@camstack/addon-smtp-nodemailer 1.2.6 → 1.2.7

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.
@@ -36,7 +36,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
36
36
  }) : target, mod));
37
37
  var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
38
38
  //#endregion
39
- //#region ../types/dist/event-category-BLcNejAE.mjs
39
+ //#region ../types/dist/event-category-Bz24uP1U.mjs
40
40
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
41
41
  EventCategory["SystemBoot"] = "system.boot";
42
42
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -307,6 +307,19 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
307
307
  */
308
308
  EventCategory["DeviceStateChanged"] = "device.state-changed";
309
309
  /**
310
+ * Frame occupancy for a camera CHANGED — a tracked object was gained or
311
+ * lost. Carries `{ deviceId, totalObjects, byClass, zones }`.
312
+ *
313
+ * Emitted only on a change, so a steady scene is silent. It exists so a
314
+ * client can stop polling `zoneAnalytics.getCurrentSnapshot`: that was the
315
+ * one live badge with no push signal at all, and it cost a request every
316
+ * four seconds per visible camera.
317
+ *
318
+ * Like every event it is telemetry and may be dropped ([D8]) — a consumer
319
+ * keeps a slow reconcile rather than trusting it alone.
320
+ */
321
+ EventCategory["ZoneAnalyticsOccupancyChanged"] = "zone-analytics.occupancy-changed";
322
+ /**
310
323
  * Cap event fired by every device that registers the `battery`
311
324
  * capability. Mirrors the cap definition's `onStatusChanged`. Carries
312
325
  * `{ deviceId, status: BatteryStatus }`. Subscribers (alert center,
@@ -7220,35 +7233,22 @@ var ConvertResultSchema = object({
7220
7233
  */
7221
7234
  var RecordingWeekdaySchema = number().int().min(0).max(6);
7222
7235
  var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
7223
- var RecordingScheduleSchema = discriminatedUnion("kind", [object({ kind: literal("always") }), object({
7224
- kind: literal("timeOfDay"),
7225
- start: string().regex(HHMM),
7226
- end: string().regex(HHMM),
7227
- /** Restrict to these weekdays; omit = every day. */
7228
- days: array(RecordingWeekdaySchema).optional()
7229
- })]);
7230
- var RecordingModeSchema = _enum([
7231
- "continuous",
7232
- "onMotion",
7233
- "onAudioThreshold"
7234
- ]);
7235
7236
  /**
7236
- * First-class, authoritative per-camera storage mode — the explicit choice the
7237
- * UI reads directly (never inferred from `rules`):
7238
- * - `off` — not recording.
7239
- * - `events` — record only around triggers (motion / audio threshold),
7240
- * with pre/post-buffer.
7241
- * - `continuous` — record 24/7 within the schedule.
7237
+ * DERIVED per-camera storage summary — the single field cheap consumers read
7238
+ * (the viewer's status dot, the camera list) instead of walking `bands`:
7239
+ * - `off` — no band covers the camera (or it is disabled).
7240
+ * - `events` — every band records around triggers only.
7241
+ * - `continuous` — at least one band records continuously.
7242
7242
  *
7243
- * `mode` compiles one-way to the internal `rules[]` consumed by the policy
7244
- * engine (see `compileRules`); `rules[]` is never authored directly anymore.
7243
+ * NEVER authored: the recorder stamps it from the authoritative `bands` on
7244
+ * every save (`activeModeForConfig`). Writing it has no effect.
7245
7245
  */
7246
7246
  var RecordingStorageModeSchema = _enum([
7247
7247
  "off",
7248
7248
  "events",
7249
7249
  "continuous"
7250
7250
  ]);
