@sudobility/types 1.9.52 → 1.9.54

package/dist/types/business/enums.js

@@ -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";

package/dist/types/business/enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/types/business/enums.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/types/business/enums.ts"],"names":[],"mappings":"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"}

package/dist/types/common.cjs

@@ -1,6 +1,12 @@
 "use strict";
 /**
- * Common utility types used throughout the application
+ * Common utility types used throughout the application.
+ *
+ * Provides foundational types like {@link Optional}, {@link Result},
+ * {@link ValidationResult}, and API response structures used across
+ * every package in the ecosystem.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=common.js.map

package/dist/types/common.d.ts

@@ -1,15 +1,42 @@
 /**
- * Common utility types used throughout the application
+ * Common utility types used throughout the application.
+ *
+ * Provides foundational types like {@link Optional}, {@link Result},
+ * {@link ValidationResult}, and API response structures used across
+ * every package in the ecosystem.
+ *
+ * @since 1.0.0
  */
 import { ChainType } from './business/enums';
 /**
- * Utility type for values that can be T, undefined, or null
- * Provides a more semantic way to represent optional/nullable values
+ * Utility type for values that can be T, undefined, or null.
+ * Use instead of manual `T | null | undefined` unions for consistency.
+ *
+ * @template T - The base type
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   name: string;
+ *   bio?: Optional<string>;
+ * }
+ * ```
  */
 export type Optional<T> = T | undefined | null;
 /**
- * Base wallet data structure containing address and chain type
- * Used across all wallet-related interfaces to ensure consistency
+ * Base wallet data structure containing address and chain type.
+ * Used across all wallet-related interfaces to ensure consistency.
+ *
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const wallet: WalletData = {
+ *   walletAddress: '0x742d35Cc6634C0532925a3b8D2C36B7f1234567',
+ *   chainType: ChainType.EVM,
+ * };
+ * ```
  */
 export interface WalletData {
     /** Wallet address (EVM 0x format or Solana Base58) */
@@ -18,8 +45,10 @@ export interface WalletData {
     chainType: ChainType;
 }
 /**
- * Base folder data structure containing common folder properties
- * Used across all folder/mailbox-related interfaces to ensure consistency
+ * Base folder data structure containing common folder properties.
+ * Used across all folder/mailbox-related interfaces to ensure consistency.
+ *
+ * @since 1.0.0
  */
 export interface FolderBase {
     /** Folder name */
@@ -30,8 +59,10 @@ export interface FolderBase {
     unreadCount: number;
 }
 /**
- * Base message structure containing core message fields
- * Used across all message/email-related interfaces to ensure consistency
+ * Base message structure containing core message fields.
+ * Used across all message/email-related interfaces to ensure consistency.
+ *
+ * @since 1.0.0
  */
 export interface MessageBase {
     /** Message sender */
@@ -44,8 +75,20 @@ export interface MessageBase {
     body: string;
 }
 /**
- * Base response structure for all API operations
- * Unified response interface for consistency across the entire application
+ * Base response structure for all API operations.
+ * Unified response interface for consistency across the entire application.
+ *
+ * @template T - The response data type (defaults to `unknown`)
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const response: BaseResponse<User> = {
+ *   success: true,
+ *   data: { name: 'Alice' },
+ *   timestamp: new Date().toISOString(),
+ * };
+ * ```
  */
 export interface BaseResponse<T = unknown> {
     /** Operation success status */
@@ -58,7 +101,19 @@ export interface BaseResponse<T = unknown> {
     timestamp: string;
 }
 /**
- * Unified pagination options for querying
+ * Unified pagination options for querying.
+ * Supports both offset-based and cursor-based pagination.
+ *
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const opts: PaginationOptions = {
+ *   limit: 20,
+ *   cursor: 'abc123',
+ *   sortOrder: 'desc',
+ * };
+ * ```
  */
 export interface PaginationOptions {
     /** Number of items per page */
@@ -71,7 +126,9 @@ export interface PaginationOptions {
     sortOrder?: Optional<'asc' | 'desc'>;
 }
 /**
- * Unified pagination metadata for responses
+ * Unified pagination metadata for responses.
+ *
+ * @since 1.0.0
  */
 export interface PaginationInfo {
     /** Whether there are more items after current page */
@@ -88,14 +145,42 @@ export interface PaginationInfo {
     pageSize: number;
 }
 /**
- * Paginated response structure
+ * Paginated response structure extending {@link BaseResponse} with
+ * pagination metadata.
+ *
+ * @template T - The item type in the paginated list
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const page: PaginatedResponse<User> = {
+ *   success: true,
+ *   data: [{ name: 'Alice' }],
+ *   timestamp: new Date().toISOString(),
+ *   pagination: { hasNextPage: true, pageSize: 20 },
+ * };
+ * ```
  */
 export interface PaginatedResponse<T> extends BaseResponse<T[]> {
     /** Pagination metadata */
     pagination: PaginationInfo;
 }
 /**
- * Unified error structure for all operations
+ * Unified error structure for all operations.
+ * Provides typed error categories, human-readable messages,
+ * and optional suggested actions for the user.
+ *
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const error: UnifiedError = {
+ *   type: 'ValidationError',
+ *   message: 'Invalid email address',
+ *   details: { field: 'email' },
+ *   suggestedAction: 'Please enter a valid email.',
+ * };
+ * ```
  */
 export interface UnifiedError {
     /** Error type/code */
@@ -116,9 +201,25 @@ export interface UnifiedError {
     suggestedAction?: Optional<string>;
 }
 /**
- * Result type for operations that can succeed or fail
- * @template T Success result type
- * @template E Error type (defaults to UnifiedError)
+ * Discriminated union for operations that can succeed or fail.
+ * Prefer this over throwing exceptions for recoverable errors.
+ *
+ * @template T - Success result type
+ * @template E - Error type (defaults to {@link UnifiedError})
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * function divide(a: number, b: number): Result<number> {
+ *   if (b === 0) {
+ *     return {
+ *       success: false,
+ *       error: { type: 'ValidationError', message: 'Division by zero' },
+ *     };
+ *   }
+ *   return { success: true, data: a / b };
+ * }
+ * ```
  */
 export type Result<T, E = UnifiedError> = {
     success: true;
@@ -128,8 +229,21 @@ export type Result<T, E = UnifiedError> = {
     error: E;
 };
 /**
- * Unified validation result pattern
- * @template T The validated data type
+ * Unified validation result pattern.
+ * Used by validators and {@link createValidator} to return typed results.
+ *
+ * @template T - The validated data type
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * function validateAge(value: unknown): ValidationResult<number> {
+ *   if (typeof value === 'number' && value >= 0) {
+ *     return { isValid: true, data: value };
+ *   }
+ *   return { isValid: false, error: 'Age must be a non-negative number' };
+ * }
+ * ```
  */
 export type ValidationResult<T = unknown> = {
     isValid: true;

package/dist/types/common.d.ts.map

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

package/dist/types/common.js

@@ -1,6 +1,12 @@
 "use strict";
 /**
- * Common utility types used throughout the application
+ * Common utility types used throughout the application.
+ *
+ * Provides foundational types like {@link Optional}, {@link Result},
+ * {@link ValidationResult}, and API response structures used across
+ * every package in the ecosystem.
+ *
+ * @since 1.0.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":";AAAA;;GAEG"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/types/subscription/entitlements.cjs

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Subscription Entitlement Constants
+ *
+ * Shared constants for subscription entitlement management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NONE_ENTITLEMENT = void 0;
+/**
+ * The special entitlement name for users without any subscription.
+ * This is returned when a user has no active entitlements in RevenueCat.
+ */
+exports.NONE_ENTITLEMENT = "none";
+//# sourceMappingURL=entitlements.js.map

package/dist/types/subscription/entitlements.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Subscription Entitlement Constants
+ *
+ * Shared constants for subscription entitlement management.
+ */
+/**
+ * The special entitlement name for users without any subscription.
+ * This is returned when a user has no active entitlements in RevenueCat.
+ */
+export declare const NONE_ENTITLEMENT: "none";
+//# sourceMappingURL=entitlements.d.ts.map

package/dist/types/subscription/entitlements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.d.ts","sourceRoot":"","sources":["../../../src/types/subscription/entitlements.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,MAAe,CAAC"}

package/dist/types/subscription/entitlements.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Subscription Entitlement Constants
+ *
+ * Shared constants for subscription entitlement management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NONE_ENTITLEMENT = void 0;
+/**
+ * The special entitlement name for users without any subscription.
+ * This is returned when a user has no active entitlements in RevenueCat.
+ */
+exports.NONE_ENTITLEMENT = "none";
+//# sourceMappingURL=entitlements.js.map

package/dist/types/subscription/entitlements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../../../src/types/subscription/entitlements.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;;GAGG;AACU,QAAA,gBAAgB,GAAG,MAAe,CAAC"}

package/dist/types/subscription/period.cjs

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Subscription Period Types
+ *
+ * Standard subscription periods and utilities for period comparison.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_PERIODS = exports.PERIOD_RANKS = void 0;
+/**
+ * Period ranking for comparison (higher = longer)
+ */
+exports.PERIOD_RANKS = {
+    weekly: 1,
+    monthly: 2,
+    quarterly: 3,
+    yearly: 4,
+    lifetime: 5,
+};
+/**
+ * All supported periods in order
+ */
+exports.ALL_PERIODS = [
+    'weekly',
+    'monthly',
+    'quarterly',
+    'yearly',
+    'lifetime',
+];
+//# sourceMappingURL=period.js.map