@camstack/types 0.1.0 → 0.1.2

package/dist/index.mjs

@@ -1,37 +1,577 @@
-import {
-  ANIMAL_TYPE_MODELS,
-  AUDIO_CLASSIFICATION_MODELS,
-  BIRD_NABIRDS_MODELS,
-  BIRD_SPECIES_MODELS,
-  COCO_80_LABELS,
-  COCO_TO_MACRO,
-  FACE_DETECTION_MODELS,
-  FACE_RECOGNITION_MODELS,
-  HF_BASE_URL,
-  HF_REPO,
-  MACRO_LABELS,
-  OBJECT_DETECTION_MODELS,
-  PLATE_DETECTION_MODELS,
-  PLATE_RECOGNITION_MODELS,
-  SEGMENTATION_MODELS,
-  hfModelUrl
-} from "./chunk-QNLZQW6W.mjs";
+// src/interfaces/storage-backend.ts
+var DEFAULT_LOCATION_SUBPATHS = {
+  "recordings-high": "recordings-high",
+  "recordings-low": "recordings-low",
+  "recordings-clips": "recordings-clips",
+  "event-images": "event-images",
+  "models": "models",
+  "addons-data": "addons-data",
+  "cache": "/tmp/camstack-cache",
+  "logs": "logs"
+};
+
+// src/interfaces/addon-i18n.ts
+function resolveTranslation(provider, locale, key) {
+  if (provider.getTranslations) {
+    const map = provider.getTranslations(locale);
+    if (map && key in map) return map[key];
+    if (locale !== "en") {
+      const fallback = provider.getTranslations("en");
+      if (fallback && key in fallback) return fallback[key];
+    }
+  }
+  if (provider.getTranslationBundle) {
+    const bundle = provider.getTranslationBundle();
+    const map = bundle[locale];
+    if (map && key in map) return map[key];
+    if (locale !== "en") {
+      const fallback = bundle["en"];
+      if (fallback && key in fallback) return fallback[key];
+    }
+  }
+  return key;
+}
+
+// src/interfaces/feature-flags.ts
+var DEFAULT_FEATURES = {
+  streaming: true,
+  notifications: true,
+  objectDetection: false,
+  remoteAccess: true,
+  agentCluster: false,
+  smartHome: true,
+  recordings: true,
+  backup: true,
+  repl: true
+};
+
+// src/interfaces/agent-protocol.ts
+var BINARY_FRAME_HEADER_SIZE = 29;
+var BINARY_FRAME_TYPE = 1;
+
+// src/interfaces/server-analysis.ts
+var DETECTION_TYPES = ["person", "vehicle", "animal", "package"];
+var SUB_DETECTION_TYPES = ["face", "plate"];
+var RECOGNITION_TYPES = ["face", "plate", "clip", "custom"];
+function createAnalysisContext(deviceId, frame, rawDetections) {
+  return {
+    deviceId,
+    frame,
+    timestamp: frame.timestamp,
+    rawDetections,
+    trackedDetections: [],
+    events: [],
+    metadata: {}
+  };
+}
+function enrichContext(ctx, updates) {
+  return {
+    ...ctx,
+    trackedDetections: updates.trackedDetections ?? ctx.trackedDetections,
+    events: updates.events ?? ctx.events,
+    metadata: updates.metadata ? { ...ctx.metadata, ...updates.metadata } : ctx.metadata
+  };
+}
+
+// src/interfaces/analysis-persistence.ts
+var DEFAULT_RETENTION = {
+  cleanupIntervalMs: 60 * 60 * 1e3,
+  detectionEventsDays: 30,
+  audioLevelsDays: 7,
+  snapshotsDays: 14
+};
+
+// src/schemas/system-settings-schemas.ts
+var READ_ONLY_SECTIONS = /* @__PURE__ */ new Set([
+  "server"
+]);
+var SETTINGS_TABS = [
+  { id: "server", label: "Server" },
+  { id: "logging", label: "Logs" },
+  { id: "recording", label: "Recording" },
+  { id: "ffmpeg", label: "FFmpeg" },
+  { id: "detection", label: "Detection" },
+  { id: "auth", label: "Auth" },
+  { id: "retention", label: "Retention" }
+];
+var SERVER_SCHEMA = {
+  sections: [
+    {
+      id: "server-info",
+      title: "Server",
+      description: "Core server connection settings (read-only)",
+      columns: 2,
+      fields: [
+        {
+          type: "info",
+          key: "server-restart-note",
+          label: "Restart required",
+          content: "Server settings are read-only. Change them in config.yaml and restart.",
+          variant: "warning"
+        },
+        {
+          type: "text",
+          key: "port",
+          label: "Port",
+          disabled: true,
+          description: "Listening port"
+        },
+        {
+          type: "text",
+          key: "host",
+          label: "Host",
+          disabled: true,
+          description: "Bind address"
+        },
+        {
+          type: "text",
+          key: "dataPath",
+          label: "Data Path",
+          disabled: true,
+          description: "Root data directory",
+          span: 2
+        }
+      ]
+    }
+  ]
+};
+var STORAGE_SCHEMA = {
+  sections: []
+};
+var LOGGING_SCHEMA = {
+  sections: [
+    {
+      id: "logging-settings",
+      title: "Logging",
+      description: "Global log verbosity. Retention is managed per log-destination addon.",
+      columns: 1,
+      fields: [
+        {
+          type: "select",
+          key: "level",
+          label: "Log Level",
+          options: [
+            { value: "debug", label: "Debug" },
+            { value: "info", label: "Info" },
+            { value: "warn", label: "Warn" },
+            { value: "error", label: "Error" }
+          ]
+        }
+      ]
+    }
+  ]
+};
+var RECORDING_SCHEMA = {
+  sections: [
+    {
+      id: "recording-settings",
+      title: "Recording",
+      description: "Video recording segment and retention defaults",
+      columns: 2,
+      fields: [
+        {
+          type: "number",
+          key: "segmentDurationSeconds",
+          label: "Segment Duration",
+          description: "Length of each recording segment",
+          min: 1,
+          max: 60,
+          step: 1,
+          unit: "seconds"
+        },
+        {
+          type: "number",
+          key: "defaultRetentionDays",
+          label: "Default Retention",
+          description: "Days to keep recordings before auto-delete",
+          min: 1,
+          max: 365,
+          step: 1,
+          unit: "days"
+        }
+      ]
+    }
+  ]
+};
+var FFMPEG_SCHEMA = {
+  sections: [
+    {
+      id: "ffmpeg-settings",
+      title: "FFmpeg",
+      description: "FFmpeg binary and hardware acceleration settings",
+      columns: 2,
+      fields: [
+        {
+          type: "text",
+          key: "binaryPath",
+          label: "Binary Path",
+          description: "Path to ffmpeg executable",
+          placeholder: "ffmpeg",
+          span: 2
+        },
+        {
+          type: "select",
+          key: "hwAccel",
+          label: "Hardware Acceleration",
+          description: "GPU decoding/encoding backend",
+          options: [
+            { value: "auto", label: "Auto-detect" },
+            { value: "none", label: "None (CPU only)" },
+            { value: "videotoolbox", label: "VideoToolbox (macOS)" },
+            { value: "vaapi", label: "VA-API (Linux Intel/AMD)" },
+            { value: "qsv", label: "QSV (Intel Quick Sync)" },
+            { value: "cuda", label: "CUDA (NVIDIA)" }
+          ]
+        },
+        {
+          type: "number",
+          key: "threadCount",
+          label: "Thread Count",
+          description: "0 = auto (let FFmpeg decide)",
+          min: 0,
+          max: 16,
+          step: 1
+        }
+      ]
+    }
+  ]
+};
+var DETECTION_SCHEMA = {
+  sections: [
+    {
+      id: "detection-fps",
+      title: "Frame Rates",
+      description: "Default analysis frame rates for new cameras",
+      columns: 2,
+      fields: [
+        {
+          type: "number",
+          key: "defaultMotionFps",
+          label: "Motion FPS",
+          description: "Frames per second for motion detection",
+          min: 1,
+          max: 30,
+          step: 1,
+          unit: "fps"
+        },
+        {
+          type: "number",
+          key: "defaultDetectionFps",
+          label: "Detection FPS",
+          description: "Frames per second for object detection",
+          min: 1,
+          max: 30,
+          step: 1,
+          unit: "fps"
+        }
+      ]
+    },
+    {
+      id: "detection-thresholds",
+      title: "Thresholds",
+      description: "Default confidence and cooldown for detections",
+      columns: 2,
+      fields: [
+        {
+          type: "slider",
+          key: "defaultConfidenceThreshold",
+          label: "Confidence Threshold",
+          description: "Minimum confidence to trigger a detection event",
+          min: 0.1,
+          max: 1,
+          step: 0.05,
+          showValue: true
+        },
+        {
+          type: "number",
+          key: "defaultCooldownSeconds",
+          label: "Cooldown",
+          description: "Seconds between duplicate events",
+          min: 0,
+          max: 300,
+          step: 1,
+          unit: "seconds"
+        }
+      ]
+    },
+    {
+      id: "detection-tracker",
+      title: "Tracker",
+      description: "SORT/IoU tracker parameters",
+      columns: 3,
+      fields: [
+        {
+          type: "number",
+          key: "trackerMaxAgeFrames",
+          label: "Max Age",
+          description: "Frames before a lost track is removed",
+          min: 1,
+          max: 120,
+          step: 1,
+          unit: "frames"
+        },
+        {
+          type: "number",
+          key: "trackerMinHits",
+          label: "Min Hits",
+          description: "Consecutive detections to confirm a track",
+          min: 1,
+          max: 20,
+          step: 1
+        },
+        {
+          type: "slider",
+          key: "trackerIouThreshold",
+          label: "IoU Threshold",
+          description: "Minimum IoU to associate detection with track",
+          min: 0.1,
+          max: 0.9,
+          step: 0.05,
+          showValue: true
+        }
+      ]
+    }
+  ]
+};
+var AUTH_SCHEMA = {
+  sections: [
+    {
+      id: "auth-settings",
+      title: "Authentication",
+      description: "Token and session settings",
+      columns: 1,
+      fields: [
+        {
+          type: "text",
+          key: "tokenExpiry",
+          label: "Token Expiry",
+          description: "JWT token lifetime (e.g. 24h, 7d, 1h)",
+          placeholder: "24h"
+        }
+      ]
+    }
+  ]
+};
+var RETENTION_SCHEMA = {
+  sections: [
+    {
+      id: "retention-settings",
+      title: "Retention",
+      description: "Data retention periods for analytics data",
+      columns: 1,
+      fields: [
+        {
+          type: "slider",
+          key: "detectionEventsDays",
+          label: "Detection Events Retention",
+          min: 1,
+          max: 365,
+          unit: "days",
+          showValue: true,
+          span: 1
+        },
+        {
+          type: "slider",
+          key: "audioLevelsDays",
+          label: "Audio Levels Retention",
+          min: 1,
+          max: 90,
+          unit: "days",
+          showValue: true,
+          span: 1
+        }
+      ]
+    }
+  ]
+};
+var SYSTEM_SETTINGS_SCHEMAS = {
+  server: SERVER_SCHEMA,
+  storage: STORAGE_SCHEMA,
+  logging: LOGGING_SCHEMA,
+  recording: RECORDING_SCHEMA,
+  ffmpeg: FFMPEG_SCHEMA,
+  detection: DETECTION_SCHEMA,
+  auth: AUTH_SCHEMA,
+  retention: RETENTION_SCHEMA,
+  // These sections have no UI form — managed programmatically or addon-specific
+  streaming: { sections: [] },
+  backup: { sections: [] },
+  features: { sections: [] },
+  addons: { sections: [] }
+};
+function getSystemSettingsSchema(section) {
+  return SYSTEM_SETTINGS_SCHEMAS[section];
+}
+
+// src/constants.ts
+var HF_REPO = "camstack/camstack-models";
+var HF_BASE_URL = `https://huggingface.co/${HF_REPO}/resolve/main`;
+
+// src/utils/hf-url.ts
+function hfModelUrl(repo, path) {
+  return `https://huggingface.co/${repo}/resolve/main/${path}`;
+}
+
+// src/utils/cosine-similarity.ts
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length) return 0;
+  let dotProduct = 0;
+  let normA = 0;
+  let normB = 0;
+  for (let i = 0; i < a.length; i++) {
+    dotProduct += a[i] * b[i];
+    normA += a[i] * a[i];
+    normB += b[i] * b[i];
+  }
+  const denom = Math.sqrt(normA) * Math.sqrt(normB);
+  return denom === 0 ? 0 : dotProduct / denom;
+}
+
+// src/catalogs/coco-classmap.ts
+var COCO_80_LABELS = [
+  { id: "person", name: "Person" },
+  { id: "bicycle", name: "Bicycle" },
+  { id: "car", name: "Car" },
+  { id: "motorcycle", name: "Motorcycle" },
+  { id: "airplane", name: "Airplane" },
+  { id: "bus", name: "Bus" },
+  { id: "train", name: "Train" },
+  { id: "truck", name: "Truck" },
+  { id: "boat", name: "Boat" },
+  { id: "traffic light", name: "Traffic Light" },
+  { id: "fire hydrant", name: "Fire Hydrant" },
+  { id: "stop sign", name: "Stop Sign" },
+  { id: "parking meter", name: "Parking Meter" },
+  { id: "bench", name: "Bench" },
+  { id: "bird", name: "Bird" },
+  { id: "cat", name: "Cat" },
+  { id: "dog", name: "Dog" },
+  { id: "horse", name: "Horse" },
+  { id: "sheep", name: "Sheep" },
+  { id: "cow", name: "Cow" },
+  { id: "elephant", name: "Elephant" },
+  { id: "bear", name: "Bear" },
+  { id: "zebra", name: "Zebra" },
+  { id: "giraffe", name: "Giraffe" },
+  { id: "backpack", name: "Backpack" },
+  { id: "umbrella", name: "Umbrella" },
+  { id: "handbag", name: "Handbag" },
+  { id: "tie", name: "Tie" },
+  { id: "suitcase", name: "Suitcase" },
+  { id: "frisbee", name: "Frisbee" },
+  { id: "skis", name: "Skis" },
+  { id: "snowboard", name: "Snowboard" },
+  { id: "sports ball", name: "Sports Ball" },
+  { id: "kite", name: "Kite" },
+  { id: "baseball bat", name: "Baseball Bat" },
+  { id: "baseball glove", name: "Baseball Glove" },
+  { id: "skateboard", name: "Skateboard" },
+  { id: "surfboard", name: "Surfboard" },
+  { id: "tennis racket", name: "Tennis Racket" },
+  { id: "bottle", name: "Bottle" },
+  { id: "wine glass", name: "Wine Glass" },
+  { id: "cup", name: "Cup" },
+  { id: "fork", name: "Fork" },
+  { id: "knife", name: "Knife" },
+  { id: "spoon", name: "Spoon" },
+  { id: "bowl", name: "Bowl" },
+  { id: "banana", name: "Banana" },
+  { id: "apple", name: "Apple" },
+  { id: "sandwich", name: "Sandwich" },
+  { id: "orange", name: "Orange" },
+  { id: "broccoli", name: "Broccoli" },
+  { id: "carrot", name: "Carrot" },
+  { id: "hot dog", name: "Hot Dog" },
+  { id: "pizza", name: "Pizza" },
+  { id: "donut", name: "Donut" },
+  { id: "cake", name: "Cake" },
+  { id: "chair", name: "Chair" },
+  { id: "couch", name: "Couch" },
+  { id: "potted plant", name: "Potted Plant" },
+  { id: "bed", name: "Bed" },
+  { id: "dining table", name: "Dining Table" },
+  { id: "toilet", name: "Toilet" },
+  { id: "tv", name: "TV" },
+  { id: "laptop", name: "Laptop" },
+  { id: "mouse", name: "Mouse" },
+  { id: "remote", name: "Remote" },
+  { id: "keyboard", name: "Keyboard" },
+  { id: "cell phone", name: "Cell Phone" },
+  { id: "microwave", name: "Microwave" },
+  { id: "oven", name: "Oven" },
+  { id: "toaster", name: "Toaster" },
+  { id: "sink", name: "Sink" },
+  { id: "refrigerator", name: "Refrigerator" },
+  { id: "book", name: "Book" },
+  { id: "clock", name: "Clock" },
+  { id: "vase", name: "Vase" },
+  { id: "scissors", name: "Scissors" },
+  { id: "teddy bear", name: "Teddy Bear" },
+  { id: "hair drier", name: "Hair Drier" },
+  { id: "toothbrush", name: "Toothbrush" }
+];
+var MACRO_LABELS = [
+  { id: "person", name: "Person" },
+  { id: "vehicle", name: "Vehicle" },
+  { id: "animal", name: "Animal" }
+];
+var COCO_TO_MACRO = {
+  mapping: {
+    person: "person",
+    bicycle: "vehicle",
+    car: "vehicle",
+    motorcycle: "vehicle",
+    airplane: "vehicle",
+    bus: "vehicle",
+    train: "vehicle",
+    truck: "vehicle",
+    boat: "vehicle",
+    bird: "animal",
+    cat: "animal",
+    dog: "animal",
+    horse: "animal",
+    sheep: "animal",
+    cow: "animal",
+    elephant: "animal",
+    bear: "animal",
+    zebra: "animal",
+    giraffe: "animal"
+  },
+  preserveOriginal: true
+};
+
+// src/types/device-type.ts
+var DeviceType = /* @__PURE__ */ ((DeviceType2) => {
+  DeviceType2["Camera"] = "camera";
+  return DeviceType2;
+})(DeviceType || {});
+var DEVICE_TYPE_INFO = {
+  ["camera" /* Camera */]: { type: "camera" /* Camera */, label: "Camera", icon: "camera" }
+};
 export {
-  ANIMAL_TYPE_MODELS,
-  AUDIO_CLASSIFICATION_MODELS,
-  BIRD_NABIRDS_MODELS,
-  BIRD_SPECIES_MODELS,
+  BINARY_FRAME_HEADER_SIZE,
+  BINARY_FRAME_TYPE,
   COCO_80_LABELS,
   COCO_TO_MACRO,
-  FACE_DETECTION_MODELS,
-  FACE_RECOGNITION_MODELS,
+  DEFAULT_FEATURES,
+  DEFAULT_LOCATION_SUBPATHS,
+  DEFAULT_RETENTION,
+  DETECTION_TYPES,
+  DEVICE_TYPE_INFO,
+  DeviceType,
   HF_BASE_URL,
   HF_REPO,
   MACRO_LABELS,
-  OBJECT_DETECTION_MODELS,
-  PLATE_DETECTION_MODELS,
-  PLATE_RECOGNITION_MODELS,
-  SEGMENTATION_MODELS,
-  hfModelUrl
+  READ_ONLY_SECTIONS,
+  RECOGNITION_TYPES,
+  SETTINGS_TABS,
+  SUB_DETECTION_TYPES,
+  SYSTEM_SETTINGS_SCHEMAS,
+  cosineSimilarity,
+  createAnalysisContext,
+  enrichContext,
+  getSystemSettingsSchema,
+  hfModelUrl,
+  resolveTranslation
 };
 //# sourceMappingURL=index.mjs.map