@camstack/addon-provider-reolink 1.2.54 → 1.2.55

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
@@ -29018,17 +29018,60 @@ var SetSiteLocationInputSchema = object({
29018
29018
  longitude: number().min(-180).max(180)
29019
29019
  }).nullable();
29020
29020
  /**
29021
- * One `(procedure, user-agent, ip, principal)` tuple of the HTTP request
29021
+ * The TRANSPORT a call arrived on.
29022
+ *
29023
+ * Every counted call carries exactly one of these, and `unknown` is a PLANE
29024
+ * rather than a gap: a plane that cannot attribute a call declares it here, so
29025
+ * the call lands in a named bucket instead of vanishing. `planes` summing to
29026
+ * `procedureCalls` is what makes "the sum of the planes explains the total"
29027
+ * checkable rather than asserted.
29028
+ *
29029
+ * - `http` — the Fastify tRPC plugin (`/trpc/*`), one context per request.
29030
+ * - `ws` — `applyWSSHandler`, counted per OPERATION rather than per
29031
+ * connection; the viewer talks to the hub over `wsLink`
29032
+ * exclusively, so this is the plane the HTTP census could not see.
29033
+ * - `mesh` — the in-process `$core-caps` bridge (`createCaller`), which
29034
+ * never touches a socket and therefore never touched a census.
29035
+ * - `unknown` — counted, plane undecidable. No hook produces it today, and
29036
+ * that is exactly what its `0` asserts: every plane the hub has can name
29037
+ * itself. It is an output bucket, never a knob — a call that arrives on a
29038
+ * plane nobody instrumented lands here instead of vanishing from the total.
29039
+ */
29040
+ var TransportPlaneSchema = _enum([
29041
+ "http",
29042
+ "ws",
29043
+ "mesh",
29044
+ "unknown"
29045
+ ]);
29046
+ /**
29047
+ * Calls per plane. Every key is always present, `0` included — an absent plane
29048
+ * reads as "not instrumented", which is the one thing this census must never
29049
+ * make an operator wonder about.
29050
+ */
29051
+ var TransportPlaneCountsSchema = object({
29052
+ http: number(),
29053
+ ws: number(),
29054
+ mesh: number(),
29055
+ unknown: number()
29056
+ });
29057
+ /**
29058
+ * One `(plane, procedure, user-agent, ip, principal)` tuple of the transport
29022
29059
  * census. `principal` is the DERIVED identity (`apocaliss92 (admin)`,
29023
29060
  * `scoped:1a2b3c4d (scoped-token)`, `anonymous`) that the tRPC error log
29024
29061
  * already prints - never a token, never an `Authorization` header.
29062
+ *
29063
+ * `subscriptions` is counted APART from `calls`: a subscription is opened once
29064
+ * and lives for hours, so folding it into a call count makes one long-lived
29065
+ * stream look like a storm.
29025
29066
  */
29026
29067
  var RequestCensusGroupSchema = object({
29068
+ plane: TransportPlaneSchema,
29027
29069
  procedure: string(),
29028
29070
  userAgent: string(),
29029
29071
  ip: string(),
29030
29072
  principal: string(),
29031
29073
  calls: number(),
29074
+ subscriptions: number(),
29032
29075
  perMin: number()
29033
29076
  });
29034
29077
  /**
@@ -29041,6 +29084,14 @@ var RequestCensusGroupSchema = object({
29041
29084
  var RequestCensusProcedureSchema = object({
29042
29085
  procedure: string(),
29043
29086
  calls: number(),
29087
+ /**
29088
+ * The same total, split by transport. THIS is the row that answers the
29089
+ * question the census exists for: one look at `deviceManager.listAll` says
29090
+ * which plane carried the 4 960, without joining two log lines by eye.
29091
+ */
29092
+ planes: TransportPlaneCountsSchema,
29093
+ /** Subscription STARTS on this procedure. Never folded into `calls`. */
29094
+ subscriptions: number(),
29044
29095
  perMin: number()
29045
29096
  });
29046
29097
  /**
@@ -29068,14 +29119,45 @@ var RequestCensusStatusSchema = object({
29068
29119
  */
29069
29120
  procedureCalls: number(),
