@mestra-dev/contract 0.0.99 → 0.0.100

package/dist/index.d.ts

@@ -1751,6 +1751,133 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 							};
 						};
+						readonly UploadToCustomerRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"filename",
+								"contentType",
+								"contentLength",
+								"workspace",
+								"customerId"
+							];
+							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: "contract.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.";
+								};
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Workspace identifier.";
+								};
+								readonly customerId: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Customer the file is attached to.";
+								};
+							};
+						};
+						readonly UploadToCustomerSuccess: {
+							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}_customers/{customerId}/{filename}.tmp`).";
+								};
+								readonly maxSize: {
+									readonly type: "integer";
+									readonly description: "Exact requested upload size in bytes.";
+								};
+							};
+						};
+						readonly ConfirmCustomerFileRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"filename",
+								"workspace",
+								"customerId"
+							];
+							readonly properties: {
+								readonly filename: {
+									readonly type: "string";
+									readonly minLength: 1;
+									readonly maxLength: 200;
+									readonly description: "Original file name used for `/files/upload-to-customer`.";
+									readonly example: "contract.pdf";
+								};
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Workspace identifier.";
+								};
+								readonly customerId: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Customer the file is attached to.";
+								};
+							};
+						};
+						readonly DeleteCustomerFileRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"filename",
+								"workspace",
+								"customerId"
+							];
+							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: "contract.pdf";
+								};
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Workspace identifier.";
+								};
+								readonly customerId: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Customer the file is attached to.";
+								};
+							};
+						};
 						readonly UploadToServiceRequest: {
 							readonly type: "object";
 							readonly required: readonly [
@@ -1992,6 +2119,59 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 							};
 						};
+						readonly CustomerFile: {
+							readonly type: "object";
+							readonly required: readonly [
+								"key",
+								"filename",
+								"size",
+								"downloadUrl"
+							];
+							readonly properties: {
+								readonly key: {
+									readonly type: "string";
+									readonly description: "Full S3 object key (`{workspace}_customers/{customerId}/{filename}`).";
+								};
+								readonly filename: {
+									readonly type: "string";
+									readonly description: "File name under `{workspace}_customers/{customerId}/`.";
+								};
+								readonly size: {
+									readonly type: "integer";
+									readonly description: "Object size in bytes.";
+								};
+								readonly lastModified: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+									readonly description: "Last modified timestamp from S3 (ISO string).";
+								};
+								readonly downloadUrl: {
+									readonly type: "string";
+									readonly description: "Presigned GET URL (5-minute expiry).";
+								};
+							};
+						};
+						readonly ListCustomerFilesSuccess: {
+							readonly type: "object";
+							readonly required: readonly [
+								"success",
+								"files"
+							];
+							readonly properties: {
+								readonly success: {
+									readonly type: "boolean";
+									readonly const: true;
+								};
+								readonly files: {
+									readonly type: "array";
+									readonly items: {
+										readonly $ref: "#/components/schemas/CustomerFile";
+									};
+									readonly description: "All non-prefix, non-`.tmp` objects under `{workspace}_customers/{customerId}/`.";
+								};
+							};
+						};
 						readonly UploadProfilePictureRequest: {
 							readonly type: "object";
 							readonly required: readonly [
@@ -2250,6 +2430,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"usedBytes",
 								"filesBytes",
 								"commentsBytes",
+								"customerBytes",
 								"servicesBytes",
 								"limitBytes"
 							];
@@ -2260,7 +2441,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 								readonly usedBytes: {
 									readonly type: "integer";
-									readonly description: "Total finalized storage in bytes (`filesBytes` + `commentsBytes` + `servicesBytes`). Excludes `.tmp` objects.";
+									readonly description: "Total finalized storage in bytes (`filesBytes` + `commentsBytes` + `customerBytes` + `servicesBytes`). Excludes `.tmp` objects.";
 									readonly example: 348320;
 								};
 								readonly filesBytes: {
@@ -2273,6 +2454,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									readonly description: "Finalized comment attachment storage under `{workspace}_comments/`. Excludes `.tmp`.";
 									readonly example: 100000;
 								};
+								readonly customerBytes: {
+									readonly type: "integer";
+									readonly description: "Finalized customer file storage under `{workspace}_customers/`. Excludes `.tmp`.";
+									readonly example: 50000;
+								};
 								readonly servicesBytes: {
 									readonly type: "integer";
 									readonly description: "Finalized service file storage under `{workspace}_services/`. Excludes `.tmp`.";
@@ -12542,7 +12728,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`), 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 description: "Returns finalized storage usage broken down by workspace files (`filesBytes`), comment attachments (`commentsBytes`), customer files (`customerBytes`), 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
 							];
