@mestra-dev/contract 0.0.77 → 0.0.79

package/dist/index.d.ts

@@ -420,7 +420,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 								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 description: "True when create immediately activates the complimentary Professional because a paid Professional is already active. False when this Professional is pending; a pending sibling is converted to the bonus only after the paid invoice succeeds.";
 								};
 							};
 						};
@@ -3345,6 +3345,66 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 							};
 						};
+						readonly BillingHistoryInvoice: {
+							readonly type: "object";
+							readonly required: readonly [
+								"id",
+								"workspaceId",
+								"workspaceName",
+								"planName",
+								"interval",
+								"billingCycles",
+								"createdAt",
+								"amountKopecks",
+								"currency",
+								"status"
+							];
+							readonly properties: {
+								readonly id: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly workspaceId: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly workspaceName: {
+									readonly type: "string";
+								};
+								readonly planName: {
+									readonly type: "string";
+								};
+								readonly interval: {
+									readonly $ref: "#/components/schemas/BillingInterval";
+								};
+								readonly billingCycles: {
+									readonly $ref: "#/components/schemas/BillingCycles";
+								};
+								readonly createdAt: {
+									readonly type: "string";
+									readonly format: "date-time";
+								};
+								readonly amountKopecks: {
+									readonly type: "integer";
+									readonly description: "Full invoice amount in kopecks.";
+								};
+								readonly currency: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"RUB"
+									];
+								};
+								readonly status: {
+									readonly type: "string";
+									readonly enum: readonly [
+										"pending",
+										"paid",
+										"canceled",
+										"failed"
+									];
+								};
+							};
+						};
 						readonly BillingInvoice: {
 							readonly type: "object";
 							readonly required: readonly [
@@ -5243,7 +5303,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. Requires the caller to have both email and phone verified. 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 description: "Creates a workspace and its billing subscription atomically. Requires the caller to have both email and phone verified. 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. A second Professional created before the first Professional is paid stays pending. After that payment succeeds, one pending Professional becomes the complimentary workspace (its checkout is canceled). If no pending Professional exists, the next Professional create after a paid Professional is active is complimentary.";
 							readonly security: readonly [
 								never
 							];
@@ -6784,6 +6844,77 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
+					readonly "/payments/history": {
+						readonly get: {
+							readonly tags: readonly [
+								"Payments"
+							];
+							readonly summary: "List billing history for the signed-in owner";
+							readonly description: "Returns every subscription invoice for workspaces owned by the caller, newest first. Includes invoices for soft-deleted workspaces. Optional month=YYYY-MM filters by invoice creation month (UTC).";
+							readonly security: readonly [
+								never
+							];
+							readonly parameters: readonly [
+								{
+									readonly name: "month";
+									readonly in: "query";
+									readonly required: false;
+									readonly schema: {
+										readonly type: "string";
+										readonly pattern: "^\\d{4}-(0[1-9]|1[0-2])$";
+										readonly example: "2026-07";
+									};
+									readonly description: "Filter invoices created in this UTC month. Omit for all months.";
+								}
+							];
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Invoice history.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly type: "object";
+												readonly required: readonly [
+													"success",
+													"invoices"
+												];
+												readonly properties: {
+													readonly success: {
+														readonly type: "boolean";
+														readonly const: true;
+													};
+													readonly invoices: {
+														readonly type: "array";
+														readonly items: any;
+													};
+												};
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid month query.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
 					readonly "/payments/invoice/{invoiceId}/pay": {
 						readonly post: {
 							readonly tags: readonly [
@@ -19308,6 +19439,39 @@ declare const routes: import("hono/hono-base").HonoBase<{
 		};
 	};
 }, "/notifications"> | import("hono/types").MergeSchemaPath<{
+	"/history": {
+		$get: {
+			input: {};
+			output: {
+				success: false;
+				error: {
+					[x: string]: import("hono/utils/types").JSONValue;
+				};
+			};
+			outputFormat: "json";
+			status: 400;
+		} | {
+			input: {};
+			output: {
+				success: true;
+				invoices: {
+					createdAt: string;
+					id: string;
+					workspaceId: string;
+					workspaceName: string;
+					planName: string;
+					interval: string;
+					billingCycles: number;
+					amountKopecks: number;
+					currency: string;
+					status: string;
+				}[];
+			};
+			outputFormat: "json";
+			status: 200;
+		};
+	};
+} & {
 	"/invoice/:invoiceId/pay": {
 		$post: {
 			input: {

package/package.json

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