@sudobility/types 1.9.53 → 1.9.55

package/dist/types/blockchain/index.cjs

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Blockchain types entry point.
+ *
+ * Import from `@sudobility/types/blockchain` to load only blockchain-
+ * related types, interfaces, enums, and validators without pulling in
+ * the rest of the library.
+ *
+ * @since 1.9.54
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMessage = exports.validateDomain = exports.validateAmount = exports.validateAddress = exports.isSolanaRecipient = exports.isSolanaAddress = exports.isEvmRecipient = exports.isEvmAddress = exports.TransactionStatus = exports.PROTOCOL_CONSTANTS = exports.MessageType = void 0;
+// Enums and constants
+var common_1 = require("./common");
+Object.defineProperty(exports, "MessageType", { enumerable: true, get: function () { return common_1.MessageType; } });
+Object.defineProperty(exports, "PROTOCOL_CONSTANTS", { enumerable: true, get: function () { return common_1.PROTOCOL_CONSTANTS; } });
+Object.defineProperty(exports, "TransactionStatus", { enumerable: true, get: function () { return common_1.TransactionStatus; } });
+// Type guards
+var common_2 = require("./common");
+Object.defineProperty(exports, "isEvmAddress", { enumerable: true, get: function () { return common_2.isEvmAddress; } });
+Object.defineProperty(exports, "isEvmRecipient", { enumerable: true, get: function () { return common_2.isEvmRecipient; } });
+Object.defineProperty(exports, "isSolanaAddress", { enumerable: true, get: function () { return common_2.isSolanaAddress; } });
+Object.defineProperty(exports, "isSolanaRecipient", { enumerable: true, get: function () { return common_2.isSolanaRecipient; } });
+// Validators
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "validateAddress", { enumerable: true, get: function () { return validation_1.validateAddress; } });
+Object.defineProperty(exports, "validateAmount", { enumerable: true, get: function () { return validation_1.validateAmount; } });
+Object.defineProperty(exports, "validateDomain", { enumerable: true, get: function () { return validation_1.validateDomain; } });
+Object.defineProperty(exports, "validateMessage", { enumerable: true, get: function () { return validation_1.validateMessage; } });
+//# sourceMappingURL=index.js.map

package/dist/types/blockchain/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Blockchain types entry point.
+ *
+ * Import from `@sudobility/types/blockchain` to load only blockchain-
+ * related types, interfaces, enums, and validators without pulling in
+ * the rest of the library.
+ *
+ * @since 1.9.54
+ */
+export type { ChainConfig, ClaimableRevenue, ClientConfig, DeploymentAddresses, FeeStructure, Message, MessageFilter, MessageRecipient, OperationError, PreparedMessage, RpcConfig, SendMessageOptions, TransactionResult, } from './common';
+export { MessageType, PROTOCOL_CONSTANTS, TransactionStatus, } from './common';
+export { isEvmAddress, isEvmRecipient, isSolanaAddress, isSolanaRecipient, } from './common';
+export { validateAddress, validateAmount, validateDomain, validateMessage, } from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/blockchain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/blockchain/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/types/blockchain/index.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Blockchain types entry point.
+ *
+ * Import from `@sudobility/types/blockchain` to load only blockchain-
+ * related types, interfaces, enums, and validators without pulling in
+ * the rest of the library.
+ *
+ * @since 1.9.54
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateMessage = exports.validateDomain = exports.validateAmount = exports.validateAddress = exports.isSolanaRecipient = exports.isSolanaAddress = exports.isEvmRecipient = exports.isEvmAddress = exports.TransactionStatus = exports.PROTOCOL_CONSTANTS = exports.MessageType = void 0;
+// Enums and constants
+var common_1 = require("./common");
+Object.defineProperty(exports, "MessageType", { enumerable: true, get: function () { return common_1.MessageType; } });
+Object.defineProperty(exports, "PROTOCOL_CONSTANTS", { enumerable: true, get: function () { return common_1.PROTOCOL_CONSTANTS; } });
+Object.defineProperty(exports, "TransactionStatus", { enumerable: true, get: function () { return common_1.TransactionStatus; } });
+// Type guards
+var common_2 = require("./common");
+Object.defineProperty(exports, "isEvmAddress", { enumerable: true, get: function () { return common_2.isEvmAddress; } });
+Object.defineProperty(exports, "isEvmRecipient", { enumerable: true, get: function () { return common_2.isEvmRecipient; } });
+Object.defineProperty(exports, "isSolanaAddress", { enumerable: true, get: function () { return common_2.isSolanaAddress; } });
+Object.defineProperty(exports, "isSolanaRecipient", { enumerable: true, get: function () { return common_2.isSolanaRecipient; } });
+// Validators
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "validateAddress", { enumerable: true, get: function () { return validation_1.validateAddress; } });
+Object.defineProperty(exports, "validateAmount", { enumerable: true, get: function () { return validation_1.validateAmount; } });
+Object.defineProperty(exports, "validateDomain", { enumerable: true, get: function () { return validation_1.validateDomain; } });
+Object.defineProperty(exports, "validateMessage", { enumerable: true, get: function () { return validation_1.validateMessage; } });
+//# sourceMappingURL=index.js.map

