een-api-toolkit 0.3.47 → 0.3.49

package/dist/index.d.ts

@@ -13,6 +13,38 @@ import { StoreDefinition } from 'pinia';
  */
 export declare type ActorType = 'bridge' | 'camera' | 'speaker' | 'account' | 'user' | 'layout' | 'job' | 'measurement' | 'sensor' | 'gateway';
 
+/**
+ * Add/create a new file entry.
+ *
+ * @remarks
+ * Creates a new file entry from `/api/v3.0/files`. The actual file content
+ * may be uploaded separately or referenced by URL.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/createfile).
+ *
+ * @param params - File creation parameters
+ * @returns A Result containing the created file or an error
+ *
+ * @example
+ * ```typescript
+ * import { addFile } from 'een-api-toolkit'
+ *
+ * const { data, error } = await addFile({
+ *   name: 'Incident Report',
+ *   type: 'upload',
+ *   description: 'Security incident documentation'
+ * })
+ *
+ * if (data) {
+ *   console.log('File created:', data.id)
+ * }
+ * ```
+ *
+ * @category Files
+ */
+export declare function addFile(params: CreateFileParams): Promise<Result<EenFile>>;
+
 /**
  * Alert entity from EEN API v3.0.
  *
@@ -874,6 +906,156 @@ export declare interface CreateEventSubscriptionParams {
     filters: FilterCreate[];
 }
 
+/**
+ * Create a new export job.
+ *
+ * @remarks
+ * Creates an asynchronous job to export video or images from a camera.
+ * The job is queued and processed in the background. Use `getJob()` to
+ * poll for completion.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/createexport).
+ *
+ * @param params - Export job parameters
+ * @returns A Result containing the created job or an error
+ *
+ * @example
+ * ```typescript
+ * import { createExportJob, getJob, formatTimestamp } from 'een-api-toolkit'
+ *
+ * // Create an export job
+ * const startTime = new Date(Date.now() - 60 * 60 * 1000) // 1 hour ago
+ * const endTime = new Date()
+ *
+ * const { data: job, error } = await createExportJob({
+ *   name: 'Security Incident Export',
+ *   type: 'video',
+ *   cameraId: 'camera-123',
+ *   startTimestamp: formatTimestamp(startTime.toISOString()),
+ *   endTimestamp: formatTimestamp(endTime.toISOString())
+ * })
+ *
+ * if (error) {
+ *   console.error('Failed to create export:', error.message)
+ *   return
+ * }
+ *
+ * // Poll for completion
+ * let completed = false
+ * while (!completed) {
+ *   await new Promise(r => setTimeout(r, 2000)) // Wait 2 seconds
+ *   const { data: status } = await getJob(job.id)
+ *   if (status?.state === 'success') {
+ *     const fileUrl = status.result?.intervals?.[0]?.files?.[0]?.url
+ *     const fileId = fileUrl?.substring(fileUrl.lastIndexOf('/') + 1)
+ *     console.log('Export complete! File ID:', fileId)
+ *     completed = true
+ *   } else if (status?.state === 'failure') {
+ *     console.error('Export failed:', status.error)
+ *     completed = true
+ *   } else {
+ *     console.log('Progress:', status?.progress || 0, '%')
+ *   }
+ * }
+ * ```
+ *
+ * @category Exports
+ */
+export declare function createExportJob(params: CreateExportParams): Promise<Result<ExportJobResponse>>;
+
+/**
+ * Parameters for creating an export job.
+ *
+ * @remarks
+ * Creates an asynchronous job that exports video or images from a camera.
+ * The job progresses through states: pending → started → success/failure.
+ *
+ * @example
+ * ```typescript
+ * import { createExportJob, formatTimestamp } from 'een-api-toolkit'
+ *
+ * const startTime = new Date(Date.now() - 60 * 60 * 1000) // 1 hour ago
+ * const endTime = new Date()
+ *
+ * const { data, error } = await createExportJob({
+ *   name: 'Security Incident Export',
+ *   type: 'video',
+ *   cameraId: 'camera-123',
+ *   startTimestamp: formatTimestamp(startTime.toISOString()),
+ *   endTimestamp: formatTimestamp(endTime.toISOString())
+ * })
+ *
+ * if (data) {
+ *   console.log('Export job created:', data.id)
+ *   // Poll getJob() to track progress
+ * }
+ * ```
+ *
+ * @category Exports
+ */
+export declare interface CreateExportParams {
+    /** Display name for the export job */
+    name?: string;
+    /** Type of export to create */
+    type: ExportType;
+    /** Camera ID to export from */
+    cameraId: string;
+    /** Start timestamp for the export (ISO 8601 format with +00:00 timezone) */
+    startTimestamp: string;
+    /** End timestamp for the export (ISO 8601 format with +00:00 timezone) */
+    endTimestamp: string;
+    /**
+     * Playback multiplier for time lapse video (required for timeLapse and bundle types).
+     * Value must be between 1 and 48.
+     * For example, a value of 10 means 10 minutes of recording becomes 1 minute of playback.
+     */
+    playbackMultiplier?: number;
+    /** If true, export is auto-deleted after 2 weeks (default: false) */
+    autoDelete?: boolean;
+    /** Directory path in archive to save the export (default: '/') */
+    directory?: string;
+    /** Notes/description for the export */
+    notes?: string;
+    /** Tags for categorization */
+    tags?: string[];
+}
+
+/**
+ * Parameters for adding/uploading a file.
+ *
+ * @remarks
+ * Creates a new file entry. The actual file content may be uploaded
+ * separately or referenced by URL.
+ *
+ * @example
+ * ```typescript
+ * import { addFile } from 'een-api-toolkit'
+ *
+ * const { data, error } = await addFile({
+ *   name: 'Incident Report',
+ *   type: 'upload',
+ *   description: 'Security incident documentation'
+ * })
+ * ```
+ *
+ * @category Files
+ */
+export declare interface CreateFileParams {
+    /** Display name for the file */
+    name: string;
+    /** Type/category of the file */
+    type?: FileType;
+    /** Original filename */
+    filename?: string;
+    /** Description or notes about the file */
+    description?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Related camera ID */
+    cameraId?: string;
+}
+
 /**
  * Create a new layout.
  *
@@ -980,6 +1162,83 @@ export declare interface CreateLayoutParams {
  */
 export declare function deleteEventSubscription(subscriptionId: string): Promise<Result<void>>;
 
