@camera.ui/sdk 0.0.1

package/dist/sensor/ptz.js

@@ -0,0 +1,159 @@
+import { Sensor } from './base.js';
+import { SensorCategory, SensorType } from './types.js';
+/**
+ * PTZ Capability enum
+ * Describes what PTZ features this sensor supports
+ */
+export var PTZCapability;
+(function (PTZCapability) {
+    /** Supports horizontal panning */
+    PTZCapability["Pan"] = "pan";
+    /** Supports vertical tilting */
+    PTZCapability["Tilt"] = "tilt";
+    /** Supports zoom in/out */
+    PTZCapability["Zoom"] = "zoom";
+    /** Supports preset positions */
+    PTZCapability["Presets"] = "presets";
+    /** Supports home position */
+    PTZCapability["Home"] = "home";
+})(PTZCapability || (PTZCapability = {}));
+/**
+ * PTZ control property keys
+ */
+export var PTZProperty;
+(function (PTZProperty) {
+    PTZProperty["Position"] = "position";
+    PTZProperty["Moving"] = "moving";
+    PTZProperty["Presets"] = "presets";
+    PTZProperty["Velocity"] = "velocity";
+    PTZProperty["TargetPreset"] = "targetPreset";
+})(PTZProperty || (PTZProperty = {}));
+/**
+ * PTZ Control
+ *
+ * Bidirectional control for camera pan/tilt/zoom.
+ *
+ * @example
+ * ```typescript
+ * // Move to absolute position
+ * ptz.position = { pan: 45, tilt: -10, zoom: 0.5 };
+ *
+ * // Continuous move
+ * ptz.continuousMove({ panSpeed: 1, tiltSpeed: 0, zoomSpeed: 0 });
+ *
+ * // Stop all movement
+ * ptz.stop();
+ *
+ * // Go to preset
+ * ptz.goToPreset('Entrance');
+ *
+ * // Go to home position
+ * ptz.goHome();
+ * ```
+ */
+export class PTZControl extends Sensor {
+    type = SensorType.PTZ;
+    category = SensorCategory.Control;
+    name;
+    /**
+     * Create a new PTZ control sensor.
+     *
+     * @param name - Human-readable name for this sensor
+     */
+    constructor(name = 'PTZ') {
+        super();
+        this.name = name;
+        // Initialize defaults
+        this.props.position = { pan: 0, tilt: 0, zoom: 0 };
+        this.props.moving = false;
+        this.props.presets = [];
+    }
+    /** Current PTZ position */
+    get position() {
+        return this.rawProps.position;
+    }
+    /** Set PTZ position (absolute move) */
+    set position(value) {
+        this.props.position = value;
+    }
+    /** Whether PTZ is currently moving */
+    get moving() {
+        return this.rawProps.moving;
+    }
+    /** Set moving state */
+    set moving(value) {
+        this.props.moving = value;
+    }
+    /** Available presets */
+    get presets() {
+        return this.rawProps.presets;
+    }
+    /** Set available presets */
+    set presets(value) {
+        this.props.presets = value;
+    }
+    /** Current velocity (for continuous move) */
+    get velocity() {
+        return this.rawProps.velocity;
+    }
+    /** Set velocity for continuous move */
+    set velocity(value) {
+        this.props.velocity = value;
+    }
+    /** Target preset to go to */
+    get targetPreset() {
+        return this.rawProps.targetPreset;
+    }
+    /** Set target preset */
+    set targetPreset(value) {
+        this.props.targetPreset = value;
+    }
+    /** Go to home position (pan: 0, tilt: 0, zoom: 0) */
+    goHome() {
+        this.props.position = { pan: 0, tilt: 0, zoom: 0 };
+    }
+    /**
+     * Pan to specific angle
+     *
+     * @param angle - Pan angle in degrees
+     */
+    pan(angle) {
+        this.props.position = { ...this.position, pan: angle };
+    }
+    /**
+     * Tilt to specific angle
+     *
+     * @param angle - Tilt angle in degrees
+     */
+    tilt(angle) {
+        this.props.position = { ...this.position, tilt: angle };
+    }
+    /**
+     * Zoom to specific level (0-1)
+     *
+     * @param level - Zoom level between 0 and 1
+     */
+    zoom(level) {
+        this.props.position = { ...this.position, zoom: Math.max(0, Math.min(1, level)) };
+    }
+    /**
+     * Start continuous movement
+     *
+     * @param velocity - Movement speed for each axis (-1 to 1)
+     */
+    continuousMove(velocity) {
+        this.props.velocity = velocity;
+    }
+    /** Stop all movement */
+    stop() {
+        this.props.velocity = { panSpeed: 0, tiltSpeed: 0, zoomSpeed: 0 };
+    }
+    /**
+     * Go to a saved preset
+     *
+     * @param preset - Preset name
+     */
+    goToPreset(preset) {
+        this.props.targetPreset = preset;
+    }
+}

