@series-inc/rundot-game-sdk 5.17.0 → 5.18.0

package/README.md

@@ -26,7 +26,7 @@ await RundotGameAPI.initializeAsync()
 
 ## Documentation
 
-The complete RUN.game SDK manuals live on [Run.game Docs](https://series-1.gitbook.io/getreel-docs). Start there for setup guides, API references, tutorials, and best practices.
+The complete RUN.game SDK manuals live on [Run.game Docs](https://series-1.gitbook.io/rundot-docs). Start there for setup guides, API references, tutorials, and best practices.
 
 ## Support & Links
 

package/dist/{AdsApi-WlnMwXKa.d.ts → AdsApi-Bd_OGDEt.d.ts}

@@ -1,4 +1,4 @@
-import { H as LeaderboardApi, I as ImageGenApi, A as AudioGenApi, V as VideoGenApi, q as SpriteGenApi, T as ThreeDGenApi } from './LeaderboardApi--NKuV2tJ.js';
+import { H as LeaderboardApi, I as ImageGenApi, A as AudioGenApi, V as VideoGenApi, q as SpriteGenApi, T as ThreeDGenApi } from './LeaderboardApi-BKte9LP0.js';
 
 interface StorageApi {
     key(index: number): Promise<string | null>;
@@ -30,6 +30,10 @@ interface RpcResponse {
     result?: any;
     error?: {
         message: string;
+        /** Machine-readable error code (e.g. THREE_D_GEN_PROVIDER_REJECTED), when the host provides one. */
+        code?: string;
+        /** Human-readable cause from an upstream provider, when available. */
+        detail?: string;
         stack?: string;
     };
 }
@@ -216,7 +220,7 @@ interface ScheduleLocalNotification {
     payload?: Record<string, any>;
     trigger?: NotificationTriggerInput;
 }
-type RCSAvailabilityReason = 'not_subscribed' | 'no_phone' | 'feature_disabled' | 'unknown';
+type RCSAvailabilityReason = 'needs_consent' | 'no_phone' | 'feature_disabled' | 'unknown';
 interface RCSAvailabilityStatus {
     available: boolean;
     reason?: RCSAvailabilityReason;
@@ -224,13 +228,66 @@ interface RCSAvailabilityStatus {
 interface ScheduleRCSInput {
     title: string;
     body: string;
+    /** Opaque continuation id; platform resolves to OneLink at send time. */
     ctaUrl?: string;
+    /** Hydrated into H5 notificationParams when the user taps the message CTA. */
+    continuationParams?: Record<string, string>;
     image?: string;
+    /** ISO8601 UTC; mutually exclusive with delaySeconds */
+    triggerAt?: string;
+    /** Seconds from now; mutually exclusive with triggerAt; max 7 days */
+    delaySeconds?: number;
 }
-type ScheduleRCSStatus = 'pending' | 'sent' | 'dry_run';
+type ScheduleRCSStatus = 'pending' | 'sent' | 'dry_run' | 'failed';
 interface ScheduleRCSResult {
     scheduleId: string;
     status: ScheduleRCSStatus;
+    /**
+     * Reserved for a future schedule-status API. Not returned by
+     * `scheduleRCSAsync` in v1 (rate-cap deferral is handled internally at
+     * dispatch time).
+     */
+    estimatedSendAt?: string;
+}
+/**
+ * Optional inputs for `requestRCSOptInAsync`. The host modal interpolates
+ * `rewardCopy` into the heading shown to the user (e.g. "Get 100 gems —
+ * never miss a {{gameName}} update."). When omitted, the modal falls back
+ * to a generic copy.
+ */
+interface RequestRCSOptInInput {
+    rewardCopy?: string;
+}
+/**
+ * Outcome of the opt-in flow as far as the game is concerned. The host
+ * resolves to one of these AFTER the user closes / completes the modal:
+ *
+ * - `subscribed`            — user is now subscribed (newly opted-in OR
+ *                              previously confirmed) and reachable.
+ * - `already_subscribed`    — user was already subscribed, no action taken.
+ * - `pending_confirmation`  — user submitted; awaiting Braze double opt-in
+ *                              SMS reply ("Y"). Game should not assume the
+ *                              user is reachable yet — re-check with
+ *                              `getRCSAvailableAsync` later.
+ * - `declined`              — user dismissed the modal ("Maybe later" /
+ *                              "I'll do it later"). No backend call made.
+ */
+type RCSOptInStatus = 'already_subscribed' | 'subscribed' | 'declined' | 'pending_confirmation';
+interface RequestRCSOptInResult {
+    status: RCSOptInStatus;
+    /**
+     * `true` only when this call completes with `status === 'subscribed'` because
+     * the user newly confirmed opt-in (typically: modal stayed open through the
+     * pending state until Braze double opt-in succeeded). Useful for one-shot
+     * rewards.
+     *
+     * `false` for `already_subscribed`, `pending_confirmation`, and `declined`.
+     * If the user dismisses while pending and replies "Y" later, a second call
+     * returns `already_subscribed` with `newlySubscribed: false` — games should
+     * not grant a reward in that case unless they track confirmation themselves
+     * (e.g. poll `getRCSAvailableAsync`).
+     */
+    newlySubscribed: boolean;
 }
 interface NotificationsApi {
     scheduleAsync(title: string, body: string, seconds: number, notificationId?: string, options?: ScheduleNotificationOptions): Promise<string | null>;
@@ -240,6 +297,13 @@ interface NotificationsApi {
     setLocalNotificationsEnabled(enabled: boolean): Promise<boolean>;
     getRCSAvailableAsync(): Promise<RCSAvailabilityStatus>;
     scheduleRCSAsync(input: ScheduleRCSInput): Promise<ScheduleRCSResult>;
+    /**
+     * Trigger the platform-owned RCS opt-in modal. The host shows one of the
+     * three modal states depending on whether the user has a phone on file and
+     * is already subscribed, then resolves with the outcome above. Games should
+     * call this in response to a user gesture (TCPA), not as a passive prompt.
+     */
+    requestRCSOptInAsync(input?: RequestRCSOptInInput): Promise<RequestRCSOptInResult>;
 }
 
 interface ShowToastOptions {
@@ -1312,6 +1376,8 @@ interface RundotGameMessage {
         value?: any;
         data?: any;
         error?: string;
+        errorCode?: string;
+        errorDetail?: string;
         script?: string;
     };
     instanceId: string;
@@ -1587,6 +1653,12 @@ interface UgcEntry {
     authorId: string;
     authorName: string;
     authorAvatarUrl: string | null;
+    /**
+     * Profile IDs permitted to edit this entry, in addition to authorId.
+     * Member-scoped: populated in member reads (get-as-member, listMine, listShared)
+     * and listCollaborators; discovery surfaces (browse, getMany) return [].
+     */
+    editorIds: string[];
     contentType: string;
     data: Record<string, unknown>;
     createdAt: number;
@@ -1668,6 +1740,16 @@ interface UgcListResponse {
     entries: UgcEntry[];
     nextCursor?: string;
 }
+interface UgcCollaboratorParams {
+    /** Entry to manage collaborators on. */
+    entryId: string;
+    /** Profile ID of the collaborator to add/remove. */
+    profileId: string;
+}
+interface UgcMembersResponse {
+    authorId: string;
+    editorIds: string[];
+}
 interface UgcBrowseResponse {
     entries: Array<UgcEntry & {
         isLikedByMe?: boolean;
@@ -1832,6 +1914,30 @@ interface UgcApi {
      * @returns Paginated list of entries with isLikedByMe status
      */
     browse(params?: UgcBrowseParams): Promise<UgcBrowseResponse>;
+    /**
+     * List entries shared with the current user (where they are an editor).
+     * Mirrors listMine but for collaborator (not author) relationships.
+     * @param params List parameters (optional filtering and pagination)
+     * @returns Paginated list of entries
+     */
+    listShared(params?: UgcListParams): Promise<UgcListResponse>;
+    /**
+     * Add a collaborator (editor) to an entry. Author-only.
+     * Idempotent; adding the author or an existing editor is a no-op.
+     * @param params Entry ID and the collaborator's profile ID
+     */
+    addCollaborator(params: UgcCollaboratorParams): Promise<void>;
+    /**
+     * Remove a collaborator from an entry. Author-only, or self-leave.
+     * @param params Entry ID and the collaborator's profile ID
+     */
+    removeCollaborator(params: UgcCollaboratorParams): Promise<void>;
+    /**
+     * List the author + editors of an entry. Readable by any member.
+     * @param entryId Entry ID
+     * @returns The author ID and editor profile IDs
+     */
+    listCollaborators(entryId: string): Promise<UgcMembersResponse>;
     /**
      * Like an entry
      * @param id Entry ID to like
@@ -2352,6 +2458,112 @@ interface FilesApi {
     getCompletedJobs(): Promise<FilesJobEvent[]>;
 }
 
+/** Canonical UGC contentType for recorded gameplay clips — the de-facto "clips collection". */
+declare const CLIP_CONTENT_TYPE = "clip";
+interface ClipAudioOptions {
+    /** Capture the player's microphone. Default true. Gated by capture consent (T2 and below). */
+    microphone?: boolean;
+    /** Capture game audio (requires useGameAudio to have registered a node). Default true. */
+    gameAudio?: boolean;
+}
+type ClipPipPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+interface ClipPipLayout {
+    position?: ClipPipPosition;
+    widthFraction?: number;
+}
+interface ClipCameraOptions {
+    facingMode?: 'user' | 'environment';
+    pip?: ClipPipLayout;
+}
+interface StartClipRecordingOptions {
+    /** The game canvas to record. Element, CSS selector, or omitted to auto-detect the first <canvas>. */
+    canvas?: HTMLCanvasElement | string;
+    fps?: number;
+    /** Auto-stop after this many ms (default 60000). */
+    maxDurationMs?: number;
+    /** Audio knobs; both default on. Omit for game audio + mic. */
+    audio?: ClipAudioOptions;
+    /**
+     * Enable webcam PiP overlay. `true` → front camera, bottom-right 25%.
+     * Pass `ClipCameraOptions` for custom facing mode / layout.
+     * Default `false` (no camera).
+     */
+    camera?: boolean | ClipCameraOptions;
+    /** Called when camera was requested but getUserMedia rejects (recording continues without PiP). */
+    onCameraUnavailable?: () => void;
+    /**
+     * 'auto' (default): the SDK samples the canvas continuously.
+     * 'manual': the game drives frames by calling clips.captureFrame() in its render
+     * loop (after world-render, before UI-render) so in-canvas UI is excluded.
+     */
+    captureMode?: 'auto' | 'manual';
+    /** Force a specific MediaRecorder mime type (throws if unsupported). */
+    mimeType?: string;
+    videoBitsPerSecond?: number;
+    /** Called when maxDurationMs caps capture; the caller should then call stopRecordingAsync(). */
+    onAutoStop?: () => void;
+}
+interface ClipBlob {
+    blob: Blob;
+    mimeType: string;
+    durationMs: number;
+    width: number;
+    height: number;
+    sizeBytes: number;
+}
+interface ClipPersistOptions {
+    /** 'ugc' (default) uploads + registers a private UGC entry; 'none' returns only the blob. */
+    persist?: 'none' | 'ugc';
+    title?: string;
+    tags?: string[];
+    /** Merge extra fields into the UGC data blob. */
+    data?: Record<string, unknown>;
+}
+interface ClipResult extends ClipBlob {
+    /** Present when persisted as UGC. */
+    ugc?: UgcEntry;
+    fileKey?: string;
+    /** Signed, expiring URL for immediate playback only — not durable, not persisted. */
+    fileUrl?: string;
+}
+interface ClipsSupport {
+    canRecord: boolean;
+    canUseMicrophone: boolean;
+    canUseCamera: boolean;
+    reason?: string;
+}
+type CaptureConsentStatus = 'granted' | 'denied' | 'undetermined';
+interface CaptureConsent {
+    status: CaptureConsentStatus;
+    canAskAgain: boolean;
+}
+interface ClipsApi {
+    isSupportedAsync(): Promise<ClipsSupport>;
+    /** Inspect the per-app capture consent without prompting. T1 apps always report granted. */
+    getCaptureConsentAsync(): Promise<CaptureConsent>;
+    /**
+     * Pop the app-owned native consent harness (T2 and below) to collect/refresh consent.
+     * Pass `includesCamera` when the upcoming recording uses the webcam so the correct
+     * device permission (camera vs microphone) drives the single-opt-in decision.
+     */
+    requestCaptureConsentAsync(opts?: {
+        includesCamera?: boolean;
+    }): Promise<CaptureConsent>;
+    /** Register the game's master Web Audio output node so clips can capture game audio. */
+    useGameAudio(node: AudioNode): void;
+    startRecordingAsync(options?: StartClipRecordingOptions): Promise<void>;
+    /**
+     * In captureMode 'manual', snapshot the current game canvas into the recording
+     * surface (call once per render frame, after world-render and before UI-render,
+     * to exclude in-canvas UI). No-op when not recording or in 'auto' mode.
+     */
+    captureFrame(): void;
+    stopRecordingAsync(persist?: ClipPersistOptions): Promise<ClipResult>;
+    cancelRecordingAsync(): Promise<void>;
+    /** Promote a private clip UGC entry to shared (file + UGC visibility -> public). */
+    publishClipAsync(ugcId: string): Promise<UgcEntry>;
+}
+
 interface Entitlement {
     docId: string;
     userId: string;
@@ -3002,6 +3214,7 @@ interface Host {
     readonly audioGen: AudioGenApi;
     readonly videoGen: VideoGenApi;
     readonly files: FilesApi;
+    readonly clips: ClipsApi;
     readonly spriteGen: SpriteGenApi;
     readonly threeDGen: ThreeDGenApi;
     readonly entitlements: EntitlementApi;
@@ -3497,6 +3710,7 @@ interface RundotGameAPI {
     audioGen: AudioGenApi;
     videoGen: VideoGenApi;
     files: FilesApi;
+    clips: ClipsApi;
     spriteGen: SpriteGenApi;
     threeDGen: ThreeDGenApi;
     entitlements: EntitlementApi;
@@ -3523,4 +3737,4 @@ interface AdsApi {
     showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-export { type FetchFromCdnOptions as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type ScheduleNotificationOptions as E, type RCSAvailabilityStatus as F, type ScheduleRCSInput as G, type Host as H, type ScheduleRCSResult as I, type PopupsApi as J, type ShowToastOptions as K, type ShowInterstitialAdOptions as L, type ShowRewardedAdOptions as M, type NavigationApi as N, type ProfileApi as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type DeviceApi as T, type DeviceInfo as U, type EnvironmentApi as V, type EnvironmentInfo as W, type SystemApi as X, type SafeArea as Y, type AddToHomeScreenResult as Z, type CdnApi as _, type RecipeRequirementQuery as a, type SpendCurrencyOptions as a$, type AssetUrlResult as a0, type TimeApi as a1, type ServerTimeData as a2, type GetFutureTimeOptions as a3, type AiApi as a4, type AiChatCompletionRequest as a5, type AiChatCompletionData as a6, type AiChatCompletionStreamOptions as a7, type AiChatCompletionStreamChunk as a8, type HapticsApi as a9, type GetActiveRunsOptions as aA, type ExecuteScopedRecipeOptions as aB, type ExecuteScopedRecipeResult as aC, type GetAvailableRecipesOptions as aD, type GetAvailableRecipesResult as aE, type Recipe as aF, type GetBatchRecipeRequirements as aG, type TriggerRecipeChainOptions as aH, type RoomDataUpdate as aI, type RoomMessageEvent as aJ, type ProposedMoveEvent as aK, RundotGameTransport as aL, type RoomsApi as aM, type CreateRoomOptions as aN, type JoinOrCreateRoomOptions as aO, type JoinOrCreateResult as aP, type ListRoomsOptions as aQ, type UpdateRoomDataOptions as aR, type RoomMessageRequest as aS, type StartRoomGameOptions as aT, type ProposeMoveRequest as aU, type ProposeMoveResult as aV, type ValidateMoveVerdict as aW, type ValidateMoveResult as aX, type RoomSubscriptionOptions as aY, type LoggingApi as aZ, type IapApi as a_, HapticFeedbackStyle as aa, type FeaturesApi as ab, type Experiment as ac, type LifecycleApi as ad, type SleepCallback as ae, type Subscription as af, type AwakeCallback as ag, type PauseCallback as ah, type ResumeCallback as ai, type QuitCallback as aj, type BackButtonCallback as ak, type SimulationApi as al, type SimulationSlotValidationResult as am, type SimulationBatchOperation as an, type SimulationBatchOperationsResult as ao, type SimulationAvailableItem as ap, type SimulationPowerPreview as aq, type SimulationSlotMutationResult as ar, type SimulationSlotContainer as as, type SimulationAssignment as at, type SimulationState as au, type ExecuteRecipeOptions as av, type ExecuteRecipeResponse as aw, type CollectRecipeResult as ax, type ResetStateOptions as ay, type ResetStateResult as az, type RecipeRequirementResult as b, type FilesApi as b$, type SpendCurrencyResult as b0, type SubscriptionTier as b1, type RunSubscriptionsResponse as b2, type SubscriptionInterval as b3, type PurchaseSubscriptionResponse as b4, type OpenStoreResult as b5, type LoadEmbeddedAssetsResponse as b6, type SharedAssetsApi as b7, type PreloaderApi as b8, type SocialApi as b9, type AdminSpriteGenApi as bA, type AdminAudioGenApi as bB, type AdminThreeDGenApi as bC, type AppRole as bD, type AdminUgcBrowseParams as bE, type AdminUgcBrowseResponse as bF, type AdminUgcListReportsParams as bG, type AdminUgcListReportsResponse as bH, type AdminUgcResolveAction as bI, type AdminGenBrowseParams as bJ, type AdminGenBrowseResponse as bK, type ImageGenEntry as bL, type AdminGenListReportsParams as bM, type AdminGenListReportsResponse as bN, type ImageGenReport as bO, type AdminGenResolveAction as bP, type SpriteGenEntry as bQ, type SpriteGenReport as bR, type ThreeDGenEntry as bS, type ThreeDGenReport as bT, type Avatar3dApi as bU, type AssetManifest as bV, type Avatar3dConfig as bW, type ShowEditorOptions as bX, type Avatar3dEdits as bY, type AdsApi as bZ, type SharedStorageHostApi as b_, type ShareMetadata as ba, type ShareLinkResult as bb, type SocialQRCodeOptions as bc, type QRCodeResult as bd, type ShareClickData as be, type ShareFileOptions as bf, type ShareFileResult as bg, type CanShareFileResult as bh, type EntitlementApi as bi, type Entitlement as bj, type LedgerEntry as bk, type ShopApi as bl, type StorefrontResponse as bm, type StorefrontItem as bn, type ShopPurchaseResponse as bo, type ShopOrderHistoryResponse as bp, type PromptLoginResult as bq, type AccessTier as br, type AccessGateApi as bs, type TextGenApi as bt, type UgcApi as bu, type VideoApi as bv, type AppApi as bw, type AdminUgcApi as bx, type AdminImageGenApi as by, type AdminVideoGenApi as bz, type RundotGameAvailableRecipe as c, type RoomMessageEventType as c$, type MultiplayerApi as c0, type AttributionApi as c1, type InitializationContext as c2, type InitializationOptions as c3, AccessDeniedError as c4, type AdminGenApi as c5, type AdminImageGenBrowseParams as c6, type AdminImageGenBrowseResponse as c7, type AdminImageGenListReportsParams as c8, type AdminImageGenListReportsResponse as c9, type AudioGenEntry as cA, type AudioGenReport as cB, type Category as cC, type ConnectionState as cD, type GetSubscriptionsForTierRequest as cE, type HudInsets as cF, type InboundForKeyEntry as cG, type InboundMethodIds as cH, type InboundStorageApi as cI, type IsPlayerSubscribedRequest as cJ, type JoinOrCreateRoomEnvelopeResponse as cK, type JoinRoomMatchCriteria as cL, type LoadEmbeddedAssetsRequest as cM, MockAvatarApi as cN, type NotificationTriggerInput as cO, type OnNotificationCallback as cP, type OnRequestCallback as cQ, type OnResponseCallback as cR, type ProposedMovePayload as cS, type Protocol as cT, type PurchaseSubscriptionRequest as cU, type RCSAvailabilityReason as cV, ROOM_GAME_PHASES as cW, type RecipeInfo as cX, type RoomEnvelopeResponse as cY, type RoomEvents as cZ, type RoomGamePhase as c_, type AdminImageGenResolveAction as ca, type AdminSpriteGenBrowseParams as cb, type AdminSpriteGenBrowseResponse as cc, type AdminSpriteGenListReportsParams as cd, type AdminSpriteGenListReportsResponse as ce, type AdminSpriteGenResolveAction as cf, type AdminThreeDGenBrowseParams as cg, type AdminThreeDGenBrowseResponse as ch, type AdminThreeDGenListReportsParams as ci, type AdminThreeDGenListReportsResponse as cj, type AdminThreeDGenResolveAction as ck, type AdminUgcEntry as cl, type AdminVideoGenBrowseParams as cm, type AdminVideoGenBrowseResponse as cn, type AdminVideoGenListReportsParams as co, type AdminVideoGenListReportsResponse as cp, type AdminVideoGenResolveAction as cq, type AiContentBlock as cr, type AiImageContent as cs, type AiImageUrlContent as ct, type AiMessage as cu, type AiResponseFormat as cv, type AiTextContent as cw, type AiToolResultContent as cx, type AiToolUseContent as cy, type Asset as cz, type RundotGameCollectRecipeResult as d, type RoomMessagePayload as d0, type RoomsEnvelopeResponse as d1, RpcInboundStorageApi as d2, RpcSharedAssetsApi as d3, type RpcTransport as d4, type RunSubscription as d5, type RundotGameRoomCustomMetadata as d6, type RundotGameRoomPayload as d7, type RundotGameRoomRules as d8, type RundotGameRoomRulesGameState as d9, SHARE_FILE_ALLOWED_MIME_TYPES as da, SHARE_FILE_MAX_SIZE_BYTES as db, type ScheduleRCSStatus as dc, type ServerPlayer as dd, type ServerRoom as de, type ShareFileMimeType as df, type ShopOrder as dg, type SimulationBatchOperationAssign as dh, type SimulationBatchOperationRemove as di, type SimulationBatchOperationResult as dj, type SimulationPersonalState as dk, type SimulationRoomActiveRecipe as dl, type SimulationRoomState as dm, type StorefrontCollection as dn, type StorefrontCollectionItem as dp, type SubPath as dq, type Tool as dr, type ToolChoice as ds, type ToolUse as dt, type TimeIntervalTriggerInput as du, type UgcReport as dv, type VideoGenEntry as dw, type VideoGenReport as dx, createHost as dy, resolveCollectionItemPrice as dz, type RundotGameExecuteRecipeOptions as e, type RundotGameExecuteRecipeResult as f, type RundotGameExecuteScopedRecipeOptions as g, RundotGameRoom as h, type RundotGameSimulationConfig as i, type RundotGameSimulationEffect as j, type RundotGameSimulationRecipe as k, type RundotGameSimulationStateResponse as l, type SimulationEntityUpdate as m, type SimulationRunSummary as n, type SimulationSnapshotUpdate as o, type SimulationSubscribeOptions as p, type SimulationUpdateData as q, type SimulationUpdateType as r, type RpcRequest as s, type RpcResponse as t, type RpcNotification as u, RpcClient as v, type StorageApi as w, type NavigationStackInfo as x, type PushAppOptions as y, type NavigateToGameOptions as z };
+export { type AddToHomeScreenResult as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type ScheduleNotificationOptions as E, type RCSAvailabilityStatus as F, type ScheduleRCSInput as G, type Host as H, type ScheduleRCSResult as I, type RequestRCSOptInInput as J, type RequestRCSOptInResult as K, type PopupsApi as L, type ShowToastOptions as M, type NavigationApi as N, type ShowInterstitialAdOptions as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type ShowRewardedAdOptions as T, type ProfileApi as U, type DeviceApi as V, type DeviceInfo as W, type EnvironmentApi as X, type EnvironmentInfo as Y, type SystemApi as Z, type SafeArea as _, type RecipeRequirementQuery as a, type LoggingApi as a$, type CdnApi as a0, type FetchFromCdnOptions as a1, type AssetUrlResult as a2, type TimeApi as a3, type ServerTimeData as a4, type GetFutureTimeOptions as a5, type AiApi as a6, type AiChatCompletionRequest as a7, type AiChatCompletionData as a8, type AiChatCompletionStreamOptions as a9, type ResetStateOptions as aA, type ResetStateResult as aB, type GetActiveRunsOptions as aC, type ExecuteScopedRecipeOptions as aD, type ExecuteScopedRecipeResult as aE, type GetAvailableRecipesOptions as aF, type GetAvailableRecipesResult as aG, type Recipe as aH, type GetBatchRecipeRequirements as aI, type TriggerRecipeChainOptions as aJ, type RoomDataUpdate as aK, type RoomMessageEvent as aL, type ProposedMoveEvent as aM, RundotGameTransport as aN, type RoomsApi as aO, type CreateRoomOptions as aP, type JoinOrCreateRoomOptions as aQ, type JoinOrCreateResult as aR, type ListRoomsOptions as aS, type UpdateRoomDataOptions as aT, type RoomMessageRequest as aU, type StartRoomGameOptions as aV, type ProposeMoveRequest as aW, type ProposeMoveResult as aX, type ValidateMoveVerdict as aY, type ValidateMoveResult as aZ, type RoomSubscriptionOptions as a_, type AiChatCompletionStreamChunk as aa, type HapticsApi as ab, HapticFeedbackStyle as ac, type FeaturesApi as ad, type Experiment as ae, type LifecycleApi as af, type SleepCallback as ag, type Subscription as ah, type AwakeCallback as ai, type PauseCallback as aj, type ResumeCallback as ak, type QuitCallback as al, type BackButtonCallback as am, type SimulationApi as an, type SimulationSlotValidationResult as ao, type SimulationBatchOperation as ap, type SimulationBatchOperationsResult as aq, type SimulationAvailableItem as ar, type SimulationPowerPreview as as, type SimulationSlotMutationResult as at, type SimulationSlotContainer as au, type SimulationAssignment as av, type SimulationState as aw, type ExecuteRecipeOptions as ax, type ExecuteRecipeResponse as ay, type CollectRecipeResult as az, type RecipeRequirementResult as b, type AdsApi as b$, type IapApi as b0, type SpendCurrencyOptions as b1, type SpendCurrencyResult as b2, type SubscriptionTier as b3, type RunSubscriptionsResponse as b4, type SubscriptionInterval as b5, type PurchaseSubscriptionResponse as b6, type OpenStoreResult as b7, type LoadEmbeddedAssetsResponse as b8, type SharedAssetsApi as b9, type AdminImageGenApi as bA, type AdminVideoGenApi as bB, type AdminSpriteGenApi as bC, type AdminAudioGenApi as bD, type AdminThreeDGenApi as bE, type AppRole as bF, type AdminUgcBrowseParams as bG, type AdminUgcBrowseResponse as bH, type AdminUgcListReportsParams as bI, type AdminUgcListReportsResponse as bJ, type AdminUgcResolveAction as bK, type AdminGenBrowseParams as bL, type AdminGenBrowseResponse as bM, type ImageGenEntry as bN, type AdminGenListReportsParams as bO, type AdminGenListReportsResponse as bP, type ImageGenReport as bQ, type AdminGenResolveAction as bR, type SpriteGenEntry as bS, type SpriteGenReport as bT, type ThreeDGenEntry as bU, type ThreeDGenReport as bV, type Avatar3dApi as bW, type AssetManifest as bX, type Avatar3dConfig as bY, type ShowEditorOptions as bZ, type Avatar3dEdits as b_, type PreloaderApi as ba, type SocialApi as bb, type ShareMetadata as bc, type ShareLinkResult as bd, type SocialQRCodeOptions as be, type QRCodeResult as bf, type ShareClickData as bg, type ShareFileOptions as bh, type ShareFileResult as bi, type CanShareFileResult as bj, type EntitlementApi as bk, type Entitlement as bl, type LedgerEntry as bm, type ShopApi as bn, type StorefrontResponse as bo, type StorefrontItem as bp, type ShopPurchaseResponse as bq, type ShopOrderHistoryResponse as br, type PromptLoginResult as bs, type AccessTier as bt, type AccessGateApi as bu, type TextGenApi as bv, type UgcApi as bw, type VideoApi as bx, type AppApi as by, type AdminUgcApi as bz, type RundotGameAvailableRecipe as c, type JoinRoomMatchCriteria as c$, type SharedStorageHostApi as c0, type FilesApi as c1, type ClipsApi as c2, type MultiplayerApi as c3, type AttributionApi as c4, type InitializationContext as c5, type InitializationOptions as c6, type CaptureConsent as c7, type StartClipRecordingOptions as c8, type ClipBlob as c9, type AdminVideoGenListReportsResponse as cA, type AdminVideoGenResolveAction as cB, type AiContentBlock as cC, type AiImageContent as cD, type AiImageUrlContent as cE, type AiMessage as cF, type AiResponseFormat as cG, type AiTextContent as cH, type AiToolResultContent as cI, type AiToolUseContent as cJ, type Asset as cK, type AudioGenEntry as cL, type AudioGenReport as cM, CLIP_CONTENT_TYPE as cN, type Category as cO, type ClipAudioOptions as cP, type ClipCameraOptions as cQ, type ClipPipLayout as cR, type ClipPipPosition as cS, type ConnectionState as cT, type GetSubscriptionsForTierRequest as cU, type HudInsets as cV, type InboundForKeyEntry as cW, type InboundMethodIds as cX, type InboundStorageApi as cY, type IsPlayerSubscribedRequest as cZ, type JoinOrCreateRoomEnvelopeResponse as c_, type ClipsSupport as ca, type ClipPersistOptions as cb, type ClipResult as cc, type UgcEntry as cd, type CaptureConsentStatus as ce, AccessDeniedError as cf, type AdminGenApi as cg, type AdminImageGenBrowseParams as ch, type AdminImageGenBrowseResponse as ci, type AdminImageGenListReportsParams as cj, type AdminImageGenListReportsResponse as ck, type AdminImageGenResolveAction as cl, type AdminSpriteGenBrowseParams as cm, type AdminSpriteGenBrowseResponse as cn, type AdminSpriteGenListReportsParams as co, type AdminSpriteGenListReportsResponse as cp, type AdminSpriteGenResolveAction as cq, type AdminThreeDGenBrowseParams as cr, type AdminThreeDGenBrowseResponse as cs, type AdminThreeDGenListReportsParams as ct, type AdminThreeDGenListReportsResponse as cu, type AdminThreeDGenResolveAction as cv, type AdminUgcEntry as cw, type AdminVideoGenBrowseParams as cx, type AdminVideoGenBrowseResponse as cy, type AdminVideoGenListReportsParams as cz, type RundotGameCollectRecipeResult as d, type LoadEmbeddedAssetsRequest as d0, MockAvatarApi as d1, type NotificationTriggerInput as d2, type OnNotificationCallback as d3, type OnRequestCallback as d4, type OnResponseCallback as d5, type ProposedMovePayload as d6, type Protocol as d7, type PurchaseSubscriptionRequest as d8, type RCSAvailabilityReason as d9, type SimulationBatchOperationRemove as dA, type SimulationBatchOperationResult as dB, type SimulationPersonalState as dC, type SimulationRoomActiveRecipe as dD, type SimulationRoomState as dE, type StorefrontCollection as dF, type StorefrontCollectionItem as dG, type SubPath as dH, type Tool as dI, type ToolChoice as dJ, type ToolUse as dK, type TimeIntervalTriggerInput as dL, type UgcReport as dM, type VideoGenEntry as dN, type VideoGenReport as dO, createHost as dP, resolveCollectionItemPrice as dQ, type RCSOptInStatus as da, ROOM_GAME_PHASES as db, type RecipeInfo as dc, type RoomEnvelopeResponse as dd, type RoomEvents as de, type RoomGamePhase as df, type RoomMessageEventType as dg, type RoomMessagePayload as dh, type RoomsEnvelopeResponse as di, RpcInboundStorageApi as dj, RpcSharedAssetsApi as dk, type RpcTransport as dl, type RunSubscription as dm, type RundotGameRoomCustomMetadata as dn, type RundotGameRoomPayload as dp, type RundotGameRoomRules as dq, type RundotGameRoomRulesGameState as dr, SHARE_FILE_ALLOWED_MIME_TYPES as ds, SHARE_FILE_MAX_SIZE_BYTES as dt, type ScheduleRCSStatus as du, type ServerPlayer as dv, type ServerRoom as dw, type ShareFileMimeType as dx, type ShopOrder as dy, type SimulationBatchOperationAssign as dz, type RundotGameExecuteRecipeOptions as e, type RundotGameExecuteRecipeResult as f, type RundotGameExecuteScopedRecipeOptions as g, RundotGameRoom as h, type RundotGameSimulationConfig as i, type RundotGameSimulationEffect as j, type RundotGameSimulationRecipe as k, type RundotGameSimulationStateResponse as l, type SimulationEntityUpdate as m, type SimulationRunSummary as n, type SimulationSnapshotUpdate as o, type SimulationSubscribeOptions as p, type SimulationUpdateData as q, type SimulationUpdateType as r, type RpcRequest as s, type RpcResponse as t, type RpcNotification as u, RpcClient as v, type StorageApi as w, type NavigationStackInfo as x, type PushAppOptions as y, type NavigateToGameOptions as z };

package/dist/{LeaderboardApi--NKuV2tJ.d.ts → LeaderboardApi-BKte9LP0.d.ts}

@@ -1,4 +1,4 @@
-type ImageGenModel = 'gemini-3.1-flash-image-preview' | 'gemini-3-pro-image-preview';
+type ImageGenModel = 'gemini-3.1-flash-image-preview' | 'gemini-3-pro-image-preview' | 'gpt-image-1' | 'gpt-image-2';
 type BgRemovalModel = 'bria' | 'birefnet';
 type BiRefNetVariant = 'light' | 'heavy' | 'portrait';
 interface RemoveBackgroundOptions {
@@ -29,10 +29,22 @@ interface ImageGenParams {
     removeBackground?: boolean | RemoveBackgroundOptions;
     /** Model to use. Defaults to 'gemini-3.1-flash-image-preview' (Nano Banana 2). */
     model?: ImageGenModel;
+    /**
+     * Native output resolution. Only supported by 'gemini-3-pro-image-preview'
+     * (Nano Banana Pro); passing it with any other model is rejected. Defaults to
+     * '1K'. Use '2K' or '4K' for studio-quality output.
+     */
+    imageSize?: '1K' | '2K' | '4K';
 }
 interface ImageGenResult {
+    /** UUID assigned by the server for this generation. */
+    generationId: string;
     imageUrl: string;
     prompt: string;
+    /** Resolved model name (server may upgrade deprecated aliases). */
+    model: string;
+    /** Seed used (echoed back even when client did not specify one). */
+    seed: number;
 }
 interface ImageGenJobEvent {
     jobId: string;
@@ -107,13 +119,19 @@ interface AudioGenSFXParams {
     /** Opaque correlation ID echoed back in job events for client-side recovery. */
     clientRef?: string;
 }
+type MusicModel = 'elevenlabs' | 'lyria3' | 'lyria3-pro' | 'minimax-music-2.6';
 interface AudioGenMusicParams {
     type: 'music';
     provider?: AudioGenProvider;
     /** Genre, tempo, instruments, mood — "orchestral victory fanfare, triumphant brass" */
     prompt: string;
-    /** Duration in seconds (REQUIRED, 1–300). */
+    /**
+     * Duration in seconds (3–300). Required for ElevenLabs; ignored by FAL
+     * models which produce a fixed-length track.
+     */
     durationSec: number;
+    /** Music generation model. Default: 'elevenlabs'. */
+    model?: MusicModel;
     /** Opaque correlation ID echoed back in job events for client-side recovery. */
     clientRef?: string;
 }
@@ -303,6 +321,10 @@ interface SpriteGenParams {
     width?: number;
     height?: number;
     bgMode?: 'transparent' | 'white' | 'include';
+    /** Disable smart-crop (auto-crop to content bounds). Default true. Set false to get exact requested dimensions. */
+    smartCrop?: boolean;
+    /** Disable pixel-perfect grid alignment. Default true. Can alter output dimensions slightly. */
+    pixelPerfect?: boolean;
     theme?: string;
     style?: string;
     colors?: string[];
@@ -370,7 +392,7 @@ interface SpriteGenApi {
     getCompletedJobs(): Promise<SpriteGenJobEvent[]>;
 }
 
-type ThreeDGenProvider = 'pixal3d' | 'hunyuan3d-v3.1-pro' | 'trellis-2';
+type ThreeDGenProvider = 'pixal3d' | 'hunyuan3d-v3.1-pro' | 'trellis-2' | 'meshy';
 type ThreeDGenMode = 'image-to-3d' | 'text-to-3d';
 type ThreeDGenQuality = 'draft' | 'standard' | 'high';
 interface ThreeDGenBase {
@@ -431,7 +453,25 @@ interface Trellis2ImageTo3DParams extends ThreeDGenBase {
     imageUrl: string;
     providerOptions?: Record<string, never>;
 }
-type ThreeDGenParams = Pixal3DImageTo3DParams | HunyuanImageTo3DParams | HunyuanTextTo3DParams | Trellis2ImageTo3DParams;
+/** Meshy native generation provider options (texture + PBR controls). */
+interface MeshyProviderOptions {
+    should_texture?: boolean;
+    enable_pbr?: boolean;
+    ai_model?: string;
+}
+interface MeshyImageTo3DParams extends ThreeDGenBase {
+    provider: 'meshy';
+    mode: 'image-to-3d';
+    imageUrl: string;
+    providerOptions?: MeshyProviderOptions;
+}
+interface MeshyTextTo3DParams extends ThreeDGenBase {
+    provider: 'meshy';
+    mode: 'text-to-3d';
+    prompt: string;
+    providerOptions?: MeshyProviderOptions;
+}
+type ThreeDGenParams = Pixal3DImageTo3DParams | HunyuanImageTo3DParams | HunyuanTextTo3DParams | Trellis2ImageTo3DParams | MeshyImageTo3DParams | MeshyTextTo3DParams;
 interface ThreeDGenResult {
     generationId: string;
     modelUrl: string;