@camstack/addon-provider-reolink 1.2.135 → 1.2.137

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/addon.js CHANGED
@@ -12896,7 +12896,23 @@ var PickStreamRequirementsSchema = object({
12896
12896
  * This is what lets one picker serve both the bypass and the full source
12897
12897
  * choice, instead of a consumer scoring privately when the bypass misses.
12898
12898
  */
12899
- allowTranscode: boolean().optional()
12899
+ allowTranscode: boolean().optional(),
12900
+ /**
12901
+ * Consider ONLY streams the broker has bound to a profile slot.
12902
+ *
12903
+ * A consumer that dials the broker — which is every exporter, since none
12904
+ * of them may open the camera's own URL — can do nothing with a source
12905
+ * that has no slot: there is no restream to dial. Without this the picker
12906
+ * can name such a stream, and each consumer discovers the dead end for
12907
+ * itself: Alexa's `profileForCamStream` returns `null` and it quietly
12908
+ * falls back, and HomeKit would have had to grow the same function again.
12909
+ *
12910
+ * Default `false`, and deliberately so: the BROKER itself picks through
12911
+ * here when it decides which source to BIND to a slot
12912
+ * (`computeInitialAssignment`), and it must see the unbound ones or it
12913
+ * could never bind them.
12914
+ */
12915
+ requireProfileBound: boolean().optional()
12900
12916
  }).readonly();
12901
12917
  var PickStreamPreferencesSchema = object({
12902
12918
  /**
@@ -12937,7 +12953,43 @@ var PickedCamStreamSchema = object({
12937
12953
  */
12938
12954
  transcodes: boolean(),
12939
12955
  /** One-line explanation of why this stream won — for logs / debug UI. */
12940
- reason: string()
12956
+ reason: string(),
12957
+ /**
12958
+ * The broker profile slot this source is bound to, when it is bound.
12959
+ *
12960
+ * Answered HERE because every consumer needs it and none of them can get it
12961
+ * from the `camStreamId` alone. Alexa wrote `profileForCamStream` for it —
12962
+ * a second cap read plus a `null` branch — and HomeKit was about to write
12963
+ * the same function a second time.
12964
+ *
12965
+ * Absent when the source has no slot, which a caller passing
12966
+ * `requireProfileBound` can never see.
12967
+ */
12968
+ profile: CamProfileSchema.optional(),
12969
+ /** The broker id of that slot, for logs that must name what was dialled. */
12970
+ brokerId: string().optional(),
12971
+ /**
12972
+ * The broker restream URL to dial for this stream.
12973
+ *
12974
+ * An exporter must never open the camera's own URL — the broker is the one
12975
+ * that dials the camera, and every consumer goes through its restream. So
12976
+ * the picker answers with the thing a consumer may actually use, instead of
12977
+ * naming a source and leaving each caller to look the URL up.
12978
+ */
12979
+ url: string().optional(),
12980
+ /**
12981
+ * Frames per second this stream really delivers, and where the number came
12982
+ * from.
12983
+ *
12984
+ * It is here because getting it wrong is expensive and silent: a HomeKit
12985
+ * accessory advertised 720p at 24 fps while the slot serving it ran at 9,
12986
+ * and the controller rendered nothing at all. The source is carried with the
12987
+ * value for the same reason the bitrate evidence is: `published` is what the
12988
+ * publisher declares and `measured` is what the broker observed, and they
12989
+ * are not interchangeable.
12990
+ */
12991
+ fps: number().positive().optional(),
12992
+ fpsSource: _enum(["published", "measured"]).optional()
12941
12993
  });
12942
12994
  /**
12943
12995
  * Camera streams — device-scoped facade over the system `stream-broker`.
package/dist/addon.mjs CHANGED
@@ -12891,7 +12891,23 @@ var PickStreamRequirementsSchema = object({
12891
12891
  * This is what lets one picker serve both the bypass and the full source
12892
12892
  * choice, instead of a consumer scoring privately when the bypass misses.
12893
12893
  */
12894
- allowTranscode: boolean().optional()
12894
+ allowTranscode: boolean().optional(),
12895
+ /**
12896
+ * Consider ONLY streams the broker has bound to a profile slot.
12897
+ *
12898
+ * A consumer that dials the broker — which is every exporter, since none
12899
+ * of them may open the camera's own URL — can do nothing with a source
12900
+ * that has no slot: there is no restream to dial. Without this the picker
12901
+ * can name such a stream, and each consumer discovers the dead end for
12902
+ * itself: Alexa's `profileForCamStream` returns `null` and it quietly
12903
+ * falls back, and HomeKit would have had to grow the same function again.
12904
+ *
12905
+ * Default `false`, and deliberately so: the BROKER itself picks through
12906
+ * here when it decides which source to BIND to a slot
12907
+ * (`computeInitialAssignment`), and it must see the unbound ones or it
12908
+ * could never bind them.
12909
+ */
12910
+ requireProfileBound: boolean().optional()
12895
12911
  }).readonly();
12896
12912
  var PickStreamPreferencesSchema = object({
12897
12913
  /**
@@ -12932,7 +12948,43 @@ var PickedCamStreamSchema = object({
12932
12948
  */
12933
12949
  transcodes: boolean(),
12934
12950
  /** One-line explanation of why this stream won — for logs / debug UI. */
12935
- reason: string()
12951
+ reason: string(),
12952
+ /**
12953
+ * The broker profile slot this source is bound to, when it is bound.
12954
+ *
12955
+ * Answered HERE because every consumer needs it and none of them can get it
12956
+ * from the `camStreamId` alone. Alexa wrote `profileForCamStream` for it —
12957
+ * a second cap read plus a `null` branch — and HomeKit was about to write
12958
+ * the same function a second time.
12959
+ *
12960
+ * Absent when the source has no slot, which a caller passing
12961
+ * `requireProfileBound` can never see.
12962
+ */
12963
+ profile: CamProfileSchema.optional(),
12964
+ /** The broker id of that slot, for logs that must name what was dialled. */
12965
+ brokerId: string().optional(),
12966
+ /**
12967
+ * The broker restream URL to dial for this stream.
12968
+ *
12969
+ * An exporter must never open the camera's own URL — the broker is the one
12970
+ * that dials the camera, and every consumer goes through its restream. So
12971
+ * the picker answers with the thing a consumer may actually use, instead of
12972
+ * naming a source and leaving each caller to look the URL up.
12973
+ */
12974
+ url: string().optional(),
12975
+ /**
12976
+ * Frames per second this stream really delivers, and where the number came
12977
+ * from.
12978
+ *
12979
+ * It is here because getting it wrong is expensive and silent: a HomeKit
12980
+ * accessory advertised 720p at 24 fps while the slot serving it ran at 9,
12981
+ * and the controller rendered nothing at all. The source is carried with the
12982
+ * value for the same reason the bitrate evidence is: `published` is what the
12983
+ * publisher declares and `measured` is what the broker observed, and they
12984
+ * are not interchangeable.
12985
+ */
12986
+ fps: number().positive().optional(),
12987
+ fpsSource: _enum(["published", "measured"]).optional()
12936
12988
  });
12937
12989
  /**
12938
12990
  * Camera streams — device-scoped facade over the system `stream-broker`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-reolink",
3
- "version": "1.2.135",
3
+ "version": "1.2.137",
4
4
  "description": "Reolink camera device provider addon for CamStack — native Baichuan protocol",
5
5
  "keywords": [
6
6
  "camstack",