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

package/dist/types/overseer.dto.d.ts

@@ -0,0 +1,530 @@
+/**
+ * Overseer System Types
+ *
+ * Type definitions for the global platform oversight system.
+ * Overseers are Gala employees with MANAGER-level access to ALL tokens.
+ *
+ * **Key Difference from Moderators:**
+ * - Moderators: Token-scoped access (invited per-token or blanket for owner's tokens)
+ * - Overseers: Global platform access (all tokens, current and future)
+ *
+ * @since 5.9.0
+ */
+import type { BasePaginationOptions, InternalApiResponse, ListResult, PageInfo } from './common';
+/**
+ * Valid statuses for overseer invites
+ */
+export declare const OVERSEER_INVITE_STATUS: {
+    readonly PENDING: "PENDING";
+    readonly CLAIMED: "CLAIMED";
+    readonly REVOKED: "REVOKED";
+    readonly EXPIRED: "EXPIRED";
+};
+export type OverseerInviteStatus = typeof OVERSEER_INVITE_STATUS[keyof typeof OVERSEER_INVITE_STATUS];
+/**
+ * Valid statuses for overseers
+ */
+export declare const OVERSEER_STATUS: {
+    readonly ACTIVE: "ACTIVE";
+    readonly REVOKED: "REVOKED";
+};
+export type OverseerStatus = typeof OVERSEER_STATUS[keyof typeof OVERSEER_STATUS];
+/**
+ * Options for creating an overseer invite
+ */
+export interface CreateOverseerInviteOptions {
+    /**
+     * Optional description/label for the invite (e.g., "John - Platform Team")
+     * Max 255 characters
+     */
+    description?: string;
+    /**
+     * Optional expiration time (ISO 8601 format)
+     * If not provided, invite never expires
+     */
+    expiresAt?: string;
+}
+/**
+ * Options for creating an overseer directly (bypassing invite flow)
+ *
+ * @since 8.3.0
+ */
+export interface CreateOverseerDirectOptions {
+    /**
+     * The wallet address to promote to overseer
+     * Must be in GalaChain format (eth|0x...)
+     */
+    userAddress: string;
+    /**
+     * Optional description/label for the promotion (e.g., "Platform Team - John")
+     * Max 255 characters
+     */
+    description?: string;
+}
+/**
+ * Options for listing overseer invites
+ *
+ * @since 6.11.0 - Now extends BasePaginationOptions for DRY compliance
+ */
+export interface ListOverseerInvitesOptions extends BasePaginationOptions {
+    /**
+     * Filter by invite status
+     */
+    status?: OverseerInviteStatus;
+}
+/**
+ * Options for listing overseers
+ *
+ * @since 6.11.0 - Now extends BasePaginationOptions for DRY compliance
+ */
+export interface ListOverseersOptions extends BasePaginationOptions {
+    /**
+     * Filter by overseer status
+     */
+    status?: OverseerStatus;
+}
+/**
+ * Overseer invite data returned from the API
+ */
+export interface OverseerInvite {
+    /** Unique identifier */
+    id: number;
+    /** Magic link code for claiming */
+    inviteCode: string;
+    /** Wallet address of the admin/overseer who created this invite */
+    invitedBy: string;
+    /** Wallet address of the user who claimed this invite (null if unclaimed) */
+    claimedBy: string | null;
+    /** Optional description/label */
+    description: string | null;
+    /** Current status of the invite */
+    status: OverseerInviteStatus;
+    /** Expiration timestamp (null if never expires) */
+    expiresAt: string | null;
+    /** When the invite was claimed (null if unclaimed) */
+    claimedAt: string | null;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Full invite URL for sharing
+ */
+export interface OverseerInviteWithUrl extends OverseerInvite {
+    /** Complete URL for the claim page */
+    inviteUrl: string;
+}
+/**
+ * Public invite info (returned by public endpoint before claiming)
+ */
+export interface PublicOverseerInviteInfo {
+    /** Description/label (if set) */
+    description: string | null;
+    /** Current status */
+    status: OverseerInviteStatus;
+    /** Expiration timestamp */
+    expiresAt: string | null;
+    /** Wallet address of inviter, or 'STREAM_ADMIN' for admin API key invites */
+    invitedBy: string;
+}
+/**
+ * Overseer data returned from the API
+ */
+export interface Overseer {
+    /** Unique identifier */
+    id: number;
+    /** Wallet address of the overseer */
+    userAddress: string;
+    /** ID of the invite that granted this access */
+    inviteId: number;
+    /** Current status */
+    status: OverseerStatus;
+    /** When access was revoked (null if still active) */
+    revokedAt: string | null;
+    /** Who revoked the access (null if still active) */
+    revokedBy: string | null;
+    /** When overseer access was granted */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Response for checking own overseer status
+ */
+export interface OverseerStatusResponse {
+    /** Whether the user is an active overseer */
+    isOverseer: boolean;
+    /** Overseer details (only present if isOverseer is true) */
+    overseer?: Overseer;
+}
+/**
+ * Platform summary response for CCTV dashboard
+ */
+export interface OverseerSummaryResponse {
+    /** Count of pools with active streams (muxStreamStatus = 'ACTIVE') */
+    activeStreams: number;
+    /** Sum of currentViewerCount across all active streams */
+    totalViewers: number;
+    /** Count of content flags with status = 'PENDING' */
+    pendingFlags: number;
+    /** Total count of pools on the platform */
+    totalPools: number;
+}
+/**
+ * Per-page stats for banned users tab
+ */
+export interface BanStatsResponse {
+    /** Active global user bans (non-expired) */
+    total: number;
+}
+/**
+ * Per-page stats for delisted tokens tab
+ */
+export interface TokenBanStatsResponse {
+    /** Total delisted tokens */
+    total: number;
+}
+/**
+ * Per-page stats for overseer invites tab
+ */
+export interface InviteStatsResponse {
+    /** All invitations */
+    total: number;
+    /** Awaiting claim */
+    pending: number;
+    /** Successfully claimed */
+    claimed: number;
+    /** Cancelled invites */
+    revoked: number;
+}
+/**
+ * Per-page stats for content flags tab
+ */
+export interface FlagStatsResponse {
+    /** All content flags */
+    total: number;
+    /** Awaiting review */
+    pending: number;
+    /** Flags resolved with action */
+    actioned: number;
+    /** No action needed */
+    dismissed: number;
+}
+/**
+ * Per-page stats for users management tab
+ */
+export interface UserStatsResponse {
+    /** Total registered users */
+    totalUsers: number;
+    /** Users with pending content flags */
+    flaggedUsers: number;
+    /** Users with active global bans */
+    bannedUsers: number;
+}
+/**
+ * Paginated overseer invites response
+ *
+ * @since 6.6.0 - Refactored to use generic ListResult<T> pattern
+ */
+export type PaginatedOverseerInvites = ListResult<OverseerInviteWithUrl>;
+/**
+ * Paginated overseers response
+ *
+ * @since 6.6.0 - Refactored to use generic ListResult<T> pattern
+ */
+export type PaginatedOverseers = ListResult<Overseer>;
+/**
+ * Options for listing users with pagination and filters
+ *
+ * @since 6.x.0
+ */
+export interface ListUsersOptions extends BasePaginationOptions {
+    /**
+     * Search query (searches by username, email, address)
+     */
+    search?: string;
+    /**
+     * Sort field (username, email, joinedAt, activity)
+     */
+    sortBy?: string;
+    /**
+     * Sort order (asc or desc)
+     */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * User profile data for overseer listings
+ *
+ * @since 6.x.0
+ */
+export interface UserProfileData {
+    /** Wallet address */
+    address: string;
+    /** Full name or username */
+    fullName?: string | null;
+    /** Email address */
+    email?: string | null;
+    /** Profile image URL */
+    imageUrl?: string | null;
+    /** Bio/description */
+    bio?: string | null;
+    /** Profile creation timestamp */
+    joinedAt: string;
+}
+/**
+ * User activity metrics for overseer summaries
+ *
+ * @since 6.x.0
+ */
+export interface UserActivityMetrics {
+    /** Number of comments posted */
+    commentCount: number;
+    /** Number of chat messages sent */
+    messageCount: number;
+    /** Number of trades executed */
+    tradeCount: number;
+    /** Total trading volume in USD */
+    tradingVolume: string;
+    /** Last activity timestamp */
+    lastActivityAt: string | null;
+}
+/**
+ * User badges and achievements for overseer dashboard
+ *
+ * @since 6.x.0
+ */
+export interface UserBadgeData {
+    /** Early adopter badge (joined before 2024) */
+    earlyAdopter: boolean;
+    /** Verified creator badge */
+    verifiedCreator: boolean;
+    /** High-volume trader badge (100+ trades) */
+    highVolumeTrader: boolean;
+    /** Moderator badge */
+    isModerator: boolean;
+    /** Overseer badge */
+    isOverseer: boolean;
+    /** Custom badge count */
+    customBadgeCount: number;
+}
+/**
+ * Aggregated user activity statistics
+ *
+ * Comprehensive breakdown of all user activities across the platform.
+ *
+ * @since 6.x.0
+ */
+export interface UserActivityStats {
+    /** Total number of tokens held */
+    tokensHeld: number;
+    /** Total number of tokens created */
+    tokensCreated: number;
+    /** Total tokens moderated */
+    tokensModerated: number;
+    /** Total comments posted */
+    commentCount: number;
+    /** Total chat messages sent */
+    chatMessageCount: number;
+    /** Total trades executed */
+    tradeCount: number;
+    /** Total content flags received */
+    flagsReceived: number;
+    /** Active bans count (non-expired) */
+    activeBansCount: number;
+    /** Total trading volume in USD */
+    totalTradingVolume: string;
+    /** Last activity timestamp */
+    lastActivityAt: string | null;
+}
+/**
+ * User list item returned by the overseer users list endpoint.
+ * Flat structure matching the backend response.
+ *
+ * @since 6.x.0
+ */
+export interface UserListItem {
+    /** User wallet address */
+    address: string;
+    /** User display name */
+    fullName: string | null;
+    /** User profile image URL */
+    profileImage: string | null;
+    /** Total content flags received by this user */
+    flagsReceived: number;
+    /** Number of pending flags for this user */
+    flagsPending: number;
+    /** Number of active bans */
+    activeBans: number;
+    /** Whether user has a global ban */
+    globalBan: boolean;
+    /** When the user record was created */
+    createdAt: string;
+}
+/**
+ * Paginated list of users for overseer dashboard
+ *
+ * @since 6.x.0
+ */
+export type UsersListResponse = ListResult<UserListItem>;
+/**
+ * User profile info in summary response
+ *
+ * @since 6.x.0
+ */
+export interface UserSummaryProfile {
+    /** Wallet address */
+    address: string;
+    /** Display name */
+    fullName: string | null;
+    /** Profile image URL */
+    profileImage: string | null;
+    /** Bio/description */
+    bio: string | null;
+    /** User badges */
+    badges: {
+        launch: string[];
+        success: string[];
+        volume: string[];
+        engagement: string[];
+    };
+    /** Profile creation timestamp */
+    createdAt: string;
+}
+/**
+ * User activity stats in summary response
+ *
+ * @since 6.x.0
+ */
+export interface UserSummaryStats {
+    /** Tokens held by user */
+    tokensHeld: number;
+    /** Tokens created by user */
+    tokensCreated: number;
+    /** Total comments posted */
+    commentsCount: number;
+    /** Total chat messages sent */
+    chatMessagesCount: number;
+    /** Total content flags received */
+    flagsReceived: number;
+    /** Pending flags count */
+    flagsPending: number;
+    /** Active bans count */
+    activeBans: number;
+    /** Whether user has a global ban */
+    globalBan: boolean;
+}
+/**
+ * Comprehensive user summary for overseer user detail page.
+ * Matches the backend UserSummaryResponse structure.
+ *
+ * @since 6.x.0
+ */
+export interface UserSummaryResponse {
+    /** User profile data (may be null if user has no profile) */
+    profile: UserSummaryProfile | null;
+    /** User activity statistics */
+    stats: UserSummaryStats;
+}
+/**
+ * Internal response for list users endpoint
+ * @internal
+ */
+export interface InternalListUsersResponse {
+    status: number;
+    error: boolean;
+    message: string;
+    data: {
+        users: UserListItem[];
+        pageInfo: PageInfo;
+    };
+}
+/**
+ * Internal response for user summary endpoint
+ * @internal
+ */
+export interface InternalUserSummaryResponse extends InternalApiResponse<UserSummaryResponse> {
+}
+/**
+ * Internal response from list overseer invites endpoint
+ * Uses domain-specific field name (invites) instead of generic (items)
+ * @internal
+ */
+export interface InternalListOverseerInvitesResponse {
+    status: number;
+    error: boolean;
+    message: string;
+    data: {
+        invites: OverseerInviteWithUrl[];
+        pageInfo: PageInfo;
+    };
+}
+/**
+ * Internal response from list overseers endpoint
+ * Uses domain-specific field name (overseers) instead of generic (items)
+ * @internal
+ */
+export interface InternalListOverseersResponse {
+    status: number;
+    error: boolean;
+    message: string;
+    data: {
+        overseers: Overseer[];
+        pageInfo: PageInfo;
+    };
+}
+/** Check if a value is a valid OverseerInviteStatus */
+export declare const isOverseerInviteStatus: (value: unknown) => value is "PENDING" | "CLAIMED" | "REVOKED" | "EXPIRED";
+/** Check if a value is a valid OverseerStatus */
+export declare const isOverseerStatus: (value: unknown) => value is "ACTIVE" | "REVOKED";
+/**
+ * Check if an invite can be claimed
+ */
+export declare function isClaimableInvite(invite: OverseerInvite): boolean;
+/**
+ * Validate CreateOverseerInviteOptions
+ * @throws ValidationError if validation fails
+ */
+export declare function validateCreateOverseerInviteOptions(options: CreateOverseerInviteOptions): void;
+/**
+ * Validate ListOverseerInvitesOptions
+ * @throws Error if validation fails
+ */
+export declare function validateListOverseerInvitesOptions(options: ListOverseerInvitesOptions): void;
+/**
+ * Validate ListOverseersOptions
+ * @throws Error if validation fails
+ */
+export declare function validateListOverseersOptions(options: ListOverseersOptions): void;
+/**
+ * Validate invite code format
+ * @throws ValidationError if validation fails
+ */
+export declare function validateInviteCode(code: string): void;
+/**
+ * Validate wallet address format
+ *
+ * This function wraps the shared `assertValidWalletAddress` helper for backward
+ * compatibility with existing overseer service code. Supports ETH, backend (eth|),
+ * and client addresses.
+ *
+ * @throws ValidationError if validation fails
+ */
+export declare function validateWalletAddress(address: string): void;
+/**
+ * Validate invite ID
+ * @throws Error if validation fails
+ */
+export declare function validateInviteId(id: number): void;
+/**
+ * Validate list users options
+ * @throws ValidationError if validation fails
+ */
+export declare function validateListUsersOptions(options: ListUsersOptions): void;
+/**
+ * Validate CreateOverseerDirectOptions
+ * @throws ValidationError if validation fails
+ * @since 8.3.0
+ */
+export declare function validateCreateOverseerDirectOptions(options: CreateOverseerDirectOptions): void;
+//# sourceMappingURL=overseer.dto.d.ts.map

package/dist/types/overseer.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overseer.dto.d.ts","sourceRoot":"","sources":["../../src/types/overseer.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmBH,OAAO,KAAK,EAAE,qBAAqB,EAAC,mBAAmB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,OAAO,sBAAsB,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AAEtG;;GAEG;AACH,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAMlF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACvE;;OAEG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IAEnB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAElB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,iCAAiC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,mCAAmC;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAE7B,mDAAmD;IACnD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,sDAAsD;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,qBAAqB;IACrB,MAAM,EAAE,oBAAoB,CAAC;IAE7B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IAEjB,qBAAqB;IACrB,MAAM,EAAE,cAAc,CAAC;IAEvB,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,oDAAoD;IACpD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,UAAU,EAAE,OAAO,CAAC;IAEpB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IAEtB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IAErB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IAErB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AAMtD;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC7D;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB,6BAA6B;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sBAAsB;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wBAAwB;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sBAAsB;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,kBAAkB;IAClB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,+BAA+B;IAC/B,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,KAAK,EAAE,YAAY,EAAE,CAAC;QACtB,QAAQ,EAAE,QAAQ,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,2BACf,SAAQ,mBAAmB,CAAC,mBAAmB,CAAC;CAAG;AAgBrD;;;;GAIG;AACH,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,OAAO,EAAE,qBAAqB,EAAE,CAAC;QACjC,QAAQ,EAAE,QAAQ,CAAC;KACpB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,QAAQ,EAAE,QAAQ,CAAC;KACpB,CAAC;CACH;AAMD,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,4EAA8C,CAAC;AAElF,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,mDAAuC,CAAC;AAErE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAcjE;AAMD;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CA0C9F;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAO5F;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAOhF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAW3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAWjD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAiCxE;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CA2B9F"}

package/dist/types/platform-config.dto.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Platform Configuration Data Transfer Objects and Types
+ *
+ * This module defines all types and interfaces for platform configuration management
+ * including global settings for streaming, chat, comments, and webhooks.
+ *
+ * @since 7.3.0
+ */
+/**
+ * Platform configuration object returned from GET /v1/config
+ *
+ * Contains global platform settings that affect all tokens and streams.
+ *
+ * @since 7.3.0
+ */
+export interface PlatformConfig {
+    /** Whether streaming is globally enabled */
+    streamingEnabled: boolean;
+    /** Whether chat is globally enabled */
+    chatEnabled: boolean;
+    /** Whether comments are globally enabled */
+    commentsEnabled: boolean;
+    /** Whether webhooks are globally enabled */
+    webhooksEnabled: boolean;
+    /** Whether AI moderation is globally enabled */
+    aiModerationEnabled: boolean;
+    /** Whether AI moderation provider (ANTHROPIC_API_KEY) is configured on the server (read-only) */
+    aiModerationAvailable: boolean;
+}
+/**
+ * Options for updating platform configuration via PUT /v1/config
+ *
+ * Partial update - only provide fields to change.
+ *
+ * @since 7.3.0
+ */
+export interface UpdatePlatformConfigOptions {
+    /** Enable/disable streaming globally */
+    streamingEnabled?: boolean;
+    /** Enable/disable chat globally */
+    chatEnabled?: boolean;
+    /** Enable/disable comments globally */
+    commentsEnabled?: boolean;
+    /** Enable/disable webhooks globally */
+    webhooksEnabled?: boolean;
+    /** Enable/disable AI moderation globally */
+    aiModerationEnabled?: boolean;
+}
+/**
+ * Information about a single role
+ *
+ * Defines a role's permissions and hierarchy level.
+ *
+ * @since 7.3.0
+ */
+export interface RoleInfo {
+    /** Role name identifier (OWNER, MANAGER, TECHNICAL_PRODUCER, MODERATOR) */
+    name: string;
+    /** Human-readable description of the role */
+    description: string;
+    /** Hierarchy level (higher = more privileges). MODERATOR=0, TECHNICAL_PRODUCER=1, MANAGER=2, OWNER=3 */
+    level: number;
+    /** List of permissions this role has */
+    permissions: string[];
+}
+/**
+ * Available roles and permissions response from GET /v1/roles
+ *
+ * Returns reference data about the role system including all available roles,
+ * their permissions, and the complete list of all available permissions.
+ *
+ * @since 7.3.0
+ */
+export interface AvailableRolesResponse {
+    /** List of available roles with their details */
+    roles: RoleInfo[];
+    /** List of all available permission names */
+    permissions: string[];
+}
+/**
+ * Validate UpdatePlatformConfigOptions
+ *
+ * @param options Options to validate
+ * @returns Array of error messages (empty if valid)
+ *
+ * @since 7.3.0
+ */
+export declare function validateUpdatePlatformConfigOptions(options: UpdatePlatformConfigOptions): string[];
+//# sourceMappingURL=platform-config.dto.d.ts.map

package/dist/types/platform-config.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-config.dto.d.ts","sourceRoot":"","sources":["../../src/types/platform-config.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iGAAiG;IACjG,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,wGAAwG;IACxG,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,EAAE,CAwClG"}

package/dist/types/platform-stats.dto.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Platform Stats Types
+ *
+ * Types for platform-wide statistics including trading volume
+ * and token counts.
+ *
+ * @category Types
+ * @since 9.0.0
+ */
+/**
+ * Platform-wide statistics data
+ */
+export interface PlatformStatsData {
+    /** Total GALA trading volume in last 1 hour */
+    galaVolume1h: string;
+    /** Total GALA trading volume in last 24 hours */
+    galaVolume24h: string;
+    /** Total GALA trading volume in last 7 days */
+    galaVolume7d: string;
+    /** Total number of tokens on the platform */
+    totalTokens: number;
+    /** Timestamp of stats calculation (ISO 8601) */
+    timestamp: string;
+}
+/**
+ * Result type for platform stats
+ */
+export interface GetPlatformStatsResult {
+    stats: PlatformStatsData;
+}
+/**
+ * Internal API response for platform stats
+ */
+export interface InternalPlatformStatsResponse {
+    status: number;
+    error: boolean;
+    message?: string;
+    data: PlatformStatsData;
+}
+//# sourceMappingURL=platform-stats.dto.d.ts.map

package/dist/types/platform-stats.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-stats.dto.d.ts","sourceRoot":"","sources":["../../src/types/platform-stats.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;CACzB"}