7251
- /** Which detectors trigger an `events`-mode recording. */
7251
+ /** Which detectors trigger an `events`-mode band. */
7252
7252
  var RecordingTriggersSchema = object({
7253
7253
  motion: boolean().optional(),
7254
7254
  audioThresholdDbfs: number().optional()
@@ -7284,18 +7284,6 @@ var RecordingBandSchema = object({
7284
7284
  preBufferSec: number().min(0).optional(),
7285
7285
  postBufferSec: number().min(0).optional()
7286
7286
  });
7287
- var RecordingRuleSchema = object({
7288
- schedule: RecordingScheduleSchema,
7289
- mode: RecordingModeSchema,
7290
- /** Seconds of footage to retain BEFORE a trigger (applied at keep/discard). */
7291
- preBufferSec: number().min(0).default(0),
7292
- /** Keep recording until this many seconds after the last trigger. */
7293
- postBufferSec: number().min(0).default(0),
7294
- /** Each new trigger restarts the post-buffer window. */
7295
- resetTimeoutOnNewEvent: boolean().default(true),
7296
- /** onAudioThreshold only — dBFS level that counts as a trigger. */
7297
- thresholdDbfs: number().optional()
7298
- });
7299
7287
  /**
7300
7288
  * Per-device retention overrides. Every field is optional; an unset or `0`
7301
7289
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -7329,40 +7317,28 @@ var ScrubThumbnailPresetSchema = _enum([
7329
7317
  /**
7330
7318
  * The full per-camera recording intent — the wire shape of a RecordingTarget.
7331
7319
  *
7332
- * `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
7333
- * are its mode-specific parameters. `rules` is a DEPRECATED authoring input kept
7334
- * only for transition + migration (`migrateRulesToMode`); the policy engine
7335
- * consumes the compiled output of `compileRules(config)`, never `rules` directly.
7320
+ * `bands` is the ONLY authored recording intent: what to record, when, and on
7321
+ * which trigger. `mode` is a derived summary the recorder stamps on save; every
7322
+ * other field is a storage knob (profiles, segment length, retention, scrub).
7323
+ *
7324
+ * STRICT on purpose: the legacy authoring surface (`schedule`/`schedules`/
7325
+ * `triggers`/`preBufferSec`/`postBufferSec`/`rules`) was retired 2026-07-30.
7326
+ * A stale caller must fail loudly — silently stripping its legacy intent would
7327
+ * persist a band-less config, i.e. silently stop recording the camera.
7336
7328
  */
7337
7329
  var RecordingConfigSchema = object({
7338
7330
  enabled: boolean(),
7339
- /** Authoritative storage mode. Absent on legacy targets derived once via
7340
- * `migrateRulesToMode`, then persisted. */
7331
+ /** DERIVED summary of `bands`, stamped by the recorder on every save.
7332
+ * Authoring it has no effect — see {@link RecordingStorageModeSchema}. */
7341
7333
  mode: RecordingStorageModeSchema.optional(),
7342
7334
  profiles: array(CamProfileSchema).optional(),
7343
7335
  segmentSeconds: number().int().positive().optional(),
7344
- /** Shared recording time-bands for `events` & `continuous` — record only when
7345
- * the wall-clock falls inside one of these windows. Omit or empty = always.
7346
- * `continuous` compiles to one rule per band; `events` to band × trigger. */
7347
- schedules: array(RecordingScheduleSchema).optional(),
7348
- /** Legacy single-band predecessor of `schedules`. Read-compat only — it is
7349
- * normalized into `schedules` on read and never written going forward. (Not
7350
- * tagged `@deprecated`: the normalization paths must read it cast-free.) */
7351
- schedule: RecordingScheduleSchema.optional(),
7352
- /** `events`-mode only — which detectors trigger a recording. */
7353
- triggers: RecordingTriggersSchema.optional(),
7354
- /** `events`-mode only — seconds retained before / after a trigger. */
7355
- preBufferSec: number().min(0).optional(),
7356
- postBufferSec: number().min(0).optional(),
7357
- /** DEPRECATED authoring input; retained for migration/transition. */
7358
- rules: array(RecordingRuleSchema).optional(),
7359
7336
  /**
7360
- * AUTHORITATIVE mode-per-band recording model (recorder). When present it
7361
- * is the single source of truth; the legacy `mode`/`schedules`/`schedule`/
7362
- * `triggers`/`rules` fields above are kept for READ-COMPAT only and are
7363
- * derived into bands once via `migrateConfigToBands`.
7337
+ * AUTHORITATIVE mode-per-band recording model the single source of truth
7338
+ * the recorder's band engine consumes. An empty array = record nothing;
7339
+ * "off" is the absence of a covering band, never a band value.
7364
7340
  */
7365
- bands: array(RecordingBandSchema).optional(),
7341
+ bands: array(RecordingBandSchema).default([]),
7366
7342
  retention: RecordingRetentionSchema.optional(),
7367
7343
  /**
7368
7344
  * Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
@@ -7370,8 +7346,15 @@ var RecordingConfigSchema = object({
7370
7346
  * windows only — existing sheets are immutable, and each window's index
7371
7347
  * carries its own tile dims so mixed-preset history renders correctly.
7372
7348
  */
7373
- scrubThumbnails: ScrubThumbnailPresetSchema.optional()
7374
- });
7349
+ scrubThumbnails: ScrubThumbnailPresetSchema.optional(),
7350
+ /**
7351
+ * OPT-IN thumbnail-strip generation for this camera: every keyframe of the
7352
+ * low recording saved as a JPEG (the fast-drag scrub depth), a derived
7353
+ * cache that eviction reclaims with the footage. Absent/false = no strips
7354
+ * are written and scrub reads exact keyframes at every velocity.
7355
+ */
7356
+ stripsEnabled: boolean().optional()
7357
+ }).strict();
7375
7358
  /**
7376
7359
  * Ops-log — the durable, append-only operations audit shared by the
7377
7360
  * recordings and events management surfaces.
@@ -7390,7 +7373,8 @@ var OpsLogOpSchema = _enum([
7390
7373
  "prune",
7391
7374
  "manual-delete",
7392
7375
  "rescan",
7393
- "retention-run"
7376
+ "retention-run",
7377
+ "relocate"
7394
7378
  ]);
7395
7379
  /** Why the operation ran. */
