@mestra-dev/contract 0.0.8 → 0.0.10

package/dist/index.d.ts

@@ -88,7 +88,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					},
 					{
 						readonly name: "Files";
-						readonly description: "S3 file upload (presigned POST), profile picture upload/confirm/delete, comment attachment upload, list task comment files with download URLs, folder create/delete, list (includes pin metadata), pin/unpin, download, and file delete. General uploads accept JPEG/PNG/WebP/PDF; profile pictures accept JPEG/PNG only (0.5 MB).";
+						readonly description: "S3 file upload (presigned POST), profile and workspace picture upload/confirm/delete, comment attachment upload, list task comment files with download URLs, folder create/delete, list (includes pin metadata), pin/unpin, download, and file delete. General uploads accept JPEG/PNG/WebP/PDF; profile/workspace pictures accept JPEG/PNG only (0.5 MB).";
 					},
 					{
 						readonly name: "Chat";
@@ -715,6 +715,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								readonly category: {
 									readonly $ref: "#/components/schemas/WorkspaceCategory";
 								};
+								readonly picture: {
+									readonly type: "string";
+									readonly nullable: true;
+									readonly description: "Presigned workspace avatar URL (7-day expiry, refreshed periodically); empty string when unset.";
+								};
 								readonly created_at: {
 									readonly type: "string";
 									readonly format: "date-time";
@@ -1235,7 +1240,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"image/jpeg",
 								"image/png"
 							];
-							readonly description: "Allowed MIME type declared for the temporary profile-picture upload.";
+							readonly description: "Allowed MIME type declared for temporary profile or workspace picture uploads.";
 						};
 						readonly UploadFileRequest: {
 							readonly type: "object";
@@ -1471,6 +1476,73 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 							};
 						};
+						readonly UploadWorkspacePictureRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"workspace",
+								"contentType"
+							];
+							readonly properties: {
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Workspace identifier.";
+								};
+								readonly contentType: {
+									readonly $ref: "#/components/schemas/ProfileImageContentType";
+								};
+							};
+						};
+						readonly WorkspacePictureWorkspaceRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"workspace"
+							];
+							readonly properties: {
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Workspace identifier.";
+								};
+							};
+						};
+						readonly ConfirmWorkspacePictureSuccess: {
+							readonly type: "object";
+							readonly required: readonly [
+								"success",
+								"url"
+							];
+							readonly properties: {
+								readonly success: {
+									readonly type: "boolean";
+									readonly const: true;
+								};
+								readonly url: {
+									readonly type: "string";
+									readonly description: "Presigned GET URL for `profiles/workspaces/{workspace}/avatar.webp` (WebP response content type, 7-day expiry). Also saved on the workspace.";
+								};
+							};
+						};
+						readonly DeleteWorkspacePictureSuccess: {
+							readonly type: "object";
+							readonly required: readonly [
+								"success",
+								"message"
+							];
+							readonly properties: {
+								readonly success: {
+									readonly type: "boolean";
+									readonly const: true;
+								};
+								readonly message: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"Workspace picture deleted successfully",
+										"Workspace picture already deleted"
+									];
+								};
+							};
+						};
 						readonly CreateFolderRequest: {
 							readonly type: "object";
 							readonly required: readonly [
@@ -9618,6 +9690,222 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
+					readonly "/files/upload-workspace-picture": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Create presigned upload for workspace picture";
+							readonly description: "Returns a presigned POST URL and form fields for uploading a temporary workspace picture to `profiles/workspaces/{workspace}/temp` (max 0.5 MB, 5-minute expiry). Accepts JPEG and PNG. After the multipart upload succeeds, call `/files/confirm-workspace-picture` to validate, optimize, and persist the image. Requires workspace access and write access to crm::general.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/UploadWorkspacePictureRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Presigned workspace picture upload created.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly allOf: readonly [
+													{
+														readonly $ref: "#/components/schemas/PresignedUploadSuccess";
+													}
+												];
+												readonly description: "key is `profiles/workspaces/{workspace}/temp`; maxSize is 524288 (0.5 MB).";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request payload or unsupported content type.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized - Missing or invalid access token.";
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access', user lacks workspace access, or user lacks write access to crm::general.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Workspace not found.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/files/confirm-workspace-picture": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Confirm and persist an uploaded workspace picture";
+							readonly description: "Reads the temporary object at `profiles/workspaces/{workspace}/temp`, verifies size (<= 0.5 MB) and real image type (JPEG, PNG, or WebP), resizes it to a 512x512 WebP avatar (cover fit, without enlargement, input pixel limit 4096x4096), stores it privately at `profiles/workspaces/{workspace}/avatar.webp`, deletes the temporary object, creates a 7-day presigned GET URL for the avatar, and saves that URL on the workspace. On failure, the temporary object is deleted and the workspace picture is cleared. Requires workspace access and write access to crm::general.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/WorkspacePictureWorkspaceRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Workspace picture confirmed and saved successfully.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ConfirmWorkspacePictureSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Temporary object missing, file too large, invalid image type, or processing failed.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized - Missing or invalid access token.";
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access', user lacks workspace access, or user lacks write access to crm::general.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Workspace not found.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/files/delete-workspace-picture": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Delete a workspace picture";
+							readonly description: "Deletes `profiles/workspaces/{workspace}/avatar.webp` from S3 when present and clears the picture on the workspace. If the object is already missing, still clears the stored value and returns success with message `Workspace picture already deleted`. Requires workspace access and write access to crm::general.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/WorkspacePictureWorkspaceRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Workspace picture deleted, or already absent and cleared from the workspace.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/DeleteWorkspacePictureSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request payload.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized - Missing or invalid access token.";
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access', user lacks workspace access, or user lacks write access to crm::general.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Workspace not found.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 500: {
+									readonly description: "Failed to delete the workspace picture object.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
 					readonly "/chat/start": {
 						readonly post: {
 							readonly tags: readonly [
@@ -15210,6 +15498,78 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			status: 500;
 		};
 	};
+} & {
+	"/upload-workspace-picture": {
+		$post: {
+			input: {};
+			output: {
+				success: false;
+				error: never;
+			};
+			outputFormat: "json";
+			status: 400;
+		} | {
+			input: {};
+			output: {
+				url: string;
+				fields: {
+					[x: string]: string;
+				};
+				key: string;
+				maxSize: number;
+			};
+			outputFormat: "json";
+			status: import("hono/utils/http-status").ContentfulStatusCode;
+		};
+	};
+} & {
+	"/confirm-workspace-picture": {
+		$post: {
+			input: {};
+			output: {
+				success: true;
+				url: string;
+			};
+			outputFormat: "json";
+			status: import("hono/utils/http-status").ContentfulStatusCode;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400;
+		};
+	};
+} & {
+	"/delete-workspace-picture": {
+		$post: {
+			input: {};
+			output: {
+				success: false;
+				error: never;
+			};
+			outputFormat: "json";
+			status: 400;
+		} | {
+			input: {};
+			output: {
+				success: true;
+				message: string;
+			};
+			outputFormat: "json";
+			status: import("hono/utils/http-status").ContentfulStatusCode;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 500;
+		};
+	};
 }, "/files"> | import("hono/types").MergeSchemaPath<{
 	"/start": {
 		$post: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mestra-dev/contract",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "Types-only Hono AppType contract for the Mestra auth API",
   "type": "module",
   "sideEffects": false,