@termix-it/vue-tool 1.0.0

package/dist/composables/useToast.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Toast Composable
+ *
+ * Simple toast notification composable - can be replaced with your preferred toast library
+ */
+export interface ToastOptions {
+    title: string;
+    description?: string;
+    variant?: 'default' | 'destructive';
+}
+export declare function useToast(): {
+    toast: (options: ToastOptions) => void;
+};
+//# sourceMappingURL=useToast.d.ts.map

package/dist/composables/useToast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToast.d.ts","sourceRoot":"","sources":["../../src/composables/useToast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;CACrC;AAED,wBAAgB,QAAQ;qBACE,YAAY;EAcrC"}

package/dist/core/container.d.ts

@@ -0,0 +1,99 @@
+import { Container } from 'inversify';
+import { SDKConfig } from './types';
+
+/**
+ * Get the global container instance
+ * Throws error if not initialized
+ */
+export declare function getContainer(): Container;
+/**
+ * Check if container is initialized
+ */
+export declare function isContainerInitialized(): boolean;
+/**
+ * Initialize the DI container with configuration
+ *
+ * This function:
+ * 1. Creates a new container instance
+ * 2. Registers all core services
+ * 3. Registers all executors
+ * 4. Registers all renderers
+ * 5. Binds configuration values
+ *
+ * @param config - SDK configuration
+ * @returns Initialized container
+ */
+export declare function initializeContainer(config: SDKConfig): Container;
+/**
+ * Reset the container (useful for testing)
+ */
+export declare function resetContainer(): void;
+/**
+ * Create a child container (for scoped dependencies)
+ *
+ * Useful for:
+ * - Per-request scoping
+ * - Per-component scoping
+ * - Testing with mocks
+ *
+ * @param parentContainer - Parent container to inherit from
+ * @returns New child container
+ */
+export declare function createChildContainer(parentContainer?: Container): Container;
+/**
+ * Helper to get a service from the container
+ *
+ * Type-safe service resolution
+ *
+ * @param token - Service token
+ * @returns Service instance
+ */
+export declare function getService<T>(token: symbol): T;
+/**
+ * Helper to get all services of a type (for registries)
+ *
+ * @param token - Service token
+ * @returns Array of service instances
+ */
+export declare function getAllServices<T>(token: symbol): T[];
+/**
+ * Helper to check if a service is bound
+ *
+ * @param token - Service token
+ * @returns True if service is bound
+ */
+export declare function hasService(token: symbol): boolean;
+/**
+ * Helper to bind a service manually
+ *
+ * @param token - Service token
+ * @param service - Service instance or factory
+ * @param scope - Service scope (Singleton, Transient, Request)
+ */
+export declare function bindService<T>(token: symbol, service: new (...args: any[]) => T | T, scope?: 'Singleton' | 'Transient' | 'Request'): void;
+/**
+ * Helper to bind a factory function
+ *
+ * @param token - Service token
+ * @param factory - Factory function
+ */
+export declare function bindFactory<T>(token: symbol, factory: (context: any) => T): void;
+/**
+ * Helper to unbind a service
+ *
+ * @param token - Service token
+ */
+export declare function unbindService(token: symbol): void;
+/**
+ * Container snapshot for testing
+ */
+export interface ContainerSnapshot {
+    config: SDKConfig;
+    services: Map<symbol, any>;
+}
+/**
+ * Create a snapshot of the container state
+ * Useful for debugging and testing
+ */
+export declare function snapshotContainer(): ContainerSnapshot;
+//# sourceMappingURL=container.d.ts.map

package/dist/core/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/core/container.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAiCpC;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAsBhE;AAsFD;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,CAAC,EAAE,SAAS,GAAG,SAAS,CAM3E;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAGpD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EACtC,KAAK,GAAE,WAAW,GAAG,WAAW,GAAG,SAAuB,GACzD,IAAI,CAsBN;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,GAC3B,IAAI,CAGN;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CAgBrD"}

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tokens';
+export * from './types';
+export * from './container';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/core/internal-container.d.ts

