@gala-chain/launchpad-sdk 3.15.4 → 3.16.1

package/dist/services/PriceHistoryService.d.ts

@@ -1,11 +1,13 @@
 /**
  * Price History Service
  *
- * Handles fetching historical price data from MySQL database for DEX tokens.
- * This service is Node.js-only and requires a MySQL connection string in configuration.
+ * Handles fetching historical price data for DEX tokens with dual implementation:
+ * - Token history (fetchPriceHistory): Uses DEX Backend API
+ * - Price sheet (fetchPrices): Uses MySQL database
  *
  * Features:
- * - Direct MySQL connection with connection pooling
+ * - DEX Backend API integration for token price history
+ * - MySQL connection pooling for price sheet queries
  * - Pagination matching SDK conventions
  * - Date range filtering
  * - Token filtering by TokenClassKey
@@ -16,6 +18,7 @@
  * @since 3.13.0
  */
 import { FetchPriceHistoryOptions, PriceHistoryResult, FetchPricesOptions, PricesResult } from '../types/priceHistory.dto';
+import { HttpClient } from '../utils/http';
 /**
  * Price History Service Class
  *
@@ -48,13 +51,15 @@ export declare class PriceHistoryService {
     private readonly connectionString;
     private readonly maxConnections;
     private readonly queryTimeout;
+    private readonly httpClient;
     /**
      * Create a new PriceHistoryService instance
      * @param connectionString MySQL connection string (format: mysql://user:password@host:port/database)
+     * @param httpClient HTTP client for DEX Backend API (for fetchPriceHistory)
      * @param debugMode Enable debug logging
      * @param config Optional configuration for connection pooling and timeouts
      */
-    constructor(connectionString: string, debugMode?: boolean, config?: PriceHistoryServiceConfig);
+    constructor(connectionString: string, httpClient: HttpClient, debugMode?: boolean, config?: PriceHistoryServiceConfig);
     /**
      * Build connection string with pool configuration options as URL parameters
      * mysql2.createPool() only accepts a single parameter (the connection string)
@@ -70,10 +75,12 @@ export declare class PriceHistoryService {
     /**
      * Fetch price history for a token with pagination
      *
+     * Fetches historical price snapshots from DEX Backend API.
+     * Returns paginated results matching SDK conventions.
+     *
      * @param options Fetch options including flexible token ID, date range, and pagination
      * @returns Promise<PriceHistoryResult> Price snapshots with pagination metadata
-     * @throws ConfigurationError if MySQL not configured
-     * @throws NetworkError if database query fails
+     * @throws NetworkError if API request fails
      * @throws ValidationError if parameters are invalid
      *
      * @example
@@ -101,16 +108,20 @@ export declare class PriceHistoryService {
      * ```
      */
     fetchPriceHistory(options: FetchPriceHistoryOptions): Promise<PriceHistoryResult>;
+    /**
+     * Transform DEX Backend API response to SDK PriceHistoryResult format
+     * @internal
+     */
+    private transformApiResponseToPriceHistory;
     /**
      * Fetch all price history for a token with automatic pagination
      *
-     * Convenience method that automatically iterates through all pages and combines results.
+     * Convenience method that automatically iterates through all pages from DEX Backend API and combines results.
      * Returns all available price snapshots matching the filter criteria.
      *
      * @param options Fetch options including token ID, date range, and sort order (no pagination parameters)
      * @returns Promise<PriceHistoryResult> All price snapshots with total count, combined from all pages
-     * @throws ConfigurationError if MySQL not configured
-     * @throws NetworkError if database query fails
+     * @throws NetworkError if API request fails
      * @throws ValidationError if parameters are invalid
      *
      * @example

package/dist/services/PriceHistoryService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PriceHistoryService.d.ts","sourceRoot":"","sources":["../../src/services/PriceHistoryService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAElB,kBAAkB,EAClB,YAAY,EACb,MAAM,2BAA2B,CAAC;AAOnC;;;;;;;;;;;;;;;;GAgBG;AACH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC;;;;;OAKG;gBACS,gBAAgB,EAAE,MAAM,EAAE,SAAS,GAAE,OAAe,EAAE,MAAM,CAAC,EAAE,yBAAyB;IAsBpG;;;;;OAKG;IACH,OAAO,CAAC,gCAAgC;IAexC;;;OAGG;YACW,gBAAgB;IAiD9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyGvF;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,oBAAoB,CACxB,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,OAAO,CAAC,GACxD,OAAO,CAAC,kBAAkB,CAAC;IAoC9B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC;IA2FxB;;;;;;;;;;;;;;;;OAgBG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IAmC7C;;;;;;;;;OASG;YACW,eAAe;IAO7B;;;OAGG;YACW,YAAY;IAgD1B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;;OAGG;IACH,OAAO,CAAC,eAAe;IA+BvB;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAYlC"}
+{"version":3,"file":"PriceHistoryService.d.ts","sourceRoot":"","sources":["../../src/services/PriceHistoryService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAElB,kBAAkB,EAClB,YAAY,EAEb,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAO3C;;;;;;;;;;;;;;;;GAgBG;AACH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;;;;;OAMG;gBAED,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,UAAU,EACtB,SAAS,GAAE,OAAe,EAC1B,MAAM,CAAC,EAAE,yBAAyB;IAwBpC;;;;;OAKG;IACH,OAAO,CAAC,gCAAgC;IAexC;;;OAGG;YACW,gBAAgB;IAiD9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+DvF;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAuB1C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,oBAAoB,CACxB,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,OAAO,CAAC,GACxD,OAAO,CAAC,kBAAkB,CAAC;IAoC9B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC;IA2FxB;;;;;;;;;;;;;;;;OAgBG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IAmC7C;;;;;;;;;OASG;YACW,eAAe;IAO7B;;;OAGG;YACW,YAAY;IAgD1B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;;OAGG;IACH,OAAO,CAAC,eAAe;IA+BvB;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAYlC"}

package/dist/types/priceHistory.dto.d.ts

@@ -157,4 +157,51 @@ export interface PricesResult {
     /** Whether there are pages before this one */
     hasPrevious: boolean;
 }
