@camstack/addon-export-hap 1.2.81 → 1.2.83
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/hap-export.addon.js +313 -0
- package/dist/hap-export.addon.mjs +313 -0
- package/package.json +1 -1
package/dist/hap-export.addon.js
CHANGED
|
@@ -5491,6 +5491,12 @@ Object.fromEntries([
|
|
|
5491
5491
|
icon: "move",
|
|
5492
5492
|
order: 40
|
|
5493
5493
|
},
|
|
5494
|
+
{
|
|
5495
|
+
id: "navigation",
|
|
5496
|
+
label: "Navigation",
|
|
5497
|
+
icon: "compass",
|
|
5498
|
+
order: 41
|
|
5499
|
+
},
|
|
5494
5500
|
{
|
|
5495
5501
|
id: "consumables",
|
|
5496
5502
|
label: "Consumables",
|
|
@@ -27664,6 +27670,203 @@ DeviceType.Camera, method(object({ deviceId: number() }), PtzAutotrackStatusSche
|
|
|
27664
27670
|
deviceId: number(),
|
|
27665
27671
|
status: PtzAutotrackStatusSchema
|
|
27666
27672
|
});
|
|
27673
|
+
/**
|
|
27674
|
+
* `navigation` — a device-scoped capability that natively expresses the FULL
|
|
27675
|
+
* navigation / action surface of a robot that DRIVES ITSELF and carries an
|
|
27676
|
+
* on-board camera (the Dreame robot-vacuum camera is the first provider).
|
|
27677
|
+
*
|
|
27678
|
+
* Why a NEW cap rather than overloading `ptz`:
|
|
27679
|
+
* - `ptz` moves a *gimbal* on a fixed camera (pan/tilt/zoom of the lens). A
|
|
27680
|
+
* robot vacuum has no gimbal — the whole chassis drives, turns and spins.
|
|
27681
|
+
* The two are different physical models: PTZ is absolute-position + presets,
|
|
27682
|
+
* navigation is momentary drive nudges + discrete robot ACTIONS
|
|
27683
|
+
* (dock / spot-clean / follow-pet / go-to-point / …).
|
|
27684
|
+
* - This cap is the SOURCE OF TRUTH. Two consumers adapt from it rather than
|
|
27685
|
+
* the reverse:
|
|
27686
|
+
* 1. a native CamStack navigation panel (data-driven from `listActions`
|
|
27687
|
+
* / `getOptions`), and
|
|
27688
|
+
* 2. the PTZ surface — a thin adapter mimics `ptz` from `navigation` so a
|
|
27689
|
+
* robot camera shows up in the existing PTZ control path without every
|
|
27690
|
+
* PTZ provider learning about robots. The mapping lives in the adapter,
|
|
27691
|
+
* not here (see the addon design note):
|
|
27692
|
+
* ptz.continuousMove({pan,tilt}) → navigation.move({pan,tilt})
|
|
27693
|
+
* ptz.stop() → navigation.stop()
|
|
27694
|
+
* ptz.goHome() → navigation.runAction('goHome')
|
|
27695
|
+
* ptz.getPresets() → navigation.listActions() (id→preset)
|
|
27696
|
+
* ptz.goToPreset(id) → navigation.runAction(id)
|
|
27697
|
+
*
|
|
27698
|
+
* ## Continuous drive
|
|
27699
|
+
*
|
|
27700
|
+
* `move` is MOMENTARY. Fluid navigation comes from the UI (or the PTZ adapter)
|
|
27701
|
+
* sending `move({pan,tilt})` REPEATEDLY at ~1 Hz while a direction is held, and
|
|
27702
|
+
* one `stop()` on release — exactly like the robot app's remote-drive joystick.
|
|
27703
|
+
* The provider forwards EACH `move` to one drive write; it must NOT debounce or
|
|
27704
|
+
* coalesce them. The UI owns the cadence.
|
|
27705
|
+
*
|
|
27706
|
+
* ## The action dictionary
|
|
27707
|
+
*
|
|
27708
|
+
* The discrete controls (dock / locate / spot-clean / follow / flash / sounds)
|
|
27709
|
+
* are a DATA-DRIVEN dictionary the cap exposes via `listActions()`. Each entry
|
|
27710
|
+
* carries `{ id, kind, label, icon }` (plus `soundId` for sound entries) so the
|
|
27711
|
+
* native panel AND the PTZ mimic render buttons WITHOUT hardcoding a
|
|
27712
|
+
* vendor-specific list. `kind: 'action'` entries are triggered with
|
|
27713
|
+
* `runAction({ actionId })`; `kind: 'sound'` entries with `playSound({ soundId })`
|
|
27714
|
+
* (the entry carries the `soundId` to pass). The general primitives — `move`,
|
|
27715
|
+
* `stop`, `goToPoint` — stay as first-class methods, not dictionary entries.
|
|
27716
|
+
*
|
|
27717
|
+
* NOTE (provider wiring): the first provider (Dreame) drives this with the RAW
|
|
27718
|
+
* `callAction(siid,aiid,in)` / `setProperty({siid,piid,value})` MIoT primitives
|
|
27719
|
+
* that the currently-published `@apocaliss92/nodedreame` already exposes on
|
|
27720
|
+
* every device handle. A future nodedreame publish adds a typed
|
|
27721
|
+
* `DreameCameraController` (drive / playPetSound / spotClean / findPet / …); the
|
|
27722
|
+
* provider can then swap the raw calls for the typed methods with no change to
|
|
27723
|
+
* THIS contract.
|
|
27724
|
+
*/
|
|
27725
|
+
/**
|
|
27726
|
+
* A momentary drive nudge. The robot MOVES (no gimbal) for as long as the caller
|
|
27727
|
+
* keeps sending nudges (~1 Hz); an explicit `stop` (or letting the nudges lapse)
|
|
27728
|
+
* halts it.
|
|
27729
|
+
*
|
|
27730
|
+
* - `pan` — turn: negative = left, positive = right, 0 = straight.
|
|
27731
|
+
* - `tilt` — throttle: positive = forward, negative = spin / turn-around.
|
|
27732
|
+
* - `speed` — optional intensity hint [0, 1]; the provider may scale the drive
|
|
27733
|
+
* vector by it (drivers without proportional drive ignore it).
|
|
27734
|
+
*
|
|
27735
|
+
* `pan` / `tilt` are normalized [-1, 1]. Both optional so a caller can nudge one
|
|
27736
|
+
* axis alone; an all-undefined nudge is a no-op.
|
|
27737
|
+
*/
|
|
27738
|
+
var NavigationMoveCommandSchema = object({
|
|
27739
|
+
pan: number().min(-1).max(1).optional(),
|
|
27740
|
+
tilt: number().min(-1).max(1).optional(),
|
|
27741
|
+
speed: number().min(0).max(1).optional()
|
|
27742
|
+
});
|
|
27743
|
+
/**
|
|
27744
|
+
* The enumerated discrete actions a navigation-capable robot can perform via
|
|
27745
|
+
* `runAction`. This is the CLOSED vocabulary; a given device advertises the
|
|
27746
|
+
* subset it supports through `listActions`. Sounds are NOT here — they go through
|
|
27747
|
+
* `playSound` (see the `sound` dictionary entries).
|
|
27748
|
+
*/
|
|
27749
|
+
var NavigationActionIdSchema = _enum([
|
|
27750
|
+
"goHome",
|
|
27751
|
+
"locate",
|
|
27752
|
+
"spotClean",
|
|
27753
|
+
"findPet",
|
|
27754
|
+
"personFollow",
|
|
27755
|
+
"stop",
|
|
27756
|
+
"startClean",
|
|
27757
|
+
"pauseClean",
|
|
27758
|
+
"dockWash",
|
|
27759
|
+
"autoEmpty",
|
|
27760
|
+
"flashOn",
|
|
27761
|
+
"flashOff"
|
|
27762
|
+
]);
|
|
27763
|
+
/** Whether a dictionary entry is a `runAction` action or a `playSound` sound. */
|
|
27764
|
+
var NavigationEntryKindSchema = _enum(["action", "sound"]);
|
|
27765
|
+
/**
|
|
27766
|
+
* One entry in the navigation action dictionary — the DATA-DRIVEN unit both the
|
|
27767
|
+
* native panel and the PTZ mimic render as a button.
|
|
27768
|
+
*
|
|
27769
|
+
* - `id` — stable id. For `kind:'action'` it is a {@link NavigationActionId}
|
|
27770
|
+
* (pass to `runAction`); for `kind:'sound'` it is a namespaced id
|
|
27771
|
+
* (`sound:meow`) whose `soundId` is passed to `playSound`.
|
|
27772
|
+
* - `icon` — icon HINT (lucide-style name; the UI maps it to its own set).
|
|
27773
|
+
* - `label` — operator-facing English label.
|
|
27774
|
+
* - `soundId` — wire sound id, present only on `kind:'sound'` entries.
|
|
27775
|
+
* - `enabled` — per-device FEATURE FLAG. `listActions` reports it so the UI /
|
|
27776
|
+
* PTZ render ONLY enabled entries. Data-driven: the provider
|
|
27777
|
+
* flips it from config, never by editing code.
|
|
27778
|
+
*/
|
|
27779
|
+
var NavigationActionEntrySchema = object({
|
|
27780
|
+
id: string(),
|
|
27781
|
+
kind: NavigationEntryKindSchema,
|
|
27782
|
+
label: string(),
|
|
27783
|
+
icon: string(),
|
|
27784
|
+
/** Present only on `kind:'sound'` entries — the id to pass to `playSound`. */
|
|
27785
|
+
soundId: number().int().optional(),
|
|
27786
|
+
/** Per-device feature flag — render this entry only when true. */
|
|
27787
|
+
enabled: boolean()
|
|
27788
|
+
});
|
|
27789
|
+
/** Coordinates for `goToPoint` — a point on the robot's live map. */
|
|
27790
|
+
var NavigationPointSchema = object({
|
|
27791
|
+
x: number(),
|
|
27792
|
+
y: number()
|
|
27793
|
+
});
|
|
27794
|
+
/**
|
|
27795
|
+
* Per-device FEATURE-FLAG report for the general (non-dictionary) primitives.
|
|
27796
|
+
* The cap reports which are enabled so the UI / PTZ render only the controls
|
|
27797
|
+
* that are turned on for THIS device. Data-driven: the provider derives these
|
|
27798
|
+
* from config + probe, never hardcoded in the UI. The per-DICTIONARY-entry flags
|
|
27799
|
+
* live on {@link NavigationActionEntrySchema.enabled}; these gate the primitives
|
|
27800
|
+
* that are not dictionary entries.
|
|
27801
|
+
*
|
|
27802
|
+
* - `move` / `stop` — the momentary drive joystick.
|
|
27803
|
+
* - `goToPoint` — send-to-map-coordinate. Ships OFF on Dreame until the
|
|
27804
|
+
* map-coordinate plumbing is wired.
|
|
27805
|
+
* - `runAction` — the discrete action buttons (dictionary `kind:'action'`).
|
|
27806
|
+
* - `playSound` — the sound buttons (dictionary `kind:'sound'`).
|
|
27807
|
+
* - `light` — the on/off fill-light toggle (works anytime).
|
|
27808
|
+
* - `lightMode` — the auto/manual selector + manual level slider (a
|
|
27809
|
+
* camera-service control; needs an active stream).
|
|
27810
|
+
*/
|
|
27811
|
+
var NavigationFeaturesSchema = object({
|
|
27812
|
+
move: boolean(),
|
|
27813
|
+
stop: boolean(),
|
|
27814
|
+
goToPoint: boolean(),
|
|
27815
|
+
runAction: boolean(),
|
|
27816
|
+
playSound: boolean(),
|
|
27817
|
+
light: boolean(),
|
|
27818
|
+
lightMode: boolean()
|
|
27819
|
+
});
|
|
27820
|
+
/** Light mode: `auto` lets the camera choose brightness; `manual` uses `level`. */
|
|
27821
|
+
var NavigationLightModeSchema = _enum(["auto", "manual"]);
|
|
27822
|
+
/**
|
|
27823
|
+
* Live navigation state so the UI can reflect what the robot is doing:
|
|
27824
|
+
* - `mode` — coarse activity (idle / cleaning / following / …).
|
|
27825
|
+
* - `following` — person/pet follow is currently armed.
|
|
27826
|
+
* - `flash` — the on-camera fill light is on.
|
|
27827
|
+
* - `lightMode` — auto vs manual fill-light mode.
|
|
27828
|
+
* - `lightLevel` — manual fill-light level (40..100); meaningful when
|
|
27829
|
+
* `lightMode === 'manual'`.
|
|
27830
|
+
*/
|
|
27831
|
+
var NavigationStatusSchema = object({
|
|
27832
|
+
mode: _enum([
|
|
27833
|
+
"idle",
|
|
27834
|
+
"cleaning",
|
|
27835
|
+
"spot",
|
|
27836
|
+
"following",
|
|
27837
|
+
"goto",
|
|
27838
|
+
"returning",
|
|
27839
|
+
"paused",
|
|
27840
|
+
"unknown"
|
|
27841
|
+
]),
|
|
27842
|
+
following: boolean(),
|
|
27843
|
+
flash: boolean(),
|
|
27844
|
+
lightMode: NavigationLightModeSchema,
|
|
27845
|
+
lightLevel: number().min(40).max(100),
|
|
27846
|
+
/** Ms epoch when the slice was last updated. */
|
|
27847
|
+
lastChangedAt: number()
|
|
27848
|
+
});
|
|
27849
|
+
NavigationStatusSchema.extend({ lastFetchedAt: number() });
|
|
27850
|
+
DeviceType.Camera, method(NavigationMoveCommandSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), _void(), { kind: "mutation" }), method(NavigationPointSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), array(NavigationActionEntrySchema)), method(object({
|
|
27851
|
+
deviceId: number(),
|
|
27852
|
+
actionId: NavigationActionIdSchema
|
|
27853
|
+
}), _void(), { kind: "mutation" }), method(object({
|
|
27854
|
+
deviceId: number(),
|
|
27855
|
+
soundId: number().int()
|
|
27856
|
+
}), _void(), { kind: "mutation" }), method(object({
|
|
27857
|
+
deviceId: number(),
|
|
27858
|
+
on: boolean()
|
|
27859
|
+
}), _void(), { kind: "mutation" }), method(object({
|
|
27860
|
+
deviceId: number(),
|
|
27861
|
+
mode: NavigationLightModeSchema,
|
|
27862
|
+
level: number().min(40).max(100).optional()
|
|
27863
|
+
}), _void(), { kind: "mutation" }), method(object({
|
|
27864
|
+
deviceId: number(),
|
|
27865
|
+
level: number().min(40).max(100)
|
|
27866
|
+
}), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), NavigationFeaturesSchema), object({
|
|
27867
|
+
deviceId: number(),
|
|
27868
|
+
status: NavigationStatusSchema
|
|
27869
|
+
});
|
|
27667
27870
|
DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
|
|
27668
27871
|
kind: "mutation",
|
|
27669
27872
|
auth: "admin"
|
|
@@ -32753,6 +32956,66 @@ Object.freeze({
|
|
|
32753
32956
|
addonId: null,
|
|
32754
32957
|
access: "create"
|
|
32755
32958
|
},
|
|
32959
|
+
"navigation.getFeatures": {
|
|
32960
|
+
capName: "navigation",
|
|
32961
|
+
capScope: "device",
|
|
32962
|
+
addonId: null,
|
|
32963
|
+
access: "view"
|
|
32964
|
+
},
|
|
32965
|
+
"navigation.goToPoint": {
|
|
32966
|
+
capName: "navigation",
|
|
32967
|
+
capScope: "device",
|
|
32968
|
+
addonId: null,
|
|
32969
|
+
access: "create"
|
|
32970
|
+
},
|
|
32971
|
+
"navigation.listActions": {
|
|
32972
|
+
capName: "navigation",
|
|
32973
|
+
capScope: "device",
|
|
32974
|
+
addonId: null,
|
|
32975
|
+
access: "view"
|
|
32976
|
+
},
|
|
32977
|
+
"navigation.move": {
|
|
32978
|
+
capName: "navigation",
|
|
32979
|
+
capScope: "device",
|
|
32980
|
+
addonId: null,
|
|
32981
|
+
access: "create"
|
|
32982
|
+
},
|
|
32983
|
+
"navigation.playSound": {
|
|
32984
|
+
capName: "navigation",
|
|
32985
|
+
capScope: "device",
|
|
32986
|
+
addonId: null,
|
|
32987
|
+
access: "create"
|
|
32988
|
+
},
|
|
32989
|
+
"navigation.runAction": {
|
|
32990
|
+
capName: "navigation",
|
|
32991
|
+
capScope: "device",
|
|
32992
|
+
addonId: null,
|
|
32993
|
+
access: "create"
|
|
32994
|
+
},
|
|
32995
|
+
"navigation.setLightLevel": {
|
|
32996
|
+
capName: "navigation",
|
|
32997
|
+
capScope: "device",
|
|
32998
|
+
addonId: null,
|
|
32999
|
+
access: "create"
|
|
33000
|
+
},
|
|
33001
|
+
"navigation.setLightMode": {
|
|
33002
|
+
capName: "navigation",
|
|
33003
|
+
capScope: "device",
|
|
33004
|
+
addonId: null,
|
|
33005
|
+
access: "create"
|
|
33006
|
+
},
|
|
33007
|
+
"navigation.setLightOn": {
|
|
33008
|
+
capName: "navigation",
|
|
33009
|
+
capScope: "device",
|
|
33010
|
+
addonId: null,
|
|
33011
|
+
access: "create"
|
|
33012
|
+
},
|
|
33013
|
+
"navigation.stop": {
|
|
33014
|
+
capName: "navigation",
|
|
33015
|
+
capScope: "device",
|
|
33016
|
+
addonId: null,
|
|
33017
|
+
access: "create"
|
|
33018
|
+
},
|
|
32756
33019
|
"networkAccess.getEndpoint": {
|
|
32757
33020
|
capName: "network-access",
|
|
32758
33021
|
capScope: "system",
|
|
@@ -36848,6 +37111,56 @@ Object.freeze({
|
|
|
36848
37111
|
form: "single",
|
|
36849
37112
|
optional: false
|
|
36850
37113
|
}],
|
|
37114
|
+
"navigation.getFeatures": [{
|
|
37115
|
+
name: "deviceId",
|
|
37116
|
+
form: "single",
|
|
37117
|
+
optional: false
|
|
37118
|
+
}],
|
|
37119
|
+
"navigation.goToPoint": [{
|
|
37120
|
+
name: "deviceId",
|
|
37121
|
+
form: "single",
|
|
37122
|
+
optional: false
|
|
37123
|
+
}],
|
|
37124
|
+
"navigation.listActions": [{
|
|
37125
|
+
name: "deviceId",
|
|
37126
|
+
form: "single",
|
|
37127
|
+
optional: false
|
|
37128
|
+
}],
|
|
37129
|
+
"navigation.move": [{
|
|
37130
|
+
name: "deviceId",
|
|
37131
|
+
form: "single",
|
|
37132
|
+
optional: false
|
|
37133
|
+
}],
|
|
37134
|
+
"navigation.playSound": [{
|
|
37135
|
+
name: "deviceId",
|
|
37136
|
+
form: "single",
|
|
37137
|
+
optional: false
|
|
37138
|
+
}],
|
|
37139
|
+
"navigation.runAction": [{
|
|
37140
|
+
name: "deviceId",
|
|
37141
|
+
form: "single",
|
|
37142
|
+
optional: false
|
|
37143
|
+
}],
|
|
37144
|
+
"navigation.setLightLevel": [{
|
|
37145
|
+
name: "deviceId",
|
|
37146
|
+
form: "single",
|
|
37147
|
+
optional: false
|
|
37148
|
+
}],
|
|
37149
|
+
"navigation.setLightMode": [{
|
|
37150
|
+
name: "deviceId",
|
|
37151
|
+
form: "single",
|
|
37152
|
+
optional: false
|
|
37153
|
+
}],
|
|
37154
|
+
"navigation.setLightOn": [{
|
|
37155
|
+
name: "deviceId",
|
|
37156
|
+
form: "single",
|
|
37157
|
+
optional: false
|
|
37158
|
+
}],
|
|
37159
|
+
"navigation.stop": [{
|
|
37160
|
+
name: "deviceId",
|
|
37161
|
+
form: "single",
|
|
37162
|
+
optional: false
|
|
37163
|
+
}],
|
|
36851
37164
|
"networkQuality.getDeviceStats": [{
|
|
36852
37165
|
name: "deviceId",
|
|
36853
37166
|
form: "single",
|
|
@@ -5479,6 +5479,12 @@ Object.fromEntries([
|
|
|
5479
5479
|
icon: "move",
|
|
5480
5480
|
order: 40
|
|
5481
5481
|
},
|
|
5482
|
+
{
|
|
5483
|
+
id: "navigation",
|
|
5484
|
+
label: "Navigation",
|
|
5485
|
+
icon: "compass",
|
|
5486
|
+
order: 41
|
|
5487
|
+
},
|
|
5482
5488
|
{
|
|
5483
5489
|
id: "consumables",
|
|
5484
5490
|
label: "Consumables",
|
|
@@ -27652,6 +27658,203 @@ DeviceType.Camera, method(object({ deviceId: number() }), PtzAutotrackStatusSche
|
|
|
27652
27658
|
deviceId: number(),
|
|
27653
27659
|
status: PtzAutotrackStatusSchema
|
|
27654
27660
|
});
|
|
27661
|
+
/**
|
|
27662
|
+
* `navigation` — a device-scoped capability that natively expresses the FULL
|
|
27663
|
+
* navigation / action surface of a robot that DRIVES ITSELF and carries an
|
|
27664
|
+
* on-board camera (the Dreame robot-vacuum camera is the first provider).
|
|
27665
|
+
*
|
|
27666
|
+
* Why a NEW cap rather than overloading `ptz`:
|
|
27667
|
+
* - `ptz` moves a *gimbal* on a fixed camera (pan/tilt/zoom of the lens). A
|
|
27668
|
+
* robot vacuum has no gimbal — the whole chassis drives, turns and spins.
|
|
27669
|
+
* The two are different physical models: PTZ is absolute-position + presets,
|
|
27670
|
+
* navigation is momentary drive nudges + discrete robot ACTIONS
|
|
27671
|
+
* (dock / spot-clean / follow-pet / go-to-point / …).
|
|
27672
|
+
* - This cap is the SOURCE OF TRUTH. Two consumers adapt from it rather than
|
|
27673
|
+
* the reverse:
|
|
27674
|
+
* 1. a native CamStack navigation panel (data-driven from `listActions`
|
|
27675
|
+
* / `getOptions`), and
|
|
27676
|
+
* 2. the PTZ surface — a thin adapter mimics `ptz` from `navigation` so a
|
|
27677
|
+
* robot camera shows up in the existing PTZ control path without every
|
|
27678
|
+
* PTZ provider learning about robots. The mapping lives in the adapter,
|
|
27679
|
+
* not here (see the addon design note):
|
|
27680
|
+
* ptz.continuousMove({pan,tilt}) → navigation.move({pan,tilt})
|
|
27681
|
+
* ptz.stop() → navigation.stop()
|
|
27682
|
+
* ptz.goHome() → navigation.runAction('goHome')
|
|
27683
|
+
* ptz.getPresets() → navigation.listActions() (id→preset)
|
|
27684
|
+
* ptz.goToPreset(id) → navigation.runAction(id)
|
|
27685
|
+
*
|
|
27686
|
+
* ## Continuous drive
|
|
27687
|
+
*
|
|
27688
|
+
* `move` is MOMENTARY. Fluid navigation comes from the UI (or the PTZ adapter)
|
|
27689
|
+
* sending `move({pan,tilt})` REPEATEDLY at ~1 Hz while a direction is held, and
|
|
27690
|
+
* one `stop()` on release — exactly like the robot app's remote-drive joystick.
|
|
27691
|
+
* The provider forwards EACH `move` to one drive write; it must NOT debounce or
|
|
27692
|
+
* coalesce them. The UI owns the cadence.
|
|
27693
|
+
*
|
|
27694
|
+
* ## The action dictionary
|
|
27695
|
+
*
|
|
27696
|
+
* The discrete controls (dock / locate / spot-clean / follow / flash / sounds)
|
|
27697
|
+
* are a DATA-DRIVEN dictionary the cap exposes via `listActions()`. Each entry
|
|
27698
|
+
* carries `{ id, kind, label, icon }` (plus `soundId` for sound entries) so the
|
|
27699
|
+
* native panel AND the PTZ mimic render buttons WITHOUT hardcoding a
|
|
27700
|
+
* vendor-specific list. `kind: 'action'` entries are triggered with
|
|
27701
|
+
* `runAction({ actionId })`; `kind: 'sound'` entries with `playSound({ soundId })`
|
|
27702
|
+
* (the entry carries the `soundId` to pass). The general primitives — `move`,
|
|
27703
|
+
* `stop`, `goToPoint` — stay as first-class methods, not dictionary entries.
|
|
27704
|
+
*
|
|
27705
|
+
* NOTE (provider wiring): the first provider (Dreame) drives this with the RAW
|
|
27706
|
+
* `callAction(siid,aiid,in)` / `setProperty({siid,piid,value})` MIoT primitives
|
|
27707
|
+
* that the currently-published `@apocaliss92/nodedreame` already exposes on
|
|
27708
|
+
* every device handle. A future nodedreame publish adds a typed
|
|
27709
|
+
* `DreameCameraController` (drive / playPetSound / spotClean / findPet / …); the
|
|
27710
|
+
* provider can then swap the raw calls for the typed methods with no change to
|
|
27711
|
+
* THIS contract.
|
|
27712
|
+
*/
|
|
27713
|
+
/**
|
|
27714
|
+
* A momentary drive nudge. The robot MOVES (no gimbal) for as long as the caller
|
|
27715
|
+
* keeps sending nudges (~1 Hz); an explicit `stop` (or letting the nudges lapse)
|
|
27716
|
+
* halts it.
|
|
27717
|
+
*
|
|
27718
|
+
* - `pan` — turn: negative = left, positive = right, 0 = straight.
|
|
27719
|
+
* - `tilt` — throttle: positive = forward, negative = spin / turn-around.
|
|
27720
|
+
* - `speed` — optional intensity hint [0, 1]; the provider may scale the drive
|
|
27721
|
+
* vector by it (drivers without proportional drive ignore it).
|
|
27722
|
+
*
|
|
27723
|
+
* `pan` / `tilt` are normalized [-1, 1]. Both optional so a caller can nudge one
|
|
27724
|
+
* axis alone; an all-undefined nudge is a no-op.
|
|
27725
|
+
*/
|
|
27726
|
+
var NavigationMoveCommandSchema = object({
|
|
27727
|
+
pan: number().min(-1).max(1).optional(),
|
|
27728
|
+
tilt: number().min(-1).max(1).optional(),
|
|
27729
|
+
speed: number().min(0).max(1).optional()
|
|
27730
|
+
});
|
|
27731
|
+
/**
|
|
27732
|
+
* The enumerated discrete actions a navigation-capable robot can perform via
|
|
27733
|
+
* `runAction`. This is the CLOSED vocabulary; a given device advertises the
|
|
27734
|
+
* subset it supports through `listActions`. Sounds are NOT here — they go through
|
|
27735
|
+
* `playSound` (see the `sound` dictionary entries).
|
|
27736
|
+
*/
|
|
27737
|
+
var NavigationActionIdSchema = _enum([
|
|
27738
|
+
"goHome",
|
|
27739
|
+
"locate",
|
|
27740
|
+
"spotClean",
|
|
27741
|
+
"findPet",
|
|
27742
|
+
"personFollow",
|
|
27743
|
+
"stop",
|
|
27744
|
+
"startClean",
|
|
27745
|
+
"pauseClean",
|
|
27746
|
+
"dockWash",
|
|
27747
|
+
"autoEmpty",
|
|
27748
|
+
"flashOn",
|
|
27749
|
+
"flashOff"
|
|
27750
|
+
]);
|
|
27751
|
+
/** Whether a dictionary entry is a `runAction` action or a `playSound` sound. */
|
|
27752
|
+
var NavigationEntryKindSchema = _enum(["action", "sound"]);
|
|
27753
|
+
/**
|
|
27754
|
+
* One entry in the navigation action dictionary — the DATA-DRIVEN unit both the
|
|
27755
|
+
* native panel and the PTZ mimic render as a button.
|
|
27756
|
+
*
|
|
27757
|
+
* - `id` — stable id. For `kind:'action'` it is a {@link NavigationActionId}
|
|
27758
|
+
* (pass to `runAction`); for `kind:'sound'` it is a namespaced id
|
|
27759
|
+
* (`sound:meow`) whose `soundId` is passed to `playSound`.
|
|
27760
|
+
* - `icon` — icon HINT (lucide-style name; the UI maps it to its own set).
|
|
27761
|
+
* - `label` — operator-facing English label.
|
|
27762
|
+
* - `soundId` — wire sound id, present only on `kind:'sound'` entries.
|
|
27763
|
+
* - `enabled` — per-device FEATURE FLAG. `listActions` reports it so the UI /
|
|
27764
|
+
* PTZ render ONLY enabled entries. Data-driven: the provider
|
|
27765
|
+
* flips it from config, never by editing code.
|
|
27766
|
+
*/
|
|
27767
|
+
var NavigationActionEntrySchema = object({
|
|
27768
|
+
id: string(),
|
|
27769
|
+
kind: NavigationEntryKindSchema,
|
|
27770
|
+
label: string(),
|
|
27771
|
+
icon: string(),
|
|
27772
|
+
/** Present only on `kind:'sound'` entries — the id to pass to `playSound`. */
|
|
27773
|
+
soundId: number().int().optional(),
|
|
27774
|
+
/** Per-device feature flag — render this entry only when true. */
|
|
27775
|
+
enabled: boolean()
|
|
27776
|
+
});
|
|
27777
|
+
/** Coordinates for `goToPoint` — a point on the robot's live map. */
|
|
27778
|
+
var NavigationPointSchema = object({
|
|
27779
|
+
x: number(),
|
|
27780
|
+
y: number()
|
|
27781
|
+
});
|
|
27782
|
+
/**
|
|
27783
|
+
* Per-device FEATURE-FLAG report for the general (non-dictionary) primitives.
|
|
27784
|
+
* The cap reports which are enabled so the UI / PTZ render only the controls
|
|
27785
|
+
* that are turned on for THIS device. Data-driven: the provider derives these
|
|
27786
|
+
* from config + probe, never hardcoded in the UI. The per-DICTIONARY-entry flags
|
|
27787
|
+
* live on {@link NavigationActionEntrySchema.enabled}; these gate the primitives
|
|
27788
|
+
* that are not dictionary entries.
|
|
27789
|
+
*
|
|
27790
|
+
* - `move` / `stop` — the momentary drive joystick.
|
|
27791
|
+
* - `goToPoint` — send-to-map-coordinate. Ships OFF on Dreame until the
|
|
27792
|
+
* map-coordinate plumbing is wired.
|
|
27793
|
+
* - `runAction` — the discrete action buttons (dictionary `kind:'action'`).
|
|
27794
|
+
* - `playSound` — the sound buttons (dictionary `kind:'sound'`).
|
|
27795
|
+
* - `light` — the on/off fill-light toggle (works anytime).
|
|
27796
|
+
* - `lightMode` — the auto/manual selector + manual level slider (a
|
|
27797
|
+
* camera-service control; needs an active stream).
|
|
27798
|
+
*/
|
|
27799
|
+
var NavigationFeaturesSchema = object({
|
|
27800
|
+
move: boolean(),
|
|
27801
|
+
stop: boolean(),
|
|
27802
|
+
goToPoint: boolean(),
|
|
27803
|
+
runAction: boolean(),
|
|
27804
|
+
playSound: boolean(),
|
|
27805
|
+
light: boolean(),
|
|
27806
|
+
lightMode: boolean()
|
|
27807
|
+
});
|
|
27808
|
+
/** Light mode: `auto` lets the camera choose brightness; `manual` uses `level`. */
|
|
27809
|
+
var NavigationLightModeSchema = _enum(["auto", "manual"]);
|
|
27810
|
+
/**
|
|
27811
|
+
* Live navigation state so the UI can reflect what the robot is doing:
|
|
27812
|
+
* - `mode` — coarse activity (idle / cleaning / following / …).
|
|
27813
|
+
* - `following` — person/pet follow is currently armed.
|
|
27814
|
+
* - `flash` — the on-camera fill light is on.
|
|
27815
|
+
* - `lightMode` — auto vs manual fill-light mode.
|
|
27816
|
+
* - `lightLevel` — manual fill-light level (40..100); meaningful when
|
|
27817
|
+
* `lightMode === 'manual'`.
|
|
27818
|
+
*/
|
|
27819
|
+
var NavigationStatusSchema = object({
|
|
27820
|
+
mode: _enum([
|
|
27821
|
+
"idle",
|
|
27822
|
+
"cleaning",
|
|
27823
|
+
"spot",
|
|
27824
|
+
"following",
|
|
27825
|
+
"goto",
|
|
27826
|
+
"returning",
|
|
27827
|
+
"paused",
|
|
27828
|
+
"unknown"
|
|
27829
|
+
]),
|
|
27830
|
+
following: boolean(),
|
|
27831
|
+
flash: boolean(),
|
|
27832
|
+
lightMode: NavigationLightModeSchema,
|
|
27833
|
+
lightLevel: number().min(40).max(100),
|
|
27834
|
+
/** Ms epoch when the slice was last updated. */
|
|
27835
|
+
lastChangedAt: number()
|
|
27836
|
+
});
|
|
27837
|
+
NavigationStatusSchema.extend({ lastFetchedAt: number() });
|
|
27838
|
+
DeviceType.Camera, method(NavigationMoveCommandSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), _void(), { kind: "mutation" }), method(NavigationPointSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), array(NavigationActionEntrySchema)), method(object({
|
|
27839
|
+
deviceId: number(),
|
|
27840
|
+
actionId: NavigationActionIdSchema
|
|
27841
|
+
}), _void(), { kind: "mutation" }), method(object({
|
|
27842
|
+
deviceId: number(),
|
|
27843
|
+
soundId: number().int()
|
|
27844
|
+
}), _void(), { kind: "mutation" }), method(object({
|
|
27845
|
+
deviceId: number(),
|
|
27846
|
+
on: boolean()
|
|
27847
|
+
}), _void(), { kind: "mutation" }), method(object({
|
|
27848
|
+
deviceId: number(),
|
|
27849
|
+
mode: NavigationLightModeSchema,
|
|
27850
|
+
level: number().min(40).max(100).optional()
|
|
27851
|
+
}), _void(), { kind: "mutation" }), method(object({
|
|
27852
|
+
deviceId: number(),
|
|
27853
|
+
level: number().min(40).max(100)
|
|
27854
|
+
}), _void(), { kind: "mutation" }), method(object({ deviceId: number() }), NavigationFeaturesSchema), object({
|
|
27855
|
+
deviceId: number(),
|
|
27856
|
+
status: NavigationStatusSchema
|
|
27857
|
+
});
|
|
27655
27858
|
DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
|
|
27656
27859
|
kind: "mutation",
|
|
27657
27860
|
auth: "admin"
|
|
@@ -32741,6 +32944,66 @@ Object.freeze({
|
|
|
32741
32944
|
addonId: null,
|
|
32742
32945
|
access: "create"
|
|
32743
32946
|
},
|
|
32947
|
+
"navigation.getFeatures": {
|
|
32948
|
+
capName: "navigation",
|
|
32949
|
+
capScope: "device",
|
|
32950
|
+
addonId: null,
|
|
32951
|
+
access: "view"
|
|
32952
|
+
},
|
|
32953
|
+
"navigation.goToPoint": {
|
|
32954
|
+
capName: "navigation",
|
|
32955
|
+
capScope: "device",
|
|
32956
|
+
addonId: null,
|
|
32957
|
+
access: "create"
|
|
32958
|
+
},
|
|
32959
|
+
"navigation.listActions": {
|
|
32960
|
+
capName: "navigation",
|
|
32961
|
+
capScope: "device",
|
|
32962
|
+
addonId: null,
|
|
32963
|
+
access: "view"
|
|
32964
|
+
},
|
|
32965
|
+
"navigation.move": {
|
|
32966
|
+
capName: "navigation",
|
|
32967
|
+
capScope: "device",
|
|
32968
|
+
addonId: null,
|
|
32969
|
+
access: "create"
|
|
32970
|
+
},
|
|
32971
|
+
"navigation.playSound": {
|
|
32972
|
+
capName: "navigation",
|
|
32973
|
+
capScope: "device",
|
|
32974
|
+
addonId: null,
|
|
32975
|
+
access: "create"
|
|
32976
|
+
},
|
|
32977
|
+
"navigation.runAction": {
|
|
32978
|
+
capName: "navigation",
|
|
32979
|
+
capScope: "device",
|
|
32980
|
+
addonId: null,
|
|
32981
|
+
access: "create"
|
|
32982
|
+
},
|
|
32983
|
+
"navigation.setLightLevel": {
|
|
32984
|
+
capName: "navigation",
|
|
32985
|
+
capScope: "device",
|
|
32986
|
+
addonId: null,
|
|
32987
|
+
access: "create"
|
|
32988
|
+
},
|
|
32989
|
+
"navigation.setLightMode": {
|
|
32990
|
+
capName: "navigation",
|
|
32991
|
+
capScope: "device",
|
|
32992
|
+
addonId: null,
|
|
32993
|
+
access: "create"
|
|
32994
|
+
},
|
|
32995
|
+
"navigation.setLightOn": {
|
|
32996
|
+
capName: "navigation",
|
|
32997
|
+
capScope: "device",
|
|
32998
|
+
addonId: null,
|
|
32999
|
+
access: "create"
|
|
33000
|
+
},
|
|
33001
|
+
"navigation.stop": {
|
|
33002
|
+
capName: "navigation",
|
|
33003
|
+
capScope: "device",
|
|
33004
|
+
addonId: null,
|
|
33005
|
+
access: "create"
|
|
33006
|
+
},
|
|
32744
33007
|
"networkAccess.getEndpoint": {
|
|
32745
33008
|
capName: "network-access",
|
|
32746
33009
|
capScope: "system",
|
|
@@ -36836,6 +37099,56 @@ Object.freeze({
|
|
|
36836
37099
|
form: "single",
|
|
36837
37100
|
optional: false
|
|
36838
37101
|
}],
|
|
37102
|
+
"navigation.getFeatures": [{
|
|
37103
|
+
name: "deviceId",
|
|
37104
|
+
form: "single",
|
|
37105
|
+
optional: false
|
|
37106
|
+
}],
|
|
37107
|
+
"navigation.goToPoint": [{
|
|
37108
|
+
name: "deviceId",
|
|
37109
|
+
form: "single",
|
|
37110
|
+
optional: false
|
|
37111
|
+
}],
|
|
37112
|
+
"navigation.listActions": [{
|
|
37113
|
+
name: "deviceId",
|
|
37114
|
+
form: "single",
|
|
37115
|
+
optional: false
|
|
37116
|
+
}],
|
|
37117
|
+
"navigation.move": [{
|
|
37118
|
+
name: "deviceId",
|
|
37119
|
+
form: "single",
|
|
37120
|
+
optional: false
|
|
37121
|
+
}],
|
|
37122
|
+
"navigation.playSound": [{
|
|
37123
|
+
name: "deviceId",
|
|
37124
|
+
form: "single",
|
|
37125
|
+
optional: false
|
|
37126
|
+
}],
|
|
37127
|
+
"navigation.runAction": [{
|
|
37128
|
+
name: "deviceId",
|
|
37129
|
+
form: "single",
|
|
37130
|
+
optional: false
|
|
37131
|
+
}],
|
|
37132
|
+
"navigation.setLightLevel": [{
|
|
37133
|
+
name: "deviceId",
|
|
37134
|
+
form: "single",
|
|
37135
|
+
optional: false
|
|
37136
|
+
}],
|
|
37137
|
+
"navigation.setLightMode": [{
|
|
37138
|
+
name: "deviceId",
|
|
37139
|
+
form: "single",
|
|
37140
|
+
optional: false
|
|
37141
|
+
}],
|
|
37142
|
+
"navigation.setLightOn": [{
|
|
37143
|
+
name: "deviceId",
|
|
37144
|
+
form: "single",
|
|
37145
|
+
optional: false
|
|
37146
|
+
}],
|
|
37147
|
+
"navigation.stop": [{
|
|
37148
|
+
name: "deviceId",
|
|
37149
|
+
form: "single",
|
|
37150
|
+
optional: false
|
|
37151
|
+
}],
|
|
36839
37152
|
"networkQuality.getDeviceStats": [{
|
|
36840
37153
|
name: "deviceId",
|
|
36841
37154
|
form: "single",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@camstack/addon-export-hap",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.83",
|
|
4
4
|
"description": "HomeKit (HAP) exporter for CamStack devices. Publishes each exposed device as its own HomeKit accessory: cameras and doorbells with SRTP streaming, HomeKit Secure Video, motion, two-way audio, PTZ and battery; switches, lights, locks and sensors through a capability→service table.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"camstack",
|