@gala-chain/launchpad-sdk 5.0.4-beta.6 → 5.0.4-beta.60

package/dist/services/shared/service-validators.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Service Validators
+ *
+ * Re-exports validation utilities from utils/service-validators.ts.
+ * Provides shared validation utilities used across multiple services to eliminate
+ * duplicated validation logic. These validators provide consistent error
+ * messages and validation behavior.
+ *
+ * This module serves as a compatibility layer for services that import from
+ * services/shared/service-validators.ts. All implementations are in utils/service-validators.ts.
+ *
+ * @category Services
+ * @since 5.13.0
+ */
+import type { TokenNameConstraint } from '../../types/common';
+export { validateArrayLength, validateNonEmptyArray, validateOptionalDate as validateOptionalDateUtil, validateOptionalNumber as validateOptionalNumberUtil, validateOptionalObject, validateOptionalString as validateOptionalStringUtil, validatePositiveInteger as validatePositiveIntegerUtil, validateRequiredDate, validateRequiredObject, validateRequiredString as validateRequiredStringUtil, validateStatusFilter as validateStatusFilterUtil, validateStringLength, validateTokenNameWithConstraints as validateTokenNameWithConstraintsUtil, } from '../../utils/service-validators';
+/**
+ * Validates that a value is a positive integer (for IDs)
+ *
+ * Wrapper for the utility function to provide the displayName parameter.
+ * This consolidates the duplicate `validatePositiveInteger` method
+ * found in both BaseService and StreamTokenServiceBase.
+ *
+ * @param value - Value to validate
+ * @param fieldName - Technical field name for error details
+ * @param displayName - Human-readable name for error message
+ * @throws {ValidationError} If value is not a positive integer
+ *
+ * @example
+ * ```typescript
+ * validatePositiveInteger(id, 'id', 'API key ID');
+ * validatePositiveInteger(inviteId, 'inviteId', 'Invite ID');
+ * validatePositiveInteger(commentId, 'commentId', 'Comment ID');
+ * ```
+ */
+export declare function validatePositiveInteger(value: number, fieldName: string, displayName: string): void;
+/**
+ * Validates token name format against provided constraints
+ *
+ * This function consolidates the duplicate token name validation found
+ * across StreamTokenServiceBase and other services.
+ *
+ * @param tokenName - Token name to validate
+ * @param constraints - Token name validation constraints (pattern, min/max length)
+ * @throws {ValidationError} If token name is invalid
+ *
+ * @example
+ * ```typescript
+ * validateTokenNameWithConstraints(tokenName, STREAMING_CONSTRAINTS.TOKEN_NAME);
+ * validateTokenNameWithConstraints(tokenName, CHAT_CONSTRAINTS.TOKEN_NAME);
+ * ```
+ */
+export declare function validateTokenNameWithConstraints(tokenName: string, constraints: TokenNameConstraint): void;
+/**
+ * Validates a required string parameter
+ *
+ * @param value - Value to validate
+ * @param fieldName - Technical field name for error details
+ * @param displayName - Human-readable name for error message
+ * @throws {ValidationError} If value is missing or not a string
+ *
+ * @example
+ * ```typescript
+ * validateRequiredString(assetId, 'assetId', 'Asset ID');
+ * validateRequiredString(content, 'content', 'Message content');
+ * ```
+ */
+export declare function validateRequiredString(value: string | undefined, fieldName: string, displayName: string): void;
+/**
+ * Validates an optional string parameter with max length constraint
+ *
+ * @param value - Value to validate (undefined/null allowed)
+ * @param fieldName - Technical field name for error details
+ * @param displayName - Human-readable name for error message
+ * @param maxLength - Maximum allowed string length
+ * @throws {ValidationError} If value is not a string or exceeds maxLength
+ *
+ * @example
+ * ```typescript
+ * validateOptionalString(description, 'description', 'Description', 255);
+ * validateOptionalString(reason, 'reason', 'Reason', 500);
+ * ```
+ */
+export declare function validateOptionalString(value: string | undefined | null, fieldName: string, displayName: string, maxLength: number): void;
+/**
+ * Validates an optional number parameter with min/max constraints
+ *
+ * @param value - Value to validate (undefined/null allowed)
+ * @param fieldName - Technical field name for error details
+ * @param displayName - Human-readable name for error message
+ * @param min - Minimum allowed value
+ * @param max - Maximum allowed value
+ * @param minMessage - Custom message suffix for minimum violation
+ * @param maxMessage - Custom message suffix for maximum violation
+ * @throws {ValidationError} If value is not a number or out of range
+ *
+ * @example
+ * ```typescript
+ * validateOptionalNumber(durationSeconds, 'durationSeconds', 'Duration', 60, 31536000, '1 minute', '1 year');
+ * ```
+ */
+export declare function validateOptionalNumber(value: number | undefined | null, fieldName: string, displayName: string, min: number, max: number, _minMessage?: string, _maxMessage?: string): void;
+/**
+ * Validates an optional ISO 8601 date string
+ *
+ * @param value - Value to validate (undefined/null allowed)
+ * @param fieldName - Technical field name for error details
+ * @param displayName - Human-readable name for error message
+ * @throws {ValidationError} If value is not a valid ISO 8601 date
+ *
+ * @example
+ * ```typescript
+ * validateOptionalDate(expiresAt, 'expiresAt', 'Expiration date');
+ * ```
+ */
+export declare function validateOptionalDate(value: string | undefined | null, fieldName: string, displayName: string): void;
+/**
+ * Validates a status filter against an enum object
+ *
+ * Generic validator for status filters used in list operations.
+ * Works with any enum-like const object.
+ *
+ * Uses enumValidationWithObjectValues for consistent enum validation.
+ *
+ * @param status - Status value to validate (undefined allowed)
+ * @param validStatusEnum - Enum-like const object to validate against
+ * @param fieldName - Field name for error message (default: 'status')
+ * @throws {ValidationError} If status is not a valid enum value
+ *
+ * @example
+ * ```typescript
+ * validateStatusFilter(options.status, OVERSEER_INVITE_STATUS);
+ * validateStatusFilter(options.status, OVERSEER_STATUS);
+ * ```
+ */
+export declare function validateStatusFilter<T extends Record<string, string>>(status: string | undefined, validStatusEnum: T, fieldName?: string): void;
+//# sourceMappingURL=service-validators.d.ts.map

