@mestra-dev/contract 0.0.32 → 0.0.33

package/dist/index.d.ts

@@ -27,7 +27,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				readonly info: {
 					readonly title: "Auth Service API";
 					readonly version: "1.5.4";
-					readonly description: "OpenAPI specification for the Auth, Integrations, Workspace, Tasks, Templates, Tags, Comments, Assignees, Chat, Events, Billings, Files, and Notifications endpoints exposed by the k3-core platform. Unhandled HTTPException and unexpected errors are normalized by the global error handler to `{ success: false, error: string }` (status preserved for HTTPException; 500 otherwise).";
+					readonly description: "OpenAPI specification for the Auth, Integrations, Workspace, Payments, Tasks, Templates, Tags, Comments, Assignees, Chat, Events, Billings, Files, and Notifications endpoints exposed by the k3-core platform. Unhandled HTTPException and unexpected errors are normalized by the global error handler to `{ success: false, error: string }` (status preserved for HTTPException; 500 otherwise).";
 				};
 				readonly servers: readonly [
 					{
@@ -56,6 +56,10 @@ declare const routes: import("hono/hono-base").HonoBase<{
 						readonly name: "Workspace";
 						readonly description: "Workspace management endpoints";
 					},
+					{
+						readonly name: "Payments";
+						readonly description: "Workspace subscription invoices, YooKassa checkout, renewals, and upgrades.";
+					},
 					{
 						readonly name: "Tasks";
 						readonly description: "Task management endpoints";
@@ -119,6 +123,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							readonly bearerFormat: "JWT";
 							readonly description: "Long-lived refresh token (iss: refresh). Claims include email and userId.";
 						};
+						readonly billingAdminToken: {
+							readonly type: "http";
+							readonly scheme: "bearer";
+							readonly description: "Operations-only token configured as BILLING_ADMIN_TOKEN. Never expose this token to a browser client.";
+						};
 					};
 					readonly schemas: {
 						readonly OtpRequestSuccess: {
@@ -348,7 +357,10 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							readonly required: readonly [
 								"success",
 								"workspace",
-								"name"
+								"name",
+								"invoiceId",
+								"subscriptionStatus",
+								"bonusWorkspace"
 							];
 							readonly properties: {
 								readonly success: {
@@ -362,6 +374,24 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								readonly name: {
 									readonly type: "string";
 								};
+								readonly invoiceId: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly nullable: true;
+									readonly description: "Pending first-payment invoice for Economy, Standard, or Professional. Null for Free trial and complimentary Professional workspace.";
+								};
+								readonly subscriptionStatus: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"trialing",
+										"pending",
+										"active"
+									];
+								};
+								readonly bonusWorkspace: {
+									readonly type: "boolean";
+									readonly description: "True only when this is the one complimentary Professional workspace linked to an active paid Professional workspace.";
+								};
 							};
 						};
 						readonly ErrorResponse: {
@@ -370,14 +400,14 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"success",
 								"error"
 							];
