adserver-dashboard 1.0.0

package/client/src/types/content-hub.ts

@@ -0,0 +1,209 @@
+/**
+ * Content Hub API Types
+ * Base URL: Configured via VITE_CONTENT_HUB_API_URL environment variable
+ */
+
+// Direct Content Hub API configuration (CORS enabled)
+export const CONTENT_HUB_CONFIG = {
+  BASE_URL: import.meta.env.VITE_CONTENT_HUB_API_URL,
+  API_PREFIX: '/api/v1/rest',
+  COMPANY_ID: '123e4567-e89b-12d3-a456-426614174000',
+} as const;
+
+// Enums
+export enum CreativeStatus {
+  DRAFT = 'draft',
+  APPROVED = 'approved',
+  REJECTED = 'rejected',
+}
+
+export enum JobStatus {
+  PENDING = 'PENDING',
+  PROCESSING = 'PROCESSING',
+  COMPLETED = 'COMPLETED',
+  FAILED = 'FAILED',
+}
+
+export enum CreativeType {
+  IMAGE = 'image',
+  VIDEO = 'video',
+  AUDIO = 'audio',
+  HTML5 = 'html5',
+}
+
+// Folder Types
+export interface Folder {
+  id: string;
+  name: string;
+  description?: string;
+  company_id: string;
+  parent_id?: string;
+  no_of_creatives: number;
+  creatives: {
+    image?: number;
+    video?: number;
+    audio?: number;
+    html5?: number;
+    total?: number;
+  };
+  created_at: string;
+  updated_at?: string;
+}
+
+export interface FolderCreate {
+  name: string;
+  description?: string;
+  company_id: string;
+  parent_id?: string;
+}
+
+export interface FolderUpdate {
+  name?: string;
+  description?: string;
+  parent_id?: string;
+}
+
+export interface FolderListResponse {
+  data: Folder[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    total_pages: number;
+  };
+}
+
+// Creative Types
+export interface CreativeMetadata {
+  // Image metadata
+  width?: number;
+  height?: number;
+  aspect_ratio?: string;
+  format?: string;
+  
+  // Video metadata
+  duration?: number;
+  codec?: string;
+  frame_rate?: number;
+  
+  // Audio metadata
+  bitrate?: number;
+  sample_rate?: number;
+  channels?: number;
+  
+  // File metadata
+  file_size?: number;
+  mime_type?: string;
+  resolution?: string;
+}
+
+export interface Creative {
+  id: string;
+  filename: string;
+  company_id?: string;
+  folder_id?: string;
+  status: string; // "approved", "rejected", "draft"
+  transcode_status?: string;
+  mime_type: string;
+  format: string;
+  size_bytes: number;
+  cdn_path: string; // This is the asset URL
+  thumbnail?: string; // This is the thumbnail URL
+  width?: number;
+  height?: number;
+  duration_seconds?: number;
+  metadata?: CreativeMetadata;
+  tags?: string[];
+  folder?: {
+    id: string;
+    name: string;
+  };
+  created_at: string;
+  updated_at?: string;
+  approved_at?: string;
+  rejected_at?: string;
+  approved_by?: string;
+  rejected_by?: string;
+}
+
+export interface CreativeUpload {
+  file: File;
+  company_id: string;
+  folder_id?: string;
+  tags?: string[];
+}
+
+export interface CreativeApprovePayload {
+  reviewer_id: string;
+  comments?: string;
+}
+
+export interface CreativeRejectPayload {
+  reviewer_id: string;
+  comments?: string;
+}
+
+export interface CreativeListResponse {
+  data: Creative[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    total_pages: number;
+  };
+}
+
+// Filter Types
+export interface FolderFilters {
+  page?: number;
+  limit?: number;
+  company_id?: string;
+  parent_id?: string;
+  search?: string;
+}
+
+export interface CreativeFilters {
+  page?: number;
+  limit?: number;
+  company_id?: string;
+  folder_id?: string;
+  search?: string;
+  status?: CreativeStatus;
+  transcode_status?: JobStatus;
+  tag?: string;
+  mime_type?: string; // Supports wildcards: 'image/*', 'video/*', 'audio/*'
+  format?: string;
+  min_size_bytes?: number;
+  max_size_bytes?: number;
+  min_duration?: number;
+  max_duration?: number;
+  resolution?: string; // e.g., '1920x1080', '3840x2160'
+}
+
+// API Response Types
+export interface ApiResponse<T> {
+  status: number;
+  result: T;
+  message?: string;
+}
+
+export interface ApiError {
+  status: number;
+  error: string;
+  message?: string;
+  details?: any;
+}
+
+// Helper type for pagination
+export interface PaginationParams {
+  page: number;
+  limit: number;
+}
+
+export interface PaginatedResponse<T> {
+  items: T[];
+  total: number;
+  page: number;
+  limit: number;
+  total_pages: number;
+}