+/**
+ * DEX Backend API response format for price oracle /price-oracle/fetch-price endpoint
+ *
+ * @internal
+ * @since 3.16.0
+ */
+export interface DexPriceOracleResponse {
+    /** HTTP status code */
+    status: number;
+    /** Response message */
+    message: string;
+    /** Error flag */
+    error: boolean;
+    /** Response data containing price snapshots and pagination metadata */
+    data: {
+        /** Array of price snapshots */
+        data: Array<{
+            /** Unique identifier for the snapshot record */
+            id: number;
+            /** Token collection identifier */
+            collection: string;
+            /** Token category identifier */
+            category: string;
+            /** Token type identifier */
+            type: string;
+            /** Additional key for token identification */
+            additionalKey: string;
+            /** Token price as decimal string (USD) */
+            price: string;
+            /** Snapshot creation timestamp (ISO 8601) */
+            createdAt: string;
+            /** Snapshot update timestamp (ISO 8601) */
+            updatedAt: string;
+        }>;
+        /** Pagination metadata */
+        meta: {
+            /** Total number of items matching the filter */
+            totalItems: number;
+            /** Current page number (1-based) */
+            currentPage: number;
+            /** Number of items per page */
+            pageSize: number;
+            /** Total number of available pages */
+            totalPages: number;
+        };
+    };
+}
 //# sourceMappingURL=priceHistory.dto.d.ts.map

package/dist/types/priceHistory.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"priceHistory.dto.d.ts","sourceRoot":"","sources":["../../src/types/priceHistory.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,OAAO,EAAE,OAAO,UAAU,EAAE,OAAO,CAAC;IACpC,mFAAmF;IACnF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,yEAAyE;IACzE,EAAE,CAAC,EAAE,IAAI,CAAC;IACV,8DAA8D;IAC9D,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,SAAS,EAAE,IAAI,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"priceHistory.dto.d.ts","sourceRoot":"","sources":["../../src/types/priceHistory.dto.ts"],"names":[],"mappings":"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"}

package/dist/utils/tokenFormatConverter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Token Format Conversion Utilities
+ *
+ * Converts between pipe-delimited and dollar-delimited token ID formats.
+ * Used for translating between SDK format (pipe) and DEX Backend API format (dollar).
+ *
+ * @internal
+ */
+/**
+ * Convert pipe-delimited token ID to dollar-delimited format for API
+ *
+ * @param pipeToken Pipe-delimited format: "Token|Unit|GUSDC|eth:0x..."
+ * @returns Dollar-delimited format: "Token$Unit$GUSDC$eth:0x..."
+ * @throws Error if token is null or empty
+ *
+ * @example
+ * ```typescript
+ * pipeFormatToDollarFormat("Token|Unit|GUSDC|eth:0x123")
+ * // Returns: "Token$Unit$GUSDC$eth:0x123"
+ * ```
+ */
+export declare function pipeFormatToDollarFormat(pipeToken: string): string;
+/**
+ * Convert dollar-delimited API response to pipe-delimited format
+ *
+ * @param dollarToken Dollar-delimited format: "Token$Unit$GUSDC$eth:0x..."
+ * @returns Pipe-delimited format: "Token|Unit|GUSDC|eth:0x..."
+ * @throws Error if token is null or empty
+ *
+ * @example
+ * ```typescript
+ * dollarFormatToPipeFormat("Token$Unit$GUSDC$eth:0x123")
+ * // Returns: "Token|Unit|GUSDC|eth:0x123"
+ * ```
+ */
+export declare function dollarFormatToPipeFormat(dollarToken: string): string;
+/**
+ * Convert sort order from SDK format (uppercase) to API format (lowercase)
+ *
+ * @param sortOrder SDK sort order: 'ASC' | 'DESC'
+ * @returns API sort order: 'asc' | 'desc' | undefined
+ *
+ * @example
+ * ```typescript
+ * convertSortOrderToApi('ASC')
+ * // Returns: 'asc'
+ *
+ * convertSortOrderToApi(undefined)
+ * // Returns: undefined
+ * ```
+ */
+export declare function convertSortOrderToApi(sortOrder?: 'ASC' | 'DESC'): 'asc' | 'desc' | undefined;
+//# sourceMappingURL=tokenFormatConverter.d.ts.map

package/dist/utils/tokenFormatConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenFormatConverter.d.ts","sourceRoot":"","sources":["../../src/utils/tokenFormatConverter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAM5F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-sdk",
-  "version": "3.15.4",
+  "version": "3.16.1",
   "description": "TypeScript SDK for Gala Launchpad Backend API - Production-ready DeFi token launchpad integration with wallet-based authentication, GalaChain trading, and comprehensive user operations. 100% tested (22/22 endpoints working).",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",