@bernierllc/email-domain-verification 1.1.0 → 3.0.0

package/dist/EmailDomainVerificationService.js

@@ -26,6 +26,11 @@ const errors_1 = require("./errors");
  * DNS record generation, propagation monitoring, and health checks.
  */
 class EmailDomainVerificationService {
+    logger;
+    neverhub;
+    httpClient;
+    healthCheckJobs;
+    verificationHistory;
     constructor(config) {
         this.logger = config?.logger || new logger_1.Logger({
             level: logger_1.LogLevel.INFO,

package/dist/errors.d.ts

@@ -1,20 +1,30 @@
 /**
- * Domain verification error types
+ * Domain verification error codes (string literal union — discriminating code values).
+ */
+export type DomainVerificationErrorCode = 'DOMAIN_VERIFICATION_ERROR' | 'DNS_PROPAGATION_ERROR' | 'PROVIDER_API_ERROR' | 'INVALID_DOMAIN' | 'INVALID_INPUT' | 'OPERATION_FAILED';
+export interface DomainVerificationErrorOptions {
+    cause?: Error;
+    code?: DomainVerificationErrorCode;
+    context?: Record<string, unknown>;
+}
+/**
+ * Base domain verification error, following the Wave 2/3 standard shape:
+ * options-based constructor, ES2022 `cause`, typed `code`, `context` bag for
+ * legacy positional fields (e.g. `retryable`, `details`).
  */
 export declare class DomainVerificationError extends Error {
-    code: string;
-    retryable: boolean;
-    details?: unknown | undefined;
-    constructor(message: string, code: string, retryable?: boolean, details?: unknown | undefined);
+    readonly code: DomainVerificationErrorCode;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options?: DomainVerificationErrorOptions);
 }
 export declare class DNSPropagationError extends DomainVerificationError {
-    constructor(message: string, details?: unknown);
+    constructor(message: string, options?: Omit<DomainVerificationErrorOptions, 'code'>);
 }
 export declare class ProviderAPIError extends DomainVerificationError {
-    constructor(message: string, details?: unknown);
+    constructor(message: string, options?: Omit<DomainVerificationErrorOptions, 'code'>);
 }
 export declare class InvalidDomainError extends DomainVerificationError {
-    constructor(message: string, details?: unknown);
+    constructor(message: string, options?: Omit<DomainVerificationErrorOptions, 'code'>);
 }
 /**
  * Structured result pattern for all service operations
@@ -34,6 +44,7 @@ export interface ServiceResult<T = unknown> {
  */
 export declare function successResult<T>(data: T): ServiceResult<T>;
 /**
- * Helper to create error result
+ * Helper to create error result. `retryable` and `details` are read from
+ * `error.context` (the standard location for legacy positional fields).
  */
 export declare function errorResult(error: DomainVerificationError): ServiceResult;

package/dist/errors.js

@@ -11,35 +11,53 @@ exports.InvalidDomainError = exports.ProviderAPIError = exports.DNSPropagationEr
 exports.successResult = successResult;
 exports.errorResult = errorResult;
 /**
- * Domain verification error types
+ * Base domain verification error, following the Wave 2/3 standard shape:
+ * options-based constructor, ES2022 `cause`, typed `code`, `context` bag for
+ * legacy positional fields (e.g. `retryable`, `details`).
  */
 class DomainVerificationError extends Error {
-    constructor(message, code, retryable = false, details) {
-        super(message);
-        this.code = code;
-        this.retryable = retryable;
-        this.details = details;
+    code;
+    context;
+    constructor(message, options) {
+        super(message, options?.cause ? { cause: options.cause } : undefined);
         this.name = 'DomainVerificationError';
+        this.code = options?.code ?? 'DOMAIN_VERIFICATION_ERROR';
+        if (options?.context !== undefined) {
+            this.context = options.context;
+        }
+        Error.captureStackTrace?.(this, this.constructor);
     }
 }
 exports.DomainVerificationError = DomainVerificationError;
 class DNSPropagationError extends DomainVerificationError {
-    constructor(message, details) {
-        super(message, 'DNS_PROPAGATION_ERROR', true, details);
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            code: 'DNS_PROPAGATION_ERROR',
+            context: { retryable: true, ...(options?.context ?? {}) }
+        });
         this.name = 'DNSPropagationError';
     }
 }
 exports.DNSPropagationError = DNSPropagationError;
 class ProviderAPIError extends DomainVerificationError {
-    constructor(message, details) {
-        super(message, 'PROVIDER_API_ERROR', true, details);
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            code: 'PROVIDER_API_ERROR',
+            context: { retryable: true, ...(options?.context ?? {}) }
+        });
         this.name = 'ProviderAPIError';
     }
 }
 exports.ProviderAPIError = ProviderAPIError;
 class InvalidDomainError extends DomainVerificationError {
-    constructor(message, details) {
-        super(message, 'INVALID_DOMAIN', false, details);
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            code: 'INVALID_DOMAIN',
+            context: { retryable: false, ...(options?.context ?? {}) }
+        });
         this.name = 'InvalidDomainError';
     }
 }
