@serve.zone/dcrouter 7.4.3 → 8.1.0

package/dist_ts_interfaces/requests/api-tokens.d.ts

@@ -0,0 +1,63 @@
+import * as plugins from '../plugins.js';
+import type * as authInterfaces from '../data/auth.js';
+import type { IApiTokenInfo, TApiTokenScope } from '../data/route-management.js';
+/**
+ * Create a new API token. Returns the raw token value once (never shown again).
+ * Admin JWT only — tokens cannot create tokens.
+ */
+export interface IReq_CreateApiToken extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_CreateApiToken> {
+    method: 'createApiToken';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        name: string;
+        scopes: TApiTokenScope[];
+        expiresInDays?: number | null;
+    };
+    response: {
+        success: boolean;
+        tokenId?: string;
+        tokenValue?: string;
+        message?: string;
+    };
+}
+/**
+ * List all API tokens (without hashes).
+ */
+export interface IReq_ListApiTokens extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ListApiTokens> {
+    method: 'listApiTokens';
+    request: {
+        identity?: authInterfaces.IIdentity;
+    };
+    response: {
+        tokens: IApiTokenInfo[];
+    };
+}
+/**
+ * Revoke (delete) an API token.
+ */
+export interface IReq_RevokeApiToken extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_RevokeApiToken> {
+    method: 'revokeApiToken';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        id: string;
+    };
+    response: {
+        success: boolean;
+        message?: string;
+    };
+}
+/**
+ * Enable or disable an API token.
+ */
+export interface IReq_ToggleApiToken extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ToggleApiToken> {
+    method: 'toggleApiToken';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        id: string;
+        enabled: boolean;
+    };
+    response: {
+        success: boolean;
+        message?: string;
+    };
+}

package/dist_ts_interfaces/requests/api-tokens.js

@@ -0,0 +1,2 @@
+import * as plugins from '../plugins.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBpLXRva2Vucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX2ludGVyZmFjZXMvcmVxdWVzdHMvYXBpLXRva2Vucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQyJ9

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

@@ -1,91 +1,71 @@
 import * as plugins from '../plugins.js';
 import * as authInterfaces from '../data/auth.js';
