@mestra-dev/contract 0.0.10 → 0.0.12

package/README.md

@@ -34,10 +34,10 @@ Always use `import type` so the bundler never pulls server code.
 
 ## Build (maintainers)
 
-Requires local `services/auth` and `services/utils` sources plus auth `node_modules` for type resolution. Those packages are **not** published with this contract.
+Requires local `services/core` and `services/utils` sources plus core `node_modules` for type resolution. Those packages are **not** published with this contract.
 
 ```bash
-cd services/contract
+cd services/hc
 bun install
 bun run build
 ```
@@ -47,7 +47,7 @@ Output: `dist/index.d.ts` (self-contained; depends on `hono` types only).
 ## Publish to npmjs
 
 ```bash
-cd services/contract
+cd services/hc
 bun run build
 bun pm version patch   # or: minor / major
 bun publish --access public

package/dist/index.d.ts

@@ -20,8 +20,8 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				readonly openapi: "3.0.3";
 				readonly info: {
 					readonly title: "Auth Service API";
-					readonly version: "1.5.1";
-					readonly description: "OpenAPI specification for the Auth, Integrations, Workspace, Tasks, Templates, Tags, Comments, Assignees, Chat, Events, Billings, and Files endpoints exposed by the k3-core platform.";
+					readonly version: "1.5.2";
+					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.";
 				};
 				readonly servers: readonly [
 					{
@@ -93,6 +93,10 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					{
 						readonly name: "Chat";
 						readonly description: "Matrix (Synapse) chat session bootstrap and chat-tenant collaborator listing; owners get an `owner_` username prefix; caches Matrix access tokens. Requires workspace access and crm::chats read.";
+					},
+					{
+						readonly name: "Notifications";
+						readonly description: "Cursor-based incremental notification sync, plus mark-read and archive. Clients store the sync cursor and pass it on the next call; read/archive bump updated_at so changes propagate via sync.";
 					}
 				];
 				readonly components: {
@@ -219,6 +223,119 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								};
 							};
 						};
+						readonly NotificationType: {
+							readonly type: "string";
+							readonly enum: readonly [
+								"info",
+								"warning",
+								"success",
+								"failure"
+							];
+							readonly default: "info";
+							readonly description: "Notification severity (`notification_type` Postgres enum).";
+						};
+						readonly Notification: {
+							readonly type: "object";
+							readonly required: readonly [
+								"id",
+								"userId",
+								"workspaceId",
+								"title",
+								"message",
+								"type",
+								"read",
+								"archive",
+								"created_at"
+							];
+							readonly properties: {
+								readonly id: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly userId: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly workspaceId: {
+									readonly type: "string";
+									readonly format: "uuid";
+								};
+								readonly title: {
+									readonly type: "string";
+									readonly maxLength: 256;
+								};
+								readonly message: {
+									readonly type: "string";
+									readonly maxLength: 256;
+								};
+								readonly type: {
+									readonly $ref: "#/components/schemas/NotificationType";
+								};
+								readonly read: {
+									readonly type: "boolean";
+								};
+								readonly archive: {
+									readonly type: "boolean";
+								};
+								readonly created_at: {
+									readonly type: "string";
+									readonly format: "date-time";
+								};
+								readonly updated_at: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+									readonly description: "Set when the notification is marked read or archived.";
+								};
+								readonly deleted_at: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+								};
+								readonly verified_at: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+								};
+								readonly suspended_at: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+								};
+							};
+						};
+						readonly NotificationSyncSuccess: {
+							readonly type: "object";
+							readonly required: readonly [
+								"success",
+								"notifications",
+								"cursor",
+								"hasMore"
+							];
+							readonly properties: {
+								readonly success: {
+									readonly type: "boolean";
+									readonly const: true;
+								};
+								readonly notifications: {
+									readonly type: "array";
+									readonly items: {
+										readonly $ref: "#/components/schemas/Notification";
+									};
+									readonly description: "Notifications created or updated after the request cursor, oldest change first.";
+								};
+								readonly cursor: {
+									readonly type: "string";
+									readonly format: "date-time";
+									readonly nullable: true;
+									readonly description: "Newest change timestamp in this page. Store it and pass it as `cursor` on the next sync. Null only when no cursor was sent and no notifications exist.";
+								};
+								readonly hasMore: {
+									readonly type: "boolean";
+									readonly description: "True when more changes remain; call again immediately with the returned cursor.";
+								};
+							};
+						};
 						readonly CreateWorkspaceSuccess: {
 							readonly type: "object";
 							readonly required: readonly [
@@ -256,10 +373,30 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									readonly description: "Human readable error message.";
 								};
 								readonly error: {
-									readonly type: "object";
 									readonly nullable: true;
-									readonly description: "Validation error details.";
-									readonly additionalProperties: true;
+									readonly description: "String message or Zod validation details, depending on the failure.";
+									readonly oneOf: readonly [
+										{
+											readonly type: "string";
+										},
+										{
+											readonly type: "object";
+											readonly additionalProperties: true;
+										}
+									];
+								};
+							};
+						};
+						readonly NotificationIdRequest: {
+							readonly type: "object";
+							readonly required: readonly [
+								"notificationId"
+							];
+							readonly properties: {
+								readonly notificationId: {
+									readonly type: "string";
+									readonly format: "uuid";
+									readonly description: "Notification identifier belonging to the authenticated user.";
 								};
 							};
 						};
@@ -758,6 +895,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								readonly workspaceName: {
 									readonly type: "string";
 								};
+								readonly profilePicture: {
+									readonly type: "string";
+									readonly nullable: true;
+									readonly description: "Presigned workspace avatar URL from `workspaces.picture` (7-day expiry); null or empty when unset.";
+								};
 								readonly workspaceCategory: {
 									readonly $ref: "#/components/schemas/WorkspaceCategory";
 								};
@@ -2959,7 +3101,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 400: {
-									readonly description: "Missing code or token verification failure.";
+									readonly description: "Missing `code`, or Google token exchange failed. `error` is a string such as Google's `error_description` (e.g. missing client_secret / invalid_request).";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -2969,7 +3111,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 500: {
-									readonly description: "Failed to issue tokens.";
+									readonly description: "`GOOGLE_CLIENT_SECRET is not configured`, or failed to issue session tokens after a successful Google exchange.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -3073,7 +3215,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 400: {
-									readonly description: "Missing query parameters, invalid state, or expired verifier.";
+									readonly description: "`Missing code or state`, `Invalid state`, `Invalid or expired state`, or Google token exchange failure (`error` string from Google / OAuth helper).";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -3099,7 +3241,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 500: {
-									readonly description: "Calendar creation, watch registration, or persistence failed (e.g. invalid watch response).";
+									readonly description: "`GOOGLE_CLIENT_SECRET is not configured`, or calendar creation / watch registration / persistence failed (e.g. invalid watch response).";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -4111,7 +4253,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, and the resource grants effective for the caller.";
+							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
 							];
@@ -4461,7 +4603,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 								"Workspace"
 							];
 							readonly summary: "Create workspace invitation";
-							readonly description: "Creates an invitation for a user to join a workspace with specified resources and role. Requires write access to crm::general resource.";
+							readonly description: "Creates an invitation for an email to join a workspace with specified resources and role. Works for emails that are not yet registered: a pending `invitations` row is stored and a collaborator is materialized when that email creates an account (OTP signup or OAuth). If the user already exists, a pending collaborator with policies is created immediately (same accept flow as before). Always returns the invite `token` for the frontend to share. Requires write access to crm::general. Pending invitations for unknown emails count toward the workspace collaborator seat limit.";
 							readonly security: readonly [
 								never
 							];
@@ -4481,7 +4623,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 												readonly email: {
 													readonly type: "string";
 													readonly format: "email";
-													readonly description: "Email of the user to invite.";
+													readonly description: "Email to invite (registered or not).";
 												};
 												readonly workspace: {
 													readonly type: "string";
@@ -4511,13 +4653,29 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
-												readonly $ref: "#/components/schemas/SimpleSuccess";
+												readonly type: "object";
+												readonly required: readonly [
+													"success",
+													"token"
+												];
+												readonly properties: {
+													readonly success: {
+														readonly type: "boolean";
+														readonly const: true;
+													};
+													readonly token: {
+														readonly type: "string";
+														readonly minLength: 64;
+														readonly maxLength: 64;
+														readonly description: "Invite token for GET /workspace/invite/{workspace}/{token} after the invitee authenticates.";
+													};
+												};
 											};
 										};
 									};
 								};
 								readonly 400: {
-									readonly description: "Invalid request payload, max collaborators reached, user not found, user is already a collaborator, or resource not found.";
+									readonly description: "Invalid request payload, max collaborators reached, invitation already pending, user is already a collaborator, or resource not found.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -5015,13 +5173,13 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
-					readonly "/workspace/leave/{workspace}/{collaboratorId}": {
+					readonly "/workspace/leave/{workspace}": {
 						readonly get: {
 							readonly tags: readonly [
 								"Workspace"
 							];
-							readonly summary: "Remove a collaborator from a workspace";
-							readonly description: "Removes the specified collaborator from the workspace. The authenticated workspace owner cannot use this endpoint; they must delete the workspace instead.";
+							readonly summary: "Leave a workspace";
+							readonly description: "Removes the authenticated user from the workspace. Workspace owners cannot leave; they must delete the workspace instead (`Owner cannot leave the workspace, Delete the workspace instead`).";
 							readonly security: readonly [
 								never
 							];
@@ -5035,21 +5193,11 @@ declare const routes: import("hono/hono-base").HonoBase<{
 										readonly type: "string";
 										readonly format: "uuid";
 									};
-								},
-								{
-									readonly name: "collaboratorId";
-									readonly in: "path";
-									readonly required: true;
-									readonly description: "Collaborator identifier to remove.";
-									readonly schema: {
-										readonly type: "string";
-										readonly format: "uuid";
-									};
 								}
 							];
 							readonly responses: {
 								readonly 200: {
-									readonly description: "Collaborator removed successfully.";
+									readonly description: "Left the workspace successfully.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -5059,7 +5207,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 									};
 								};
 								readonly 400: {
-									readonly description: "Invalid workspace id, user is not a collaborator, or user is the workspace owner.";
+									readonly description: "Invalid workspace id, caller is not a collaborator, or caller is the workspace owner.";
 									readonly content: {
 										readonly "application/json": {
 											readonly schema: {
@@ -9906,6 +10054,190 @@ declare const routes: import("hono/hono-base").HonoBase<{
 							};
 						};
 					};
+					readonly "/notifications/sync": {
+						readonly get: {
+							readonly tags: readonly [
+								"Notifications"
+							];
+							readonly summary: "Sync notifications incrementally";
+							readonly description: "Returns the authenticated user's notifications created or updated after the given `cursor` (change timestamp = greatest of created_at/updated_at), ordered oldest change first. Without a cursor, returns notifications from the beginning. Responses are paged by `limit`; when `hasMore` is true, call again with the returned cursor until it is false. Marking notifications read or archived bumps their change timestamp, so state changes propagate to all of the user's devices. Requires a valid access token (no workspace policy check).";
+							readonly security: readonly [
+								never
+							];
+							readonly parameters: readonly [
+								{
+									readonly name: "cursor";
+									readonly in: "query";
+									readonly required: false;
+									readonly schema: {
+										readonly type: "string";
+										readonly format: "date-time";
+									};
+									readonly description: "Change timestamp returned by the previous sync call (ISO 8601). Omit for a full initial sync.";
+								},
+								{
+									readonly name: "limit";
+									readonly in: "query";
+									readonly required: false;
+									readonly schema: {
+										readonly type: "integer";
+										readonly minimum: 1;
+										readonly maximum: 200;
+										readonly default: 100;
+									};
+									readonly description: "Maximum notifications per page.";
+								}
+							];
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Changed notifications with the next cursor.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/NotificationSyncSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid cursor or limit query parameter.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized - Missing or invalid access token.";
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access'.";
+								};
+							};
+						};
+					};
+					readonly "/notifications/read": {
+						readonly post: {
+							readonly tags: readonly [
+								"Notifications"
+							];
+							readonly summary: "Mark a notification as read";
+							readonly description: "Sets `read=true` and bumps `updated_at` for a notification owned by the authenticated user so the change is picked up by `/notifications/sync`. Requires a valid access token (no workspace policy check).";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/NotificationIdRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Notification marked as read.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/SimpleSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request payload.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized - Missing or invalid access token.";
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access'.";
+								};
+								readonly 404: {
+									readonly description: "Notification not found for this user.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
+					readonly "/notifications/archive": {
+						readonly post: {
+							readonly tags: readonly [
+								"Notifications"
+							];
+							readonly summary: "Archive a notification";
+							readonly description: "Sets `archive=true` and bumps `updated_at` for a notification owned by the authenticated user so the change is picked up by `/notifications/sync`. Requires a valid access token (no workspace policy check).";
+							readonly security: readonly [
+								never
+							];
+							readonly requestBody: {
+								readonly required: true;
+								readonly content: {
+									readonly "application/json": {
+										readonly schema: {
+											readonly $ref: "#/components/schemas/NotificationIdRequest";
+										};
+									};
+								};
+							};
+							readonly responses: {
+								readonly 200: {
+									readonly description: "Notification archived.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/SimpleSuccess";
+											};
+										};
+									};
+								};
+								readonly 400: {
+									readonly description: "Invalid request payload.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+								readonly 401: {
+									readonly description: "Unauthorized - Missing or invalid access token.";
+								};
+								readonly 403: {
+									readonly description: "Forbidden - Token issuer is not 'access'.";
+								};
+								readonly 404: {
+									readonly description: "Notification not found for this user.";
+									readonly content: {
+										readonly "application/json": {
+											readonly schema: {
+												readonly $ref: "#/components/schemas/ErrorResponse";
+											};
+										};
+									};
+								};
+							};
+						};
+					};
 					readonly "/chat/start": {
 						readonly post: {
 							readonly tags: readonly [
@@ -10321,6 +10653,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 				workspaces: {
 					workspaceId: string;
 					workspaceName: string;
+					profilePicture: string | null;
 					workspaceCategory: string;
 					role: string;
 					maxCollaborators: number;
@@ -10444,6 +10777,7 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			input: {};
 			output: {
 				success: true;
+				token: string;
 			};
 			outputFormat: "json";
 			status: 201;
@@ -10806,9 +11140,10 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			output: {
 				success: true;
 				task: {
-					status: string | null;
 					id: string;
 					workspaceId: string;
+					created_at: string;
+					status: string | null;
 					description: string | null;
 					subject: string;
 					created_by: string;
@@ -10817,7 +11152,6 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					deleted_at: string | null;
 					verified_at: string | null;
 					suspended_at: string | null;
-					created_at: string;
 					priority: string | null;
 					visibility: string | null;
 				};
@@ -11067,16 +11401,16 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			output: {
 				success: true;
 				template: {
-					title: string;
 					id: string;
 					workspaceId: string;
+					title: string;
+					created_at: string;
 					created_by: string;
 					content: string;
 					updated_at: string | null;
 					deleted_at: string | null;
 					verified_at: string | null;
 					suspended_at: string | null;
-					created_at: string;
 				}[];
 			};
 			outputFormat: "json";
@@ -11125,20 +11459,20 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			output: {
 				success: true;
 				service: {
-					name: string;
-					active: boolean | null;
 					id: string;
 					workspaceId: string;
+					type: string | null;
+					created_at: string;
+					name: string;
+					active: boolean | null;
 					description: string | null;
 					price: number | null;
 					stock: number | null;
 					currency: string | null;
-					type: string | null;
 					updated_at: string | null;
 					deleted_at: string | null;
 					verified_at: string | null;
 					suspended_at: string | null;
-					created_at: string;
 					qrCode: string | null;
 				}[];
 			};
@@ -11295,19 +11629,19 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			output: {
 				success: true;
 				customer: {
+					id: string;
+					workspaceId: string;
+					type: string | null;
+					created_at: string;
 					name: string;
 					active: boolean | null;
 					email: string | null;
-					id: string;
-					workspaceId: string;
 					description: string | null;
-					type: string | null;
 					phone: string | null;
 					updated_at: string | null;
 					deleted_at: string | null;
 					verified_at: string | null;
 					suspended_at: string | null;
-					created_at: string;
 					website: string | null;
 					companyPhone: string | null;
 					companyAddress: string | null;
@@ -11527,9 +11861,10 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			output: {
 				success: true;
 				billing: {
-					active: boolean | null;
 					id: string;
 					workspaceId: string;
+					created_at: string;
+					active: boolean | null;
 					country: string;
 					companyName: string;
 					inn: string;
@@ -11544,7 +11879,6 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					deleted_at: string | null;
 					verified_at: string | null;
 					suspended_at: string | null;
-					created_at: string;
 				}[];
 			};
 			outputFormat: "json";
@@ -11765,11 +12099,12 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			output: {
 				success: true;
 				assignee: {
+					id: string;
+					workspaceId: string;
+					created_at: string;
 					startDate: string | null;
 					endDate: string | null;
 					collaboratorId: string;
-					id: string;
-					workspaceId: string;
 					description: string | null;
 					created_by: string;
 					taskId: string;
@@ -11777,7 +12112,6 @@ declare const routes: import("hono/hono-base").HonoBase<{
 					deleted_at: string | null;
 					verified_at: string | null;
 					suspended_at: string | null;
-					created_at: string;
 				};
 			};
 			outputFormat: "json";
@@ -11887,15 +12221,15 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			output: {
 				success: true;
 				tag: {
-					name: string;
 					id: string;
 					workspaceId: string;
+					created_at: string;
+					name: string;
 					description: string | null;
 					updated_at: string | null;
 					deleted_at: string | null;
 					verified_at: string | null;
 					suspended_at: string | null;
-					created_at: string;
 				}[];
 			};
 			outputFormat: "json";
@@ -12093,6 +12427,14 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			};
 			outputFormat: "json";
 			status: 400;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 500;
 		} | {
 			input: {};
 			output: {
@@ -12828,10 +13170,10 @@ declare const routes: import("hono/hono-base").HonoBase<{
 						"www-authenticate"?: string | undefined | undefined;
 						":status"?: number | undefined | undefined;
 					};
+					readonly type: ResponseType;
 					readonly url: string;
 					readonly status: number;
 					readonly ok: boolean;
-					readonly type: ResponseType;
 					data: {
 						anyoneCanAddSelf?: boolean | null | undefined;
 						attachments?: {
@@ -15585,7 +15927,6 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			output: {
 				success: false;
 				error: string;
-				details: string;
 			};
 			outputFormat: "json";
 			status: 500;
@@ -15632,5 +15973,105 @@ declare const routes: import("hono/hono-base").HonoBase<{
 			status: 200;
 		};
 	};
-}, "/chat">, "/", "/">;
+}, "/chat"> | import("hono/types").MergeSchemaPath<{
+	"/sync": {
+		$get: {
+			input: {};
+			output: {
+				success: false;
+				error: {
+					_errors: string[];
+					limit?: {
+						[x: string]: any;
+						_errors: string[];
+					} | undefined;
+					cursor?: {
+						[x: string]: any;
+						_errors: string[];
+					} | undefined;
+				};
+			};
+			outputFormat: "json";
+			status: 400;
+		} | {
+			input: {};
+			output: {
+				success: true;
+				notifications: {
+					updated_at: string | null;
+					deleted_at: string | null;
+					verified_at: string | null;
+					suspended_at: string | null;
+					created_at: string;
+					id: string;
+					userId: string;
+					workspaceId: string;
+					title: string;
+					message: string;
+					type: "success" | "info" | "warning" | "failure";
+					read: boolean;
+					archive: boolean;
+				}[];
+				cursor: string | null;
+				hasMore: boolean;
+			};
+			outputFormat: "json";
+			status: 200;
+		};
+	};
+} & {
+	"/read": {
+		$post: {
+			input: {};
+			output: {
+				success: false;
+				error: never;
+			};
+			outputFormat: "json";
+			status: 400;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 404;
+		} | {
+			input: {};
+			output: {
+				success: true;
+			};
+			outputFormat: "json";
+			status: 200;
+		};
+	};
+} & {
+	"/archive": {
+		$post: {
+			input: {};
+			output: {
+				success: false;
+				error: never;
+			};
+			outputFormat: "json";
+			status: 400;
+		} | {
+			input: {};
+			output: {
+				success: false;
+				error: string;
+			};
+			outputFormat: "json";
+			status: 404;
+		} | {
+			input: {};
+			output: {
+				success: true;
+			};
+			outputFormat: "json";
+			status: 200;
+		};
+	};
+}, "/notifications">, "/", "/">;
 export type AppType = typeof routes;

package/package.json

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