+/**
+ * Delete (recycle) a file by ID.
+ *
+ * @remarks
+ * Moves a file to the recycle bin (trash) via DELETE `/api/v3.0/files/{fileId}`.
+ * This does not permanently delete the file - it can be recovered from trash.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/deletefile).
+ *
+ * @param fileId - The unique identifier of the file to delete
+ * @returns A Result indicating success or an error
+ *
+ * @example
+ * ```typescript
+ * import { deleteFile } from 'een-api-toolkit'
+ *
+ * async function recycleFile(fileId: string) {
+ *   const { error } = await deleteFile(fileId)
+ *
+ *   if (error) {
+ *     if (error.code === 'NOT_FOUND') {
+ *       console.log('File not found or already deleted')
+ *     } else {
+ *       console.error('Failed to delete file:', error.message)
+ *     }
+ *     return false
+ *   }
+ *
+ *   console.log('File moved to trash')
+ *   return true
+ * }
+ * ```
+ *
+ * @category Files
+ */
+export declare function deleteFile(fileId: string): Promise<Result<void>>;
+
+/**
+ * Delete (revoke) a job by ID.
+ *
+ * @remarks
+ * Deletes a job from `/api/v3.0/jobs/{jobId}` regardless of its state.
+ * This can be used to:
+ * - Cancel a **pending** job before it starts processing
+ * - Revoke a **started** job to stop processing
+ * - Remove a **completed** job record
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/deletejob).
+ *
+ * @param jobId - The unique identifier of the job to delete
+ * @returns A Result with void data on success, or an error
+ *
+ * @example
+ * ```typescript
+ * import { deleteJob } from 'een-api-toolkit'
+ *
+ * // Cancel a pending export job
+ * const { error } = await deleteJob('job-123')
+ *
+ * if (error) {
+ *   if (error.code === 'NOT_FOUND') {
+ *     console.log('Job not found or already deleted')
+ *   } else {
+ *     console.error('Failed to delete job:', error.message)
+ *   }
+ *   return
+ * }
+ *
+ * console.log('Job successfully revoked')
+ * ```
+ *
+ * @category Jobs
+ */
+export declare function deleteJob(jobId: string): Promise<Result<void>>;
+
 /**
  * Delete a layout.
  *
@@ -1031,6 +1290,190 @@ export declare type DeliveryConfig = SSEDeliveryConfig | WebhookDeliveryConfig;
  */
 export declare type DeliveryConfigCreate = SSEDeliveryConfigCreate | WebhookDeliveryConfigCreate;
 