package/dist/services/shared/service-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-validators.d.ts","sourceRoot":"","sources":["../../../src/services/shared/service-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAc9D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,IAAI,wBAAwB,EAChD,sBAAsB,IAAI,0BAA0B,EACpD,sBAAsB,EACtB,sBAAsB,IAAI,0BAA0B,EACpD,uBAAuB,IAAI,2BAA2B,EACtD,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,IAAI,0BAA0B,EACpD,oBAAoB,IAAI,wBAAwB,EAChD,oBAAoB,EACpB,gCAAgC,IAAI,oCAAoC,GACzE,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAOnG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAa1G;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAI9G;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CASN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CASN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI,CAUN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnE,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,EAAE,CAAC,EAClB,SAAS,GAAE,MAAiB,GAC3B,IAAI,CAIN"}

package/dist/services/shared/websocket-helpers.d.ts

@@ -0,0 +1,158 @@
+/**
+ * WebSocket Helpers
+ *
+ * Shared utilities for WebSocket event buffering and lifecycle management.
+ * Eliminates duplicate patterns across WebSocketService and StreamWebSocketService.
+ *
+ * @category Services
+ * @since 6.5.0
+ */
+import type { Logger } from '../../utils/Logger';
+/**
+ * Configuration for EventBuffer
+ */
+export interface EventBufferConfig {
+    /** Maximum number of events to buffer (default: 100) */
+    maxSize?: number;
+    /** Time-to-live for buffered events in ms (default: 30000) */
+    ttlMs?: number;
+    /** Logger instance for debug output */
+    logger?: Logger;
+    /** Prefix for log messages (e.g., 'Stream' or 'Transaction') */
+    logPrefix?: string;
+}
+/**
+ * Generic event buffer for WebSocket race condition prevention
+ *
+ * Buffers events that arrive before listeners are registered,
+ * preventing loss of events during the subscription window.
+ *
+ * @typeParam T - Event data type
+ *
+ * @example
+ * ```typescript
+ * const buffer = new EventBuffer<TransactionStatus>({
+ *   maxSize: 1000,
+ *   ttlMs: 30000,
+ *   logger,
+ *   logPrefix: 'Transaction'
+ * });
+ *
+ * // Buffer an event when received
+ * buffer.set('tx-123', eventData);
+ *
+ * // Later, when listener is registered, retrieve buffered event
+ * const buffered = buffer.consume('tx-123');
+ * if (buffered) {
+ *   callback(buffered);
+ * }
+ * ```
+ *
+ * @since 6.5.0
+ */
+export declare class EventBuffer<T = unknown> {
+    private readonly buffer;
+    private readonly maxSize;
+    private readonly ttlMs;
+    private readonly logger;
+    private readonly logPrefix;
+    constructor(config?: EventBufferConfig);
+    /**
+     * Buffer an event for later retrieval
+     *
+     * If buffer is full, drops the oldest event (FIFO).
+     *
+     * @param key - Event identifier (e.g., transactionId, tokenName)
+     * @param data - Event data to buffer
+     */
+    set(key: string, data: T): void;
+    /**
+     * Retrieve and remove a buffered event
+     *
+     * @param key - Event identifier
+     * @returns Buffered data or undefined if not found
+     */
+    consume(key: string): T | undefined;
+    /**
+     * Get a buffered event without removing it
+     *
+     * @param key - Event identifier
+     * @returns Buffered data or undefined if not found
+     */
+    get(key: string): T | undefined;
+    /**
+     * Check if an event is buffered
+     *
+     * @param key - Event identifier
+     * @returns True if event is buffered
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a buffered event
+     *
+     * @param key - Event identifier
+     */
+    delete(key: string): void;
+    /**
+     * Delete all buffered events matching a predicate
+     *
+     * @param predicate - Function to test each key
+     */
+    deleteWhere(predicate: (key: string) => boolean): void;
+    /**
+     * Clear all buffered events
+     */
+    clear(): void;
+    /**
+     * Get current buffer size
+     */
+    get size(): number;
+}
+/**
+ * Timeout manager for WebSocket operations
+ *
+ * Centralizes timeout handling for transaction monitoring, subscriptions, etc.
+ *
+ * @since 6.5.0
+ */
+export declare class TimeoutManager {
+    private readonly timeouts;
+    private readonly logger;
+    private readonly logPrefix;
+    constructor(logger?: Logger, logPrefix?: string);
+    /**
+     * Set a timeout for a key
+     *
+     * @param key - Identifier for this timeout
+     * @param callback - Function to call when timeout fires
+     * @param ms - Timeout duration in milliseconds
+     */
+    set(key: string, callback: () => void, ms: number): void;
+    /**
+     * Clear a specific timeout
+     *
+     * @param key - Identifier of timeout to clear
+     */
+    clear(key: string): void;
+    /**
+     * Clear all timeouts
+     */
+    clearAll(): void;
+    /**
+     * Check if a timeout exists
+     *
+     * @param key - Identifier to check
+     */
+    has(key: string): boolean;
+    /**
+     * Get count of active timeouts
+     */
+    get size(): number;
+}
+/**
+ * Check if Socket.IO client is available in the current environment
+ *
+ * @returns True if Socket.IO io function is available
+ */
+export declare function checkSocketIOAvailability(): boolean;
+//# sourceMappingURL=websocket-helpers.d.ts.map

package/dist/services/shared/websocket-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-helpers.d.ts","sourceRoot":"","sources":["../../../src/services/shared/websocket-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAcjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,iBAAsB;IAO1C;;;;;;;OAOG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAmC/B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAcnC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI/B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQzB;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB;IAK1D;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAaxD;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CASnD"}

package/dist/setup.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Vitest setup file for test environment configuration
+ *
+ * This file is placed in src/ to satisfy TypeScript's rootDir configuration
+ * while remaining in the test environment setup pipeline via vitest.config.ts
+ */
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}