raffel 1.0.8 → 1.0.9

package/dist/adapters/index.d.ts

@@ -22,6 +22,8 @@ export { createJsonRpcAdapter, JsonRpcErrorCode, HttpMetadataKey } from './jsonr
 export type { JsonRpcAdapter, JsonRpcAdapterOptions, JsonRpcRequest, JsonRpcResponse, JsonRpcError, } from './jsonrpc.js';
 export { createGrpcAdapter } from './grpc.js';
 export type { GrpcAdapter, GrpcAdapterOptions, GrpcTlsOptions, GrpcMethodInfo } from './grpc.js';
+export { createSmtpAdapter, createSmtpClient } from './smtp.js';
+export type { SmtpAdapter, SmtpAdapterOptions, SmtpContextCapability, SmtpTlsOptions, SmtpAuthVerifier, SmtpRecipientValidator } from './smtp.js';
 export { checkConnectionFilter, checkWebSocketConnectionFilter } from './utils/connection-filter.js';
 export type { ConnectionFilter, WebSocketConnectionFilter } from './utils/connection-filter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAG/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGhF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAG7D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAG7D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACtF,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGhG,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAA;AACpG,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAG/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGhF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAG7D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAG7D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACtF,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGhG,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC/D,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAGjJ,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAA;AACpG,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/adapters/index.js

@@ -23,6 +23,8 @@ export { createUdpAdapter, createUdpClient } from './udp.js';
 export { createJsonRpcAdapter, JsonRpcErrorCode, HttpMetadataKey } from './jsonrpc.js';
 // gRPC adapter
 export { createGrpcAdapter } from './grpc.js';
+// SMTP adapter
+export { createSmtpAdapter, createSmtpClient } from './smtp.js';
 // Connection Filter (TCP, UDP, WebSocket)
 export { checkConnectionFilter, checkWebSocketConnectionFilter } from './utils/connection-filter.js';
 //# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,iDAAiD;AAEjD,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAG7C,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG5D,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG5D,uBAAuB;AACvB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAStF,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAG7C,0CAA0C;AAC1C,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,iDAAiD;AAEjD,oBAAoB;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAG7C,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG5D,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG5D,uBAAuB;AACvB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAStF,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAG7C,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAG/D,0CAA0C;AAC1C,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/adapters/smtp.d.ts

