@upyo/smtp 0.1.0-dev.14 → 0.1.0-dev.17

package/dist/index.cjs

@@ -31,21 +31,11 @@ const __upyo_core = __toESM(require("@upyo/core"));
 *
 * This function takes a partial SMTP configuration and returns a complete
 * configuration with all optional fields filled with sensible defaults.
+* It is used internally by the SMTP transport.
 *
 * @param config - The SMTP configuration with optional fields
 * @returns A resolved configuration with all defaults applied
-*
-* @example
-* ```typescript
-* const resolved = createSmtpConfig({
-*   host: 'smtp.example.com',
-*   auth: { user: 'user', pass: 'pass' }
-* });
-*
-* // resolved.port will be 587 (default)
-* // resolved.secure will be true (default)
-* // resolved.poolSize will be 5 (default)
-* ```
+* @internal
 */
 function createSmtpConfig(config) {
 	return {
@@ -428,9 +418,15 @@ function encodeBase64(data) {
 * ```
 */
 var SmtpTransport = class {
+	/**
+	* The SMTP configuration used by this transport.
+	*/
 	config;
-	connectionPool = [];
+	/**
+	* The maximum number of connections in the pool.
+	*/
 	poolSize;
+	connectionPool = [];
 	/**
 	* Creates a new SMTP transport instance.
 	*
@@ -653,5 +649,4 @@ var SmtpTransport = class {
 };
 
 //#endregion
-exports.SmtpTransport = SmtpTransport;
-exports.createSmtpConfig = createSmtpConfig;
+exports.SmtpTransport = SmtpTransport;

package/dist/index.d.cts

@@ -1,6 +1,4 @@
 import { Message, Receipt, Transport, TransportOptions } from "@upyo/core";
-import { Socket } from "node:net";
-import { TLSSocket } from "node:tls";
 
 //#region src/config.d.ts
 
@@ -154,67 +152,6 @@ interface SmtpTlsOptions {
  * This type represents the final configuration after applying defaults,
  * used internally by the SMTP transport implementation.
  */
-type ResolvedSmtpConfig = Omit<Required<SmtpConfig>, "auth" | "tls"> & {
-  readonly auth?: SmtpAuth;
-  readonly tls?: SmtpTlsOptions;
-};
-/**
- * Creates a resolved SMTP configuration by applying default values to optional fields.
- *
- * This function takes a partial SMTP configuration and returns a complete
- * configuration with all optional fields filled with sensible defaults.
- *
- * @param config - The SMTP configuration with optional fields
- * @returns A resolved configuration with all defaults applied
- *
- * @example
- * ```typescript
- * const resolved = createSmtpConfig({
- *   host: 'smtp.example.com',
- *   auth: { user: 'user', pass: 'pass' }
- * });
- *
- * // resolved.port will be 587 (default)
- * // resolved.secure will be true (default)
- * // resolved.poolSize will be 5 (default)
- * ```
- */
-declare function createSmtpConfig(config: SmtpConfig): ResolvedSmtpConfig;
-//#endregion
-//#region src/message-converter.d.ts
-interface SmtpMessage {
-  readonly envelope: SmtpEnvelope;
-  readonly raw: string;
-}
-interface SmtpEnvelope {
-  readonly from: string;
-  readonly to: string[];
-}
-//#endregion
-//#region src/smtp-connection.d.ts
-declare class SmtpConnection {
-  socket: Socket | TLSSocket | null;
-  config: ResolvedSmtpConfig;
-  authenticated: boolean;
-  capabilities: string[];
-  constructor(config: SmtpConfig);
-  connect(signal?: AbortSignal): Promise<void>;
-  sendCommand(command: string, signal?: AbortSignal): Promise<SmtpResponse>;
-  greeting(signal?: AbortSignal): Promise<SmtpResponse>;
-  ehlo(signal?: AbortSignal): Promise<void>;
-  authenticate(signal?: AbortSignal): Promise<void>;
-  private authPlain;
-  authLogin(signal?: AbortSignal): Promise<void>;
-  sendMessage(message: SmtpMessage, signal?: AbortSignal): Promise<string>;
-  extractMessageId(response: string): string;
-  quit(): Promise<void>;
-  reset(signal?: AbortSignal): Promise<void>;
-}
-interface SmtpResponse {
-  readonly code: number;
-  readonly message: string;
-  readonly raw: string;
-}
 //#endregion
 //#region src/smtp-transport.d.ts
 /**
@@ -251,9 +188,15 @@ interface SmtpResponse {
  * ```
  */
 declare class SmtpTransport implements Transport, AsyncDisposable {
+  /**
+   * The SMTP configuration used by this transport.
+   */
   config: SmtpConfig;
-  connectionPool: SmtpConnection[];
+  /**
+   * The maximum number of connections in the pool.
+   */
   poolSize: number;
+  private connectionPool;
   /**
    * Creates a new SMTP transport instance.
    *
@@ -317,10 +260,10 @@ declare class SmtpTransport implements Transport, AsyncDisposable {
    * @returns An async iterable of receipts, one for each message.
    */
   sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
-  getConnection(signal?: AbortSignal): Promise<SmtpConnection>;
-  connectAndSetup(connection: SmtpConnection, signal?: AbortSignal): Promise<void>;
-  returnConnection(connection: SmtpConnection): Promise<void>;
-  discardConnection(connection: SmtpConnection): Promise<void>;
+  private getConnection;
+  private connectAndSetup;
+  private returnConnection;
+  private discardConnection;
   /**
    * Closes all active SMTP connections in the connection pool.
    *
@@ -352,4 +295,4 @@ declare class SmtpTransport implements Transport, AsyncDisposable {
   [Symbol.asyncDispose](): Promise<void>;
 }
 //#endregion
-export { SmtpAuth, SmtpConfig, SmtpTlsOptions, SmtpTransport, createSmtpConfig };
+export { SmtpAuth, SmtpConfig, SmtpTlsOptions, SmtpTransport };

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-import { Socket } from "node:net";
-import { TLSSocket } from "node:tls";
 import { Message, Receipt, Transport, TransportOptions } from "@upyo/core";
 
 //#region src/config.d.ts
@@ -154,67 +152,6 @@ interface SmtpTlsOptions {
  * This type represents the final configuration after applying defaults,
  * used internally by the SMTP transport implementation.
  */
-type ResolvedSmtpConfig = Omit<Required<SmtpConfig>, "auth" | "tls"> & {
-  readonly auth?: SmtpAuth;
-  readonly tls?: SmtpTlsOptions;
-};
-/**
- * Creates a resolved SMTP configuration by applying default values to optional fields.
- *
- * This function takes a partial SMTP configuration and returns a complete
- * configuration with all optional fields filled with sensible defaults.
- *
- * @param config - The SMTP configuration with optional fields
- * @returns A resolved configuration with all defaults applied
- *
- * @example
- * ```typescript
- * const resolved = createSmtpConfig({
- *   host: 'smtp.example.com',
- *   auth: { user: 'user', pass: 'pass' }
- * });
- *
- * // resolved.port will be 587 (default)
- * // resolved.secure will be true (default)
- * // resolved.poolSize will be 5 (default)
- * ```
- */
-declare function createSmtpConfig(config: SmtpConfig): ResolvedSmtpConfig;
-//#endregion
-//#region src/message-converter.d.ts
-interface SmtpMessage {
-  readonly envelope: SmtpEnvelope;
-  readonly raw: string;
-}
-interface SmtpEnvelope {
-  readonly from: string;
-  readonly to: string[];
-}
-//#endregion
-//#region src/smtp-connection.d.ts
-declare class SmtpConnection {
-  socket: Socket | TLSSocket | null;
-  config: ResolvedSmtpConfig;
-  authenticated: boolean;
-  capabilities: string[];
-  constructor(config: SmtpConfig);
-  connect(signal?: AbortSignal): Promise<void>;
-  sendCommand(command: string, signal?: AbortSignal): Promise<SmtpResponse>;
-  greeting(signal?: AbortSignal): Promise<SmtpResponse>;
-  ehlo(signal?: AbortSignal): Promise<void>;
-  authenticate(signal?: AbortSignal): Promise<void>;
-  private authPlain;
-  authLogin(signal?: AbortSignal): Promise<void>;
-  sendMessage(message: SmtpMessage, signal?: AbortSignal): Promise<string>;
-  extractMessageId(response: string): string;
-  quit(): Promise<void>;
-  reset(signal?: AbortSignal): Promise<void>;
-}
-interface SmtpResponse {
-  readonly code: number;
-  readonly message: string;
-  readonly raw: string;
-}
 //#endregion
 //#region src/smtp-transport.d.ts
 /**
@@ -251,9 +188,15 @@ interface SmtpResponse {
  * ```
  */
 declare class SmtpTransport implements Transport, AsyncDisposable {
+  /**
+   * The SMTP configuration used by this transport.
+   */
   config: SmtpConfig;
-  connectionPool: SmtpConnection[];
+  /**
+   * The maximum number of connections in the pool.
+   */
   poolSize: number;
+  private connectionPool;
   /**
    * Creates a new SMTP transport instance.
    *
@@ -317,10 +260,10 @@ declare class SmtpTransport implements Transport, AsyncDisposable {
    * @returns An async iterable of receipts, one for each message.
    */
   sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
-  getConnection(signal?: AbortSignal): Promise<SmtpConnection>;
-  connectAndSetup(connection: SmtpConnection, signal?: AbortSignal): Promise<void>;
-  returnConnection(connection: SmtpConnection): Promise<void>;
-  discardConnection(connection: SmtpConnection): Promise<void>;
+  private getConnection;
+  private connectAndSetup;
+  private returnConnection;
+  private discardConnection;
   /**
    * Closes all active SMTP connections in the connection pool.
    *
@@ -352,4 +295,4 @@ declare class SmtpTransport implements Transport, AsyncDisposable {
   [Symbol.asyncDispose](): Promise<void>;
 }
 //#endregion
-export { SmtpAuth, SmtpConfig, SmtpTlsOptions, SmtpTransport, createSmtpConfig };
+export { SmtpAuth, SmtpConfig, SmtpTlsOptions, SmtpTransport };

package/dist/index.js

@@ -8,21 +8,11 @@ import { formatAddress } from "@upyo/core";
 *
 * This function takes a partial SMTP configuration and returns a complete
 * configuration with all optional fields filled with sensible defaults.
+* It is used internally by the SMTP transport.
 *
 * @param config - The SMTP configuration with optional fields
 * @returns A resolved configuration with all defaults applied
-*
-* @example
-* ```typescript
-* const resolved = createSmtpConfig({
-*   host: 'smtp.example.com',
-*   auth: { user: 'user', pass: 'pass' }
-* });
-*
-* // resolved.port will be 587 (default)
-* // resolved.secure will be true (default)
-* // resolved.poolSize will be 5 (default)
-* ```
+* @internal
 */
 function createSmtpConfig(config) {
 	return {
@@ -405,9 +395,15 @@ function encodeBase64(data) {
 * ```
 */
 var SmtpTransport = class {
+	/**
+	* The SMTP configuration used by this transport.
+	*/
 	config;
-	connectionPool = [];
+	/**
+	* The maximum number of connections in the pool.
+	*/
 	poolSize;
+	connectionPool = [];
 	/**
 	* Creates a new SMTP transport instance.
 	*
@@ -630,4 +626,4 @@ var SmtpTransport = class {
 };
 
 //#endregion
-export { SmtpTransport, createSmtpConfig };
+export { SmtpTransport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/smtp",
-  "version": "0.1.0-dev.14+1ceb3382",
+  "version": "0.1.0-dev.17+3ffd074a",
   "description": "SMTP transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,7 +53,7 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.1.0-dev.14+1ceb3382"
+    "@upyo/core": "0.1.0-dev.17+3ffd074a"
   },
   "devDependencies": {
     "@dotenvx/dotenvx": "^1.47.3",