@serve.zone/interfaces 19.7.0 → 19.8.0

package/changelog.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2026-07-29 - 19.8.0
+
+### Features
+
+- add an authenticated gateway-client mail-domain count contract (gateway)
+  - Expose getGatewayClientMailDomainCount with a count-only response for distinct configured mail domains.
+  - Derive ownership from the authenticating gateway credential instead of caller-selected owner fields.
+  - Document the new request and extend gateway contract tests.
+
 ## 2026-07-29 - 19.7.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

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

package/dist_ts/requests/gateway.d.ts

@@ -100,6 +100,17 @@ export interface IReq_GetGatewayClientMailOverview extends plugins.typedrequestI
         emails: IMailOverviewEmail[];
     };
 }
+/** Cheap gateway-client-owned count of distinct configured mail domains. */
+export interface IReq_GetGatewayClientMailDomainCount extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetGatewayClientMailDomainCount> {
+    method: 'getGatewayClientMailDomainCount';
+    request: {
+        identity?: IGatewayIdentity;
+        apiToken?: string;
+    };
+    response: {
+        count: number;
+    };
+}
 export interface IReq_GetGatewayClientDomains extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetGatewayClientDomains> {
     method: 'getGatewayClientDomains';
     request: {

package/package.json

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

package/readme.md

@@ -345,7 +345,7 @@ const provisioning: requests.gateway.IReq_ProvisionGatewayClientCredential['requ
 };
 ```
 
-`getGatewayClientContext` returns effective live policy. A `gatewayClient` role necessarily includes the credential ID, bound client ID/type, and `policyGeneration`; consumers should reject admin/operator or mismatched contexts rather than falling back to a caller-supplied owner ID. `getGatewayClientMailOverview` provides an owner-scoped domain and recent-message summary. Cloudly therefore uses only `dcrouterGatewayApiToken`; the former `dcrouterOpsApiToken` setting is not part of `data.ICloudlySettings`.
+`getGatewayClientContext` returns effective live policy. A `gatewayClient` role necessarily includes the credential ID, bound client ID/type, and `policyGeneration`; consumers should reject admin/operator or mismatched contexts rather than falling back to a caller-supplied owner ID. `getGatewayClientMailOverview` provides an owner-scoped domain and recent-message summary. `getGatewayClientMailDomainCount` derives ownership exclusively from the authenticating gateway credential and returns `{ count: number }` for its distinct configured mail domains. Cloudly therefore uses only `dcrouterGatewayApiToken`; the former `dcrouterOpsApiToken` setting is not part of `data.ICloudlySettings`.
 
 Request groups are exported by product area:
 

package/ts/00_commitinfo_data.ts

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

package/ts/requests/gateway.ts

@@ -141,6 +141,21 @@ export interface IReq_GetGatewayClientMailOverview extends plugins.typedrequestI
   };
 }
 
+/** Cheap gateway-client-owned count of distinct configured mail domains. */
+export interface IReq_GetGatewayClientMailDomainCount extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_GetGatewayClientMailDomainCount
+> {
+  method: 'getGatewayClientMailDomainCount';
+  request: {
+    identity?: IGatewayIdentity;
+    apiToken?: string;
+  };
+  response: {
+    count: number;
+  };
+}
+
 export interface IReq_GetGatewayClientDomains extends plugins.typedrequestInterfaces.implementsTR<
   plugins.typedrequestInterfaces.ITypedRequest,
   IReq_GetGatewayClientDomains