package/client/src/types/geofencing.ts

@@ -0,0 +1,67 @@
+export interface MapGeometry {
+  type: 'Point' | 'Polygon' | 'Circle';
+  coordinates: number[] | number[][] | number[][][];
+  radius?: number;
+  poi?: string[];
+  metadata?: Record<string, string>;
+  enabled?: boolean;
+}
+
+export interface MapMarkerLocation {
+  id: string;
+  name: string;
+  latitude: number;
+  longitude: number;
+  radius?: number;
+  address?: string;
+  geometry?: MapGeometry;
+  properties?: Record<string, any>;
+  poi?: string[];
+  metadata?: Record<string, string>;
+  enabled?: boolean;
+}
+
+export interface GeoImportFile {
+  id: string;
+  fileName: string;
+  originalName?: string;
+  countryName: string;
+  uploadedAt: string;
+  uploadedBy?: string;
+  locationCount: number;
+  status: 'pending' | 'processing' | 'completed' | 'failed';
+  errorMessage?: string;
+}
+
+export interface GeoImportFilesParams {
+  page?: number;
+  limit?: number;
+  countryName?: string;
+  search?: string;
+}
+
+export interface GeoImportFilesResponse {
+  files: GeoImportFile[];
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+  };
+}
+
+export interface GeoImportLocationsResponse {
+  locations: MapMarkerLocation[];
+  total: number;
+}
+
+export interface UploadGeoCoordinatesResponse {
+  success: boolean;
+  file: GeoImportFile;
+  message?: string;
+}
+
+export interface GeoImportDeleteResponse {
+  success: boolean;
+  message?: string;
+}

package/client/src/types/transcoding.ts