@@ -0,0 +1,152 @@
+/**
+ * SMTP Adapter
+ *
+ * Exposes Raffel services as a standards-compliant SMTP server.
+ * Translates SMTP transactions into Envelope procedure calls.
+ *
+ * Supported RFCs:
+ *   - RFC 5321 (SMTP core)
+ *   - RFC 3207 (STARTTLS)
+ *   - RFC 4954 (AUTH PLAIN / LOGIN)
+ *   - RFC 1870 (SIZE extension)
+ *   - RFC 6152 (8BITMIME)
+ *   - RFC 6531 (SMTPUTF8)
+ *   - RFC 3030 (CHUNKING / BDAT)
+ *   - RFC 2920 (PIPELINING)
+ *
+ * Protocol mapping:
+ *   SMTP transaction → procedure 'mail.receive' (configurable)
+ *   AUTH attempt      → procedure 'mail.authenticate' (configurable)
+ *   VRFY command      → procedure 'mail.verify' (configurable)
+ */
+import { type Server, type Socket } from 'node:net';
+import * as tls from 'node:tls';
+import type { Router } from '../core/router.js';
+import type { ContextSeed } from '../types/index.js';
+import { type ConnectionFilter } from './utils/connection-filter.js';
+export type SmtpState = 'greeting' | 'ready' | 'mail' | 'rcpt' | 'data' | 'bdat' | 'starttls' | 'auth_login_user' | 'auth_login_pass' | 'closing';
+export interface SmtpContextCapability {
+    readonly kind: 'smtp';
+    readonly remoteAddress?: string;
+    readonly remotePort?: number;
+    readonly sender?: string;
+    readonly recipients?: readonly string[];
+    readonly authenticated?: boolean;
+    readonly authenticatedUser?: string;
+    readonly tlsActive?: boolean;
+    readonly ehloHostname?: string;
+}
+export interface SmtpTlsOptions {
+    /** TLS certificate (PEM) */
+    cert: string | Buffer;
+    /** TLS private key (PEM) */
+    key: string | Buffer;
+    /** CA certificates for client verification (optional) */
+    ca?: string | Buffer | Array<string | Buffer>;
+    /** Minimum TLS version (default: TLSv1.2) */
+    minVersion?: tls.SecureVersion;
+}
+export interface SmtpTimeouts {
+    greeting?: number;
+    command?: number;
+    data?: number;
+    quit?: number;
+    tls?: number;
+}
+/** Auth verifier: return true to accept, false to reject */
+export type SmtpAuthVerifier = (username: string, password: string, info: {
+    remoteAddress: string;
+    remotePort: number;
+    tlsActive: boolean;
+}) => boolean | Promise<boolean>;
+/** Recipient validator: return true to accept, false → 550 */
+export type SmtpRecipientValidator = (recipient: string, sender: string, info: {
+    remoteAddress: string;
+    authenticated: boolean;
+    authenticatedUser?: string;
+}) => boolean | Promise<boolean>;
+/**
+ * SMTP adapter configuration
+ */
+export interface SmtpAdapterOptions {
+    /** Port to listen on (25 = relay, 587 = submission, 465 = SMTPS) */
+    port: number;
+    /** Host to bind to (default: '0.0.0.0') */
+    host?: string;
+    /** Server hostname for EHLO greeting */
+    hostname?: string;
+    /** Maximum message size in bytes (default: 50MB) */
+    maxMessageSize?: number;
+    /** Maximum recipients per message (default: 100) */
+    maxRecipients?: number;
+    /** Maximum failed AUTH attempts per connection (default: 5) */
+    maxAuthAttempts?: number;
+    /** SMTP-specific timeouts */
+    timeouts?: SmtpTimeouts;
+    /** TLS config for STARTTLS (omit to disable STARTTLS) */
+    tls?: SmtpTlsOptions;
+    /** Implicit TLS (port 465 / SMTPS) — wraps socket in TLS immediately */
+    implicitTls?: boolean;
+    /** Require TLS before accepting mail (default: false) */
+    requireTls?: boolean;
+    /** Require AUTH before accepting mail (default: false) */
+    requireAuth?: boolean;
+    /** Only allow AUTH over TLS (default: true — RFC 4954 compliance) */
+    authRequiresTls?: boolean;
+    /** AUTH credential verifier */
+    authVerifier?: SmtpAuthVerifier;
+    /** Recipient validator (called on each RCPT TO) */
+    recipientValidator?: SmtpRecipientValidator;
+    /** Procedure name for mail delivery (default: 'mail.receive') */
+    deliverProcedure?: string;
+    /** Procedure name for auth (default: 'mail.authenticate') */
+    authProcedure?: string;
+    /** Procedure name for VRFY (default: 'mail.verify') */
+    verifyProcedure?: string;
+    /** SMTP banner text (after 220 hostname) */
+    banner?: string;
+    /** Context factory for creating request context */
+    contextFactory?: (socket: Socket) => ContextSeed | Promise<ContextSeed>;
+    /** Inbound connection filter */
+    filter?: ConnectionFilter;
+}
+/**
+ * SMTP connection handler for established sockets
+ */
+export interface SmtpConnectionHandler {
+    handleConnection(socket: Socket): void;
+    closeAllConnections(): void;
+    readonly clientCount: number;
+}
+/**
+ * SMTP Adapter interface
+ */
+export interface SmtpAdapter {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    readonly clientCount: number;
+    readonly server: Server | null;
+}
+export declare function createSmtpConnectionHandler(router: Router, options: Omit<SmtpAdapterOptions, 'port' | 'host' | 'filter'>): SmtpConnectionHandler;
+export declare function createSmtpAdapter(router: Router, options: SmtpAdapterOptions): SmtpAdapter;
+/**
+ * Helper: Create an SMTP client for testing/usage
+ */
+export declare function createSmtpClient(options: {
+    host: string;
+    port: number;
+    tls?: boolean;
+    tlsOptions?: tls.ConnectionOptions;
+}): {
+    connect(): Promise<string>;
+    command(cmd: string): Promise<string>;
+    sendMail(options: {
+        from: string;
+        to: string | string[];
+        subject?: string;
+        body?: string;
+        headers?: Record<string, string>;
+    }): Promise<string>;
+    disconnect(): void;
+};
+//# sourceMappingURL=smtp.d.ts.map

package/dist/adapters/smtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.d.ts","sourceRoot":"","sources":["../../src/adapters/smtp.ts"],"names":[],"mappings":"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"}