@sudobility/types 1.8.21

package/dist/types/infrastructure/analytics.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Analytics types and interfaces
+ * Platform-agnostic analytics service interface for dependency injection
+ *
+ * @ai-context Core analytics interface for dependency injection
+ * @ai-pattern Service interface with comprehensive event tracking
+ * @ai-platform Cross-platform compatible (Web, React Native, Node.js)
+ * @ai-usage Implement this interface to create analytics services for Firebase, Mixpanel, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsEventBuilder = exports.AnalyticsEvent = void 0;
+/**
+ * Standardized analytics events enumeration.
+ *
+ * Provides consistent event naming for common application analytics scenarios.
+ * Organized by functional categories for better code organization and analytics reporting.
+ *
+ * @example
+ * ```typescript
+ * // Use predefined events for consistency
+ * analytics.track(AnalyticsEvent.USER_LOGIN, { method: 'email' });
+ * analytics.track(AnalyticsEvent.EMAIL_OPENED, { email_id: 'msg-123' });
+ * ```
+ */
+var AnalyticsEvent;
+(function (AnalyticsEvent) {
+    /** User successfully logged into the application */
+    AnalyticsEvent["USER_LOGIN"] = "user_login";
+    /** User logged out of the application */
+    AnalyticsEvent["USER_LOGOUT"] = "user_logout";
+    /** New user completed account registration */
+    AnalyticsEvent["USER_SIGNUP"] = "user_signup";
+    /** User sent an email message */
+    AnalyticsEvent["EMAIL_SENT"] = "email_sent";
+    /** User received a new email message */
+    AnalyticsEvent["EMAIL_RECEIVED"] = "email_received";
+    /** User opened an email message (consolidated from EMAIL_OPENED and EMAIL_OPEN) */
+    AnalyticsEvent["EMAIL_OPENED"] = "email_opened";
+    /** User replied to an email message */
+    AnalyticsEvent["EMAIL_REPLY"] = "email_reply";
+    /** User forwarded an email message */
+    AnalyticsEvent["EMAIL_FORWARD"] = "email_forward";
+    /** User deleted an email message */
+    AnalyticsEvent["EMAIL_DELETE"] = "email_delete";
+    /** User starred an email message */
+    AnalyticsEvent["EMAIL_STAR"] = "email_star";
+    /** User composed a new email */
+    AnalyticsEvent["EMAIL_COMPOSE"] = "email_compose";
+    /** User clicked a link within an email */
+    AnalyticsEvent["EMAIL_CLICKED"] = "email_clicked";
+    /** User viewed a web page */
+    AnalyticsEvent["PAGE_VIEW"] = "page_view";
+    /** User viewed a mobile screen */
+    AnalyticsEvent["SCREEN_VIEW"] = "screen_view";
+    /** User switched between folders */
+    AnalyticsEvent["FOLDER_SWITCH"] = "folder_switch";
+    /** User viewed subscription options */
+    AnalyticsEvent["SUBSCRIPTION_VIEW"] = "subscription_view";
+    /** User purchased a subscription */
+    AnalyticsEvent["SUBSCRIPTION_PURCHASE"] = "subscription_purchase";
+    /** User cancelled a subscription */
+    AnalyticsEvent["SUBSCRIPTION_CANCEL"] = "subscription_cancel";
+    /** User performed a search */
+    AnalyticsEvent["SEARCH_PERFORMED"] = "search_performed";
+    /** User changed application settings */
+    AnalyticsEvent["SETTINGS_CHANGED"] = "settings_changed";
+    /** An application error occurred */
+    AnalyticsEvent["ERROR_OCCURRED"] = "error_occurred";
+    /** User viewed an A/B test variant */
+    AnalyticsEvent["AB_TEST_VIEWED"] = "ab_test_viewed";
+    /** User converted on an A/B test */
+    AnalyticsEvent["AB_TEST_CONVERTED"] = "ab_test_converted";
+    /** Custom application-specific event */
+    AnalyticsEvent["CUSTOM_EVENT"] = "custom_event";
+})(AnalyticsEvent || (exports.AnalyticsEvent = AnalyticsEvent = {}));
+/**
+ * Utility class for building standardized analytics event properties.
+ *
+ * Provides static methods to create consistent event property objects
+ * for common analytics scenarios. Ensures proper naming conventions
+ * and includes standard fields like timestamps.
+ *
+ * @ai-utility-class Event property builders
+ * @ai-pattern Factory pattern for event properties
+ * @ai-standardization Ensures consistent event property naming
+ *
+ * @example
+ * ```typescript
+ * // Use builders to create standardized event properties
+ * const properties = AnalyticsEventBuilder.emailAction('read', 'email-123', 'inbox');
+ * analytics.trackEvent(AnalyticsEvent.EMAIL_OPENED, properties);
+ * ```
+ */
+class AnalyticsEventBuilder {
+    /**
+     * Build properties for email action events.
+     *
+     * @param action Email action performed (read, sent, archived, etc.)
+     * @param emailId Unique identifier for the email
+     * @param folder Email folder context (inbox, sent, trash, etc.)
+     * @returns Standardized event properties object
+     *
+     * @ai-builder Email action properties
+     * @ai-standardization Consistent email event tracking
+     */
+    static emailAction(action, emailId, folder) {
+        return {
+            action,
+            email_id: emailId,
+            folder,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Build properties for page/screen view events.
+     *
+     * @param pageName Human-readable page name
+     * @param pagePath URL path or screen identifier
+     * @returns Standardized page view properties
+     *
+     * @ai-builder Navigation tracking properties
+     * @ai-cross-platform Works for web pages and mobile screens
+     */
+    static pageView(pageName, pagePath) {
+        return {
+            page_name: pageName,
+            page_path: pagePath,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Build properties for error tracking events.
+     *
+     * @param errorType Category of error (network, validation, runtime, etc.)
+     * @param errorMessage Error message or description
+     * @param pageName Page/screen where error occurred
+     * @returns Standardized error event properties
+     *
+     * @ai-builder Error tracking properties
+     * @ai-debugging Consistent error event structure
+     */
+    static error(errorType, errorMessage, pageName) {
+        return {
+            error_type: errorType,
+            error_message: errorMessage,
+            page_name: pageName,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Build properties for subscription/revenue events.
+     *
+     * @param action Subscription action (subscribe, upgrade, cancel, etc.)
+     * @param planType Subscription plan type (free, premium, pro, etc.)
+     * @param amount Monetary amount (for revenue tracking)
+     * @param currency Currency code (USD, EUR, etc.)
+     * @returns Standardized subscription event properties
+     *
+     * @ai-builder Revenue tracking properties
+     * @ai-business-metrics Subscription and revenue analytics
+     */
+    static subscription(action, planType, amount, currency) {
+        return {
+            action,
+            plan_type: planType,
+            amount,
+            currency,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Build properties for user engagement events.
+     *
+     * @param feature Feature name or component identifier
+     * @param interaction Type of interaction (click, scroll, hover, etc.)
+     * @param duration Time spent on interaction (milliseconds)
+     * @returns Standardized engagement event properties
+     *
+     * @ai-builder User engagement properties
+     * @ai-ux-analytics User experience and interaction tracking
+     */
+    static engagement(feature, interaction, duration) {
+        return {
+            feature,
+            interaction,
+            duration,
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Build properties for performance monitoring events.
+     *
+     * @param metric Performance metric name (load_time, api_response, etc.)
+     * @param value Metric value (usually in milliseconds)
+     * @param context Additional context about the performance event
+     * @returns Standardized performance event properties
+     *
+     * @ai-builder Performance monitoring properties
+     * @ai-performance Application performance tracking
+     */
+    static performance(metric, value, context) {
+        return {
+            metric,
+            value,
+            context,
+            timestamp: Date.now(),
+        };
+    }
+}
+exports.AnalyticsEventBuilder = AnalyticsEventBuilder;
+//# sourceMappingURL=analytics.js.map

package/dist/types/infrastructure/analytics.js.map

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

package/dist/types/infrastructure/api.cjs

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * @fileoverview Core API Type Definitions
+ * @description Centralized type definitions for API requests/responses and data structures
+ * @version 2.0.0
+ *
+ * This file provides comprehensive type safety for:
+ * - API request/response interfaces
+ * - Multi-chain data structures
+ * - Database entity interfaces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainType = void 0;
+// Re-export ChainType from business enums
+var enums_1 = require("../business/enums");
+Object.defineProperty(exports, "ChainType", { enumerable: true, get: function () { return enums_1.ChainType; } });
+//# sourceMappingURL=api.js.map

package/dist/types/infrastructure/api.d.ts

@@ -0,0 +1,152 @@
+/**
+ * @fileoverview Core API Type Definitions
+ * @description Centralized type definitions for API requests/responses and data structures
+ * @version 2.0.0
+ *
+ * This file provides comprehensive type safety for:
+ * - API request/response interfaces
+ * - Multi-chain data structures
+ * - Database entity interfaces
+ */
+import { Optional, BaseResponse, PaginationInfo } from '../common';
+export { ChainType } from '../business/enums';
+export type ApiResponse<T = unknown> = BaseResponse<T>;
+/**
+ * Signature-protected API request base interface
+ * All signature-protected endpoints should extend this
+ */
+export interface SignatureProtectedRequest {
+    /** Wallet address (EVM 0x format or Solana Base58) */
+    walletAddress: string;
+    /** Cryptographic signature proving wallet ownership */
+    signature: string;
+}
+/**
+ * GraphQL query result wrapper
+ * @template T The entity type being queried
+ */
+export interface GraphQLResult<T> {
+    items: T[];
+    pageInfo?: Optional<PaginationInfo>;
+}
+/**
+ * Multi-chain entity ID components
+ * Used for creating unique identifiers across all chains
+ */
+export interface MultiChainId {
+    chainId: number;
+    txHash: string;
+    logIndex: number;
+}
+/**
+ * User-specific multi-chain identifier
+ */
+export interface UserChainId {
+    chainId: number;
+    address: string;
+}
+/**
+ * Chain-specific metadata for all entities
+ */
+export interface ChainMetadata {
+    chainId: number;
+    blockNumber: bigint;
+    blockHash: string;
+    txHash: string;
+    logIndex: number;
+    timestamp: bigint;
+}
+/**
+ * Mail message entity - represents individual mail messages
+ */
+export interface MailEntity extends ChainMetadata {
+    id: string;
+    from: string;
+    to: string;
+    subject: string;
+    body?: Optional<string>;
+    contractAddress: string;
+    feesPaid: bigint;
+    priority: boolean;
+}
+/**
+ * Prepared mail entity - represents pre-prepared mail messages
+ */
+export interface PreparedMailEntity extends ChainMetadata {
+    id: string;
+    mailHash: string;
+    from: string;
+    contractAddress: string;
+    feesPaid: bigint;
+}
+/**
+ * Delegation entity - represents wallet delegations per chain
+ */
+export interface DelegationEntity extends ChainMetadata {
+    id: string;
+    delegator: string;
+    delegateTo?: Optional<string>;
+    contractAddress: string;
+}
+/**
+ * Per-chain statistics
+ */
+export interface StatisticsEntity {
+    id: string;
+    chainId: number;
+    totalMails: bigint;
+    totalPreparedMails: bigint;
+    totalUsers: bigint;
+    totalDelegations: bigint;
+    totalVolume: bigint;
+    lastUpdated: bigint;
+}
+/**
+ * Per-user, per-chain statistics
+ */
+export interface UserStatisticsEntity {
+    id: string;
+    chainId: number;
+    address: string;
+    mailsSent: bigint;
+    mailsReceived: bigint;
+    preparedMailsSent: bigint;
+    totalFeesPaid: bigint;
+    totalFeesReceived: bigint;
+    lastActivity: bigint;
+}
+/**
+ * Cross-chain global statistics
+ */
+export interface ChainStatisticsEntity {
+    id: 'global';
+    totalChains: number;
+    totalMails: bigint;
+    totalPreparedMails: bigint;
+    totalUsers: bigint;
+    totalDelegations: bigint;
+    totalVolume: bigint;
+    lastUpdated: bigint;
+}
+/**
+ * Event log entity - complete audit trail for debugging
+ */
+export interface EventLogEntity extends ChainMetadata {
+    id: string;
+    eventName: string;
+    contractAddress: string;
+    eventData: string;
+}
+/**
+ * Supported network chain IDs
+ */
+export type SupportedChainId = 1 | 137 | 42161 | 10 | 8453 | 56 | 43114 | 250 | 100 | 42220 | 31337 | 11155111 | 80001 | 421614 | 11155420 | 84532 | -101 | -102 | -103 | -104;
+/**
+ * Contract types supported by the indexer
+ */
+export type ContractType = 'Mailer' | 'MailService';
+/**
+ * Event names processed by the indexer
+ */
+export type ProcessedEventName = 'MailSent' | 'PreparedMailSent' | 'DelegationSet' | 'DelegationCleared' | 'DomainRegistered' | 'DomainExtended' | 'DomainReleased' | 'FeeUpdated' | 'SharesRecorded' | 'RecipientClaimed' | 'OwnerClaimed' | 'ExpiredSharesClaimed';
+//# sourceMappingURL=api.d.ts.map

package/dist/types/infrastructure/api.d.ts.map

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

package/dist/types/infrastructure/api.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * @fileoverview Core API Type Definitions
+ * @description Centralized type definitions for API requests/responses and data structures
+ * @version 2.0.0
+ *
+ * This file provides comprehensive type safety for:
+ * - API request/response interfaces
+ * - Multi-chain data structures
+ * - Database entity interfaces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainType = void 0;
+// Re-export ChainType from business enums
+var enums_1 = require("../business/enums");
+Object.defineProperty(exports, "ChainType", { enumerable: true, get: function () { return enums_1.ChainType; } });
+//# sourceMappingURL=api.js.map

package/dist/types/infrastructure/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/types/infrastructure/api.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAIH,0CAA0C;AAC1C,2CAA8C;AAArC,kGAAA,SAAS,OAAA"}

package/dist/types/infrastructure/index.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletType = exports.NetworkError = exports.ChainType = exports.AnalyticsEventBuilder = exports.AnalyticsEvent = void 0;
+var analytics_1 = require("./analytics");
+Object.defineProperty(exports, "AnalyticsEvent", { enumerable: true, get: function () { return analytics_1.AnalyticsEvent; } });
+Object.defineProperty(exports, "AnalyticsEventBuilder", { enumerable: true, get: function () { return analytics_1.AnalyticsEventBuilder; } });
+var api_1 = require("./api");
+Object.defineProperty(exports, "ChainType", { enumerable: true, get: function () { return api_1.ChainType; } });
+var network_1 = require("./network");
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return network_1.NetworkError; } });
+// Wallet types
+var wallet_1 = require("./wallet");
+Object.defineProperty(exports, "WalletType", { enumerable: true, get: function () { return wallet_1.WalletType; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,9 @@
+export type { AnalyticsConfig, AnalyticsEventProperties, AnalyticsService, EmailAnalyticsService, } from './analytics';
+export { AnalyticsEvent, AnalyticsEventBuilder } from './analytics';
+export type { ApiResponse, ChainMetadata, ChainStatisticsEntity, ContractType, DelegationEntity, EventLogEntity, GraphQLResult, MailEntity, MultiChainId, PreparedMailEntity, ProcessedEventName, SignatureProtectedRequest, StatisticsEntity, SupportedChainId, UserChainId, UserStatisticsEntity, } from './api';
+export { ChainType } from './api';
+export type { NetworkClient, NetworkRequestOptions, NetworkResponse, } from './network';
+export { NetworkError } from './network';
+export type { UILocationHook, UINavigationConfig, UINavigationHook, UINavigationOptions, UINavigationService, UINavigationState, } from './navigation';
+export { WalletType } from './wallet';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/infrastructure/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpE,YAAY,EACV,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,GACrB,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/infrastructure/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletType = exports.NetworkError = exports.ChainType = exports.AnalyticsEventBuilder = exports.AnalyticsEvent = void 0;
+var analytics_1 = require("./analytics");
+Object.defineProperty(exports, "AnalyticsEvent", { enumerable: true, get: function () { return analytics_1.AnalyticsEvent; } });
+Object.defineProperty(exports, "AnalyticsEventBuilder", { enumerable: true, get: function () { return analytics_1.AnalyticsEventBuilder; } });
+var api_1 = require("./api");
+Object.defineProperty(exports, "ChainType", { enumerable: true, get: function () { return api_1.ChainType; } });
+var network_1 = require("./network");
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return network_1.NetworkError; } });
+// Wallet types
+var wallet_1 = require("./wallet");
+Object.defineProperty(exports, "WalletType", { enumerable: true, get: function () { return wallet_1.WalletType; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/infrastructure/index.ts"],"names":[],"mappings":";;;AAQA,yCAAoE;AAA3D,2GAAA,cAAc,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAsB9C,6BAAkC;AAAzB,gGAAA,SAAS,OAAA;AASlB,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AAYrB,eAAe;AACf,mCAAsC;AAA7B,oGAAA,UAAU,OAAA"}

package/dist/types/infrastructure/navigation.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=navigation.js.map

package/dist/types/infrastructure/navigation.d.ts

@@ -0,0 +1,56 @@
+import type { Optional } from '../common';
+/**
+ * UI-level navigation state interface for web and mobile applications
+ * This provides cross-platform navigation abstractions that work with different routing systems
+ */
+export interface UINavigationState {
+    currentPath: string;
+    previousPath?: Optional<string>;
+    params: Record<string, string>;
+    searchParams: Record<string, string>;
+}
+export interface UINavigationOptions {
+    replace?: Optional<boolean>;
+    state?: Optional<Record<string, unknown>>;
+    preventScrollReset?: Optional<boolean>;
+}
+export interface UINavigationService {
+    navigate(path: string, options?: Optional<UINavigationOptions>): void;
+    goBack(fallbackPath?: Optional<string>): void;
+    goForward(): void;
+    replace(path: string, options?: Optional<UINavigationOptions>): void;
+    getCurrentState(): UINavigationState;
+    getCurrentPath(): string;
+    getSearchParams(): Record<string, string>;
+    getParams(): Record<string, string>;
+    canGoBack(): boolean;
+    canGoForward(): boolean;
+    addListener(listener: (state: UINavigationState) => void): () => void;
+    isSupported(): boolean;
+}
+export interface UINavigationHook {
+    navigate: (path: string, options?: Optional<UINavigationOptions>) => void;
+    goBack: (fallbackPath?: Optional<string>) => void;
+    replace: (path: string, options?: Optional<UINavigationOptions>) => void;
+    currentPath: string;
+    searchParams: Record<string, string>;
+    params: Record<string, string>;
+    canGoBack: boolean;
+    isSupported: boolean;
+}
+export interface UILocationHook {
+    pathname: string;
+    search: string;
+    searchParams: Record<string, string>;
+    hash: string;
+    state: Record<string, unknown>;
+    key: string;
+}
+export interface UINavigationConfig {
+    enableBackGesture?: Optional<boolean>;
+    enableSwipeGesture?: Optional<boolean>;
+    animationType?: Optional<'slide' | 'fade' | 'none'>;
+    enableAnalytics?: Optional<boolean>;
+    fallbackPath?: Optional<string>;
+}
+//# sourceMappingURL=navigation.d.ts.map

package/dist/types/infrastructure/navigation.d.ts.map

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

package/dist/types/infrastructure/navigation.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=navigation.js.map

package/dist/types/infrastructure/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../../src/types/infrastructure/navigation.ts"],"names":[],"mappings":""}

package/dist/types/infrastructure/network.cjs

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Network client interface for dependency injection
+ * Platform-agnostic HTTP client interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = void 0;
+class NetworkError extends Error {
+    constructor(message, status, statusText, response) {
+        super(message);
+        this.name = 'NetworkError';
+        this.status = status;
+        this.statusText = statusText;
+        this.response = response;
+    }
+}
+exports.NetworkError = NetworkError;
+//# sourceMappingURL=network.js.map

package/dist/types/infrastructure/network.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Network client interface for dependency injection
+ * Platform-agnostic HTTP client interface
+ */
+import { BaseResponse, Optional } from '../common';
+interface NetworkRequestOptions {
+    method?: Optional<'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'>;
+    headers?: Optional<Record<string, string>>;
+    body?: Optional<string | FormData | Blob>;
+    signal?: Optional<AbortSignal>;
+    timeout?: Optional<number>;
+}
+interface NetworkResponse<T = unknown> extends BaseResponse<T> {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+}
+interface NetworkClient {
+    /**
+     * Make a network request
+     */
+    request<T = unknown>(url: string, options?: Optional<NetworkRequestOptions>): Promise<NetworkResponse<T>>;
+    /**
+     * Make a GET request
+     */
+    get<T = unknown>(url: string, options?: Optional<Omit<NetworkRequestOptions, 'method' | 'body'>>): Promise<NetworkResponse<T>>;
+    /**
+     * Make a POST request
+     */
+    post<T = unknown>(url: string, body?: Optional<unknown>, options?: Optional<Omit<NetworkRequestOptions, 'method'>>): Promise<NetworkResponse<T>>;
+    /**
+     * Make a PUT request
+     */
+    put<T = unknown>(url: string, body?: Optional<unknown>, options?: Optional<Omit<NetworkRequestOptions, 'method'>>): Promise<NetworkResponse<T>>;
+    /**
+     * Make a DELETE request
+     */
+    delete<T = unknown>(url: string, options?: Optional<Omit<NetworkRequestOptions, 'method' | 'body'>>): Promise<NetworkResponse<T>>;
+}
+declare class NetworkError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly response?: Optional<unknown>;
+    constructor(message: string, status: number, statusText: string, response?: Optional<unknown>);
+}
+export { type NetworkClient, type NetworkResponse, type NetworkRequestOptions, NetworkError, };
+//# sourceMappingURL=network.d.ts.map

package/dist/types/infrastructure/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/types/infrastructure/network.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEnD,UAAU,qBAAqB;IAC7B,MAAM,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC;IAC/D,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,UAAU,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IAC5D,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,UAAU,aAAa;IACrB;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACxC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/B;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,GACjE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/B;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,OAAO,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC,GACxD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/B;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,OAAO,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC,GACxD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/B;;OAEG;IACH,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,GACjE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;CAChC;AAED,cAAM,YAAa,SAAQ,KAAK;IAC9B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC;CAQ/B;AAED,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,YAAY,GACb,CAAC"}

package/dist/types/infrastructure/network.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Network client interface for dependency injection
+ * Platform-agnostic HTTP client interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = void 0;
+class NetworkError extends Error {
+    constructor(message, status, statusText, response) {
+        super(message);
+        this.name = 'NetworkError';
+        this.status = status;
+        this.statusText = statusText;
+        this.response = response;
+    }
+}
+exports.NetworkError = NetworkError;
+//# sourceMappingURL=network.js.map

package/dist/types/infrastructure/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/types/infrastructure/network.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA+DH,MAAM,YAAa,SAAQ,KAAK;IAK9B,YACE,OAAe,EACf,MAAc,EACd,UAAkB,EAClB,QAA4B;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAMC,oCAAY"}