@gala-chain/launchpad-sdk 5.0.4-beta.62 → 5.0.4-beta.63

package/dist/services/ClientConfigService.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Client Config Service
+ *
+ * Handles client-side feature flag configuration for native mobile apps.
+ *
+ * Public endpoint - no authentication required.
+ *
+ * @category Services
+ * @since 5.1.0
+ */
+import type { GetClientFlagsResult } from '../types/client-config.dto';
+import type { HttpClient } from '../utils/http';
+import { BaseService } from './BaseService';
+/**
+ * Client Config Service Class
+ *
+ * Provides methods for accessing client-side feature flags.
+ * These flags control which features are enabled/disabled in the mobile app.
+ *
+ * **Public endpoint** - no authentication required.
+ *
+ * @example
+ * ```typescript
+ * const configService = new ClientConfigService(httpClient, true);
+ *
+ * const { flags } = await configService.getClientFlags();
+ * console.log('Push notifications:', flags.PUSH_NOTIFICATIONS);
+ * console.log('Dark mode:', flags.DARK_MODE);
+ * ```
+ */
+export declare class ClientConfigService extends BaseService {
+    constructor(http: HttpClient, debugMode?: boolean);
+    /**
+     * Extract data from API response wrapper
+     * @throws Error if response indicates failure or has no data
+     */
+    private extractData;
+    /**
+     * Get client feature flags.
+     *
+     * Returns feature flag overrides for the native mobile app.
+     * No authentication required.
+     *
+     * @returns Client feature flags
+     *
+     * @example
+     * ```typescript
+     * const { flags } = await configService.getClientFlags();
+     *
+     * if (flags.PUSH_NOTIFICATIONS) {
+     *   // Initialize push notification system
+     * }
+     *
+     * if (flags.DEX_TRADING) {
+     *   // Show DEX trading UI
+     * }
+     * ```
+     */
+    getClientFlags(): Promise<GetClientFlagsResult>;
+}
+//# sourceMappingURL=ClientConfigService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClientConfigService.d.ts","sourceRoot":"","sources":["../../src/services/ClientConfigService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAEV,oBAAoB,EAErB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;OAGG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAatD"}

package/dist/services/IntervalRegistry.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Interval Registry for SDK
+ *
+ * Centralized tracking for setInterval handles to ensure proper cleanup
+ * and prevent memory leaks during SDK disposal.
+ *
+ * Pattern:
+ * 1. registerInterval(setInterval(...)) - tracks the interval
+ * 2. unregisterInterval(handle) - removes from registry
+ * 3. unregisterAllIntervals() - nuclear cleanup on SDK shutdown
+ *
+ * @packageDocumentation
+ */
+/**
+ * Register an interval handle for centralized tracking.
+ *
+ * @param handle - The interval ID returned by setInterval
+ * @param label - Optional label for debugging (e.g., 'background-warming')
+ * @returns The same interval handle for chaining
+ *
+ * @example
+ * ```typescript
+ * const timer = registerInterval(setInterval(() => {
+ *   // periodic work
+ * }, 5000), 'background-warming');
+ * ```
+ */
+export declare function registerInterval(handle: number | NodeJS.Timeout, label?: string): number;
+/**
+ * Unregister an interval handle from centralized tracking.
+ *
+ * Should be called alongside clearInterval() for complete cleanup.
+ *
+ * @param handle - The interval ID to unregister
+ *
+ * @example
+ * ```typescript
+ * // In cleanup function:
+ * unregisterInterval(timer);
+ * clearInterval(timer);
+ * ```
+ */
+export declare function unregisterInterval(handle: number | NodeJS.Timeout): void;
+/**
+ * Unregister all tracked intervals.
+ *
+ * Nuclear option - use only during SDK shutdown or test cleanup.
+ * Returns count of intervals cleared for monitoring.
+ *
+ * @returns Number of intervals that were registered
+ *
+ * @example
+ * ```typescript
+ * // In SDK cleanup:
+ * const cleared = unregisterAllIntervals();
+ * console.log(`Cleared ${cleared} leaked intervals`);
+ * ```
+ */
+export declare function unregisterAllIntervals(): number;
+/**
+ * Get registry statistics for debugging.
+ *
+ * @returns Current registry size and entries
+ */
+export declare function getIntervalRegistryStats(): {
+    size: number;
+    entries: Array<{
+        id: number;
+        createdAt: number;
+        label?: string | undefined;
+    }>;
+};
+/**
+ * Clear the registry for test isolation.
+ *
+ * @internal - Test use only
+ */
+export declare function __resetIntervalRegistryForTests(): void;
+//# sourceMappingURL=IntervalRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IntervalRegistry.d.ts","sourceRoot":"","sources":["../../src/services/IntervalRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,EAC/B,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAOR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAGxE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC/E,CASA;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}

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

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

