@gala-chain/launchpad-sdk 3.5.3 → 3.6.1

package/CHANGELOG.md

@@ -4,6 +4,76 @@ All notable changes to the Gala Launchpad SDK will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.6.0] - 2025-10-02
+
+### Changed
+- **Major architectural refactoring** - LaunchpadService decomposed into specialized services
+  - Extracted PoolService (~400 lines) - Pool queries, distribution, badges, volume data
+  - Extracted TradeService (~150 lines) - Trade history and queries
+  - Extracted CommentService (~200 lines) - Comments with vault resolution
+  - Extracted UserService (~400 lines) - Profile management and token lists
+  - Extracted ImageService (~150 lines) - Image upload operations
+  - Extracted FaucetService (~100 lines) - Faucet transfer operations
+  - Rewrote LaunchpadService as facade pattern (1,657 → 384 lines, 76.8% reduction)
+  - All public methods maintained for 100% backward compatibility
+
+### Added
+- **Centralized constants** - `constants/endpoints.ts` eliminates magic strings
+  - 14 API endpoint URLs now defined in single location
+  - Type-safe via `as const` assertion
+  - Easier to maintain and update
+- **Unified query builder** - `utils/query-params.ts` consolidates 4 duplicate methods
+  - `buildBackendQueryParams()` - Generic query parameter builder
+  - `buildPaginationParams()` - Common pagination pattern
+  - `buildTokenQueryParams()` - Token-specific queries
+  - Configurable field transformations (stringification, mappings, optional fields)
+  - Reduced from 81 lines (4 methods) to 30 lines (1 generic utility)
+- **Response normalizers** - `utils/response-normalizers.ts` for consistent data handling
+  - `normalizePoolResponse()` - Handles multiple backend pool formats
+  - `normalizeTradeResponse()` - Standardizes trade data
+  - `normalizeTokenListResponse()` - Unifies token list formats
+  - `normalizeCommentResponse()` - Comment data transformation
+  - `extractPaginationMetadata()` - Pagination info extraction
+  - `createPaginationFlags()` - hasNext/hasPrevious flag generation
+
+### Removed
+- **Eliminated code duplication** - 163 lines of inline validation removed
+  - All validation now uses centralized utilities
+  - No functionality lost, just consolidated
+- **Deprecated query builders** - 4 nearly-identical methods replaced
+  - `buildGetCommentsQueryParams` → `buildBackendQueryParams`
+  - `buildTradeQueryParams` → `buildBackendQueryParams`
+  - `buildTokenListQueryParams` → `buildBackendQueryParams`
+  - `buildTokenHoldQueryParams` → `buildBackendQueryParams`
+
+### Fixed
+- **TypeScript strict mode compliance** - Fixed exactOptionalPropertyTypes issues
+  - Conditional property assignment pattern for optional fields
+  - Type-safe field mapping in query builder
+  - All compilation errors resolved
+
+### Benefits
+- ✅ **76.8% reduction** in main service file (1,657 → 384 lines)
+- ✅ **100% backward compatible** - All public methods unchanged
+- ✅ **Single Responsibility Principle** - Each service has one clear purpose
+- ✅ **Improved maintainability** - Easier to locate and modify functionality
+- ✅ **Reduced duplication** - 244 lines eliminated (163 validation + 81 query builders)
+- ✅ **Better testability** - Services can be tested in isolation
+- ✅ **Modern patterns** - Template literals, optional chaining, nullish coalescing
+- ✅ **All tests passing** - 53/53 tests verified
+
+### Architecture
+New service structure (facade pattern):
+```
+LaunchpadService (facade)
+├── PoolService - Pool operations
+├── TradeService - Trade history
+├── CommentService - Social features
+├── UserService - Profile & token lists
+├── ImageService - Image uploads
+└── FaucetService - Faucet transfers
+```
+
 ## [3.5.2] - 2025-10-02
 
 ### Changed

package/README.md

@@ -687,7 +687,29 @@ import {
 
 ### Service Responsibilities
 
-**LaunchpadService** - Launchpad Backend Operations
+**LaunchpadService** - Launchpad Backend Operations (Facade)
+
+LaunchpadService uses a **facade pattern** internally, delegating to specialized sub-services:
+
+```typescript
+// Internal architecture (v3.6.0+)
+LaunchpadService (facade)
+├── PoolService - Pool queries, distribution, badges, volume data
+├── TradeService - Trade history and queries
+├── CommentService - Comments with vault resolution
+├── UserService - Profile management and token lists
+├── ImageService - Image upload operations
+└── FaucetService - Faucet transfer operations
+```
+
+**Facade Benefits:**
+- ✅ Single responsibility: Each sub-service has one clear purpose
+- ✅ Maintainability: 76.8% reduction in main service file (1,657 → 384 lines)
+- ✅ Code reuse: Shared utilities for query building and response normalization
+- ✅ Backward compatibility: All public methods unchanged
+- ✅ Testability: Sub-services can be tested independently
+
+**Public API (unchanged):**
 - Pool management (fetch, create, check)
 - Trade history
 - Comments (post, fetch)

package/dist/constants/endpoints.d.ts

@@ -0,0 +1,38 @@
+/**
+ * API Endpoint Constants
+ *
+ * Centralized definition of all launchpad-backend API endpoints.
+ * This prevents magic strings scattered throughout the codebase and
+ * makes it easier to update endpoints when the backend API changes.
+ *
+ * @category Constants
+ * @since 3.6.0
+ */
+/**
+ * Launchpad Backend API Endpoints
+ */
+export declare const ENDPOINTS: {
+    readonly UPLOAD_IMAGE: "/launchpad/upload-image";
+    readonly FETCH_POOLS: "/launchpad/fetch-pool";
+    readonly CHECK_POOL: "/launchpad/check-pool";
+    readonly GET_GRAPH_DATA: "/launchpad/get-graph-data";
+    readonly GET_TOKEN_DISTRIBUTION: "/holders";
+    readonly GET_TOKEN_BADGES: "/launchpad/get-badge/";
+    readonly GET_TRADES: "/trade/";
+    readonly GET_COMMENTS: "/token/commment";
+    readonly POST_COMMENT: "/token/commment";
+    readonly GET_PROFILE: "/user/profile";
+    readonly UPDATE_PROFILE: "/user/profile";
+    readonly GET_TOKEN_LIST: "/user/token-list";
+    readonly GET_TOKENS_HELD: "/user/token-hold";
+    readonly TRANSFER_FAUCETS: "/user/transfer-faucets";
+};
+/**
+ * Type-safe endpoint keys
+ */
+export type EndpointKey = keyof typeof ENDPOINTS;
+/**
+ * Type-safe endpoint values
+ */
+export type EndpointValue = typeof ENDPOINTS[EndpointKey];
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/constants/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/constants/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;CA8BZ,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC"}