@mestra-dev/contract 0.0.98 → 0.0.99

package/dist/index.d.ts

@@ -86,7 +86,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					},
 					{
 						readonly name: "Customers";
-						readonly description: "Category-specific customer create. Real-estate workspaces persist leads on customer_real_estates. List, get, update, delete, and get-tasks are not currently exposed.";
+						readonly description: "Category-specific customer CRUD. Real-estate workspaces persist leads on customer_real_estates.";
 					},
 					{
 						readonly name: "Events";
@@ -9247,6 +9247,555 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
+					readonly "/customers/update": {
+						readonly post: {
+							readonly tags: readonly [
+								"Customers"
+							];
+							readonly summary: "Update a customer";
+							readonly description: "Partially updates a category-specific customer in the specified workspace. Real-estate workspaces update only the provided lead fields on customer_real_estates. Requires workspace access, write access to crm::customers, and billing access for customers.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly type: "object";
+											readonly required: readonly [
+												"workspace",
+												"customerId"
+											];
+											readonly properties: {
+												readonly workspace: {
+													readonly type: "string";
+													readonly format: "uuid";
+													readonly description: "Workspace identifier where the customer belongs.";
+												};
+												readonly customerId: {
+													readonly type: "string";
+													readonly format: "uuid";
+													readonly description: "Customer identifier to update.";
+												};
+												readonly name: {
+													readonly type: "string";
+												};
+												readonly type: {
+													readonly type: "string";
+													readonly enum: readonly [
+														"buyer",
+														"seller",
+														"tenant",
+														"landlord",
+														"investor",
+														"agent"
+													];
+												};
+												readonly companyName: {
+													readonly type: "string";
+												};
+												readonly phone: {
+													readonly type: "string";
+													readonly description: "E.164 phone number.";
+												};
+												readonly telegram: {
+													readonly type: "string";
+												};
+												readonly whatsapp: {
+													readonly type: "string";
+													readonly description: "E.164 WhatsApp number.";
+												};
+												readonly email: {
+													readonly type: "string";
+													readonly format: "email";
+												};
+												readonly leadSource: {
+													readonly type: "string";
+													readonly enum: readonly [
+														"cian",
+														"avito",
+														"vk",
+														"yandex",
+														"website",
+														"referral",
+														"walk_in"
+													];
+												};
+												readonly budgetMin: {
+													readonly type: "number";
+													readonly minimum: 0;
+												};
+												readonly budgetMax: {
+													readonly type: "number";
+													readonly minimum: 0;
+												};
+												readonly inHandBudget: {
+													readonly type: "number";
+													readonly minimum: 0;
+												};
+												readonly installmentBudget: {
+													readonly type: "number";
+													readonly minimum: 0;
+												};
+												readonly minArea: {
+													readonly type: "number";
+													readonly minimum: 0;
+												};
+												readonly maxArea: {
+													readonly type: "number";
+													readonly minimum: 0;
+												};
+												readonly roomsCount: {
+													readonly type: "integer";
+													readonly minimum: 0;
+												};
+												readonly preferredDistricts: {
+													readonly type: "array";
+													readonly items: {
+														readonly type: "string";
+													};
+												};
+												readonly propertyType: {
+													readonly type: "string";
+												};
+												readonly maxMetroDistance: {
+													readonly type: "number";
+													readonly minimum: 0;
+												};
+												readonly dealStatus: {
+													readonly type: "string";
+													readonly enum: readonly [
+														"just_browsing",
+														"serious_buyer",
+														"mortgage_approved",
+														"signed_contract",
+														"closed_deal"
+													];
+												};
+												readonly preferredPaymentMethod: {
+													readonly type: "string";
+													readonly enum: readonly [
+														"full_payment",
+														"mortgage",
+														"installment"
+													];
+												};
+												readonly childrenCount: {
+													readonly type: "integer";
+													readonly minimum: 0;
+												};
+												readonly hasPets: {
+													readonly type: "boolean";
+												};
+												readonly carsCount: {
+													readonly type: "integer";
+													readonly minimum: 0;
+												};
+												readonly birthDate: {
+													readonly type: "string";
+													readonly format: "date-time";
+												};
+												readonly notes: {
+													readonly type: "string";
+												};
+											};
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Customer updated successfully.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/UpdateCustomerSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request payload or unsupported workspace category.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Customer or workspace not found.";
+									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, write access to crm::customers, or billing access for customers.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/customers/get/{workspace}/{customerId}": {
+						readonly get: {
+							readonly tags: readonly [
+								"Customers"
+							];
+							readonly summary: "Get a customer by ID";
+							readonly description: "Returns a single customer by ID within the workspace. Real-estate workspaces read from customer_real_estates. Requires workspace access and read access to crm::customers resource.";
+							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 fetched successfully.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/GetCustomerSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Unsupported workspace category.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Customer or workspace not found.";
+									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, or user lacks read access to crm::customers resource.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/customers/list/{workspace}": {
+						readonly get: {
+							readonly tags: readonly [
+								"Customers"
+							];
+							readonly summary: "List customers in workspace";
+							readonly description: "Returns all customers in the specified workspace. Real-estate workspaces list leads from customer_real_estates. Requires workspace access and read access to crm::customers resource.";
+							readonly security: readonly [
+								never
+							];
+							readonly parameters: readonly [
+								{
+									readonly name: "workspace";
+									readonly in: "path";
+									readonly required: true;
+									readonly description: "Workspace identifier where customers belong.";
+									readonly schema: {
+										readonly type: "string";
+										readonly format: "uuid";
+									};
+								}
+							];
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Customers fetched successfully.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ListCustomersSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Unsupported workspace category.";
+									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 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, or user lacks read access to crm::customers resource.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/customers/delete": {
+						readonly post: {
+							readonly tags: readonly [
+								"Customers"
+							];
+							readonly summary: "Delete a customer";
+							readonly description: "Deletes a customer in the specified workspace. Real-estate workspaces remove a lead from customer_real_estates. Requires workspace access and write access to crm::customers resource.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly type: "object";
+											readonly required: readonly [
+												"customerId",
+												"workspace"
+											];
+											readonly properties: {
+												readonly customerId: {
+													readonly type: "string";
+													readonly format: "uuid";
+													readonly description: "Customer identifier.";
+												};
+												readonly workspace: {
+													readonly type: "string";
+													readonly format: "uuid";
+													readonly description: "Workspace identifier.";
+												};
+											};
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Customer deleted successfully.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/SimpleSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request payload or unsupported workspace category.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Customer or workspace not found.";
+									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, or user lacks write access to crm::customers resource.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/customers/get-tasks/{workspace}/{customerId}": {
+						readonly get: {
+							readonly tags: readonly [
+								"Customers"
+							];
+							readonly summary: "List tasks for a customer";
+							readonly description: "Returns tasks linked to the specified customer in the workspace. Requires workspace access and read access to crm::tasks resource.";
+							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: "Tasks fetched successfully.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ListTasksSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Unsupported workspace category.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Customer or workspace not found.";
+									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, or user lacks read access to crm::tasks resource.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
 					readonly "/services/create": {
 						readonly post: {
 							readonly tags: readonly [
@@ -15683,6 +16232,18 @@ declare const routes: import("hono/hono-base").HonoBase<{
 } & {
 	"/list/:workspace": {
 		$get: {
+			input: {
+				param: {
+					workspace: string;
+				};
+			};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 404;
+		} | {
 			input: {
 				param: {
 					workspace: string;
@@ -15698,22 +16259,47 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					created_at: string;
 					id: string;
 					workspaceId: string;
-					name: string;
-					email: string | null;
-					website: string | null;
 					type: string | null;
-					description: string | null;
-					active: boolean | null;
+					name: string;
+					companyName: string | null;
 					phone: string | null;
-					companyPhone: string | null;
-					companyAddress: string | null;
-					address: string | null;
+					telegram: string | null;
+					whatsapp: string | null;
+					email: string | null;
+					leadSource: string | null;
+					budgetMin: number | null;
+					budgetMax: number | null;
+					inHandBudget: number | null;
+					installmentBudget: number | null;
+					minArea: number | null;
+					maxArea: number | null;
+					roomsCount: number | null;
+					preferredDistricts: string[] | null;
+					propertyType: string | null;
+					maxMetroDistance: number | null;
+					dealStatus: string | null;
+					preferredPaymentMethod: string | null;
+					childrenCount: number | null;
+					hasPets: boolean | null;
+					carsCount: number | null;
 					birthDate: string | null;
-					utmSource: string | null;
+					notes: string | null;
 				}[];
 			};
 			outputFormat: "json";
 			status: 200;
+		} | {
+			input: {
+				param: {
+					workspace: string;
+				};
+			};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400;
 		};
 	};
 } & {
@@ -15750,22 +16336,49 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					created_at: string;
 					id: string;
 					workspaceId: string;
-					name: string;
-					email: string | null;
-					website: string | null;
 					type: string | null;
-					description: string | null;
-					active: boolean | null;
+					name: string;
+					companyName: string | null;
 					phone: string | null;
-					companyPhone: string | null;
-					companyAddress: string | null;
-					address: string | null;
+					telegram: string | null;
+					whatsapp: string | null;
+					email: string | null;
+					leadSource: string | null;
+					budgetMin: number | null;
+					budgetMax: number | null;
+					inHandBudget: number | null;
+					installmentBudget: number | null;
+					minArea: number | null;
+					maxArea: number | null;
+					roomsCount: number | null;
+					preferredDistricts: string[] | null;
+					propertyType: string | null;
+					maxMetroDistance: number | null;
+					dealStatus: string | null;
+					preferredPaymentMethod: string | null;
+					childrenCount: number | null;
+					hasPets: boolean | null;
+					carsCount: number | null;
 					birthDate: string | null;
-					utmSource: string | null;
-				}[];
+					notes: string | null;
+				};
 			};
 			outputFormat: "json";
 			status: 200;
+		} | {
+			input: {
+				param: {
+					workspace: string;
+				} & {
+					customerId: string;
+				};
+			};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400;
 		};
 	};
 } & {
@@ -15774,25 +16387,25 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			input: {};
 			output: {
 				success: false;
-				error: never;
+				error: string;
 			};
 			outputFormat: "json";
-			status: 400;
+			status: 404;
 		} | {
 			input: {};
 			output: {
-				success: false;
-				error: string;
+				success: true;
 			};
 			outputFormat: "json";
-			status: 404;
+			status: 200;
 		} | {
 			input: {};
 			output: {
-				success: true;
+				success: false;
+				error: string;
 			};
 			outputFormat: "json";
-			status: 200;
+			status: 400;
 		};
 	};
 } & {
@@ -15801,10 +16414,10 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			input: {};
 			output: {
 				success: false;
-				error: never;
+				error: string;
 			};
 			outputFormat: "json";
-			status: 400;
+			status: 404;
 		} | {
 			input: {};
 			output: {
@@ -15812,7 +16425,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				error: string;
 			};
 			outputFormat: "json";
-			status: 404;
+			status: 400;
 		} | {
 			input: {};
 			output: {
@@ -15825,19 +16438,32 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					created_at: string;
 					id: string;
 					workspaceId: string;
-					name: string;
-					email: string | null;
-					website: string | null;
 					type: string | null;
-					description: string | null;
-					active: boolean | null;
+					name: string;
+					companyName: string | null;
 					phone: string | null;
-					companyPhone: string | null;
-					companyAddress: string | null;
-					address: string | null;
+					telegram: string | null;
+					whatsapp: string | null;
+					email: string | null;
+					leadSource: string | null;
+					budgetMin: number | null;
+					budgetMax: number | null;
+					inHandBudget: number | null;
+					installmentBudget: number | null;
+					minArea: number | null;
+					maxArea: number | null;
+					roomsCount: number | null;
+					preferredDistricts: string[] | null;
+					propertyType: string | null;
+					maxMetroDistance: number | null;
+					dealStatus: string | null;
+					preferredPaymentMethod: string | null;
+					childrenCount: number | null;
+					hasPets: boolean | null;
+					carsCount: number | null;
 					birthDate: string | null;
-					utmSource: string | null;
-				};
+					notes: string | null;
+				}[];
 			};
 			outputFormat: "json";
 			status: 200;
@@ -15846,6 +16472,20 @@ declare const routes: import("hono/hono-base").HonoBase<{
 } & {
 	"/get-tasks/:workspace/:customerId": {
 		$get: {
+			input: {
+				param: {
+					workspace: string;
+				} & {
+					customerId: string;
+				};
+			};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 404;
+		} | {
 			input: {
 				param: {
 					workspace: string;
@@ -15870,6 +16510,20 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			};
 			outputFormat: "json";
 			status: 200;
+		} | {
+			input: {
+				param: {
+					workspace: string;
+				} & {
+					customerId: string;
+				};
+			};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400;
 		};
 	};
 }, "/customers"> | import("hono/types").MergeSchemaPath<{

package/package.json

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