een-api-toolkit 0.0.13 → 0.0.18

package/examples/vue-cameras/src/views/Cameras.vue

@@ -0,0 +1,249 @@
+<script setup lang="ts">
+import { ref, watch } from 'vue'
+import { useCameras, type CameraStatus } from 'een-api-toolkit'
+
+// Status filter
+const statusFilter = ref<CameraStatus | ''>('')
+
+// Initial fetch with common includes
+const {
+  cameras,
+  loading,
+  error,
+  hasNextPage,
+  totalSize,
+  fetchNextPage,
+  refresh,
+  setParams,
+  fetch
+} = useCameras({
+  pageSize: 20,
+  include: ['deviceInfo', 'status']
+})
+
+// Watch for status filter changes
+watch(statusFilter, async (newStatus) => {
+  if (newStatus) {
+    setParams({
+      pageSize: 20,
+      include: ['deviceInfo', 'status'],
+      status__in: [newStatus]
+    })
+  } else {
+    setParams({
+      pageSize: 20,
+      include: ['deviceInfo', 'status']
+    })
+  }
+  await fetch()
+})
+
+// Get status badge class
+function getStatusClass(status?: CameraStatus): string {
+  switch (status) {
+    case 'online':
+    case 'streaming':
+      return 'status-online'
+    case 'offline':
+    case 'deviceOffline':
+    case 'bridgeOffline':
+      return 'status-offline'
+    case 'error':
+    case 'invalidCredentials':
+      return 'status-error'
+    default:
+      return 'status-unknown'
+  }
+}
+</script>
+
+<template>
+  <div class="cameras">
+    <div class="header">
+      <h2>Cameras</h2>
+      <div class="controls">
+        <select v-model="statusFilter" class="status-filter">
+          <option value="">All Statuses</option>
+          <option value="online">Online</option>
+          <option value="streaming">Streaming</option>
+          <option value="offline">Offline</option>
+          <option value="deviceOffline">Device Offline</option>
+          <option value="bridgeOffline">Bridge Offline</option>
+          <option value="error">Error</option>
+        </select>
+        <button @click="refresh" :disabled="loading">
+          {{ loading ? 'Loading...' : 'Refresh' }}
+        </button>
+      </div>
+    </div>
+
+    <div v-if="totalSize !== undefined" class="total-count">
+      Total: {{ totalSize }} camera{{ totalSize !== 1 ? 's' : '' }}
+    </div>
+
+    <div v-if="loading && cameras.length === 0" class="loading">
+      Loading cameras...
+    </div>
+
+    <div v-else-if="error" class="error">
+      Error: {{ error.message }}
+    </div>
+
+    <div v-else>
+      <div v-if="cameras.length > 0" class="camera-grid">
+        <router-link
+          v-for="camera in cameras"
+          :key="camera.id"
+          :to="`/cameras/${camera.id}`"
+          class="camera-card"
+        >
+          <div class="camera-header">
+            <h3>{{ camera.name }}</h3>
+            <span :class="['status-badge', getStatusClass(camera.status)]">
+              {{ camera.status || 'Unknown' }}
+            </span>
+          </div>
+          <div class="camera-details">
+            <p v-if="camera.deviceInfo?.make || camera.deviceInfo?.model">
+              <strong>Device:</strong>
+              {{ camera.deviceInfo?.make || '' }} {{ camera.deviceInfo?.model || '' }}
+            </p>
+            <p v-if="camera.locationId">
+              <strong>Location:</strong> {{ camera.locationId }}
+            </p>
+            <p v-if="camera.tags && camera.tags.length > 0">
+              <strong>Tags:</strong> {{ camera.tags.join(', ') }}
+            </p>
+          </div>
+        </router-link>
+      </div>
+
+      <p v-else class="no-cameras">
+        No cameras found{{ statusFilter ? ' with selected filter' : '' }}.
+      </p>
+
+      <div v-if="hasNextPage" class="pagination">
+        <button @click="fetchNextPage" :disabled="loading">
+          {{ loading ? 'Loading...' : 'Load More' }}
+        </button>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.cameras {
+  max-width: 1000px;
+  margin: 0 auto;
+}
+
+.header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 10px;
+}
+
+.controls {
+  display: flex;
+  gap: 10px;
+  align-items: center;
+}
+
+.status-filter {
+  padding: 10px;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  font-size: 1rem;
+}
+
+.total-count {
+  color: #666;
+  margin-bottom: 20px;
+}
+
+.camera-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
+  gap: 20px;
+}
+
+.camera-card {
+  background: #fff;
+  border: 1px solid #eee;
+  border-radius: 8px;
+  padding: 20px;
+  text-decoration: none;
+  color: inherit;
+  transition: box-shadow 0.2s, border-color 0.2s;
+}
+
+.camera-card:hover {
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+  border-color: #42b883;
+}
+
+.camera-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  margin-bottom: 15px;
+}
+
+.camera-header h3 {
+  margin: 0;
+  font-size: 1.1rem;
+  flex: 1;
+  margin-right: 10px;
+}
+
+.status-badge {
+  padding: 4px 8px;
+  border-radius: 4px;
+  font-size: 0.75rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  white-space: nowrap;
+}
+
+.status-online {
+  background: #d4edda;
+  color: #155724;
+}
+
+.status-offline {
+  background: #f8d7da;
+  color: #721c24;
+}
+
+.status-error {
+  background: #fff3cd;
+  color: #856404;
+}
+
+.status-unknown {
+  background: #e2e3e5;
+  color: #383d41;
+}
+
+.camera-details p {
+  margin: 5px 0;
+  font-size: 0.9rem;
+  color: #666;
+}
+
+.camera-details strong {
+  color: #333;
+}
+
+.no-cameras {
+  text-align: center;
+  color: #666;
+  padding: 40px;
+}
+
+.pagination {
+  margin-top: 30px;
+  text-align: center;
+}
+</style>