package/dist/services/NotificationService.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Notification Service
+ *
+ * Handles push notification device registration and preference management.
+ *
+ * All operations require MultiAuth (JWT session or per-user API key).
+ *
+ * @category Services
+ * @since 5.1.0
+ */
+import type { JwtAuth } from '../auth/JwtAuth';
+import type { GetNotificationPreferencesResult, RegisterPushTokenParams, RegisterPushTokenResult, UnregisterPushTokenResult, UpdateNotificationPreferencesParams, UpdateNotificationPreferencesResult } from '../types/notification.dto';
+import type { HttpClient } from '../utils/http';
+import { BaseService } from './BaseService';
+/**
+ * Notification Service Class
+ *
+ * Provides methods for:
+ * - Registering/unregistering push notification device tokens
+ * - Getting/updating notification preferences
+ *
+ * @example
+ * ```typescript
+ * const notificationService = new NotificationService(httpClient, true, jwtAuth);
+ *
+ * // Register a device
+ * await notificationService.registerPushToken({
+ *   token: 'fcm-token-here',
+ *   platform: 'android',
+ * });
+ *
+ * // Get preferences
+ * const { preferences } = await notificationService.getPreferences();
+ * console.log('Trades enabled:', preferences.tradesEnabled);
+ * ```
+ */
+export declare class NotificationService extends BaseService {
+    constructor(http: HttpClient, debugMode?: boolean, jwtAuth?: JwtAuth);
+    /**
+     * Extract data from API response wrapper
+     * @throws Error if response indicates failure or has no data
+     */
+    private extractData;
+    /**
+     * Register a push notification device token.
+     *
+     * Associates a push token (FCM or APNs) with the authenticated user.
+     * If the token already exists, it updates the associated device info.
+     *
+     * @param params - Registration parameters
+     * @returns Registration result
+     *
+     * @example
+     * ```typescript
+     * const result = await notificationService.registerPushToken({
+     *   token: 'fcm-device-token-abc123',
+     *   platform: 'android',
+     *   deviceId: 'pixel-7-main',
+     * });
+     * console.log('Registered:', result.registered);
+     * ```
+     */
+    registerPushToken(params: RegisterPushTokenParams): Promise<RegisterPushTokenResult>;
+    /**
+     * Unregister a push notification device token.
+     *
+     * Deactivates a push token so the device no longer receives notifications.
+     *
+     * @param token - The push token to unregister
+     * @returns Unregistration result
+     *
+     * @example
+     * ```typescript
+     * const result = await notificationService.unregisterPushToken('fcm-device-token-abc123');
+     * console.log('Unregistered:', result.unregistered);
+     * ```
+     */
+    unregisterPushToken(token: string): Promise<UnregisterPushTokenResult>;
+    /**
+     * Get notification preferences for the authenticated user.
+     *
+     * @returns Current notification preferences
+     *
+     * @example
+     * ```typescript
+     * const { preferences } = await notificationService.getPreferences();
+     * console.log('Trades:', preferences.tradesEnabled);
+     * console.log('Streams:', preferences.streamsEnabled);
+     * console.log('Chat:', preferences.chatEnabled);
+     * console.log('System:', preferences.systemEnabled);
+     * ```
+     */
+    getPreferences(): Promise<GetNotificationPreferencesResult>;
+    /**
+     * Update notification preferences for the authenticated user.
+     *
+     * Partial update - only provided fields are modified.
+     *
+     * @param params - Preference fields to update
+     * @returns Updated notification preferences
+     *
+     * @example
+     * ```typescript
+     * // Disable chat notifications only
+     * const { preferences } = await notificationService.updatePreferences({
+     *   chatEnabled: false,
+     * });
+     * console.log('Chat now:', preferences.chatEnabled); // false
+     * ```
+     */
+    updatePreferences(params: UpdateNotificationPreferencesParams): Promise<UpdateNotificationPreferencesResult>;
+}
+//# sourceMappingURL=NotificationService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationService.d.ts","sourceRoot":"","sources":["../../src/services/NotificationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EACV,gCAAgC,EAGhC,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,mCAAmC,EACnC,mCAAmC,EACpC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,OAAO;IAI3E;;;OAGG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;;;;;;;;;;;;;;;OAkBG;IACG,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmB1F;;;;;;;;;;;;;OAaG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAkB5E;;;;;;;;;;;;;OAaG;IACG,cAAc,IAAI,OAAO,CAAC,gCAAgC,CAAC;IAkBjE;;;;;;;;;;;;;;;;OAgBG;IACG,iBAAiB,CACrB,MAAM,EAAE,mCAAmC,GAC1C,OAAO,CAAC,mCAAmC,CAAC;CAiBhD"}

