@camstack/types 1.2.179 → 1.2.180

package/dist/capabilities/pipeline-runner.cap.d.ts

@@ -17,6 +17,7 @@ export declare const NativeCropBboxSchema: z.ZodObject<{
 export declare const NativeCropResultSchema: z.ZodObject<{
     bytes: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
     jpeg: z.ZodOptional<z.ZodString>;
+    jpegBytes: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
     width: z.ZodNumber;
     height: z.ZodNumber;
     tier: z.ZodOptional<z.ZodEnum<{
@@ -80,7 +81,8 @@ export declare const ParkTrackFrameResultSchema: z.ZodDiscriminatedUnion<[z.ZodO
 export type ParkTrackFrameResult = z.infer<typeof ParkTrackFrameResultSchema>;
 /** A retrieved parcel — the runner's own JPEG, base64 for the wire. */
 export declare const ParkedTrackFrameSchema: z.ZodObject<{
-    jpeg: z.ZodString;
+    jpeg: z.ZodOptional<z.ZodString>;
+    jpegBytes: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
     width: z.ZodNumber;
     height: z.ZodNumber;
     timestamp: z.ZodNumber;
@@ -804,10 +806,12 @@ export declare const pipelineRunnerCapability: {
                 h: z.ZodNumber;
             }, z.core.$strip>;
             maxWidth: z.ZodOptional<z.ZodNumber>;
+            acceptJpegBytes: z.ZodOptional<z.ZodBoolean>;
             encodeJpeg: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
             bytes: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
             jpeg: z.ZodOptional<z.ZodString>;
+            jpegBytes: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
             width: z.ZodNumber;
             height: z.ZodNumber;
             tier: z.ZodOptional<z.ZodEnum<{
@@ -1072,8 +1076,10 @@ export declare const pipelineRunnerCapability: {
                 keyFrame: "keyFrame";
                 thumbnail: "thumbnail";
             }>;
+            acceptJpegBytes: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
-            jpeg: z.ZodString;
+            jpeg: z.ZodOptional<z.ZodString>;
+            jpegBytes: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
             width: z.ZodNumber;
             height: z.ZodNumber;
             timestamp: z.ZodNumber;

package/dist/index.js

@@ -21271,6 +21271,14 @@ var NativeCropResultSchema = zod.z.object({
 	* set `encodeJpeg: true`; `bytes` is then absent.
 	*/
 	jpeg: zod.z.string().optional(),
+	/**
+	* The SAME compressed JPEG as `jpeg`, as bytes (D462). Present instead of
+	* `jpeg` when the request set `acceptJpegBytes`; a request that did not gets
+	* `jpeg` exactly as before. MsgPack and the mesh leg both carry binary —
+	* `bytes` above has crossed this boundary as a `Uint8Array` all along — so
+	* base64 was buying nothing but a multi-megabyte string in the relay's heap.
+	*/
+	jpegBytes: zod.z.instanceof(Uint8Array).optional(),
 	width: zod.z.number().int().positive(),
 	height: zod.z.number().int().positive(),
 	/**
@@ -21337,7 +21345,14 @@ var ParkTrackFrameResultSchema = zod.z.discriminatedUnion("parked", [zod.z.objec
 })]);
 /** A retrieved parcel — the runner's own JPEG, base64 for the wire. */
 var ParkedTrackFrameSchema = zod.z.object({
-	jpeg: zod.z.string(),
+	/**
+	* Base64 JPEG — the pre-D462 wire. OPTIONAL since D462: a request that set
+	* `acceptJpegBytes` is answered in `jpegBytes` and this is then absent.
+	* Exactly one of the two is present.
+	*/
+	jpeg: zod.z.string().optional(),
+	/** The same JPEG as bytes, for a caller that declared it reads them (D462). */
+	jpegBytes: zod.z.instanceof(Uint8Array).optional(),
 	width: zod.z.number().int().positive(),
 	height: zod.z.number().int().positive(),
 	/** The frame instant the parcel shows (the caller's clock, echoed back). */
@@ -22176,6 +22191,13 @@ var pipelineRunnerCapability = {
 			bbox: NativeCropBboxSchema,
 			maxWidth: zod.z.number().int().positive().optional(),
 			/**
+			* The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+			* back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+			* wire — never assume consent: a pre-D462 caller parses the field as
+			* base64 and bytes would decode to garbage rather than fail.
+			*/
+			acceptJpegBytes: zod.z.boolean().optional(),
+			/**
 			* When `true`, the runner encodes the resolved crop to JPEG ON THE
 			* OWNING NODE and returns it in `jpeg` (base64) INSTEAD of raw `bytes`.
 			* Callers set this for CROSS-NODE fetches (`handle.nodeId` is a remote
@@ -22348,7 +22370,14 @@ var pipelineRunnerCapability = {
 		getParkedTrackFrame: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number(),
 			trackId: zod.z.string(),
-			kind: ParkedFrameKindSchema
+			kind: ParkedFrameKindSchema,
+			/**
+			* The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+			* back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+			* wire — never assume consent: a pre-D462 caller parses the field as
+			* base64 and bytes would decode to garbage rather than fail.
+			*/
+			acceptJpegBytes: zod.z.boolean().optional()
 		}), ParkedTrackFrameSchema.nullable()),
 		/**
 		* Drop every parcel of a track — the hub closed it. Idempotent. A track

package/dist/index.mjs

@@ -21270,6 +21270,14 @@ var NativeCropResultSchema = z.object({
 	* set `encodeJpeg: true`; `bytes` is then absent.
 	*/
 	jpeg: z.string().optional(),
+	/**
+	* The SAME compressed JPEG as `jpeg`, as bytes (D462). Present instead of
+	* `jpeg` when the request set `acceptJpegBytes`; a request that did not gets
+	* `jpeg` exactly as before. MsgPack and the mesh leg both carry binary —
+	* `bytes` above has crossed this boundary as a `Uint8Array` all along — so
+	* base64 was buying nothing but a multi-megabyte string in the relay's heap.
+	*/
+	jpegBytes: z.instanceof(Uint8Array).optional(),
 	width: z.number().int().positive(),
 	height: z.number().int().positive(),
 	/**
@@ -21336,7 +21344,14 @@ var ParkTrackFrameResultSchema = z.discriminatedUnion("parked", [z.object({
 })]);
 /** A retrieved parcel — the runner's own JPEG, base64 for the wire. */
 var ParkedTrackFrameSchema = z.object({
-	jpeg: z.string(),
+	/**
+	* Base64 JPEG — the pre-D462 wire. OPTIONAL since D462: a request that set
+	* `acceptJpegBytes` is answered in `jpegBytes` and this is then absent.
+	* Exactly one of the two is present.
+	*/
+	jpeg: z.string().optional(),
+	/** The same JPEG as bytes, for a caller that declared it reads them (D462). */
+	jpegBytes: z.instanceof(Uint8Array).optional(),
 	width: z.number().int().positive(),
 	height: z.number().int().positive(),
 	/** The frame instant the parcel shows (the caller's clock, echoed back). */
@@ -22175,6 +22190,13 @@ var pipelineRunnerCapability = {
 			bbox: NativeCropBboxSchema,
 			maxWidth: z.number().int().positive().optional(),
 			/**
+			* The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+			* back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+			* wire — never assume consent: a pre-D462 caller parses the field as
+			* base64 and bytes would decode to garbage rather than fail.
+			*/
+			acceptJpegBytes: z.boolean().optional(),
+			/**
 			* When `true`, the runner encodes the resolved crop to JPEG ON THE
 			* OWNING NODE and returns it in `jpeg` (base64) INSTEAD of raw `bytes`.
 			* Callers set this for CROSS-NODE fetches (`handle.nodeId` is a remote
@@ -22347,7 +22369,14 @@ var pipelineRunnerCapability = {
 		getParkedTrackFrame: method(z.object({
 			deviceId: z.number(),
 			trackId: z.string(),
-			kind: ParkedFrameKindSchema
+			kind: ParkedFrameKindSchema,
+			/**
+			* The caller reads a `Uint8Array` (D462). When set, a JPEG answer comes
+			* back in `jpegBytes` instead of base64 `jpeg`. Absent means the old
+			* wire — never assume consent: a pre-D462 caller parses the field as
+			* base64 and bytes would decode to garbage rather than fail.
+			*/
+			acceptJpegBytes: z.boolean().optional()
 		}), ParkedTrackFrameSchema.nullable()),
 		/**
 		* Drop every parcel of a track — the hub closed it. Idempotent. A track

package/dist/interfaces/pipeline-runner-capability.d.ts

@@ -272,6 +272,8 @@ export interface IPipelineRunnerProvider {
         readonly deviceId: number;
         readonly trackId: string;
         readonly kind: import('../capabilities/pipeline-runner.cap.js').ParkedFrameKind;
+        /** The caller reads bytes: answer in `jpegBytes`, not base64 (D462). */
+        readonly acceptJpegBytes?: boolean;
     }): Promise<import('../capabilities/pipeline-runner.cap.js').ParkedTrackFrame | null>;
     /** Drop every parcel of a closed track. Idempotent. */
     releaseParkedTrackFrames(input: {

package/package.json

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