package/examples/vue-cameras/src/views/Home.vue

@@ -0,0 +1,125 @@
+<script setup lang="ts">
+import { useAuthStore, useCurrentUser } from 'een-api-toolkit'
+import { computed } from 'vue'
+
+const authStore = useAuthStore()
+const isAuthenticated = computed(() => authStore.isAuthenticated)
+
+// Fetch current user if authenticated
+const { user, loading, error } = useCurrentUser({ immediate: true })
+</script>
+
+<template>
+  <div class="home">
+    <h2>Welcome to the EEN Cameras Example</h2>
+
+    <div v-if="isAuthenticated">
+      <div v-if="loading" class="loading">Loading user info...</div>
+      <div v-else-if="error" class="error">{{ error.message }}</div>
+      <div v-else-if="user" class="user-info">
+        <p>Logged in as: <strong>{{ user.firstName }} {{ user.lastName }}</strong></p>
+        <p>Email: {{ user.email }}</p>
+      </div>
+
+      <div class="actions">
+        <router-link to="/cameras">
+          <button>View Cameras</button>
+        </router-link>
+      </div>
+    </div>
+
+    <div v-else class="login-prompt">
+      <p>Please log in to view your cameras.</p>
+      <router-link to="/login">
+        <button>Login</button>
+      </router-link>
+    </div>
+
+    <div class="description">
+      <h3>About This Example</h3>
+      <p>
+        This example demonstrates how to use the <code>useCameras</code> and
+        <code>useCamera</code> composables from the EEN API Toolkit to display
+        and manage cameras from the Eagle Eye Networks platform.
+      </p>
+      <h4>Features</h4>
+      <ul>
+        <li>List cameras with pagination</li>
+        <li>Filter cameras by status</li>
+        <li>View camera details</li>
+        <li>Display device information</li>
+      </ul>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.home {
+  max-width: 600px;
+  margin: 0 auto;
+}
+
+h2 {
+  margin-bottom: 20px;
+}
+
+.user-info {
+  background: #f5f5f5;
+  padding: 15px;
+  border-radius: 4px;
+  margin-bottom: 20px;
+}
+
+.user-info p {
+  margin: 5px 0;
+}
+
+.actions {
+  margin: 20px 0;
+}
+
+.login-prompt {
+  text-align: center;
+  padding: 20px;
+  background: #f5f5f5;
+  border-radius: 4px;
+  margin-bottom: 20px;
+}
+
+.login-prompt p {
+  margin-bottom: 15px;
+}
+
+.description {
+  margin-top: 40px;
+  padding-top: 20px;
+  border-top: 1px solid #eee;
+}
+
+.description h3 {
+  margin-bottom: 10px;
+}
+
+.description h4 {
+  margin-top: 15px;
+  margin-bottom: 10px;
+}
+
+.description p {
+  color: #666;
+  margin-bottom: 15px;
+}
+
+.description ul {
+  list-style: disc;
+  padding-left: 20px;
+  color: #666;
+}
+
+.description code {
+  background: #f0f0f0;
+  padding: 2px 6px;
+  border-radius: 3px;
+  font-size: 0.9em;
+}
+</style>