@@ -0,0 +1,26 @@
+import { Container } from 'inversify';
+
+export interface ContainerConfig {
+    projectId: string;
+    authorization?: string;
+    apiBaseUrl?: string;
+    domainHeaders?: any[];
+    proxyMode?: boolean;
+}
+/**
+ * Get or create a container instance based on configuration.
+ * If the configuration hasn't changed, returns the cached container.
+ * Otherwise, creates a new container with the new configuration.
+ */
+export declare function getOrCreateContainer(config: ContainerConfig): Container;
+/**
+ * Reset the global container.
+ * Useful for testing or when you need to force re-initialization.
+ */
+export declare function resetContainer(): void;
+/**
+ * Get the current container instance without creating a new one.
+ * Returns null if no container has been initialized yet.
+ */
+export declare function getCurrentContainer(): Container | null;
+//# sourceMappingURL=internal-container.d.ts.map

package/dist/core/internal-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-container.d.ts","sourceRoot":"","sources":["../../src/core/internal-container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AActC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,GAAG,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAyBvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,GAAG,IAAI,CAEtD"}

package/dist/core/tokens.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Dependency Injection Tokens
+ *
+ * This file defines all the injection tokens used throughout the application.
+ * Using symbols ensures type-safe dependency injection and prevents naming collisions.
+ *
+ * Inspired by Angular's DI token system.
+ */
+/**
+ * Core Service Tokens
+ */
+export declare const TOKENS: {
+    readonly APIClient: symbol;
+    readonly EthersAdapter: symbol;
+    readonly WalletService: symbol;
+    readonly MoonPayService: symbol;
+    readonly ToolCallProcessor: symbol;
+    readonly FunctionCallExecutor: symbol;
+    readonly ExecutorRegistry: symbol;
+    readonly APIExecutor: symbol;
+    readonly ContractExecutor: symbol;
+    readonly FiatExecutor: symbol;
+    readonly AP2Executor: symbol;
+    readonly RendererRegistry: symbol;
+    readonly APIRenderer: symbol;
+    readonly ContractRenderer: symbol;
+    readonly FiatRenderer: symbol;
+    readonly AP2Renderer: symbol;
+    readonly SDKConfig: symbol;
+    readonly DomainHeaders: symbol;
+    readonly Authorization: symbol;
+    readonly APIBaseUrl: symbol;
+    readonly ProxyMode: symbol;
+};
+/**
+ * Type-safe token accessor
+ */
+export type TokenType = typeof TOKENS;
+export type TokenKey = keyof TokenType;
+/**
+ * Helper to get token by key
+ */
+export declare function getToken(key: TokenKey): symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/core/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/core/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;CAmCT,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC;AACtC,MAAM,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC;AAEvC;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAE9C"}