29070
29121
  /**
29122
+ * `procedureCalls` split by transport. The four keys sum to
29123
+ * `procedureCalls` by construction - {@link RequestCensusSnapshotSchema}'s
29124
+ * `planesExplainTotal` is that identity, checked rather than assumed.
29125
+ */
29126
+ planes: TransportPlaneCountsSchema,
29127
+ /**
29128
+ * True iff `planes` sums to `procedureCalls`. False means a call was counted
29129
+ * on no plane at all - which is a RESULT (a plane is missing from the
29130
+ * instrument), not a failure, and it has to be visible to be read as one.
29131
+ */
29132
+ planesExplainTotal: boolean(),
29133
+ /**
29071
29134
  * tRPC WebSocket connections opened during the window. NOT calls - the WS
29072
- * transport resolves one context per connection - but the number that says
29073
- * whether a plane this census cannot see was busy while HTTP was quiet.
29135
+ * adapter resolves one context per connection - kept because a plane's call
29136
+ * count of zero against 37 open connections says something different from a
29137
+ * plane with no connections at all.
29074
29138
  */
29075
29139
  wsConnections: number(),
29140
+ /**
29141
+ * Client frames the WS plane looked at. `wsMessages` far above
29142
+ * `planes.ws + subscriptions` means most traffic is not operations
29143
+ * (keepalives, connection params) - which is itself an answer.
29144
+ */
29145
+ wsMessages: number(),
29146
+ /**
29147
+ * Subscription STARTS across every plane, excluded from `procedureCalls` on
29148
+ * purpose: one live-events stream opened at boot and held for six hours is
29149
+ * one subscription, and counting it as a call would let a quiet plane
29150
+ * masquerade as the storm.
29151
+ */
29152
+ subscriptions: number(),
29153
+ /** `subscription.stop` frames. Starts minus stops is what is still open. */
29154
+ subscriptionStops: number(),
29076
29155
  distinctGroups: number(),
29077
- /** Calls counted in the totals whose group attribution was shed at the
29078
- * cardinality bound. */
29156
+ /**
29157
+ * Operations counted in the totals whose CALLER attribution was shed at the
29158
+ * cardinality bound. Unrelated to the `unknown` PLANE: these calls know
29159
+ * which transport they arrived on, they just lost their group row.
29160
+ */
29079
29161
  unattributedCalls: number(),
29080
29162
  procedures: array(RequestCensusProcedureSchema).readonly(),
29081
29163
  groups: array(RequestCensusGroupSchema).readonly()
package/dist/addon.mjs CHANGED
@@ -29013,17 +29013,60 @@ var SetSiteLocationInputSchema = object({
29013
29013
  longitude: number().min(-180).max(180)
29014
29014
  }).nullable();
29015
29015
  /**
29016
- * One `(procedure, user-agent, ip, principal)` tuple of the HTTP request
29016
+ * The TRANSPORT a call arrived on.
29017
+ *
29018
+ * Every counted call carries exactly one of these, and `unknown` is a PLANE
29019
+ * rather than a gap: a plane that cannot attribute a call declares it here, so
29020
+ * the call lands in a named bucket instead of vanishing. `planes` summing to
29021
+ * `procedureCalls` is what makes "the sum of the planes explains the total"
29022
+ * checkable rather than asserted.
29023
+ *
29024
+ * - `http` — the Fastify tRPC plugin (`/trpc/*`), one context per request.
29025
+ * - `ws` — `applyWSSHandler`, counted per OPERATION rather than per
29026
+ * connection; the viewer talks to the hub over `wsLink`
29027
+ * exclusively, so this is the plane the HTTP census could not see.
29028
+ * - `mesh` — the in-process `$core-caps` bridge (`createCaller`), which
29029
+ * never touches a socket and therefore never touched a census.
29030
+ * - `unknown` — counted, plane undecidable. No hook produces it today, and
29031
+ * that is exactly what its `0` asserts: every plane the hub has can name
29032
+ * itself. It is an output bucket, never a knob — a call that arrives on a
29033
+ * plane nobody instrumented lands here instead of vanishing from the total.
29034
+ */
29035
+ var TransportPlaneSchema = _enum([
29036
+ "http",
29037
+ "ws",
29038
+ "mesh",
29039
+ "unknown"
29040
+ ]);
29041
+ /**
29042
+ * Calls per plane. Every key is always present, `0` included — an absent plane
29043
+ * reads as "not instrumented", which is the one thing this census must never
29044
+ * make an operator wonder about.
29045
+ */
29046
+ var TransportPlaneCountsSchema = object({
29047
+ http: number(),
29048
+ ws: number(),
29049
+ mesh: number(),
29050
+ unknown: number()
29051
+ });
29052
+ /**
29053
+ * One `(plane, procedure, user-agent, ip, principal)` tuple of the transport
29017
29054
  * census. `principal` is the DERIVED identity (`apocaliss92 (admin)`,
29018
29055
  * `scoped:1a2b3c4d (scoped-token)`, `anonymous`) that the tRPC error log
29019
29056
  * already prints - never a token, never an `Authorization` header.
29057
+ *
29058
+ * `subscriptions` is counted APART from `calls`: a subscription is opened once
29059
+ * and lives for hours, so folding it into a call count makes one long-lived
29060
+ * stream look like a storm.
29020
29061
  */
