@serve.zone/dcrouter 17.0.0 → 17.1.0

package/dist_ts_interfaces/requests/config.d.ts

@@ -7,7 +7,7 @@ export interface IConfigData {
         publicIp: string | null;
         proxyIps: string[];
         uptime: number;
-        storageBackend: 'filesystem' | 'custom' | 'memory';
+        storageBackend: 'smartdata-local' | 'smartdata-external';
         storagePath: string | null;
     };
     smartProxy: {

package/dist_ts_interfaces/requests/email-ops.d.ts

@@ -15,10 +15,42 @@ export interface IEmail {
 }
 export interface ISmtpLogEntry {
     timestamp: string;
-    direction: 'client' | 'server';
+    direction: 'client' | 'server' | 'system';
     command: string;
     responseCode?: number;
 }
+export type TSmtpDeliveryPhase = 'connect' | 'greeting' | 'ehlo' | 'starttls' | 'tls_handshake' | 'post_tls_ehlo' | 'auth' | 'mail_from' | 'rcpt_to' | 'data_command' | 'message_body' | 'final_response' | 'rset' | 'quit' | 'unknown';
+export interface ISmtpTranscriptEntry {
+    timestampMs: number;
+    phase: TSmtpDeliveryPhase;
+    direction: 'client' | 'server' | 'system';
+    text: string;
+    responseCode?: number;
+}
+export interface ISmtpTransactionAttempt {
+    id: string;
+    queueItemId: string;
+    queueAttempt: number;
+    targetHost: string;
+    targetPort: number;
+    recipientDomain?: string;
+    recipients: string[];
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
+    outcome: 'succeeded' | 'failed';
+    retryable: boolean;
+    errorType?: string;
+    smtpCode?: number;
+    recipientResults?: Array<{
+        recipient: string;
+        accepted: boolean;
+        responseCode: number;
+    }>;
+    failurePhase?: TSmtpDeliveryPhase;
+    error?: string;
+    transcript: ISmtpTranscriptEntry[];
+}
 export interface IConnectionInfo {
     sourceIp: string;
     sourceHostname: string;
@@ -39,6 +71,7 @@ export interface IAuthenticationResults {
     dmarcPolicy: string;
 }
 export interface IEmailDetail extends IEmail {
+    smtpTransactions?: ISmtpTransactionAttempt[];
     toList: string[];
     cc?: string[];
     smtpLog: ISmtpLogEntry[];

package/dist_ts_interfaces/requests/index.d.ts

@@ -20,5 +20,6 @@ export * from './dns-records.js';
 export * from './acme-config.js';
 export * from './email-domains.js';
 export * from './email-settings.js';
+export * from './realtime.js';
 export * from './workhoster.js';
 export * from './security-policy.js';

package/dist_ts_interfaces/requests/index.js

@@ -20,6 +20,7 @@ export * from './dns-records.js';
 export * from './acme-config.js';
 export * from './email-domains.js';
 export * from './email-settings.js';
+export * from './realtime.js';
 export * from './workhoster.js';
 export * from './security-policy.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsV0FBVyxDQUFDO0FBQzFCLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsVUFBVSxDQUFDO0FBQ3pCLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsc0JBQXNCLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsV0FBVyxDQUFDO0FBQzFCLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsVUFBVSxDQUFDO0FBQ3pCLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLGVBQWUsQ0FBQztBQUM5QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsc0JBQXNCLENBQUMifQ==

package/dist_ts_interfaces/requests/realtime.d.ts

@@ -0,0 +1,38 @@
+import * as plugins from '../plugins.js';
+import type { IIdentity } from '../data/auth.js';
+export declare const opsRealtimeResources: readonly ["emailDomains", "emailQueue", "smtpAttempts", "dns", "routes", "edges", "certificates"];
+export type TOpsRealtimeResource = (typeof opsRealtimeResources)[number];
+export type IOpsRealtimeRevisionMap = Record<TOpsRealtimeResource, number>;
+export interface IOpsRealtimeInvalidation {
+    resource: TOpsRealtimeResource;
+    revision: number;
+    changedIds?: string[];
+    reason?: string;
+    timestamp: number;
+}
+/**
+ * Authenticates the current WebSocket peer and returns anything newer than the
+ * client's last accepted revision. The tag is assigned by the server only.
+ */
+export interface IReq_SubscribeOpsRealtime extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_SubscribeOpsRealtime> {
+    method: 'subscribeOpsRealtime';
+    request: {
+        identity: IIdentity;
+        knownServerEpoch?: string;
+        knownRevisions?: Partial<IOpsRealtimeRevisionMap>;
+    };
+    response: {
+        serverEpoch: string;
+        revisions: IOpsRealtimeRevisionMap;
+        invalidations: IOpsRealtimeInvalidation[];
+    };
+}
+/** Server-to-browser notification. Resource data remains behind authenticated reads. */
+export interface IReq_PushOpsRealtimeInvalidation extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_PushOpsRealtimeInvalidation> {
+    method: 'pushOpsRealtimeInvalidation';
+    request: {
+        serverEpoch: string;
+        invalidations: IOpsRealtimeInvalidation[];
+    };
+    response: Record<string, never>;
+}

package/dist_ts_interfaces/requests/realtime.js

@@ -0,0 +1,11 @@
+import * as plugins from '../plugins.js';
+export const opsRealtimeResources = [
+    'emailDomains',
+    'emailQueue',
+    'smtpAttempts',
+    'dns',
+    'routes',
+    'edges',
+    'certificates',
+];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVhbHRpbWUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzL3JlYWx0aW1lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sZUFBZSxDQUFDO0FBR3pDLE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHO0lBQ2xDLGNBQWM7SUFDZCxZQUFZO0lBQ1osY0FBYztJQUNkLEtBQUs7SUFDTCxRQUFRO0lBQ1IsT0FBTztJQUNQLGNBQWM7Q0FDTixDQUFDIn0=

package/dist_ts_migrations/index.d.ts

@@ -16,6 +16,10 @@ export interface IMigrationRunResult {
 export interface IMigrationRunner {
     run(): Promise<IMigrationRunResult>;
 }
+export interface IMigrationBlobStorage {
+    set(key: string, value: Buffer): Promise<void>;
+    get(key: string): Promise<Buffer | null>;
+}
 export interface IDcRouterMigrationOptions {
     remoteIngressHubSettings?: {
         enabled?: boolean;
@@ -31,6 +35,8 @@ export interface IDcRouterMigrationOptions {
     };
     /** Explicit legacy raw-file adapter root; never inferred from process state. */
     legacySmartMtaStoragePath?: string;
+    /** SmartBucket adapter injected for the versioned CachedEmail payload migration. */
+    legacyRawMessageBlobStorage?: IMigrationBlobStorage;
 }
 /**
  * Create a configured SmartMigration runner with all dcrouter migration steps registered.