@varity-labs/sdk 2.0.0-alpha.1

package/dist/modules/notifications/NotificationsModule.js

@@ -0,0 +1,418 @@
+/**
+ * NotificationsModule - Universal notifications and alerting
+ *
+ * Provides multi-channel notification delivery with templates, scheduling,
+ * preferences, and alert rules. Works across all templates by using
+ * template-specific notification templates.
+ */
+export class NotificationsModule {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * Send notification immediately
+     *
+     * Universal method - sends notifications via any channel for any template.
+     * Template configuration provides template-specific message content.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * await sdk.notifications.send({
+     *   type: 'email',
+     *   to: 'merchant@example.com',
+     *   template: 'merchant_registered',
+     *   data: { merchantName: 'Acme Corp' }
+     * })
+     * ```
+     *
+     * @example Healthcare Dashboard
+     * ```typescript
+     * await sdk.notifications.send({
+     *   type: 'sms',
+     *   to: '+1234567890',
+     *   template: 'appointment_reminder',
+     *   data: { patientName: 'John Doe', appointmentTime: '2025-01-15 10:00' }
+     * })
+     * ```
+     */
+    async send(options) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/send`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to send notification: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Send batch notifications
+     *
+     * Universal method - sends multiple notifications efficiently.
+     *
+     * @example
+     * ```typescript
+     * const results = await sdk.notifications.sendBatch([
+     *   { type: 'email', to: 'user1@example.com', template: 'alert' },
+     *   { type: 'email', to: 'user2@example.com', template: 'alert' },
+     *   { type: 'sms', to: '+1234567890', template: 'urgent_alert' }
+     * ])
+     * ```
+     */
+    async sendBatch(notifications) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/send-batch`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify({ notifications })
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to send batch notifications: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Get notification preferences for a user
+     *
+     * Universal method - retrieves user notification preferences.
+     */
+    async getPreferences(userId) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const url = userId
+            ? `${apiEndpoint}/api/v1/notifications/preferences?userId=${userId}`
+            : `${apiEndpoint}/api/v1/notifications/preferences`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get notification preferences: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Set notification preferences for a user
+     *
+     * Universal method - updates user notification preferences.
+     *
+     * @example
+     * ```typescript
+     * await sdk.notifications.setPreferences({
+     *   email: true,
+     *   slack: true,
+     *   push: false,
+     *   alerts: ['compliance', 'anomaly', 'milestone'],
+     *   quietHours: {
+     *     enabled: true,
+     *     start: '22:00',
+     *     end: '08:00',
+     *     timezone: 'America/New_York'
+     *   }
+     * })
+     * ```
+     */
+    async setPreferences(preferences, userId) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/preferences`, {
+            method: 'PUT',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify({ preferences, userId })
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to set notification preferences: ${response.statusText}`);
+        }
+    }
+    /**
+     * Get notification history
+     *
+     * Universal method - retrieves past notifications with filtering.
+     *
+     * @example
+     * ```typescript
+     * const history = await sdk.notifications.getHistory({
+     *   type: 'email',
+     *   status: 'delivered',
+     *   startDate: '2025-01-01',
+     *   limit: 50
+     * })
+     * ```
+     */
+    async getHistory(options = {}) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/history`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get notification history: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Schedule notification for later delivery
+     *
+     * Universal method - schedules notifications for future delivery.
+     *
+     * @example
+     * ```typescript
+     * const scheduled = await sdk.notifications.schedule({
+     *   type: 'email',
+     *   to: 'user@example.com',
+     *   template: 'monthly_report',
+     *   scheduledFor: '2025-02-01T09:00:00Z',
+     *   repeat: {
+     *     interval: 'monthly',
+     *     count: 12
+     *   }
+     * })
+     * ```
+     */
+    async schedule(options) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/schedule`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(options)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to schedule notification: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Cancel scheduled notification
+     *
+     * Universal method - cancels a scheduled notification.
+     */
+    async cancelScheduled(notificationId) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/schedule/${notificationId}`, {
+            method: 'DELETE',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to cancel scheduled notification: ${response.statusText}`);
+        }
+    }
+    /**
+     * List scheduled notifications
+     *
+     * Universal method - lists all scheduled notifications.
+     */
+    async listScheduled(options = {}) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const queryParams = new URLSearchParams();
+        if (options.status)
+            queryParams.append('status', options.status);
+        if (options.limit)
+            queryParams.append('limit', options.limit.toString());
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/scheduled?${queryParams}`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to list scheduled notifications: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Create alert rule
+     *
+     * Universal method - creates an automatic alert based on conditions.
+     *
+     * @example ISO Dashboard
+     * ```typescript
+     * await sdk.notifications.createAlertRule({
+     *   name: 'High Residual Alert',
+     *   condition: {
+     *     metric: 'residual_amount',
+     *     operator: '>',
+     *     threshold: 10000,
+     *     duration: 300 // 5 minutes
+     *   },
+     *   notification: {
+     *     type: 'email',
+     *     to: 'admin@example.com',
+     *     template: 'high_residual_alert'
+     *   },
+     *   enabled: true
+     * })
+     * ```
+     */
+    async createAlertRule(rule) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/alert-rules`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(rule)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to create alert rule: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Update alert rule
+     *
+     * Universal method - updates an existing alert rule.
+     */
+    async updateAlertRule(ruleId, updates) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/alert-rules/${ruleId}`, {
+            method: 'PUT',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(updates)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to update alert rule: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Delete alert rule
+     *
+     * Universal method - deletes an alert rule.
+     */
+    async deleteAlertRule(ruleId) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/alert-rules/${ruleId}`, {
+            method: 'DELETE',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to delete alert rule: ${response.statusText}`);
+        }
+    }
+    /**
+     * List alert rules
+     *
+     * Universal method - lists all alert rules.
+     */
+    async listAlertRules(options = {}) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const queryParams = new URLSearchParams();
+        if (options.enabled !== undefined)
+            queryParams.append('enabled', options.enabled.toString());
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/alert-rules?${queryParams}`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to list alert rules: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Create notification template
+     *
+     * Universal method - creates a reusable notification template.
+     */
+    async createTemplate(template) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/templates`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(template)
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to create notification template: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Get notification template
+     *
+     * Universal method - retrieves a notification template by name.
+     */
+    async getTemplate(templateName) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/templates/${templateName}`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get notification template: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * List notification templates
+     *
+     * Universal method - lists all available notification templates.
+     */
+    async listTemplates(type) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const queryParams = type ? `?type=${type}` : '';
+        const response = await fetch(`${apiEndpoint}/api/v1/notifications/templates${queryParams}`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to list notification templates: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+}

package/dist/modules/notifications/index.d.ts

@@ -0,0 +1,3 @@
+export { NotificationsModule } from './NotificationsModule';
+export type { NotificationType, NotificationPriority, NotificationStatus, SendNotificationOptions, NotificationAttachment, NotificationResult, NotificationPreferences, NotificationHistoryOptions, NotificationHistoryEntry, NotificationHistoryResult, ScheduleNotificationOptions, ScheduledNotification, AlertRule, AlertCondition, AlertRuleResult, NotificationTemplate } from './NotificationsModule';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,SAAS,EACT,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,MAAM,uBAAuB,CAAA"}

package/dist/modules/notifications/index.js

@@ -0,0 +1 @@
+export { NotificationsModule } from './NotificationsModule';

package/dist/modules/oracle/OracleModule.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Varity SDK - Oracle Module
+ *
+ * Universal oracle data fetching.
+ * Works across all templates (ISO, Healthcare, Retail, etc.)
+ */
+import type { VaritySDK } from '../../core/VaritySDK';
+export interface OracleQuery {
+    source: string;
+    parameters: Record<string, any>;
+}
+export interface OracleData {
+    value: any;
+    timestamp: number;
+    source: string;
+    confidence?: number;
+}
+export interface DataCallback {
+    (data: OracleData): void;
+}
+export interface Subscription {
+    id: string;
+    unsubscribe: () => Promise<void>;
+}
+export interface PriceData {
+    asset: string;
+    price: number;
+    currency: string;
+    timestamp: number;
+    source: string;
+}
+export interface TimeRange {
+    start: Date;
+    end: Date;
+}
+export interface PriceHistory {
+    asset: string;
+    prices: Array<{
+        price: number;
+        timestamp: number;
+    }>;
+    range: TimeRange;
+}
+/**
+ * OracleModule - Universal oracle data fetching
+ *
+ * @example
+ * ```typescript
+ * // Get oracle data
+ * const data = await sdk.oracle.getData({
+ *   source: 'chainlink',
+ *   parameters: { asset: 'ETH/USD' }
+ * })
+ *
+ * // Get price feed
+ * const price = await sdk.oracle.getPrice('ETH')
+ *
+ * // Subscribe to updates
+ * const sub = await sdk.oracle.subscribe(
+ *   { source: 'chainlink', parameters: { asset: 'ETH/USD' } },
+ *   (data) => console.log('New price:', data.value)
+ * )
+ * ```
+ */
+export declare class OracleModule {
+    private sdk;
+    private subscriptions;
+    constructor(sdk: VaritySDK);
+    /**
+     * Get data from oracle
+     *
+     * @param query - Oracle query
+     * @returns Oracle data
+     */
+    getData(query: OracleQuery): Promise<OracleData>;
+    /**
+     * Subscribe to oracle data updates
+     *
+     * @param query - Oracle query
+     * @param callback - Data callback
+     * @returns Subscription
+     */
+    subscribe(query: OracleQuery, callback: DataCallback): Promise<Subscription>;
+    /**
+     * Unsubscribe from oracle data
+     *
+     * @param subscriptionId - Subscription identifier
+     */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /**
+     * Get current price for an asset
+     *
+     * @param asset - Asset symbol (e.g., 'ETH', 'BTC')
+     * @returns Price data
+     */
+    getPrice(asset: string): Promise<PriceData>;
+    /**
+     * Get price history for an asset
+     *
+     * @param asset - Asset symbol
+     * @param range - Time range
+     * @returns Price history
+     */
+    getPriceHistory(asset: string, range: TimeRange): Promise<PriceHistory>;
+    /**
+     * Remove all subscriptions
+     */
+    removeAllSubscriptions(): Promise<void>;
+}
+//# sourceMappingURL=OracleModule.d.ts.map

package/dist/modules/oracle/OracleModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OracleModule.d.ts","sourceRoot":"","sources":["../../../src/modules/oracle/OracleModule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,GAAG,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,CAAA;IACX,GAAG,EAAE,IAAI,CAAA;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,MAAM,CAAA;KAClB,CAAC,CAAA;IACF,KAAK,EAAE,SAAS,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,aAAa,CAA8B;gBAEvC,GAAG,EAAE,SAAS;IAI1B;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBtD;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBlF;;;;OAIG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAejD;;;;;;OAMG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IA2B7E;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;CAO9C"}

package/dist/modules/oracle/OracleModule.js

@@ -0,0 +1,151 @@
+/**
+ * Varity SDK - Oracle Module
+ *
+ * Universal oracle data fetching.
+ * Works across all templates (ISO, Healthcare, Retail, etc.)
+ */
+/**
+ * OracleModule - Universal oracle data fetching
+ *
+ * @example
+ * ```typescript
+ * // Get oracle data
+ * const data = await sdk.oracle.getData({
+ *   source: 'chainlink',
+ *   parameters: { asset: 'ETH/USD' }
+ * })
+ *
+ * // Get price feed
+ * const price = await sdk.oracle.getPrice('ETH')
+ *
+ * // Subscribe to updates
+ * const sub = await sdk.oracle.subscribe(
+ *   { source: 'chainlink', parameters: { asset: 'ETH/USD' } },
+ *   (data) => console.log('New price:', data.value)
+ * )
+ * ```
+ */
+export class OracleModule {
+    constructor(sdk) {
+        this.subscriptions = new Map();
+        this.sdk = sdk;
+    }
+    /**
+     * Get data from oracle
+     *
+     * @param query - Oracle query
+     * @returns Oracle data
+     */
+    async getData(query) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/oracle/query`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify(query)
+        });
+        if (!response.ok) {
+            throw new Error(`Oracle query failed: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Subscribe to oracle data updates
+     *
+     * @param query - Oracle query
+     * @param callback - Data callback
+     * @returns Subscription
+     */
+    async subscribe(query, callback) {
+        const subscriptionId = `${query.source}:${JSON.stringify(query.parameters)}`;
+        // For v1, we use polling. Future versions could use WebSocket
+        const pollInterval = setInterval(async () => {
+            try {
+                const data = await this.getData(query);
+                callback(data);
+            }
+            catch (error) {
+                console.error('Oracle subscription error:', error);
+            }
+        }, 5000); // Poll every 5 seconds
+        this.subscriptions.set(subscriptionId, pollInterval);
+        return {
+            id: subscriptionId,
+            unsubscribe: async () => {
+                await this.unsubscribe(subscriptionId);
+            }
+        };
+    }
+    /**
+     * Unsubscribe from oracle data
+     *
+     * @param subscriptionId - Subscription identifier
+     */
+    async unsubscribe(subscriptionId) {
+        const interval = this.subscriptions.get(subscriptionId);
+        if (interval) {
+            clearInterval(interval);
+            this.subscriptions.delete(subscriptionId);
+            console.log(`✅ Unsubscribed from ${subscriptionId}`);
+        }
+    }
+    /**
+     * Get current price for an asset
+     *
+     * @param asset - Asset symbol (e.g., 'ETH', 'BTC')
+     * @returns Price data
+     */
+    async getPrice(asset) {
+        const data = await this.getData({
+            source: 'chainlink',
+            parameters: { asset: `${asset}/USD` }
+        });
+        return {
+            asset,
+            price: data.value,
+            currency: 'USD',
+            timestamp: data.timestamp,
+            source: data.source
+        };
+    }
+    /**
+     * Get price history for an asset
+     *
+     * @param asset - Asset symbol
+     * @param range - Time range
+     * @returns Price history
+     */
+    async getPriceHistory(asset, range) {
+        const apiEndpoint = this.sdk.getAPIEndpoint();
+        const apiKey = this.sdk.getAPIKey();
+        const response = await fetch(`${apiEndpoint}/api/v1/oracle/price-history`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(apiKey && { 'Authorization': `Bearer ${apiKey}` })
+            },
+            body: JSON.stringify({
+                asset,
+                start: range.start.toISOString(),
+                end: range.end.toISOString()
+            })
+        });
+        if (!response.ok) {
+            throw new Error(`Price history failed: ${response.statusText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Remove all subscriptions
+     */
+    async removeAllSubscriptions() {
+        for (const [id, interval] of this.subscriptions.entries()) {
+            clearInterval(interval);
+        }
+        this.subscriptions.clear();
+        console.log('✅ All oracle subscriptions removed');
+    }
+}