@trillboards/edge-sdk 0.1.0

package/configs/backpackster.json

@@ -0,0 +1,32 @@
+{
+  "apiBaseUrl": "https://api.trillboards.com",
+  "deviceToken": "REPLACE_WITH_YOUR_TOKEN",
+  "screenId": "REPLACE_WITH_SCREEN_ID",
+  "venueType": "mobile_ooh",
+  "platform": "linux",
+  "camera": {
+    "enabled": true,
+    "deviceId": "/dev/video0",
+    "width": 640,
+    "height": 480,
+    "fps": 5
+  },
+  "audio": {
+    "enabled": false
+  },
+  "models": {
+    "dir": "/opt/trillboards/models",
+    "executionProvider": "openvino"
+  },
+  "kiosk": {
+    "enabled": false
+  },
+  "cloud": {
+    "enabled": false
+  },
+  "federated": {
+    "enabled": true
+  },
+  "dataDir": "/var/lib/trillboards",
+  "logLevel": "info"
+}

package/configs/generic-linux.json

@@ -0,0 +1,31 @@
+{
+  "apiBaseUrl": "https://api.trillboards.com",
+  "deviceToken": "REPLACE_WITH_YOUR_TOKEN",
+  "screenId": "REPLACE_WITH_SCREEN_ID",
+  "venueType": "retail",
+  "camera": {
+    "enabled": true,
+    "deviceId": "/dev/video0",
+    "width": 640,
+    "height": 480,
+    "fps": 5
+  },
+  "audio": {
+    "enabled": true
+  },
+  "models": {
+    "dir": "./models",
+    "executionProvider": "cpu"
+  },
+  "kiosk": {
+    "enabled": true,
+    "url": "https://screen.trillboards.com"
+  },
+  "cloud": {
+    "enabled": false
+  },
+  "federated": {
+    "enabled": false
+  },
+  "logLevel": "info"
+}

package/configs/windows-dooh.json

@@ -0,0 +1,35 @@
+{
+  "apiBaseUrl": "https://api.trillboards.com",
+  "deviceToken": "REPLACE_WITH_YOUR_TOKEN",
+  "screenId": "REPLACE_WITH_SCREEN_ID",
+  "venueType": "roadside_billboard",
+  "platform": "windows",
+  "camera": {
+    "enabled": true,
+    "rtspUrl": "rtsp://admin:password@192.168.1.100:554/stream1",
+    "width": 1280,
+    "height": 720,
+    "fps": 3
+  },
+  "audio": {
+    "enabled": false
+  },
+  "models": {
+    "dir": "C:\\trillboards\\models",
+    "executionProvider": "directml"
+  },
+  "kiosk": {
+    "enabled": true,
+    "url": "https://screen.trillboards.com",
+    "chromiumPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
+  },
+  "cloud": {
+    "enabled": true,
+    "geminiApiKey": "REPLACE_WITH_GEMINI_KEY"
+  },
+  "federated": {
+    "enabled": false
+  },
+  "dataDir": "C:\\ProgramData\\trillboards",
+  "logLevel": "info"
+}

package/deploy/docker/.dockerignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+*.md
+.git

package/deploy/docker/Dockerfile

