@gala-chain/launchpad-sdk 5.1.1 → 7.0.0-beta.1

package/dist/src/types/api-key.dto.d.ts

@@ -1,373 +0,0 @@
-/**
- * API Key Types and DTOs
- *
- * Type definitions for user-managed API keys with role-based permissions.
- * API keys enable delegation of specific permissions to third-party services
- * or automated systems.
- *
- * @since 5.6.0
- * @category Types
- * @module api-key
- */
-import type { PageInfo } from './common';
-/**
- * API Key Role Values
- *
- * Hierarchical roles determining permissions:
- * - OWNER: Full access (indistinguishable from normal auth)
- * - MANAGER: Moderator + Technical Producer + recordings + stream settings
- * - TECHNICAL_PRODUCER: Simulcast targets, stream key, stop/start stream
- * - MODERATOR: Manage comments, chat messages, ban/unban users
- */
-export declare const API_KEY_ROLE: {
-    /** Manage comments, chat messages, ban/unban users */
-    readonly MODERATOR: "MODERATOR";
-    /** Setup simulcast targets, get stream key, stop/start stream, prep work */
-    readonly TECHNICAL_PRODUCER: "TECHNICAL_PRODUCER";
-    /** Overseer: Moderator + Technical Producer + recordings + stream settings */
-    readonly MANAGER: "MANAGER";
-    /** Full access, indistinguishable from normal auth session */
-    readonly OWNER: "OWNER";
-};
-/**
- * API Key Role Type
- */
-export type ApiKeyRole = (typeof API_KEY_ROLE)[keyof typeof API_KEY_ROLE];
-/**
- * All available API key roles as an array (for validation)
- */
-export declare const API_KEY_ROLES: ApiKeyRole[];
-/**
- * API Key permission enumeration
- *
- * Fine-grained permissions that can be assigned to API keys.
- * Permissions vary based on the role assigned to the key.
- *
- * @since 6.x.0
- */
-export declare const API_KEY_PERMISSION: {
-    /** Manage comments (create/delete) */
-    readonly MANAGE_COMMENTS: "MANAGE_COMMENTS";
-    /** Manage chat messages (send/delete) */
-    readonly MANAGE_CHAT: "MANAGE_CHAT";
-    /** Ban users from streams */
-    readonly BAN_USERS: "BAN_USERS";
-    /** Unban users from streams */
-    readonly UNBAN_USERS: "UNBAN_USERS";
-    /** Manage simulcast targets */
-    readonly MANAGE_SIMULCAST: "MANAGE_SIMULCAST";
-    /** Get stream key */
-    readonly GET_STREAM_KEY: "GET_STREAM_KEY";
-    /** Stop active stream */
-    readonly STOP_STREAM: "STOP_STREAM";
-    /** Reset stream key */
-    readonly RESET_STREAM_KEY: "RESET_STREAM_KEY";
-    /** Start new stream */
-    readonly START_STREAM: "START_STREAM";
-    /** Delete stream recordings */
-    readonly DELETE_RECORDINGS: "DELETE_RECORDINGS";
-    /** Manage stream settings (countdown, language) */
-    readonly MANAGE_STREAM_SETTINGS: "MANAGE_STREAM_SETTINGS";
-};
-export type ApiKeyPermissionType = (typeof API_KEY_PERMISSION)[keyof typeof API_KEY_PERMISSION];
-/**
- * Consolidated Permission System (v5.8.0)
- *
- * Fine-grained permissions consolidated into 5 logical groupings:
- * - MANAGE_COMMUNITY: Chat/comments moderation + banning
- * - MANAGE_STREAM: Stream operations (start/stop, credentials, simulcasts)
- * - MANAGE_SETTINGS: Token profile, branding, scheduling, toggles
- * - MANAGE_RECORDINGS: Recording view/delete/download
- * - VIEW_ANALYTICS: Analytics access
- *
- * Used for per-token permission overrides in API keys.
- *
- * @since 5.8.0
- */
-export declare const PERMISSION: {
-    /** Community moderation (chat, comments, banning) */
-    readonly MANAGE_COMMUNITY: "MANAGE_COMMUNITY";
-    /** Stream operations (start/stop, credentials, simulcasts) */
-    readonly MANAGE_STREAM: "MANAGE_STREAM";
-    /** Token settings (socials, description, image, language, countdown, toggles) */
-    readonly MANAGE_SETTINGS: "MANAGE_SETTINGS";
-    /** Recording management (view, delete, download) */
-    readonly MANAGE_RECORDINGS: "MANAGE_RECORDINGS";
-    /** Analytics access */
-    readonly VIEW_ANALYTICS: "VIEW_ANALYTICS";
-};
-/**
- * Permission type for consolidated permission system.
- * @since 5.8.0
- */
-export type Permission = (typeof PERMISSION)[keyof typeof PERMISSION];
-/**
- * All valid permission values as an array (for validation).
- * @since 5.8.0
- */
-export declare const ALL_PERMISSIONS: Permission[];
-/**
- * Options for creating a new API key.
- *
- * @example
- * ```typescript
- * const options: CreateApiKeyOptions = {
- *   role: 'MODERATOR',
- *   description: 'Chat moderation bot',
- *   delegateAllTokens: false,
- *   tokenNames: ['mytoken', 'othertoken'],
- *   expiresAt: '2025-12-31T23:59:59Z'
- * };
- * ```
- */
-export interface CreateApiKeyOptions {
-    /**
-     * Role determining permissions for this API key.
-     * Required.
-     */
-    role: ApiKeyRole;
-    /**
-     * User's description/label for this API key.
-     * Max 255 characters.
-     */
-    description?: string;
-    /**
-     * If true, key has access to ALL tokens owned by the user (current and future).
-     * If false, only tokens in `tokenNames` are accessible.
-     * @default false
-     */
-    delegateAllTokens?: boolean;
-    /**
-     * Specific tokens to delegate access to.
-     * Ignored if `delegateAllTokens` is true.
-     * Token names are case-insensitive.
-     */
-    tokenNames?: string[];
-    /**
-     * Optional expiration date in ISO 8601 format.
-     * If not provided, key never expires.
-     * @example "2025-12-31T23:59:59Z"
-     */
-    expiresAt?: string;
-    /**
-     * Per-token permission overrides. Maps tokenName to Permission[].
-     * Only applies to tokens in tokenNames. Tokens not in this map
-     * use the API key's role-based default permissions.
-     *
-     * @example { "mytoken": ["MANAGE_COMMUNITY"] }
-     * @since 5.8.0
-     */
-    tokenPermissions?: Record<string, Permission[]>;
-}
-/**
- * Options for updating an existing API key.
- * All fields are optional - only provided fields are updated.
- *
- * @example
- * ```typescript
- * // Update description and add more tokens
- * const updates: UpdateApiKeyOptions = {
- *   description: 'Updated description',
- *   tokenNames: ['token1', 'token2', 'token3']
- * };
- *
- * // Upgrade role and extend expiration
- * const roleUpdate: UpdateApiKeyOptions = {
- *   role: 'MANAGER',
- *   expiresAt: '2026-12-31T23:59:59Z'
- * };
- * ```
- */
-export interface UpdateApiKeyOptions {
-    /**
-     * New role for the API key.
-     */
-    role?: ApiKeyRole;
-    /**
-     * Updated description/label.
-     * Max 255 characters.
-     */
-    description?: string;
-    /**
-     * If true, key has access to ALL tokens owned by the user.
-     */
-    delegateAllTokens?: boolean;
-    /**
-     * Updated list of specific tokens to delegate.
-     * Replaces existing token delegations.
-     */
-    tokenNames?: string[];
-    /**
-     * Updated expiration date in ISO 8601 format.
-     * Pass null to remove expiration.
-     */
-    expiresAt?: string | null;
-    /**
-     * Per-token permission overrides. Maps tokenName to Permission[].
-     * Replaces existing per-token permissions for the specified tokens.
-     * @since 5.8.0
-     */
-    tokenPermissions?: Record<string, Permission[]>;
-}
-/**
- * Pagination options for listing API keys.
- * Uses cursor-based pagination for efficient navigation.
- * @updated 8.1.0 - Migrated to cursor-based pagination
- */
-export interface ListApiKeysOptions {
-    /**
-     * Cursor token for fetching the next page (omit for first page).
-     * Use the `nextCursor` from the previous response's `pageInfo`.
-     */
-    cursor?: string;
-    /**
-     * Page size for pagination (defaults to 50, max 100).
-     * The maximum allowed page size is 100 items per page.
-     * @default 50
-     */
-    pageSize?: number;
-}
-/**
- * Source type indicating how the API key holder relates to their tokens.
- * OWNER = key holder owns the tokens directly.
- * MODERATOR = key holder only has moderator access to tokens.
- */
-export type ApiKeySource = 'OWNER' | 'MODERATOR';
-/**
- * API key data returned in responses.
- * Note: The raw key is NOT included - it's only returned on creation.
- */
-export interface ApiKeyData {
-    /** Unique identifier */
-    id: number;
-    /** First 8 characters for identification (e.g., "glp_abc1") */
-    keyPrefix: string;
-    /** User's description/label */
-    description: string | null;
-    /** Role determining permissions */
-    role: ApiKeyRole;
-    /**
-     * Indicates whether the key holder owns tokens (OWNER) or only has moderator access (MODERATOR).
-     * @since 9.1.0
-     */
-    sourceType: ApiKeySource;
-    /** Whether key has access to all owner's tokens */
-    delegateAllTokens: boolean;
-    /** List of specifically delegated token names (null if delegateAllTokens is true) */
-    tokenNames: string[] | null;
-    /**
-     * Per-token permission overrides (null if no overrides set).
-     * Maps tokenName to Permission[].
-     * @since 5.8.0
-     */
-    tokenPermissions?: Record<string, Permission[]> | null;
-    /** Expiration timestamp (ISO 8601) or null if never expires */
-    expiresAt: string | null;
-    /** Last time key was used (ISO 8601) or null if never used */
-    lastUsedAt: string | null;
-    /** Creation timestamp (ISO 8601) */
-    createdAt: string;
-    /** Last update timestamp (ISO 8601) */
-    updatedAt: string;
-}
-/**
- * Response when creating a new API key.
- * CRITICAL: `rawKey` is ONLY returned on creation and never again!
- *
- * @example
- * ```typescript
- * const result = await sdk.createApiKey({ role: 'MODERATOR' });
- * console.log('Save this key:', result.rawKey); // Only chance to see it!
- * // rawKey format: "glp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
- * ```
- */
-export interface CreateApiKeyResponse extends ApiKeyData {
-    /**
-     * The full API key - ONLY shown once on creation!
-     * Format: glp_{base64url_encoded_random_bytes}
-     * Example: "glp_abc1234defghijklmnopqrstuvwxyz012345678"
-     *
-     * CRITICAL: Store this securely - it cannot be retrieved again!
-     */
-    rawKey: string;
-}
-/**
- * Paginated list of API keys.
- */
-export interface ApiKeyListResponse {
-    /** Array of API key data */
-    apiKeys: ApiKeyData[];
-    /** Pagination metadata */
-    pageInfo: PageInfo;
-}
-/**
- * Check if a string is a valid API key role.
- *
- * @param role - The role string to validate
- * @returns True if the role is valid
- *
- * @example
- * ```typescript
- * isValidApiKeyRole('MODERATOR') // true
- * isValidApiKeyRole('ADMIN')     // false
- * ```
- */
-export declare function isValidApiKeyRole(role: string): role is ApiKeyRole;
-/**
- * Validate CreateApiKeyOptions.
- *
- * @param options - The options to validate
- * @returns Array of validation error messages (empty if valid)
- *
- * @example
- * ```typescript
- * const errors = validateCreateApiKeyOptions({ role: 'INVALID' });
- * if (errors.length > 0) {
- *   console.error('Validation failed:', errors);
- * }
- * ```
- */
-export declare function validateCreateApiKeyOptions(options: CreateApiKeyOptions): string[];
-/**
- * Validate UpdateApiKeyOptions.
- *
- * @param options - The options to validate
- * @returns Array of validation error messages (empty if valid)
- */
-export declare function validateUpdateApiKeyOptions(options: UpdateApiKeyOptions): string[];
-/**
- * Validate ListApiKeysOptions.
- *
- * @param options - The options to validate
- * @throws ValidationError if pagination parameters are invalid
- *
- * @example
- * ```typescript
- * validateListApiKeysOptions({ pageSize: 20, cursor: 'abc123' });
- * // No error - valid options
- * ```
- *
- * @updated 8.1.0 - Migrated to cursor-based pagination validation
- */
-export declare function validateListApiKeysOptions(options: ListApiKeysOptions): void;
-/**
- * API key role hierarchy for permission checks.
- * Higher index = more permissions.
- */
-export declare const API_KEY_ROLE_HIERARCHY: Record<ApiKeyRole, number>;
-/**
- * Check if a role has sufficient permissions for another role.
- *
- * @param actualRole - The role the API key has
- * @param requiredRole - The minimum role required
- * @returns True if actualRole >= requiredRole in hierarchy
- *
- * @example
- * ```typescript
- * roleHasSufficientPermission('OWNER', 'MODERATOR')   // true
- * roleHasSufficientPermission('MODERATOR', 'MANAGER') // false
- * roleHasSufficientPermission('MANAGER', 'TECHNICAL_PRODUCER') // true
- * ```
- */
-export declare function roleHasSufficientPermission(actualRole: ApiKeyRole, requiredRole: ApiKeyRole): boolean;
-//# sourceMappingURL=api-key.dto.d.ts.map