-export type TEmailQueueStatus = 'pending' | 'processing' | 'delivered' | 'failed' | 'deferred';
-export interface IEmailQueueItem {
+export type TEmailStatus = 'delivered' | 'bounced' | 'rejected' | 'deferred' | 'pending';
+export type TEmailDirection = 'inbound' | 'outbound';
+export interface IEmail {
     id: string;
-    processingMode: 'forward' | 'mta' | 'process';
-    status: TEmailQueueStatus;
-    attempts: number;
-    nextAttempt: number;
-    lastError?: string;
-    createdAt: number;
-    updatedAt: number;
-    deliveredAt?: number;
-    from?: string;
-    to?: string[];
-    subject?: string;
+    direction: TEmailDirection;
+    status: TEmailStatus;
+    from: string;
+    to: string;
+    subject: string;
+    timestamp: string;
+    messageId: string;
+    size: string;
 }
-export type TBounceType = 'invalid_recipient' | 'domain_not_found' | 'mailbox_full' | 'mailbox_inactive' | 'blocked' | 'spam_related' | 'policy_related' | 'server_unavailable' | 'temporary_failure' | 'quota_exceeded' | 'network_error' | 'timeout' | 'auto_response' | 'challenge_response' | 'unknown';
-export type TBounceCategory = 'hard' | 'soft' | 'auto_response' | 'unknown';
-export interface IBounceRecord {
-    id: string;
-    originalEmailId?: string;
-    recipient: string;
-    sender: string;
-    domain: string;
-    subject?: string;
-    bounceType: TBounceType;
-    bounceCategory: TBounceCategory;
-    timestamp: number;
-    smtpResponse?: string;
-    diagnosticCode?: string;
-    statusCode?: string;
-    processed: boolean;
-    retryCount?: number;
-    nextRetryTime?: number;
+export interface ISmtpLogEntry {
+    timestamp: string;
+    direction: 'client' | 'server';
+    command: string;
+    responseCode?: number;
 }
-export type TSecurityLogLevel = 'info' | 'warn' | 'error' | 'critical';
-export type TSecurityEventType = 'authentication' | 'access_control' | 'email_validation' | 'email_processing' | 'email_forwarding' | 'email_delivery' | 'dkim' | 'spf' | 'dmarc' | 'rate_limit' | 'rate_limiting' | 'spam' | 'malware' | 'connection' | 'data_exposure' | 'configuration' | 'ip_reputation' | 'rejected_connection';
-export interface ISecurityIncident {
-    timestamp: number;
-    level: TSecurityLogLevel;
-    type: TSecurityEventType;
-    message: string;
-    details?: any;
-    ipAddress?: string;
-    userId?: string;
-    sessionId?: string;
-    emailId?: string;
-    domain?: string;
-    action?: string;
-    result?: string;
-    success?: boolean;
+export interface IConnectionInfo {
+    sourceIp: string;
+    sourceHostname: string;
+    destinationIp: string;
+    destinationPort: number;
+    tlsVersion: string;
+    tlsCipher: string;
+    authenticated: boolean;
+    authMethod: string;
+    authUser: string;
 }
-export interface IReq_GetQueuedEmails extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetQueuedEmails> {
-    method: 'getQueuedEmails';
-    request: {
-        identity?: authInterfaces.IIdentity;
-        status?: TEmailQueueStatus;
-        limit?: number;
-        offset?: number;
-    };
-    response: {
-        items: IEmailQueueItem[];
-        total: number;
-    };
+export interface IAuthenticationResults {
+    spf: 'pass' | 'fail' | 'softfail' | 'neutral' | 'none';
+    spfDomain: string;
+    dkim: 'pass' | 'fail' | 'none';
+    dkimDomain: string;
+    dmarc: 'pass' | 'fail' | 'none';
+    dmarcPolicy: string;
+}
+export interface IEmailDetail extends IEmail {
+    toList: string[];
+    cc?: string[];
+    smtpLog: ISmtpLogEntry[];
+    connectionInfo: IConnectionInfo;
+    authenticationResults: IAuthenticationResults;
+    rejectionReason?: string;
+    bounceMessage?: string;
+    headers: Record<string, string>;
+    body: string;
 }
-export interface IReq_GetSentEmails extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetSentEmails> {
-    method: 'getSentEmails';
+export interface IReq_GetAllEmails extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetAllEmails> {
+    method: 'getAllEmails';
     request: {
         identity?: authInterfaces.IIdentity;
-        limit?: number;
-        offset?: number;
     };
     response: {
-        items: IEmailQueueItem[];
-        total: number;
+        emails: IEmail[];
     };
 }
-export interface IReq_GetFailedEmails extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetFailedEmails> {
-    method: 'getFailedEmails';
+export interface IReq_GetEmailDetail extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetEmailDetail> {
+    method: 'getEmailDetail';
     request: {
         identity?: authInterfaces.IIdentity;
-        limit?: number;
-        offset?: number;
+        emailId: string;
     };
     response: {
-        items: IEmailQueueItem[];
-        total: number;
+        email: IEmailDetail | null;
     };
 }
 export interface IReq_ResendEmail extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ResendEmail> {
@@ -100,40 +80,3 @@ export interface IReq_ResendEmail extends plugins.typedrequestInterfaces.impleme
         error?: string;
     };
 }
-export interface IReq_GetSecurityIncidents extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetSecurityIncidents> {
-    method: 'getSecurityIncidents';
-    request: {
-        identity?: authInterfaces.IIdentity;
-        type?: TSecurityEventType;
-        level?: TSecurityLogLevel;
-        limit?: number;
-    };
-    response: {
-        incidents: ISecurityIncident[];
-        total: number;
-    };
-}
-export interface IReq_GetBounceRecords extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetBounceRecords> {
-    method: 'getBounceRecords';
-    request: {
-        identity?: authInterfaces.IIdentity;
-        limit?: number;
-        offset?: number;
-    };
-    response: {
-        records: IBounceRecord[];
-        suppressionList: string[];
-        total: number;
-    };
-}
-export interface IReq_RemoveFromSuppressionList extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_RemoveFromSuppressionList> {
-    method: 'removeFromSuppressionList';
-    request: {
-        identity?: authInterfaces.IIdentity;
-        email: string;
-    };
-    response: {
-        success: boolean;
-        error?: string;
-    };
-}

package/dist_ts_interfaces/requests/index.d.ts

@@ -7,3 +7,5 @@ export * from './radius.js';
 export * from './email-ops.js';
 export * from './certificate.js';
 export * from './remoteingress.js';
+export * from './route-management.js';
+export * from './api-tokens.js';

package/dist_ts_interfaces/requests/index.js

@@ -7,4 +7,6 @@ export * from './radius.js';
 export * from './email-ops.js';
 export * from './certificate.js';
 export * from './remoteingress.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsV0FBVyxDQUFDO0FBQzFCLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsb0JBQW9CLENBQUMifQ==
+export * from './route-management.js';
+export * from './api-tokens.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsV0FBVyxDQUFDO0FBQzFCLGNBQWMsWUFBWSxDQUFDO0FBQzNCLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLGlCQUFpQixDQUFDIn0=

package/dist_ts_interfaces/requests/route-management.d.ts

@@ -0,0 +1,114 @@
+import * as plugins from '../plugins.js';
+import type * as authInterfaces from '../data/auth.js';
+import type { IMergedRoute, IRouteWarning } from '../data/route-management.js';
+import type { IRouteConfig } from '@push.rocks/smartproxy';
+/**
+ * Get all merged routes (hardcoded + programmatic) with warnings.
+ */
+export interface IReq_GetMergedRoutes extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetMergedRoutes> {
+    method: 'getMergedRoutes';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        apiToken?: string;
+    };
+    response: {
+        routes: IMergedRoute[];
+        warnings: IRouteWarning[];
+    };
+}
+/**
+ * Create a new programmatic route.
+ */
+export interface IReq_CreateRoute extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_CreateRoute> {
+    method: 'createRoute';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        apiToken?: string;
+        route: IRouteConfig;
+        enabled?: boolean;
+    };
+    response: {
+        success: boolean;
+        storedRouteId?: string;
+        message?: string;
+    };
+}
+/**
+ * Update a programmatic route.
+ */
+export interface IReq_UpdateRoute extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_UpdateRoute> {
+    method: 'updateRoute';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        apiToken?: string;
+        id: string;
+        route?: Partial<IRouteConfig>;
+        enabled?: boolean;
+    };
+    response: {
+        success: boolean;
+        message?: string;
+    };
+}
+/**
+ * Delete a programmatic route.
+ */
+export interface IReq_DeleteRoute extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_DeleteRoute> {
+    method: 'deleteRoute';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        apiToken?: string;
+        id: string;
+    };
+    response: {
+        success: boolean;
+        message?: string;
+    };
+}
+/**
+ * Set an override on a hardcoded route (disable/enable by name).
+ */
+export interface IReq_SetRouteOverride extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_SetRouteOverride> {
+    method: 'setRouteOverride';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        apiToken?: string;
+        routeName: string;
+        enabled: boolean;
+    };
+    response: {
+        success: boolean;
+        message?: string;
+    };
+}
+/**
+ * Remove an override from a hardcoded route (restore default behavior).
+ */
+export interface IReq_RemoveRouteOverride extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_RemoveRouteOverride> {
+    method: 'removeRouteOverride';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        apiToken?: string;
+        routeName: string;
+    };
+    response: {
+        success: boolean;
+        message?: string;
+    };
+}
+/**
+ * Toggle a programmatic route on/off by id.
+ */
+export interface IReq_ToggleRoute extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ToggleRoute> {
+    method: 'toggleRoute';
+    request: {
+        identity?: authInterfaces.IIdentity;
+        apiToken?: string;
+        id: string;
+        enabled: boolean;
+    };
+    response: {
+        success: boolean;
+        message?: string;
+    };
+}