package/examples/vue-cameras/src/views/Login.vue

@@ -0,0 +1,33 @@
+<script setup lang="ts">
+import { getAuthUrl } from 'een-api-toolkit'
+
+function login() {
+  // Redirect to EEN OAuth login
+  window.location.href = getAuthUrl()
+}
+</script>
+
+<template>
+  <div class="login">
+    <h2>Login</h2>
+    <p>Click the button below to login with your Eagle Eye Networks account.</p>
+    <button @click="login">Login with Eagle Eye Networks</button>
+  </div>
+</template>
+
+<style scoped>
+.login {
+  text-align: center;
+  max-width: 400px;
+  margin: 0 auto;
+}
+
+h2 {
+  margin-bottom: 20px;
+}
+
+p {
+  margin-bottom: 20px;
+  color: #666;
+}
+</style>

package/examples/vue-cameras/src/views/Logout.vue

@@ -0,0 +1,66 @@
+<script setup lang="ts">
+import { onMounted, ref } from 'vue'
+import { useRouter } from 'vue-router'
+import { revokeToken, useAuthStore } from 'een-api-toolkit'
+
+const router = useRouter()
+const authStore = useAuthStore()
+const error = ref<string | null>(null)
+const processing = ref(true)
+
+onMounted(async () => {
+  if (!authStore.isAuthenticated) {
+    // Already logged out
+    router.push('/')
+    return
+  }
+
+  const result = await revokeToken()
+
+  if (result.error) {
+    error.value = result.error.message
+    processing.value = false
+    return
+  }
+
+  // Success - redirect to home
+  router.push('/')
+})
+</script>
+
+<template>
+  <div class="logout">
+    <div v-if="processing" class="loading">
+      <h2>Logging out...</h2>
+      <p>Please wait while we complete the logout process.</p>
+    </div>
+
+    <div v-else-if="error" class="error-state">
+      <h2>Logout Failed</h2>
+      <p class="error">{{ error }}</p>
+      <router-link to="/">
+        <button>Return Home</button>
+      </router-link>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.logout {
+  text-align: center;
+  max-width: 400px;
+  margin: 0 auto;
+}
+
+h2 {
+  margin-bottom: 20px;
+}
+
+.loading p {
+  color: #666;
+}
+
+.error-state .error {
+  margin-bottom: 20px;
+}
+</style>

package/examples/vue-cameras/src/vite-env.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_PROXY_URL: string
+  readonly VITE_EEN_CLIENT_ID: string
+  readonly VITE_REDIRECT_URI?: string
+  readonly VITE_DEBUG?: string
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}

package/examples/vue-cameras/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "preserve",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

package/examples/vue-cameras/tsconfig.node.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["vite.config.ts"]
+}

package/examples/vue-cameras/vite.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+
+export default defineConfig({
+  plugins: [vue()],
+  server: {
+    // IMPORTANT: Must use 127.0.0.1:3333 for EEN OAuth callback
+    // The EEN Identity Provider only permits this specific redirect URI
+    host: '127.0.0.1',
+    port: 3333
+  }
+})

package/package.json

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