package/dist/core/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Core Type Definitions for DI System
+ *
+ * This file contains shared type definitions used across the DI infrastructure.
+ */
+/**
+ * SDK Configuration passed during initialization
+ */
+export interface SDKConfig {
+    projectId: string;
+    aiConfigId?: string;
+    authorization?: string;
+    apiBaseUrl?: string;
+    domainHeaders?: DomainHeaderConfig[];
+    restExecuteHeaders?: Record<string, string>;
+    proxyMode?: boolean;
+}
+/**
+ * Domain-specific header configuration
+ */
+export interface DomainHeaderConfig {
+    domain: string;
+    headers: Record<string, string>;
+}
+/**
+ * API Request object for beforeCallApiFunc hook
+ */
+export interface ApiRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    params?: Record<string, any>;
+    data?: any;
+}
+/**
+ * Hook function called before API executor makes a request
+ */
+export type BeforeCallApiFunc = (request: ApiRequest) => Promise<ApiRequest>;
+/**
+ * Execution context passed to executors
+ */
+export interface ExecutionContext {
+    projectId: string;
+    authorization?: string;
+    domainHeaders?: DomainHeaderConfig[];
+    restExecuteHeaders?: Record<string, string>;
+    onProgress?: (progress: ExecutionProgress) => void;
+    onError?: (error: ExecutionError) => void;
+    /**
+     * Optional hook called before API executor makes a request.
+     * Allows modification of the request object before it's sent.
+     */
+    beforeCallApiFunc?: BeforeCallApiFunc;
+}
+/**
+ * Execution progress callback data
+ */
+export interface ExecutionProgress {
+    stage: 'preparing' | 'executing' | 'processing' | 'completed';
+    message?: string;
+    percentage?: number;
+}
+/**
+ * Execution error callback data
+ */
+export interface ExecutionError {
+    code: string;
+    message: string;
+    details?: any;
+}
+/**
+ * Render context passed to renderers
+ */
+export interface RenderContext {
+    projectId: string;
+    authorization?: string;
+    domainHeaders?: DomainHeaderConfig[];
+    onExecute?: (functionCall: any) => Promise<void>;
+    onExecutionComplete?: (result: any) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Plugin lifecycle interface
+ */
+export interface Plugin {
+    name: string;
+    version: string;
+    onLoad?: (container: any) => Promise<void>;
+    onUnload?: () => Promise<void>;
+}
+/**
+ * Service lifecycle interface
+ */
+export interface IDisposable {
+    dispose(): Promise<void> | void;
+}
+/**
+ * Service initialization interface
+ */
+export interface IInitializable {
+    initialize(): Promise<void> | void;
+    isInitialized(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/executors/AP2Executor.d.ts

@@ -0,0 +1,20 @@
+import { BaseExecutor } from './base/BaseExecutor';
+import { FunctionCall, ExecutionResult } from '../types';
+import { ExecutionContext } from '../core/types';
+import { IAPIClient } from '../interfaces/IAPIClient';
+import { ValidationResult } from '../interfaces/IExecutor';
+
+export declare class AP2Executor extends BaseExecutor {
+    private apiClient;
+    readonly type = "ap2";
+    constructor(apiClient: IAPIClient);
+    /**
+     * Validate AP2-specific requirements
+     */
+    protected validateCustom(functionCall: FunctionCall): Partial<ValidationResult>;
+    /**
+     * Execute AP2 tool call
+     */
+    protected executeInternal(functionCall: FunctionCall, context: ExecutionContext): Promise<ExecutionResult>;
+}
+//# sourceMappingURL=AP2Executor.d.ts.map

package/dist/executors/AP2Executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AP2Executor.d.ts","sourceRoot":"","sources":["../../src/executors/AP2Executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,qBACa,WAAY,SAAQ,YAAY;IAGL,OAAO,CAAC,SAAS;IAFvD,QAAQ,CAAC,IAAI,SAAS;gBAEwB,SAAS,EAAE,UAAU;IAInE;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAU/E;;OAEG;cACa,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;CA+C5B"}

package/dist/executors/APIExecutor.d.ts

@@ -0,0 +1,35 @@
+import { BaseExecutor } from './base/BaseExecutor';
+import { FunctionCall, ExecutionResult, DomainHeaderConfig } from '../types';
+import { ExecutionContext } from '../core/types';
+import { IWalletService } from '../services/walletService';
+import { ValidationResult } from '../interfaces/IExecutor';
+
+export declare class APIExecutor extends BaseExecutor {
+    private walletService;
+    private domainHeaders;
+    private proxyMode;
+    private apiBaseUrl?;
+    readonly type = "api";
+    constructor(walletService: IWalletService, domainHeaders?: DomainHeaderConfig[], proxyMode?: boolean, apiBaseUrl?: string | undefined);
+    /**
+     * Validate API-specific requirements
+     */
+    protected validateCustom(functionCall: FunctionCall): Partial<ValidationResult>;
+    /**
+     * Execute REST API call
+     */
+    protected executeInternal(functionCall: FunctionCall, context: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Match domain pattern against URL hostname
+     */
+    private matchDomain;
+    /**
+     * Get headers for a specific URL by matching domain patterns
+     */
+    private getHeadersForUrl;
+    /**
+     * Execute a calldata transaction on the blockchain
+     */
+    private executeCalldataTransaction;
+}
+//# sourceMappingURL=APIExecutor.d.ts.map

package/dist/executors/APIExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIExecutor.d.ts","sourceRoot":"","sources":["../../src/executors/APIExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAc,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,qBACa,WAAY,SAAQ,YAAY;IAIX,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,aAAa;IACzB,OAAO,CAAC,SAAS;IAChB,OAAO,CAAC,UAAU,CAAC;IANhD,QAAQ,CAAC,IAAI,SAAS;gBAGkB,aAAa,EAAE,cAAc,EAC7B,aAAa,GAAE,kBAAkB,EAAO,EAC5C,SAAS,GAAE,OAAe,EACzB,UAAU,CAAC,EAAE,MAAM,YAAA;IAMxD;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAU/E;;OAEG;cACa,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAmJ3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;YACW,0BAA0B;CAsCzC"}

package/dist/executors/ContractExecutor.d.ts

@@ -0,0 +1,41 @@
+import { BaseExecutor } from './base/BaseExecutor';
+import { FunctionCall, ExecutionResult } from '../types';
+import { ExecutionContext } from '../core/types';
+import { IWalletService } from '../services/walletService';
+import { IAPIClient } from '../interfaces/IAPIClient';
+import { IEthersAdapter } from '../interfaces/IEthersAdapter';
+import { ValidationResult } from '../interfaces/IExecutor';
+
+export declare class ContractExecutor extends BaseExecutor {
+    private walletService;
+    private apiClient;
+    private ethersAdapter;
+    readonly type = "contract";
+    private contractABICache;
+    constructor(walletService: IWalletService, apiClient: IAPIClient, ethersAdapter: IEthersAdapter);
+    /**
+     * Validate contract-specific requirements
+     */
+    protected validateCustom(functionCall: FunctionCall): Partial<ValidationResult>;
+    /**
+     * Execute smart contract call
+     */
+    protected executeInternal(functionCall: FunctionCall, context: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Fetch ABI for a contract method from the backend
+     */
+    private getContractABI;
+    /**
+     * Execute Web3 transaction (read or write)
+     */
+    private executeWeb3Transaction;
+    /**
+     * Convert parameters object to ordered array based on ABI
+     */
+    private convertParametersToArray;
+    /**
+     * Attempt to determine the correct ABI function name to use for encoding.
+     */
+    private extractFunctionNameFromABI;
+}
+//# sourceMappingURL=ContractExecutor.d.ts.map

package/dist/executors/ContractExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContractExecutor.d.ts","sourceRoot":"","sources":["../../src/executors/ContractExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,qBACa,gBAAiB,SAAQ,YAAY;IAOhB,OAAO,CAAC,aAAa;IACzB,OAAO,CAAC,SAAS;IACb,OAAO,CAAC,aAAa;IARrD,QAAQ,CAAC,IAAI,cAAc;IAG3B,OAAO,CAAC,gBAAgB,CAAgE;gBAGhD,aAAa,EAAE,cAAc,EACjC,SAAS,EAAE,UAAU,EACjB,aAAa,EAAE,cAAc;IAKrE;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmB/E;;OAEG;cACa,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAwH3B;;OAEG;YACW,cAAc;IAwE5B;;OAEG;YACW,sBAAsB;IA2DpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmBhC;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAkBnC"}

package/dist/executors/ExecutorRegistry.d.ts

@@ -0,0 +1,99 @@
+import { IExecutor } from '../interfaces/IExecutor';
+import { FunctionCall, ExecutionResult } from '../types';
+import { ExecutionContext } from '../core/types';
+
+/**
+ * Executor registry manages all registered executors
+ * and routes function calls to the appropriate executor
+ */
+export declare class ExecutorRegistry {
+    private executorMap;
+    constructor(apiExecutor: IExecutor, contractExecutor: IExecutor, fiatExecutor: IExecutor, ap2Executor: IExecutor);
+    /**
+     * Register an executor
+     *
+     * @param executor - Executor instance to register
+     */
+    register(executor: IExecutor): void;
+    /**
+     * Unregister an executor
+     *
+     * @param type - Executor type to unregister
+     */
+    unregister(type: string): boolean;
+    /**
+     * Get an executor by type
+     *
+     * @param type - Executor type
+     * @returns Executor instance or undefined
+     */
+    getExecutor(type: string): IExecutor | undefined;
+    /**
+     * Check if an executor is registered
+     *
+     * @param type - Executor type
+     * @returns True if executor is registered
+     */
+    hasExecutor(type: string): boolean;
+    /**
+     * Get all registered executors
+     *
+     * @returns Array of all executor instances
+     */
+    getAllExecutors(): IExecutor[];
+    /**
+     * Get all registered executor types
+     *
+     * @returns Array of executor type strings
+     */
+    getExecutorTypes(): string[];
+    /**
+     * Find the appropriate executor for a function call
+     *
+     * Uses the executor's canHandle method to determine if it can execute the call.
+     * Falls back to type-based matching if no executor claims to handle it.
+     *
+     * @param functionCall - Function call to find executor for
+     * @returns Executor instance or undefined
+     */
+    findExecutor(functionCall: FunctionCall): IExecutor | undefined;
+    /**
+     * Execute a function call
+     *
+     * Automatically finds the appropriate executor and executes the call.
+     *
+     * @param functionCall - Function call to execute
+     * @param context - Execution context
+     * @returns Execution result
+     */
+    execute(functionCall: FunctionCall, context: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Validate a function call
+     *
+     * Finds the appropriate executor and validates the call.
+     *
+     * @param functionCall - Function call to validate
+     * @returns Validation result
+     */
+    validate(functionCall: FunctionCall): {
+        isValid: boolean;
+        errors?: string[];
+        warnings?: string[];
+        executorType?: string;
+    };
+    /**
+     * Batch execute multiple function calls
+     *
+     * Executes multiple function calls in parallel.
+     *
+     * @param functionCalls - Array of function calls to execute
+     * @param context - Execution context
+     * @returns Array of execution results in the same order
+     */
+    executeMany(functionCalls: FunctionCall[], context: ExecutionContext): Promise<ExecutionResult[]>;
+    /**
+     * Log helper
+     */
+    private log;
+}
+//# sourceMappingURL=ExecutorRegistry.d.ts.map

package/dist/executors/ExecutorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutorRegistry.d.ts","sourceRoot":"","sources":["../../src/executors/ExecutorRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD;;;GAGG;AACH,qBACa,gBAAgB;IAE3B,OAAO,CAAC,WAAW,CAAqC;gBAI1B,WAAW,EAAE,SAAS,EACjB,gBAAgB,EAAE,SAAS,EAC/B,YAAY,EAAE,SAAS,EACxB,WAAW,EAAE,SAAS;IAWpD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAWnC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIhD;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;OAIG;IACH,eAAe,IAAI,SAAS,EAAE;IAI9B;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;;;;;;;OAQG;IACH,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS;IAoB/D;;;;;;;;OAQG;IACG,OAAO,CACX,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAiD3B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG;QACpC,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAoBD;;;;;;;;OAQG;IACG,WAAW,CACf,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,EAAE,CAAC;IAM7B;;OAEG;IACH,OAAO,CAAC,GAAG;CAQZ"}

package/dist/executors/FiatExecutor.d.ts

@@ -0,0 +1,31 @@
+import { BaseExecutor } from './base/BaseExecutor';
+import { FunctionCall, ExecutionResult } from '../types';
+import { ExecutionContext } from '../core/types';
+
+export interface IMoonPayService {
+    createBuyTransaction(params: any): Promise<any>;
+    createSellTransaction(params: any): Promise<any>;
+}
+export declare class FiatExecutor extends BaseExecutor {
+    private moonPayService;
+    readonly type = "fiat";
+    private readonly MOONPAY_LIMITS;
+    constructor(moonPayService: IMoonPayService);
+    /**
+     * Execute fiat operation
+     */
+    protected executeInternal(functionCall: FunctionCall, context: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Execute MoonPay buy operation
+     */
+    private executeMoonPayBuy;
+    /**
+     * Execute MoonPay sell operation
+     */
+    private executeMoonPaySell;
+    /**
+     * Get MoonPay currencies
+     */
+    private getMoonPayCurrencies;
+}
+//# sourceMappingURL=FiatExecutor.d.ts.map

package/dist/executors/FiatExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FiatExecutor.d.ts","sourceRoot":"","sources":["../../src/executors/FiatExecutor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKjD,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,qBAAqB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAClD;AAED,qBACa,YAAa,SAAQ,YAAY;IAOX,OAAO,CAAC,cAAc;IANvD,QAAQ,CAAC,IAAI,UAAU;IAGvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;gBAGjB,cAAc,EAAE,eAAe;IAKxE;;OAEG;cACa,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAuB3B;;OAEG;YACW,iBAAiB;IAgE/B;;OAEG;YACW,kBAAkB;IAsDhC;;OAEG;YACW,oBAAoB;CA+CnC"}

package/dist/executors/base/BaseExecutor.d.ts

@@ -0,0 +1,87 @@
+import { IExecutorWithLifecycle, ValidationResult } from '../../interfaces/IExecutor';
+import { FunctionCall, ExecutionResult } from '../../types';
+import { ExecutionContext, ExecutionProgress } from '../../core/types';
+
+export declare abstract class BaseExecutor implements IExecutorWithLifecycle {
+    /**
+     * Type identifier for this executor
+     * Must be overridden by subclasses
+     */
+    abstract readonly type: string;
+    /**
+     * Human-readable name for logging
+     */
+    protected get name(): string;
+    /**
+     * Check if this executor can handle the given function call
+     * Default implementation checks if function type matches executor type
+     */
+    canHandle(functionCall: FunctionCall): boolean;
+    /**
+     * Validate function call before execution
+     * Can be overridden by subclasses for custom validation
+     */
+    validate(functionCall: FunctionCall): ValidationResult;
+    /**
+     * Custom validation logic for subclasses
+     * Override this to add type-specific validation
+     */
+    protected validateCustom(functionCall: FunctionCall): Partial<ValidationResult>;
+    /**
+     * Execute the function call
+     * This is the main entry point that orchestrates the execution lifecycle
+     */
+    execute(functionCall: FunctionCall, context: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Internal execution logic - must be implemented by subclasses
+     * This is where the actual work happens
+     */
+    protected abstract executeInternal(functionCall: FunctionCall, context: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Lifecycle hook: called when executor is initialized
+     */
+    onInit?(): Promise<void>;
+    /**
+     * Lifecycle hook: called before execution starts
+     */
+    onBeforeExecute?(functionCall: FunctionCall, context: ExecutionContext): Promise<void>;
+    /**
+     * Lifecycle hook: called to prepare execution
+     * Useful for fetching metadata, checking permissions, etc.
+     */
+    protected onPrepare?(functionCall: FunctionCall, context: ExecutionContext): Promise<void>;
+    /**
+     * Lifecycle hook: called to post-process result
+     * Useful for transforming data, adding metadata, etc.
+     */
+    protected onPostProcess?(result: ExecutionResult, functionCall: FunctionCall, context: ExecutionContext): Promise<ExecutionResult>;
+    /**
+     * Lifecycle hook: called after execution completes (success or failure)
+     */
+    onAfterExecute?(functionCall: FunctionCall, result: ExecutionResult, context: ExecutionContext): Promise<void>;
+    /**
+     * Lifecycle hook: called when executor is disposed
+     */
+    onDispose?(): Promise<void>;
+    /**
+     * Helper: Create a success result
+     */
+    protected createSuccessResult(data: any, metadata?: Record<string, any>): ExecutionResult;
+    /**
+     * Helper: Create an error result
+     */
+    protected createErrorResult(error: string, functionCall?: FunctionCall, metadata?: Record<string, any>): ExecutionResult;
+    /**
+     * Helper: Report execution progress
+     */
+    protected reportProgress(context: ExecutionContext, progress: ExecutionProgress): void;
+    /**
+     * Helper: Log messages with consistent formatting
+     */
+    protected log(level: 'info' | 'warn' | 'error', message: string, data?: any): void;
+    /**
+     * Helper: Sleep utility for testing/delays
+     */
+    protected sleep(ms: number): Promise<void>;
+}
+//# sourceMappingURL=BaseExecutor.d.ts.map