7396
7380
  var OpsLogReasonSchema = _enum([
@@ -7429,6 +7413,55 @@ var OpsLogQueryInputSchema = object({
7429
7413
  limit: number().int().min(1).max(1e3).optional()
7430
7414
  });
7431
7415
  /**
7416
+ * Entity-relocation job state (storage entity-routing spec, Phase 4).
7417
+ *
7418
+ * One shape shared by the recorder's `relocateFootage` (segments + strips) and
7419
+ * pipeline-analytics' `relocateMedia` (event media blobs) so the admin Data
7420
+ * page renders both movers with one component. Jobs are in-RAM (a restart
7421
+ * forgets them — re-running is safe by construction: copy-if-absent, delete
7422
+ * after verify) and each completed/failed run also lands one durable ops-log
7423
+ * row on the owning addon's surface.
7424
+ */
7425
+ var RelocateJobStateSchema = _enum([
7426
+ "running",
7427
+ "done",
7428
+ "failed",
7429
+ "cancelled"
7430
+ ]);
7431
+ var RelocateJobSchema = object({
7432
+ jobId: string(),
7433
+ state: RelocateJobStateSchema,
7434
+ /** Source location — for media relocation this is informational ('*': rows
7435
+ * move from wherever they are to the target). */
7436
+ fromLocationId: string(),
7437
+ toLocationId: string(),
7438
+ /** Scoped device, or null = every device. */
7439
+ deviceId: number().nullable(),
7440
+ /** What the job moves (owner-addon specific: segments/strips or media). */
7441
+ entities: array(string()),
7442
+ filesMoved: number().int(),
7443
+ bytesMoved: number().int(),
7444
+ /** Total files discovered up front; null while (or when) unknown. */
7445
+ filesTotal: number().int().nullable(),
7446
+ startedAt: number(),
7447
+ finishedAt: number().nullable(),
7448
+ error: string().nullable()
7449
+ });
7450
+ var RelocateFootageInputSchema = object({
7451
+ deviceId: number().optional(),
7452
+ fromLocationId: string(),
7453
+ toLocationId: string(),
7454
+ entities: array(_enum(["segments", "strips"])).optional(),
7455
+ /** Copy throttle in MB/s (default 40) — the drain is a background chore,
7456
+ * never allowed to starve live writers. */
7457
+ throttleMbps: number().min(1).max(1e3).optional()
7458
+ });
7459
+ var RelocateMediaInputSchema = object({
7460
+ deviceId: number().optional(),
7461
+ toLocationId: string(),
7462
+ throttleMbps: number().min(1).max(1e3).optional()
7463
+ });
7464
+ /**
7432
7465
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
7433
7466
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
7434
7467
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -7478,6 +7511,13 @@ var StorageLocationSchema = object({
7478
7511
  nodeId: string().optional(),
7479
7512
  isDefault: boolean().default(false),
7480
7513
  isSystem: boolean().default(false),
7514
+ /** COMPUTED at read time by the orchestrator (statfs of the backing volume
7515
+ * for node-local locations it can reach) — never persisted, absent when the
7516
+ * volume is remote/unreachable. The single capacity truth every UI reads. */
7517
+ capacity: object({
7518
+ totalBytes: number(),
7519
+ availableBytes: number()
7520
+ }).nullable().optional(),
7481
7521
  createdAt: number(),
7482
7522
  updatedAt: number()
7483
7523
  });
@@ -8245,7 +8285,8 @@ var NcTaxonomyEntrySchema = object({
8245
8285
  /** Macro/category parent for grouping ('car' → 'vehicle'); null for a top. */
8246
8286
  parentKind: string().nullable()
8247
8287
  });
