@gala-chain/launchpad-sdk 5.0.2-beta.1 → 5.0.4-beta.0

package/dist/src/types/constraints.d.ts

@@ -0,0 +1,374 @@
+/**
+ * Centralized Validation Constraints
+ *
+ * @category Types
+ * @since 6.9.0
+ */
+import { ADDRESS_PATTERNS } from '../utils/validation-helpers';
+/**
+ * Token name constraint configuration interface
+ *
+ * @since 5.1.1
+ */
+export interface TokenNameConstraint {
+    /** Minimum token name length */
+    MIN_LENGTH: number;
+    /** Maximum token name length */
+    MAX_LENGTH: number;
+    /** Regex pattern for validation */
+    PATTERN: RegExp;
+}
+/**
+ * Standard launchpad token name constraints (3-20 alphanumeric)
+ *
+ * Used by: streaming, ban, chat, comments, moderator, content-flag, content-reactions
+ */
+export declare const LAUNCHPAD_TOKEN_NAME_CONSTRAINT: TokenNameConstraint;
+/**
+ * Relaxed token name constraints (2-20 alphanumeric)
+ *
+ * Used by: comment.dto, comments.dto, content-reactions.dto, content-flag.dto
+ * Note: Slightly more permissive than LAUNCHPAD_TOKEN_NAME_CONSTRAINT
+ */
+export declare const RELAXED_TOKEN_NAME_CONSTRAINT: TokenNameConstraint;
+/**
+ * Extended token name constraints (1-50 alphanumeric)
+ *
+ * Used by: user.dto, trade.dto for more flexible token queries
+ */
+export declare const EXTENDED_TOKEN_NAME_CONSTRAINT: {
+    readonly MIN_LENGTH: 1;
+    readonly MAX_LENGTH: 50;
+};
+/**
+ * Token name pattern (alphanumeric only)
+ *
+ * Used by: transfer.dto, lock.dto, burn.dto
+ */
+export declare const TOKEN_NAME_PATTERN: RegExp;
+/**
+ * Standard pagination constraint interface (for assertValidPagination compatibility)
+ *
+ * Used by services that call assertValidPagination with bounds validation.
+ */
+export interface PaginationBoundsConstraint {
+    /** Minimum page number */
+    MIN_PAGE: number;
+    /** Maximum page number */
+    MAX_PAGE: number;
+    /** Minimum items per page */
+    MIN_LIMIT: number;
+    /** Maximum items per page */
+    MAX_LIMIT: number;
+}
+/**
+ * Query pagination constraint interface (for API endpoints)
+ *
+ * Used by endpoints that have default values and max limits.
+ */
+export interface QueryPaginationConstraint {
+    /** Maximum items per page */
+    MAX_LIMIT: number;
+    /** Default page number */
+    DEFAULT_PAGE?: number;
+    /** Default items per page */
+    DEFAULT_LIMIT?: number;
+}
+/**
+ * Global pagination bounds (shared by all endpoints)
+ *
+ * Individual endpoints may have tighter limits via their specific constraints.
+ */
+export declare const GLOBAL_PAGINATION_BOUNDS: {
+    /** Minimum items per page */
+    readonly MIN_LIMIT: 1;
+    /** Maximum items per page (global cap) */
+    readonly MAX_LIMIT: 100;
+    /** Minimum page number */
+    readonly MIN_PAGE: 1;
+    /** Maximum page number */
+    readonly MAX_PAGE: 1000;
+};
+/**
+ * Standard pagination constraints (max 100 items)
+ *
+ * Used by: launchpad.dto, ban.dto (max_limit)
+ * Compatible with assertValidPagination() bounds checking.
+ */
+export declare const STANDARD_PAGINATION_CONSTRAINT: PaginationBoundsConstraint & QueryPaginationConstraint;
+/**
+ * User/Trade pagination constraints (max 20 items)
+ *
+ * Used by: user.dto, trade.dto
+ * Compatible with assertValidPagination() bounds checking.
+ */
+export declare const USER_PAGINATION_CONSTRAINT: PaginationBoundsConstraint;
+/**
+ * API query pagination constraints (max 50 items)
+ *
+ * Used by: trades-query.dto, comments.dto, moderator.dto, overseer, chat-messages.dto
+ * Note: For API endpoints that don't use assertValidPagination bounds checking.
+ */
+export declare const QUERY_PAGINATION_CONSTRAINT: QueryPaginationConstraint;
+/**
+ * Chat/Stream pagination constraints (max 100 items)
+ *
+ * Used by: stream-chat.dto
+ */
+export declare const CHAT_PAGINATION_CONSTRAINT: QueryPaginationConstraint;
+/**
+ * User address constraint interface (with pattern)
+ */
+export interface AddressPatternConstraint {
+    /** Regex pattern for validation */
+    PATTERN: RegExp;
+}
+/**
+ * Flexible address constraint interface (with max length)
+ */
+export interface AddressLengthConstraint {
+    /** Maximum length (for variable-length addresses) */
+    MAX_LENGTH: number;
+}
+/**
+ * User address constraints (eth| format)
+ *
+ * Used by: trade.dto, user.dto
+ */
+export declare const USER_ADDRESS_CONSTRAINT: AddressPatternConstraint;
+/**
+ * Flexible address constraints (accepts multiple formats)
+ *
+ * Used by: chat-messages.dto, trades-query.dto
+ */
+export declare const FLEXIBLE_ADDRESS_CONSTRAINT: AddressLengthConstraint;
+/**
+ * Re-export ADDRESS_PATTERNS from validation-helpers for convenience
+ */
+export { ADDRESS_PATTERNS };
+/**
+ * Content length constraints
+ */
+export declare const CONTENT_LENGTH_CONSTRAINTS: {
+    /** Comment content (comment.dto) */
+    readonly COMMENT: {
+        readonly MAX_LENGTH: 1000;
+    };
+    /** Comments v1 content (comments.dto) */
+    readonly COMMENTS_V1: {
+        readonly MAX_LENGTH: 2000;
+    };
+    /** Chat message content (stream-chat.dto) */
+    readonly CHAT_MESSAGE: {
+        readonly MIN_LENGTH: 1;
+        readonly MAX_LENGTH: 500;
+        readonly PATTERN: RegExp;
+    };
+    /** Chat messages v1 content (chat-messages.dto) */
+    readonly CHAT_MESSAGES_V1: {
+        readonly MAX_LENGTH: 500;
+    };
+    /** Ban reason (ban.dto) */
+    readonly BAN_REASON: {
+        readonly MAX_LENGTH: 500;
+    };
+    /** Description (moderator.dto, overseer) */
+    readonly DESCRIPTION: {
+        readonly MAX_LENGTH: 255;
+    };
+    /** Token description (launchpad.dto) */
+    readonly TOKEN_DESCRIPTION: {
+        readonly MIN_LENGTH: 1;
+        readonly MAX_LENGTH: 500;
+    };
+    /** Flag details (content-flag.dto) */
+    readonly FLAG_DETAILS: {
+        readonly MAX_LENGTH: 1000;
+    };
+    /** Content ID (content-flag.dto) */
+    readonly CONTENT_ID: {
+        readonly MAX_LENGTH: 100;
+    };
+};
+/**
+ * Message ID pattern constraints
+ */
+export declare const MESSAGE_ID_CONSTRAINTS: {
+    /** Chat message ID pattern: chat-{timestamp13}-{uuid} */
+    readonly CHAT_MESSAGE: {
+        readonly PATTERN: RegExp;
+    };
+    /** Content reaction message ID (supports both formats) */
+    readonly CONTENT_REACTION: {
+        readonly MAX_LENGTH: 64;
+        readonly PATTERN: RegExp;
+    };
+};
+/**
+ * Ban duration constraints
+ */
+export declare const BAN_DURATION_CONSTRAINT: {
+    /** Minimum duration in seconds (1 minute) */
+    readonly MIN_SECONDS: 60;
+    /** Maximum duration in seconds (1 year) */
+    readonly MAX_SECONDS: 31536000;
+};
+/**
+ * Unique key constraints for idempotency
+ *
+ * Used by: transfer.dto, lock.dto, burn.dto
+ */
+export declare const UNIQUE_KEY_CONSTRAINT: {
+    /** Maximum length for unique keys */
+    readonly MAX_LENGTH: 64;
+    /** Pattern for valid unique keys (must have GalaChain operation prefix) */
+    readonly PATTERN: RegExp;
+};
+/**
+ * Token symbol constraints (uppercase letters only)
+ *
+ * Used by: launchpad.dto
+ */
+export declare const TOKEN_SYMBOL_CONSTRAINT: {
+    readonly MIN_LENGTH: 1;
+    readonly MAX_LENGTH: 8;
+    readonly PATTERN: RegExp;
+};
+/**
+ * File upload constraints
+ *
+ * Used by: launchpad.dto
+ */
+export declare const FILE_UPLOAD_CONSTRAINT: {
+    /** Maximum file size in bytes (10MB) */
+    readonly MAX_SIZE: number;
+    /** Minimum file size in bytes */
+    readonly MIN_SIZE: 1;
+    /** Maximum filename length */
+    readonly MAX_FILENAME_LENGTH: 255;
+    /** Allowed MIME types */
+    readonly ALLOWED_TYPES: readonly ["image/png", "image/jpg", "image/jpeg", "image/gif", "image/webp", "image/svg+xml"];
+    /** Allowed file extensions */
+    readonly ALLOWED_EXTENSIONS: readonly [".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg"];
+};
+/**
+ * Invite code constraints
+ *
+ * Used by: moderator.dto, overseer
+ */
+export declare const INVITE_CODE_CONSTRAINT: {
+    /** Invite code length (64 hex characters) */
+    readonly LENGTH: 64;
+    /** Invite code pattern */
+    readonly PATTERN: RegExp;
+    /** Max length for overseer codes (more permissive) */
+    readonly MAX_LENGTH: 100;
+};
+/**
+ * Simulcast constraints
+ *
+ * Used by: streaming.dto
+ */
+export declare const SIMULCAST_CONSTRAINT: {
+    /** Maximum simulcast targets per stream */
+    readonly MAX_TARGETS: 3;
+    /** Stream URL pattern (RTMP, RTMPS, SRT) */
+    readonly STREAM_URL_PATTERN: RegExp;
+    /**
+     * @deprecated since 6.4.0, will be removed in 7.0.0.
+     * Use STREAM_URL_PATTERN instead which supports RTMP, RTMPS, and SRT protocols.
+     */
+    readonly RTMP_URL_PATTERN: RegExp;
+};
+/**
+ * Recording constraints
+ *
+ * Used by: streaming.dto
+ */
+export declare const RECORDING_CONSTRAINT: {
+    /** Maximum recordings to fetch per page */
+    readonly MAX_LIMIT: 50;
+};
+/**
+ * Volume data query constraints
+ *
+ * Used by: launchpad.dto for fetchVolumeData()
+ */
+export declare const VOLUME_DATA_CONSTRAINT: {
+    /** Minimum timestamp value */
+    readonly MIN_TIMESTAMP: 173000000;
+    /** Minimum resolution value */
+    readonly MIN_RESOLUTION: 1;
+};
+/**
+ * Vault address patterns
+ *
+ * Used by: trade.dto
+ */
+export declare const VAULT_ADDRESS_CONSTRAINT: {
+    /** Ethereum vault pattern: eth|0x[40-hex-chars] */
+    readonly ETH_PATTERN: RegExp;
+    /** Service vault pattern: service|[alphanumeric with special chars] */
+    readonly SERVICE_PATTERN: RegExp;
+};
+/**
+ * Amount validation constraints
+ *
+ * Used by: trade.dto
+ */
+export declare const AMOUNT_CONSTRAINT: {
+    /** Pattern for positive decimal numbers */
+    readonly POSITIVE_DECIMAL: RegExp;
+};
+/**
+ * Batch operation size constraints
+ */
+export declare const BATCH_SIZE_CONSTRAINT: {
+    /** Maximum tokens per lock batch */
+    readonly MAX_LOCK_BATCH: 100;
+    /** Maximum tokens per unlock batch */
+    readonly MAX_UNLOCK_BATCH: 100;
+    /** Maximum tokens per burn batch */
+    readonly MAX_BURN_BATCH: 100;
+};
+/**
+ * Search query constraints
+ *
+ * Used by: user.dto
+ */
+export declare const SEARCH_CONSTRAINT: {
+    readonly MIN_LENGTH: 1;
+    readonly MAX_LENGTH: 100;
+};
+/**
+ * User profile constraints
+ *
+ * Used by: user.dto
+ */
+export declare const PROFILE_CONSTRAINT: {
+    readonly FULL_NAME: {
+        readonly MIN_LENGTH: 1;
+        readonly MAX_LENGTH: 100;
+        /** Pattern for alphabets only (first name and optional last name) */
+        readonly ALPHABETS_ONLY_PATTERN: RegExp;
+    };
+};
+/**
+ * URL validation constraints
+ *
+ * Used by: launchpad.dto
+ */
+export declare const URL_CONSTRAINT: {
+    /** Basic URL pattern */
+    readonly PATTERN: RegExp;
+};
+/**
+ * Social URL requirements
+ */
+export declare const SOCIAL_URL_CONSTRAINT: {
+    /** At least one of these URLs must be provided */
+    readonly REQUIRED_COUNT: 1;
+    /** Valid social URL fields */
+    readonly FIELDS: readonly ["websiteUrl", "twitterUrl", "telegramUrl", "instagramUrl", "facebookUrl", "redditUrl", "tiktokUrl"];
+};
+//# sourceMappingURL=constraints.d.ts.map