+/**
+ * Download entity from EEN API v3.0.
+ *
+ * @remarks
+ * Represents a downloadable item in the Eagle Eye Networks platform.
+ * Downloads may expire after a certain time period.
+ *
+ * @example
+ * ```typescript
+ * import { listDownloads, type Download } from 'een-api-toolkit'
+ *
+ * const { data, error } = await listDownloads({ status__in: ['available'] })
+ * if (data) {
+ *   data.results.forEach((download: Download) => {
+ *     console.log(`${download.name}: ${download.status}`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Downloads
+ */
+export declare interface Download {
+    /** Unique identifier for the download */
+    id: string;
+    /** ID of the account this download belongs to */
+    accountId: string;
+    /** Display name of the download */
+    name: string;
+    /** Current status of the download */
+    status: DownloadStatus;
+    /** MIME content type (e.g., 'video/mp4') */
+    contentType?: string;
+    /** File size in bytes */
+    sizeBytes?: number;
+    /** ID of the related file */
+    fileId?: string;
+    /** ID of the job that created this download */
+    jobId?: string;
+    /** ID of the camera this download relates to */
+    cameraId?: string;
+    /** Description or notes */
+    description?: string;
+    /** ISO 8601 timestamp when the download was created */
+    createTimestamp: string;
+    /** ISO 8601 timestamp when the download expires */
+    expirationTimestamp?: string;
+    /** Download URL (may be pre-signed) */
+    downloadUrl?: string;
+}
+
+/**
+ * Download the binary content of a download entry.
+ *
+ * @remarks
+ * Downloads the actual file content from `/api/v3.0/downloads/{downloadId}:download`.
+ * Returns a Blob that can be used to create a download link or process the file.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/downloaddownload).
+ *
+ * @param downloadId - The unique identifier of the download to fetch
+ * @returns A Result containing the download result with blob, filename, and metadata
+ *
+ * @example
+ * ```typescript
+ * import { downloadDownload } from 'een-api-toolkit'
+ *
+ * const { data, error } = await downloadDownload('download-123')
+ *
+ * if (error) {
+ *   console.error('Download failed:', error.message)
+ *   return
+ * }
+ *
+ * // Create download link
+ * const url = URL.createObjectURL(data.blob)
+ * const a = document.createElement('a')
+ * a.href = url
+ * a.download = data.filename
+ * a.click()
+ * URL.revokeObjectURL(url)
+ *
+ * console.log(`Downloaded: ${data.filename} (${data.size} bytes)`)
+ * ```
+ *
+ * @category Downloads
+ */
+export declare function downloadDownload(downloadId: string): Promise<Result<DownloadDownloadResult>>;
+
+/**
+ * Result from downloading via the downloads endpoint.
+ *
+ * @remarks
+ * Reuses the same structure as file downloads.
+ *
+ * @category Downloads
+ */
+export declare type DownloadDownloadResult = DownloadFileResult;
+
+/**
+ * Download a file's binary content.
+ *
+ * @remarks
+ * Downloads the actual file content from `/api/v3.0/files/{fileId}:download`.
+ * Returns a Blob that can be used to create a download link or process the file.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/downloadfile).
+ *
+ * @param fileId - The unique identifier of the file to download
+ * @returns A Result containing the download result with blob, filename, and metadata
+ *
+ * @example
+ * ```typescript
+ * import { downloadFile } from 'een-api-toolkit'
+ *
+ * const { data, error } = await downloadFile('file-123')
+ *
+ * if (error) {
+ *   console.error('Download failed:', error.message)
+ *   return
+ * }
+ *
+ * // Create download link
+ * const url = URL.createObjectURL(data.blob)
+ * const a = document.createElement('a')
+ * a.href = url
+ * a.download = data.filename
+ * a.click()
+ * URL.revokeObjectURL(url)
+ *
+ * console.log(`Downloaded: ${data.filename} (${data.size} bytes)`)
+ * ```
+ *
+ * @category Files
+ */
+export declare function downloadFile(fileId: string): Promise<Result<DownloadFileResult>>;
+
+/**
+ * Result from downloading a file.
+ *
+ * @remarks
+ * Contains the binary file data as a Blob along with metadata.
+ *
+ * @example
+ * ```typescript
+ * import { downloadFile } from 'een-api-toolkit'
+ *
+ * const { data, error } = await downloadFile('file-123')
+ *
+ * if (data) {
+ *   // Create download link
+ *   const url = URL.createObjectURL(data.blob)
+ *   const a = document.createElement('a')
+ *   a.href = url
+ *   a.download = data.filename
+ *   a.click()
+ *   URL.revokeObjectURL(url)
+ * }
+ * ```
+ *
+ * @category Files
+ */
+export declare interface DownloadFileResult {
+    /** Binary file data */
+    blob: Blob;
+    /** Filename from Content-Disposition header */
+    filename: string;
+    /** MIME content type from Content-Type header */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+}
+
+/**
+ * Download status from EEN API v3.0.
+ *
+ * @remarks
+ * Indicates the availability status of a download.
+ *
+ * @category Downloads
+ */
+export declare type DownloadStatus = 'available' | 'expired' | 'pending' | 'error';
+
 /**
  * Error object returned when an operation fails.
  *
@@ -1062,6 +1505,72 @@ export declare interface EenError {
     details?: unknown;
 }
 
+/**
+ * File entity from EEN API v3.0.
+ *
+ * @remarks
+ * Represents a file stored in the Eagle Eye Networks platform.
+ * Files can be exports, uploads, or snapshots.
+ *
+ * @example
+ * ```typescript
+ * import { listFiles, type EenFile } from 'een-api-toolkit'
+ *
+ * const { data, error } = await listFiles({ type__in: ['export'] })
+ * if (data) {
+ *   data.results.forEach((file: EenFile) => {
+ *     console.log(`${file.name}: ${file.size} bytes`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Files
+ */
+export declare interface EenFile {
+    /** Unique identifier for the file */
+    id: string;
+    /** Display name of the file */
+    name: string;
+    /** MIME type from API (e.g., 'video/mp4', 'application/directory') */
+    mimeType?: string;
+    /** Directory path */
+    directory?: string;
+    /** ID of the account this file belongs to (requires include=accountId) */
+    accountId?: string;
+    /** Public share information (requires include=publicShare) */
+    publicShare?: unknown;
+    /** File notes/description (requires include=notes) */
+    notes?: string;
+    /** ISO 8601 timestamp when the file was created (requires include=createTimestamp) */
+    createTimestamp?: string;
+    /** ISO 8601 timestamp when the file was last updated (requires include=updateTimestamp) */
+    updateTimestamp?: string;
+    /** File size in bytes (requires include=size) */
+    size?: number;
+    /** Additional metadata (requires include=metadata) */
+    metadata?: Record<string, unknown>;
+    /** Tags for categorization (requires include=tags) */
+    tags?: string[];
+    /** Number of child files for directories (requires include=childCount) */
+    childCount?: number;
+    /** Additional file details (requires include=details) */
+    details?: Record<string, unknown>;
+    /** Original filename */
+    filename?: string;
+    /** MIME content type (e.g., 'video/mp4', 'image/jpeg') */
+    contentType?: string;
+    /** Type/category of the file */
+    type?: FileType;
+    /** ID of the job that created this file (for exports) */
+    jobId?: string;
+    /** ID of the camera this file relates to */
+    cameraId?: string;
+    /** Description or notes about the file */
+    description?: string;
+    /** ISO 8601 timestamp when the file expires (if applicable) */
+    expirationTimestamp?: string;
+}
+
 /**
  * Configuration for initializing the toolkit.
  *
@@ -1476,6 +1985,31 @@ export declare interface EventTypeFilter {
     id: string;
 }
 
+/**
+ * Response from creating an export job.
+ *
+ * @remarks
+ * Returns the created job with its initial state. Use `getJob()` to poll
+ * for completion.
+ *
+ * @category Exports
+ */
+export declare type ExportJobResponse = Job;
+
+/**
+ * Export types supported by the EEN API v3.0.
+ *
+ * @remarks
+ * Different export types produce different output formats.
+ *
+ * - `bundle`: ZIP archive containing video clips and images
+ * - `timeLapse`: Time-lapse video from multiple frames
+ * - `video`: Single video file export
+ *
+ * @category Exports
+ */
+export declare type ExportType = 'bundle' | 'timeLapse' | 'video';
+
 /* Excluded from this release type: failure */
 
 /**
@@ -1588,6 +2122,34 @@ export declare type FeedMediaType = 'video' | 'audio' | 'image' | 'halfDuplex' |
  */
 export declare type FeedStreamType = 'main' | 'preview' | 'talkdown';
 
