@mestra-dev/contract 0.0.46 → 0.0.48

package/dist/index.d.ts

@@ -26,7 +26,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				readonly openapi: "3.0.3";
 				readonly info: {
 					readonly title: "Auth Service API";
-					readonly version: "1.5.4";
+					readonly version: "1.5.5";
 					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 [
@@ -926,6 +926,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"maxCollaborators",
 								"hasPaid",
 								"status",
+								"planCode",
 								"isOwner",
 								"resources"
 							];
@@ -959,6 +960,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									readonly type: "string";
 									readonly description: "Collaborator status for the workspace (e.g., active, pending).";
 								};
+								readonly planCode: {
+									readonly type: "string";
+									readonly description: "Current workspace plan code (e.g. free, economy, standard, professional, or a private enterprise code).";
+									readonly example: "free";
+								};
 								readonly token: {
 									readonly type: "string";
 									readonly nullable: true;
@@ -4982,7 +4988,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"Workspace"
 							];
 							readonly summary: "Create a new workspace";
-							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 description: "Creates a workspace and its billing subscription atomically. Free starts a 15-day trial (default `TRIAL_WORKSPACE_LIMIT` is 1 Free trial per owner). Economy, Standard, and Professional create a pending invoice; use the returned invoiceId to start YooKassa checkout. An owner may have at most 5 pending unpaid invoices for those paid plans before creating another. Professional may create one complimentary workspace for an owner with an active paid Professional workspace.";
 							readonly security: readonly [
 								never
 							];
@@ -5047,7 +5053,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 400: {
-									readonly description: "Invalid payload, an unavailable plan, or an attempt to exceed the five Free-trial workspace limit.";
+									readonly description: "Invalid payload, unavailable plan, Free-trial limit exceeded (`Each user can create only {TRIAL_WORKSPACE_LIMIT} free trial workspaces`; default 1), or too many pending unpaid invoices for Economy/Standard/Professional (`Pay or cancel unpaid invoices before creating more workspaces (limit 5)`).";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -5340,7 +5346,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"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 description: "Returns workspaces the user collaborates on, each with category, plan code, role, billing flags, invitation state, workspace profile picture URL, and the resource grants effective for the caller. Also returns `unpaidLimit` (5): the maximum pending unpaid Economy/Standard/Professional invoices an owner may hold before create is blocked.";
 							readonly security: readonly [
 								never
 							];
@@ -5353,7 +5359,8 @@ declare const routes: import("hono/hono-base").HonoBase<{
 												readonly type: "object";
 												readonly required: readonly [
 													"success",
-													"workspaces"
+													"workspaces",
+													"unpaidLimit"
 												];
 												readonly properties: {
 													readonly success: {
@@ -5364,6 +5371,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 														readonly type: "array";
 														readonly items: any;
 													};
+													readonly unpaidLimit: {
+														readonly type: "integer";
+														readonly const: 5;
+														readonly description: "Max pending unpaid invoices allowed when creating another Economy/Standard/Professional workspace. Create returns 400 once this many unpaid invoices already exist.";
+													};
 												};
 											};
 										};
@@ -6238,7 +6250,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"Workspace"
 							];
 							readonly summary: "Delete a workspace";
-							readonly description: "Deletes a workspace and cascades removal of related data (policies, assignees, chat tenants, collaborators, comments, task tags, tasks, customers, services, billings, subscription invoices, tags, templates). Only the owner can delete a workspace. Requires write access to crm::general. Also allowed when the workspace was never paid, still has its first unpaid initial invoice, and YooKassa checkout has not been started; frozen, past-due, or open-checkout workspaces cannot be deleted.";
+							readonly description: "Soft-deletes a workspace: sets deleted_at, revokes collaborator access, and purges CRM content (policies, assignees, chat tenants, comments, tasks, customers, services, tags, templates). Billing subscriptions and invoices are retained for audit/history (pending invoices are canceled; the subscription is marked canceled). Soft-deleted Free trials still count toward the free-trial workspace limit. Only the owner can delete. Requires write access to crm::general. Also allowed when the workspace was never paid, still has its first unpaid initial invoice, and YooKassa checkout has not been started; frozen, past-due, or open-checkout workspaces cannot be deleted.";
 							readonly security: readonly [
 								never
 							];
@@ -6269,7 +6281,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 							readonly responses: {
 								readonly 200: {
-									readonly description: "Workspace deleted successfully.";
+									readonly description: "Workspace soft-deleted successfully.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -13093,6 +13105,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					maxCollaborators: number;
 					hasPaid: boolean;
 					status: string;
+					planCode: string;
 					token: string | null;
 					isOwner: boolean;
 					resources: {

package/package.json

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