@serve.zone/interfaces 7.20.0 → 7.21.0

package/changelog.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2026-06-11 - 7.21.0
+
+### Features
+
+- add Cloudly mail overview request interfaces (mail)
+  - Adds interfaces for mail overview domains and recent email queue entries.
+  - Defines the getMailOverview typed request contract with configuration status, gateway URL, domains, emails, and error text.
+
 ## 2026-06-11 - 7.20.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/interfaces',
-    version: '7.20.0',
+    version: '7.21.0',
     description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=

package/dist_ts/requests/mail.d.ts

@@ -199,3 +199,35 @@ export interface IReq_EnqueueMail extends plugins.typedrequestInterfaces.impleme
         message?: string;
     };
 }
+/**
+ * Cloudly admin UI mail overview, relayed from the hub dcrouter's ops API.
+ * Read-only summary: configured email domains and recent queue entries.
+ */
+export interface IMailOverviewDomain {
+    domain: string;
+    dnsMode?: string;
+    status?: string;
+}
+export interface IMailOverviewEmail {
+    id: string;
+    direction?: string;
+    from?: string;
+    to?: string;
+    subject?: string;
+    status?: string;
+    timestamp?: number;
+}
+export interface IReq_Any_Cloudly_GetMailOverview extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_Cloudly_GetMailOverview> {
+    method: 'getMailOverview';
+    request: {
+        identity: IIdentity;
+    };
+    response: {
+        /** False when no dcrouter ops API token is configured in settings. */
+        configured: boolean;
+        gatewayUrl?: string;
+        domains: IMailOverviewDomain[];
+        emails: IMailOverviewEmail[];
+        errorText?: string;
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "7.20.0",
+  "version": "7.21.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@serve.zone/interfaces',
-  version: '7.20.0',
+  version: '7.21.0',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/requests/mail.ts

@@ -288,3 +288,41 @@ export interface IReq_EnqueueMail extends plugins.typedrequestInterfaces.impleme
     message?: string;
   };
 }
+
+/**
+ * Cloudly admin UI mail overview, relayed from the hub dcrouter's ops API.
+ * Read-only summary: configured email domains and recent queue entries.
+ */
+export interface IMailOverviewDomain {
+  domain: string;
+  dnsMode?: string;
+  status?: string;
+}
+
+export interface IMailOverviewEmail {
+  id: string;
+  direction?: string;
+  from?: string;
+  to?: string;
+  subject?: string;
+  status?: string;
+  timestamp?: number;
+}
+
+export interface IReq_Any_Cloudly_GetMailOverview extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_Cloudly_GetMailOverview
+> {
+  method: 'getMailOverview';
+  request: {
+    identity: IIdentity;
+  };
+  response: {
+    /** False when no dcrouter ops API token is configured in settings. */
+    configured: boolean;
+    gatewayUrl?: string;
+    domains: IMailOverviewDomain[];
+    emails: IMailOverviewEmail[];
+    errorText?: string;
+  };
+}