package/dist/src/LaunchpadSDK.d.ts

@@ -9,6 +9,7 @@ import type { ActiveUsersResult, BanListResult, BanStatusResult, CreateBanOption
 import type { BurnTokensData, BurnTokensResult } from './types/burn.dto';
 import type { FlushResult } from './types/cache-management.dto';
 import type { CreateChatMessageOptions, CreateChatMessageResult, GetChatMessagesOptions, GetChatMessagesResult, UpdateChatMessageOptions, UpdateChatMessageResult } from './types/chat-messages.dto';
+import type { GetClientFlagsResult } from './types/client-config.dto';
 import type { CommentsResult, CreateCommentOptions, CreateCommentResult, DeleteCommentResult, GetCommentsOptions, UpdateCommentOptions, UpdateCommentResult } from './types/comments.dto';
 import type { AddressFormat, ApiResponse, SDKConfig, TokenClassKey, TokenId } from './types/common';
 import type { ActionFlagOptions, ActionFlagResult, CreateFlagOptions, CreateFlagResult, DismissFlagOptions, DismissFlagResult, FlagListResult, ListFlagsOptions, ListGlobalFlagsOptions } from './types/content-flag.dto';
@@ -19,6 +20,7 @@ import type { LockTokensData, LockTokensResult, UnlockTokensData, UnlockTokensRe
 import type { CreateMessageOptions, CreateMessageResult, DeleteMessageResult, FetchMessagesOptions, FetchMessagesResult, GetPinnedMessageResult, MessageStats, PinMessageResult, UpdateMessageOptions, UpdateMessageResult, UpdateTokenConfigOptions } from './types/messages.dto';
 import type { ClaimModeratorInviteOptions, ClaimModeratorInviteResult, CreateModeratorInviteOptions, CreateModeratorInviteResult, GetModeratedTokensOptions, ListModeratorInvitesOptions, ModeratedTokensResult, ModeratorInviteListResult, PublicInviteInfo, UpdateInviteRoleOptions, UpdateInviteRoleResult, UpdateModeratorInviteOptions, UpdateModeratorInviteResult } from './types/moderator.dto';
 import type { ClaimCollectionParams, ClaimCollectionResult, CreateTokenClassParams, CreateTokenClassResult, EstimateMintFeeParams, EstimateNftFeesParams, FetchTokenClassesParams, MintNftParams, MintNftResult, NftBalance, NftCollectionAuthorization, NftFeeEstimate, NftTokenClassWithSupply } from './types/nft.dto';
+import type { GetNotificationPreferencesResult, RegisterPushTokenParams, RegisterPushTokenResult, UnregisterPushTokenResult, UpdateNotificationPreferencesParams, UpdateNotificationPreferencesResult } from './types/notification.dto';
 import type { GetHomeOEmbedJsonResult, GetHomeOEmbedOptions, GetPoolOEmbedJsonResult, GetPoolOEmbedOptions, GetProfileOEmbedJsonResult, GetProfileOEmbedOptions } from './types/oembed.dto';
 import type { BanStatsResponse, CreateOverseerDirectOptions, CreateOverseerInviteOptions, FlagStatsResponse, InviteStatsResponse, ListOverseerInvitesOptions, ListOverseersOptions, ListUsersOptions, Overseer, OverseerInviteWithUrl, OverseerStatusResponse, OverseerSummaryResponse, PaginatedOverseerInvites, PaginatedOverseers, PublicOverseerInviteInfo, TokenBanStatsResponse, UsersListResponse, UserStatsResponse, UserSummaryResponse } from './types/overseer.dto';
 import type { PlatformConfig, UpdatePlatformConfigOptions } from './types/platform-config.dto';
@@ -394,6 +396,8 @@ export declare class LaunchpadSDK {
     private _weeklyChallengeService;
     private _oembedService;
     private _platformStatsService;
+    private _notificationService;
+    private _clientConfigService;
     private readonly nftCollectionService;
     private readonly tradingQuotesService;
     private readonly launchpadAPI;
@@ -2045,6 +2049,24 @@ export declare class LaunchpadSDK {
      * @since 9.0.0
      */
     private getPlatformStatsService;
+    /**
+     * Get or create the NotificationService instance.
+     *
+     * Lazily initializes the NotificationService on first use.
+     * The service handles push notification device registration and preference management.
+     *
+     * @returns Configured NotificationService instance
+     */
+    private getNotificationService;
+    /**
+     * Get or create the ClientConfigService instance.
+     *
+     * Lazily initializes the ClientConfigService on first use.
+     * The service handles client-side feature flag queries.
+     *
+     * @returns Configured ClientConfigService instance
+     */
+    private getClientConfigService;
     /**
      * Get or create the ApiKeyService instance.
      *
@@ -5605,6 +5627,101 @@ export declare class LaunchpadSDK {
      * ```
      */
     getPlatformStats(): Promise<GetPlatformStatsResult>;
+    /**
+     * Register a push notification device token.
+     *
+     * Associates a push token (FCM or APNs) with the authenticated user.
+     * If the token already exists, it updates the associated device info.
+     *
+     * Authentication: Requires JWT auth (call sdk.login() first).
+     *
+     * @param params - Registration parameters (token, platform, optional deviceId)
+     * @returns Registration result
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.registerPushToken({
+     *   token: 'fcm-device-token-abc123',
+     *   platform: 'android',
+     *   deviceId: 'pixel-7-main',
+     * });
+     * console.log('Registered:', result.registered);
+     * ```
+     */
+    registerPushToken(params: RegisterPushTokenParams): Promise<RegisterPushTokenResult>;
+    /**
+     * Unregister a push notification device token.
+     *
+     * Deactivates a push token so the device no longer receives notifications.
+     *
+     * Authentication: Requires JWT auth (call sdk.login() first).
+     *
+     * @param token - The push token to unregister
+     * @returns Unregistration result
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.unregisterPushToken('fcm-device-token-abc123');
+     * console.log('Unregistered:', result.unregistered);
+     * ```
+     */
+    unregisterPushToken(token: string): Promise<UnregisterPushTokenResult>;
+    /**
+     * Get notification preferences for the authenticated user.
+     *
+     * Returns the current push notification preference settings.
+     *
+     * Authentication: Requires JWT auth (call sdk.login() first).
+     *
+     * @returns Current notification preferences
+     *
+     * @example
+     * ```typescript
+     * const { preferences } = await sdk.fetchNotificationPreferences();
+     * console.log('Trades:', preferences.tradesEnabled);
+     * console.log('Streams:', preferences.streamsEnabled);
+     * console.log('Chat:', preferences.chatEnabled);
+     * console.log('System:', preferences.systemEnabled);
+     * ```
+     */
+    fetchNotificationPreferences(): Promise<GetNotificationPreferencesResult>;
+    /**
+     * Update notification preferences for the authenticated user.
+     *
+     * Partial update - only provided fields are modified, others remain unchanged.
+     *
+     * Authentication: Requires JWT auth (call sdk.login() first).
+     *
+     * @param params - Preference fields to update
+     * @returns Updated notification preferences
+     *
+     * @example
+     * ```typescript
+     * // Disable chat notifications only
+     * const { preferences } = await sdk.updateNotificationPreferences({
+     *   chatEnabled: false,
+     * });
+     * console.log('Chat now:', preferences.chatEnabled); // false
+     * ```
+     */
+    updateNotificationPreferences(params: UpdateNotificationPreferencesParams): Promise<UpdateNotificationPreferencesResult>;
+    /**
+     * Get client feature flags.
+     *
+     * Returns feature flag overrides for the native mobile app.
+     * No authentication required (public endpoint).
+     *
+     * @returns Client feature flags
+     *
+     * @example
+     * ```typescript
+     * const { flags } = await sdk.fetchClientFlags();
+     * console.log('Push notifications:', flags.PUSH_NOTIFICATIONS);
+     * console.log('Dark mode:', flags.DARK_MODE);
+     * console.log('DEX trading:', flags.DEX_TRADING);
+     * ```
+     */
+    fetchClientFlags(): Promise<GetClientFlagsResult>;
     /**
      * Add a reaction to a pool message (chat or comment).
      *