package/dist/src/types/api-key.dto.d.ts.map

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

package/dist/src/types/backend-responses.d.ts

@@ -1,235 +0,0 @@
-/**
- * Backend Response Interfaces
- *
- * Type definitions for raw backend API responses before normalization.
- * These interfaces capture the various response formats the backend API
- * returns, enabling type-safe response normalization.
- *
- * @category Types
- * @since 3.12.0
- */
-import type { PoolData } from './launchpad.dto';
-import type { TradeInfo } from './trade.dto';
-import type { UserTokenInfo } from './user.dto';
-/**
- * Backend pool response format - handles three variations:
- * 1. Single token: { tokens: PoolData }
- * 2. Multiple tokens: { tokens: PoolData[] }
- * 3. Legacy format: { pools: PoolData[] }
- */
-export interface BackendPoolResponse {
-    /** Single pool data or array of pools (modern format) */
-    tokens?: PoolData | PoolData[];
-    /** Array of pools (legacy format) */
-    pools?: PoolData[];
-    /** Total count field from backend (not "total") */
-    count?: number;
-    /** Optional pagination fields (rarely provided by backend) */
-    page?: number;
-    limit?: number;
-    total?: number;
-    totalPages?: number;
-}
-/**
- * Raw pool item from backend (before date normalization)
- */
-export interface RawBackendPool {
-    id: string;
-    tokenName: string;
-    symbol: string;
-    description: string;
-    amount: string;
-    creatorAddress: string;
-    vaultAddress: string;
-    /** Backend returns created_at as string or createdAt */
-    created_at?: string;
-    createdAt?: string;
-    /** Optional reverse bonding curve fee fields */
-    reverseBondingCurveMinFeePortion?: string;
-    reverseBondingCurveMaxFeePortion?: string;
-    hasReverseBondingCurveFee?: boolean;
-    image: string;
-    websiteUrl: string;
-    telegramUrl: string;
-    twitterUrl: string;
-    instagramUrl: string;
-    facebookUrl: string;
-    redditUrl: string;
-    tiktokUrl: string;
-    initialBuyAmount: number;
-    volume: string;
-    volume1h: string;
-    galaPrice: string;
-    galaInPool: string;
-    usdPrice: string;
-    marketCapUsd: string;
-    marketCapGala: string;
-    circulatingSupply: string;
-    deltaSupply: string;
-    isGraduated: boolean;
-    isFinalized: boolean;
-    bondingCurvePercentage: string;
-    /** Current viewer count for active streams */
-    currentViewerCount?: number;
-    /** Highest viewer count during current/last stream session */
-    peakViewerCount?: number;
-    /** Timestamp when stream status changed to ACTIVE (ISO 8601) */
-    streamStartedAt?: string | null;
-    /** Timestamp when the pool last had an active stream (ISO 8601) */
-    lastStreamedAt?: string | null;
-    /** Additional pool metadata - use unknown for type safety, narrow with type guards when accessing */
-    [key: string]: unknown;
-}
-/**
- * Backend trade response format - handles two variations:
- * 1. Direct array: TradeInfo[]
- * 2. Wrapped object: { trades: TradeInfo[] }
- */
-export type BackendTradeResponse = TradeInfo[] | {
-    trades: TradeInfo[];
-    /** Optional pagination metadata */
-    page?: number;
-    limit?: number;
-    total?: number;
-    totalPages?: number;
-    hasNextPage?: boolean;
-    hasPrevPage?: boolean;
-};
-/**
- * Raw trade item from backend (before date normalization)
- */
-export interface RawBackendTrade {
-    id: string;
-    userAddress: string;
-    tradeType: 'buy' | 'sell';
-    tokenAmount: string;
-    vaultAddress: string;
-    /** Backend returns timestamps as strings */
-    createdAt: string;
-    updatedAt: string;
-    slippageTolerance?: string;
-    deadline?: number;
-    /** Additional trade metadata - use unknown for type safety, narrow with type guards when accessing */
-    [key: string]: unknown;
-}
-/**
- * Backend token list response format - handles two variations:
- * 1. Direct array: UserTokenInfo[]
- * 2. Wrapped object: { token: UserTokenInfo[] }
- */
-export type BackendTokenListResponse = UserTokenInfo[] | {
-    token: UserTokenInfo[];
-    /** Optional pagination metadata */
-    count?: number;
-    page?: number;
-    limit?: number;
-    total?: number;
-    totalPages?: number;
-};
-/**
- * Raw token item from backend (before date normalization)
- */
-export interface RawBackendToken {
-    id: string;
-    name: string;
-    symbol: string;
-    type: 'all' | 'DEFI' | 'ASSET';
-    address: string;
-    balance: string;
-    decimals: number;
-    metadata?: {
-        description?: string;
-        image?: string;
-        /** Additional nested metadata - use unknown for type safety */
-        [key: string]: unknown;
-    };
-    /** Backend returns timestamps as strings */
-    createdAt: string;
-    updatedAt: string;
-    /** Additional token metadata - use unknown for type safety, narrow with type guards when accessing */
-    [key: string]: unknown;
-}
-/**
- * Raw pagination metadata from backend responses
- * Different endpoints return different field combinations
- */
-export interface RawPaginationMetadata {
-    /** Current page (string or number) */
-    page?: string | number;
-    /** Items per page (string or number) */
-    limit?: string | number;
-    /** Total items (string or number) */
-    total?: string | number;
-    /** Total items via count field (backend preference) */
-    count?: string | number;
-    /** Total pages (rarely provided) */
-    totalPages?: string | number;
-    /** Next page flag */
-    hasNextPage?: boolean;
-    /** Previous page flag */
-    hasPrevPage?: boolean;
-    /** Has next (alternative naming) */
-    hasNext?: boolean;
-    /** Has previous (alternative naming) */
-    hasPrevious?: boolean;
-}
-/**
- * Normalized pagination metadata
- */
-export interface NormalizedPaginationMetadata {
-    /** Zero-based offset */
-    offset: number;
-    /** Items per page */
-    limit: number;
-    /** Total number of items */
-    total: number;
-    /** Total number of pages (calculated) */
-    totalPages: number;
-}
-/**
- * Pagination navigation flags
- */
-export interface PaginationFlags {
-    /** Whether there is a next page */
-    hasNext: boolean;
-    /** Whether there is a previous page */
-    hasPrevious: boolean;
-}
-/**
- * Default pagination values
- */
-export interface PaginationDefaults {
-    /** Default offset */
-    offset: number;
-    /** Default items per page */
-    limit: number;
-}
-/**
- * Type guard to check if response is a wrapped pool response with tokens field
- */
-export declare function isWrappedPoolResponse(response: unknown): response is {
-    tokens: PoolData | PoolData[];
-};
-/**
- * Type guard to check if response is a legacy pool response with pools field
- */
-export declare function isLegacyPoolResponse(response: unknown): response is {
-    pools: PoolData[];
-};
-/**
- * Type guard to check if trade response is wrapped with trades field
- */
-export declare function isWrappedTradeResponse(response: unknown): response is {
-    trades: TradeInfo[];
-};
-/**
- * Type guard to check if token response is wrapped with token field
- */
-export declare function isWrappedTokenResponse(response: unknown): response is {
-    token: UserTokenInfo[];
-};
-/**
- * Type guard to check if response has pagination metadata
- */
-export declare function hasPaginationMetadata(response: unknown): response is RawPaginationMetadata;
-//# sourceMappingURL=backend-responses.d.ts.map

package/dist/src/types/backend-responses.d.ts.map

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