@veruna/api-contracts 1.0.45 → 1.0.46

package/build/v1/index.d.ts

@@ -17,3 +17,4 @@ export * from './wallet';
 export * from './email-validation';
 export * from './registration-antifraud';
 export * from './page-hints';
+export * from './s3';

package/build/v1/index.js

@@ -33,3 +33,4 @@ __exportStar(require("./wallet"), exports);
 __exportStar(require("./email-validation"), exports);
 __exportStar(require("./registration-antifraud"), exports);
 __exportStar(require("./page-hints"), exports);
+__exportStar(require("./s3"), exports);

package/build/v1/message/commands/create-message.command.d.ts

@@ -51,6 +51,7 @@ export declare namespace CreateMessageCommand {
         chatId: z.ZodString;
         messageId: z.ZodString;
         type: z.ZodLiteral<import("../schemas").StreamEventType.REASONING>;
+        content: z.ZodLiteral<"">;
         reasoning: z.ZodString;
         reasoningDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
             type: z.ZodString;
@@ -58,6 +59,15 @@ export declare namespace CreateMessageCommand {
             format: z.ZodOptional<z.ZodString>;
             index: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodNumber;
+        chatId: z.ZodString;
+        messageId: z.ZodString;
+        type: z.ZodLiteral<import("../schemas").StreamEventType.IMAGE>;
+        content: z.ZodLiteral<"">;
+        imageBase64: z.ZodString;
+        imageMimeType: z.ZodString;
+        imageIndex: z.ZodNumber;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodNumber;
         chatId: z.ZodString;

package/build/v1/message/schemas/index.d.ts

@@ -4,7 +4,9 @@ export { UserRating } from './user-rating.enum';
 export { CreateMessageRequestSchema } from './create-message-request.schema';
 export { CreateMessageResponseSchema } from './create-message-response.schema';
 export { MessageResponseSchema } from './message-response.schema';
-export { StreamEventType, StreamEventSchema, StreamChunkEventSchema, StreamReasoningEventSchema, StreamDoneEventSchema, StreamErrorEventSchema, } from './stream-events.schema';
+export { StreamEventType, StreamEventSchema, StreamChunkEventSchema, StreamReasoningEventSchema, StreamImageEventSchema, StreamDoneEventSchema, StreamErrorEventSchema, } from './stream-events.schema';
+export { AttachmentType, AttachmentSchema, AttachmentsSchema } from './message-attachment.schema';
+export type { Attachment, Attachments } from './message-attachment.schema';
 export { MessageMetaSchema, ReasoningMetaSchema, ReasoningDetailSchema, } from './message-meta.schema';
 export { RateMessageRequestSchema, RateMessageResponseSchema, RateMessageParamsSchema, } from './rate-message.schema';
 export type { RateMessageRequestDto, RateMessageResponseDto, RateMessageParamsDto, } from './rate-message.schema';

package/build/v1/message/schemas/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RateMessageParamsSchema = exports.RateMessageResponseSchema = exports.RateMessageRequestSchema = exports.ReasoningDetailSchema = exports.ReasoningMetaSchema = exports.MessageMetaSchema = exports.StreamErrorEventSchema = exports.StreamDoneEventSchema = exports.StreamReasoningEventSchema = exports.StreamChunkEventSchema = exports.StreamEventSchema = exports.StreamEventType = exports.MessageResponseSchema = exports.CreateMessageResponseSchema = exports.CreateMessageRequestSchema = exports.UserRating = exports.MessageStatus = exports.MessageRole = void 0;
+exports.RateMessageParamsSchema = exports.RateMessageResponseSchema = exports.RateMessageRequestSchema = exports.ReasoningDetailSchema = exports.ReasoningMetaSchema = exports.MessageMetaSchema = exports.AttachmentsSchema = exports.AttachmentSchema = exports.AttachmentType = exports.StreamErrorEventSchema = exports.StreamDoneEventSchema = exports.StreamImageEventSchema = exports.StreamReasoningEventSchema = exports.StreamChunkEventSchema = exports.StreamEventSchema = exports.StreamEventType = exports.MessageResponseSchema = exports.CreateMessageResponseSchema = exports.CreateMessageRequestSchema = exports.UserRating = exports.MessageStatus = exports.MessageRole = void 0;
 var message_role_enum_1 = require("./message-role.enum");
 Object.defineProperty(exports, "MessageRole", { enumerable: true, get: function () { return message_role_enum_1.MessageRole; } });
 var message_status_enum_1 = require("./message-status.enum");
@@ -18,8 +18,13 @@ Object.defineProperty(exports, "StreamEventType", { enumerable: true, get: funct
 Object.defineProperty(exports, "StreamEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamEventSchema; } });
 Object.defineProperty(exports, "StreamChunkEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamChunkEventSchema; } });
 Object.defineProperty(exports, "StreamReasoningEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamReasoningEventSchema; } });
+Object.defineProperty(exports, "StreamImageEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamImageEventSchema; } });
 Object.defineProperty(exports, "StreamDoneEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamDoneEventSchema; } });
 Object.defineProperty(exports, "StreamErrorEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamErrorEventSchema; } });
+var message_attachment_schema_1 = require("./message-attachment.schema");
+Object.defineProperty(exports, "AttachmentType", { enumerable: true, get: function () { return message_attachment_schema_1.AttachmentType; } });
+Object.defineProperty(exports, "AttachmentSchema", { enumerable: true, get: function () { return message_attachment_schema_1.AttachmentSchema; } });
+Object.defineProperty(exports, "AttachmentsSchema", { enumerable: true, get: function () { return message_attachment_schema_1.AttachmentsSchema; } });
 var message_meta_schema_1 = require("./message-meta.schema");
 Object.defineProperty(exports, "MessageMetaSchema", { enumerable: true, get: function () { return message_meta_schema_1.MessageMetaSchema; } });
 Object.defineProperty(exports, "ReasoningMetaSchema", { enumerable: true, get: function () { return message_meta_schema_1.ReasoningMetaSchema; } });

package/build/v1/message/schemas/message-attachment.schema.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+/**
+ * Attachment types for message assets
+ */
+export declare enum AttachmentType {
+    IMAGE = "image"
+}
+/**
+ * Attachment schema - stores S3 reference for generated assets
+ * Used internally for file management (deletion, tracking)
+ * NOT sent to frontend - frontend gets images via markdown in content
+ */
+export declare const AttachmentSchema: z.ZodObject<{
+    type: z.ZodEnum<typeof AttachmentType>;
+    key: z.ZodString;
+    bucket: z.ZodString;
+}, z.core.$strip>;
+export type Attachment = z.infer<typeof AttachmentSchema>;
+/**
+ * Array of attachments for message
+ */
+export declare const AttachmentsSchema: z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<typeof AttachmentType>;
+    key: z.ZodString;
+    bucket: z.ZodString;
+}, z.core.$strip>>;
+export type Attachments = z.infer<typeof AttachmentsSchema>;

package/build/v1/message/schemas/message-attachment.schema.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachmentsSchema = exports.AttachmentSchema = exports.AttachmentType = void 0;
+const zod_1 = require("zod");
+/**
+ * Attachment types for message assets
+ */
+var AttachmentType;
+(function (AttachmentType) {
+    AttachmentType["IMAGE"] = "image";
+})(AttachmentType || (exports.AttachmentType = AttachmentType = {}));
+/**
+ * Attachment schema - stores S3 reference for generated assets
+ * Used internally for file management (deletion, tracking)
+ * NOT sent to frontend - frontend gets images via markdown in content
+ */
+exports.AttachmentSchema = zod_1.z.object({
+    /** Asset type */
+    type: zod_1.z.nativeEnum(AttachmentType),
+    /** S3 object key */
+    key: zod_1.z.string().min(1),
+    /** S3 bucket name */
+    bucket: zod_1.z.string().min(1),
+});
+/**
+ * Array of attachments for message
+ */
+exports.AttachmentsSchema = zod_1.z.array(exports.AttachmentSchema);

package/build/v1/message/schemas/stream-events.schema.d.ts

@@ -7,6 +7,8 @@ export declare enum StreamEventType {
     CHUNK = "chunk",
     /** Reasoning chunk from AI */
     REASONING = "reasoning",
+    /** Image generated by AI */
+    IMAGE = "image",
     /** Stream completed successfully */
     DONE = "done",
     /** Error occurred during streaming */
@@ -30,6 +32,7 @@ export declare const StreamReasoningEventSchema: z.ZodObject<{
     chatId: z.ZodString;
     messageId: z.ZodString;
     type: z.ZodLiteral<StreamEventType.REASONING>;
+    content: z.ZodLiteral<"">;
     reasoning: z.ZodString;
     reasoningDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodString;
@@ -58,6 +61,19 @@ export declare const StreamErrorEventSchema: z.ZodObject<{
     type: z.ZodLiteral<StreamEventType.ERROR>;
     content: z.ZodLiteral<"">;
 }, z.core.$strip>;
+/**
+ * Image event - AI generated image (base64)
+ */
+export declare const StreamImageEventSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    chatId: z.ZodString;
+    messageId: z.ZodString;
+    type: z.ZodLiteral<StreamEventType.IMAGE>;
+    content: z.ZodLiteral<"">;
+    imageBase64: z.ZodString;
+    imageMimeType: z.ZodString;
+    imageIndex: z.ZodNumber;
+}, z.core.$strip>;
 /**
  * Discriminated union of all stream events
  * Use `type` field to narrow the type
@@ -73,6 +89,7 @@ export declare const StreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     chatId: z.ZodString;
     messageId: z.ZodString;
     type: z.ZodLiteral<StreamEventType.REASONING>;
+    content: z.ZodLiteral<"">;
     reasoning: z.ZodString;
     reasoningDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodString;
@@ -80,6 +97,15 @@ export declare const StreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         format: z.ZodOptional<z.ZodString>;
         index: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodNumber;
+    chatId: z.ZodString;
+    messageId: z.ZodString;
+    type: z.ZodLiteral<StreamEventType.IMAGE>;
+    content: z.ZodLiteral<"">;
+    imageBase64: z.ZodString;
+    imageMimeType: z.ZodString;
+    imageIndex: z.ZodNumber;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodNumber;
     chatId: z.ZodString;

package/build/v1/message/schemas/stream-events.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StreamEventSchema = exports.StreamErrorEventSchema = exports.StreamDoneEventSchema = exports.StreamReasoningEventSchema = exports.StreamChunkEventSchema = exports.StreamEventType = void 0;
+exports.StreamEventSchema = exports.StreamImageEventSchema = exports.StreamErrorEventSchema = exports.StreamDoneEventSchema = exports.StreamReasoningEventSchema = exports.StreamChunkEventSchema = exports.StreamEventType = void 0;
 const zod_1 = require("zod");
 /**
  * Stream Event Types for message streaming (NDJSON format)
@@ -11,6 +11,8 @@ var StreamEventType;
     StreamEventType["CHUNK"] = "chunk";
     /** Reasoning chunk from AI */
     StreamEventType["REASONING"] = "reasoning";
+    /** Image generated by AI */
+    StreamEventType["IMAGE"] = "image";
     /** Stream completed successfully */
     StreamEventType["DONE"] = "done";
     /** Error occurred during streaming */
@@ -43,6 +45,8 @@ exports.StreamChunkEventSchema = BaseStreamEventSchema.extend({
  */
 exports.StreamReasoningEventSchema = BaseStreamEventSchema.extend({
     type: zod_1.z.literal(StreamEventType.REASONING),
+    /** Always empty for reasoning event */
+    content: zod_1.z.literal(''),
     /** Partial reasoning text */
     reasoning: zod_1.z.string().min(1),
     reasoningDetails: zod_1.z
@@ -70,6 +74,20 @@ exports.StreamErrorEventSchema = BaseStreamEventSchema.extend({
     /** Always empty for error event */
     content: zod_1.z.literal(''),
 });
+/**
+ * Image event - AI generated image (base64)
+ */
+exports.StreamImageEventSchema = BaseStreamEventSchema.extend({
+    type: zod_1.z.literal(StreamEventType.IMAGE),
+    /** Always empty for image event */
+    content: zod_1.z.literal(''),
+    /** Base64 encoded image data */
+    imageBase64: zod_1.z.string().min(1),
+    /** Image MIME type (image/jpeg, image/png, etc.) */
+    imageMimeType: zod_1.z.string().min(1),
+    /** Image index (for multiple images in one message) */
+    imageIndex: zod_1.z.number().int().nonnegative(),
+});
 // ============================================================================
 // Union Schema
 // ============================================================================
@@ -80,6 +98,7 @@ exports.StreamErrorEventSchema = BaseStreamEventSchema.extend({
 exports.StreamEventSchema = zod_1.z.discriminatedUnion('type', [
     exports.StreamChunkEventSchema,
     exports.StreamReasoningEventSchema,
+    exports.StreamImageEventSchema,
     exports.StreamDoneEventSchema,
     exports.StreamErrorEventSchema,
 ]);

package/build/v1/s3/index.d.ts

@@ -0,0 +1 @@
+export * from './s3.errors';

package/build/v1/s3/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./s3.errors"), exports);

package/build/v1/s3/s3.errors.d.ts

@@ -0,0 +1,13 @@
+import { ErrorMetadata } from '../../shared/error-metadata';
+/**
+ * S3 Error Codes
+ */
+export declare enum S3ErrorCode {
+    UPLOAD_FAILED = "S3_UPLOAD_FAILED",
+    INVALID_BASE64 = "S3_INVALID_BASE64",
+    DELETE_FAILED = "S3_DELETE_FAILED"
+}
+/**
+ * S3 Error Metadata mapping
+ */
+export declare const S3_ERRORS: Record<S3ErrorCode, ErrorMetadata>;

package/build/v1/s3/s3.errors.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3_ERRORS = exports.S3ErrorCode = void 0;
+/**
+ * S3 Error Codes
+ */
+var S3ErrorCode;
+(function (S3ErrorCode) {
+    S3ErrorCode["UPLOAD_FAILED"] = "S3_UPLOAD_FAILED";
+    S3ErrorCode["INVALID_BASE64"] = "S3_INVALID_BASE64";
+    S3ErrorCode["DELETE_FAILED"] = "S3_DELETE_FAILED";
+})(S3ErrorCode || (exports.S3ErrorCode = S3ErrorCode = {}));
+/**
+ * S3 Error Metadata mapping
+ */
+exports.S3_ERRORS = {
+    [S3ErrorCode.UPLOAD_FAILED]: {
+        code: S3ErrorCode.UPLOAD_FAILED,
+        statusCode: 500,
+    },
+    [S3ErrorCode.INVALID_BASE64]: {
+        code: S3ErrorCode.INVALID_BASE64,
+        statusCode: 400,
+    },
+    [S3ErrorCode.DELETE_FAILED]: {
+        code: S3ErrorCode.DELETE_FAILED,
+        statusCode: 500,
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veruna/api-contracts",
-  "version": "1.0.45",
+  "version": "1.0.46",
   "description": "API contracts for Veruna project - Zod schemas, types, and paths",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",