@camstack/types 1.2.221 → 1.2.223

package/dist/capabilities/camera-grid-layout.cap.d.ts

@@ -89,13 +89,13 @@ declare const GridProfileOfferSchema: z.ZodObject<{
     }>;
     offered: z.ZodBoolean;
     missingSources: z.ZodArray<z.ZodNumber>;
+    canvas: z.ZodString;
+    published: z.ZodBoolean;
 }, z.core.$strip>;
 export declare const GridLayoutViewSchema: z.ZodObject<{
     instanceId: z.ZodString;
     deviceId: z.ZodNumber;
     name: z.ZodString;
-    width: z.ZodNumber;
-    height: z.ZodNumber;
     fps: z.ZodNumber;
     cells: z.ZodArray<z.ZodObject<{
         deviceId: z.ZodNumber;
@@ -120,6 +120,8 @@ export declare const GridLayoutViewSchema: z.ZodObject<{
         }>;
         offered: z.ZodBoolean;
         missingSources: z.ZodArray<z.ZodNumber>;
+        canvas: z.ZodString;
+        published: z.ZodBoolean;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GridNormalizedRect = z.infer<typeof GridNormalizedRectSchema>;
@@ -129,9 +131,12 @@ export type GridLayoutView = z.infer<typeof GridLayoutViewSchema>;
 export declare const GridLayoutPatchSchema: z.ZodObject<{
     deviceId: z.ZodNumber;
     name: z.ZodOptional<z.ZodString>;
-    width: z.ZodOptional<z.ZodNumber>;
-    height: z.ZodOptional<z.ZodNumber>;
     fps: z.ZodOptional<z.ZodNumber>;
+    publishedProfiles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        high: "high";
+        mid: "mid";
+        low: "low";
+    }>>>;
     cells: z.ZodArray<z.ZodObject<{
         deviceId: z.ZodNumber;
         source: z.ZodObject<{
@@ -187,8 +192,6 @@ export declare const cameraGridLayoutCapability: {
             instanceId: z.ZodString;
             deviceId: z.ZodNumber;
             name: z.ZodString;
-            width: z.ZodNumber;
-            height: z.ZodNumber;
             fps: z.ZodNumber;
             cells: z.ZodArray<z.ZodObject<{
                 deviceId: z.ZodNumber;
@@ -213,15 +216,20 @@ export declare const cameraGridLayoutCapability: {
                 }>;
                 offered: z.ZodBoolean;
                 missingSources: z.ZodArray<z.ZodNumber>;
+                canvas: z.ZodString;
+                published: z.ZodBoolean;
             }, z.core.$strip>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Write the geometry back. Returns the grid as it now stands, profiles included. */
         readonly saveLayout: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
             name: z.ZodOptional<z.ZodString>;
-            width: z.ZodOptional<z.ZodNumber>;
-            height: z.ZodOptional<z.ZodNumber>;
             fps: z.ZodOptional<z.ZodNumber>;
+            publishedProfiles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>>;
             cells: z.ZodArray<z.ZodObject<{
                 deviceId: z.ZodNumber;
                 source: z.ZodObject<{
@@ -241,8 +249,6 @@ export declare const cameraGridLayoutCapability: {
             instanceId: z.ZodString;
             deviceId: z.ZodNumber;
             name: z.ZodString;
-            width: z.ZodNumber;
-            height: z.ZodNumber;
             fps: z.ZodNumber;
             cells: z.ZodArray<z.ZodObject<{
                 deviceId: z.ZodNumber;
@@ -267,6 +273,8 @@ export declare const cameraGridLayoutCapability: {
                 }>;
                 offered: z.ZodBoolean;
                 missingSources: z.ZodArray<z.ZodNumber>;
+                canvas: z.ZodString;
+                published: z.ZodBoolean;
             }, z.core.$strip>>;
         }, z.core.$strip>, "mutation">;
     };

package/dist/ffmpeg/process.d.ts

@@ -81,6 +81,18 @@ export interface FfmpegProcessOptions {
      * it is bounded by {@link maxRestarts} regardless of what this returns.
      */
     readonly onExit?: (exit: FfmpegExit) => void;
+    /**
+     * Called ONCE, when the wrapper stops restarting and the child is gone for
+     * good.
+     *
+     * `onExit` cannot answer this: it fires on every exit, including the ones
+     * that are about to be respawned, so a caller using it to tear down would
+     * tear down on the first hiccup. And the `start()` promise cannot answer it
+     * either — its `reject` is spent the moment the child first goes live, so a
+     * give-up AFTER that reached nobody at all. A camera-grid tile that died an
+     * hour in was indistinguishable, to its owner, from one that never started.
+     */
+    readonly onGiveUp?: (error: Error) => void;
     /** Wall-clock budget for the first output byte. `0` disables the deadline. */
     readonly firstDataTimeoutMs?: number;
     /** `0` ⇒ never restart (a run-to-completion job). */

package/dist/index.js

@@ -32551,16 +32551,37 @@ var GridProfileOfferSchema = zod.z.object({
 	]),
 	offered: zod.z.boolean(),
 	/** Sources that cannot serve it. Empty when it is offered, or when there are no cells. */
-	missingSources: zod.z.array(zod.z.number().int().positive())
+	missingSources: zod.z.array(zod.z.number().int().positive()),
+	/**
+	* The canvas this profile composes onto, `WxH`, or empty when it is not
+	* offered. DERIVED from the cells and the sources' own size at this profile —
+	* it is reported because nothing else in the system would ever say what the
+	* grid came out as, and because it is the number an operator would otherwise
+	* expect to type.
+	*/
+	canvas: zod.z.string(),
+	/**
+	* Whether this profile is PUBLISHED, of the ones the grid could serve.
+	*
+	* A grid's `high` is composed of its sources' `high`, so on a 4K fleet it is
+	* a 4K canvas built from 4K decodes — something to opt into, not something a
+	* viewer's adaptive should be handed by climbing to the top rung it can see.
+	* Default is `mid` + `low`.
+	*/
+	published: zod.z.boolean()
 });
 var GridLayoutViewSchema = zod.z.object({
 	/** The persisted grid row this camera was declared from. */
 	instanceId: zod.z.string(),
 	deviceId: zod.z.number().int().nonnegative(),
 	name: zod.z.string(),
-	/** The canvas the operator laid out — this grid's `high`. mid/low are scaled from it. */
-	width: zod.z.number().int(),
-	height: zod.z.number().int(),
+	/**
+	* NO canvas size. A grid's resolution is not authored: each profile derives
+	* its own from the cells and its sources' dimensions. The two numbers that
+	* used to be here were a text field that silently decided both how much the
+	* composite cost and how sharp it was — see `profiles[].canvas` for what it
+	* came out as.
+	*/
 	fps: zod.z.number().int(),
 	cells: zod.z.array(GridLayoutCellSchema),
 	/** What the catalog will publish, and what it refuses to. Read-only. */
@@ -32569,9 +32590,13 @@ var GridLayoutViewSchema = zod.z.object({
 var GridLayoutPatchSchema = zod.z.object({
 	deviceId: zod.z.number().int().nonnegative(),
 	name: zod.z.string().min(1).max(160).optional(),
-	width: zod.z.number().int().min(160).max(7680).optional(),
-	height: zod.z.number().int().min(120).max(4320).optional(),
 	fps: zod.z.number().int().min(1).max(60).optional(),
+	/** Which profiles to publish. See `GridProfileOffer.published`. */
+	publishedProfiles: zod.z.array(zod.z.enum([
+		"high",
+		"mid",
+		"low"
+	])).max(3).optional(),
 	/**
 	* The whole cell list at once. A per-cell patch would need an ordering the
 	* editor does not have, and a half-applied layout is a picture nobody asked

package/dist/index.mjs

@@ -32550,16 +32550,37 @@ var GridProfileOfferSchema = z.object({
 	]),
 	offered: z.boolean(),
 	/** Sources that cannot serve it. Empty when it is offered, or when there are no cells. */
-	missingSources: z.array(z.number().int().positive())
+	missingSources: z.array(z.number().int().positive()),
+	/**
+	* The canvas this profile composes onto, `WxH`, or empty when it is not
+	* offered. DERIVED from the cells and the sources' own size at this profile —
+	* it is reported because nothing else in the system would ever say what the
+	* grid came out as, and because it is the number an operator would otherwise
+	* expect to type.
+	*/
+	canvas: z.string(),
+	/**
+	* Whether this profile is PUBLISHED, of the ones the grid could serve.
+	*
+	* A grid's `high` is composed of its sources' `high`, so on a 4K fleet it is
+	* a 4K canvas built from 4K decodes — something to opt into, not something a
+	* viewer's adaptive should be handed by climbing to the top rung it can see.
+	* Default is `mid` + `low`.
+	*/
+	published: z.boolean()
 });
 var GridLayoutViewSchema = z.object({
 	/** The persisted grid row this camera was declared from. */
 	instanceId: z.string(),
 	deviceId: z.number().int().nonnegative(),
 	name: z.string(),
-	/** The canvas the operator laid out — this grid's `high`. mid/low are scaled from it. */
-	width: z.number().int(),
-	height: z.number().int(),
+	/**
+	* NO canvas size. A grid's resolution is not authored: each profile derives
+	* its own from the cells and its sources' dimensions. The two numbers that
+	* used to be here were a text field that silently decided both how much the
+	* composite cost and how sharp it was — see `profiles[].canvas` for what it
+	* came out as.
+	*/
 	fps: z.number().int(),
 	cells: z.array(GridLayoutCellSchema),
 	/** What the catalog will publish, and what it refuses to. Read-only. */
@@ -32568,9 +32589,13 @@ var GridLayoutViewSchema = z.object({
 var GridLayoutPatchSchema = z.object({
 	deviceId: z.number().int().nonnegative(),
 	name: z.string().min(1).max(160).optional(),
-	width: z.number().int().min(160).max(7680).optional(),
-	height: z.number().int().min(120).max(4320).optional(),
 	fps: z.number().int().min(1).max(60).optional(),
+	/** Which profiles to publish. See `GridProfileOffer.published`. */
+	publishedProfiles: z.array(z.enum([
+		"high",
+		"mid",
+		"low"
+	])).max(3).optional(),
 	/**
 	* The whole cell list at once. A per-cell patch would need an ordering the
 	* editor does not have, and a half-applied layout is a picture nobody asked

package/dist/node.js

@@ -1158,7 +1158,9 @@ var FfmpegProcess = class {
 				tags: this.logTags,
 				meta: { stderrTail: this.stderrTail }
 			});
-			onDead(new Error(reason));
+			const error = new Error(reason);
+			onDead(error);
+			this.opts.onGiveUp?.(error);
 			return;
 		}
 		this.scheduleRestart(onLive, onDead);
@@ -1166,7 +1168,10 @@ var FfmpegProcess = class {
 	scheduleRestart(onLive, onDead) {
 		if (this.stopped) return;
 		const maxRestarts = this.opts.maxRestarts ?? 0;
-		if (maxRestarts === 0) return;
+		if (maxRestarts === 0) {
+			this.opts.onGiveUp?.(/* @__PURE__ */ new Error(`ffmpeg ${this.opts.role} ended and restarts are disabled`));
+			return;
+		}
 		if (this.producedOutput && this.now - this.startedAtMs >= (this.opts.stableRunMs ?? DEFAULT_STABLE_RUN_MS)) this.consecutiveFailures = 0;
 		if (this.consecutiveFailures > maxRestarts) return;
 		(this.opts.setTimeoutFn ?? setTimeout)(() => {

package/dist/node.mjs

@@ -1135,7 +1135,9 @@ var FfmpegProcess = class {
 				tags: this.logTags,
 				meta: { stderrTail: this.stderrTail }
 			});
-			onDead(new Error(reason));
+			const error = new Error(reason);
+			onDead(error);
+			this.opts.onGiveUp?.(error);
 			return;
 		}
 		this.scheduleRestart(onLive, onDead);
@@ -1143,7 +1145,10 @@ var FfmpegProcess = class {
 	scheduleRestart(onLive, onDead) {
 		if (this.stopped) return;
 		const maxRestarts = this.opts.maxRestarts ?? 0;
-		if (maxRestarts === 0) return;
+		if (maxRestarts === 0) {
+			this.opts.onGiveUp?.(/* @__PURE__ */ new Error(`ffmpeg ${this.opts.role} ended and restarts are disabled`));
+			return;
+		}
 		if (this.producedOutput && this.now - this.startedAtMs >= (this.opts.stableRunMs ?? DEFAULT_STABLE_RUN_MS)) this.consecutiveFailures = 0;
 		if (this.consecutiveFailures > maxRestarts) return;
 		(this.opts.setTimeoutFn ?? setTimeout)(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.221",
+  "version": "1.2.223",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",