-							readonly description: "Standard API error body. Route handlers and the global HTTPException handler return this shape. Validation failures may put Zod details in `error` instead of a string.";
+							readonly description: "Standard API error body. Route handlers and the global HTTPException handler return this shape. Validation failures may put Valibot details in `error` instead of a string.";
 							readonly properties: {
 								readonly success: {
 									readonly type: "boolean";
 									readonly const: false;
 								};
 								readonly error: {
-									readonly description: "Human-readable message, or Zod validation details for invalid payloads.";
+									readonly description: "Human-readable message, or Valibot validation details for invalid payloads.";
 									readonly oneOf: readonly [
 										{
 											readonly type: "string";
@@ -813,12 +843,9 @@ declare const routes: import("hono/hono-base").HonoBase<{
 						};
 						readonly WorkspaceMaxCollaborators: {
 							readonly type: "integer";
-							readonly enum: readonly [
-								1,
-								20,
-								50
-							];
-							readonly description: "Allowed collaborator cap for the workspace plan tier.";
+							readonly minimum: 1;
+							readonly maximum: 10000;
+							readonly description: "Number of billable seats reserved for the workspace.";
 						};
 						readonly WorkspaceResourceAccess: {
 							readonly type: "object";
@@ -1083,7 +1110,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							readonly type: "object";
 							readonly required: readonly [
 								"success",
-								"crm",
+								"plans",
 								"price"
 							];
 							readonly properties: {
@@ -1091,18 +1118,30 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									readonly type: "boolean";
 									readonly const: true;
 								};
-								readonly crm: {
+								readonly plans: {
 									readonly type: "array";
-									readonly description: "Available CRM pricing plans.";
 									readonly items: {
-										readonly $ref: "#/components/schemas/WorkspaceCalculatorPlan";
+										readonly $ref: "#/components/schemas/WorkspacePlan";
 									};
 								};
 								readonly price: {
-									readonly type: "number";
-									readonly format: "float";
-									readonly nullable: true;
-									readonly description: "Calculated price for the given maxCollaborators. Null when no plan matches.";
+									readonly type: "array";
+									readonly items: {
+										readonly type: "object";
+										readonly required: readonly [
+											"code",
+											"amountKopecks"
+										];
+										readonly properties: {
+											readonly code: {
+												readonly type: "string";
+											};
+											readonly amountKopecks: {
+												readonly type: "integer";
+												readonly description: "Monthly total for the requested seat count, in kopecks.";
+											};
+										};
+									};
 								};
 							};
 						};
@@ -1404,6 +1443,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							readonly required: readonly [
 								"filename",
 								"contentType",
+								"contentLength",
 								"workspace"
 							];
 							readonly properties: {
@@ -1417,6 +1457,12 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								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";
@@ -1490,7 +1536,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 								readonly maxSize: {
 									readonly type: "integer";
-									readonly description: "Maximum allowed upload size in bytes (15 MB).";
+									readonly description: "Exact requested upload size in bytes; it cannot exceed 15 MB.";
 									readonly example: 15728640;
 								};
 							};
@@ -1500,6 +1546,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							readonly required: readonly [
 								"filename",
 								"contentType",
+								"contentLength",
 								"workspace",
 								"taskId",
 								"commentId"
@@ -1515,6 +1562,12 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								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";
@@ -1564,7 +1617,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 								readonly maxSize: {
 									readonly type: "integer";
-									readonly description: "Maximum allowed upload size in bytes (15 MB).";
+									readonly description: "Exact requested upload size in bytes; it cannot exceed 15 MB.";
 									readonly example: 15728640;
 								};
 							};
@@ -3017,6 +3070,356 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 							};
 						};
+						readonly BillingInterval: {
+							readonly type: "string";
+							readonly enum: readonly [
+								"monthly",
+								"yearly"
+							];
+							readonly description: "Yearly prices represent 10 monthly payments (two months free).";
+						};
+						readonly BillingCycles: {
+							readonly type: "integer";
+							readonly minimum: 1;
+							readonly maximum: 11;
+							readonly description: "Number of prepaid billing units. Monthly supports 1\u201311 months; yearly supports 1\u20132 years.";
+						};
+						readonly WorkspacePlan: {
+							readonly type: "object";
+							readonly required: readonly [
+								"id",
+								"code",
+								"name",
+								"kind",
+								"sortOrder",
+								"prices",
+								"limits"
+							];
+							readonly properties: {
+								readonly id: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly code: {
+									readonly type: "string";
+									readonly example: "economy";
+								};
+								readonly name: {
+									readonly type: "string";
+									readonly example: "Economy";
+								};
+								readonly kind: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"trial",
+										"public",
+										"enterprise"
+									];
+								};
+								readonly sortOrder: {
+									readonly type: "integer";
+								};
+								readonly prices: {
+									readonly type: "object";
+									readonly additionalProperties: {
+										readonly type: "integer";
+									};
+									readonly description: "Price per seat in kopecks, keyed by billing interval. Free trial has no prices.";
+									readonly example: {
+										readonly monthly: 99000;
+										readonly yearly: 990000;
+									};
+								};
+								readonly limits: {
+									readonly type: "object";
+									readonly additionalProperties: {
+										readonly type: "integer";
+										readonly format: "int64";
+									};
+									readonly description: "Included limits keyed by tasks, comments, customers, services, and storage_bytes.";
+								};
+							};
+						};
+						readonly WorkspaceSubscription: {
+							readonly type: "object";
+							readonly required: readonly [
+								"id",
+								"status",
+								"seats",
+								"planId",
+								"planCode",
+								"planName"
+							];
+							readonly properties: {
+								readonly id: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly status: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"trialing",
+										"pending",
+										"active",
+										"past_due",
+										"frozen",
+										"canceled"
+									];
+								};
+								readonly seats: {
+									readonly type: "integer";
+								};
+								readonly interval: {
+									readonly $ref: "#/components/schemas/BillingInterval";
+									readonly nullable: true;
+								};
+								readonly billingCycles: {
+									readonly $ref: "#/components/schemas/BillingCycles";
+								};
+								readonly trialEndsAt: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+								};
+								readonly periodEnd: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+								};
+								readonly planId: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly planCode: {
+									readonly type: "string";
+								};
+								readonly planName: {
+									readonly type: "string";
+								};
+							};
+						};
+						readonly BillingInvoice: {
+							readonly type: "object";
+							readonly required: readonly [
+								"id",
+								"workspaceId",
+								"planId",
+								"status",
+								"kind",
+								"seats",
+								"interval",
+								"billingCycles",
+								"amountKopecks",
+								"currency"
+							];
+							readonly properties: {
+								readonly id: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly workspaceId: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly planId: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly status: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"pending",
+										"paid",
+										"canceled",
+										"failed"
+									];
+								};
+								readonly kind: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"initial",
+										"upgrade",
+										"renewal"
+									];
+								};
+								readonly seats: {
+									readonly type: "integer";
+								};
+								readonly interval: {
+									readonly $ref: "#/components/schemas/BillingInterval";
+								};
+								readonly billingCycles: {
+									readonly $ref: "#/components/schemas/BillingCycles";
+								};
+								readonly amountKopecks: {
+									readonly type: "integer";
+									readonly description: "Full invoice amount in kopecks.";
+								};
+								readonly currency: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"RUB"
+									];
+								};
+								readonly paymentUrl: {
+									readonly type: "string";
+									readonly format: "uri";
+									readonly nullable: true;
+								};
+								readonly paidAt: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+								};
+							};
+						};
+						readonly BillingRecommendations: {
+							readonly type: "object";
+							readonly required: readonly [
+								"usage",
+								"plans"
+							];
+							readonly description: "Returned only for a frozen Free-trial workspace.";
+							readonly properties: {
+								readonly usage: {
+									readonly type: "object";
+									readonly required: readonly [
+										"tasks",
+										"comments",
+										"customers",
+										"services",
+										"seats",
+										"storage_bytes"
+									];
+									readonly additionalProperties: {
+										readonly type: "integer";
+										readonly format: "int64";
+									};
+								};
+								readonly plans: {
+									readonly type: "array";
+									readonly items: {
+										readonly allOf: readonly [
+											{
+												readonly $ref: "#/components/schemas/WorkspacePlan";
+											},
+											{
+												readonly type: "object";
+												readonly required: readonly [
+													"fits",
+													"overLimit"
+												];
+												readonly properties: {
+													readonly fits: {
+														readonly type: "boolean";
+													};
+													readonly overLimit: {
+														readonly type: "array";
+														readonly items: {
+															readonly type: "string";
+														};
+													};
+												};
+											}
+										];
+									};
+								};
+							};
+						};
+						readonly UpgradeWorkspacePlanRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"workspace"
+							];
+							readonly properties: {
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly plan: {
+									readonly type: "string";
+									readonly description: "Target public or workspace-granted Enterprise plan code. Required when choosing a plan.";
+								};
+								readonly seats: {
+									readonly $ref: "#/components/schemas/WorkspaceMaxCollaborators";
+								};
+								readonly billingInterval: {
+									readonly $ref: "#/components/schemas/BillingInterval";
+									readonly description: "Required when converting a frozen Free trial to a paid plan.";
+								};
+								readonly billingCycles: {
+									readonly $ref: "#/components/schemas/BillingCycles";
+									readonly description: "Prepaid months (1\u201311) or years (1\u20132). Defaults to 1.";
+								};
+							};
+						};
+						readonly CreateEnterprisePlanRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"workspace",
+								"email",
+								"code",
+								"name",
+								"monthlyAmountKopecks",
+								"yearlyAmountKopecks",
+								"limits"
+							];
+							readonly properties: {
+								readonly workspace: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly email: {
+									readonly type: "string";
+									readonly format: "email";
+									readonly description: "Email of the workspace owner who may see and select this private plan.";
+								};
+								readonly code: {
+									readonly type: "string";
+									readonly pattern: "^[a-z0-9_-]+$";
+									readonly example: "enterprise-acme";
+								};
+								readonly name: {
+									readonly type: "string";
+									readonly example: "Acme Enterprise";
+								};
+								readonly monthlyAmountKopecks: {
+									readonly type: "integer";
+									readonly minimum: 1;
+								};
+								readonly yearlyAmountKopecks: {
+									readonly type: "integer";
+									readonly minimum: 1;
+								};
+								readonly limits: {
+									readonly type: "array";
+									readonly minItems: 1;
+									readonly items: {
+										readonly type: "object";
+										readonly required: readonly [
+											"metric",
+											"limitValue"
+										];
+										readonly properties: {
+											readonly metric: {
+												readonly type: "string";
+												readonly enum: readonly [
+													"tasks",
+													"comments",
+													"customers",
+													"services",
+													"storage_bytes"
+												];
+											};
+											readonly limitValue: {
+												readonly type: "integer";
+												readonly minimum: 1;
+											};
+										};
+									};
+								};
+							};
+						};
 					};
 				};
 				readonly paths: {
@@ -4481,7 +4884,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"Workspace"
 							];
 							readonly summary: "Create a new workspace";