@@ -13375,6 +13561,204 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
+					readonly "/files/upload-to-customer": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Create presigned upload for a customer file";
+							readonly description: "Returns a presigned POST for `{workspace}_customers/{customerId}/{filename}.tmp`. JPEG, PNG, WebP, and PDF files up to 15 MB are supported. The customer must belong to a real-estate workspace. Confirm the upload with `/files/confirm-customer-file`.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/UploadToCustomerRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Presigned customer upload created.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/UploadToCustomerSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid payload or unsupported workspace category.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Real-estate customer not found.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/files/confirm-customer-file": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Confirm a customer file upload";
+							readonly description: "Validates and promotes `{workspace}_customers/{customerId}/{filename}.tmp` to its finalized key. Confirmed bytes contribute to `customerBytes`.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/ConfirmCustomerFileRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Customer file confirmed.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ConfirmFileSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request, missing temporary object, oversized file, or invalid file type.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/files/download-from-customer/{workspace}/{customerId}": {
+						readonly get: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "List files for a customer";
+							readonly description: "Lists finalized objects under `{workspace}_customers/{customerId}/`, each with a 5-minute presigned download URL. Requires workspace access and read access to crm::customers.";
+							readonly security: readonly [
+								never
+							];
+							readonly parameters: readonly [
+								{
+									readonly name: "workspace";
+									readonly in: "path";
+									readonly required: true;
+									readonly schema: {
+										readonly type: "string";
+										readonly format: "uuid";
+									};
+									readonly description: "Workspace identifier.";
+								},
+								{
+									readonly name: "customerId";
+									readonly in: "path";
+									readonly required: true;
+									readonly schema: {
+										readonly type: "string";
+										readonly format: "uuid";
+									};
+									readonly description: "Customer identifier.";
+								}
+							];
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Customer files listed.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ListCustomerFilesSuccess";
+											};
+										};
+									};
+								};
+								readonly 403: {
+									readonly description: "Workspace or customer read access is missing.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/files/delete-customer-file": {
+						readonly post: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Delete a customer file";
+							readonly description: "Deletes `{workspace}_customers/{customerId}/{filename}`. Requires workspace access, write access to crm::customers, and billing access.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/DeleteCustomerFileRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Customer file deleted.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/DeleteFileSuccess";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "File not found.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/DeleteFileFailure";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
 					readonly "/files/delete-comment-file": {
 						readonly post: {
 							readonly tags: readonly [
@@ -16394,18 +16778,18 @@ declare const routes: import("hono/hono-base").HonoBase<{
 		} | {
 			input: {};
 			output: {
-				success: true;
+				success: false;
+				error: string;
 			};
 			outputFormat: "json";
-			status: 200;
+			status: 400;
 		} | {
 			input: {};
 			output: {
-				success: false;
-				error: string;
+				success: true;
 			};
 			outputFormat: "json";
-			status: 400;
+			status: 200;
 		};
 	};
 } & {
@@ -20377,6 +20761,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				usedBytes: number;
 				filesBytes: number;
 				commentsBytes: number;
+				customerBytes: number;
 				servicesBytes: number;
 				limitBytes: number | null;
 			};
@@ -20908,6 +21293,122 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			status: import("hono/utils/http-status").ContentfulStatusCode;
 		};
 	};
+} & {
+	"/upload-to-customer": {
+		$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-customer-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;
+		};
+	};
+} & {
+	"/download-from-customer/:workspace/:customerId": {
+		$get: {
+			input: {
+				param: {
+					workspace: string;
+				} & {
+					customerId: string;
+				};
+			};
+			output: {
+				success: true;
+				files: {
+					key: string;
+					filename: string;
+					size: number;
+					lastModified: string | null;
+					downloadUrl: string;
+				}[];
+			};
+			outputFormat: "json";
+			status: import("hono/utils/http-status").ContentfulStatusCode;
+		};
+	};
+} & {
+	"/delete-customer-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.99",
+  "version": "0.0.100",
   "description": "Types-only Hono AppType contract for the Mestra auth API",
   "type": "module",
   "sideEffects": false,