@serve.zone/interfaces 7.27.0 → 7.28.0

package/changelog.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2026-06-24 - 7.28.0
+
+### Features
+
+- add service mail endpoint registration interfaces (mail)
+  - Add inbound mail configuration fields for typed endpoints and SMTP forwarding targets
+  - Add registerServiceMailEndpoint TypedRequest contract for registering inbound delivery addresses
+
 ## 2026-06-22 - 7.27.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/data/mail.d.ts

@@ -174,6 +174,10 @@ export interface IWorkAppMailBinding {
 export type TServiceMailSubmissionTlsMode = 'plain' | 'starttls' | 'implicitTls';
 export interface IServiceMailInboundConfig {
     enabled?: boolean;
+    /** Platformclient apps use typedEndpoint; third-party apps with their own SMTP server use smtpForward. */
+    targetType?: 'typedEndpoint' | 'smtpForward';
+    /** TypedRequest method exposed by platformclient over TypedSocket for inbound delivery. */
+    typedMethod?: string;
     /** Published Docker/Swarm port that dcrouter may SMTP-forward inbound mail to. */
     publishedPort?: number;
     preserveHeaders?: boolean;

package/dist_ts/requests/mail.d.ts

@@ -151,6 +151,18 @@ export interface IReq_DeliverInboundMail extends plugins.typedrequestInterfaces.
         message?: string;
     };
 }
+export interface IReq_RegisterServiceMailEndpoint extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_RegisterServiceMailEndpoint> {
+    method: 'registerServiceMailEndpoint';
+    request: {
+        auth: IMailSubmissionRequestAuth;
+        addresses?: string[];
+    };
+    response: {
+        success: boolean;
+        addresses?: string[];
+        message?: string;
+    };
+}
 export interface IReq_GetMailDeliveryStatus extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetMailDeliveryStatus> {
     method: 'getMailDeliveryStatus';
     request: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "7.27.0",
+  "version": "7.28.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.27.0',
+  version: '7.28.0',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/data/mail.ts

@@ -227,6 +227,10 @@ export type TServiceMailSubmissionTlsMode = 'plain' | 'starttls' | 'implicitTls'
 
 export interface IServiceMailInboundConfig {
   enabled?: boolean;
+  /** Platformclient apps use typedEndpoint; third-party apps with their own SMTP server use smtpForward. */
+  targetType?: 'typedEndpoint' | 'smtpForward';
+  /** TypedRequest method exposed by platformclient over TypedSocket for inbound delivery. */
+  typedMethod?: string;
   /** Published Docker/Swarm port that dcrouter may SMTP-forward inbound mail to. */
   publishedPort?: number;
   preserveHeaders?: boolean;

package/ts/requests/mail.ts

@@ -225,6 +225,22 @@ export interface IReq_DeliverInboundMail extends plugins.typedrequestInterfaces.
   };
 }
 
+export interface IReq_RegisterServiceMailEndpoint extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_RegisterServiceMailEndpoint
+> {
+  method: 'registerServiceMailEndpoint';
+  request: {
+    auth: IMailSubmissionRequestAuth;
+    addresses?: string[];
+  };
+  response: {
+    success: boolean;
+    addresses?: string[];
+    message?: string;
+  };
+}
+
 export interface IReq_GetMailDeliveryStatus extends plugins.typedrequestInterfaces.implementsTR<
   plugins.typedrequestInterfaces.ITypedRequest,
   IReq_GetMailDeliveryStatus