@camstack/types 1.2.111 → 1.2.113
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 +1 -1
- package/dist/addon.mjs +1 -1
- package/dist/capabilities/face-gallery.cap.d.ts +60 -0
- package/dist/capabilities/index.d.ts +3 -3
- package/dist/capabilities/notification-rules.cap.d.ts +20 -0
- package/dist/capabilities/recording.cap.d.ts +66 -0
- package/dist/capabilities/system.cap.d.ts +489 -1
- package/dist/catalogs/index.d.ts +1 -0
- package/dist/catalogs/sensor-active-state.d.ts +130 -0
- package/dist/generated/addon-api.d.ts +35 -0
- package/dist/generated/device-proxy.d.ts +1 -1
- package/dist/generated/method-access-map.d.ts +1 -1
- package/dist/generated/method-device-selectors.d.ts +2 -2
- package/dist/generated/system-proxy.d.ts +1 -1
- package/dist/index.d.ts +7 -6
- package/dist/index.js +897 -109
- package/dist/index.mjs +866 -110
- package/dist/interfaces/recording-config.d.ts +44 -0
- package/dist/pipeline/native-lease.d.ts +9 -1
- package/dist/{sleep-BCRrMlni.js → sleep-CSodb2vQ.js} +2 -0
- package/dist/{sleep-DJlqY62B.mjs → sleep-CdbM8ge4.mjs} +2 -0
- package/dist/types/detection.d.ts +11 -2
- package/dist/types/labels.d.ts +26 -0
- package/package.json +1 -1
package/dist/addon.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
2
|
const require_event_category = require("./event-category-EY0GNjV9.js");
|
|
3
|
-
const require_sleep = require("./sleep-
|
|
3
|
+
const require_sleep = require("./sleep-CSodb2vQ.js");
|
|
4
4
|
const require_err_msg = require("./err-msg-COpsHMw2.js");
|
|
5
5
|
//#region src/generated/cap-input-defaults.ts
|
|
6
6
|
/**
|
package/dist/addon.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { t as EventCategory } from "./event-category-CIa_iT6b.mjs";
|
|
2
|
-
import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-
|
|
2
|
+
import { B as ReadinessRegistry, E as adminUiCapability, L as nodePin, R as readNodePin, St as emitReadiness, T as DeviceType, V as ReadinessTimeoutError, W as scopeKey, _t as DisposerChain, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, gt as DATAPLANE_SECRET_HEADER, h as createEventBusSliceSource, j as expandCapMethods, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as BaseAddon, x as viewerUiCapability, yt as normalizeAddonInitResult } from "./sleep-CdbM8ge4.mjs";
|
|
3
3
|
import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
|
|
4
4
|
//#region src/generated/cap-input-defaults.ts
|
|
5
5
|
/**
|
|
@@ -42,6 +42,44 @@ declare const FaceInfoSchema: z.ZodObject<{
|
|
|
42
42
|
suggestedMatchScore: z.ZodOptional<z.ZodNumber>;
|
|
43
43
|
}, z.core.$strip>;
|
|
44
44
|
export type FaceInfo = z.infer<typeof FaceInfoSchema>;
|
|
45
|
+
/**
|
|
46
|
+
* What a `listRecentFaces` page is ORDERED BY.
|
|
47
|
+
*
|
|
48
|
+
* - `timestamp` — when the face was seen. The historical (and default) order.
|
|
49
|
+
* - `suggestionConfidence` — {@link FaceInfo.suggestedMatchScore}, the peak
|
|
50
|
+
* cosine of the face's SUGGESTED identity. This is the "review by certainty"
|
|
51
|
+
* order: it puts the suggestions an operator can confirm with one tap at the
|
|
52
|
+
* top, and it is the reason this enum exists — a client that ranked a capped
|
|
53
|
+
* page client-side was ranking the newest N, never the most certain N.
|
|
54
|
+
*
|
|
55
|
+
* A row with NO suggestion (`suggestedMatchScore` absent — a legacy row, an
|
|
56
|
+
* auto-assigned face, or a face below the suggestion band) has no certainty to
|
|
57
|
+
* compare. Under `suggestionConfidence` it sorts **LAST, in BOTH directions**
|
|
58
|
+
* — flipping the direction reorders the rows that HAVE a certainty and never
|
|
59
|
+
* floods the page with the ones that do not. `addon-post-analysis`'s
|
|
60
|
+
* `store/face-sort.ts` is the single implementation, tiebreaks newest-first
|
|
61
|
+
* then by faceId, and is what makes this a total order instead of the
|
|
62
|
+
* backend's NULL-collation accident.
|
|
63
|
+
*/
|
|
64
|
+
declare const FaceSortFieldEnum: z.ZodEnum<{
|
|
65
|
+
timestamp: "timestamp";
|
|
66
|
+
suggestionConfidence: "suggestionConfidence";
|
|
67
|
+
}>;
|
|
68
|
+
export type FaceSortField = z.infer<typeof FaceSortFieldEnum>;
|
|
69
|
+
declare const FaceSortDirectionEnum: z.ZodEnum<{
|
|
70
|
+
asc: "asc";
|
|
71
|
+
desc: "desc";
|
|
72
|
+
}>;
|
|
73
|
+
export type FaceSortDirection = z.infer<typeof FaceSortDirectionEnum>;
|
|
74
|
+
/** One suggested group of look-alike UNASSIGNED faces. Ids only — an embedding
|
|
75
|
+
* never leaves the server. */
|
|
76
|
+
declare const FaceClusterSchema: z.ZodObject<{
|
|
77
|
+
faceIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
|
|
78
|
+
representativeFaceId: z.ZodString;
|
|
79
|
+
size: z.ZodNumber;
|
|
80
|
+
cohesion: z.ZodNumber;
|
|
81
|
+
}, z.core.$strip>;
|
|
82
|
+
export type FaceCluster = z.infer<typeof FaceClusterSchema>;
|
|
45
83
|
export declare const faceGalleryCapability: {
|
|
46
84
|
readonly name: "face-gallery";
|
|
47
85
|
readonly scope: "system";
|
|
@@ -90,6 +128,7 @@ export declare const faceGalleryCapability: {
|
|
|
90
128
|
}, z.core.$strip>, z.ZodVoid, "mutation">;
|
|
91
129
|
readonly listRecentFaces: import("./capability-definition.js").CapabilityMethodSchema<z.ZodOptional<z.ZodObject<{
|
|
92
130
|
deviceId: z.ZodOptional<z.ZodNumber>;
|
|
131
|
+
deviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
|
|
93
132
|
limit: z.ZodOptional<z.ZodNumber>;
|
|
94
133
|
filter: z.ZodOptional<z.ZodEnum<{
|
|
95
134
|
all: "all";
|
|
@@ -97,6 +136,16 @@ export declare const faceGalleryCapability: {
|
|
|
97
136
|
recognized: "recognized";
|
|
98
137
|
identified: "identified";
|
|
99
138
|
}>>;
|
|
139
|
+
since: z.ZodOptional<z.ZodNumber>;
|
|
140
|
+
until: z.ZodOptional<z.ZodNumber>;
|
|
141
|
+
sortBy: z.ZodOptional<z.ZodEnum<{
|
|
142
|
+
timestamp: "timestamp";
|
|
143
|
+
suggestionConfidence: "suggestionConfidence";
|
|
144
|
+
}>>;
|
|
145
|
+
sortDirection: z.ZodOptional<z.ZodEnum<{
|
|
146
|
+
asc: "asc";
|
|
147
|
+
desc: "desc";
|
|
148
|
+
}>>;
|
|
100
149
|
includeCrops: z.ZodOptional<z.ZodBoolean>;
|
|
101
150
|
}, z.core.$strip>>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
|
|
102
151
|
faceId: z.ZodString;
|
|
@@ -185,7 +234,9 @@ export declare const faceGalleryCapability: {
|
|
|
185
234
|
readonly suggestFaceClusters: import("./capability-definition.js").CapabilityMethodSchema<z.ZodOptional<z.ZodObject<{
|
|
186
235
|
threshold: z.ZodOptional<z.ZodNumber>;
|
|
187
236
|
minClusterSize: z.ZodOptional<z.ZodNumber>;
|
|
237
|
+
maxClusters: z.ZodOptional<z.ZodNumber>;
|
|
188
238
|
limit: z.ZodOptional<z.ZodNumber>;
|
|
239
|
+
maxFacesScanned: z.ZodOptional<z.ZodNumber>;
|
|
189
240
|
}, z.core.$strip>>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
|
|
190
241
|
faceIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
|
|
191
242
|
representativeFaceId: z.ZodString;
|
|
@@ -195,4 +246,13 @@ export declare const faceGalleryCapability: {
|
|
|
195
246
|
};
|
|
196
247
|
};
|
|
197
248
|
export type IFaceGalleryProvider = InferProvider<typeof faceGalleryCapability>;
|
|
249
|
+
/**
|
|
250
|
+
* The inputs, as the PROVIDER sees them.
|
|
251
|
+
*
|
|
252
|
+
* Named so an implementation can annotate its methods without re-typing the
|
|
253
|
+
* shape (`z.infer`, never a hand copy — a duplicated input shape is how a new
|
|
254
|
+
* field arrives at the router and is dropped by the provider).
|
|
255
|
+
*/
|
|
256
|
+
export type ListRecentFacesInput = z.infer<typeof faceGalleryCapability.methods.listRecentFaces.input>;
|
|
257
|
+
export type SuggestFaceClustersInput = z.infer<typeof faceGalleryCapability.methods.suggestFaceClusters.input>;
|
|
198
258
|
export {};
|
|
@@ -142,7 +142,7 @@ export { type DoorbellPressEvent, DoorbellPressEventSchema, type DoorbellStatus,
|
|
|
142
142
|
export { type EnumSensorDateTimeFormat, EnumSensorDateTimeFormatSchema, type EnumSensorStatus, EnumSensorStatusSchema, enumSensorCapability, type IEnumSensorProvider, } from './enum-sensor.cap.js';
|
|
143
143
|
export { type EventEmitterStatus, EventEmitterStatusSchema, type EventFire, EventFireSchema, eventEmitterCapability, type IEventEmitterProvider, } from './event-emitter.cap.js';
|
|
144
144
|
export { EventItemSchema, eventsCapability, type IEventsProvider } from './events.cap.js';
|
|
145
|
-
export { type FaceInfo, faceGalleryCapability, type Identity, type IdentitySampleInfo, type IFaceGalleryProvider, } from './face-gallery.cap.js';
|
|
145
|
+
export { type FaceCluster, type FaceInfo, type FaceSortDirection, type FaceSortField, faceGalleryCapability, type Identity, type IdentitySampleInfo, type IFaceGalleryProvider, type ListRecentFacesInput, type SuggestFaceClustersInput, } from './face-gallery.cap.js';
|
|
146
146
|
export { type FanControlStatus, FanControlStatusSchema, type FanDirection, FanDirectionSchema, fanControlCapability, type IFanControlProvider, } from './fan-control.cap.js';
|
|
147
147
|
export { type FeatureProbeStatus, FeatureProbeStatusSchema, featureProbeCapability, type IFeatureProbeProvider, } from './feature-probe.cap.js';
|
|
148
148
|
export { type FloodStatus, FloodStatusSchema, floodCapability, type IFloodProvider, } from './flood.cap.js';
|
|
@@ -179,7 +179,7 @@ export { type IPrivacyMaskProvider, type PrivacyMaskOptions, PrivacyMaskOptionsS
|
|
|
179
179
|
export { type IPtzProvider, PtzMoveCommandSchema, type PtzOptions, PtzOptionsSchema, PtzPositionSchema, PtzPresetSchema, type PtzStatus, PtzStatusSchema, ptzCapability, } from './ptz.cap.js';
|
|
180
180
|
export { type IPtzAutotrackProvider, type PtzAutotrackRuntimeState, PtzAutotrackRuntimeStateSchema, type PtzAutotrackSettings, PtzAutotrackSettingsSchema, type PtzAutotrackStatus, PtzAutotrackStatusSchema, type PtzAutotrackTargetOption, PtzAutotrackTargetOptionSchema, ptzAutotrackCapability, } from './ptz-autotrack.cap.js';
|
|
181
181
|
export { type IRebootProvider, rebootCapability } from './reboot.cap.js';
|
|
182
|
-
export { type IRecordingProvider, type LocateSegmentResult, LocateSegmentResultSchema, type ReadGopBytesResult, ReadGopBytesResultSchema, type ReadSegmentBytesResult, ReadSegmentBytesResultSchema, type RecordingAvailability, RecordingAvailabilitySchema, type RecordingDays, RecordingDaysSchema, type RecordingDeviceUsage, RecordingDeviceUsageSchema, type RecordingLocationUsage, RecordingLocationUsageSchema, type RecordingManifest, RecordingManifestSchema, RecordingRangeSchema, type RecordingRebalanceInput, RecordingRebalanceInputSchema, type RecordingRebalanceMove, RecordingRebalanceMoveSchema, type RecordingRebalancePlan, RecordingRebalancePlanSchema, type RecordingRebalanceSkip, type RecordingRebalanceSkipReason, RecordingRebalanceSkipReasonSchema, RecordingRebalanceSkipSchema, type RecordingStatus, RecordingStatusSchema, type RecordingStorageUsage, RecordingStorageUsageSchema, recordingCapability, } from './recording.cap.js';
|
|
182
|
+
export { type IRecordingProvider, type LocateSegmentResult, LocateSegmentResultSchema, type ReadGopBytesResult, ReadGopBytesResultSchema, type ReadSegmentBytesResult, ReadSegmentBytesResultSchema, type ReadWindowBytesResult, ReadWindowBytesResultSchema, type RecordingAvailability, RecordingAvailabilitySchema, type RecordingDays, RecordingDaysSchema, type RecordingDeviceUsage, RecordingDeviceUsageSchema, type RecordingLocationUsage, RecordingLocationUsageSchema, type RecordingManifest, RecordingManifestSchema, RecordingRangeSchema, type RecordingRebalanceInput, RecordingRebalanceInputSchema, type RecordingRebalanceMove, RecordingRebalanceMoveSchema, type RecordingRebalancePlan, RecordingRebalancePlanSchema, type RecordingRebalanceSkip, type RecordingRebalanceSkipReason, RecordingRebalanceSkipReasonSchema, RecordingRebalanceSkipSchema, type RecordingStatus, RecordingStatusSchema, type RecordingStorageUsage, RecordingStorageUsageSchema, recordingCapability, } from './recording.cap.js';
|
|
183
183
|
export { EXPORT_DENSE_MAX_RANGES, type ExportBytes, ExportBytesSchema, type ExportDense, type ExportDenseRange, ExportDenseRangeSchema, ExportDenseSchema, type ExportDownload, ExportDownloadSchema, type ExportOptions, ExportOptionsSchema, type ExportRecord, ExportRecordSchema, ExportSpeedSchema, type ExportState, ExportStateSchema, ExportTimelapseSchema, type IRecordingExportProvider, RECORDING_EXPORT_MAX_READ_BYTES, recordingExportCapability, } from './recording-export.cap.js';
|
|
184
184
|
export { type ISceneMonitorProvider, SCENE_CONDITIONS, SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, SCENE_DEFAULT_ANCHOR_THRESHOLD, SCENE_DEFAULT_CHECK_INTERVAL_SEC, SCENE_DEFAULT_OBSERVATION_SPACING_SEC, SCENE_DEFAULT_QUIET_SECONDS, SCENE_DEFAULT_UNCOVERED_POLICY, SCENE_DIVERGED, SCENE_RESET_RECAPTURES, type SceneCheck, SceneCheckSchema, type SceneCondition, SceneConditionSchema, type SceneConfirm, SceneConfirmSchema, type SceneMonitor, SceneMonitorSchema, type SceneMonitorState, SceneMonitorStateSchema, type SceneMonitorStatus, SceneMonitorStatusSchema, type SceneReference, SceneReferenceSchema, type SceneUnavailable, SceneUnavailableSchema, type SceneUncoveredPolicy, SceneUncoveredPolicySchema, type SceneVerdict, SceneVerdictSchema, sceneMonitorCapability, } from './scene-monitor.cap.js';
|
|
185
185
|
export { type ZoneRule, type ZoneRuleMode, ZoneRuleModeEnum, ZoneRuleSchema, type ZoneRules, ZoneRulesArraySchema, } from './schemas/zone-rule.js';
|
|
@@ -189,7 +189,7 @@ export { type CamStreamDescriptor, CamStreamDescriptorSchema, type IStreamCatalo
|
|
|
189
189
|
export { type IStreamParamsProvider, type StreamParamsOptions, StreamParamsOptionsSchema, type StreamParamsStatus, StreamParamsStatusSchema, type StreamProfile, StreamProfileConfigSchema, StreamProfileOptionsSchema, type StreamProfilePatch, StreamProfilePatchSchema, StreamProfileSchema, streamParamsCapability, } from './stream-params.cap.js';
|
|
190
190
|
export { buildStreamParamsConfigSchema, parseStreamParamsFormPatch, STREAM_PROFILE_META, type StreamProfileMeta, } from './stream-params-config-schema.js';
|
|
191
191
|
export { type ISwitchProvider, type SwitchStatus, SwitchStatusSchema, switchCapability, } from './switch.cap.js';
|
|
192
|
-
export { FeatureManifestSchema, HealthStatusSchema, type ISystemProvider, NetworkAddressSchema, type SetSiteLocationInput, SetSiteLocationInputSchema, type SiteLocation, SiteLocationSchema, type SiteLocationSource, SiteLocationSourceSchema, type SiteLocationStatus, SiteLocationStatusSchema, systemCapability, } from './system.cap.js';
|
|
192
|
+
export { type DiagnosticId, DiagnosticIdSchema, type DiagnosticWindow, type DiagnosticWindowPatch, DiagnosticWindowPatchSchema, DiagnosticWindowSchema, FeatureManifestSchema, type GetLoggingSettingsInput, GetLoggingSettingsInputSchema, HealthStatusSchema, type ISystemProvider, type LoggingEffective, LoggingEffectiveSchema, type LoggingExplicit, LoggingExplicitSchema, type LoggingLevelLayer, LoggingLevelLayerSchema, type LoggingLevelSource, LoggingLevelSourceSchema, type LoggingScopeKind, LoggingScopeKindSchema, type LoggingSettingsPatch, LoggingSettingsPatchSchema, type LoggingSettingsState, LoggingSettingsStateSchema, NetworkAddressSchema, type RequestCensusGroup, RequestCensusGroupSchema, type RequestCensusProcedure, RequestCensusProcedureSchema, type RequestCensusSnapshot, RequestCensusSnapshotSchema, type RequestCensusStatus, RequestCensusStatusSchema, type SetLoggingSettingsInput, SetLoggingSettingsInputSchema, type SetSiteLocationInput, SetSiteLocationInputSchema, type SiteLocation, SiteLocationSchema, type SiteLocationSource, SiteLocationSourceSchema, type SiteLocationStatus, SiteLocationStatusSchema, systemCapability, } from './system.cap.js';
|
|
193
193
|
export { type ITamperProvider, type TamperStatus, TamperStatusSchema, tamperCapability, } from './tamper.cap.js';
|
|
194
194
|
export { type ITemperatureSensorProvider, type TemperatureSensorStatus, TemperatureSensorStatusSchema, temperatureSensorCapability, } from './temperature-sensor.cap.js';
|
|
195
195
|
export { type IToastProvider, ToastSchema, toastCapability } from './toast.cap.js';
|
|
@@ -1812,6 +1812,7 @@ export declare const NcHistoryEntrySchema: z.ZodObject<{
|
|
|
1812
1812
|
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
1813
1813
|
}, z.core.$strip>>;
|
|
1814
1814
|
}, z.core.$strip>;
|
|
1815
|
+
artifactIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
1815
1816
|
}, z.core.$strip>;
|
|
1816
1817
|
export type NcHistoryEntry = z.infer<typeof NcHistoryEntrySchema>;
|
|
1817
1818
|
/** `getHistory` default page size + hard ceiling (bounded output). */
|
|
@@ -4047,8 +4048,27 @@ export declare const notificationRulesCapability: {
|
|
|
4047
4048
|
data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
|
|
4048
4049
|
}, z.core.$strip>>;
|
|
4049
4050
|
}, z.core.$strip>;
|
|
4051
|
+
artifactIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
4050
4052
|
}, z.core.$strip>>;
|
|
4051
4053
|
}, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
|
|
4054
|
+
/**
|
|
4055
|
+
* Mint a fresh, externally-reachable URL for one artefact a history row
|
|
4056
|
+
* named in {@link NcHistoryEntrySchema.shape.artifactIds} — the SAME
|
|
4057
|
+
* signed-link mechanism the dispatcher uses to attach media to an
|
|
4058
|
+
* outgoing notification (one derivation; this never re-implements it).
|
|
4059
|
+
*
|
|
4060
|
+
* `url: null` on THREE causes a caller must treat identically ("no image
|
|
4061
|
+
* right now", never a broken link): the id is unknown, its artefact has
|
|
4062
|
+
* expired past the retained shelf's own age bound, or this install has no
|
|
4063
|
+
* externally-reachable base URL. A caller that received a URL on a
|
|
4064
|
+
* previous call and now gets `null` must stop showing it — a link that
|
|
4065
|
+
* worked five minutes ago is not proof it works now.
|
|
4066
|
+
*/
|
|
4067
|
+
readonly resolveArtifactUrl: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
|
|
4068
|
+
artifactId: z.ZodString;
|
|
4069
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
4070
|
+
url: z.ZodNullable<z.ZodString>;
|
|
4071
|
+
}, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
|
|
4052
4072
|
/**
|
|
4053
4073
|
* Snooze windows currently in effect, plus any whose digest has not yet
|
|
4054
4074
|
* gone out. `caller: 'required'`: a user sees their OWN windows and the
|
|
@@ -203,6 +203,33 @@ export declare const ReadGopBytesResultSchema: z.ZodObject<{
|
|
|
203
203
|
gopDurMs: z.ZodNumber;
|
|
204
204
|
}, z.core.$strip>;
|
|
205
205
|
export type ReadGopBytesResult = z.infer<typeof ReadGopBytesResultSchema>;
|
|
206
|
+
/**
|
|
207
|
+
* A time WINDOW of one finalized segment, cut by byte range — the multi-GOP
|
|
208
|
+
* twin of {@link ReadGopBytesResultSchema}'s single instant. Built for the
|
|
209
|
+
* replay clip's `recording` source (`docs/design/plans/2026-08-26-replay-clip-su-pipeline.md`):
|
|
210
|
+
* a replay needs several seconds of native pixels, not one frame.
|
|
211
|
+
*
|
|
212
|
+
* `ok.data` is standalone-demuxable, same as a GOP read. `ok.reachesRequestedEnd`
|
|
213
|
+
* is `false` when the returned bytes were cut short by the read's own safety
|
|
214
|
+
* byte cap before covering `[fromMs, toMs)` — a truncation, reported, not a
|
|
215
|
+
* silently shorter answer. `spans-multiple-segments` is a REFUSAL, not a
|
|
216
|
+
* degradation: a window whose end falls past the covering segment would need
|
|
217
|
+
* bytes stitched from a second segment file (its own `ftyp`+`moov`), which is
|
|
218
|
+
* not one standalone-demuxable stream — the caller's answer is to request a
|
|
219
|
+
* shorter window or one aligned to a single segment, not to receive spliced
|
|
220
|
+
* bytes nothing has proven decodable.
|
|
221
|
+
*/
|
|
222
|
+
export declare const ReadWindowBytesResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
223
|
+
kind: z.ZodLiteral<"ok">;
|
|
224
|
+
data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
|
|
225
|
+
gopStartMs: z.ZodNumber;
|
|
226
|
+
gopDurMs: z.ZodNumber;
|
|
227
|
+
reachesRequestedEnd: z.ZodBoolean;
|
|
228
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
229
|
+
kind: z.ZodLiteral<"spans-multiple-segments">;
|
|
230
|
+
segmentEndMs: z.ZodNumber;
|
|
231
|
+
}, z.core.$strip>], "kind">;
|
|
232
|
+
export type ReadWindowBytesResult = z.infer<typeof ReadWindowBytesResultSchema>;
|
|
206
233
|
export declare const recordingCapability: {
|
|
207
234
|
readonly name: "recording";
|
|
208
235
|
readonly scope: "system";
|
|
@@ -300,6 +327,12 @@ export declare const recordingCapability: {
|
|
|
300
327
|
triggers: z.ZodOptional<z.ZodObject<{
|
|
301
328
|
motion: z.ZodOptional<z.ZodBoolean>;
|
|
302
329
|
audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
|
|
330
|
+
objectClasses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
331
|
+
person: "person";
|
|
332
|
+
vehicle: "vehicle";
|
|
333
|
+
animal: "animal";
|
|
334
|
+
}>>>;
|
|
335
|
+
sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
|
|
303
336
|
}, z.core.$strip>>;
|
|
304
337
|
preBufferSec: z.ZodOptional<z.ZodNumber>;
|
|
305
338
|
postBufferSec: z.ZodOptional<z.ZodNumber>;
|
|
@@ -348,6 +381,27 @@ export declare const recordingCapability: {
|
|
|
348
381
|
gopStartMs: z.ZodNumber;
|
|
349
382
|
gopDurMs: z.ZodNumber;
|
|
350
383
|
}, z.core.$strip>, "query">;
|
|
384
|
+
/** Read a WINDOW `[fromMs, toMs)` of segment `startMs`, by mfra byte
|
|
385
|
+
* range — the multi-GOP twin of `readGopBytes`. Refuses (does not
|
|
386
|
+
* degrade) when the window runs past the covering segment. Used by the
|
|
387
|
+
* replay clip's `recording` source to fetch several seconds of native
|
|
388
|
+
* footage for its single ffmpeg decode pass. */
|
|
389
|
+
readonly readWindowBytes: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
|
|
390
|
+
deviceId: z.ZodNumber;
|
|
391
|
+
profile: z.ZodString;
|
|
392
|
+
startMs: z.ZodNumber;
|
|
393
|
+
fromMs: z.ZodNumber;
|
|
394
|
+
toMs: z.ZodNumber;
|
|
395
|
+
}, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
396
|
+
kind: z.ZodLiteral<"ok">;
|
|
397
|
+
data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
|
|
398
|
+
gopStartMs: z.ZodNumber;
|
|
399
|
+
gopDurMs: z.ZodNumber;
|
|
400
|
+
reachesRequestedEnd: z.ZodBoolean;
|
|
401
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
402
|
+
kind: z.ZodLiteral<"spans-multiple-segments">;
|
|
403
|
+
segmentEndMs: z.ZodNumber;
|
|
404
|
+
}, z.core.$strip>], "kind">, "query">;
|
|
351
405
|
readonly setDeviceConfig: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
|
|
352
406
|
deviceId: z.ZodNumber;
|
|
353
407
|
config: z.ZodObject<{
|
|
@@ -374,6 +428,12 @@ export declare const recordingCapability: {
|
|
|
374
428
|
triggers: z.ZodOptional<z.ZodObject<{
|
|
375
429
|
motion: z.ZodOptional<z.ZodBoolean>;
|
|
376
430
|
audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
|
|
431
|
+
objectClasses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
432
|
+
person: "person";
|
|
433
|
+
vehicle: "vehicle";
|
|
434
|
+
animal: "animal";
|
|
435
|
+
}>>>;
|
|
436
|
+
sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
|
|
377
437
|
}, z.core.$strip>>;
|
|
378
438
|
preBufferSec: z.ZodOptional<z.ZodNumber>;
|
|
379
439
|
postBufferSec: z.ZodOptional<z.ZodNumber>;
|
|
@@ -407,6 +467,12 @@ export declare const recordingCapability: {
|
|
|
407
467
|
triggers: z.ZodOptional<z.ZodObject<{
|
|
408
468
|
motion: z.ZodOptional<z.ZodBoolean>;
|
|
409
469
|
audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
|
|
470
|
+
objectClasses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
471
|
+
person: "person";
|
|
472
|
+
vehicle: "vehicle";
|
|
473
|
+
animal: "animal";
|
|
474
|
+
}>>>;
|
|
475
|
+
sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
|
|
410
476
|
}, z.core.$strip>>;
|
|
411
477
|
preBufferSec: z.ZodOptional<z.ZodNumber>;
|
|
412
478
|
postBufferSec: z.ZodOptional<z.ZodNumber>;
|