29021
29062
  var RequestCensusGroupSchema = object({
29063
+ plane: TransportPlaneSchema,
29022
29064
  procedure: string(),
29023
29065
  userAgent: string(),
29024
29066
  ip: string(),
29025
29067
  principal: string(),
29026
29068
  calls: number(),
29069
+ subscriptions: number(),
29027
29070
  perMin: number()
29028
29071
  });
29029
29072
  /**
@@ -29036,6 +29079,14 @@ var RequestCensusGroupSchema = object({
29036
29079
  var RequestCensusProcedureSchema = object({
29037
29080
  procedure: string(),
29038
29081
  calls: number(),
29082
+ /**
29083
+ * The same total, split by transport. THIS is the row that answers the
29084
+ * question the census exists for: one look at `deviceManager.listAll` says
29085
+ * which plane carried the 4 960, without joining two log lines by eye.
29086
+ */
29087
+ planes: TransportPlaneCountsSchema,
29088
+ /** Subscription STARTS on this procedure. Never folded into `calls`. */
29089
+ subscriptions: number(),
29039
29090
  perMin: number()
29040
29091
  });
29041
29092
  /**
@@ -29063,14 +29114,45 @@ var RequestCensusStatusSchema = object({
29063
29114
  */
29064
29115
  procedureCalls: number(),
29065
29116
  /**
29117
+ * `procedureCalls` split by transport. The four keys sum to
29118
+ * `procedureCalls` by construction - {@link RequestCensusSnapshotSchema}'s
29119
+ * `planesExplainTotal` is that identity, checked rather than assumed.
29120
+ */
29121
+ planes: TransportPlaneCountsSchema,
29122
+ /**
29123
+ * True iff `planes` sums to `procedureCalls`. False means a call was counted
29124
+ * on no plane at all - which is a RESULT (a plane is missing from the
29125
+ * instrument), not a failure, and it has to be visible to be read as one.
29126
+ */
29127
+ planesExplainTotal: boolean(),
29128
+ /**
29066
29129
  * tRPC WebSocket connections opened during the window. NOT calls - the WS
29067
- * transport resolves one context per connection - but the number that says
29068
- * whether a plane this census cannot see was busy while HTTP was quiet.
29130
+ * adapter resolves one context per connection - kept because a plane's call
29131
+ * count of zero against 37 open connections says something different from a
29132
+ * plane with no connections at all.
29069
29133
  */
29070
29134
  wsConnections: number(),
29135
+ /**
29136
+ * Client frames the WS plane looked at. `wsMessages` far above
29137
+ * `planes.ws + subscriptions` means most traffic is not operations
29138
+ * (keepalives, connection params) - which is itself an answer.
29139
+ */
29140
+ wsMessages: number(),
29141
+ /**
29142
+ * Subscription STARTS across every plane, excluded from `procedureCalls` on
29143
+ * purpose: one live-events stream opened at boot and held for six hours is
29144
+ * one subscription, and counting it as a call would let a quiet plane
29145
+ * masquerade as the storm.
29146
+ */
29147
+ subscriptions: number(),
29148
+ /** `subscription.stop` frames. Starts minus stops is what is still open. */
29149
+ subscriptionStops: number(),
29071
29150
  distinctGroups: number(),
29072
- /** Calls counted in the totals whose group attribution was shed at the
29073
- * cardinality bound. */
29151
+ /**
29152
+ * Operations counted in the totals whose CALLER attribution was shed at the
29153
+ * cardinality bound. Unrelated to the `unknown` PLANE: these calls know
29154
+ * which transport they arrived on, they just lost their group row.
29155
+ */
29074
29156
  unattributedCalls: number(),
29075
29157
  procedures: array(RequestCensusProcedureSchema).readonly(),
29076
29158
  groups: array(RequestCensusGroupSchema).readonly()
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-reolink",
3
- "version": "1.2.54",
3
+ "version": "1.2.55",
4
4
  "description": "Reolink camera device provider addon for CamStack — native Baichuan protocol",
5
5
  "keywords": [
6
6
  "camstack",