package/dist/sensor/siren.js

@@ -0,0 +1,73 @@
+import { Sensor } from './base.js';
+import { SensorCategory, SensorType } from './types.js';
+/**
+ * Siren Capability enum
+ * Describes what Siren features this sensor supports
+ */
+export var SirenCapability;
+(function (SirenCapability) {
+    /** Supports volume control */
+    SirenCapability["Volume"] = "volume";
+    /** Supports different siren modes */
+    SirenCapability["Modes"] = "modes";
+})(SirenCapability || (SirenCapability = {}));
+/**
+ * Siren control property keys
+ */
+export var SirenProperty;
+(function (SirenProperty) {
+    SirenProperty["Active"] = "active";
+    SirenProperty["Volume"] = "volume";
+})(SirenProperty || (SirenProperty = {}));
+/**
+ * Siren Control
+ *
+ * Bidirectional control for camera siren/alarm.
+ * Properties can be set directly: `siren.active = true`
+ */
+export class SirenControl extends Sensor {
+    type = SensorType.Siren;
+    category = SensorCategory.Control;
+    name;
+    constructor(name = 'Siren') {
+        super();
+        this.name = name;
+        // Initialize defaults
+        this.props.active = false;
+        this.props.volume = 100;
+    }
+    /** Whether siren is active */
+    get active() {
+        return this.rawProps.active;
+    }
+    /** Activate/deactivate siren */
+    set active(value) {
+        this.props.active = value;
+    }
+    /** Volume level (0-100) */
+    get volume() {
+        return this.rawProps.volume;
+    }
+    /** Set volume level (0-100) */
+    set volume(value) {
+        this.props.volume = Math.max(0, Math.min(100, value));
+    }
+    /** Activate siren */
+    activate() {
+        this.props.active = true;
+    }
+    /** Deactivate siren */
+    deactivate() {
+        this.props.active = false;
+    }
+    /**
+     * Sound siren for a duration
+     *
+     * @param durationMs - Duration to sound siren in milliseconds
+     */
+    async soundFor(durationMs) {
+        this.activate();
+        await new Promise((resolve) => setTimeout(resolve, durationMs));
+        this.deactivate();
+    }
+}

package/dist/sensor/types.js

@@ -0,0 +1,46 @@
+/**
+ * Charging state for battery
+ */
+export var ChargingState;
+(function (ChargingState) {
+    ChargingState["NotChargeable"] = "NOT_CHARGEABLE";
+    ChargingState["NotCharging"] = "NOT_CHARGING";
+    ChargingState["Charging"] = "CHARGING";
+    ChargingState["Full"] = "FULL";
+})(ChargingState || (ChargingState = {}));
+// ========== Sensor Types ==========
+/**
+ * Sensor Type Enum - identifies the type of sensor/control/trigger/info
+ */
+export var SensorType;
+(function (SensorType) {
+    // Detection Sensors
+    SensorType["Motion"] = "motion";
+    SensorType["Object"] = "object";
+    SensorType["Audio"] = "audio";
+    SensorType["Face"] = "face";
+    SensorType["LicensePlate"] = "licensePlate";
+    SensorType["Contact"] = "contact";
+    // Controls
+    SensorType["Light"] = "light";
+    SensorType["Siren"] = "siren";
+    SensorType["PTZ"] = "ptz";
+    // Triggers
+    SensorType["Doorbell"] = "doorbell";
+    // Info
+    SensorType["Battery"] = "battery";
+})(SensorType || (SensorType = {}));
+/**
+ * Sensor Category - categorizes sensors by their behavior
+ */
+export var SensorCategory;
+(function (SensorCategory) {
+    /** Detection sensors (read-only, 1 provider) */
+    SensorCategory["Sensor"] = "sensor";
+    /** Bidirectional controls */
+    SensorCategory["Control"] = "control";
+    /** Event-based triggers */
+    SensorCategory["Trigger"] = "trigger";
+    /** Read-only hardware status */
+    SensorCategory["Info"] = "info";
+})(SensorCategory || (SensorCategory = {}));

package/dist/service/base.js

