@metamask-previews/perps-controller 0.0.0-preview-e4aa1532 → 0.0.0-preview-6dfa4aeba

package/dist/services/TradingService.d.mts

@@ -1,308 +0,0 @@
-import type { RewardsIntegrationService } from "./RewardsIntegrationService.mjs";
-import type { ServiceContext } from "./ServiceContext.mjs";
-import type { PerpsControllerMessenger } from "../PerpsController.mjs";
-import type { PerpsProvider, PerpsControllerAccess, OrderParams, OrderResult, EditOrderParams, CancelOrderParams, CancelOrderResult, CancelOrdersParams, CancelOrdersResult, ClosePositionParams, ClosePositionsParams, ClosePositionsResult, Position, UpdatePositionTPSLParams, PerpsPlatformDependencies } from "../types/index.mjs";
-/**
- * Controller-level dependencies for TradingService.
- * These are singletons that don't change per-call, injected once via setControllerDependencies().
- */
-export type TradingServiceControllerDeps = {
-    controllers: PerpsControllerAccess;
-    messenger: PerpsControllerMessenger;
-    rewardsIntegrationService: RewardsIntegrationService;
-};
-/**
- * TradingService
- *
- * Handles trading operations with fee discount management.
- * Controller is responsible for analytics, state management, and tracing.
- *
- * Instance-based service with constructor injection of platform dependencies.
- * Controller-level dependencies (RewardsController, NetworkController, etc.)
- * are injected via setControllerDependencies() after construction.
- */
-export declare class TradingService {
-    /**
-     * Platform dependencies for logging, metrics, etc.
-     */
-    private readonly deps;
-    /**
-     * Controller-level dependencies for fee discount calculation.
-     * Set via setControllerDependencies() after construction.
-     */
-    private controllerDeps;
-    /**
-     * Create a new TradingService instance.
-     *
-     * @param deps - Platform dependencies for logging, metrics, etc.
-     */
-    constructor(deps: PerpsPlatformDependencies);
-    /**
-     * Set controller-level dependencies for fee discount calculation.
-     * Called by PerpsController after construction to inject singleton dependencies.
-     *
-     * @param controllerDeps - Controller-level dependencies (RewardsController, etc.)
-     */
-    setControllerDependencies(controllerDeps: TradingServiceControllerDeps): void;
-    /**
-     * Error context helper for consistent logging.
-     *
-     * @param method - Method name
-     * @param additionalContext - Additional context data
-     * @returns Error context object
-     */
-    private getErrorContext;
-    /**
-     * Track order result analytics event (success or failure).
-     *
-     * @param options - Tracking options
-     * @param options.result
-     * @param options.error
-     * @param options.params
-     * @param options.context
-     * @param options.duration
-     */
-    private trackOrderResult;
-    /**
-     * Handle successful order placement (state updates, analytics, data lake reporting).
-     *
-     * @param options - Options for handling order success
-     * @param options.params
-     * @param options.context
-     * @param options.reportOrderToDataLake
-     */
-    private handleOrderSuccess;
-    /**
-     * Execute a trading operation with fee discount context.
-     * Ensures fee discount is always cleared after operation (success or failure).
-     *
-     * @param options - Options for fee discount context
-     * @param options.provider
-     * @param options.feeDiscountBips
-     * @param options.operation
-     * @returns The operation result
-     */
-    private withFeeDiscount;
-    /**
-     * Place a new order with full orchestration.
-     * Handles tracing, fee discounts, state management, analytics, and data lake reporting.
-     *
-     * @param options - Options for placing order
-     * @param options.provider
-     * @param options.params
-     * @param options.context
-     * @param options.reportOrderToDataLake
-     * @returns Order result
-     */
-    placeOrder(options: {
-        provider: PerpsProvider;
-        params: OrderParams;
-        context: ServiceContext;
-        reportOrderToDataLake: (params: {
-            action: 'open' | 'close';
-            symbol: string;
-            sl_price?: number;
-            tp_price?: number;
-        }) => Promise<{
-            success: boolean;
-            error?: string;
-        }>;
-    }): Promise<OrderResult>;
-    /**
-     * Load position data with performance measurement.
-     *
-     * @param options - Options for loading position data
-     * @param options.symbol
-     * @param options.context
-     * @returns The position or undefined
-     */
-    private loadPositionData;
-    /**
-     * Calculate close position metrics.
-     *
-     * @param position - The position being closed
-     * @param params - Close position parameters
-     * @param result - Order result
-     * @returns Calculated metrics
-     */
-    private calculateCloseMetrics;
-    /**
-     * Build event properties for position close analytics.
-     *
-     * @param position - The position being closed
-     * @param params - Close position parameters
-     * @param metrics - Calculated metrics
-     * @param metrics.direction
-     * @param result - Order result
-     * @param metrics.closePercentage
-     * @param status - Event status
-     * @param metrics.closeType
-     * @param error - Error message if any
-     * @param metrics.orderType
-     * @param metrics.requestedSize
-     * @returns Event properties
-     */
-    private buildCloseEventProperties;
-    /**
-     * Track position close result analytics (consolidates all tracking logic).
-     *
-     * @param options - Tracking options
-     * @param options.position
-     * @param options.result
-     * @param options.error
-     * @param options.params
-     * @param options.context
-     * @param options.duration
-     */
-    private trackPositionCloseResult;
-    /**
-     * Handle data lake reporting (fire-and-forget).
-     *
-     * @param reportOrderToDataLake - Data lake reporting function
-     * @param symbol - Asset symbol
-     * @param context - Service context
-     */
-    private handleDataLakeReporting;
-    /**
-     * Calculate fee discount with performance measurement.
-     * Uses controller dependencies injected via setControllerDependencies().
-     * Helper method for placeOrder orchestration.
-     *
-     * @returns Fee discount in basis points or undefined
-     */
-    private calculateFeeDiscountWithMeasurement;
-    /**
-     * Edit an existing order with full orchestration.
-     * Handles tracing, fee discounts, state management, and analytics.
-     *
-     * @param options - Options for editing order
-     * @param options.provider
-     * @param options.params
-     * @param options.context
-     * @returns Order result
-     */
-    editOrder(options: {
-        provider: PerpsProvider;
-        params: EditOrderParams;
-        context: ServiceContext;
-    }): Promise<OrderResult>;
-    /**
-     * Cancel a single order with full orchestration.
-     * Handles tracing, state management, and analytics.
-     *
-     * @param options - Options for canceling order
-     * @param options.provider
-     * @param options.params
-     * @param options.context
-     * @returns Cancel order result
-     */
-    cancelOrder(options: {
-        provider: PerpsProvider;
-        params: CancelOrderParams;
-        context: ServiceContext;
-    }): Promise<CancelOrderResult>;
-    /**
-     * Cancel multiple orders with full orchestration.
-     * Handles tracing, stream pausing, filtering, batch operations, and analytics.
-     *
-     * @param options - Options for canceling multiple orders
-     * @param options.provider
-     * @param options.params
-     * @param options.context
-     * @param options.withStreamPause
-     * @returns Cancel orders result
-     */
-    cancelOrders(options: {
-        provider: PerpsProvider;
-        params: CancelOrdersParams;
-        context: ServiceContext;
-        withStreamPause: <T>(operation: () => Promise<T>, channels: string[]) => Promise<T>;
-    }): Promise<CancelOrdersResult>;
-    /**
-     * Close a single position with full orchestration.
-     * Handles tracing, fee discounts, state management, analytics, and data lake reporting.
-     *
-     * @param options - Options for closing position
-     * @param options.provider
-     * @param options.params
-     * @param options.context
-     * @param options.reportOrderToDataLake
-     * @returns Order result
-     */
-    closePosition(options: {
-        provider: PerpsProvider;
-        params: ClosePositionParams;
-        context: ServiceContext;
-        reportOrderToDataLake: (params: {
-            action: 'open' | 'close';
-            symbol: string;
-        }) => Promise<{
-            success: boolean;
-            error?: string;
-        }>;
-    }): Promise<OrderResult>;
-    /**
-     * Close multiple positions with full orchestration.
-     * Handles tracing, fee discounts, batch operations, and analytics.
-     *
-     * @param options - Options for closing multiple positions
-     * @param options.provider
-     * @param options.params
-     * @param options.context
-     * @returns Close positions result
-     */
-    closePositions(options: {
-        provider: PerpsProvider;
-        params: ClosePositionsParams;
-        context: ServiceContext;
-    }): Promise<ClosePositionsResult>;
-    /**
-     * Update TP/SL for an existing position with full orchestration.
-     * Handles tracing, fee discounts, state management, and analytics.
-     *
-     * @param options - Options for updating TP/SL
-     * @param options.provider
-     * @param options.params
-     * @param options.context
-     * @returns Order result
-     */
-    updatePositionTPSL(options: {
-        provider: PerpsProvider;
-        params: UpdatePositionTPSLParams;
-        context: ServiceContext;
-    }): Promise<OrderResult>;
-    /**
-     * Update margin for an existing position (add or remove).
-     *
-     * @param options - Options for updating margin
-     * @param options.provider
-     * @param options.symbol
-     * @param options.amount
-     * @param options.context
-     * @returns Margin update result
-     */
-    updateMargin(options: {
-        provider: PerpsProvider;
-        symbol: string;
-        amount: string;
-        context: ServiceContext;
-    }): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    /**
-     * Flip position (reverse direction while keeping size and leverage).
-     *
-     * @param options - Options for flipping position
-     * @param options.provider
-     * @param options.position
-     * @param options.context
-     * @returns Order result
-     */
-    flipPosition(options: {
-        provider: PerpsProvider;
-        position: Position;
-        context: ServiceContext;
-    }): Promise<OrderResult>;
-}
-//# sourceMappingURL=TradingService.d.mts.map

package/dist/services/TradingService.d.mts.map

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