8248
- object({
8288
+ /** The complete NC picker taxonomy — three grouped buckets. */
8289
+ var NcTaxonomySchema = object({
8249
8290
  videoClasses: array(NcTaxonomyEntrySchema),
8250
8291
  audioKinds: array(NcTaxonomyEntrySchema),
8251
8292
  labels: array(NcTaxonomyEntrySchema)
@@ -8905,6 +8946,7 @@ var AccessoryKind = {
8905
8946
  };
8906
8947
  AccessoryKind.Siren, AccessoryKind.Floodlight, AccessoryKind.Spotlight, AccessoryKind.PirSensor, AccessoryKind.Chime, AccessoryKind.Autotrack, AccessoryKind.Nightvision, AccessoryKind.PrivacyMask;
8907
8948
  DeviceFeature.BatteryOperated;
8949
+ new Set(["devices", "classes"]);
8908
8950
  /**
8909
8951
  * Shared geometry vocabulary for on-frame shape caps — privacy-mask,
8910
8952
  * motion-zones, and the detection zones/lines editor all speak this one
@@ -9063,6 +9105,29 @@ var NcOccupancyConditionSchema = object({
9063
9105
  count: number().int().min(0).default(1),
9064
9106
  sustainSeconds: number().int().min(0).max(3600).default(15)
9065
9107
  });
9108
+ /**
9109
+ * Which zone-crossing DIRECTION a rule accepts (`ObjectEvent.zoneCrossing`).
9110
+ *
9111
+ * The values are not symmetric, and deliberately so — the absent value has to
9112
+ * mean exactly what every rule authored before this condition existed already
9113
+ * does:
9114
+ * - `enter` — entries and every NON-crossing record (movement state,
9115
+ * package, sensor). Exits are rejected. **This is the absent behaviour**:
9116
+ * an operator who never asked for exits must not start receiving them.
9117
+ * - `exit` — ONLY an exit crossing. A record that is not a crossing at all
9118
+ * fails closed, because "the car left the drive" is a question about a
9119
+ * boundary, not about a detection.
9120
+ * - `any` — no direction filter; entries, exits and non-crossings alike.
9121
+ *
9122
+ * A rule asking for a direction should normally also scope `zones`, which the
9123
+ * engine evaluates against the crossed zone as well as the current membership
9124
+ * (an exit's membership no longer contains the zone it just left).
9125
+ */
9126
+ var NcCrossingSchema = _enum([
9127
+ "enter",
9128
+ "exit",
9129
+ "any"
9130
+ ]);
9066
9131
  /** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
9067
9132
  var NcZoneConditionSchema = object({
9068
9133
  ids: array(string().min(1)).min(1),
@@ -9087,6 +9152,13 @@ var NcConditionsSchema = object({
9087
9152
  /** Veto zones — any hit fails the rule. */
9088
9153
  zonesExclude: array(string().min(1)).optional(),
9089
9154
  /**
9155
+ * Zone-crossing direction. IMMEDIATE only — a crossing is a per-event fact
9156
+ * and a closed track carries none, so a `track-end` rule asking for one
9157
+ * fails closed (use `zones`, which tests `zonesVisited`). ABSENT = `enter`,
9158
+ * which is exactly today's behaviour. See {@link NcCrossingSchema}.
9159
+ */
9160
+ crossing: NcCrossingSchema.optional(),
9161
+ /**
9090
9162
  * Exact (case-insensitive) match on the record's collapsed `label`
9091
9163
  * (identity name / plate text / subclass).
9092
9164
  */
@@ -9221,17 +9293,85 @@ var NcRuleTargetSchema = object({
9221
9293
  * - `keyFrame` — the clean scene frame (no subject box).
9222
9294
  * - `none` — no attachment.
9223
9295
  */
9224
- var NcMediaPolicySchema = object({ attach: _enum([
9225
- "best",
9226
- "best-matching",
9227
- "keyFrame",
9228
- "none"
9229
- ]).default("best") });
9296
+ /**
9297
+ * WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
9298
+ * conflate it with the selection strategy and betray the request: asking for
9299
+ * the clean scene frame on an object-event owner used to start at
9300
+ * `fullFrameBoxed`, i.e. the annotated frame (2026-07-30).
9301
+ * - `cropped` — the subject, tight. What "who is at the door" wants.
9302
+ * - `full` — the clean scene, no annotation. What "what is going on" wants.
9303
+ * - `boxed` — the scene WITH the detection boxes drawn, for verifying what
9304
+ * the pipeline actually saw.
9305
+ */
9306
+ var NcMediaFrameSchema = _enum([
9307
+ "cropped",
9308
+ "full",
9309
+ "boxed"
9310
+ ]);
9311
+ var NcMediaPolicySchema = object({
9312
+ attach: _enum([
9313
+ "best",
9314
+ "best-matching",
9315
+ "keyFrame",
9316
+ "none"
9317
+ ]).default("best"),
9318
+ /** What the still shows. Absent = `cropped` (the historical `best` shape). */
9319
+ frame: NcMediaFrameSchema.optional(),
9320
+ /** Crop the attached still to the rule's condition-zone bbox (padded) —
9321
+ * "show me the ZONE", not the whole scene or the subject crop. */
9322
+ zoneCrop: boolean().optional(),
9323
+ /**
9324
+ * Also attach a short GIF cut from the stream broker's clip ring around the
9325
+ * event — NOT from the recording, so the camera does not have to be
9326
+ * recording, and the window sits AROUND the moment instead of a segment
9327
+ * behind it. Fail-closed: a window the ring does not cover contributes no
9328
+ * gif, never a failed notification.
9329
+ */
9330
+ gif: boolean().optional(),
9331
+ /**
9332
+ * Also attach a short MP4 CLIP of the same cut. Same source and the same
9333
+ * fail-closed rule as `gif`. Prefer it where the backend takes video
9334
+ * (telegram, discord, zentik, webhook); backends that do not are handled by
9335
+ * the degrade engine, which drops the video and keeps the still.
9336
+ */
9337
+ clip: boolean().optional(),
9338
+ /** Seconds of footage BEFORE / AFTER the event instant. Defaults 3 / 7. */
9339
+ clipPreRollSec: number().int().min(0).max(30).optional(),
9340
+ clipPostRollSec: number().int().min(0).max(30).optional(),
9341
+ /**
9342
+ * Which stream profile the footage is cut from. Absent = the CHEAPEST
9343
+ * assigned profile: a notification is watched on a phone, so the 4K
9344
+ * rendition would burn CPU to produce a file the client downscales anyway.
9345
+ * A profile that is not assigned falls back to the cheapest, and the render
9346
+ * reports which one actually ran.
9347
+ */
9348
+ profile: CamProfileSchema.optional()
9349
+ });
9350
+ /**
9351
+ * Cooldown GRANULARITY over the subject's class — how much a fired
9352
+ * notification suppresses.
9353
+ * - `shared` (default, and the absent value) — one window for the whole
9354
+ * rule/scope: a cat silences the next dog for `cooldownSec`.
9355
+ * - `per-class` — an independent window per detected class, so cat→dog fires
9356
+ * at once and cat→cat still waits.
9357
+ *
9358
+ * AUDIO subjects are ALWAYS per-class regardless of this setting: a scream
9359
+ * must not be swallowed by a bark's window (the precedent this generalizes —
9360
+ * see `cooldownKey` in the rule engine).
9361
+ */
9362
+ var NcThrottleGranularitySchema = _enum(["shared", "per-class"]);
9230
9363
  /** Throttle — cooldown survives restarts (rebuilt from the outbox on boot). */
9231
9364
  var NcThrottleSchema = object({
9232
9365
  cooldownSec: number().int().min(0).max(86400).default(60),
9233
9366
  /** `rule` = one shared cooldown; `rule-device` = per-camera cooldown. */
9234
- scope: _enum(["rule", "rule-device"]).default("rule-device")
9367
+ scope: _enum(["rule", "rule-device"]).default("rule-device"),
9368
+ /**
9369
+ * Class granularity of the cooldown key. Optional rather than defaulted:
9370
+ * a Zod default does NOT run on the addon→addon cap path, so a persisted
9371
+ * rule authored before this field simply carries none — and the engine
9372
+ * reads absent as `shared`, the pre-existing behaviour.
9373
+ */
9374
+ granularity: NcThrottleGranularitySchema.optional()
9235
9375
  });
9236
9376
  /** Client-supplied rule fields (server stamps id/createdBy/createdAt/updatedAt). */
9237
9377
  var NcRuleInputSchema = object({
@@ -9240,7 +9380,19 @@ var NcRuleInputSchema = object({
9240
9380
  delivery: NcDeliverySchema,
9241
9381
  conditions: NcConditionsSchema.default({}),
9242
9382
  schedule: NcScheduleSchema.optional(),
9243
- targets: array(NcRuleTargetSchema).min(1),
9383
+ /** May be empty when `targetUsers` addresses at least one user — the
9384
+ * "at least one addressee" invariant is enforced by the provider, because
9385
+ * a cross-field refine here would break `NcRulePatchSchema.partial()`. */
9386
+ targets: array(NcRuleTargetSchema),
9387
+ /**
9388
+ * USERS this rule addresses in addition to `targets` (Phase 4). At fire
9389
+ * time each user fans out to the personal targets they own
9390
+ * (`config.ownerUserId`), filtered by that user's `allowedDevices` for the
9391
+ * firing camera — a user is never notified about a device they cannot open.
9392
+ * Per-user opt-outs (`disabledTargetIds`) still apply to the fanned-out
9393
+ * targets.
9394
+ */
9395
+ targetUsers: array(string()).optional(),
9244
9396
  media: NcMediaPolicySchema.default({ attach: "best" }),
9245
9397
  throttle: NcThrottleSchema.default({
9246
9398
  cooldownSec: 60,
@@ -9327,6 +9479,7 @@ var NcConditionDescriptorSchema = object({
9327
9479
  "schedule",
9328
9480
  "plateMatcher",
9329
9481
  "packagePhase",
9482
+ "crossingSelect",
9330
9483
  "polygonDraw",
9331
9484
  "occupancy"
9332
9485
  ]),
@@ -9453,7 +9606,10 @@ method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), m
9453
9606
  }), object({ results: array(NcTestResultSchema) }), {
9454
9607
  kind: "mutation",
9455
9608
  auth: "admin"
9456
- }), method(object({}), object({ catalog: array(NcConditionDescriptorSchema) })), method(object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), object({ entries: array(NcHistoryEntrySchema) }), { auth: "admin" });
9609
+ }), method(object({}), object({
9610
+ catalog: array(NcConditionDescriptorSchema),
9611
+ taxonomy: NcTaxonomySchema.optional()
9612
+ })), method(object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), object({ entries: array(NcHistoryEntrySchema) }), { auth: "admin" });
9457
9613
  /**
9458
9614
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
9459
9615
  *
@@ -10190,6 +10346,28 @@ method(object({
10190
10346
  }), object({ success: literal(true) }), {
10191
10347
  kind: "mutation",
10192
10348
  auth: "admin"
10349
+ }), method(object({
10350
+ deviceId: number(),
10351
+ /** Absent = the LOWEST assigned profile — a notification attachment is
10352
+ * watched on a phone, and the cheap rendition is the right default. */
10353
+ profile: CamProfileSchema.optional(),
10354
+ aroundMs: number(),
10355
+ preRollSec: number().min(0).max(20).default(3),
10356
+ postRollSec: number().min(0).max(20).default(5),
10357
+ format: _enum(["gif", "mp4"]).default("gif"),
10358
+ maxWidth: number().int().min(120).max(1920).default(480),
10359
+ /** GIF only — MP4 keeps the source cadence. */
10360
+ fps: number().int().min(1).max(15).default(5)
10361
+ }), object({
10362
+ base64: string(),
10363
+ mime: string(),
10364
+ bytes: number().int(),
10365
+ /** The profile actually rendered (what the default resolved to). */
10366
+ profile: CamProfileSchema,
10367
+ durationMs: number()
10368
+ }), {
10369
+ kind: "mutation",
10370
+ auth: "admin"
10193
10371
  }), method(_void(), array(CameraStreamSchema).readonly()), method(_void(), array(ProfileSlotSchema).readonly()), method(object({ brokerId: string() }), BrokerStatsSchema), method(object({ brokerId: string() }), object({
10194
10372
  probed: boolean(),
10195
10373
  summary: string()
@@ -15784,7 +15962,10 @@ method(object({
15784
15962
  }), method(object({
15785
15963
  deviceId: number(),
15786
15964
  caps: array(string()).readonly().optional()
15787
- }), record(string(), unknown().nullable()));
15965
+ }), record(string(), unknown().nullable())), method(object({
15966
+ deviceIds: array(number()).readonly(),
15967
+ caps: array(string()).readonly().optional()
15968
+ }), record(string(), record(string(), unknown().nullable())));
15788
15969
  method(object({ deviceId: number() }), record(string(), record(string(), unknown()))), method(object({
15789
15970
  deviceId: number(),
15790
15971
  capName: string()
@@ -16715,6 +16896,36 @@ var TargetKindSchema = object({
16715
16896
  icon: string(),
16716
16897
  /** Stamped by each provider so the concat-fanned catalog stays routable. */
16717
16898
  addonId: string(),
16899
+ /**
16900
+ * URL of the kind's bundled BRAND icon, served by the providing addon over
16901
+ * its own `addon-routes` surface (`/addon/<addonId>/icons/<kind>`). Absent
16902
+ * when the addon bundles no icon for that kind — the client then falls back
16903
+ * to a neutral glyph rather than rendering the raw `icon` NAME as text.
16904
+ *
16905
+ * Root-relative on purpose: it resolves against whatever origin serves a web
16906
+ * client, and a native client joins it onto its own hub base.
16907
+ *
16908
+ * DECLARED here deliberately. It used to travel as an undeclared passthrough
16909
+ * field that survived only because the runtime cap-router forwards provider
16910
+ * output verbatim — so every consumer had to re-declare it by hand to stop
16911
+ * its own Zod parse from stripping it, and the whole arrangement would have
16912
+ * broken silently the moment output validation was tightened anywhere.
16913
+ */
16914
+ iconUrl: string().optional(),
16915
+ /**
16916
+ * Media type of {@link iconUrl} (`image/svg+xml`, `image/png`, …).
16917
+ *
16918
+ * The server knows this and therefore says it, because the client cannot
16919
+ * safely guess: a React-Native client renders SVG and raster through two
16920
+ * DIFFERENT components (`react-native-svg` vs `expo-image` — expo-image does
16921
+ * not decode SVG on iOS/Android), so without this it silently fell back to a
16922
+ * placeholder glyph for every vector icon while the web build looked fine.
16923
+ *
16924
+ * Absent when {@link iconUrl} is absent, or for a legacy provider that has
16925
+ * not been updated — a client that cannot determine the type should prefer
16926
+ * its raster path, which is the safe default for an unknown image.
16927
+ */
16928
+ iconMediaType: string().optional(),
16718
16929
  configSchema: ConfigSchemaPassthrough,
16719
16930
  supportsDiscovery: boolean(),
16720
16931
  caps: TargetKindCapsSchema
@@ -17162,6 +17373,29 @@ var MotionEventSchema = object({
17162
17373
  * Absent on legacy rows ⇒ treat as `pipeline`.
17163
17374
  */
17164
17375
  var DetectionSourceSchema = _enum(["pipeline", "onboard"]);
17376
+ /**
17377
+ * The confirmed zone crossing that produced an object event. Present ONLY on
17378
+ * an event emitted BY a crossing (`zone.enter` / `zone.exit`); a movement-state
17379
+ * event (`object.entering` / `leaving` / `stationary` / `loitering`) and an
17380
+ * appearance event carry none, so a rule asking for a direction fails closed
17381
+ * on them.
17382
+ *
17383
+ * Exactly ONE crossing per event: the emitter turns each confirmed crossing
17384
+ * into its own event, so a frame in which a track enters A while leaving B
17385
+ * produces two events with two directions — never one ambiguous row.
17386
+ *
17387
+ * `zoneId` is load-bearing for an EXIT: the event's `zones` list is the
17388
+ * membership the box has NOW, and by definition it no longer contains the zone
17389
+ * that was just left. Without the id here, a zone-scoped rule could never match
17390
+ * the exit it asked for.
17391
+ */
17392
+ var ZoneCrossingSchema = object({
17393
+ direction: _enum(["enter", "exit"]),
17394
+ /** Admin zone id crossed. */
17395
+ zoneId: string(),
17396
+ /** Zone display name at crossing time (falls back to the id). */
17397
+ zoneName: string().optional()
17398
+ });
17165
17399
  var ObjectEventSchema = object({
17166
17400
  ...BaseEventFields,
17167
17401
  kind: literal("object"),
@@ -17188,6 +17422,12 @@ var ObjectEventSchema = object({
17188
17422
  zones: array(string()).readonly().optional(),
17189
17423
  /** Omitted in slim projection. */
17190
17424
  state: TrackStateSchema.optional(),
17425
+ /**
17426
+ * The zone crossing this event IS, when it is one. Absent on every other
17427
+ * event kind (movement state, appearance, package) — see
17428
+ * {@link ZoneCrossingSchema}. Omitted in slim projection.
17429
+ */
17430
+ zoneCrossing: ZoneCrossingSchema.optional(),
17191
17431
  /** Detection-frame dimensions in pixels — let consumers normalize the
17192
17432
  * pixel-space `bbox` onto a displayed image. Omitted in slim projection. */
17193
17433
  frameWidth: number().optional(),
@@ -17446,6 +17686,15 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
17446
17686
  }), method(object({ deviceId: number() }), EventPruneCountsSchema, {
17447
17687
  kind: "mutation",
17448
17688
  auth: "admin"
17689
+ }), method(RelocateMediaInputSchema, object({ jobId: string() }), {
17690
+ kind: "mutation",
17691
+ auth: "admin"
17692
+ }), method(object({}), array(RelocateJobSchema).readonly(), {
17693
+ kind: "query",
17694
+ auth: "admin"
17695
+ }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
17696
+ kind: "mutation",
17697
+ auth: "admin"
17449
17698
  }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
17450
17699
  kind: "query",
17451
17700
  auth: "admin"
@@ -19938,6 +20187,17 @@ var GetConnectionEndpointsResultSchema = object({ endpoints: array(object({
19938
20187
  */
19939
20188
  priority: number()
19940
20189
  })).readonly() });
20190
+ /**
20191
+ * The chosen outbound endpoint for notification artifacts. `baseUrl: null` =
20192
+ * AUTO (resolved from the candidate ranking at send time); `resolved` reports
20193
+ * what AUTO currently picks, so the UI can show the effective value either way.
20194
+ */
20195
+ var NotificationEndpointSchema = object({
20196
+ /** The operator's explicit choice, or null for AUTO. */
20197
+ baseUrl: string().nullable(),
20198
+ /** What the ranking currently resolves to (null when nothing is reachable). */
20199
+ resolved: string().nullable()
20200
+ });
19941
20201
  var AllowedAddressesSchema = object({
19942
20202
  /**
19943
20203
  * Allowlist of interface addresses operators have explicitly opted
@@ -19960,7 +20220,7 @@ method(_void(), ListResultSchema), method(_void(), PreferredSchema), method(obje
19960
20220
  * to avoid mixed-content blocks in the browser. The public
19961
20221
  * tunnel always emits `https://` regardless. */
19962
20222
  scheme: _enum(["http", "https"]).optional()
19963
- }), GetConnectionEndpointsResultSchema), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" });
20223
+ }), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" });
19964
20224
  /**
19965
20225
  * mesh-network — collection cap for mesh-VPN providers.
19966
20226
  *
@@ -20759,7 +21019,12 @@ var RecordingDeviceUsageSchema = object({
20759
21019
  var RecordingLocationUsageSchema = object({
20760
21020
  /** StorageLocation id; null for the legacy/degraded single-root fallback. */
20761
21021
  locationId: string().nullable(),
20762
- /** Bytes of recordings stored on this location. */
21022
+ /** Every location id sharing this row's PHYSICAL volume (aliases). One row
21023
+ * is emitted per physical disk (2026-07-29): two locations on one root
21024
+ * previously rendered as two identical "disks" with a nonsensical used
21025
+ * split — hydrate attribution across aliases is arbitrary by nature. */
21026
+ locationIds: array(string()).optional(),
21027
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
20763
21028
  usedBytes: number(),
20764
21029
  /** Free bytes on the location's volume; null when capacity is unknown (remote). */
20765
21030
  availableBytes: number().nullable(),
@@ -20871,6 +21136,44 @@ method(object({
20871
21136
  }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
20872
21137
  kind: "query",
20873
21138
  auth: "admin"
21139
+ }), method(object({
21140
+ deviceId: number(),
21141
+ aroundMs: number(),
21142
+ preRollSec: number().min(0).max(30).default(2),
21143
+ postRollSec: number().min(0).max(30).default(5),
21144
+ maxWidth: number().int().min(120).max(1280).default(480),
21145
+ fps: number().int().min(1).max(15).default(5)
21146
+ }), object({
21147
+ gifBase64: string(),
21148
+ fromMs: number(),
21149
+ toMs: number()
21150
+ }), {
21151
+ kind: "mutation",
21152
+ auth: "admin"
21153
+ }), method(object({
21154
+ deviceId: number(),
21155
+ aroundMs: number(),
21156
+ preRollSec: number().min(0).max(30).default(3),
21157
+ postRollSec: number().min(0).max(30).default(7),
21158
+ maxWidth: number().int().min(160).max(1920).default(640)
21159
+ }), object({
21160
+ clipBase64: string(),
21161
+ mime: string(),
21162
+ fromMs: number(),
21163
+ toMs: number(),
21164
+ bytes: number().int()
21165
+ }), {
21166
+ kind: "mutation",
21167
+ auth: "admin"
21168
+ }), method(RelocateFootageInputSchema, object({ jobId: string() }), {
21169
+ kind: "mutation",
21170
+ auth: "admin"
21171
+ }), method(object({}), array(RelocateJobSchema).readonly(), {
21172
+ kind: "query",
21173
+ auth: "admin"
21174
+ }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
21175
+ kind: "mutation",
21176
+ auth: "admin"
20874
21177
  });
20875
21178
  /**
20876
21179
  * `recordingExport` cap — render a footage time range into a single downloadable
@@ -22462,6 +22765,12 @@ Object.freeze({
22462
22765
  addonId: null,
22463
22766
  access: "view"
22464
22767
  },
22768
+ "deviceManager.getDeviceStatusAggregateBatch": {
22769
+ capName: "device-manager",
22770
+ capScope: "system",
22771
+ addonId: null,
22772
+ access: "view"
22773
+ },
22465
22774
  "deviceManager.getLinkedDevices": {
22466
22775
  capName: "device-manager",
22467
22776
  capScope: "system",
@@ -23356,6 +23665,12 @@ Object.freeze({
23356
23665
  addonId: null,
23357
23666
  access: "view"
23358
23667
  },
23668
+ "localNetwork.getNotificationEndpoint": {
23669
+ capName: "local-network",
23670
+ capScope: "system",
23671
+ addonId: null,
23672
+ access: "view"
23673
+ },
23359
23674
  "localNetwork.getPreferred": {
23360
23675
  capName: "local-network",
23361
23676
  capScope: "system",
@@ -23380,6 +23695,12 @@ Object.freeze({
23380
23695
  addonId: null,
23381
23696
  access: "create"
23382
23697
  },
23698
+ "localNetwork.setNotificationEndpoint": {
23699
+ capName: "local-network",
23700
+ capScope: "system",
23701
+ addonId: null,
23702
+ access: "create"
23703
+ },
23383
23704
  "lockControl.lock": {
23384
23705
  capName: "lock-control",
23385
23706
  capScope: "device",
@@ -24022,6 +24343,12 @@ Object.freeze({
24022
24343
  addonId: null,
24023
24344
  access: "create"
24024
24345
  },
24346
+ "pipelineAnalytics.cancelMediaRelocate": {
24347
+ capName: "pipeline-analytics",
24348
+ capScope: "device",
24349
+ addonId: null,
24350
+ access: "create"
24351
+ },
24025
24352
  "pipelineAnalytics.clearTracks": {
24026
24353
  capName: "pipeline-analytics",
24027
24354
  capScope: "device",
@@ -24076,6 +24403,12 @@ Object.freeze({
24076
24403
  addonId: null,
24077
24404
  access: "view"
24078
24405
  },
24406
+ "pipelineAnalytics.getMediaRelocateStatus": {
24407
+ capName: "pipeline-analytics",
24408
+ capScope: "device",
24409
+ addonId: null,
24410
+ access: "view"
24411
+ },
24079
24412
  "pipelineAnalytics.getMotionEvents": {
24080
24413
  capName: "pipeline-analytics",
24081
24414
  capScope: "device",
@@ -24148,6 +24481,12 @@ Object.freeze({
24148
24481
  addonId: null,
24149
24482
  access: "create"
24150
24483
  },
24484
+ "pipelineAnalytics.relocateMedia": {
24485
+ capName: "pipeline-analytics",
24486
+ capScope: "device",
24487
+ addonId: null,
24488
+ access: "create"
24489
+ },
24151
24490
  "pipelineAnalytics.searchObjectEvents": {
24152
24491
  capName: "pipeline-analytics",
24153
24492
  capScope: "device",
@@ -24910,6 +25249,12 @@ Object.freeze({
24910
25249
  addonId: null,
24911
25250
  access: "create"
24912
25251
  },
25252
+ "recording.cancelRelocate": {
25253
+ capName: "recording",
25254
+ capScope: "system",
25255
+ addonId: null,
25256
+ access: "create"
25257
+ },
24913
25258
  "recording.deleteFootprint": {
24914
25259
  capName: "recording",
24915
25260
  capScope: "system",
@@ -24940,6 +25285,12 @@ Object.freeze({
24940
25285
  addonId: null,
24941
25286
  access: "view"
24942
25287
  },
25288
+ "recording.getRelocateStatus": {
25289
+ capName: "recording",
25290
+ capScope: "system",
25291
+ addonId: null,
25292
+ access: "view"
25293
+ },
24943
25294
  "recording.getStorageUsage": {
24944
25295
  capName: "recording",
24945
25296
  capScope: "system",
@@ -24970,6 +25321,24 @@ Object.freeze({
24970
25321
  addonId: null,
24971
25322
  access: "view"
24972
25323
  },
25324
+ "recording.relocateFootage": {
25325
+ capName: "recording",
25326
+ capScope: "system",
25327
+ addonId: null,
25328
+ access: "create"
25329
+ },
25330
+ "recording.renderClip": {
25331
+ capName: "recording",
25332
+ capScope: "system",
25333
+ addonId: null,
25334
+ access: "create"
25335
+ },
25336
+ "recording.renderGif": {
25337
+ capName: "recording",
25338
+ capScope: "system",
25339
+ addonId: null,
25340
+ access: "create"
25341
+ },
24973
25342
  "recording.rescanStorage": {
24974
25343
  capName: "recording",
24975
25344
  capScope: "system",
@@ -25564,6 +25933,12 @@ Object.freeze({
25564
25933
  addonId: null,
25565
25934
  access: "create"
25566
25935
  },
25936
+ "streamBroker.renderPreBufferClip": {
25937
+ capName: "stream-broker",
25938
+ capScope: "system",
25939
+ addonId: null,
25940
+ access: "create"
25941
+ },
25567
25942
  "streamBroker.restartProfile": {
25568
25943
  capName: "stream-broker",
25569
25944
  capScope: "system",