@canonmsg/backend-contracts 6.0.0 → 6.2.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/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./diffRedaction.js"), exports);
 __exportStar(require("./environment.js"), exports);
 __exportStar(require("./media.js"), exports);
 __exportStar(require("./message.js"), exports);
+__exportStar(require("./messageText.js"), exports);
 __exportStar(require("./runtimeCardFields.js"), exports);
 __exportStar(require("./runtimeCardStorage.js"), exports);
 __exportStar(require("./turnProtocol.js"), exports);

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/messageText.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HUMAN_MESSAGE_TEXT_MAX_BYTES = void 0;
+exports.messageTextUtf8ByteLength = messageTextUtf8ByteLength;
+exports.isHumanMessageTextWithinLimit = isHumanMessageTextWithinLimit;
+/** Maximum UTF-8 payload size for a human-authored message. */
+exports.HUMAN_MESSAGE_TEXT_MAX_BYTES = 32 * 1024;
+const UTF8_ENCODER = new TextEncoder();
+/** Returns the encoded UTF-8 size used by the message API. */
+function messageTextUtf8ByteLength(value) {
+    return UTF8_ENCODER.encode(value).byteLength;
+}
+/** Whether human-authored message text fits the API's UTF-8 byte budget. */
+function isHumanMessageTextWithinLimit(value) {
+    return messageTextUtf8ByteLength(value) <= exports.HUMAN_MESSAGE_TEXT_MAX_BYTES;
+}

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/index.d.ts

@@ -2,6 +2,7 @@ export * from './diffRedaction.js';
 export * from './environment.js';
 export * from './media.js';
 export * from './message.js';
+export * from './messageText.js';
 export * from './runtimeCardFields.js';
 export * from './runtimeCardStorage.js';
 export * from './turnProtocol.js';

package/dist/index.js

@@ -2,6 +2,7 @@ export * from './diffRedaction.js';
 export * from './environment.js';
 export * from './media.js';
 export * from './message.js';
+export * from './messageText.js';
 export * from './runtimeCardFields.js';
 export * from './runtimeCardStorage.js';
 export * from './turnProtocol.js';

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/messageText.d.ts

@@ -0,0 +1,6 @@
+/** Maximum UTF-8 payload size for a human-authored message. */
+export declare const HUMAN_MESSAGE_TEXT_MAX_BYTES: number;
+/** Returns the encoded UTF-8 size used by the message API. */
+export declare function messageTextUtf8ByteLength(value: string): number;
+/** Whether human-authored message text fits the API's UTF-8 byte budget. */
+export declare function isHumanMessageTextWithinLimit(value: string): boolean;

package/dist/messageText.js

@@ -0,0 +1,11 @@
+/** Maximum UTF-8 payload size for a human-authored message. */
+export const HUMAN_MESSAGE_TEXT_MAX_BYTES = 32 * 1024;
+const UTF8_ENCODER = new TextEncoder();
+/** Returns the encoded UTF-8 size used by the message API. */
+export function messageTextUtf8ByteLength(value) {
+    return UTF8_ENCODER.encode(value).byteLength;
+}
+/** Whether human-authored message text fits the API's UTF-8 byte budget. */
+export function isHumanMessageTextWithinLimit(value) {
+    return messageTextUtf8ByteLength(value) <= HUMAN_MESSAGE_TEXT_MAX_BYTES;
+}

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.2.0",
   "description": "Canon backend contract helpers shared by Functions and stream-service",
   "type": "module",
   "main": "dist/cjs/index.js",