@camstack/system 1.2.267 → 1.2.269

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BbPssgI6.js");
+const require_dist = require("../../dist-BTpfLiUX.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { P as addonPagesCapability, Pn as EventCategory, an as errMsg, sn as BaseAddon } from "../../dist-Ck0rjYOQ.mjs";
+import { P as addonPagesCapability, Pn as EventCategory, an as errMsg, sn as BaseAddon } from "../../dist-CqmImT7i.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BbPssgI6.js");
+const require_dist = require("../../dist-BTpfLiUX.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { I as addonWidgetsCapability, Pn as EventCategory, an as errMsg, sn as BaseAddon } from "../../dist-Ck0rjYOQ.mjs";
+import { I as addonWidgetsCapability, Pn as EventCategory, an as errMsg, sn as BaseAddon } from "../../dist-CqmImT7i.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BbPssgI6.js");
+const require_dist = require("../../dist-BTpfLiUX.js");
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,4 +1,4 @@
-import { L as alertsCapability, Pn as EventCategory, an as errMsg, bn as createEvent, n as AlertSchema, sn as BaseAddon } from "../../dist-Ck0rjYOQ.mjs";
+import { L as alertsCapability, Pn as EventCategory, an as errMsg, bn as createEvent, n as AlertSchema, sn as BaseAddon } from "../../dist-CqmImT7i.mjs";
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/autotrack/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BbPssgI6.js");
+const require_dist = require("../../dist-BTpfLiUX.js");
 //#region src/builtins/autotrack/autotrack-config.ts
 var DEFAULT_AUTOTRACK_LOOP_CONFIG = {
 	deadZoneFraction: .5,

package/dist/builtins/autotrack/index.mjs

@@ -1,4 +1,4 @@
-import { B as bareAddonId, En as isEvent, It as ptzAutotrackCapability, Pn as EventCategory, an as errMsg, h as FIRST_LEVEL_MACRO_CLASSES, sn as BaseAddon } from "../../dist-Ck0rjYOQ.mjs";
+import { B as bareAddonId, En as isEvent, It as ptzAutotrackCapability, Pn as EventCategory, an as errMsg, h as FIRST_LEVEL_MACRO_CLASSES, sn as BaseAddon } from "../../dist-CqmImT7i.mjs";
 //#region src/builtins/autotrack/autotrack-config.ts
 var DEFAULT_AUTOTRACK_LOOP_CONFIG = {
 	deadZoneFraction: .5,

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BbPssgI6.js");
+const require_dist = require("../../dist-BTpfLiUX.js");
 let node_crypto = require("node:crypto");
 let buffer = require("buffer");
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Dt as mayWriteToLocation, Pn as EventCategory, Zt as storageOccupancyCapability, sn as BaseAddon, z as backupCapability } from "../../dist-Ck0rjYOQ.mjs";
+import { Dt as mayWriteToLocation, Pn as EventCategory, Zt as storageOccupancyCapability, sn as BaseAddon, z as backupCapability } from "../../dist-CqmImT7i.mjs";
 import { randomBytes, randomUUID } from "node:crypto";
 import { Buffer as Buffer$1 } from "buffer";
 import * as fsp from "node:fs/promises";

package/dist/builtins/camera-grid/addon.d.ts

@@ -22,7 +22,7 @@ export declare class CameraGridAddon extends BaseAddon<CameraGridAddonConfig> {
      * (D224), and 60 s is the window for a fact — "does 615 have a low assigned"
      * — that only changes when an operator changes it.
      */
-    private readonly planByInstanceId;
+    private readonly plansByInstanceId;
     private activity;
     private snapshots;
     private frameSampler;
@@ -87,12 +87,23 @@ export declare class CameraGridAddon extends BaseAddon<CameraGridAddonConfig> {
      * line a minute for ever.
      */
     private logSourcePlan;
+    private plansFor;
     private planFor;
+    /**
+     * The canvas of the BEST profile this grid offers.
+     *
+     * Used where a single geometry is needed for something that is not a
+     * composition — the detection boxes a grid forwards (`grid-activity`), which
+     * are normalized against whatever picture the viewer is looking at. The best
+     * offered one is the honest default; a grid offering nothing has no geometry
+     * and says so.
+     */
+    private canvasFor;
     private ensureSessions;
     private makeSession;
     /** The session a dial is asking for, or `null` - which the relay answers 404 to. */
     private sessionFor;
-    /** This grid's composition, as the list the snapshot source expects. */
+    /** This grid's sessions, in DESCENDING quality — the snapshot takes the first running one. */
     private sessionsForDevice;
     /** A grid that is gone stops immediately - it must not keep N sources dialled. */
     private retireWithdrawnSessions;

package/dist/builtins/camera-grid/grid-canvas-derivation.d.ts

@@ -0,0 +1,19 @@
+import { PixelSize } from './grid-canvas.js';
+import { NormalizedRect } from './grid-filter-graph.js';
+export interface GridCanvasCell {
+    /** The part of the source this cell shows, normalized against the SOURCE. */
+    readonly source: NormalizedRect;
+    /** Where it lands, normalized against the CANVAS. */
+    readonly cell: NormalizedRect;
+    /** The source's size AT THE PROFILE being derived for. */
+    readonly sourceSize: PixelSize;
+}
+/**
+ * The canvas these cells imply, or `null` when they imply none.
+ *
+ * `null` for a grid with no cells — the normal freshly-created state — and for
+ * a layout whose every rectangle is degenerate. Both are "there is no picture
+ * to size", which the caller turns into "this profile is not on offer" rather
+ * than into a guess.
+ */
+export declare function deriveGridCanvas(cells: readonly GridCanvasCell[]): PixelSize | null;

package/dist/builtins/camera-grid/grid-compositor.d.ts

@@ -31,6 +31,14 @@ export declare class GridCompositor {
      * flicker. The canvas is never cleared between ticks for the same reason.
      */
     tick(): boolean;
+    /**
+     * A tile's decoder was replaced: drop its half frame, keep its picture.
+     *
+     * Without this the new decoder's bytes would be appended to the old one's
+     * partial frame and every frame after would be sheared — raw video has no
+     * framing to re-sync on.
+     */
+    resetTile(tileId: string): void;
     /** After this, a tick emits nothing — a dead child must not keep writing. */
     close(): void;
 }

package/dist/builtins/camera-grid/grid-instances.d.ts

@@ -25,9 +25,12 @@ declare const GridInstanceSchema: z.ZodObject<{
     cameraStableId: z.ZodString;
     name: z.ZodString;
     enabled: z.ZodBoolean;
-    width: z.ZodNumber;
-    height: z.ZodNumber;
     fps: z.ZodNumber;
+    publishedProfiles: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        high: "high";
+        mid: "mid";
+        low: "low";
+    }>>>;
     cells: z.ZodDefault<z.ZodArray<z.ZodObject<{
         deviceId: z.ZodNumber;
         source: z.ZodObject<{

package/dist/builtins/camera-grid/grid-plan.d.ts

@@ -5,15 +5,17 @@ export interface GridPlanEncodeContext {
     readonly encoder: FfmpegVideoEncoderId;
     readonly decodeHwAccel: string | null;
     /**
-     * The canvas to compose onto, when it is not the one the operator laid out.
+     * The canvas to compose onto. REQUIRED, and never authored: each profile
+     * derives its own from the cells and its sources' size
+     * (`grid-canvas-derivation.ts`). It used to fall back to two numbers the
+     * operator typed into the editor, and that field is gone — it silently
+     * decided both what the composite cost and how sharp it was.
      *
-     * A grid publishes one composition per profile, and `mid`/`low` compose onto
-     * a SCALED copy of the operator's canvas (`grid-profiles.ts` owns the
-     * scale). The geometry needs no second version of itself: every rectangle is
+     * The geometry needs no second version of itself: every rectangle is
      * normalized on both sides (D519), so the same fractions land correctly on a
-     * smaller picture. Absent ⇒ the operator's own canvas, which is `high`.
+     * canvas of any size.
      */
-    readonly canvas?: {
+    readonly canvas: {
         readonly width: number;
         readonly height: number;
     };

package/dist/builtins/camera-grid/grid-profiles.d.ts

@@ -1,61 +1,64 @@
 import { CamProfile } from '@camstack/types';
+import { PixelSize } from './grid-canvas.js';
 import { NormalizedRect } from './grid-filter-graph.js';
 /**
- * One id, for every grid, forever.
+ * One id per profile, for every grid, forever.
  *
- * D519's reason is what keeps this id bare: a per-instance or newly-spelled id
- * mints a second cam-stream and orphans whatever profile assignment the
- * operator had made. It was `high` on the live hub before the per-profile
- * detour and it is `high` again, so nothing an operator assigned is disturbed.
+ * D519's reason is what keeps `high`'s id bare: a newly-spelled id mints a
+ * second cam-stream and orphans whatever profile assignment the operator had
+ * made. `grid` was `high` on the live hub before any of this and still is.
  */
 export declare const GRID_CAM_STREAM_ID = "grid";
-/**
- * The slot the single composition claims.
- *
- * NOT decoration. A device publishing one stream with no hint is ranked by
- * pixel count and lands in `mid` — the slot `recordings` does not select on its
- * own, that `recordingsLow` ignores, and that scrub never reads. The Dreame
- * robot's single 720p relay landed exactly there and its footage was written
- * where nothing looked.
- */
-export declare const GRID_OUTPUT_PROFILE: CamProfile;
-/** The cheapest stream this source serves, or `null` when it serves none. */
-export declare function lowestServedProfile(served: readonly CamProfile[]): CamProfile | null;
-/** One stream a camera serves, with the size that decides whether it fits. */
+/** Every profile a grid can compose, in descending quality. */
+export declare const GRID_PROFILES: readonly CamProfile[];
+/** The cam-stream id a grid publishes for one profile. */
+export declare function gridCamStreamId(profile: CamProfile): string;
+/** One stream a camera serves, with the size the canvas is derived from. */
 export interface ServedProfile {
     readonly profile: CamProfile;
-    /** `0` means the broker stated no size — see `gridSourceProfiles`. */
     readonly width: number;
     readonly height: number;
 }
-/** One cell, as the two rectangles that decide what its source must carry. */
+/** One cell: which part of which source, and where it lands. */
 export interface GridSourceCell {
     readonly deviceId: number;
-    /** The part of the source it shows, normalized against the SOURCE. */
     readonly source: NormalizedRect;
-    /** Where it lands, normalized against the CANVAS. */
     readonly cell: NormalizedRect;
 }
-export interface GridSourceProfilesInput {
-    readonly canvas: {
-        readonly width: number;
-        readonly height: number;
-    };
+export interface GridProfilePlansInput {
     readonly cells: readonly GridSourceCell[];
     /**
-     * Which streams this source can serve, or `null` when nobody could say.
-     * `null` is not an empty list: an unanswerable question is a refusal, and
-     * saying so separately keeps "we did not ask" out of the catalog.
+     * Which profiles the operator wants published. A profile that is not in here
+     * is still SIZED and reported — the editor shows what it would come out as,
+     * so turning it on is a decision made with the number in view — but it is not
+     * offered to the broker.
+     */
+    readonly publishedProfiles: readonly CamProfile[];
+    /**
+     * Which streams this source serves, or `null` when nobody could say. `null`
+     * is not an empty list: an unanswerable question is a refusal, and saying so
+     * separately keeps "we did not ask" out of the catalog.
      */
     readonly profilesServedBy: (deviceId: number) => readonly ServedProfile[] | null;
 }
-export interface GridSourcePlan {
-    /** True when every source can be read — the only case a grid is on offer. */
-    readonly offered: boolean;
-    /** Which stream each source is read at. Only contains readable sources. */
-    readonly profileBySource: ReadonlyMap<number, CamProfile>;
-    /** The sources that serve nothing, or that nobody could answer for. */
+export type GridProfilePlan = {
+    readonly profile: CamProfile;
+    readonly offered: true;
+    readonly canvas: PixelSize;
+    /** False ⇒ serviceable, sized, and deliberately not published. */
+    readonly published: boolean;
+} | {
+    readonly profile: CamProfile;
+    readonly offered: false;
+    /** The sources that cannot serve it. Empty only when there are none at all. */
     readonly missingSources: readonly number[];
-}
-/** Which stream to read each source at, and who cannot be read at all. */
-export declare function gridSourceProfiles(input: GridSourceProfilesInput): GridSourcePlan;
+};
+/**
+ * What this grid can honestly publish, per profile, with the canvas or the
+ * refusal.
+ *
+ * Every profile gets a row whether it is offered or not: an absent row says
+ * nothing, and the caller logging a refusal needs the reason more than the
+ * caller publishing an offer needs the offer.
+ */
+export declare function gridProfilePlans(input: GridProfilePlansInput): readonly GridProfilePlan[];

package/dist/builtins/camera-grid/grid-stream-descriptor.d.ts

@@ -1,5 +1,8 @@
-import { CamStreamDescriptor } from '@camstack/types';
+import { CamProfile, CamStreamDescriptor } from '@camstack/types';
 export interface GridStreamDescriptorInput {
+    /** Which composition this is. Also the `profileHint` — see below. */
+    readonly profile: CamProfile;
+    /** The DERIVED canvas of that profile, never an authored number. */
     readonly width: number;
     readonly height: number;
     readonly fps: number;
@@ -15,8 +18,8 @@ export interface GridStreamDescriptorInput {
  * scrub never reads. The Dreame robot's one 720p relay landed exactly there and
  * its footage was written nowhere anything looked.
  *
- * So the single composition claims `high` EXPLICITLY (`GRID_OUTPUT_PROFILE`).
- * It is also the slot this stream held before the per-profile detour, which is
- * what keeps an operator's existing assignment intact.
+ * With several compositions published the hint does a second job: it says which
+ * slot each one is FOR. Ranked by pixels a grid's `mid` would take the `high`
+ * slot on any grid whose `high` was not offered.
  */
 export declare function gridStreamDescriptor(input: GridStreamDescriptorInput): CamStreamDescriptor;

package/dist/builtins/camera-grid/grid-stream-relay.d.ts

@@ -1,17 +1,20 @@
+import { CamProfile } from '@camstack/types';
 import { GridStreamLogger, GridStreamSession } from './grid-stream-session.js';
 /**
- * Which grid. There is one composition of it, so that is the whole address.
+ * Which grid, and WHICH COMPOSITION of it.
  *
- * The path used to carry a profile segment, because a grid published one
- * composition per profile and a dial naming none would have been the broker
- * asking for "whichever". With a single output "whichever" is well defined,
- * and the segment would be a choice with one option — which is not a choice,
- * it is a way to spell one stream two ways.
+ * The profile is a path segment and not a query string for the reason the
+ * restream suffixes are (`restream-intent.ts`): the choice belongs to the URL
+ * the consumer was handed, so a broker configured once keeps asking for the
+ * same thing. It is REQUIRED — a dial naming none would be the broker asking
+ * for "whichever", which is how a `low` slot ends up holding a `high`
+ * composition.
  */
 export interface GridStreamRequest {
     readonly instanceId: string;
+    readonly profile: CamProfile;
 }
-/** `/grid/<instanceId>.flv`, or `null` when it is anything else. */
+/** `/grid/<instanceId>/<profile>.flv`, or `null` when it is anything else. */
 export declare function parseGridStreamPath(url: string | undefined): GridStreamRequest | null;
 export interface GridStreamRelayDeps {
     readonly logger: GridStreamLogger;

package/dist/builtins/camera-grid/grid-tile-feed.d.ts

@@ -33,6 +33,18 @@ export declare class GridTileFeed {
     latest(): Buffer | null;
     /** Has a new frame arrived since the last {@link latest}? */
     hasFresh(): boolean;
+    /**
+     * Forget the half frame, keep the picture.
+     *
+     * Raw video has no framing: the feed cuts on a fixed length, so bytes from a
+     * NEW decoder concatenated onto a partial frame from the old one would be
+     * misaligned for ever — every frame after it sheared, with nothing to
+     * re-sync on. Called whenever a tile's decoder is replaced.
+     *
+     * The newest frame is kept deliberately: the cell holds its last picture
+     * while its decoder comes back, instead of blinking to black.
+     */
+    resetPartial(): void;
     /** For the bound in the spec: one frame plus at most a partial one. */
     bufferedBytes(): number;
 }

package/dist/builtins/camera-grid/index.d.ts

@@ -22,8 +22,9 @@ export type { GridPlanEncodeContext } from './grid-plan.js';
 export { normalizeGridRows } from './grid-row-normalization.js';
 export type { NormalizedGridRows } from './grid-row-normalization.js';
 export { gridStreamDescriptor } from './grid-stream-descriptor.js';
-export { GRID_CAM_STREAM_ID, GRID_OUTPUT_PROFILE, gridSourceProfiles, lowestServedProfile, } from './grid-profiles.js';
-export type { GridSourcePlan } from './grid-profiles.js';
+export { GRID_CAM_STREAM_ID, GRID_PROFILES, gridCamStreamId, gridProfilePlans, } from './grid-profiles.js';
+export type { GridProfilePlan, ServedProfile } from './grid-profiles.js';
+export { deriveGridCanvas } from './grid-canvas-derivation.js';
 export { gridSourceDial } from './grid-sentry-sources.js';
 export type { GridSourceAcquisition, GridSourceDial } from './grid-sentry-sources.js';
 export { GridSnapshotSource, gridSnapshotAnswerFor } from './grid-snapshot.js';