@@ -0,0 +1,140 @@
+// Transcoding types for Content Hub API
+
+export type TranscodeProfile = "low" | "medium" | "high" | "preview" | "custom";
+
+export type TranscodeFormat = "mp4" | "webm" | "jpeg" | "png" | "mp3" | "wav" | "mpeg";
+
+export type JobStatus = "queued" | "running" | "completed" | "failed" | "cancelled" | "partial";
+
+export interface TranscodeRequest {
+  profiles: TranscodeProfile[];
+  target_formats?: TranscodeFormat[];
+}
+
+export interface TranscodeJob {
+  profile: TranscodeProfile;
+  format: TranscodeFormat;
+}
+
+export interface TranscodeResponse {
+  status: number;
+  result: {
+    creative_id: string;
+    jobs: TranscodeJob[];
+    auto_formats?: TranscodeFormat[];
+  };
+  message: string;
+}
+
+export interface TranscodedVariant {
+  id: string;
+  creative_id: string;
+  profile: TranscodeProfile;
+  format: TranscodeFormat;
+  storage_path: string;
+  cdn_path?: string;
+  file_size_bytes?: number;
+  width?: number;
+  height?: number;
+  duration_seconds?: number;
+  bitrate?: number;
+  created_at: string;
+}
+
+export interface TranscodingJob {
+  id: string;
+  creative_id: string;
+  company_id: string;
+  profile: TranscodeProfile;
+  target_format: TranscodeFormat;
+  status: JobStatus;
+  progress_percent?: number;
+  error_message?: string;
+  started_at?: string;
+  completed_at?: string;
+  created_at: string;
+}
+
+export interface TranscodingJobsFilters {
+  creative_id?: string;
+  company_id?: string;
+  status?: JobStatus;
+  page?: number;
+  limit?: number;
+}
+
+export interface TranscodingJobsResponse {
+  jobs: TranscodingJob[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+// Profile configuration metadata
+export interface ProfileConfig {
+  value: TranscodeProfile;
+  label: string;
+  description: string;
+}
+
+export const TRANSCODE_PROFILES: ProfileConfig[] = [
+  {
+    value: "low",
+    label: "Low Quality",
+    description: "Fast processing, smaller file sizes (good for previews)",
+  },
+  {
+    value: "medium",
+    label: "Medium Quality",
+    description: "Balanced quality and file size (recommended)",
+  },
+  {
+    value: "high",
+    label: "High Quality",
+    description: "Maximum quality output (larger files)",
+  },
+  {
+    value: "preview",
+    label: "Preview",
+    description: "Quick low-resolution preview generation",
+  },
+];
+
+// Format suggestions based on MIME type
+export const FORMAT_SUGGESTIONS: Record<string, TranscodeFormat[]> = {
+  "video/": ["mp4", "webm"],
+  "audio/": ["mp3", "wav"],
+  "image/": ["jpeg", "png"],
+};
+
+export function getSuggestedFormats(mimeType: string): TranscodeFormat[] {
+  for (const [prefix, formats] of Object.entries(FORMAT_SUGGESTIONS)) {
+    if (mimeType.startsWith(prefix)) {
+      return formats;
+    }
+  }
+  return [];
+}
+
+export function getFormatLabel(format: TranscodeFormat): string {
+  return format.toUpperCase();
+}
+
+export function getJobStatusColor(
+  status: JobStatus
+): "default" | "secondary" | "destructive" | "outline" {
+  switch (status) {
+    case "completed":
+      return "default";
+    case "running":
+    case "queued":
+      return "secondary";
+    case "failed":
+    case "cancelled":
+      return "destructive";
+    case "partial":
+      return "outline";
+    default:
+      return "outline";
+  }
+}

package/client/src/vite-env.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_INFLUENCE_DEALS_API_URL: string;
+  readonly VITE_OAUTH_API_URL: string;
+  readonly VITE_OAUTH_REDIRECT_URI: string;
+  readonly VITE_IAM_API_URL: string;
+  readonly VITE_CONTENT_HUB_API_URL: string;
+  readonly VITE_PLANNER_URL: string;
+  readonly VITE_INVENTORY_URL: string;
+  readonly VITE_MEASURE_URL: string;
+  readonly VITE_ACCOUNT_URL: string;
+  readonly VITE_INFLUENCE_URL: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/components.json

@@ -0,0 +1,20 @@
+{
+    "$schema": "https://ui.shadcn.com/schema.json",
+    "style": "new-york",
+    "rsc": false,
+    "tsx": true,
+    "tailwind": {
+      "config": "tailwind.config.ts",
+      "css": "client/src/index.css",
+      "baseColor": "neutral",
+      "cssVariables": true,
+      "prefix": ""
+    },
+    "aliases": {
+      "components": "@/components",
+      "utils": "@/lib/utils",
+      "ui": "@/components/ui",
+      "lib": "@/lib",
+      "hooks": "@/hooks"
+    }
+}

package/creative-api.json

@@ -0,0 +1 @@
+{"openapi":"3.1.0","info":{"title":"DOOH Content Hub API","description":"\n    ## Digital Out-of-Home Content Hub Microservice\n    \n    A production-grade FastAPI microservice for managing DOOH creative assets with advanced features:\n    \n    ### Key Features\n    * **Smart Metadata Extraction**: Automatic extraction for images, videos, audio, and HTML5 files\n    * **Intelligent Auto-Transcoding**: Videos → MP4+WebM, Audio → MP3+WAV, Images → JPEG+PNG\n    * **Folder Auto-Population**: Real-time statistics tracking for creative counts and summaries\n    * **AWS S3 Integration**: Secure cloud storage with CDN support\n    * **Comprehensive Audit Logging**: Full audit trail for all operations\n    * **Approval Workflows**: Built-in creative review and approval system\n    \n    ### Supported File Types\n    * **Images**: JPEG, PNG, GIF, WebP\n    * **Videos**: MP4, WebM, WMV, AVI, MOV\n    * **Audio**: MP3, WAV, AAC, OGG\n    * **HTML5**: Interactive HTML5 creatives\n    \n    ### API Versioning\n    Current Version: **v1** (prefix: `/api/v1/rest`)\n    ","version":"1.0.0"},"paths":{"/api/v1/rest/folders/":{"get":{"tags":["Folders"],"summary":"List Creative Folders","description":"Retrieve a paginated list of creative folders with optional filtering.\n    \n    **Features:**\n    - Pagination support (default: 20 items per page, max: 100)\n    - Filter by company, parent folder, or search term\n    - Returns folder statistics (creative counts, summaries)\n    \n    **Auto-Population:**\n    - Each folder includes `no_of_creatives` and `creatives` summary\n    - Statistics auto-update on creative upload, move, or delete","operationId":"list_folders_api_v1_rest_folders__get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (starts at 1)","default":1,"title":"Page"},"description":"Page number (starts at 1)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Items per page (max 100)","default":20,"title":"Limit"},"description":"Items per page (max 100)"},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by company ID","title":"Company Id"},"description":"Filter by company ID"},{"name":"parent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by parent folder ID","title":"Parent Id"},"description":"Filter by parent folder ID"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search term for folder name or description","title":"Search"},"description":"Search term for folder name or description"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Folders"],"summary":"Create New Folder","description":"Create a new creative folder for organizing assets.\n    \n    **Auto-Initialization:**\n    - Folder stats initialized to zero (no_of_creatives: 0)\n    - Empty creative summary created automatically\n    - Supports nested folder hierarchy via parent_id\n    \n    **Example Request:**\n    ```json\n    {\n      \"company_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n      \"name\": \"E2E Test Folder\",\n      \"description\": \"Real end-to-end testing\"\n    }\n    ```\n    \n    **Example Response:**\n    ```json\n    {\n      \"status\": 201,\n      \"result\": {\n        \"id\": \"786a812d-42cf-484a-9cfb-66f4bdd7113b\",\n        \"name\": \"E2E Test Folder\",\n        \"description\": \"Real end-to-end testing\",\n        \"company_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n        \"no_of_creatives\": 0,\n        \"creatives\": {},\n        \"created_at\": \"2025-11-06T04:15:00.123456\"\n      },\n      \"message\": \"Folder created\"\n    }\n    ```","operationId":"create_folder_api_v1_rest_folders__post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Folder Api V1 Rest Folders  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/folders/{folder_id}":{"get":{"tags":["Folders"],"summary":"Get Folder Details","description":"Retrieve detailed information about a specific folder.\n    \n    **Includes:**\n    - Folder metadata (name, description, hierarchy)\n    - Statistics (creative counts by status, format, total size)\n    - Auto-populated creative summary","operationId":"get_folder_api_v1_rest_folders__folder_id__get","parameters":[{"name":"folder_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Folder Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Folder Api V1 Rest Folders  Folder Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Folders"],"summary":"Update Folder","description":"Update an existing folder's properties.\n    \n    **Updatable Fields:**\n    - Name\n    - Description\n    - Parent folder (to reorganize hierarchy)\n    \n    **Note:** Folder statistics are auto-calculated and cannot be manually updated.","operationId":"update_folder_api_v1_rest_folders__folder_id__put","parameters":[{"name":"folder_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Folder Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Folder Api V1 Rest Folders  Folder Id  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Folders"],"summary":"Delete Folder","description":"Delete a folder. Folder must be empty (no creatives).\n    \n    **Safety:**\n    - Cannot delete folders containing creatives\n    - Move or delete creatives first before deleting folder","operationId":"delete_folder_api_v1_rest_folders__folder_id__delete","parameters":[{"name":"folder_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Folder Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Folder Api V1 Rest Folders  Folder Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/":{"get":{"tags":["Creatives"],"summary":"List Creatives","description":"Retrieve paginated list of creative assets with filtering.\n    \n    **Query Parameters:**\n    - `page` (int): Page number, default 1\n    - `limit` (int): Items per page, default 20, max 100\n    - `company_id` (UUID): Filter by company\n    - `folder_id` (UUID): Filter by folder\n    - `search` (string): Search filename\n    - `status` (enum): DRAFT, APPROVED, REJECTED\n    - `transcode_status` (enum): Filter by transcoding status\n    - `tag` (string): Filter by tag\n    - `mime_type` (string): MIME type filter, supports wildcards (e.g., `image/*`, `video/*`)\n    - `format` (string): File format (e.g., `mp4`, `jpeg`)\n    - `min_size_bytes`, `max_size_bytes` (int): File size range\n    - `min_duration`, `max_duration` (int): Duration range in seconds\n    - `resolution` (string): Resolution filter (e.g., `1920x1080`)\n    \n    **Response:** Includes pagination metadata and creative list with auto-extracted metadata (duration, dimensions, codec, etc.)","operationId":"list_creatives_api_v1_rest_creatives__get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (starts at 1)","default":1,"title":"Page"},"description":"Page number (starts at 1)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Items per page (max 100)","default":20,"title":"Limit"},"description":"Items per page (max 100)"},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by company ID","title":"Company Id"},"description":"Filter by company ID"},{"name":"folder_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by folder ID","title":"Folder Id"},"description":"Filter by folder ID"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search term for filename","title":"Search"},"description":"Search term for filename"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/CreativeStatus"},{"type":"null"}],"description":"Filter by creative status (DRAFT, APPROVED, REJECTED)","title":"Status"},"description":"Filter by creative status (DRAFT, APPROVED, REJECTED)"},{"name":"transcode_status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/JobStatus"},{"type":"null"}],"description":"Filter by transcoding status","title":"Transcode Status"},"description":"Filter by transcoding status"},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by tag","title":"Tag"},"description":"Filter by tag"},{"name":"mime_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by MIME type (e.g., 'image/jpeg', 'video/mp4'). Supports wildcards: 'image/*', 'video/*', 'audio/*'","title":"Mime Type"},"description":"Filter by MIME type (e.g., 'image/jpeg', 'video/mp4'). Supports wildcards: 'image/*', 'video/*', 'audio/*'"},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by file format (e.g., 'jpeg', 'mp4', 'png')","title":"Format"},"description":"Filter by file format (e.g., 'jpeg', 'mp4', 'png')"},{"name":"min_size_bytes","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Minimum file size in bytes","title":"Min Size Bytes"},"description":"Minimum file size in bytes"},{"name":"max_size_bytes","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Maximum file size in bytes","title":"Max Size Bytes"},"description":"Maximum file size in bytes"},{"name":"min_duration","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Minimum duration in seconds","title":"Min Duration"},"description":"Minimum duration in seconds"},{"name":"max_duration","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Maximum duration in seconds","title":"Max Duration"},"description":"Maximum duration in seconds"},{"name":"resolution","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by resolution (e.g., '1920x1080', '1280x720', '3840x2160')","title":"Resolution"},"description":"Filter by resolution (e.g., '1920x1080', '1280x720', '3840x2160')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Creatives"],"summary":"Upload Creative Asset","description":"Upload creative file with automatic metadata extraction and S3 storage.\n    \n    **Form Data (multipart/form-data):**\n    - `file` (required): Creative file\n    - `company_id` (UUID): Company ID\n    - `folder_id` (UUID): Folder ID\n    - `external_ref` (string): External reference\n    - `tags` (string): Comma-separated tags\n    \n    **Response (201 Created):**\n    ```json\n    {\n      \"status\": 201,\n      \"result\": {\n        \"id\": \"3d31d5e2-5b8e-42f6-88f7-7100dfde71df\",\n        \"filename\": \"video.mp4\",\n        \"created_at\": \"2025-11-06T04:15:12.345678\"\n      },\n      \"message\": \"Creative uploaded successfully\"\n    }\n    ```\n    \n    **Auto-Processing:** Metadata extraction, S3 upload, thumbnail generation, folder stats update, audit logging\n    \n    **Supported Formats:** JPEG, PNG, GIF, WebP, MP4, WebM, WMV, AVI, MOV, MP3, WAV, AAC, OGG, HTML5\n    \n    **Error Codes:**\n    - `400` - Invalid file type\n    - `404` - Folder not found\n    - `413` - File too large\n    - `422` - Validation error","operationId":"upload_creative_api_v1_rest_creatives__post","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_creative_api_v1_rest_creatives__post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Creative Api V1 Rest Creatives  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/from-url":{"post":{"tags":["Creatives"],"summary":"Create Creative from URL","description":"Create creative from URL with asynchronous metadata extraction. Returns immediately (HTTP 202) while metadata extraction happens in background.\n    \n    **Request Body:**\n    ```json\n    {\n      \"url\": \"https://cdn.example.com/video.mp4\",\n      \"filename\": \"video.mp4\",\n      \"company_id\": \"uuid\",\n      \"folder_id\": \"uuid\",\n      \"external_ref\": \"ref123\",\n      \"tags\": [\"tag1\", \"tag2\"]\n    }\n    ```\n    \n    **Required:** `url`, `filename`  \n    **Optional:** `company_id`, `folder_id`, `external_ref`, `tags`, `mime_type`, `width`, `height`, `duration_seconds`\n    \n    **Response (202 Accepted):**\n    ```json\n    {\n      \"status\": 202,\n      \"result\": {\n        \"id\": \"22607bac-47b3-4dcc-b75c-08fd0b649825\",\n        \"filename\": \"video.mp4\",\n        \"processing_status\": \"pending\",\n        \"created_at\": \"2025-11-07T16:10:30.421147\"\n      },\n      \"message\": \"Creative created successfully. Metadata extraction in progress.\"\n    }\n    ```\n    \n    **Metadata Extraction:** Automatically extracts duration, dimensions, codec, bitrate for videos/audio, and dimensions for images. Poll `GET /creatives/{id}` to check when `processing_status` changes to \"completed\".\n    \n    **Security:** SSRF protection blocks private IPs (127.0.0.0/8, 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, link-local, multicast). Max 3 redirects, 100MB file size limit, 30s timeout.\n    \n    **Supported Formats:** MP4, WebM, WMV, AVI, MOV, MP3, WAV, AAC, OGG, JPEG, PNG, GIF, WebP, HTML5\n    \n    **Error Codes:**\n    - `400` - Invalid URL scheme or private IP detected\n    - `404` - Folder not found\n    - `413` - File exceeds 100MB\n    - `422` - Invalid request data\n    - `502` - Failed to download from URL","operationId":"create_creative_from_url_api_v1_rest_creatives_from_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeURLCreate"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Creative From Url Api V1 Rest Creatives From Url Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/{creative_id}":{"put":{"tags":["Creatives"],"summary":"Update Creative","description":"Update creative properties with automatic audit logging and folder stats refresh.\n    \n    **Updatable Fields:**\n    - Folder ID (moves creative, updates both folder statistics)\n    - Tags\n    - External reference\n    \n    **Auto-Processing:**\n    - Creates audit log entry\n    - Updates folder statistics if folder changes\n    - Maintains version history","operationId":"update_creative_api_v1_rest_creatives__creative_id__put","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}},{"name":"performer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"ID of user performing the update","title":"Performer Id"},"description":"ID of user performing the update"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Creative Api V1 Rest Creatives  Creative Id  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Creatives"],"summary":"Get Creative Details","description":"Retrieve detailed information about a specific creative asset.\n    \n    **Includes:**\n    - Full metadata from auto-extraction\n    - Storage paths (S3 and CDN)\n    - Transcoding status and variants\n    - File integrity checksums\n    - Tags and version information","operationId":"get_creative_api_v1_rest_creatives__creative_id__get","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Creatives"],"summary":"Delete Creative","description":"Permanently delete a creative asset with automatic cleanup.\n    \n    **Auto-Processing:**\n    - Deletes file from S3 storage\n    - Removes all transcoded variants\n    - Creates audit log entry\n    - Updates parent folder statistics\n    - Cleans up all related database records\n    \n    **Warning:** This action cannot be undone!","operationId":"delete_creative_api_v1_rest_creatives__creative_id__delete","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}},{"name":"performer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"ID of user performing deletion","title":"Performer Id"},"description":"ID of user performing deletion"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Creative Api V1 Rest Creatives  Creative Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/{creative_id}/audit":{"get":{"tags":["Creatives"],"summary":"Get Audit Logs","description":"Retrieve complete audit trail for a creative asset.\n    \n    **Logged Actions:**\n    - CREATE: Initial upload\n    - UPDATE: Property modifications\n    - DELETE: Asset removal\n    - TRANSCODE: Transcoding requests\n    - APPROVE: Creative approval\n    - REJECT: Creative rejection\n    \n    **Each Entry Includes:**\n    - Action type and timestamp\n    - Performer ID (who performed the action)\n    - Change details (JSON payload)","operationId":"get_creative_audit_logs_api_v1_rest_creatives__creative_id__audit_get","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuditLogResponse"},"title":"Response Get Creative Audit Logs Api V1 Rest Creatives  Creative Id  Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/{creative_id}/transcode":{"post":{"tags":["Creatives"],"summary":"Initiate Transcoding","description":"Initiate intelligent transcoding for a creative asset.\n    \n    **Smart Auto-Format Selection:**\n    If `target_formats` is not specified, the system automatically selects optimal formats:\n    - **Videos** → MP4 + WebM (web-optimized delivery)\n    - **Audio** → MP3 (universal compatibility)\n    - **Images** → JPEG + PNG (web formats)\n    \n    **Example Request (Auto-Format for Video):**\n    ```\n    POST /api/v1/rest/creatives/140f4a7d-2f1b-42cf-8953-a358fc4b18ae/transcode\n    ```\n    ```json\n    {\n      \"profiles\": [\"medium\"]\n    }\n    ```\n    \n    **Example Request (Multiple Profiles with Custom Formats):**\n    ```\n    POST /api/v1/rest/creatives/140f4a7d-2f1b-42cf-8953-a358fc4b18ae/transcode\n    ```\n    ```json\n    {\n      \"profiles\": [\"high\", \"preview\"],\n      \"target_formats\": [\"mp4\", \"webm\"]\n    }\n    ```\n    \n    **Example Response (creates one job per profile × format combination):**\n    ```json\n    {\n      \"status\": 200,\n      \"result\": {\n        \"creative_id\": \"140f4a7d-2f1b-42cf-8953-a358fc4b18ae\",\n        \"jobs\": [\n          {\"profile\": \"high\", \"format\": \"mp4\"},\n          {\"profile\": \"high\", \"format\": \"webm\"},\n          {\"profile\": \"preview\", \"format\": \"mp4\"},\n          {\"profile\": \"preview\", \"format\": \"webm\"}\n        ],\n        \"auto_formats\": [\"mp4\", \"webm\"]\n      },\n      \"message\": \"Transcoding jobs initiated\"\n    }\n    ```\n    \n    **Note:** With 2 profiles × 2 formats = 4 jobs created\n    \n    **Quality Profiles:**\n    - LOW: Fast processing, smaller file size\n    - MEDIUM: Balanced quality and size\n    - HIGH: Maximum quality\n    - PREVIEW: Quick low-res preview\n    - CUSTOM: User-defined settings\n    \n    **Manual Override:**\n    Specify `target_formats` array to override auto-selection.\n    Supported: mp4, webm, jpeg, png, mp3, wav, mpeg\n    \n    **Auto-Processing:**\n    - Creates transcoding jobs for background worker\n    - Supports multiple profiles simultaneously\n    - Creates audit log entry","operationId":"initiate_transcode_api_v1_rest_creatives__creative_id__transcode_post","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}},{"name":"performer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"ID of user initiating transcode","title":"Performer Id"},"description":"ID of user initiating transcode"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscodeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Initiate Transcode Api V1 Rest Creatives  Creative Id  Transcode Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/{creative_id}/transcodes":{"get":{"tags":["Creatives"],"summary":"Get Transcoded Files","description":"Retrieve all transcoded variants of a creative asset.\n    \n    **Returns:**\n    - List of all successfully transcoded files\n    - Each entry includes format, profile, storage paths, and file size\n    - Only COMPLETED transcodes are returned","operationId":"get_transcoded_files_api_v1_rest_creatives__creative_id__transcodes_get","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TranscodedFileResponse"},"title":"Response Get Transcoded Files Api V1 Rest Creatives  Creative Id  Transcodes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/{creative_id}/transcoded-files":{"get":{"tags":["Creatives"],"summary":"Get Transcoded Files (Alias)","description":"Alias for /transcodes endpoint","operationId":"get_transcoded_files_alias_api_v1_rest_creatives__creative_id__transcoded_files_get","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TranscodedFileResponse"},"title":"Response Get Transcoded Files Alias Api V1 Rest Creatives  Creative Id  Transcoded Files Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/{creative_id}/approve":{"post":{"tags":["Creatives"],"summary":"Approve Creative","description":"Approve a creative asset as part of the review workflow.\n    \n    **Workflow:**\n    - Updates creative status to APPROVED\n    - Creates review record with reviewer ID and comments\n    - Creates audit log entry\n    - Optional: Add reviewer comments\n    \n    **Use Case:**\n    Quality control and approval workflows for DOOH content before deployment.","operationId":"approve_creative_api_v1_rest_creatives__creative_id__approve_post","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveRejectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Approve Creative Api V1 Rest Creatives  Creative Id  Approve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/creatives/{creative_id}/reject":{"post":{"tags":["Creatives"],"summary":"Reject Creative","description":"Reject a creative asset as part of the review workflow.\n    \n    **Workflow:**\n    - Updates creative status to REJECTED\n    - Creates review record with reviewer ID and rejection reason\n    - Creates audit log entry\n    - Requires comments explaining rejection reason\n    \n    **Use Case:**\n    Quality control workflow when content doesn't meet requirements.\n    Rejection comments guide content creators on necessary changes.","operationId":"reject_creative_api_v1_rest_creatives__creative_id__reject_post","parameters":[{"name":"creative_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creative Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveRejectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reject Creative Api V1 Rest Creatives  Creative Id  Reject Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/rest/transcoding/jobs/":{"get":{"tags":["Transcoding Jobs"],"summary":"List Transcoding Jobs","operationId":"list_transcoding_jobs_api_v1_rest_transcoding_jobs__get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"creative_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Creative Id"}},{"name":"company_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/JobStatus"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscodingJobListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","description":"Enhanced health check endpoint with comprehensive system statistics.\n\nReturns:\n- status: Application health status (UP/DOWN)\n- uptime: How long the application has been running\n- timestamp: Current server time\n- system: CPU, memory, and disk usage statistics\n- database: Database connectivity status\n- worker: Transcoding worker status","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}}},"components":{"schemas":{"ActionType":{"type":"string","enum":["create","update","delete","approve","reject","transcode","publish"],"title":"ActionType"},"ApproveRejectRequest":{"properties":{"reviewer_id":{"type":"string","format":"uuid","title":"Reviewer Id"},"comments":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comments"}},"type":"object","required":["reviewer_id"],"title":"ApproveRejectRequest"},"AuditLogResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"creative_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Creative Id"},"entity_type":{"type":"string","title":"Entity Type"},"entity_id":{"type":"string","format":"uuid","title":"Entity Id"},"action":{"$ref":"#/components/schemas/ActionType"},"performed_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Performed By"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","creative_id","entity_type","entity_id","action","performed_by","details","created_at"],"title":"AuditLogResponse"},"Body_upload_creative_api_v1_rest_creatives__post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"Creative file to upload"},"company_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Id","description":"Company ID (optional)"},"folder_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Folder Id","description":"Folder ID for organization"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref","description":"External reference ID"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags","description":"Comma-separated tags"}},"type":"object","required":["file"],"title":"Body_upload_creative_api_v1_rest_creatives__post"},"CreativeDetailResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"company_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Id"},"uploader_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Uploader Id"},"folder_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Folder Id"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"},"storage_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Storage Path"},"cdn_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdn Path"},"thumbnail":{"type":"string","title":"Thumbnail"},"filename":{"type":"string","title":"Filename"},"format":{"type":"string","title":"Format"},"mime_type":{"type":"string","title":"Mime Type"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"codec":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"status":{"$ref":"#/components/schemas/CreativeStatus"},"transcode_status":{"$ref":"#/components/schemas/JobStatus"},"validation_errors":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Validation Errors"},"meta":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta"},"transcoded_variants":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Transcoded Variants"},"version":{"type":"integer","title":"Version"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","company_id","uploader_id","folder_id","external_ref","storage_path","cdn_path","thumbnail","filename","format","mime_type","duration_seconds","width","height","aspect_ratio","codec","size_bytes","status","transcode_status","validation_errors","meta","transcoded_variants","version","checksum","tags","created_at","updated_at"],"title":"CreativeDetailResponse"},"CreativeListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CreativeResponse"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PaginationResponse"}},"type":"object","required":["data","pagination"],"title":"CreativeListResponse"},"CreativeResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"filename":{"type":"string","title":"Filename"},"format":{"type":"string","title":"Format"},"mime_type":{"type":"string","title":"Mime Type"},"thumbnail":{"type":"string","title":"Thumbnail"},"cdn_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdn Path"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"status":{"$ref":"#/components/schemas/CreativeStatus"},"transcode_status":{"$ref":"#/components/schemas/JobStatus"},"transcoded_variants":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Transcoded Variants"},"folder":{"anyOf":[{"$ref":"#/components/schemas/FolderInfo"},{"type":"null"}]},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","filename","format","mime_type","thumbnail","cdn_path","duration_seconds","width","height","size_bytes","status","transcode_status","transcoded_variants","folder","tags","created_at"],"title":"CreativeResponse"},"CreativeStatus":{"type":"string","enum":["draft","pending_approval","processing","accepted","inadequate","approved","rejected","archived"],"title":"CreativeStatus"},"CreativeURLCreate":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"filename":{"type":"string","title":"Filename"},"company_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Id"},"folder_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Folder Id"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"}},"type":"object","required":["url","filename"],"title":"CreativeURLCreate","description":"Schema for creating a creative from URL with automatic metadata extraction."},"CreativeUpdate":{"properties":{"folder_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Folder Id"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"}},"type":"object","title":"CreativeUpdate"},"CreativesCount":{"properties":{"image":{"type":"integer","title":"Image","default":0},"video":{"type":"integer","title":"Video","default":0},"audio":{"type":"integer","title":"Audio","default":0},"others":{"type":"integer","title":"Others","default":0}},"type":"object","title":"CreativesCount"},"FolderCreate":{"properties":{"company_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Id"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"},"name":{"type":"string","minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["name"],"title":"FolderCreate"},"FolderInfo":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"FolderInfo"},"FolderListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/FolderResponse"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PaginationResponse"}},"type":"object","required":["data","pagination"],"title":"FolderListResponse"},"FolderResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"},"no_of_creatives":{"type":"integer","title":"No Of Creatives"},"creatives":{"$ref":"#/components/schemas/CreativesCount"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","parent_id","no_of_creatives","creatives","created_at","updated_at"],"title":"FolderResponse"},"FolderUpdate":{"properties":{"name":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Parent Id"}},"type":"object","title":"FolderUpdate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"JobStatus":{"type":"string","enum":["none","queued","running","completed","failed","cancelled","partial"],"title":"JobStatus"},"PaginationResponse":{"properties":{"page":{"type":"integer","title":"Page"},"limit":{"type":"integer","title":"Limit"},"total":{"type":"integer","title":"Total"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["page","limit","total","pages"],"title":"PaginationResponse"},"TranscodeProfile":{"type":"string","enum":["low","medium","high","preview","custom"],"title":"TranscodeProfile"},"TranscodeRequest":{"properties":{"profiles":{"items":{"$ref":"#/components/schemas/TranscodeProfile"},"type":"array","title":"Profiles"},"target_formats":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Formats"}},"type":"object","required":["profiles"],"title":"TranscodeRequest"},"TranscodedFileResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"creative_id":{"type":"string","format":"uuid","title":"Creative Id"},"profile":{"$ref":"#/components/schemas/TranscodeProfile"},"output_path":{"type":"string","title":"Output Path"},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"bitrate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bitrate"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"checksum":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checksum"},"status":{"$ref":"#/components/schemas/JobStatus"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","creative_id","profile","output_path","mime_type","format","width","height","bitrate","duration_seconds","size_bytes","checksum","status","metadata","created_at","updated_at"],"title":"TranscodedFileResponse"},"TranscodingJobListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TranscodingJobResponse"},"type":"array","title":"Data"},"pagination":{"$ref":"#/components/schemas/PaginationResponse"}},"type":"object","required":["data","pagination"],"title":"TranscodingJobListResponse"},"TranscodingJobResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"creative_id":{"type":"string","format":"uuid","title":"Creative Id"},"company_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Id"},"profile":{"$ref":"#/components/schemas/TranscodeProfile"},"input_path":{"type":"string","title":"Input Path"},"output_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Output Path"},"target_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Format"},"status":{"$ref":"#/components/schemas/JobStatus"},"logs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logs"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"finished_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished At"},"attempts":{"type":"integer","title":"Attempts"},"output_file_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Output File Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","creative_id","company_id","profile","input_path","output_path","target_format","status","logs","error_message","started_at","finished_at","attempts","output_file_id","created_at","updated_at"],"title":"TranscodingJobResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}