@@ -0,0 +1,96 @@
+/**
+ * Service types that can be registered by plugins
+ */
+export var ServiceType;
+(function (ServiceType) {
+    /** Streaming URL generation */
+    ServiceType["Streaming"] = "streaming";
+    /** Snapshot capture */
+    ServiceType["Snapshot"] = "snapshot";
+})(ServiceType || (ServiceType = {}));
+/**
+ * Abstract base class for all camera services
+ *
+ * Plugins extend this class to implement custom service functionality.
+ * The service communicates with the server via RPC, with the base class
+ * handling online/offline status management.
+ *
+ * @example
+ * ```typescript
+ * class MyStreamingService extends Service implements StreamingService {
+ *   readonly type = ServiceType.Streaming;
+ *
+ *   async streamUrl(sourceName: string): Promise<string> {
+ *     return `rtsp://my-camera/${sourceName}`;
+ *   }
+ * }
+ *
+ * // In plugin:
+ * const service = new MyStreamingService(camera.id, this.pluginId);
+ * await camera.registerService(service);
+ * ```
+ */
+export class Service {
+    /**
+     * Camera ID this service is associated with
+     */
+    cameraId;
+    /**
+     * Plugin ID that provides this service
+     */
+    pluginId;
+    /**
+     * Internal online state
+     */
+    _online = false;
+    /**
+     * Callback for online status changes (set by runtime)
+     */
+    _onlineChangeFn;
+    /**
+     * Create a new service instance
+     *
+     * @param cameraId - ID of the camera this service is for
+     *
+     * @param pluginId - ID of the plugin providing this service
+     */
+    constructor(cameraId, pluginId) {
+        this.cameraId = cameraId;
+        this.pluginId = pluginId;
+    }
+    /**
+     * Whether the service is currently online/available
+     *
+     * Setting this property notifies the server of the status change.
+     */
+    get online() {
+        return this._online;
+    }
+    set online(value) {
+        if (this._online !== value) {
+            this._online = value;
+            this._onlineChangeFn?.(value);
+        }
+    }
+    /**
+     * Internal initialization - sets up the online status callback
+     *
+     * Called by the runtime when the service is registered.
+     *
+     * @param onlineChangeFn - Callback to notify server of online status changes
+     *
+     * @internal
+     */
+    _init(onlineChangeFn) {
+        this._onlineChangeFn = onlineChangeFn;
+    }
+    /**
+     * Internal cleanup - called when service is unregistered
+     *
+     * @internal
+     */
+    _cleanup() {
+        this._onlineChangeFn = undefined;
+        this._online = false;
+    }
+}

package/dist/service/index.js

@@ -0,0 +1,3 @@
+export * from './base.js';
+export * from './services.js';
+export * from './types.js';

package/dist/service/services.js

@@ -0,0 +1 @@
+export {};

package/dist/service/types.js

@@ -0,0 +1 @@
+export {};

package/dist/storage/index.js

@@ -0,0 +1,2 @@
+export * from './schema.js';
+export * from './storages.js';

package/dist/storage/schema.js

@@ -0,0 +1 @@
+export {};

package/dist/storage/storages.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@camera.ui/sdk",
+  "version": "0.0.1",
+  "description": "camera.ui sdk",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "type": "module",
+  "scripts": {
+    "build": "rimraf dist && tsc --project tsconfig.node.json && rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "format": "prettier --write 'src/' --ignore-unknown --no-error-on-unmatched-pattern",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "update": "updates --update ./",
+    "install-updates": "npm i --save",
+    "prepublishOnly": "npm i --package-lock-only && npm run lint:fix && npm run format && npm run build"
+  },
+  "dependencies": {
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@stylistic/eslint-plugin": "^5.6.1",
+    "@types/multicast-dns": "^7.2.4",
+    "@types/node": "^24.10.1",
+    "@typescript-eslint/parser": "^8.48.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-jsdoc": "^61.5.0",
+    "globals": "^16.5.0",
+    "prettier": "^3.7.4",
+    "rimraf": "^6.1.2",
+    "rollup": "^4.53.3",
+    "rollup-plugin-dts": "^6.3.0",
+    "sharp": "^0.34.5",
+    "tsyringe": "^4.10.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.48.1",
+    "updates": "^17.0.4",
+    "werift": "0.22.2",
+    "werift-rtp": "^0.8.8"
+  },
+  "author": "seydx (https://github.com/seydx/camera.ui)",
+  "bugs": {
+    "url": "https://github.com/seydx/camera.ui/issues"
+  },
+  "homepage": "https://github.com/seydx/camera.ui#readme",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seydx/camera.ui.git"
+  },
+  "keywords": [
+    "camera.ui",
+    "sdk"
+  ]
+}

package/tsconfig.node.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "outDir": "./dist",
+    "target": "ES2022",
+    "moduleResolution": "NodeNext",
+    "module": "NodeNext",
+    "lib": [
+      "ES2022",
+    ],
+    "declaration": false,
+    "strict": true,
+    "esModuleInterop": true,
+    "preserveConstEnums": true,
+    "skipLibCheck": true,
+    "useUnknownInCatchVariables": false,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "verbatimModuleSyntax": true,
+    "noImplicitAny": true,
+  },
+  "include": [
+    "src",
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+  ],
+}