package/dist_ts_interfaces/requests/route-management.js

@@ -0,0 +1,2 @@
+import * as plugins from '../plugins.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicm91dGUtbWFuYWdlbWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX2ludGVyZmFjZXMvcmVxdWVzdHMvcm91dGUtbWFuYWdlbWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQyJ9

package/dist_ts_web/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/dcrouter',
-    version: '7.4.3',
+    version: '8.1.0',
     description: 'A multifaceted routing service handling mail and SMS delivery functions.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfd2ViLzAwX2NvbW1pdGluZm9fZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4QixJQUFJLEVBQUUsc0JBQXNCO0lBQzVCLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSwwRUFBMEU7Q0FDeEYsQ0FBQSJ9

package/dist_ts_web/appstate.d.ts

@@ -82,14 +82,7 @@ export interface ICertificateState {
     lastUpdated: number;
 }
 export interface IEmailOpsState {
-    currentView: 'queued' | 'sent' | 'failed' | 'received' | 'security';
-    queuedEmails: interfaces.requests.IEmailQueueItem[];
-    sentEmails: interfaces.requests.IEmailQueueItem[];
-    failedEmails: interfaces.requests.IEmailQueueItem[];
-    securityIncidents: interfaces.requests.ISecurityIncident[];
-    bounceRecords: interfaces.requests.IBounceRecord[];
-    suppressionList: string[];
-    selectedEmailId: string | null;
+    emails: interfaces.requests.IEmail[];
     isLoading: boolean;
     error: string | null;
     lastUpdated: number;
@@ -112,6 +105,15 @@ export interface IRemoteIngressState {
     lastUpdated: number;
 }
 export declare const remoteIngressStatePart: plugins.deesElement.domtools.plugins.smartstate.StatePart<string, IRemoteIngressState>;
+export interface IRouteManagementState {
+    mergedRoutes: interfaces.data.IMergedRoute[];
+    warnings: interfaces.data.IRouteWarning[];
+    apiTokens: interfaces.data.IApiTokenInfo[];
+    isLoading: boolean;
+    error: string | null;
+    lastUpdated: number;
+}
+export declare const routeManagementStatePart: plugins.deesElement.domtools.plugins.smartstate.StatePart<string, IRouteManagementState>;
 export declare const loginAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<ILoginState, {
     username: string;
     password: string;
@@ -127,14 +129,7 @@ export declare const fetchRecentLogsAction: plugins.deesElement.domtools.plugins
 export declare const toggleAutoRefreshAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IUiState, unknown>;
 export declare const setActiveViewAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IUiState, string>;
 export declare const fetchNetworkStatsAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<INetworkState, unknown>;
-export declare const setEmailOpsViewAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, "failed" | "security" | "queued" | "sent" | "received">;
-export declare const fetchQueuedEmailsAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, unknown>;
-export declare const fetchSentEmailsAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, unknown>;
-export declare const fetchFailedEmailsAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, unknown>;
-export declare const fetchSecurityIncidentsAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, unknown>;
-export declare const fetchBounceRecordsAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, unknown>;
-export declare const resendEmailAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, string>;
-export declare const removeFromSuppressionListAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, string>;
+export declare const fetchAllEmailsAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IEmailOpsState, unknown>;
 export declare const fetchCertificateOverviewAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<ICertificateState, unknown>;
 export declare const reprovisionCertificateAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<ICertificateState, string>;
 export declare const deleteCertificateAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<ICertificateState, string>;
@@ -186,3 +181,30 @@ export declare const toggleRemoteIngressAction: plugins.deesElement.domtools.plu
     id: string;
     enabled: boolean;
 }>;
+export declare const fetchMergedRoutesAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, unknown>;
+export declare const createRouteAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, {
+    route: any;
+    enabled?: boolean;
+}>;
+export declare const deleteRouteAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, string>;
+export declare const toggleRouteAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, {
+    id: string;
+    enabled: boolean;
+}>;
+export declare const setRouteOverrideAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, {
+    routeName: string;
+    enabled: boolean;
+}>;
+export declare const removeRouteOverrideAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, string>;
+export declare const fetchApiTokensAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, unknown>;
+export declare function createApiToken(name: string, scopes: interfaces.data.TApiTokenScope[], expiresInDays?: number | null): Promise<{
+    success: boolean;
+    tokenId?: string;
+    tokenValue?: string;
+    message?: string;
+}>;
+export declare const revokeApiTokenAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, string>;
+export declare const toggleApiTokenAction: plugins.deesElement.domtools.plugins.smartstate.StateAction<IRouteManagementState, {
+    id: string;
+    enabled: boolean;
+}>;