package/dist/types/blockchain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/blockchain/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAmBH,sBAAsB;AACtB,mCAIkB;AAHhB,qGAAA,WAAW,OAAA;AACX,4GAAA,kBAAkB,OAAA;AAClB,2GAAA,iBAAiB,OAAA;AAGnB,cAAc;AACd,mCAKkB;AAJhB,sGAAA,YAAY,OAAA;AACZ,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AAGnB,aAAa;AACb,2CAKsB;AAJpB,6GAAA,eAAe,OAAA;AACf,4GAAA,cAAc,OAAA;AACd,4GAAA,cAAc,OAAA;AACd,6GAAA,eAAe,OAAA"}

package/dist/types/blockchain/validation.cjs

@@ -1,6 +1,9 @@
 "use strict";
 /**
- * Validation utilities for multi-chain operations
+ * Validation utilities for multi-chain operations.
+ * All validators throw on invalid input.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateDomain = validateDomain;
@@ -8,6 +11,20 @@ exports.validateMessage = validateMessage;
 exports.validateAddress = validateAddress;
 exports.validateAmount = validateAmount;
 const address_1 = require("../../utils/blockchain/address");
+/**
+ * Validate a domain name format.
+ *
+ * @param domain - Domain string to validate
+ * @returns True if valid
+ * @throws Error if domain is empty, too long, or has invalid format
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateDomain('example.com'); // true
+ * validateDomain('');            // throws "Domain cannot be empty"
+ * ```
+ */
 function validateDomain(domain) {
     if (!domain || domain.length === 0) {
         throw new Error('Domain cannot be empty');
@@ -22,6 +39,15 @@ function validateDomain(domain) {
     }
     return true;
 }
+/**
+ * Validate a message subject and body against length constraints.
+ *
+ * @param subject - Message subject (max 200 chars)
+ * @param body - Message body (max 10000 chars)
+ * @returns True if valid
+ * @throws Error if subject or body is empty or exceeds limits
+ * @since 1.0.0
+ */
 function validateMessage(subject, body) {
     if (!subject || subject.length === 0) {
         throw new Error('Message subject cannot be empty');
@@ -37,6 +63,20 @@ function validateMessage(subject, body) {
     }
     return true;
 }
+/**
+ * Validate a wallet address for a specific chain type.
+ *
+ * @param address - Wallet address to validate
+ * @param chainType - Target blockchain type (EVM or Solana)
+ * @returns True if valid
+ * @throws Error if address is empty or has invalid format
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateAddress('0x742d35Cc6634C0532925a3b844e2', ChainType.EVM);
+ * ```
+ */
 function validateAddress(address, chainType) {
     if (!address || address.length === 0) {
         throw new Error('Address cannot be empty');
@@ -46,6 +86,22 @@ function validateAddress(address, chainType) {
     }
     return true;
 }
+/**
+ * Validate and convert an amount to a non-negative bigint.
+ * Accepts string, number, or bigint input.
+ *
+ * @param amount - Amount value to validate
+ * @returns The validated amount as bigint
+ * @throws Error if amount is invalid, non-numeric, or negative
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateAmount('1000');  // 1000n
+ * validateAmount(500);     // 500n
+ * validateAmount(-1);      // throws "Amount cannot be negative"
+ * ```
+ */
 function validateAmount(amount) {
     // Check for null, undefined, or empty string
     if (amount === null ||

package/dist/types/blockchain/validation.d.ts

@@ -1,9 +1,65 @@
 /**
- * Validation utilities for multi-chain operations
+ * Validation utilities for multi-chain operations.
+ * All validators throw on invalid input.
+ *
+ * @since 1.0.0
  */
 import { ChainType } from '../business/enums';
+/**
+ * Validate a domain name format.
+ *
+ * @param domain - Domain string to validate
+ * @returns True if valid
+ * @throws Error if domain is empty, too long, or has invalid format
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateDomain('example.com'); // true
+ * validateDomain('');            // throws "Domain cannot be empty"
+ * ```
+ */
 export declare function validateDomain(domain: string): boolean;
+/**
+ * Validate a message subject and body against length constraints.
+ *
+ * @param subject - Message subject (max 200 chars)
+ * @param body - Message body (max 10000 chars)
+ * @returns True if valid
+ * @throws Error if subject or body is empty or exceeds limits
+ * @since 1.0.0
+ */
 export declare function validateMessage(subject: string, body: string): boolean;
+/**
+ * Validate a wallet address for a specific chain type.
+ *
+ * @param address - Wallet address to validate
+ * @param chainType - Target blockchain type (EVM or Solana)
+ * @returns True if valid
+ * @throws Error if address is empty or has invalid format
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateAddress('0x742d35Cc6634C0532925a3b844e2', ChainType.EVM);
+ * ```
+ */
 export declare function validateAddress(address: string, chainType: ChainType): boolean;
+/**
+ * Validate and convert an amount to a non-negative bigint.
+ * Accepts string, number, or bigint input.
+ *
+ * @param amount - Amount value to validate
+ * @returns The validated amount as bigint
+ * @throws Error if amount is invalid, non-numeric, or negative
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateAmount('1000');  // 1000n
+ * validateAmount(500);     // 500n
+ * validateAmount(-1);      // throws "Amount cannot be negative"
+ * ```
+ */
 export declare function validateAmount(amount: string | number | bigint): bigint;
 //# sourceMappingURL=validation.d.ts.map

package/dist/types/blockchain/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/types/blockchain/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CActD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CActE;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,OAAO,CAUT;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAwCvE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/types/blockchain/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CActD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CActE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GACnB,OAAO,CAUT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAwCvE"}

package/dist/types/blockchain/validation.js

@@ -1,6 +1,9 @@
 "use strict";
 /**
- * Validation utilities for multi-chain operations
+ * Validation utilities for multi-chain operations.
+ * All validators throw on invalid input.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateDomain = validateDomain;
@@ -8,6 +11,20 @@ exports.validateMessage = validateMessage;
 exports.validateAddress = validateAddress;
 exports.validateAmount = validateAmount;
 const address_1 = require("../../utils/blockchain/address");
+/**
+ * Validate a domain name format.
+ *
+ * @param domain - Domain string to validate
+ * @returns True if valid
+ * @throws Error if domain is empty, too long, or has invalid format
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateDomain('example.com'); // true
+ * validateDomain('');            // throws "Domain cannot be empty"
+ * ```
+ */
 function validateDomain(domain) {
     if (!domain || domain.length === 0) {
         throw new Error('Domain cannot be empty');
@@ -22,6 +39,15 @@ function validateDomain(domain) {
     }
     return true;
 }
+/**
+ * Validate a message subject and body against length constraints.
+ *
+ * @param subject - Message subject (max 200 chars)
+ * @param body - Message body (max 10000 chars)
+ * @returns True if valid
+ * @throws Error if subject or body is empty or exceeds limits
+ * @since 1.0.0
+ */
 function validateMessage(subject, body) {
     if (!subject || subject.length === 0) {
         throw new Error('Message subject cannot be empty');
@@ -37,6 +63,20 @@ function validateMessage(subject, body) {
     }
     return true;
 }
+/**
+ * Validate a wallet address for a specific chain type.
+ *
+ * @param address - Wallet address to validate
+ * @param chainType - Target blockchain type (EVM or Solana)
+ * @returns True if valid
+ * @throws Error if address is empty or has invalid format
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateAddress('0x742d35Cc6634C0532925a3b844e2', ChainType.EVM);
+ * ```
+ */
 function validateAddress(address, chainType) {
     if (!address || address.length === 0) {
         throw new Error('Address cannot be empty');
@@ -46,6 +86,22 @@ function validateAddress(address, chainType) {
     }
     return true;
 }
+/**
+ * Validate and convert an amount to a non-negative bigint.
+ * Accepts string, number, or bigint input.
+ *
+ * @param amount - Amount value to validate
+ * @returns The validated amount as bigint
+ * @throws Error if amount is invalid, non-numeric, or negative
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * validateAmount('1000');  // 1000n
+ * validateAmount(500);     // 500n
+ * validateAmount(-1);      // throws "Amount cannot be negative"
+ * ```
+ */
 function validateAmount(amount) {
     // Check for null, undefined, or empty string
     if (amount === null ||

package/dist/types/blockchain/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/types/blockchain/validation.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAKH,wCAcC;AAED,0CAcC;AAED,0CAaC;AAED,wCAwCC;AAzFD,4DAAsE;AAEtE,SAAgB,cAAc,CAAC,MAAc;IAC3C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,4CAA4C;IAC5C,MAAM,WAAW,GACf,+FAA+F,CAAC;IAClG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,eAAe,CAAC,OAAe,EAAE,IAAY;IAC3D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,eAAe,CAC7B,OAAe,EACf,SAAoB;IAEpB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,IAAA,8BAAoB,EAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,iBAAiB,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,cAAc,CAAC,MAAgC;IAC7D,6CAA6C;IAC7C,IACE,MAAM,KAAK,IAAI;QACf,MAAM,KAAK,SAAS;QACpB,MAAM,KAAK,EAAE;QACb,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EACpD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,YAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,gCAAgC;YAChC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtC,4BAA4B;YAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtC,YAAY,GAAG,MAAM,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/types/blockchain/validation.ts"],"names":[],"mappings":"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"}

package/dist/types/business/enums.cjs

@@ -1,24 +1,41 @@
 "use strict";
 /**
- * Platform-agnostic enums for discrete states
- * These replace string literals throughout the application
+ * Platform-agnostic enums for discrete states.
+ * These replace string literals throughout the application.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Currency = exports.ErrorType = exports.FeatureFlag = exports.EmailValidationState = exports.PlatformType = exports.ConnectionState = exports.ConnectionType = exports.EmailSortCriteria = exports.SortOrder = exports.EmailAddressType = exports.InfoType = exports.NotificationType = exports.RequestStatus = exports.SubscriptionAction = exports.EmailAction = exports.MediumView = exports.MobileView = exports.EmailComposeType = exports.FontSize = exports.Theme = exports.Chain = exports.ChainType = exports.AuthStatus = void 0;
-// Authentication states - aligned with @johnqh/di
+/**
+ * Authentication status of a wallet connection.
+ * @since 1.0.0
+ */
 var AuthStatus;
 (function (AuthStatus) {
+    /** Wallet is connected but not yet verified via signature */
     AuthStatus["CONNECTED"] = "connected";
+    /** Wallet is not connected */
     AuthStatus["DISCONNECTED"] = "disconnected";
+    /** Wallet is connected and ownership is verified via signature */
     AuthStatus["VERIFIED"] = "verified";
 })(AuthStatus || (exports.AuthStatus = AuthStatus = {}));
-// Chain types (more specific than @johnqh/di version)
+/**
+ * Blockchain family classification.
+ * @since 1.0.0
+ */
 var ChainType;
 (function (ChainType) {
+    /** Ethereum Virtual Machine compatible chains */
     ChainType["EVM"] = "evm";
+    /** Solana blockchain */
     ChainType["SOLANA"] = "solana";
 })(ChainType || (exports.ChainType = ChainType = {}));
-// Supported blockchain networks
+/**
+ * Supported blockchain networks across EVM and Solana ecosystems.
+ * Includes mainnets, testnets, and local development chains.
+ * @since 1.0.0
+ */
 var Chain;
 (function (Chain) {
     // Ethereum
@@ -110,21 +127,33 @@ var Chain;
     Chain["EVM_LOCAL"] = "evm-local";
     Chain["SOLANA_LOCAL"] = "solana-local";
 })(Chain || (exports.Chain = Chain = {}));
-// Theme states
+/**
+ * UI theme preference.
+ * @since 1.0.0
+ */
 var Theme;
 (function (Theme) {
+    /** Light color scheme */
     Theme["LIGHT"] = "light";
+    /** Dark color scheme */
     Theme["DARK"] = "dark";
+    /** Follow OS/system preference */
     Theme["SYSTEM"] = "system";
 })(Theme || (exports.Theme = Theme = {}));
-// Font sizes
+/**
+ * UI font size preference.
+ * @since 1.2.0
+ */
 var FontSize;
 (function (FontSize) {
     FontSize["SMALL"] = "small";
     FontSize["MEDIUM"] = "medium";
     FontSize["LARGE"] = "large";
 })(FontSize || (exports.FontSize = FontSize = {}));
-// Email compose types
+/**
+ * Email composition mode.
+ * @since 1.0.0
+ */
 var EmailComposeType;
 (function (EmailComposeType) {
     EmailComposeType["NEW"] = "new";
@@ -132,7 +161,10 @@ var EmailComposeType;
     EmailComposeType["REPLY_ALL"] = "replyAll";
     EmailComposeType["FORWARD"] = "forward";
 })(EmailComposeType || (exports.EmailComposeType = EmailComposeType = {}));
-// Mobile navigation views
+/**
+ * Mobile navigation view states.
+ * @since 1.0.0
+ */
 var MobileView;
 (function (MobileView) {
     MobileView["EMAIL_ADDRESSES"] = "emailAddresses";
@@ -140,13 +172,19 @@ var MobileView;
     MobileView["EMAILS"] = "emails";
     MobileView["EMAIL_BODY"] = "emailBody";
 })(MobileView || (exports.MobileView = MobileView = {}));
-// Medium screen navigation
+/**
+ * Medium-screen (tablet) navigation pane selection.
+ * @since 1.0.0
+ */
 var MediumView;
 (function (MediumView) {
     MediumView["LEFT"] = "left";
     MediumView["RIGHT"] = "right";
 })(MediumView || (exports.MediumView = MediumView = {}));
-// Email actions
+/**
+ * Actions that can be performed on an email message.
+ * @since 1.0.0
+ */
 var EmailAction;
 (function (EmailAction) {
     EmailAction["OPEN"] = "open";
@@ -158,7 +196,10 @@ var EmailAction;
     EmailAction["MARK_READ"] = "mark_read";
     EmailAction["MARK_UNREAD"] = "mark_unread";
 })(EmailAction || (exports.EmailAction = EmailAction = {}));
-// Subscription actions
+/**
+ * Subscription lifecycle actions.
+ * @since 1.3.0
+ */
 var SubscriptionAction;
 (function (SubscriptionAction) {
     SubscriptionAction["VIEW"] = "view";
@@ -166,15 +207,25 @@ var SubscriptionAction;
     SubscriptionAction["CANCEL"] = "cancel";
     SubscriptionAction["RESTORE"] = "restore";
 })(SubscriptionAction || (exports.SubscriptionAction = SubscriptionAction = {}));
-// Network request states
+/**
+ * Network request lifecycle states.
+ * @since 1.0.0
+ */
 var RequestStatus;
 (function (RequestStatus) {
+    /** No request in progress */
     RequestStatus["IDLE"] = "idle";
+    /** Request is in flight */
     RequestStatus["LOADING"] = "loading";
+    /** Request completed successfully */
     RequestStatus["SUCCESS"] = "success";
+    /** Request failed */
     RequestStatus["ERROR"] = "error";
 })(RequestStatus || (exports.RequestStatus = RequestStatus = {}));
-// Notification types
+/**
+ * UI notification severity levels.
+ * @since 1.0.0
+ */
 var NotificationType;
 (function (NotificationType) {
     NotificationType["INFO"] = "info";
@@ -182,7 +233,10 @@ var NotificationType;
     NotificationType["WARNING"] = "warning";
     NotificationType["ERROR"] = "error";
 })(NotificationType || (exports.NotificationType = NotificationType = {}));
-// Info types for UI feedback
+/**
+ * Info-level UI feedback types.
+ * @since 1.0.0
+ */
 var InfoType;
 (function (InfoType) {
     InfoType["INFO"] = "info";
@@ -190,7 +244,10 @@ var InfoType;
     InfoType["WARNING"] = "warning";
     InfoType["ERROR"] = "error";
 })(InfoType || (exports.InfoType = InfoType = {}));
-// Email address types
+/**
+ * Email address resolution types.
+ * @since 1.0.0
+ */
 var EmailAddressType;
 (function (EmailAddressType) {
     EmailAddressType["DIRECT"] = "direct";
@@ -198,13 +255,19 @@ var EmailAddressType;
     EmailAddressType["SNS"] = "sns";
     EmailAddressType["CUSTOM"] = "custom";
 })(EmailAddressType || (exports.EmailAddressType = EmailAddressType = {}));
-// Mailbox sort orders
+/**
+ * Sort order direction.
+ * @since 1.0.0
+ */
 var SortOrder;
 (function (SortOrder) {
     SortOrder["ASC"] = "asc";
     SortOrder["DESC"] = "desc";
 })(SortOrder || (exports.SortOrder = SortOrder = {}));
-// Email sort criteria
+/**
+ * Fields by which emails can be sorted.
+ * @since 1.0.0
+ */
 var EmailSortCriteria;
 (function (EmailSortCriteria) {
     EmailSortCriteria["DATE"] = "date";
@@ -212,7 +275,10 @@ var EmailSortCriteria;
     EmailSortCriteria["FROM"] = "from";
     EmailSortCriteria["SIZE"] = "size";
 })(EmailSortCriteria || (exports.EmailSortCriteria = EmailSortCriteria = {}));
-// Connection types
+/**
+ * Network connection type (WiFi, cellular, etc.).
+ * @since 1.1.0
+ */
 var ConnectionType;
 (function (ConnectionType) {
     ConnectionType["UNKNOWN"] = "unknown";
@@ -224,7 +290,11 @@ var ConnectionType;
     ConnectionType["CELLULAR_5G"] = "5g";
     ConnectionType["ETHERNET"] = "ethernet";
 })(ConnectionType || (exports.ConnectionType = ConnectionType = {}));
-// Connection states (consolidated from WalletConnectionState, NetworkStatus, and ConnectionState)
+/**
+ * Wallet/network connection lifecycle states.
+ * Consolidated from WalletConnectionState, NetworkStatus, and ConnectionState.
+ * @since 1.0.0
+ */
 var ConnectionState;
 (function (ConnectionState) {
     ConnectionState["UNKNOWN"] = "unknown";
@@ -236,14 +306,20 @@ var ConnectionState;
     ConnectionState["LIMITED"] = "limited";
     ConnectionState["ERROR"] = "error";
 })(ConnectionState || (exports.ConnectionState = ConnectionState = {}));
-// Platform types
+/**
+ * Runtime platform identification.
+ * @since 1.0.0
+ */
 var PlatformType;
 (function (PlatformType) {
     PlatformType["WEB"] = "web";
     PlatformType["REACT_NATIVE"] = "react_native";
     PlatformType["DESKTOP"] = "desktop";
 })(PlatformType || (exports.PlatformType = PlatformType = {}));
-// Email validation states
+/**
+ * Email address validation status.
+ * @since 1.0.0
+ */
 var EmailValidationState;
 (function (EmailValidationState) {
     EmailValidationState["VALID"] = "valid";
@@ -251,7 +327,10 @@ var EmailValidationState;
     EmailValidationState["PENDING"] = "pending";
     EmailValidationState["UNKNOWN"] = "unknown";
 })(EmailValidationState || (exports.EmailValidationState = EmailValidationState = {}));
-// Feature flags
+/**
+ * Feature flags for gating experimental or premium features.
+ * @since 1.2.0
+ */
 var FeatureFlag;
 (function (FeatureFlag) {
     FeatureFlag["AI_SEARCH"] = "ai_search";
@@ -261,7 +340,10 @@ var FeatureFlag;
     FeatureFlag["NOTIFICATIONS"] = "notifications";
     FeatureFlag["ANALYTICS"] = "analytics";
 })(FeatureFlag || (exports.FeatureFlag = FeatureFlag = {}));
-// Error types
+/**
+ * High-level error category classification.
+ * @since 1.0.0
+ */
 var ErrorType;
 (function (ErrorType) {
     ErrorType["NETWORK"] = "network";
@@ -270,7 +352,10 @@ var ErrorType;
     ErrorType["PERMISSION"] = "permission";
     ErrorType["UNKNOWN"] = "unknown";
 })(ErrorType || (exports.ErrorType = ErrorType = {}));
-// Currency types for subscriptions
+/**
+ * Fiat currency codes for subscription pricing.
+ * @since 1.3.0
+ */
 var Currency;
 (function (Currency) {
     Currency["USD"] = "USD";