-							readonly description: "Creates a workspace and assigns the authenticated user as owner with default CRM write policies (general, tasks, customers, services, analytics, calendar, chats). Optional category selects the workspace vertical (defaults to general).";
+							readonly description: "Creates a workspace and its billing subscription atomically. Free starts a 15-day trial. Economy, Standard, and Professional create a pending invoice; use the returned invoiceId to start YooKassa checkout. Professional may create one complimentary workspace for an owner with an active paid Professional workspace.";
 							readonly security: readonly [
 								never
 							];
@@ -4506,6 +4909,24 @@ declare const routes: import("hono/hono-base").HonoBase<{
 												readonly category: {
 													readonly $ref: "#/components/schemas/WorkspaceCategory";
 												};
+												readonly plan: {
+													readonly type: "string";
+													readonly default: "free";
+													readonly enum: readonly [
+														"free",
+														"economy",
+														"standard",
+														"professional"
+													];
+													readonly description: "Public plan code. Enterprise codes are only available after operations grants them to an existing workspace.";
+												};
+												readonly billingInterval: {
+													readonly $ref: "#/components/schemas/BillingInterval";
+												};
+												readonly billingCycles: {
+													readonly $ref: "#/components/schemas/BillingCycles";
+													readonly description: "Prepaid months (1\u201311) or years (1\u20132). Defaults to 1.";
+												};
 											};
 										};
 									};