package/dist/src/types/constraints.d.ts.map

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

package/dist/src/types/content-flag.dto.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Content Flag/Report Types
+ *
+ * Two-tier system: one-click flags for chat/comments, modal reports for streams.
+ *
+ * @module content-flag.dto
+ */
+import { UserProfileInfo, PaginationMeta, ListResult, BasePaginationOptions, InternalApiResponse } from './common';
+/**
+ * Content types that can be flagged/reported
+ */
+export declare enum ContentType {
+    CHAT_MESSAGE = "CHAT_MESSAGE",
+    COMMENT = "COMMENT",
+    STREAM = "STREAM"
+}
+/**
+ * Reasons for flagging content
+ * Required for STREAM reports, optional for chat/comment flags
+ */
+export declare enum FlagReason {
+    INAPPROPRIATE_CONTENT = "INAPPROPRIATE_CONTENT",
+    SPAM = "SPAM",
+    HARASSMENT = "HARASSMENT",
+    SCAM = "SCAM",
+    OTHER = "OTHER"
+}
+/**
+ * Status of the flag/report
+ */
+export declare enum FlagStatus {
+    PENDING = "PENDING",
+    DISMISSED = "DISMISSED",
+    ACTIONED = "ACTIONED"
+}
+/**
+ * Actions that can be taken on flagged content
+ */
+export declare enum FlagAction {
+    DELETE_CONTENT = "DELETE_CONTENT",
+    BAN_USER = "BAN_USER",
+    DELETE_AND_BAN = "DELETE_AND_BAN"
+}
+/**
+ * Content flag data returned from API
+ */
+export interface FlagData {
+    id: number;
+    tokenName: string;
+    contentType: ContentType;
+    contentId: string;
+    contentSnapshot: string | null;
+    reporterAddress: string;
+    reportedUserAddress: string;
+    reason: FlagReason | null;
+    details: string | null;
+    status: FlagStatus;
+    reviewedBy: string | null;
+    reviewedAt: string | null;
+    actionTaken: FlagAction | null;
+    createdAt: string;
+    updatedAt: string;
+    reporter?: UserProfileInfo;
+    reportedUser?: UserProfileInfo;
+}
+/**
+ * Options for creating a content flag/report
+ *
+ * - Chat/Comment: reason and details are optional (one-click flag)
+ * - Stream: reason is required (modal flow)
+ */
+export interface CreateFlagOptions {
+    /** Token name the content belongs to */
+    tokenName: string;
+    /** Type of content being flagged */
+    contentType: ContentType;
+    /** ID of the content (message ID, comment ID, or stream ID) */
+    contentId: string;
+    /** Address of the user who created the flagged content */
+    reportedUserAddress: string;
+    /** Reason for the flag (required for STREAM, optional for others) */
+    reason?: FlagReason;
+    /** Additional details about the flag (max 500 chars) */
+    details?: string;
+}
+/**
+ * Options for listing flags for a specific token
+ *
+ * @since 6.11.0 - Now extends BasePaginationOptions for DRY compliance
+ */
+export interface ListFlagsOptions extends BasePaginationOptions {
+    /** Token name to list flags for */
+    tokenName: string;
+    /** Filter by content type */
+    contentType?: ContentType;
+    /** Filter by status */
+    status?: FlagStatus;
+    /** Filter by reason */
+    reason?: FlagReason;
+    /** Filter by reporter address */
+    reporterAddress?: string;
+    /** Filter by reported user address */
+    reportedUserAddress?: string;
+}
+/**
+ * Options for listing flags globally (across all tokens)
+ * Used by overseers and admins for the CCTV dashboard
+ *
+ * @since 6.11.0 - Now extends BasePaginationOptions for DRY compliance
+ */
+export interface ListGlobalFlagsOptions extends BasePaginationOptions {
+    /** Filter by token name (optional - no token filter shows all) */
+    tokenName?: string;
+    /** Filter by content type */
+    contentType?: ContentType;
+    /** Filter by status */
+    status?: FlagStatus;
+    /** Filter by reason */
+    reason?: FlagReason;
+    /** Filter by reporter address */
+    reporterAddress?: string;
+    /** Filter by reported user address */
+    reportedUserAddress?: string;
+}
+/**
+ * Options for dismissing a flag
+ */
+export interface DismissFlagOptions {
+    /** Flag ID to dismiss */
+    flagId: number;
+}
+/**
+ * Options for taking action on a flag
+ */
+export interface ActionFlagOptions {
+    /** Flag ID to action */
+    flagId: number;
+    /** Action to take */
+    action: FlagAction;
+}
+/**
+ * Result from creating a flag
+ */
+export interface CreateFlagResult {
+    flag: FlagData;
+}
+/**
+ * Pagination metadata for content flag list responses
+ *
+ * Type alias for the unified list metadata type. All domain-specific pagination
+ * metadata types (FlagPaginationMeta, BanListMeta, etc.) share the same structure:
+ * `{ total, page, limit, totalPages }`
+ *
+ * @deprecated Use PaginationMeta from common.ts directly. This alias is kept for backward compatibility.
+ * @see PaginationMeta in common.ts for the canonical pagination metadata type
+ * @see ListMetadata in common.ts for the unified list metadata alias
+ */
+export type FlagPaginationMeta = PaginationMeta;
+/**
+ * Result from listing flags
+ *
+ * @since 6.6.0 - Refactored to use generic ListResult<T> pattern
+ *
+ * Note: For backward compatibility, use `result.items` (generic pattern) or
+ * cast to legacy interface with `flags` field if needed.
+ */
+export type FlagListResult = ListResult<FlagData>;
+/**
+ * Result from dismissing a flag
+ */
+export interface DismissFlagResult {
+    flag: FlagData;
+}
+/**
+ * Result from actioning a flag
+ */
+export interface ActionFlagResult {
+    flag: FlagData;
+}
+/**
+ * Internal response data for list flags endpoint
+ * @internal
+ */
+interface InternalListFlagsData {
+    flags: FlagData[];
+    meta: FlagPaginationMeta;
+}
+/**
+ * Internal response from list flags endpoint
+ * Uses domain-specific field name (flags) instead of generic (items)
+ * @internal
+ * @since 6.13.0 - Refactored to use InternalApiResponse<T> from common.ts
+ */
+export type InternalListFlagsResponse = InternalApiResponse<InternalListFlagsData>;
+/**
+ * Payload sent when content is flagged
+ */
+export interface ContentFlaggedPayload {
+    id: number;
+    tokenName: string;
+    contentType: ContentType;
+    contentId: string;
+    reason: FlagReason | null;
+    reporterAddress: string;
+    reportedUserAddress: string;
+    createdAt: string;
+}
+/**
+ * Payload sent when a flag is resolved
+ */
+export interface FlagResolvedPayload {
+    id: number;
+    tokenName: string;
+    contentType: ContentType;
+    contentId: string;
+    status: FlagStatus;
+    actionTaken: FlagAction | null;
+    reviewedBy: string;
+    reviewedAt: string;
+}
+/**
+ * Flag reason display labels
+ */
+export declare const FLAG_REASON_LABELS: Record<FlagReason, string>;
+/**
+ * Flag status display labels
+ */
+export declare const FLAG_STATUS_LABELS: Record<FlagStatus, string>;
+/**
+ * Flag action display labels
+ */
+export declare const FLAG_ACTION_LABELS: Record<FlagAction, string>;
+/**
+ * Content type display labels
+ */
+export declare const CONTENT_TYPE_LABELS: Record<ContentType, string>;
+/**
+ * Maximum length for flag details
+ */
+export declare const FLAG_DETAILS_MAX_LENGTH = 500;
+/** Check if a value is a valid ContentType */
+export declare const isContentType: (value: unknown) => value is ContentType;
+/** Check if a value is a valid FlagReason */
+export declare const isFlagReason: (value: unknown) => value is FlagReason;
+/** Check if a value is a valid FlagStatus */
+export declare const isFlagStatus: (value: unknown) => value is FlagStatus;
+/** Check if a value is a valid FlagAction */
+export declare const isFlagAction: (value: unknown) => value is FlagAction;
+/**
+ * Check if a value is valid FlagData
+ *
+ * @since 6.12.0 - Refactored to use factory pattern
+ */
+export declare const isFlagData: (obj: unknown) => obj is FlagData;
+/**
+ * Content flag validation constraints
+ *
+ * @deprecated Import individual constraints from './constraints' instead.
+ * This composite object is kept for backward compatibility.
+ */
+export declare const CONTENT_FLAG_CONSTRAINTS: {
+    readonly TOKEN_NAME: import("./constraints").TokenNameConstraint;
+    readonly CONTENT_ID: {
+        readonly MAX_LENGTH: 100;
+    };
+    readonly DETAILS: {
+        readonly MAX_LENGTH: 1000;
+    };
+    readonly PAGINATION: {
+        readonly DEFAULT_LIMIT: 20;
+        readonly MAX_LIMIT: number;
+    };
+};
+/**
+ * Validates CreateFlagOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateCreateFlagOptions(options: CreateFlagOptions): void;
+/**
+ * Validates ListFlagsOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateListFlagsOptions(options: ListFlagsOptions): void;
+/**
+ * Validates ListGlobalFlagsOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateListGlobalFlagsOptions(options: ListGlobalFlagsOptions): void;
+/**
+ * Validates DismissFlagOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateDismissFlagOptions(options: DismissFlagOptions): void;
+/**
+ * Validates ActionFlagOptions
+ *
+ * @param options - Options to validate
+ * @throws {ValidationError} If options are invalid
+ */
+export declare function validateActionFlagOptions(options: ActionFlagOptions): void;
+export {};
+//# sourceMappingURL=content-flag.dto.d.ts.map

package/dist/src/types/content-flag.dto.d.ts.map

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