@@ -51,16 +69,18 @@ function successResult(data) {
     return { success: true, data };
 }
 /**
- * Helper to create error result
+ * Helper to create error result. `retryable` and `details` are read from
+ * `error.context` (the standard location for legacy positional fields).
  */
 function errorResult(error) {
+    const ctx = error.context ?? {};
     return {
         success: false,
         error: {
             code: error.code,
             message: error.message,
-            retryable: error.retryable,
-            details: error.details
+            retryable: typeof ctx.retryable === 'boolean' ? ctx.retryable : false,
+            details: ctx.details
         }
     };
 }

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@bernierllc/email-domain-verification",
-  "version": "1.1.0",
+  "version": "3.0.0",
   "description": "Programmatic domain setup and DNS management for production email sending with multi-provider support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
   "keywords": [
     "email",
     "domain",
@@ -25,10 +29,10 @@
     "cron": "^3.1.6",
     "dns-packet": "^5.6.1",
     "dns2": "^2.1.0",
-    "@bernierllc/crypto-utils": "1.3.0",
-    "@bernierllc/email-sender-manager": "1.5.0",
-    "@bernierllc/logger": "1.6.0",
-    "@bernierllc/neverhub-adapter": "0.3.0"
+    "@bernierllc/crypto-utils": "1.4.0",
+    "@bernierllc/email-sender-manager": "1.6.0",
+    "@bernierllc/logger": "1.7.0",
+    "@bernierllc/neverhub-adapter": "0.4.0"
   },
   "devDependencies": {
     "@types/cron": "^2.0.1",

package/.eslintrc.cjs

@@ -1,29 +0,0 @@
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-
-module.exports = {
-  parser: '@typescript-eslint/parser',
-  extends: [
-    'eslint:recommended',
-    'plugin:@typescript-eslint/recommended',
-  ],
-  parserOptions: {
-    ecmaVersion: 2020,
-    sourceType: 'module',
-  },
-  rules: {
-    '@typescript-eslint/no-explicit-any': 'warn',
-    '@typescript-eslint/explicit-module-boundary-types': 'off',
-    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
-  },
-  env: {
-    node: true,
-    es6: true,
-    jest: true,
-  },
-};

package/CHANGELOG.md

@@ -1,121 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-# 1.1.0 (2026-05-20)
-
-
-### Features
-
-* **contentful-types:** es2022, errors.ts with error.cause ([b74c636](https://github.com/bernierllc/tools/commit/b74c636e9c4675885c9386dcd413c5163a166ef8))
-
-
-
-
-
-## [1.0.12](https://github.com/bernierllc/tools/compare/@bernierllc/email-domain-verification@1.0.11...@bernierllc/email-domain-verification@1.0.12) (2026-05-19)
-
-**Note:** Version bump only for package @bernierllc/email-domain-verification
-
-
-
-
-
-## [1.0.11](https://github.com/bernierllc/tools/compare/@bernierllc/email-domain-verification@1.0.10...@bernierllc/email-domain-verification@1.0.11) (2026-05-19)
-
-**Note:** Version bump only for package @bernierllc/email-domain-verification
-
-
-
-
-
-## [1.0.10](https://github.com/bernierllc/tools/compare/@bernierllc/email-domain-verification@1.0.9...@bernierllc/email-domain-verification@1.0.10) (2026-03-30)
-
-**Note:** Version bump only for package @bernierllc/email-domain-verification
-
-
-
-
-
-## [1.0.9](https://github.com/bernierllc/tools/compare/@bernierllc/email-domain-verification@1.0.8...@bernierllc/email-domain-verification@1.0.9) (2026-03-21)
-
-**Note:** Version bump only for package @bernierllc/email-domain-verification
-
-
-
-
-
-## [1.0.8](https://github.com/bernierllc/tools/compare/@bernierllc/email-domain-verification@1.0.7...@bernierllc/email-domain-verification@1.0.8) (2026-03-09)
-
-
-### Bug Fixes
-
-* **email:** sync provider type unions across email packages ([b515e54](https://github.com/bernierllc/tools/commit/b515e5456da4ce6fd6067d20e4da010d658e3a2b))
-
-
-
-
-
-## [1.0.7](https://github.com/bernierllc/tools/compare/@bernierllc/email-domain-verification@1.0.6...@bernierllc/email-domain-verification@1.0.7) (2026-03-03)
-
-**Note:** Version bump only for package @bernierllc/email-domain-verification
-
-
-
-
-
-## 1.0.6 (2025-12-25)
-
-
-### Bug Fixes
-
-* **ci:** add lerna version step before publish ([3d20300](https://github.com/bernierllc/tools/commit/3d203002143bf353fffafe4f8a78a99009567347))
-* **ci:** fix release workflow + convert internal deps to workspace:* ([01c078b](https://github.com/bernierllc/tools/commit/01c078b49d6025f7eef750f79207a1c71c8d85dc))
-* update neverhub-adapter deps to workspace:* and publish 0.1.2 ([f0e3d04](https://github.com/bernierllc/tools/commit/f0e3d04d8d4f094e3bb899ddf81e93243d16e2c2))
-
-
-
-
-
-## 1.0.5 (2025-12-25)
-
-
-### Bug Fixes
-
-* **ci:** fix release workflow + convert internal deps to workspace:* ([01c078b](https://github.com/bernierllc/tools/commit/01c078b49d6025f7eef750f79207a1c71c8d85dc))
-* update neverhub-adapter deps to workspace:* and publish 0.1.2 ([f0e3d04](https://github.com/bernierllc/tools/commit/f0e3d04d8d4f094e3bb899ddf81e93243d16e2c2))
-
-
-
-
-
-# @bernierllc/email-domain-verification
-
-## 1.0.4
-
-### Patch Changes
-
-- Updated dependencies [[`73c1d1e`](https://github.com/bernierllc/tools/commit/73c1d1e46114cf2ccfd5b74b83743361247f4502)]:
-  - @bernierllc/logger@1.1.0
-
-## 1.0.3
-
-### Patch Changes
-
-- Updated dependencies [[`24899fa`](https://github.com/bernierllc/tools/commit/24899fa4eaf80ae329f7bd74483cf97a132f5d4c)]:
-  - @bernierllc/logger@1.0.4
-
-## 1.0.2
-
-### Patch Changes
-
-- Updated dependencies [[`a314763`](https://github.com/bernierllc/tools/commit/a31476336717301e410da2b0b64c8f1ee44c0e8d)]:
-  - @bernierllc/crypto-utils@1.0.4
-
-## 1.0.1
-
-### Patch Changes
-
-- Updated dependencies [[`a65f28c`](https://github.com/bernierllc/tools/commit/a65f28c2a1d09da8e8c7c23dcebd8f6606d9783f)]:
-  - @bernierllc/crypto-utils@1.0.3

package/__mocks__/@bernierllc/crypto-utils.ts

@@ -1,15 +0,0 @@
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-
-export async function generateUUIDKey(): Promise<{ key: string }> {
-  return { key: `test-uuid-${Date.now()}-${Math.random().toString(36).substr(2, 9)}` };
-}
-
-export function generateSecureToken(length = 32): string {
-  return Array(length).fill(0).map(() => Math.random().toString(36).charAt(2)).join('');
-}

package/__mocks__/@bernierllc/logger.ts

@@ -1,42 +0,0 @@
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-
-export enum LogLevel {
-  DEBUG = 0,
-  INFO = 1,
-  WARN = 2,
-  ERROR = 3,
-  FATAL = 4,
-  SILENT = 5
-}
-
-export interface LoggerOptions {
-  level?: LogLevel;
-  transports?: unknown[];
-  context?: Record<string, unknown>;
-  enableCorrelation?: boolean;
-  sanitize?: boolean;
-  sanitizeFields?: string[];
-  onError?: (error: Error, transport: string) => void;
-}
-
-export class Logger {
-  constructor(_options: LoggerOptions) {}
-
-  debug(_message: string, _metadata?: Record<string, unknown>): void {}
-  info(_message: string, _metadata?: Record<string, unknown>): void {}
-  warn(_message: string, _metadata?: Record<string, unknown>): void {}
-  error(_message: string, _metadata?: Record<string, unknown>): void {}
-  fatal(_message: string, _metadata?: Record<string, unknown>): void {}
-}
-
-export class ConsoleTransport {
-  constructor(_options: { level?: LogLevel } = {}) {}
-}
-
-export const createLogger = (options: LoggerOptions = { level: LogLevel.SILENT }) => new Logger(options);

package/__mocks__/@bernierllc/neverhub-adapter.ts

@@ -1,17 +0,0 @@
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-
-export class NeverHubAdapter {
-  static async detect(): Promise<boolean> {
-    return false;
-  }
-
-  async register(_config: Record<string, unknown>): Promise<void> {}
-  async publishEvent(_event: Record<string, unknown>): Promise<void> {}
-  async subscribe(_eventType: string, _handler: (event: unknown) => void): Promise<void> {}
-}