@camstack/types 1.2.47 → 1.2.48

package/dist/capabilities/face-gallery.cap.d.ts

@@ -28,6 +28,7 @@ declare const FaceInfoSchema: z.ZodObject<{
     identityName: z.ZodOptional<z.ZodString>;
     assigned: z.ZodBoolean;
     base64: z.ZodOptional<z.ZodString>;
+    cropUrl: z.ZodOptional<z.ZodString>;
     faceBbox: z.ZodOptional<z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -92,6 +93,7 @@ export declare const faceGalleryCapability: {
                 recognized: "recognized";
                 all: "all";
             }>>;
+            includeCrops: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             faceId: z.ZodString;
             deviceId: z.ZodNumber;
@@ -101,6 +103,7 @@ export declare const faceGalleryCapability: {
             identityName: z.ZodOptional<z.ZodString>;
             assigned: z.ZodBoolean;
             base64: z.ZodOptional<z.ZodString>;
+            cropUrl: z.ZodOptional<z.ZodString>;
             faceBbox: z.ZodOptional<z.ZodObject<{
                 x: z.ZodNumber;
                 y: z.ZodNumber;
@@ -125,6 +128,7 @@ export declare const faceGalleryCapability: {
             identityName: z.ZodOptional<z.ZodString>;
             assigned: z.ZodBoolean;
             base64: z.ZodOptional<z.ZodString>;
+            cropUrl: z.ZodOptional<z.ZodString>;
             faceBbox: z.ZodOptional<z.ZodObject<{
                 x: z.ZodNumber;
                 y: z.ZodNumber;

package/dist/generated/addon-api.d.ts

@@ -9304,7 +9304,7 @@ export type AppRouter = TrpcCoreRouter<{
         createShareToken: import("@trpc/server").TRPCMutationProcedure<{
             input: {
                 scope: {
-                    kind: "grid-view";
+                    kind: "grid-view" | "events-view";
                     deviceIds: number[];
                 };
                 ttlSec?: number | "never" | undefined;
@@ -9332,7 +9332,7 @@ export type AppRouter = TrpcCoreRouter<{
                 userId: string;
                 tokenPrefix: string;
                 scope: {
-                    kind: "grid-view";
+                    kind: "grid-view" | "events-view";
                     deviceIds: number[];
                 };
                 createdAt: number;
@@ -9617,7 +9617,7 @@ export type AppRouter = TrpcCoreRouter<{
         createShareToken: import("@trpc/server").TRPCMutationProcedure<{
             input: {
                 scope: {
-                    kind: "grid-view";
+                    kind: "grid-view" | "events-view";
                     deviceIds: number[];
                 };
                 ttlSec?: number | "never" | undefined;
@@ -9645,7 +9645,7 @@ export type AppRouter = TrpcCoreRouter<{
                 userId: string;
                 tokenPrefix: string;
                 scope: {
-                    kind: "grid-view";
+                    kind: "grid-view" | "events-view";
                     deviceIds: number[];
                 };
                 createdAt: number;

package/dist/index.js

@@ -19114,7 +19114,29 @@ var FaceInfoSchema = zod.z.object({
 	recognizedIdentityId: zod.z.string().optional(),
 	identityName: zod.z.string().optional(),
 	assigned: zod.z.boolean(),
+	/**
+	* The crop, inline, base64.
+	*
+	* **Prefer {@link cropUrl}.** At the 500 rows the Faces view asks for this
+	* field alone is ~2.87 MiB, re-sent in full on every operator assign and
+	* every 30 s poll, base64-inflated over the msgpack socket and held in the
+	* query heap. It stays for callers that have not migrated; `includeCrops:
+	* false` turns it off once they have.
+	*/
 	base64: zod.z.string().optional(),
+	/**
+	* Same crop, as a data-plane URL for `<img src>` — the move the admin
+	* snapshot surfaces made on 2026-08-08.
+	*
+	* Served by the `event-media` plane, which resolves a raw MediaStore key and
+	* is `access: 'authenticated'`: a bare `<img>` carries the `camstack_session`
+	* cookie, so no header plumbing is needed. The bytes then ride the browser's
+	* HTTP cache with an ETag and `immutable`, instead of the WebSocket.
+	*
+	* Absent when the face has no stored crop, or when the addon has no data
+	* plane — callers fall back to {@link base64}.
+	*/
+	cropUrl: zod.z.string().optional(),
 	/** Design B: the face bbox (pixel space) on the key frame — lets a detail
 	*  view draw the box over the native `keyFrameMediaKey` frame. Absent on
 	*  legacy rows written before design B. */
@@ -19190,7 +19212,23 @@ var faceGalleryCapability = {
 		}),
 		listRecentFaces: require_sleep.method(zod.z.object({
 			limit: zod.z.number().int().positive().optional(),
-			filter: FaceFilterEnum.optional()
+			filter: FaceFilterEnum.optional(),
+			/**
+			* Inline the base64 crop on every row. Default `true` — the existing
+			* behaviour, kept so no caller breaks.
+			*
+			* Set `false` once the caller renders {@link FaceInfo.cropUrl}: that
+			* drops ~2.87 MiB per 500-row page to a few KiB of metadata and lets
+			* the browser cache the images.
+			*
+			* **This is an INPUT field, so it does not reach the addon until the
+			* next train.** The hub router validates cap inputs against its own
+			* compiled Zod, which strips a key it does not know — verified today
+			* on the OUTPUT side, where an additive field DOES arrive immediately
+			* (`Track.hasFace`). Until the train ships, sending `false` is
+			* harmless and simply keeps the crops inline.
+			*/
+			includeCrops: zod.z.boolean().optional()
 		}).optional(), zod.z.array(FaceInfoSchema).readonly()),
 		getFaceByTrack: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number().int(),

package/dist/index.mjs

@@ -19113,7 +19113,29 @@ var FaceInfoSchema = z.object({
 	recognizedIdentityId: z.string().optional(),
 	identityName: z.string().optional(),
 	assigned: z.boolean(),
+	/**
+	* The crop, inline, base64.
+	*
+	* **Prefer {@link cropUrl}.** At the 500 rows the Faces view asks for this
+	* field alone is ~2.87 MiB, re-sent in full on every operator assign and
+	* every 30 s poll, base64-inflated over the msgpack socket and held in the
+	* query heap. It stays for callers that have not migrated; `includeCrops:
+	* false` turns it off once they have.
+	*/
 	base64: z.string().optional(),
+	/**
+	* Same crop, as a data-plane URL for `<img src>` — the move the admin
+	* snapshot surfaces made on 2026-08-08.
+	*
+	* Served by the `event-media` plane, which resolves a raw MediaStore key and
+	* is `access: 'authenticated'`: a bare `<img>` carries the `camstack_session`
+	* cookie, so no header plumbing is needed. The bytes then ride the browser's
+	* HTTP cache with an ETag and `immutable`, instead of the WebSocket.
+	*
+	* Absent when the face has no stored crop, or when the addon has no data
+	* plane — callers fall back to {@link base64}.
+	*/
+	cropUrl: z.string().optional(),
 	/** Design B: the face bbox (pixel space) on the key frame — lets a detail
 	*  view draw the box over the native `keyFrameMediaKey` frame. Absent on
 	*  legacy rows written before design B. */
@@ -19189,7 +19211,23 @@ var faceGalleryCapability = {
 		}),
 		listRecentFaces: method(z.object({
 			limit: z.number().int().positive().optional(),
-			filter: FaceFilterEnum.optional()
+			filter: FaceFilterEnum.optional(),
+			/**
+			* Inline the base64 crop on every row. Default `true` — the existing
+			* behaviour, kept so no caller breaks.
+			*
+			* Set `false` once the caller renders {@link FaceInfo.cropUrl}: that
+			* drops ~2.87 MiB per 500-row page to a few KiB of metadata and lets
+			* the browser cache the images.
+			*
+			* **This is an INPUT field, so it does not reach the addon until the
+			* next train.** The hub router validates cap inputs against its own
+			* compiled Zod, which strips a key it does not know — verified today
+			* on the OUTPUT side, where an additive field DOES arrive immediately
+			* (`Track.hasFace`). Until the train ships, sending `false` is
+			* harmless and simply keeps the crops inline.
+			*/
+			includeCrops: z.boolean().optional()
 		}).optional(), z.array(FaceInfoSchema).readonly()),
 		getFaceByTrack: method(z.object({
 			deviceId: z.number().int(),

package/package.json

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