+/**
+ * Valid include field names for the Files API.
+ *
+ * @remarks
+ * These fields can be requested via the `include` parameter to get additional
+ * file metadata that is not returned by default.
+ *
+ * @example
+ * ```typescript
+ * const { data } = await listFiles({
+ *   include: ['size', 'createTimestamp', 'tags', 'metadata']
+ * })
+ * ```
+ *
+ * @category Files
+ */
+export declare type FileIncludeField = 'accountId' | 'publicShare' | 'notes' | 'createTimestamp' | 'updateTimestamp' | 'size' | 'metadata' | 'tags' | 'childCount' | 'details';
+
+/**
+ * File type/category from EEN API v3.0.
+ *
+ * @remarks
+ * Indicates the type of content in the file.
+ *
+ * @category Files
+ */
+export declare type FileType = 'export' | 'upload' | 'snapshot' | 'other';
+
 /**
  * Filter creation parameters.
  *
@@ -2071,6 +2633,56 @@ export declare function getConfig(): EenToolkitConfig;
  */
 export declare function getCurrentUser(): Promise<Result<UserProfile>>;
 
+/**
+ * Get a specific download by ID.
+ *
+ * @remarks
+ * Fetches a single download's metadata from `/api/v3.0/downloads/{downloadId}`.
+ * Use this to get download details before downloading.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/getdownload).
+ *
+ * @param downloadId - The unique identifier of the download to fetch
+ * @param params - Optional parameters (e.g., include additional fields)
+ * @returns A Result containing the download or an error
+ *
+ * @example
+ * ```typescript
+ * import { getDownload } from 'een-api-toolkit'
+ *
+ * const { data, error } = await getDownload('download-123')
+ *
+ * if (error) {
+ *   if (error.code === 'NOT_FOUND') {
+ *     console.log('Download not found')
+ *   }
+ *   return
+ * }
+ *
+ * console.log(`Download: ${data.name} (${data.status})`)
+ * if (data.status === 'available') {
+ *   console.log(`Size: ${data.sizeBytes} bytes`)
+ * }
+ * ```
+ *
+ * @category Downloads
+ */
+export declare function getDownload(downloadId: string, params?: GetDownloadParams): Promise<Result<Download>>;
+
+/**
+ * Parameters for getting a single download.
+ *
+ * @remarks
+ * Use to fetch download metadata and URL before downloading.
+ *
+ * @category Downloads
+ */
+export declare interface GetDownloadParams {
+    /** Additional fields to include in the response */
+    include?: string[];
+}
+
 /**
  * Get a specific event by ID.
  *
@@ -2269,55 +2881,174 @@ export declare interface GetEventMetricsParams {
 }
 
 /**
- * Parameters for getting a single event by ID.
+ * Parameters for getting a single event by ID.
+ *
+ * @remarks
+ * Supports including additional data schemas in the response.
+ *
+ * @example
+ * ```typescript
+ * import { getEvent } from 'een-api-toolkit'
+ *
+ * const { data } = await getEvent('event-123', {
+ *   include: ['data.een.objectDetection.v1', 'data.een.fullFrameImageUrl.v1']
+ * })
+ * ```
+ *
+ * @category Events
+ */
+export declare interface GetEventParams {
+    /** Data schemas to include in the response */
+    include?: string[];
+}
+
+/**
+ * Get a specific event subscription by ID.
+ *
+ * @remarks
+ * Fetches a single event subscription from `/api/v3.0/eventSubscriptions/{id}`.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/geteventsubscription).
+ *
+ * @param subscriptionId - The unique identifier of the subscription to fetch
+ * @returns A Result containing the event subscription or an error
+ *
+ * @example
+ * ```typescript
+ * import { getEventSubscription } from 'een-api-toolkit'
+ *
+ * const { data, error } = await getEventSubscription('f3d6f55d5ba546168758a309508f4419')
+ * if (data) {
+ *   console.log(`Subscription: ${data.id}`)
+ *   if (data.deliveryConfig.type === 'serverSentEvents.v1') {
+ *     console.log(`SSE URL: ${data.deliveryConfig.sseUrl}`)
+ *   }
+ * }
+ * ```
+ *
+ * @category EventSubscriptions
+ */
+export declare function getEventSubscription(subscriptionId: string): Promise<Result<EventSubscription>>;
+
+/**
+ * Get a specific file by ID.
+ *
+ * @remarks
+ * Fetches a single file's metadata from `/api/v3.0/files/{fileId}`.
+ * Use this to get file details before downloading.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/getfile).
+ *
+ * @param fileId - The unique identifier of the file to fetch
+ * @param params - Optional parameters (e.g., include additional fields)
+ * @returns A Result containing the file or an error
+ *
+ * @example
+ * ```typescript
+ * import { getFile } from 'een-api-toolkit'
+ *
+ * const { data, error } = await getFile('file-123')
+ *
+ * if (error) {
+ *   if (error.code === 'NOT_FOUND') {
+ *     console.log('File not found')
+ *   }
+ *   return
+ * }
+ *
+ * console.log(`File: ${data.name} (${data.size} bytes)`)
+ * ```
+ *
+ * @category Files
+ */
+export declare function getFile(fileId: string, params?: GetFileParams): Promise<Result<EenFile>>;
+
+/**
+ * Parameters for getting a single file.
  *
  * @remarks
- * Supports including additional data schemas in the response.
- *
- * @example
- * ```typescript
- * import { getEvent } from 'een-api-toolkit'
+ * Use to fetch file metadata before downloading.
  *
- * const { data } = await getEvent('event-123', {
- *   include: ['data.een.objectDetection.v1', 'data.een.fullFrameImageUrl.v1']
- * })
- * ```
- *
- * @category Events
+ * @category Files
  */