@@ -4528,7 +4949,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 400: {
-									readonly description: "Invalid request payload or unpaid workspace limit reached (user already owns the maximum number of workspaces allowed without payment).";
+									readonly description: "Invalid payload, an unavailable plan, or an attempted second Free trial.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -4560,13 +4981,268 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
-					readonly "/workspace/list": {
+					readonly "/workspace/plans": {
 						readonly get: {
 							readonly tags: readonly [
 								"Workspace"
 							];
-							readonly summary: "List workspaces for the authenticated user";
-							readonly description: "Returns workspaces the user collaborates on, each with category, role, billing flags, invitation state, workspace profile picture URL, and the resource grants effective for the caller.";
+							readonly summary: "List public workspace plans";
+							readonly description: "Returns Free, Economy, Standard, and Professional cards. Enterprise is represented by a contact-us CTA and is not a public checkout plan.";
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Public plans fetched.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly type: "object";
+												readonly required: readonly [
+													"success",
+													"plans",
+													"enterprise"
+												];
+												readonly properties: {
+													readonly success: {
+														readonly type: "boolean";
+														readonly const: true;
+													};
+													readonly plans: {
+														readonly type: "array";
+														readonly items: any;
+													};
+													readonly enterprise: {
+														readonly type: "object";
+														readonly required: readonly [
+															"code",
+															"cta"
+														];
+														readonly properties: any;
+													};
+												};
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/workspace/plans/{workspace}": {
+						readonly get: {
+							readonly tags: readonly [
+								"Workspace"
+							];
+							readonly summary: "List plans available to a workspace";
+							readonly description: "Returns public plans plus any private Enterprise plans granted to this workspace.";
+							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 responses: {
+								readonly 200: {
+									readonly description: "Available plans fetched.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly type: "object";
+												readonly required: readonly [
+													"success",
+													"plans"
+												];
+												readonly properties: {
+													readonly success: {
+														readonly type: "boolean";
+														readonly const: true;
+													};
+													readonly plans: {
+														readonly type: "array";
+														readonly items: any;
+													};
+												};
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Workspace not found or caller is not a collaborator.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/workspace/billing/{workspace}": {
+						readonly get: {
+							readonly tags: readonly [
+								"Workspace"
+							];
+							readonly summary: "Get workspace billing state";
+							readonly description: "Owner-only. For a frozen Free trial, includes usage and plan-fit recommendations. Paid workspaces receive subscription and pending-invoice state only.";
+							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 responses: {
+								readonly 200: {
+									readonly description: "Billing state fetched.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly type: "object";
+												readonly required: readonly [
+													"success",
+													"subscription",
+													"pendingInvoice",
+													"recommendations"
+												];
+												readonly properties: {
+													readonly success: {
+														readonly type: "boolean";
+														readonly const: true;
+													};
+													readonly subscription: {
+														readonly allOf: readonly [ /*elided*/
+															any
+														];
+														readonly nullable: true;
+													};
+													readonly pendingInvoice: {
+														readonly allOf: readonly [ /*elided*/
+															any
+														];
+														readonly nullable: true;
+													};
+													readonly recommendations: {
+														readonly allOf: readonly [ /*elided*/
+															any
+														];
+														readonly nullable: true;
+													};
+												};
+											};
+										};
+									};
+								};
+								readonly 403: {
+									readonly description: "Only the workspace owner can view billing.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/workspace/admin/enterprise-plan": {
+						readonly post: {
+							readonly tags: readonly [
+								"Workspace"
+							];
+							readonly summary: "Create and grant a private Enterprise plan";
+							readonly description: "Operations-only endpoint. It creates a plan and grants it to one workspace. Do not call from frontend code or expose BILLING_ADMIN_TOKEN.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/CreateEnterprisePlanRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 201: {
+									readonly description: "Enterprise plan created and granted.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly type: "object";
+												readonly required: readonly [
+													"success",
+													"plan"
+												];
+												readonly properties: {
+													readonly success: {
+														readonly type: "boolean";
+														readonly const: true;
+													};
+													readonly plan: {
+														readonly $ref: "#/components/schemas/WorkspacePlan";
+													};
+												};
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Missing or invalid operations token.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid plan definition or duplicate plan code.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/workspace/list": {
+						readonly get: {
+							readonly tags: readonly [
+								"Workspace"
+							];
+							readonly summary: "List workspaces for the authenticated user";
+							readonly description: "Returns workspaces the user collaborates on, each with category, role, billing flags, invitation state, workspace profile picture URL, and the resource grants effective for the caller.";
 							readonly security: readonly [
 								never
 							];
@@ -4579,8 +5255,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 												readonly type: "object";
 												readonly required: readonly [
 													"success",
-													"workspaces",
-													"unpaidLimit"
+													"workspaces"
 												];
 												readonly properties: {
 													readonly success: {
@@ -4591,11 +5266,6 @@ declare const routes: import("hono/hono-base").HonoBase<{
 														readonly type: "array";
 														readonly items: any;
 													};
-													readonly unpaidLimit: {
-														readonly type: "integer";
-														readonly description: "Configured cap on workspaces a user may own without payment (from UNPAID_WORKSPACE_LIMIT).";
-														readonly example: 3;
-													};
 												};
 											};
 										};
@@ -5266,7 +5936,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"Workspace"
 							];
 							readonly summary: "Update workspace settings";
-							readonly description: "Updates workspace name and/or max collaborators. Only the workspace owner may call this endpoint; requires write access to crm::general. Downgrading max collaborators on a paid plan is ignored; increasing the cap may reset hasPaid.";
+							readonly description: "Updates the workspace name. Only the workspace owner may call this endpoint; requires write access to crm::general. Seat changes must use `/payments/upgrade` so an invoice is created.";
 							readonly security: readonly [
 								never
 							];
@@ -5284,9 +5954,6 @@ declare const routes: import("hono/hono-base").HonoBase<{
 													readonly type: "string";
 													readonly description: "New name for the workspace.";
 												};
-												readonly maxCollaborators: {
-													readonly $ref: "#/components/schemas/WorkspaceMaxCollaborators";
-												};
 												readonly workspace: {
 													readonly type: "string";
 													readonly format: "uuid";
@@ -5335,7 +6002,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 400: {
-									readonly description: "Invalid request payload, neither name nor maxCollaborators provided, or caller is not the workspace owner.";
+									readonly description: "Invalid request payload, missing name, or caller is not the workspace owner. Seat changes are rejected; use /payments/upgrade.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -5576,21 +6243,196 @@ declare const routes: import("hono/hono-base").HonoBase<{
 										readonly type: "string";
 										readonly format: "uuid";
 									};
-								}
-							];
+								}
+							];
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Left the workspace successfully.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/SimpleSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid workspace id, caller is not a collaborator, or caller is the workspace owner.";
+									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' or user lacks workspace access.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 500: {
+									readonly description: "Failed to leave workspace.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/payments/invoice/{invoiceId}/pay": {
+						readonly post: {
+							readonly tags: readonly [
+								"Payments"
+							];
+							readonly summary: "Create or retrieve YooKassa checkout";
+							readonly description: "Workspace owner only. Starts checkout for a pending invoice and returns a redirect URL. Redirect the browser to paymentUrl.";
+							readonly security: readonly [
+								never
+							];
+							readonly parameters: readonly [
+								{
+									readonly name: "invoiceId";
+									readonly in: "path";
+									readonly required: true;
+									readonly schema: {
+										readonly type: "string";
+										readonly format: "uuid";
+									};
+								}
+							];
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Checkout URL ready.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly type: "object";
+												readonly required: readonly [
+													"success",
+													"paymentUrl",
+													"providerPaymentId"
+												];
+												readonly properties: {
+													readonly success: {
+														readonly type: "boolean";
+														readonly const: true;
+													};
+													readonly paymentUrl: {
+														readonly type: "string";
+														readonly format: "uri";
+													};
+													readonly providerPaymentId: {
+														readonly type: "string";
+													};
+												};
+											};
+										};
+									};
+								};
+								readonly 403: {
+									readonly description: "Invoice does not belong to caller.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 404: {
+									readonly description: "Pending invoice not found.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 503: {
+									readonly description: "YooKassa configuration is missing.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/payments/upgrade": {
+						readonly post: {
+							readonly tags: readonly [
+								"Payments"
+							];
+							readonly summary: "Create a plan-change or seat-change invoice";
+							readonly description: "Before the first payment, owners can correct a plan or seat count up or down. After any payment, only a higher plan and/or more seats is accepted. The selected change takes effect only after the new invoice is paid.";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/UpgradeWorkspacePlanRequest";
+										};
+									};
+								};
+							};
 							readonly responses: {
-								readonly 200: {
-									readonly description: "Left the workspace successfully.";
+								readonly 201: {
+									readonly description: "Pending invoice created.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
-												readonly $ref: "#/components/schemas/SimpleSuccess";
+												readonly type: "object";
+												readonly required: readonly [
+													"success",
+													"invoiceId",
+													"invoice"
+												];
+												readonly properties: {
+													readonly success: {
+														readonly type: "boolean";
+														readonly const: true;
+													};
+													readonly invoiceId: {
+														readonly type: "string";
+														readonly format: "uuid";
+													};
+													readonly invoice: {
+														readonly $ref: "#/components/schemas/BillingInvoice";
+													};
+												};
 											};
 										};
 									};
 								};
 								readonly 400: {
-									readonly description: "Invalid workspace id, caller is not a collaborator, or caller is the workspace owner.";
+									readonly description: "Invalid change, no actual change, or disallowed downgrade.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -5599,8 +6441,8 @@ declare const routes: import("hono/hono-base").HonoBase<{
 										};
 									};
 								};
