@lumiastream/ui 0.2.6 → 0.2.8-alpha.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ButtonProps } from '@mui/material/Button';
 import * as React from 'react';
-import { ReactNode, CSSProperties, JSX, HTMLAttributes } from 'react';
+import { ReactNode, CSSProperties, JSX, HTMLAttributes, ComponentType } from 'react';
 import { TextFieldProps } from '@mui/material/TextField';
 import { SelectProps } from '@mui/material/Select';
 import { CheckboxProps } from '@mui/material/Checkbox';
@@ -485,4 +485,379 @@ declare const resolvePlatformChatterProfileUrl: ({ platform, username, displayna
 declare const normalizeHttpUrl: (value: unknown) => string | null;
 declare const resolveChatterProfileUrlWithResolvers: ({ platform, username, displayname, userId, extraSettings, resolvers, }: ResolveChatterProfileUrlWithResolversInput) => Promise<string | null>;
 
-export { type BuildChatMessageContentOptions, type ChatMessageContentItem, type ChatMessageEmoteStore, type ChatMessageToken, type ChatMessageTokenizationOptions, type ChatboxMediaPreview, type ChatboxMediaPreviewKind, type ChatterProfileResolver, type ChatterProfileResolverPayload, type ChatterProfileUrlInput, type IVariables, LSButton, type LSButtonProps, LSCheckbox, LSCheckboxField, LSColorPicker, type LSColorPickerProps, LSFontPicker, LSInput, type LSInputProps$1 as LSInputProps, LSMultiSelect, LSRadio, LSRadioGroup, LSSelect, LSSliderInput, type LSInputProps as LSSliderInputProps, LSTextField, type LSTextFieldProps, type LSVariableInputContextValue, LSVariableInputField, type LSVariableInputFieldProps, LSVariableInputProvider, MEDIA_PREVIEW_USER_LEVEL_VALUES, type MediaPreviewRoleSettings, type MediaPreviewRoleSettingsInput, type MediaPreviewUserLevel, type MessageLinkPart, type ResolveChatterProfileUrlWithResolversInput, buildChatMessageContent, codeMirrorlinterOptions, getMediaPreviewFromUrl, getNormalizedUserLevels, isMediaPreviewAllowedForUser, normalizeHttpUrl, normalizeMediaPreviewUserLevels, parseMessageLinks, resolveChatterProfileUrlWithResolvers, resolveMediaPreviewRoleSettings, resolveMediaPreviewSetting, resolvePlatformChatterProfileUrl, tokenizeChatMessage, variableCompletionOptions };
+type ModuleType = 'alert' | 'emotebox' | 'emotealert' | 'text' | 'image' | 'audio' | 'video' | 'camera' | 'slideshow' | 'shape' | 'svg' | 'colorbox' | 'goal' | 'timer' | 'gradientlight' | 'browsersource' | 'chatbox' | 'credits' | 'eventlist' | 'eventrotate' | 'hfx' | 'hfxalert' | 'clip' | 'youtube' | 'spinwheel' | 'raffle' | 'viewerqueue' | 'loyaltyleaderboard' | 'viewerprofiles' | 'achievements' | 'poll' | 'tournaments' | 'spotify' | 'nowplaying' | 'youtubemusic' | 'brbscreen' | 'vlc' | 'tts' | 'livecaption' | 'custom' | 'group';
+type OverlayLayerType = 'layer' | 'group';
+type OverlayLayerBounds = {
+    height: number;
+    width: number;
+    x: number;
+    y: number;
+    scale: [number, number];
+    opacity?: number;
+    rotate?: number;
+    zIndex?: number;
+    matrix?: string;
+    clipPath?: string;
+};
+type OverlayLayerState = {
+    id: string;
+    group?: string | null;
+    type?: OverlayLayerType;
+    state: {
+        visible?: boolean;
+        locked?: boolean;
+        expanded?: boolean;
+    };
+    bounds: OverlayLayerBounds;
+};
+type OverlayModuleAlertState = {
+    events?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+type OverlayModuleState = {
+    id?: string;
+    loaded?: boolean;
+    version?: number;
+    settings?: {
+        title?: string | null;
+        type?: ModuleType;
+        locked?: boolean;
+    };
+    lights?: unknown[];
+    css?: Record<string, string | number>;
+    content?: Record<string, unknown>;
+    variables?: Record<string, unknown>;
+    events?: Record<string, unknown>;
+    alert?: OverlayModuleAlertState;
+};
+type OverlaySettings = {
+    layers: OverlayLayerState[];
+    metadata: {
+        width: number;
+        height: number;
+    };
+    modules: Record<string, OverlayModuleState>;
+};
+type OverlayState = {
+    uuid: string;
+    listen_id: string;
+    name: string;
+    description?: string;
+    settings: OverlaySettings;
+    metadata?: {
+        width: number | null;
+        height: number | null;
+    } | null;
+    layers_count?: number | null;
+    hasFullSettings?: boolean;
+};
+
+interface SEBootstrapResponse {
+    overlay: SEOverlay;
+    session?: unknown;
+    tipping?: unknown;
+    channel?: unknown;
+    passport?: unknown;
+}
+interface SEOverlay {
+    _id: string;
+    channel?: string;
+    type?: string;
+    name?: string;
+    settings: {
+        width: number;
+        height: number;
+        name?: string;
+    };
+    widgets: SEWidget[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface SEWidget {
+    id: number | string;
+    group?: string | null;
+    version?: number | string | null;
+    type: string;
+    name?: string | null;
+    visible?: boolean;
+    locked?: boolean;
+    listener?: string | null;
+    listeners?: Record<string, boolean> | string[] | null;
+    provider?: string;
+    css: SECss;
+    text?: SEText;
+    image?: SEImage;
+    video?: SEVideo;
+    audio?: SEAudio;
+    variables?: Record<string, unknown>;
+}
+interface SECss {
+    'z-index'?: number;
+    width: string | number;
+    height: string | number;
+    opacity?: number;
+    top?: string | number;
+    left?: string | number;
+}
+interface SEText {
+    type?: string;
+    value?: string | null;
+    enableShadow?: boolean;
+    scrolling?: {
+        direction?: string;
+        speed?: number;
+    };
+    css?: Record<string, unknown>;
+}
+interface SEImage {
+    type?: string;
+    src?: string;
+    css?: Record<string, unknown>;
+}
+interface SEVideo {
+    type?: string;
+    src?: string;
+    volume?: number;
+    css?: Record<string, unknown>;
+}
+interface SEAudio {
+    src?: string;
+    volume?: number;
+}
+interface ImportCoverage {
+    totalWidgets: number;
+    mappings: Array<{
+        seType: string;
+        lumiaType: string;
+        status: 'direct' | 'partial' | 'template' | 'placeholder';
+        count: number;
+    }>;
+    notes: string[];
+}
+interface ReviewItem {
+    moduleId: string;
+    seWidget: SEWidget;
+    status: 'placeholder' | 'template';
+    reason: string;
+    flaggedOff?: boolean;
+}
+
+/** Distinct SE CDN URLs referenced anywhere inside the overlay's settings. */
+declare function findSEAssetURLs(overlay: OverlayState): string[];
+/** Return a new overlay with every `oldUrl → newUrl` replacement applied. */
+declare function rewriteAssetURLs(overlay: OverlayState, mapping: Record<string, string>): OverlayState;
+interface AssetMirrorProgress {
+    url: string;
+    state: 'pending' | 'fetching' | 'uploading' | 'done' | 'failed';
+    newUrl?: string;
+    error?: string;
+}
+/**
+ * Mirror a single SE asset to Lumia storage via the existing `/overlays/assets`
+ * upload endpoint. Returns the new Lumia URL on success.
+ *
+ * The host call site is responsible for retries and progress reporting; this
+ * function is intentionally single-shot. Pass `signal` (AbortSignal) to abort
+ * the source-side `fetch` when the modal closes mid-mirror — the upload itself
+ * is consumer-defined and the caller decides whether/how to short-circuit it.
+ */
+declare function mirrorOneAsset(url: string, upload: (file: File) => Promise<{
+    asset: {
+        url: string;
+    };
+} | {
+    url: string;
+} | unknown>, signal?: AbortSignal): Promise<string>;
+declare function filenameFromURL(url: string): string;
+
+interface TransplantedUnit {
+    layer: OverlayLayerState;
+    module: OverlayModuleState;
+    extras?: Array<{
+        layer: OverlayLayerState;
+        module: OverlayModuleState;
+    }>;
+}
+declare function transplantLayer(source: OverlayState, sourceLayerId: string): TransplantedUnit | null;
+declare function listTransplantableLayers(source: OverlayState): Array<{
+    id: string;
+    label: string;
+    type: string;
+}>;
+
+declare const SE_WIDGET_TO_MARKETPLACE_CANDIDATES: Record<string, number[]>;
+declare function getMarketplaceCandidates(seWidgetType: string): number[];
+declare function hasMarketplaceCandidates(seWidgetType: string): boolean;
+
+declare const SE_IMPORT_FLAGS: {
+    readonly IMPORT_MERCH_PRODUCTS: false;
+    readonly IMPORT_SEASONAL: false;
+};
+declare function isWidgetFlaggedOff(seType: string): boolean;
+declare const FLAG_OFF_REASONS: Record<string, string>;
+
+interface SEAccountClaims {
+    channel: string;
+    user: string;
+    authToken: string;
+    provider: string;
+    provider_id: string;
+    role: string;
+    exp: number;
+    jti: string;
+    channel_id?: string;
+    user_id?: string;
+}
+type SEAuthErrorCode = 'invalid-jwt' | 'expired' | 'unauthorized' | 'forbidden';
+declare class SEAuthError extends Error {
+    code: SEAuthErrorCode;
+    constructor(code: SEAuthErrorCode, message: string);
+}
+declare function decodeJwtPayload(jwt: string): SEAccountClaims;
+declare class SEClient {
+    private readonly claims;
+    constructor(claims: SEAccountClaims);
+    static fromJwt(jwt: string): SEClient;
+    get channelId(): string;
+    get provider(): string;
+    get providerId(): string;
+    get userId(): string;
+    get jti(): string;
+    get expiresAt(): Date;
+    provenance(): {
+        jti: string;
+        channelId: string;
+        provider: string;
+        importedAt: string;
+    };
+    get<T>(path: string): Promise<T>;
+}
+interface SEChannelSummary {
+    _id: string;
+    provider: string;
+    providerId: string;
+    username: string;
+    alias?: string;
+    displayName?: string;
+    avatar?: string;
+    role?: string;
+    authorized?: boolean;
+    inactive?: boolean;
+    isPartner?: boolean;
+    broadcasterType?: string;
+}
+interface SEUsersCurrentResponse {
+    _id: string;
+    suspended?: boolean;
+    channels: SEChannelSummary[];
+}
+declare function fetchUsableChannels(client: SEClient): Promise<SEChannelSummary[]>;
+
+interface SEExistingAsset {
+    file_name?: string;
+    name?: string;
+    url: string;
+}
+interface SECustomEmbedProps {
+    codeId: string;
+    html: string;
+    css: string;
+    js: string;
+    data: unknown;
+}
+interface SEUploadAssetResult {
+    url: string;
+    file_name?: string;
+    name?: string;
+}
+interface SESaveOverlayBody {
+    name: string;
+    description?: string;
+    settings: OverlayState['settings'];
+}
+interface SEImportBindings {
+    fetchMarketplaceOverlay: (id: number) => Promise<OverlayState>;
+    generateAICustomCode: (prompt: string) => Promise<AIGeneratedCustomOverlay>;
+    uploadAsset: (file: File) => Promise<SEUploadAssetResult>;
+    existingAssets: SEExistingAsset[];
+    saveOverlay: (body: SESaveOverlayBody) => Promise<{
+        uuid: string;
+    }>;
+    onComplete: (result: {
+        overlayId: string;
+    }) => void;
+    onClose: () => void;
+    notify: {
+        success: (msg: string) => void;
+        error: (msg: string) => void;
+        warning: (msg: string) => void;
+    };
+    CustomEmbed?: ComponentType<SECustomEmbedProps>;
+    t?: (key: string) => string | undefined;
+    onAuthError?: (err: SEAuthError) => void;
+}
+
+interface SEImportWizardProps {
+    bindings: SEImportBindings;
+    initialUrl?: string;
+}
+declare function SEImportWizard({ bindings, initialUrl, }: SEImportWizardProps): react_jsx_runtime.JSX.Element;
+
+interface MarketplacePickerProps {
+    seWidgetType: string;
+    fetchMarketplaceOverlay: SEImportBindings['fetchMarketplaceOverlay'];
+    CustomEmbed?: SEImportBindings['CustomEmbed'];
+    onPick: (transplant: {
+        layer: OverlayLayerState;
+        module: OverlayModuleState;
+    }) => void;
+    onCancel: () => void;
+}
+declare function MarketplacePicker({ seWidgetType, fetchMarketplaceOverlay, CustomEmbed, onPick, onCancel }: MarketplacePickerProps): react_jsx_runtime.JSX.Element;
+
+interface ImportResult {
+    overlay: OverlayState;
+    coverage: ImportCoverage;
+    reviewItems: ReviewItem[];
+}
+declare function extractSEOverlayId(input: string): string | null;
+declare function extractSEPreviewParts(input: string): {
+    overlayId: string;
+    apikey: string;
+} | null;
+declare function buildBootstrapUrl(overlayId: string): string;
+declare function fetchSEBootstrap({ overlayId, apikey }: {
+    overlayId: string;
+    apikey: string;
+}): Promise<SEBootstrapResponse>;
+declare function isSEBootstrap(value: unknown): value is SEBootstrapResponse;
+declare function importSEBootstrap(bootstrap: SEBootstrapResponse): ImportResult;
+interface AIGeneratedCustomOverlay {
+    codeId?: string;
+    html?: string;
+    css?: string;
+    js?: string;
+    data?: unknown;
+    configs?: unknown;
+}
+declare function applyReviewAction(result: ImportResult, moduleId: string, action: 'keep' | 'skip' | 'ai' | 'marketplace', payload?: AIGeneratedCustomOverlay | {
+    layer: OverlayLayerState;
+    module: OverlayModuleState;
+    extras?: Array<{
+        layer: OverlayLayerState;
+        module: OverlayModuleState;
+    }>;
+}): ImportResult;
+declare function getAILandingBounds(widget: SEWidget, canvas?: {
+    width: number;
+    height: number;
+}): {
+    width: number;
+    height: number;
+};
+declare function buildAIPromptForSEWidget(widget: SEWidget, canvas?: {
+    width: number;
+    height: number;
+}): string;
+
+export { type AIGeneratedCustomOverlay, type AssetMirrorProgress, type BuildChatMessageContentOptions, type ChatMessageContentItem, type ChatMessageEmoteStore, type ChatMessageToken, type ChatMessageTokenizationOptions, type ChatboxMediaPreview, type ChatboxMediaPreviewKind, type ChatterProfileResolver, type ChatterProfileResolverPayload, type ChatterProfileUrlInput, FLAG_OFF_REASONS, type IVariables, type ImportCoverage, type ImportResult, LSButton, type LSButtonProps, LSCheckbox, LSCheckboxField, LSColorPicker, type LSColorPickerProps, LSFontPicker, LSInput, type LSInputProps$1 as LSInputProps, LSMultiSelect, LSRadio, LSRadioGroup, LSSelect, LSSliderInput, type LSInputProps as LSSliderInputProps, LSTextField, type LSTextFieldProps, type LSVariableInputContextValue, LSVariableInputField, type LSVariableInputFieldProps, LSVariableInputProvider, MEDIA_PREVIEW_USER_LEVEL_VALUES, MarketplacePicker, type MarketplacePickerProps, type MediaPreviewRoleSettings, type MediaPreviewRoleSettingsInput, type MediaPreviewUserLevel, type MessageLinkPart, type ModuleType, type OverlayLayerBounds, type OverlayLayerState, type OverlayLayerType, type OverlayModuleAlertState, type OverlayModuleState, type OverlaySettings, type OverlayState, type ResolveChatterProfileUrlWithResolversInput, type ReviewItem, type SEAccountClaims, SEAuthError, type SEAuthErrorCode, type SEBootstrapResponse, type SEChannelSummary, SEClient, type SECustomEmbedProps, type SEExistingAsset, type SEImportBindings, SEImportWizard, type SEImportWizardProps, type SESaveOverlayBody, type SEUploadAssetResult, type SEUsersCurrentResponse, type SEWidget, SE_IMPORT_FLAGS, SE_WIDGET_TO_MARKETPLACE_CANDIDATES, type TransplantedUnit, applyReviewAction, buildAIPromptForSEWidget, buildBootstrapUrl, buildChatMessageContent, codeMirrorlinterOptions, decodeJwtPayload, extractSEOverlayId, extractSEPreviewParts, fetchSEBootstrap, fetchUsableChannels, filenameFromURL, findSEAssetURLs, getAILandingBounds, getMarketplaceCandidates, getMediaPreviewFromUrl, getNormalizedUserLevels, hasMarketplaceCandidates, importSEBootstrap, isMediaPreviewAllowedForUser, isSEBootstrap, isWidgetFlaggedOff, listTransplantableLayers, mirrorOneAsset, normalizeHttpUrl, normalizeMediaPreviewUserLevels, parseMessageLinks, resolveChatterProfileUrlWithResolvers, resolveMediaPreviewRoleSettings, resolveMediaPreviewSetting, resolvePlatformChatterProfileUrl, rewriteAssetURLs, tokenizeChatMessage, transplantLayer, variableCompletionOptions };