@@ -0,0 +1,31 @@
+FROM node:20-slim AS base
+
+# Install ffmpeg for camera/audio capture
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends ffmpeg v4l-utils pulseaudio-utils && \
+    rm -rf /var/lib/apt/lists/*
+
+WORKDIR /opt/trillboards
+
+# Install SDK
+COPY package.json ./
+RUN npm install --omit=dev
+
+# Download models
+RUN npx trillboards-edge download-models --dir /opt/trillboards/models || true
+
+# Copy config (override at runtime with -v)
+COPY config.json ./trillboards.config.json
+
+# Non-root user
+RUN useradd --system --no-create-home trillboards && \
+    mkdir -p /var/lib/trillboards && \
+    chown -R trillboards:trillboards /opt/trillboards /var/lib/trillboards
+
+USER trillboards
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=5s \
+  CMD node -e "process.exit(0)"
+
+ENTRYPOINT ["npx", "trillboards-edge", "start", "--config", "trillboards.config.json"]

package/deploy/docker/config.json

@@ -0,0 +1,21 @@
+{
+  "apiBaseUrl": "https://api.trillboards.com",
+  "deviceToken": "REPLACE_WITH_YOUR_TOKEN",
+  "screenId": "REPLACE_WITH_SCREEN_ID",
+  "camera": {
+    "enabled": true,
+    "deviceId": "/dev/video0"
+  },
+  "audio": {
+    "enabled": false
+  },
+  "models": {
+    "dir": "/opt/trillboards/models",
+    "executionProvider": "cpu"
+  },
+  "kiosk": {
+    "enabled": false
+  },
+  "dataDir": "/var/lib/trillboards",
+  "logLevel": "info"
+}

package/deploy/docker/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "trillboards-edge-docker",
+  "version": "0.1.0",
+  "private": true,
+  "dependencies": {
+    "@trillboards/edge-sdk": "0.1.0",
+    "@trillboards/edge-platform-linux": "0.1.0"
+  }
+}

package/deploy/systemd/install.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "=== Trillboards Edge AI SDK — Linux Install ==="
+echo ""
+
+# Check Node.js
+if ! command -v node &>/dev/null; then
+  echo "Error: Node.js >= 18 is required."
+  echo "Install: curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs"
+  exit 1
+fi
+
+NODE_VER=$(node -v | sed 's/v//' | cut -d. -f1)
+if [ "$NODE_VER" -lt 18 ]; then
+  echo "Error: Node.js >= 18 required (found v$(node -v))"
+  exit 1
+fi
+
+# Check ffmpeg
+if ! command -v ffmpeg &>/dev/null; then
+  echo "Installing ffmpeg..."
+  sudo apt-get update -qq && sudo apt-get install -y -qq ffmpeg
+fi
+
+# Create user and directories
+echo "Creating trillboards user and directories..."
+sudo useradd --system --home-dir /opt/trillboards --shell /usr/sbin/nologin trillboards 2>/dev/null || true
+sudo mkdir -p /opt/trillboards /var/lib/trillboards /etc/trillboards
+sudo chown -R trillboards:trillboards /opt/trillboards /var/lib/trillboards
+
+# Install SDK
+echo "Installing @trillboards/edge-sdk..."
+cd /opt/trillboards
+sudo -u trillboards npm init -y --silent 2>/dev/null
+sudo -u trillboards npm install @trillboards/edge-sdk @trillboards/edge-platform-linux
+
+# Download models
+echo "Downloading ONNX models..."
+sudo -u trillboards mkdir -p /opt/trillboards/models
+sudo -u trillboards npx trillboards-edge download-models --dir /opt/trillboards/models
+
+# Install config template
+if [ ! -f /etc/trillboards/config.json ]; then
+  echo "Installing config template..."
+  sudo cp node_modules/@trillboards/edge-sdk/configs/generic-linux.json /etc/trillboards/config.json
+  sudo chown trillboards:trillboards /etc/trillboards/config.json
+  echo ""
+  echo "  *** IMPORTANT: Edit /etc/trillboards/config.json ***"
+  echo "  Set your deviceToken and screenId from the Trillboards dashboard."
+  echo ""
+fi
+
+# Install systemd service
+echo "Installing systemd service..."
+sudo cp node_modules/@trillboards/edge-sdk/deploy/systemd/trillboards-edge.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable trillboards-edge
+
+echo ""
+echo "=== Installation Complete ==="
+echo ""
+echo "Next steps:"
+echo "  1. Edit /etc/trillboards/config.json with your device token"
+echo "  2. Start: sudo systemctl start trillboards-edge"
+echo "  3. Logs:  sudo journalctl -u trillboards-edge -f"
+echo "  4. Status: sudo systemctl status trillboards-edge"
+echo ""

package/deploy/systemd/trillboards-edge.service

@@ -0,0 +1,42 @@
+[Unit]
+Description=Trillboards Edge AI Agent
+Documentation=https://github.com/trillboards/packages
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=trillboards
+Group=trillboards
+WorkingDirectory=/opt/trillboards
+ExecStartPre=/usr/bin/node -e "require('@trillboards/edge-sdk')"
+ExecStart=/usr/bin/npx trillboards-edge start --config /etc/trillboards/config.json
+Restart=always
+RestartSec=10
+StartLimitInterval=300
+StartLimitBurst=5
+StandardOutput=journal
+StandardError=journal
+SyslogIdentifier=trillboards-edge
+
+# Security hardening
+NoNewPrivileges=true
+ProtectSystem=strict
+ProtectHome=true
+ReadWritePaths=/var/lib/trillboards /opt/trillboards/models
+PrivateTmp=true
+
+# Resource limits
+MemoryMax=2G
+CPUQuota=80%
+
+# Camera/audio device access
+SupplementaryGroups=video audio
+
+# Environment
+Environment=NODE_ENV=production
+Environment=NODE_OPTIONS=--max-old-space-size=1536
+EnvironmentFile=-/etc/trillboards/env
+
+[Install]
+WantedBy=multi-user.target

package/deploy/windows/install-service.ps1

@@ -0,0 +1,95 @@
+# Trillboards Edge AI SDK — Windows Service Installer
+# Run as Administrator: powershell -ExecutionPolicy Bypass -File install-service.ps1
+
+$ErrorActionPreference = "Stop"
+
+$ServiceName = "TrillboardsEdge"
+$DisplayName = "Trillboards Edge AI Agent"
+$InstallDir = "C:\trillboards"
+$DataDir = "C:\ProgramData\trillboards"
+$ConfigPath = "$InstallDir\config.json"
+$ModelsDir = "$InstallDir\models"
+
+Write-Host "=== Trillboards Edge AI SDK - Windows Install ===" -ForegroundColor Cyan
+Write-Host ""
+
+# Check Node.js
+try {
+    $nodeVersion = (node -v) -replace 'v', ''
+    $major = [int]($nodeVersion.Split('.')[0])
+    if ($major -lt 18) {
+        throw "Node.js >= 18 required (found v$nodeVersion)"
+    }
+    Write-Host "Node.js $nodeVersion detected" -ForegroundColor Green
+} catch {
+    Write-Host "Error: Node.js >= 18 is required." -ForegroundColor Red
+    Write-Host "Download from: https://nodejs.org/"
+    exit 1
+}
+
+# Create directories
+Write-Host "Creating directories..."
+New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null
+New-Item -ItemType Directory -Force -Path $DataDir | Out-Null
+New-Item -ItemType Directory -Force -Path $ModelsDir | Out-Null
+
+# Install SDK
+Write-Host "Installing @trillboards/edge-sdk..."
+Push-Location $InstallDir
+if (!(Test-Path "package.json")) {
+    npm init -y --silent 2>$null
+}
+npm install @trillboards/edge-sdk @trillboards/edge-platform-windows
+Pop-Location
+
+# Download models
+Write-Host "Downloading ONNX models..."
+Push-Location $InstallDir
+npx trillboards-edge download-models --dir $ModelsDir
+Pop-Location
+
+# Install config template
+if (!(Test-Path $ConfigPath)) {
+    Write-Host "Installing config template..."
+    Copy-Item "$InstallDir\node_modules\@trillboards\edge-sdk\configs\windows-dooh.json" $ConfigPath
+    Write-Host ""
+    Write-Host "  *** IMPORTANT: Edit $ConfigPath ***" -ForegroundColor Yellow
+    Write-Host "  Set your deviceToken and screenId from the Trillboards dashboard."
+    Write-Host ""
+}
+
+# Create Windows Service wrapper script
+$WrapperScript = @"
+const { exec } = require('child_process');
+const path = require('path');
+const svc = exec(
+  'node ' + path.join(__dirname, 'node_modules', '@trillboards', 'edge-sdk', 'dist', 'cli.js') + ' start --config ' + path.join(__dirname, 'config.json'),
+  { cwd: __dirname }
+);
+svc.stdout.pipe(process.stdout);
+svc.stderr.pipe(process.stderr);
+svc.on('exit', (code) => process.exit(code || 0));
+"@
+Set-Content -Path "$InstallDir\service-wrapper.js" -Value $WrapperScript
+
+# Register as Windows Service using sc.exe with NSSM or node-windows
+# For simplicity, use a scheduled task that runs at startup
+$Action = New-ScheduledTaskAction -Execute "node.exe" -Argument "$InstallDir\service-wrapper.js" -WorkingDirectory $InstallDir
+$Trigger = New-ScheduledTaskTrigger -AtStartup
+$Settings = New-ScheduledTaskSettingsSet -RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1) -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable
+$Principal = New-ScheduledTaskPrincipal -UserId "SYSTEM" -LogonType ServiceAccount -RunLevel Highest
+
+# Remove existing task if present
+Unregister-ScheduledTask -TaskName $ServiceName -Confirm:$false -ErrorAction SilentlyContinue
+
+Register-ScheduledTask -TaskName $ServiceName -Action $Action -Trigger $Trigger -Settings $Settings -Principal $Principal -Description $DisplayName
+
+Write-Host ""
+Write-Host "=== Installation Complete ===" -ForegroundColor Green
+Write-Host ""
+Write-Host "Next steps:" -ForegroundColor Cyan
+Write-Host "  1. Edit $ConfigPath with your device token"
+Write-Host "  2. Start: Start-ScheduledTask -TaskName '$ServiceName'"
+Write-Host "  3. Stop:  Stop-ScheduledTask -TaskName '$ServiceName'"
+Write-Host "  4. Logs:  Get-Content $DataDir\agent.log -Tail 50 -Wait"
+Write-Host ""

package/dist/EdgeAgent.d.ts

@@ -0,0 +1,39 @@
+import { EventEmitter } from 'events';
+import type { EdgeAgentConfig } from './config';
+export declare class EdgeAgent extends EventEmitter {
+    private config;
+    private platform;
+    private camera;
+    private audio;
+    private socketManager;
+    private sensingService;
+    private telemetryScheduler;
+    private recoveryLadder;
+    private browserManager;
+    private federatedTrainer;
+    private healthRegistry;
+    private signalBuffer;
+    private running;
+    private signalHandlersRegistered;
+    private boundShutdownSigint;
+    private boundShutdownSigterm;
+    constructor(config: EdgeAgentConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private shutdown;
+    /**
+     * Load the platform-specific adapter using require() so that optional
+     * dependencies fail gracefully at runtime when not installed.
+     */
+    private loadPlatformAdapter;
+    /**
+     * Load the platform-specific camera provider using require() for optional deps.
+     */
+    private loadCamera;
+    /**
+     * Load the platform-specific audio provider using require() for optional deps.
+     */
+    private loadAudio;
+    private log;
+}
+//# sourceMappingURL=EdgeAgent.d.ts.map

package/dist/EdgeAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeAgent.d.ts","sourceRoot":"","sources":["../src/EdgeAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AA6BtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,wBAAwB,CAAS;IACzC,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,oBAAoB,CAA6B;gBAE7C,MAAM,EAAE,eAAe;IAK7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+NtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA4Bb,QAAQ;IAMtB;;;OAGG;YACW,mBAAmB;IAwBjC;;OAEG;YACW,UAAU;IAoCxB;;OAEG;YACW,SAAS;IAsBvB,OAAO,CAAC,GAAG;CAgBZ"}