-								readonly 401: {
-									readonly description: "Unauthorized - Missing or invalid access token.";
+								readonly 403: {
+									readonly description: "Plan is not available to this workspace.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -5609,8 +6451,8 @@ declare const routes: import("hono/hono-base").HonoBase<{
 										};
 									};
 								};
-								readonly 403: {
-									readonly description: "Forbidden - Token issuer is not 'access' or user lacks workspace access.";
+								readonly 404: {
+									readonly description: "Workspace not found or caller is not its owner.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -5619,8 +6461,52 @@ declare const routes: import("hono/hono-base").HonoBase<{
 										};
 									};
 								};
-								readonly 500: {
-									readonly description: "Failed to leave workspace.";
+							};
+						};
+					};
+					readonly "/payments/webhook": {
+						readonly post: {
+							readonly tags: readonly [
+								"Payments"
+							];
+							readonly summary: "Receive YooKassa payment event";
+							readonly description: "Server-to-server endpoint for YooKassa only. The core verifies the payment with YooKassa before marking an invoice paid. Frontends must not call this endpoint.";
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly type: "object";
+											readonly required: readonly [
+												"object"
+											];
+											readonly properties: {
+												readonly type: {
+													readonly type: "string";
+													readonly example: "notification";
+												};
+												readonly object: {
+													readonly type: "object";
+													readonly required: readonly [
+														"id",
+														"status"
+													];
+													readonly properties: {
+														readonly id: any;
+														readonly status: any;
+													};
+												};
+											};
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Payment applied or non-success event ignored.";
+								};
+								readonly 400: {
+									readonly description: "Invalid webhook or payment did not succeed.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -11824,6 +12710,103 @@ declare const routes: import("hono/hono-base").HonoBase<{
 		};
 	};
 }, "/auth"> | import("hono/types").MergeSchemaPath<{
+	"/plans": {
+		$get: {
+			input: {};
+			output: {
+				success: true;
+				plans: {
+					id: string;
+					code: string;
+					name: string;
+					kind: string;
+					sortOrder: number;
+					prices: {
+						[x: string]: number;
+					};
+					limits: {
+						[x: string]: number;
+					};
+				}[];
+				enterprise: {
+					code: string;
+					cta: string;
+				};
+			};
+			outputFormat: "json";
+			status: 200;
+		};
+	};
+} & {
+	"/plans/:workspace": {
+		$get: {
+			input: {
+				param: {
+					workspace: string;
+				};
+			};
+			output: {
+				success: true;
+				plans: {
+					id: string;
+					code: string;
+					name: string;
+					kind: string;
+					sortOrder: number;
+					prices: {
+						[x: string]: number;
+					};
+					limits: {
+						[x: string]: number;
+					};
+				}[];
+			};
+			outputFormat: "json";
+			status: 200;
+		};
+	};
+} & {
+	"/admin/enterprise-plan": {
+		$post: {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 401;
+		} | {
+			input: {};
+			output: {
+				success: true;
+				plan: {
+					id: string;
+					created_at: string;
+					name: string;
+					active: boolean;
+					code: string;
+					kind: string;
+					sortOrder: number;
+					publiclyVisible: boolean;
+					updated_at: string | null;
+					deleted_at: string | null;
+					verified_at: string | null;
+					suspended_at: string | null;
+				};
+			};
+			outputFormat: "json";
+			status: 201;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400 | 404;
+		};
+	};
+} & {
 	"/create": {
 		$post: {
 			input: {};
@@ -11832,13 +12815,16 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				error: string;
 			};
 			outputFormat: "json";
-			status: 400;
+			status: 400 | 403 | 404 | 500;
 		} | {
 			input: {};
 			output: {
 				success: true;
-				workspace: any;
-				name: any;
+				workspace: string;
+				name: string;
+				invoiceId: any;
+				subscriptionStatus: any;
+				bonusWorkspace: boolean;
 			};
 			outputFormat: "json";
 			status: 201;
@@ -11866,7 +12852,98 @@ declare const routes: import("hono/hono-base").HonoBase<{
 						action: string;
 					}[];
 				}[];
-				unpaidLimit: number;
+			};
+			outputFormat: "json";
+			status: 200;
+		};
+	};
+} & {
+	"/billing/:workspace": {
+		$get: {
+			input: {
+				param: {
+					workspace: string;
+				};
+			};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 403;
+		} | {
+			input: {
+				param: {
+					workspace: string;
+				};
+			};
+			output: {
+				subscription: null;
+				pendingInvoice: null;
+				recommendations: null;
+				success: true;
+			} | {
+				subscription: {
+					id: string;
+					status: string;
+					seats: number;
+					interval: string | null;
+					billingCycles: number;
+					trialEndsAt: string | null;
+					periodEnd: string | null;
+					planCode: string;
+					planName: string;
+					planId: string;
+				};
+				pendingInvoice: {
+					updated_at: string | null;
+					deleted_at: string | null;
+					verified_at: string | null;
+					suspended_at: string | null;
+					created_at: string;
+					id: string;
+					workspaceId: string;
+					subscriptionId: string;
+					planId: string;
+					status: string;
+					kind: string;
+					seats: number;
+					interval: string;
+					billingCycles: number;
+					amountKopecks: number;
+					currency: string;
+					periodStart: string;
+					periodEnd: string;
+					providerPaymentId: string | null;
+					paymentUrl: string | null;
+					paidAt: string | null;
+				};
+				recommendations: {
+					usage: {
+						tasks: number;
+						comments: number;
+						customers: number;
+						services: number;
+						seats: number;
+						storage_bytes: number;
+					};
+					plans: {
+						fits: boolean;
+						overLimit: string[];
+						id: string;
+						code: string;
+						name: string;
+						kind: string;
+						sortOrder: number;
+						prices: {
+							[x: string]: number;
+						};
+						limits: {
+							[x: string]: number;
+						};
+					}[];
+				} | null;
+				success: true;
 			};
 			outputFormat: "json";
 			status: 200;
@@ -11916,23 +12993,23 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			input: {};
 			output: {
 				success: true;
-				crm: {
-					price: number;
-					maxCollaborators: number;
+				plans: {
+					id: string;
+					code: string;
+					name: string;
+					kind: string;
+					sortOrder: number;
+					prices: {
+						[x: string]: number;
+					};
+					limits: {
+						[x: string]: number;
+					};
 				}[];
-				price: number;
-			};
-			outputFormat: "json";
-			status: 200;
-		} | {
-			input: {};
-			output: {
-				success: true;
-				crm: {
-					price: number;
-					maxCollaborators: number;
+				price: {
+					code: string;
+					amountKopecks: number;
 				}[];
-				price: null;
 			};
 			outputFormat: "json";
 			status: 200;
@@ -12679,8 +13756,8 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					workspaceId: string;
 					description: string | null;
 					price: number | null;
-					stock: number | null;
 					currency: string | null;
+					stock: number | null;
 					updated_at: string | null;
 					deleted_at: string | null;
 					verified_at: string | null;
@@ -12849,11 +13926,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					email: string | null;
 					workspaceId: string;
 					description: string | null;
-					phone: string | null;
 					updated_at: string | null;
 					deleted_at: string | null;
 					verified_at: string | null;
 					suspended_at: string | null;
+					phone: string | null;
 					website: string | null;
 					companyPhone: string | null;
 					companyAddress: string | null;
@@ -17430,7 +18507,85 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			status: 200;
 		};
 	};
-}, "/notifications">, "/", "/">;
+}, "/notifications"> | import("hono/types").MergeSchemaPath<{
+	"/invoice/:invoiceId/pay": {
+		$post: {
+			input: {
+				param: {
+					invoiceId: string;
+				};
+			};
+			output: {
+				paymentUrl: string;
+				providerPaymentId: string;
+				success: true;
+			};
+			outputFormat: "json";
+			status: 200;
+		} | {
+			input: {
+				param: {
+					invoiceId: string;
+				};
+			};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400 | 403 | 404 | 503;
+		};
+	};
+} & {
+	"/upgrade": {
+		$post: {
+			input: {};
+			output: {
+				success: true;
+				invoiceId: any;
+				invoice: any;
+			};
+			outputFormat: "json";
+			status: 201;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400 | 403 | 404;
+		};
+	};
+} & {
+	"/webhook": {
+		$post: {
+			input: {};
+			output: {
+				success: true;
+				ignored: true;
+			};
+			outputFormat: "json";
+			status: 200;
+		} | {
+			input: {};
+			output: {
+				success: true;
+				invoiceId: string;
+			};
+			outputFormat: "json";
+			status: 200;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 400 | 404 | 503;
+		};
+	};
+}, "/payments">, "/", "/">;
 type GlobalErrorResponses = {
 	400: {
 		json: ApiError;