@storvia/sdk 0.5.20 → 0.5.25

package/dist/index.d.mts

@@ -691,15 +691,6 @@ declare class StorviaError extends Error {
     constructor(code: StorviaErrorCode, message: string);
 }
 
-/**
- * SDK 内置 Toast：参考主站 Toast.vue 样式
- * 用于在 HTTP 层捕获错误后自动提示用户
- */
-
-type ToastType = 'success' | 'error' | 'warning' | 'info';
-declare function setToastEnabled(enabled: boolean): void;
-declare function showToast(message: string, type?: ToastType, duration?: number): void;
-
 /**
  * 父子 iframe postMessage 协议类型
  *
@@ -775,12 +766,19 @@ interface SdkErrorPayload {
     message: string;
     recoverable: boolean;
 }
+/**
+ * 子 → 父：请求宿主跳转。当前仅支持 'wallet'（充值/钱包页），
+ * Web 主站 router.push('/wallet')，App 端跳 App 内钱包路由。
+ */
+interface NavigatePayload {
+    target: 'wallet';
+}
 interface AckPayload {
     ok: boolean;
     error?: string;
 }
 type DownstreamMsg = ProtocolEnvelope<'init', InitPayload> | ProtocolEnvelope<'preview-init', PreviewInitPayload> | ProtocolEnvelope<'token-update', TokenUpdatePayload> | ProtocolEnvelope<'config-update', ConfigUpdatePayload> | ProtocolEnvelope<'set-model', SetModelPayload> | ProtocolEnvelope<'orientation', OrientationPayload> | ProtocolEnvelope<'ack', AckPayload>;
-type UpstreamMsg = ProtocolEnvelope<'ready', ReadyPayload> | ProtocolEnvelope<'exit', Record<string, never>> | ProtocolEnvelope<'request-orientation', OrientationPayload> | ProtocolEnvelope<'error', SdkErrorPayload> | ProtocolEnvelope<'ack', AckPayload>;
+type UpstreamMsg = ProtocolEnvelope<'ready', ReadyPayload> | ProtocolEnvelope<'exit', Record<string, never>> | ProtocolEnvelope<'request-orientation', OrientationPayload> | ProtocolEnvelope<'error', SdkErrorPayload> | ProtocolEnvelope<'navigate', NavigatePayload> | ProtocolEnvelope<'ack', AckPayload>;
 declare function isProtocolEnvelope(data: unknown): data is ProtocolEnvelope<string, unknown>;
 declare function envelope<T extends string, P>(type: T, payload: P, opts?: {
     id?: string;
@@ -824,6 +822,11 @@ interface StorviaBusOptions<TIn extends AnyEnvelope> {
     debug?: boolean;
     /** transferable objects 的回调（用于 Phase 4 MessageChannel） */
     transfer?: (msg: AnyEnvelope) => Transferable[] | undefined;
+    /**
+     * 自定义出站发送函数。一旦提供，`outgoing` 不会被调用，全部消息走这个函数。
+     * 用于 Flutter WebView 等没有 `window.parent` 的宿主环境（消息走 native channel）。
+     */
+    customSend?: (envelope: AnyEnvelope) => void;
 }
 declare class StorviaBus<TIn extends AnyEnvelope, TOut extends AnyEnvelope> {
     private incoming;
@@ -832,6 +835,7 @@ declare class StorviaBus<TIn extends AnyEnvelope, TOut extends AnyEnvelope> {
     private validate;
     private debug;
     private getTransferables;
+    private customSend;
     private handlers;
     private pendingAcks;
     private listener;
@@ -848,4 +852,24 @@ declare class StorviaBus<TIn extends AnyEnvelope, TOut extends AnyEnvelope> {
     destroy(): void;
 }
 
-export { type AISummary, type AckPayload, type AssetItem, type CharacterAddOptions, type CharacterDetail, type CharacterPersona, type CharacterUpdateOptions, type ChatGenerateOptions, type ChatMessage, type ChatMessageCursor, type ChatMessagesOptions, type ChatMessagesResponse, type ChatResponse, type ChatRetryOptions, type ChatSaveOptions, type ChatSendOptions, type ChatStateCallback, type ConfigUpdatePayload, type CurrentState, type DormantState, type DownstreamMsg, type FieldValue, type Gender, type InitPayload, type InventoryAddOptions, type InventoryMoveOptions, type InventoryRemoveGroupOptions, type InventoryRemoveOptions, type InventoryState, type InventoryUpdateOptions, type ItemData, type OrientationPayload, PROTOCOL_VERSION, type PlayerPersona, type PreviewConfig, type PreviewInitPayload, type ProtocolEnvelope, type ReadyPayload, type Relationship, type RichFieldValue, type SdkErrorPayload, type SetModelPayload, type State, type StateChanges, StorviaBus, type StorviaBusOptions, StorviaError, type StorviaErrorCode, StorviaSDK, type TokenUpdatePayload, type UpstreamMsg, createStorviaSDK, envelope, extractFieldValue, isProtocolEnvelope, isRichFieldValue, setToastEnabled, showToast };
+/**
+ * SDK 内置 Toast：参考主站 Toast.vue 样式
+ * 用于在 HTTP 层捕获错误后自动提示用户
+ */
+
+type ToastType = 'success' | 'error' | 'warning' | 'info';
+declare function setToastEnabled(enabled: boolean): void;
+interface ToastAction {
+    label: string;
+    onClick: () => void;
+}
+/**
+ * 展示一条 toast。
+ * - duration > 0：duration ms 后自动消失
+ * - duration === 0：常驻，必须用户点关闭按钮（× 自动加上）或 action 按钮才会关闭
+ */
+declare function showToast(message: string, type?: ToastType, duration?: number, action?: ToastAction): void;
+declare function setInsufficientCreditsSheetEnabled(enabled: boolean): void;
+declare function showInsufficientCreditsSheet(fallbackMsg?: string): void;
+
+export { type AISummary, type AckPayload, type AssetItem, type CharacterAddOptions, type CharacterDetail, type CharacterPersona, type CharacterUpdateOptions, type ChatGenerateOptions, type ChatMessage, type ChatMessageCursor, type ChatMessagesOptions, type ChatMessagesResponse, type ChatResponse, type ChatRetryOptions, type ChatSaveOptions, type ChatSendOptions, type ChatStateCallback, type ConfigUpdatePayload, type CurrentState, type DormantState, type DownstreamMsg, type FieldValue, type Gender, type InitPayload, type InventoryAddOptions, type InventoryMoveOptions, type InventoryRemoveGroupOptions, type InventoryRemoveOptions, type InventoryState, type InventoryUpdateOptions, type ItemData, type OrientationPayload, PROTOCOL_VERSION, type PlayerPersona, type PreviewConfig, type PreviewInitPayload, type ProtocolEnvelope, type ReadyPayload, type Relationship, type RichFieldValue, type SdkErrorPayload, type SetModelPayload, type State, type StateChanges, StorviaBus, type StorviaBusOptions, StorviaError, type StorviaErrorCode, StorviaSDK, type TokenUpdatePayload, type UpstreamMsg, createStorviaSDK, envelope, extractFieldValue, isProtocolEnvelope, isRichFieldValue, setInsufficientCreditsSheetEnabled, setToastEnabled, showInsufficientCreditsSheet, showToast };