@mestra-dev/contract 0.0.38 → 0.0.40

package/dist/index.d.ts

@@ -98,7 +98,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					},
 					{
 						readonly name: "Files";
-						readonly description: "S3 file upload (presigned POST to a temporary `.tmp` key), confirm (magic-byte validation then promote to final key), optional nested folder destination under `{workspace}/folders/{path}/`, profile and workspace picture upload/confirm/delete, comment attachment upload/confirm, list task comment files with download URLs, folder create/delete (nested paths), list (includes pin metadata; excludes `.tmp` objects), pin/unpin, download by relative path, move, and file delete. General uploads accept JPEG/PNG/WebP/PDF; profile/workspace pictures accept JPEG/PNG only (0.5 MB). Workspace file routes require active collaborator status and crm::files access; comment attachments require crm::tasks write/read.";
+						readonly description: "S3 file upload (presigned POST to a temporary `.tmp` key), confirm (magic-byte validation then promote to final key), optional nested folder destination under `{workspace}/folders/{path}/`, profile and workspace picture upload/confirm/delete, comment attachment upload/confirm, list task comment files with download URLs, folder create/delete (nested paths), list (includes pin metadata; excludes `.tmp` objects), storage usage, pin/unpin, download by relative path, move, and file delete. General uploads accept JPEG/PNG/WebP/PDF; profile/workspace pictures accept JPEG/PNG only (0.5 MB). Workspace file routes require active collaborator status and crm::files access; comment attachments require crm::tasks write/read.";
 					},
 					{
 						readonly name: "Chat";
@@ -2012,6 +2012,43 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 							};
 						};
+						readonly StorageUsageSuccess: {
+							readonly type: "object";
+							readonly required: readonly [
+								"success",
+								"usedBytes",
+								"filesBytes",
+								"commentsBytes",
+								"limitBytes"
+							];
+							readonly properties: {
+								readonly success: {
+									readonly type: "boolean";
+									readonly const: true;
+								};
+								readonly usedBytes: {
+									readonly type: "integer";
+									readonly description: "Total finalized storage in bytes (`filesBytes` + `commentsBytes`). Excludes `.tmp` objects.";
+									readonly example: 348320;
+								};
+								readonly filesBytes: {
+									readonly type: "integer";
+									readonly description: "Finalized workspace file storage under `{workspace}/` (root files and folders). Excludes `.tmp`.";
+									readonly example: 248320;
+								};
+								readonly commentsBytes: {
+									readonly type: "integer";
+									readonly description: "Finalized comment attachment storage under `{workspace}_comments/`. Excludes `.tmp`.";
+									readonly example: 100000;
+								};
+								readonly limitBytes: {
+									readonly type: "integer";
+									readonly nullable: true;
+									readonly description: "Plan storage limit in bytes for this workspace, or null when no subscription/limit is configured. Applies to the combined total.";
+									readonly example: 1073741824;
+								};
+							};
+						};
 						readonly DownloadFileSuccess: {
 							readonly type: "object";
 							readonly required: readonly [
@@ -6202,7 +6239,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, tags, templates). Only the owner can delete a workspace. Requires write access to crm::general resource.";
+							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 security: readonly [
 								never
 							];
@@ -6263,7 +6300,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 403: {
-									readonly description: "Forbidden - Token issuer is not 'access', user lacks workspace access, or user lacks write access to crm::general resource.";
+									readonly description: "Forbidden - Token issuer is not 'access', user lacks workspace access or crm::general write, or the workspace is frozen/past-due/has an open YooKassa checkout (delete is only exempt for an unpaid initial invoice with no checkout).";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -11083,6 +11120,72 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
+					readonly "/files/usage/{workspace}": {
+						readonly get: {
+							readonly tags: readonly [
+								"Files"
+							];
+							readonly summary: "Get workspace storage usage";
+							readonly description: "Returns finalized storage usage broken down by workspace files (`filesBytes`) and comment attachments (`commentsBytes`), plus the combined total and plan limit. Temporary `.tmp` objects are excluded. Requires workspace access and read access to crm::files.";
+							readonly 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 responses: {
+								readonly 200: {
+									readonly description: "Storage usage returned.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/StorageUsageSuccess";
+											};
+										};
+									};
+								};
+								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 404: {
+									readonly description: "Workspace not found.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
 					readonly "/files/download/{workspace}": {
 						readonly get: {
 							readonly tags: readonly [
@@ -13367,7 +13470,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				error: string;
 			};
 			outputFormat: "json";
-			status: 400;
+			status: 400 | 403 | 404;
 		} | {
 			input: {};
 			output: {
@@ -18120,6 +18223,25 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			status: 200;
 		};
 	};
+} & {
+	"/usage/:workspace": {
+		$get: {
+			input: {
+				param: {
+					workspace: string;
+				};
+			};
+			output: {
+				success: true;
+				usedBytes: number;
+				filesBytes: number;
+				commentsBytes: number;
+				limitBytes: number | null;
+			};
+			outputFormat: "json";
+			status: import("hono/utils/http-status").ContentfulStatusCode;
+		};
+	};
 } & {
 	"/download/:workspace": {
 		$get: {

package/package.json

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