@canonmsg/backend-contracts 6.0.0 → 6.1.0

package/dist/canon-verbs.schema.json

@@ -135,6 +135,24 @@
         "durationMs": {
           "type": "number",
           "minimum": 0
+        },
+        "thumbnailUrl": {
+          "type": "string",
+          "minLength": 1
+        },
+        "processingStatus": {
+          "enum": [
+            "processing",
+            "ready",
+            "failed"
+          ]
+        },
+        "processingErrorCode": {
+          "enum": [
+            "invalid_video",
+            "video_limits_exceeded",
+            "video_processing_failed"
+          ]
         }
       }
     },

package/dist/cjs/media.js

@@ -92,6 +92,20 @@ function normalizeStoredAttachments(value) {
         const width = normalizeAttachmentNumber(candidate.width);
         const height = normalizeAttachmentNumber(candidate.height);
         const durationMs = normalizeAttachmentNumber(candidate.durationMs);
+        const processingStatus = candidate.processingStatus;
+        if (processingStatus !== undefined
+            && processingStatus !== 'processing'
+            && processingStatus !== 'ready'
+            && processingStatus !== 'failed') {
+            return null;
+        }
+        const processingErrorCode = candidate.processingErrorCode;
+        if (processingErrorCode !== undefined
+            && processingErrorCode !== 'invalid_video'
+            && processingErrorCode !== 'video_limits_exceeded'
+            && processingErrorCode !== 'video_processing_failed') {
+            return null;
+        }
         attachments.push({
             kind: candidate.kind,
             url: candidate.url,
@@ -102,6 +116,11 @@ function normalizeStoredAttachments(value) {
             ...(width !== undefined ? { width } : {}),
             ...(height !== undefined ? { height } : {}),
             ...(durationMs !== undefined ? { durationMs } : {}),
+            ...(typeof candidate.thumbnailUrl === 'string' && candidate.thumbnailUrl
+                ? { thumbnailUrl: candidate.thumbnailUrl }
+                : {}),
+            ...(processingStatus !== undefined ? { processingStatus } : {}),
+            ...(processingErrorCode !== undefined ? { processingErrorCode } : {}),
         });
     }
     return attachments.length > 0 ? attachments : [];

package/dist/cjs/verbSchemas.js

@@ -108,6 +108,11 @@ const mediaAttachmentDef = {
         width: { type: 'number', minimum: 0 },
         height: { type: 'number', minimum: 0 },
         durationMs: { type: 'number', minimum: 0 },
+        thumbnailUrl: { type: 'string', minLength: 1 },
+        processingStatus: { enum: ['processing', 'ready', 'failed'] },
+        processingErrorCode: {
+            enum: ['invalid_video', 'video_limits_exceeded', 'video_processing_failed'],
+        },
     },
 };
 const turnMetadataDef = {

package/dist/media.d.ts

@@ -1,4 +1,8 @@
 export type MediaAttachmentKind = 'image' | 'audio' | 'video' | 'file';
+/** Lifecycle for newly uploaded videos that are normalized server-side. */
+export type VideoProcessingStatus = 'processing' | 'ready' | 'failed';
+/** Stable, display-safe reasons for a terminal video processing failure. */
+export type VideoProcessingErrorCode = 'invalid_video' | 'video_limits_exceeded' | 'video_processing_failed';
 export interface MediaAttachment {
     kind: MediaAttachmentKind;
     url: string;
@@ -14,6 +18,11 @@ export interface MediaAttachment {
     width?: number;
     height?: number;
     durationMs?: number;
+    /** Server-generated poster for a normalized video. */
+    thumbnailUrl?: string;
+    /** Missing means a legacy attachment that is immediately playable. */
+    processingStatus?: VideoProcessingStatus;
+    processingErrorCode?: VideoProcessingErrorCode;
 }
 export declare function inferMediaAttachmentKind(mimeType: string): MediaAttachmentKind;
 export declare function getStoredFileExtension(input: {

package/dist/media.js

@@ -84,6 +84,20 @@ export function normalizeStoredAttachments(value) {
         const width = normalizeAttachmentNumber(candidate.width);
         const height = normalizeAttachmentNumber(candidate.height);
         const durationMs = normalizeAttachmentNumber(candidate.durationMs);
+        const processingStatus = candidate.processingStatus;
+        if (processingStatus !== undefined
+            && processingStatus !== 'processing'
+            && processingStatus !== 'ready'
+            && processingStatus !== 'failed') {
+            return null;
+        }
+        const processingErrorCode = candidate.processingErrorCode;
+        if (processingErrorCode !== undefined
+            && processingErrorCode !== 'invalid_video'
+            && processingErrorCode !== 'video_limits_exceeded'
+            && processingErrorCode !== 'video_processing_failed') {
+            return null;
+        }
         attachments.push({
             kind: candidate.kind,
             url: candidate.url,
@@ -94,6 +108,11 @@ export function normalizeStoredAttachments(value) {
             ...(width !== undefined ? { width } : {}),
             ...(height !== undefined ? { height } : {}),
             ...(durationMs !== undefined ? { durationMs } : {}),
+            ...(typeof candidate.thumbnailUrl === 'string' && candidate.thumbnailUrl
+                ? { thumbnailUrl: candidate.thumbnailUrl }
+                : {}),
+            ...(processingStatus !== undefined ? { processingStatus } : {}),
+            ...(processingErrorCode !== undefined ? { processingErrorCode } : {}),
         });
     }
     return attachments.length > 0 ? attachments : [];

package/dist/verbContract.d.ts

@@ -258,6 +258,9 @@ export interface VerbMediaAttachment {
     width?: number;
     height?: number;
     durationMs?: number;
+    thumbnailUrl?: string;
+    processingStatus?: 'processing' | 'ready' | 'failed';
+    processingErrorCode?: 'invalid_video' | 'video_limits_exceeded' | 'video_processing_failed';
 }
 /**
  * Well-known turn-protocol keys inside the free-form metadata envelope

package/dist/verbSchemas.d.ts

@@ -280,6 +280,16 @@ export declare const CANON_VERBS_JSON_SCHEMA: {
                     readonly type: "number";
                     readonly minimum: 0;
                 };
+                readonly thumbnailUrl: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly processingStatus: {
+                    readonly enum: readonly ["processing", "ready", "failed"];
+                };
+                readonly processingErrorCode: {
+                    readonly enum: readonly ["invalid_video", "video_limits_exceeded", "video_processing_failed"];
+                };
             };
         };
         readonly turnMetadata: {

package/dist/verbSchemas.js

@@ -103,6 +103,11 @@ const mediaAttachmentDef = {
         width: { type: 'number', minimum: 0 },
         height: { type: 'number', minimum: 0 },
         durationMs: { type: 'number', minimum: 0 },
+        thumbnailUrl: { type: 'string', minLength: 1 },
+        processingStatus: { enum: ['processing', 'ready', 'failed'] },
+        processingErrorCode: {
+            enum: ['invalid_video', 'video_limits_exceeded', 'video_processing_failed'],
+        },
     },
 };
 const turnMetadataDef = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/backend-contracts",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "description": "Canon backend contract helpers shared by Functions and stream-service",
   "type": "module",
   "main": "dist/cjs/index.js",