@mestra-dev/contract 0.0.86 → 0.0.88

package/dist/index.d.ts

@@ -1751,6 +1751,135 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 							};
 						};
+						readonly UploadToServiceRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"filename",
+								"contentType",
+								"contentLength",
+								"workspace",
+								"serviceId"
+							];
+							readonly properties: {
+								readonly filename: {
+									readonly type: "string";
+									readonly minLength: 1;
+									readonly maxLength: 200;
+									readonly description: "Safe file name (no path separators, not `.tmp`).";
+									readonly example: "floor-plan.pdf";
+								};
+								readonly contentType: {
+									readonly $ref: "#/components/schemas/FileContentType";
+								};
+								readonly contentLength: {
+									readonly type: "integer";
+									readonly minimum: 1;
+									readonly maximum: 15728640;
+									readonly description: "Exact file byte length. The S3 upload policy rejects a different size.";
+								};
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Workspace identifier.";
+								};
+								readonly serviceId: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Service the file is attached to.";
+								};
+							};
+						};
+						readonly UploadToServiceSuccess: {
+							readonly type: "object";
+							readonly required: readonly [
+								"success",
+								"url",
+								"fields",
+								"key",
+								"maxSize"
+							];
+							readonly properties: {
+								readonly success: {
+									readonly type: "boolean";
+									readonly const: true;
+								};
+								readonly url: {
+									readonly type: "string";
+									readonly description: "S3 presigned POST URL.";
+								};
+								readonly fields: {
+									readonly type: "object";
+									readonly additionalProperties: {
+										readonly type: "string";
+									};
+									readonly description: "Form fields to include in the multipart upload POST.";
+								};
+								readonly key: {
+									readonly type: "string";
+									readonly description: "Temporary S3 object key (`{workspace}_services/{serviceId}/{filename}.tmp`). Call `/files/confirm-service-file` after upload.";
+									readonly example: "550e8400-e29b-41d4-a716-446655440000_services/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/floor-plan.pdf.tmp";
+								};
+								readonly maxSize: {
+									readonly type: "integer";
+									readonly description: "Exact requested upload size in bytes; it cannot exceed 15 MB.";
+									readonly example: 15728640;
+								};
+							};
+						};
+						readonly ConfirmServiceFileRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"filename",
+								"workspace",
+								"serviceId"
+							];
+							readonly properties: {
+								readonly filename: {
+									readonly type: "string";
+									readonly minLength: 1;
+									readonly maxLength: 200;
+									readonly description: "Original file name used for `/files/upload-to-service` (without the `.tmp` suffix).";
+									readonly example: "floor-plan.pdf";
+								};
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Workspace identifier.";
+								};
+								readonly serviceId: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Service the file is attached to.";
+								};
+							};
+						};
+						readonly DeleteServiceFileRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"filename",
+								"workspace",
+								"serviceId"
+							];
+							readonly properties: {
+								readonly filename: {
+									readonly type: "string";
+									readonly minLength: 1;
+									readonly maxLength: 200;
+									readonly description: "Safe file name (no path separators, not `.tmp`).";
+									readonly example: "floor-plan.pdf";
+								};
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Workspace identifier.";
+								};
+								readonly serviceId: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Service the file is attached to.";
+								};
+							};
+						};
 						readonly TaskCommentFile: {
 							readonly type: "object";
 							readonly required: readonly [
@@ -2068,6 +2197,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"usedBytes",
 								"filesBytes",
 								"commentsBytes",
+								"servicesBytes",
 								"limitBytes"
 							];
 							readonly properties: {
@@ -2077,7 +2207,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 								readonly usedBytes: {
 									readonly type: "integer";
-									readonly description: "Total finalized storage in bytes (`filesBytes` + `commentsBytes`). Excludes `.tmp` objects.";
+									readonly description: "Total finalized storage in bytes (`filesBytes` + `commentsBytes` + `servicesBytes`). Excludes `.tmp` objects.";
 									readonly example: 348320;
 								};
 								readonly filesBytes: {
@@ -2090,6 +2220,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									readonly description: "Finalized comment attachment storage under `{workspace}_comments/`. Excludes `.tmp`.";
 									readonly example: 100000;
 								};
+								readonly servicesBytes: {
+									readonly type: "integer";
+									readonly description: "Finalized service file storage under `{workspace}_services/`. Excludes `.tmp`.";
+									readonly example: 50000;
+								};
 								readonly limitBytes: {
 									readonly type: "integer";
 									readonly nullable: true;
@@ -11819,7 +11954,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"Files"
 							];
 							readonly summary: "Get workspace storage usage";
-							readonly description: "Returns finalized storage usage broken down by workspace files (`filesBytes`) and comment attachments (`commentsBytes`), plus the combined total and plan limit. Temporary `.tmp` objects are excluded. Requires workspace access and read access to crm::files.";
+							readonly description: "Returns finalized storage usage broken down by workspace files (`filesBytes`), comment attachments (`commentsBytes`), and service files (`servicesBytes`), plus the combined total and plan limit. Temporary `.tmp` objects are excluded. Requires workspace access and read access to crm::files.";
 							readonly security: readonly [
 								never
 							];
@@ -12354,6 +12489,228 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
+					readonly "/files/upload-to-service": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Create presigned upload for a service file";
+							readonly description: "Returns a presigned POST URL and form fields for uploading a file attached to a CRM service. Object key is `{workspace}_services/{serviceId}/{filename}.tmp` (max 15 MB, 5-minute expiry). Accepts JPEG, PNG, WebP, and PDF. After upload, call `/files/confirm-service-file` to validate magic bytes and promote the object. Currently supported for real-estate workspaces; verifies the service belongs to the workspace. Requires active workspace access, write access to crm::services, and an active billing grant.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/UploadToServiceRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Presigned service upload created.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/UploadToServiceSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request payload, unsupported content type, or unsupported workspace category.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized - Missing or invalid access token.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access', user lacks workspace access, user lacks write access to crm::services, or billing access is missing.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Workspace or real-estate service not found.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/files/confirm-service-file": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Confirm a service file upload";
+							readonly description: "Reads the temporary object at `{workspace}_services/{serviceId}/{filename}.tmp`, verifies size (<= 15 MB) and real file type (JPEG, PNG, WebP, or PDF), promotes it to `{workspace}_services/{serviceId}/{filename}`, and deletes the temporary object. Confirmed bytes count toward workspace storage usage (`servicesBytes`). Requires active workspace access, write access to crm::services, and an active billing grant.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/ConfirmServiceFileRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Service file confirmed and promoted.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ConfirmFileSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request payload, missing temp object, oversized file, or invalid file type.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized - Missing or invalid access token.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access', invite not accepted, user lacks workspace access, user lacks write access to crm::services, or billing access is missing.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/files/delete-service-file": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Delete a service file";
+							readonly description: "Deletes the S3 object at `{workspace}_services/{serviceId}/{filename}`. Verifies the object exists before deletion and confirms removal afterward. Requires workspace access, write access to crm::services, and an active billing grant.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/DeleteServiceFileRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Service file deleted successfully.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/DeleteFileSuccess";
+											};
+										};
+									};
+								};
+								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 content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access', user lacks workspace access, user lacks write access to crm::services, or billing access is missing.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "File not found at the given service file key.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/DeleteFileFailure";
+											};
+										};
+									};
+								};
+								readonly 500: {
+									readonly description: "Delete command ran but the object still exists.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/DeleteFileFailure";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
 					readonly "/files/delete-comment-file": {
 						readonly post: {
 							readonly tags: readonly [
@@ -19146,6 +19503,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				usedBytes: number;
 				filesBytes: number;
 				commentsBytes: number;
+				servicesBytes: number;
 				limitBytes: number | null;
 			};
 			outputFormat: "json";
@@ -19560,6 +19918,98 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			status: 500;
 		};
 	};
+} & {
+	"/upload-to-service": {
+		$post: {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 404;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400;
+		} | {
+			input: {};
+			output: {
+				success: true;
+				url: string;
+				fields: {
+					[x: string]: string;
+				};
+				key: string;
+				maxSize: number;
+			};
+			outputFormat: "json";
+			status: import("hono/utils/http-status").ContentfulStatusCode;
+		};
+	};
+} & {
+	"/confirm-service-file": {
+		$post: {
+			input: {};
+			output: {
+				success: true;
+				key: string;
+			};
+			outputFormat: "json";
+			status: import("hono/utils/http-status").ContentfulStatusCode;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400;
+		};
+	};
+} & {
+	"/delete-service-file": {
+		$post: {
+			input: {};
+			output: {
+				success: false;
+				error: never;
+			};
+			outputFormat: "json";
+			status: 400;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				message: string;
+				key: string;
+			};
+			outputFormat: "json";
+			status: 404;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				message: string;
+				key: string;
+			};
+			outputFormat: "json";
+			status: 500;
+		} | {
+			input: {};
+			output: {
+				success: true;
+				message: string;
+				key: string;
+			};
+			outputFormat: "json";
+			status: import("hono/utils/http-status").ContentfulStatusCode;
+		};
+	};
 }, "/files"> | import("hono/types").MergeSchemaPath<{
 	"/start": {
 		$post: {

package/package.json

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