-export declare interface GetEventParams {
-    /** Data schemas to include in the response */
-    include?: string[];
+export declare interface GetFileParams {
+    /**
+     * Additional fields to include in the response.
+     * Valid values: accountId, publicShare, notes, createTimestamp,
+     * updateTimestamp, size, metadata, tags, childCount, details
+     */
+    include?: FileIncludeField[];
 }
 
 /**
- * Get a specific event subscription by ID.
+ * Get a specific job by ID.
  *
  * @remarks
- * Fetches a single event subscription from `/api/v3.0/eventSubscriptions/{id}`.
+ * Fetches a single job from `/api/v3.0/jobs/{jobId}`. Use this to poll
+ * for job completion after creating an export.
  *
  * For more details, see the
- * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/geteventsubscription).
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/getjob).
  *
- * @param subscriptionId - The unique identifier of the subscription to fetch
- * @returns A Result containing the event subscription or an error
+ * @param jobId - The unique identifier of the job to fetch
+ * @param params - Optional parameters (e.g., include additional fields)
+ * @returns A Result containing the job or an error
  *
  * @example
  * ```typescript
- * import { getEventSubscription } from 'een-api-toolkit'
+ * import { getJob } from 'een-api-toolkit'
  *
- * const { data, error } = await getEventSubscription('f3d6f55d5ba546168758a309508f4419')
- * if (data) {
- *   console.log(`Subscription: ${data.id}`)
- *   if (data.deliveryConfig.type === 'serverSentEvents.v1') {
- *     console.log(`SSE URL: ${data.deliveryConfig.sseUrl}`)
+ * const { data, error } = await getJob('job-123')
+ *
+ * if (error) {
+ *   if (error.code === 'NOT_FOUND') {
+ *     console.log('Job not found')
  *   }
+ *   return
+ * }
+ *
+ * console.log(`Job state: ${data.state}`)
+ * if (data.state === 'started') {
+ *   console.log(`Progress: ${data.progress}%`)
+ * }
+ * if (data.state === 'success') {
+ *   const fileUrl = data.result?.intervals?.[0]?.files?.[0]?.url
+ *   const fileId = fileUrl?.substring(fileUrl.lastIndexOf('/') + 1)
+ *   console.log(`File ID: ${fileId}`)
  * }
  * ```
  *
- * @category EventSubscriptions
+ * @category Jobs
  */
-export declare function getEventSubscription(subscriptionId: string): Promise<Result<EventSubscription>>;
+export declare function getJob(jobId: string, params?: GetJobParams): Promise<Result<Job>>;
+
+/**
+ * Parameters for getting a single job.
+ *
+ * @remarks
+ * Use to fetch a specific job by ID, typically for polling job status.
+ *
+ * @example
+ * ```typescript
+ * import { getJob } from 'een-api-toolkit'
+ *
+ * // Poll for job completion
+ * const { data, error } = await getJob('job-123')
+ * if (data?.state === 'success') {
+ *   const fileUrl = data.result?.intervals?.[0]?.files?.[0]?.url
+ *   const fileId = fileUrl?.substring(fileUrl.lastIndexOf('/') + 1)
+ *   console.log('Job completed! File ID:', fileId)
+ * }
+ * ```
+ *
+ * @category Jobs
+ */
+export declare interface GetJobParams {
+    /** Additional fields to include in the response */
+    include?: string[];
+}
 
 /**
  * Get a specific layout by ID.
@@ -2916,6 +3647,163 @@ export declare function initEenToolkit(options?: EenToolkitConfig): void;
  */
 export declare function initMediaSession(): Promise<Result<MediaSessionResult>>;
 
+/**
+ * Job entity from EEN API v3.0.
+ *
+ * @remarks
+ * Represents an asynchronous job in the Eagle Eye Networks platform.
+ * Jobs are used for long-running operations like video exports.
+ *
+ * Note: Some fields like name and timestamps are nested in the `arguments`
+ * and `result` objects. Use helper properties or access them directly:
+ * - Name: `job.arguments?.originalRequest?.name`
+ * - Request timestamps: `job.arguments?.originalRequest?.startTimestamp/endTimestamp`
+ * - Result files: `job.result?.intervals?.[0]?.files`
+ *
+ * @example
+ * ```typescript
+ * import { listJobs, type Job } from 'een-api-toolkit'
+ *
+ * const { data, error } = await listJobs({ state__in: ['pending', 'started'] })
+ * if (data) {
+ *   data.results.forEach((job: Job) => {
+ *     const name = job.arguments?.originalRequest?.name || job.id
+ *     console.log(`${name}: ${job.state}`)
+ *   })
+ * }
+ * ```
+ *
+ * @category Jobs
+ */
+export declare interface Job {
+    /** Unique identifier for the job */
+    id: string;
+    /** Namespace of the job (e.g., 'media') */
+    namespace?: string;
+    /** Type of job (e.g., 'media.export') */
+    type: string;
+    /** ID of the user who created the job */
+    userId: string;
+    /** Current state of the job */
+    state: JobState;
+    /** Detailed state information */
+    detailedState?: string | null;
+    /** Progress as a decimal (0-1). Multiply by 100 for percentage. */
+    progress?: number;
+    /** Error details if the job failed */
+    error?: string | null;
+    /** Job arguments including the original request */
+    arguments?: JobArguments;
+    /** Job result including output files */
+    result?: JobResult;
+    /** ISO 8601 timestamp when the job was created */
+    createTimestamp: string;
+    /** ISO 8601 timestamp when the job was last updated */
+    updateTimestamp?: string;
+    /** ISO 8601 timestamp when the job is scheduled to expire */
+    expireTimestamp?: string;
+    /** ISO 8601 timestamp when the job is scheduled to run */
+    scheduleTimestamp?: string | null;
+}
+
+/**
+ * Job arguments structure.
+ *
+ * @category Jobs
+ */
+declare interface JobArguments {
+    /** Device ID the job operates on */
+    deviceId?: string;
+    /** Original request parameters */
+    originalRequest?: JobOriginalRequest;
+}
+
+/**
+ * Original request stored in job arguments.
+ *
+ * @category Jobs
+ */
+declare interface JobOriginalRequest {
+    /** Export type */
+    type?: string;
+    /** Name given to the export */
+    name?: string;
+    /** Target directory */
+    directory?: string;
+    /** Start timestamp of requested period */
+    startTimestamp?: string;
+    /** End timestamp of requested period */
+    endTimestamp?: string;
+    /** Additional notes */
+    notes?: string | null;
+    /** Tags for the export */
+    tags?: string[] | null;
+}
+
+/**
+ * Job result structure.
+ *
+ * @category Jobs
+ */
+declare interface JobResult {
+    /** Overall result state */
+    state?: string;
+    /** Error details if failed */
+    error?: string | null;
+    /** Result intervals (each may contain files) */
+    intervals?: JobResultInterval[];
+}
+
+/**
+ * File info within a job result interval.
+ *
+ * @category Jobs
+ */
+declare interface JobResultFile {
+    /** File name */
+    name: string;
+    /** File path/directory */
+    path?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Start timestamp of the file content */
+    startTimestamp?: string;
+    /** End timestamp of the file content */
+    endTimestamp?: string;
+    /** URL to download/access the file */
+    url?: string;
+    /** File checksum */
+    checksum?: string;
+}
+
+/**
+ * Interval within a job result.
+ *
+ * @category Jobs
+ */
+declare interface JobResultInterval {
+    /** Start of this interval */
+    startTimestamp?: string;
+    /** End of this interval */
+    endTimestamp?: string;
+    /** State of this interval */
+    state?: string;
+    /** Files produced in this interval */
+    files?: JobResultFile[];
+    /** Error for this interval */
+    error?: string | null;
+}
+
+/**
+ * Job states from EEN API v3.0.
+ *
+ * @remarks
+ * Indicates the current state of an asynchronous job.
+ *
+ * @category Jobs
+ */
+export declare type JobState = 'pending' | 'started' | 'success' | 'failure' | 'revoked';
+
 /**
  * Layout entity from EEN API v3.0.
  *
@@ -3593,6 +4481,84 @@ export declare interface ListCamerasParams {
     status__ne?: CameraStatus;
 }
 
+/**
+ * List downloads with optional pagination and filtering.
+ *
+ * @remarks
+ * Fetches a paginated list of downloads from `/api/v3.0/downloads`. Supports
+ * filtering by status, camera, and time range.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/listdownloads).
+ *
+ * @param params - Optional pagination and filtering parameters
+ * @returns A Result containing a paginated list of downloads or an error
+ *
+ * @example
+ * ```typescript
+ * import { listDownloads } from 'een-api-toolkit'
+ *
+ * // Basic usage
+ * const { data, error } = await listDownloads()
+ * if (data) {
+ *   console.log(`Found ${data.results.length} downloads`)
+ * }
+ *
+ * // Filter by status
+ * const { data } = await listDownloads({
+ *   status__in: ['available'],
+ *   pageSize: 50
+ * })
+ * ```
+ *
+ * @category Downloads
+ */
+export declare function listDownloads(params?: ListDownloadsParams): Promise<Result<PaginatedResult<Download>>>;
+
+/**
+ * Parameters for listing downloads.
+ *
+ * @remarks
+ * Supports filtering by status, camera, and time range.
+ *
+ * @example
+ * ```typescript
+ * import { listDownloads } from 'een-api-toolkit'
+ *
+ * // Get available downloads
+ * const { data } = await listDownloads({
+ *   status__in: ['available'],
+ *   pageSize: 50
+ * })
+ * ```
+ *
+ * @category Downloads
+ */
+export declare interface ListDownloadsParams {
+    /** Number of results per page (default: 100, max: 1000) */
+    pageSize?: number;
+    /** Token for fetching a specific page */
+    pageToken?: string;
+    /** Filter by download status (any match) */
+    status__in?: DownloadStatus[];
+    /** Filter by camera ID */
+    cameraId?: string;
+    /** Filter by camera IDs (any match) */
+    cameraId__in?: string[];
+    /** Filter by job ID */
+    jobId?: string;
+    /** Filter by file ID */
+    fileId?: string;
+    /** Filter by downloads created after this timestamp (ISO 8601) */
+    createTimestamp__gte?: string;
+    /** Filter by downloads created before this timestamp (ISO 8601) */
+    createTimestamp__lte?: string;
+    /** Full-text search query */
+    q?: string;
+    /** Fields to sort by (prefix with - for descending) */
+    sort?: string[];
+}
+
 /**
  * List event alert condition rules with optional filters and pagination.
  *
@@ -4075,6 +5041,184 @@ export declare interface ListFeedsResult {
     totalSize?: number;
 }
 
+/**
+ * List files with optional pagination and filtering.
+ *
+ * @remarks
+ * Fetches a paginated list of files from `/api/v3.0/files`. Supports
+ * filtering by type, camera, and time range.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/listfiles).
+ *
+ * @param params - Optional pagination and filtering parameters
+ * @returns A Result containing a paginated list of files or an error
+ *
+ * @example
+ * ```typescript
+ * import { listFiles } from 'een-api-toolkit'
+ *
+ * // Basic usage
+ * const { data, error } = await listFiles()
+ * if (data) {
+ *   console.log(`Found ${data.results.length} files`)
+ * }
+ *
+ * // Filter by type
+ * const { data } = await listFiles({
+ *   type__in: ['export'],
+ *   pageSize: 50
+ * })
+ *
+ * // Files for a specific camera
+ * const { data: cameraFiles } = await listFiles({
+ *   cameraId: 'camera-123'
+ * })
+ * ```
+ *
+ * @category Files
+ */
+export declare function listFiles(params?: ListFilesParams): Promise<Result<PaginatedResult<EenFile>>>;
+
+/**
+ * Parameters for listing files.
+ *
+ * @remarks
+ * Supports filtering by type, camera, and time range.
+ *
+ * @example
+ * ```typescript
+ * import { listFiles } from 'een-api-toolkit'
+ *
+ * // Get export files
+ * const { data } = await listFiles({
+ *   type__in: ['export'],
+ *   pageSize: 50
+ * })
+ *
+ * // Get files for a specific camera
+ * const { data: cameraFiles } = await listFiles({
+ *   cameraId: 'camera-123'
+ * })
+ * ```
+ *
+ * @category Files
+ */
+export declare interface ListFilesParams {
+    /** Number of results per page (default: 100, max: 1000) */
+    pageSize?: number;
+    /** Token for fetching a specific page */
+    pageToken?: string;
+    /**
+     * Additional fields to include in the response.
+     * Valid values: accountId, publicShare, notes, createTimestamp,
+     * updateTimestamp, size, metadata, tags, childCount, details
+     */
+    include?: FileIncludeField[];
+    /** Filter by file types (any match) */
+    type__in?: FileType[];
+    /** Filter by camera ID */
+    cameraId?: string;
+    /** Filter by camera IDs (any match) */
+    cameraId__in?: string[];
+    /** Filter by job ID */
+    jobId?: string;
+    /** Filter by files created after this timestamp (ISO 8601) */
+    createTimestamp__gte?: string;
+    /** Filter by files created before this timestamp (ISO 8601) */
+    createTimestamp__lte?: string;
+    /** Filter by tags (all must match) */
+    tags__contains?: string[];
+    /** Full-text search query */
+    q?: string;
+    /** Fields to sort by (prefix with - for descending) */
+    sort?: string[];
+}
+
+/**
+ * List jobs with optional pagination and filtering.
+ *
+ * @remarks
+ * Fetches a paginated list of jobs from `/api/v3.0/jobs`. Supports
+ * filtering by state, type, and time range.
+ *
+ * For more details, see the
+ * [EEN API Documentation](https://developer.eagleeyenetworks.com/reference/listjobs).
+ *
+ * @param params - Optional pagination and filtering parameters
+ * @returns A Result containing a paginated list of jobs or an error
+ *
+ * @example
+ * ```typescript
+ * import { listJobs } from 'een-api-toolkit'
+ *
+ * // Basic usage
+ * const { data, error } = await listJobs()
+ * if (data) {
+ *   console.log(`Found ${data.results.length} jobs`)
+ * }
+ *
+ * // Filter by state
+ * const { data } = await listJobs({
+ *   state__in: ['pending', 'started'],
+ *   pageSize: 50
+ * })
+ *
+ * // Get export jobs only
+ * const { data: exports } = await listJobs({
+ *   type: 'export'
+ * })
+ * ```
+ *
+ * @category Jobs
+ */
+export declare function listJobs(params?: ListJobsParams): Promise<Result<PaginatedResult<Job>>>;
+
+/**
+ * Parameters for listing jobs.
+ *
+ * @remarks
+ * Supports filtering by state, type, and time range.
+ *
+ * @example
+ * ```typescript
+ * import { listJobs } from 'een-api-toolkit'
+ *
+ * // Get pending and started jobs
+ * const { data } = await listJobs({
+ *   state__in: ['pending', 'started'],
+ *   pageSize: 50
+ * })
+ *
+ * // Get export jobs
+ * const { data: exports } = await listJobs({
+ *   type: 'export'
+ * })
+ * ```
+ *
+ * @category Jobs
+ */
+export declare interface ListJobsParams {
+    /** Number of results per page (default: 100, max: 1000) */
+    pageSize?: number;
+    /** Token for fetching a specific page */
+    pageToken?: string;
+    /** Filter by job states (any match) */
+    state__in?: JobState[];
+    /** Filter by job type */
+    type?: string;
+    /** Filter by job types (any match) */
+    type__in?: string[];
+    /** Filter by jobs created after this timestamp (ISO 8601) */
+    createTimestamp__gte?: string;
+    /** Filter by jobs created before this timestamp (ISO 8601) */
+    createTimestamp__lte?: string;
+    /** Filter by user ID */
+    userId?: string;
+    /** Fields to sort by (prefix with - for descending) */
+    sort?: string[];
+}
+
 /**
  * Valid include options for listing layouts.
  *