@gala-chain/launchpad-sdk 3.6.0 → 3.6.2

package/dist/utils/validation-helpers.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Validation Helper Utilities
+ *
+ * Reusable validation functions for common patterns across services.
+ * Eliminates duplicate validation logic and provides consistent error messages.
+ *
+ * @category Utilities
+ * @since 3.6.2
+ */
+/**
+ * Pagination constraints structure
+ *
+ * This interface defines the expected structure for pagination constraint objects
+ * used across the SDK (e.g., USER_CONSTRAINTS, TRADE_CONSTRAINTS, COMMENT_CONSTRAINTS).
+ */
+export interface PaginationConstraints {
+    PAGINATION: {
+        MIN_PAGE: number;
+        MAX_PAGE: number;
+        MIN_LIMIT: number;
+        MAX_LIMIT: number;
+    };
+}
+/**
+ * Validates pagination parameters against constraint bounds
+ *
+ * This utility consolidates the duplicate pagination validation logic found across
+ * multiple services (UserService, TradeService, CommentService).
+ *
+ * ## Replaces Patterns
+ *
+ * This function replaces 3 instances of duplicate pagination validation:
+ *
+ * ### Before (Duplicate Private Methods):
+ * ```typescript
+ * // UserService.ts (lines 403-427)
+ * private validateUserPagination(options: { page: number; limit: number }): void {
+ *   if (typeof options.page !== 'number' ||
+ *       options.page < USER_CONSTRAINTS.PAGINATION.MIN_PAGE ||
+ *       options.page > USER_CONSTRAINTS.PAGINATION.MAX_PAGE) {
+ *     throw new ValidationError(...);
+ *   }
+ *   if (typeof options.limit !== 'number' ||
+ *       options.limit < USER_CONSTRAINTS.PAGINATION.MIN_LIMIT ||
+ *       options.limit > USER_CONSTRAINTS.PAGINATION.MAX_LIMIT) {
+ *     throw new ValidationError(...);
+ *   }
+ * }
+ *
+ * // TradeService.ts (lines 121-145) - IDENTICAL STRUCTURE
+ * private validateTradePagination(options: { page: number; limit: number }): void {
+ *   // Same pattern, different constraints
+ * }
+ *
+ * // CommentService.ts (inline validation with helper function)
+ * if (!isValidCommentPagination(page, limit)) {
+ *   throw new ValidationError(...);
+ * }
+ * ```
+ *
+ * ### After (Single Source of Truth):
+ * ```typescript
+ * // UserService.ts
+ * import { assertValidPagination } from '../utils/validation-helpers';
+ * assertValidPagination(page, limit, USER_CONSTRAINTS);
+ *
+ * // TradeService.ts
+ * import { assertValidPagination } from '../utils/validation-helpers';
+ * assertValidPagination(page, limit, TRADE_CONSTRAINTS);
+ *
+ * // CommentService.ts
+ * import { assertValidPagination } from '../utils/validation-helpers';
+ * assertValidPagination(page, limit, COMMENT_CONSTRAINTS);
+ * ```
+ *
+ * @param page - Page number to validate (1-based)
+ * @param limit - Results per page limit to validate
+ * @param constraints - Constraint object with PAGINATION bounds
+ * @throws ValidationError if page or limit is invalid
+ *
+ * @example Basic usage with USER_CONSTRAINTS
+ * ```typescript
+ * import { assertValidPagination } from '../utils/validation-helpers';
+ * import { USER_CONSTRAINTS } from '../types/user.dto';
+ *
+ * function fetchUsers(page: number, limit: number) {
+ *   assertValidPagination(page, limit, USER_CONSTRAINTS);
+ *   // Validation passed - proceed with fetch
+ * }
+ * ```
+ *
+ * @example With TRADE_CONSTRAINTS
+ * ```typescript
+ * import { assertValidPagination } from '../utils/validation-helpers';
+ * import { TRADE_CONSTRAINTS } from '../types/trade.dto';
+ *
+ * function fetchTrades(page: number, limit: number) {
+ *   assertValidPagination(page, limit, TRADE_CONSTRAINTS);
+ *   // Validation passed - proceed with fetch
+ * }
+ * ```
+ *
+ * @example Error handling
+ * ```typescript
+ * try {
+ *   assertValidPagination(0, 100, USER_CONSTRAINTS);
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.log(error.code); // 'INVALID_PAGE'
+ *     console.log(error.message); // 'Page must be a number between 1 and 1000'
+ *   }
+ * }
+ * ```
+ */
+export declare function assertValidPagination(page: number, limit: number, constraints: PaginationConstraints): void;
+//# sourceMappingURL=validation-helpers.d.ts.map

package/dist/utils/validation-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/validation-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,qBAAqB,GACjC,IAAI,CAoBN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-sdk",
-  "version": "3.6.0",
+  "version": "3.6.2",
   "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",