assistsx-js 0.1.42 → 0.2.0

package/dist/index.d.mts

@@ -4111,4 +4111,121 @@ declare const FloatCallMethod: {
 };
 type FloatCallMethodType = (typeof FloatCallMethod)[keyof typeof FloatCallMethod];
 
-export { type AccessibilityEvent, type AccessibilityEventData, AccessibilityEventFilter, type AccessibilityEventFilterConfig, type AccessibilityEventListener, AppInfo, AssistsX, AssistsXAsync, BarUtils, BarUtilsCallMethod, type BarUtilsCallMethodType, Bounds, CallMethod, type CallMethodType, CallResponse, type Contact, DeviceInfo, FileIO, type FileInfo, type FileListItem, type FileUploadInfo, FileUtils, Float, FloatCallMethod, type FloatCallMethodType, Gallery, type GalleryDeleteResponse, type GalleryResponse, Http, type HttpConfig, type HttpDownloadResponse, type HttpResponse, type ImageProcessResult, type ImageRotateDegree, type ImageSaveResult, type ImageSize, type ImageType, ImageUtils, Ime, ImeAction, type IsCurrentInputMethodResponse, type IsInputMethodEnabledResponse, Mlkit, MlkitCallMethod, type MlkitCallMethodType, type MlkitRegion, Node, NodeAsync, NodeClassValue, type OpenInputMethodSettingsResponse, Path, type PerformEditorActionResponse, type RecognizeTextInScreenshotPosition, type RecognizeTextInScreenshotResult, type RecognizeTextRegion, type Screen, type ScreenTextJsonResult, type ScreenTextRecognitionResult, Step, StepAsync, StepError, type StepImpl, type StepInterceptor, type StepResult, type StepState, type StepStatus, StepStopError, type TextPosition, type WebFloatingWindowOptions, WindowFlags, accessibilityEventListeners, barUtils, callbacks, decodeBase64UTF8, fileIO, fileUtils, float, gallery, generateUUID, http, imageUtils, ime, mlkit, pathUtils, screen, sleep, useStepStore };
+/**
+ * 日志桥接方法名（与 tools/log/AssistsLogCallMethod.kt 一致）
+ */
+declare const LogCallMethod: {
+    readonly readAllText: "readAllText";
+    readonly clear: "clear";
+    readonly refreshFromFile: "refreshFromFile";
+    readonly appendLine: "appendLine";
+    readonly appendTimestampedEntry: "appendTimestampedEntry";
+    readonly replaceAll: "replaceAll";
+    readonly subscribe: "subscribe";
+    readonly unsubscribe: "unsubscribe";
+    readonly uploadLogs: "uploadLogs";
+    /** 获取日志服务当前域名（origin，无路径；与上传、管理后台同源），对应 AssistsLogDiagnostics.adminWebBaseUrl() */
+    readonly getLogServiceBaseUrl: "getLogServiceBaseUrl";
+};
+/** 与 ASWebView / AssistsLogJavascriptInterface companion 对齐 */
+declare const LogStream: {
+    readonly latestLine: "latestLine";
+    readonly entireLogText: "entireLogText";
+};
+type LogStreamType = (typeof LogStream)[keyof typeof LogStream];
+type LogCallMethodType = (typeof LogCallMethod)[keyof typeof LogCallMethod];
+
+/**
+ * onAssistsLogUpdate 推送的监听器列表（与 accessibilityEventListeners 风格一致）。
+ * 在页面加载本模块后，向此数组 push，或使用 log.addLogUpdateListener。
+ * 注意：若页面在 import 本模块之前已自定义 `window.onAssistsLogUpdate`，则不会安装默认分发函数，需自行解码并转发到监听器。
+ */
+declare const logUpdateListeners: Array<(payload: LogUpdateEvent) => void>;
+/**
+ * Base64 解码后的 CallResponse，data 含 stream / text
+ */
+interface LogUpdateEvent {
+    code: number;
+    data: LogUpdateData | null;
+    message?: string;
+    callbackId?: string | null;
+}
+interface LogUpdateData {
+    stream: LogStreamType;
+    text: string;
+}
+interface LogSubscribeUpdatePayload {
+    text: string;
+    stream: string;
+    subscriptionId: string;
+}
+interface LogUploadOptions {
+    baseUrl?: string;
+    /** PNG（默认）| JPEG | JPG | WEBP */
+    format?: "PNG" | "JPEG" | "JPG" | "WEBP" | string;
+    prettyPrint?: boolean;
+    overlayHiddenDelayMillis?: number;
+    /** 与 Kotlin handleUploadLogs / AssistsLogDiagnostics.uploadLogs 的 uploadKey 一致 */
+    uploadKey?: string;
+}
+/** 与 Kotlin assistsLogUploadResultToJson 对齐 */
+interface LogUploadResult {
+    success: boolean;
+    message: string;
+    httpCode?: number;
+    responseBody?: string;
+    data?: unknown;
+    localLogFilePath?: string;
+    localScreenshotFilePath?: string;
+    localNodeTreeFilePath?: string;
+    causeMessage?: string;
+}
+declare class Log {
+    private getBridge;
+    private asyncCall;
+    /** 读取当前日志全文 */
+    readAllText(timeout?: number): Promise<string>;
+    /**
+     * 获取日志服务当前域名（origin，无路径；与上传、管理后台同源）。
+     * 与 Kotlin getLogServiceBaseUrl / adminWebBaseUrl 对齐。
+     */
+    getLogServiceBaseUrl(timeout?: number): Promise<string>;
+    /** 清空日志 */
+    clear(timeout?: number): Promise<boolean>;
+    /** 从文件重新加载到内存 Flow */
+    refreshFromFile(timeout?: number): Promise<boolean>;
+    /** 追加一行 */
+    appendLine(line: string, maxLength?: number, timeout?: number): Promise<boolean>;
+    /** 追加带时间戳的条目 */
+    appendTimestampedEntry(message: string, timeout?: number): Promise<boolean>;
+    /** 替换全部内容 */
+    replaceAll(content: string, timeout?: number): Promise<boolean>;
+    /**
+     * 订阅 Flow：先收到 subscribed，再多次 update。
+     * resolve 后请保留 dispose 或调用 unsubscribe(subscriptionId) 以释放原生协程与 JS 回调。
+     */
+    subscribe(stream: LogStreamType, onUpdate: (payload: LogSubscribeUpdatePayload) => void, options?: {
+        timeout?: number;
+    }): Promise<{
+        subscriptionId: string;
+        dispose: () => Promise<void>;
+    }>;
+    /** 取消订阅（与 Kotlin handleUnsubscribe 对齐） */
+    unsubscribe(subscriptionId: string, timeout?: number): Promise<boolean>;
+    /** 截图 + 节点树 + 日志上传（需 Android API 30+） */
+    uploadLogs(options?: LogUploadOptions & {
+        timeout?: number;
+    }): Promise<LogUploadResult>;
+    /**
+     * 注册 onAssistsLogUpdate 推送监听（ASWebView 注入的 Base64 CallResponse，解码后见 LogUpdateEvent）
+     */
+    addLogUpdateListener(listener: (payload: LogUpdateEvent) => void): void;
+    /**
+     * 移除先前通过 addLogUpdateListener 注册的同一函数引用
+     */
+    removeLogUpdateListener(listener: (payload: LogUpdateEvent) => void): void;
+}
+/** 默认单例，用法与 floatingwindow 模块导出的 float 一致 */
+declare const log: Log;
+
+export { type AccessibilityEvent, type AccessibilityEventData, AccessibilityEventFilter, type AccessibilityEventFilterConfig, type AccessibilityEventListener, AppInfo, AssistsX, AssistsXAsync, BarUtils, BarUtilsCallMethod, type BarUtilsCallMethodType, Bounds, CallMethod, type CallMethodType, CallResponse, type Contact, DeviceInfo, FileIO, type FileInfo, type FileListItem, type FileUploadInfo, FileUtils, Float, FloatCallMethod, type FloatCallMethodType, Gallery, type GalleryDeleteResponse, type GalleryResponse, Http, type HttpConfig, type HttpDownloadResponse, type HttpResponse, type ImageProcessResult, type ImageRotateDegree, type ImageSaveResult, type ImageSize, type ImageType, ImageUtils, Ime, ImeAction, type IsCurrentInputMethodResponse, type IsInputMethodEnabledResponse, Log, LogCallMethod, type LogCallMethodType, LogStream, type LogStreamType, type LogSubscribeUpdatePayload, type LogUpdateData, type LogUpdateEvent, type LogUploadOptions, type LogUploadResult, Mlkit, MlkitCallMethod, type MlkitCallMethodType, type MlkitRegion, Node, NodeAsync, NodeClassValue, type OpenInputMethodSettingsResponse, Path, type PerformEditorActionResponse, type RecognizeTextInScreenshotPosition, type RecognizeTextInScreenshotResult, type RecognizeTextRegion, type Screen, type ScreenTextJsonResult, type ScreenTextRecognitionResult, Step, StepAsync, StepError, type StepImpl, type StepInterceptor, type StepResult, type StepState, type StepStatus, StepStopError, type TextPosition, type WebFloatingWindowOptions, WindowFlags, accessibilityEventListeners, barUtils, callbacks, decodeBase64UTF8, fileIO, fileUtils, float, gallery, generateUUID, http, imageUtils, ime, log, logUpdateListeners, mlkit, pathUtils, screen, sleep, useStepStore };

package/dist/index.d.ts

@@ -4111,4 +4111,121 @@ declare const FloatCallMethod: {
 };
 type FloatCallMethodType = (typeof FloatCallMethod)[keyof typeof FloatCallMethod];
 
-export { type AccessibilityEvent, type AccessibilityEventData, AccessibilityEventFilter, type AccessibilityEventFilterConfig, type AccessibilityEventListener, AppInfo, AssistsX, AssistsXAsync, BarUtils, BarUtilsCallMethod, type BarUtilsCallMethodType, Bounds, CallMethod, type CallMethodType, CallResponse, type Contact, DeviceInfo, FileIO, type FileInfo, type FileListItem, type FileUploadInfo, FileUtils, Float, FloatCallMethod, type FloatCallMethodType, Gallery, type GalleryDeleteResponse, type GalleryResponse, Http, type HttpConfig, type HttpDownloadResponse, type HttpResponse, type ImageProcessResult, type ImageRotateDegree, type ImageSaveResult, type ImageSize, type ImageType, ImageUtils, Ime, ImeAction, type IsCurrentInputMethodResponse, type IsInputMethodEnabledResponse, Mlkit, MlkitCallMethod, type MlkitCallMethodType, type MlkitRegion, Node, NodeAsync, NodeClassValue, type OpenInputMethodSettingsResponse, Path, type PerformEditorActionResponse, type RecognizeTextInScreenshotPosition, type RecognizeTextInScreenshotResult, type RecognizeTextRegion, type Screen, type ScreenTextJsonResult, type ScreenTextRecognitionResult, Step, StepAsync, StepError, type StepImpl, type StepInterceptor, type StepResult, type StepState, type StepStatus, StepStopError, type TextPosition, type WebFloatingWindowOptions, WindowFlags, accessibilityEventListeners, barUtils, callbacks, decodeBase64UTF8, fileIO, fileUtils, float, gallery, generateUUID, http, imageUtils, ime, mlkit, pathUtils, screen, sleep, useStepStore };
+/**
+ * 日志桥接方法名（与 tools/log/AssistsLogCallMethod.kt 一致）
+ */
+declare const LogCallMethod: {
+    readonly readAllText: "readAllText";
+    readonly clear: "clear";
+    readonly refreshFromFile: "refreshFromFile";
+    readonly appendLine: "appendLine";
+    readonly appendTimestampedEntry: "appendTimestampedEntry";
+    readonly replaceAll: "replaceAll";
+    readonly subscribe: "subscribe";
+    readonly unsubscribe: "unsubscribe";
+    readonly uploadLogs: "uploadLogs";
+    /** 获取日志服务当前域名（origin，无路径；与上传、管理后台同源），对应 AssistsLogDiagnostics.adminWebBaseUrl() */
+    readonly getLogServiceBaseUrl: "getLogServiceBaseUrl";
+};
+/** 与 ASWebView / AssistsLogJavascriptInterface companion 对齐 */
+declare const LogStream: {
+    readonly latestLine: "latestLine";
+    readonly entireLogText: "entireLogText";
+};
+type LogStreamType = (typeof LogStream)[keyof typeof LogStream];
+type LogCallMethodType = (typeof LogCallMethod)[keyof typeof LogCallMethod];
+
+/**
+ * onAssistsLogUpdate 推送的监听器列表（与 accessibilityEventListeners 风格一致）。
+ * 在页面加载本模块后，向此数组 push，或使用 log.addLogUpdateListener。
+ * 注意：若页面在 import 本模块之前已自定义 `window.onAssistsLogUpdate`，则不会安装默认分发函数，需自行解码并转发到监听器。
+ */
+declare const logUpdateListeners: Array<(payload: LogUpdateEvent) => void>;
+/**
+ * Base64 解码后的 CallResponse，data 含 stream / text
+ */
+interface LogUpdateEvent {
+    code: number;
+    data: LogUpdateData | null;
+    message?: string;
+    callbackId?: string | null;
+}
+interface LogUpdateData {
+    stream: LogStreamType;
+    text: string;
+}
+interface LogSubscribeUpdatePayload {
+    text: string;
+    stream: string;
+    subscriptionId: string;
+}
+interface LogUploadOptions {
+    baseUrl?: string;
+    /** PNG（默认）| JPEG | JPG | WEBP */
+    format?: "PNG" | "JPEG" | "JPG" | "WEBP" | string;
+    prettyPrint?: boolean;
+    overlayHiddenDelayMillis?: number;
+    /** 与 Kotlin handleUploadLogs / AssistsLogDiagnostics.uploadLogs 的 uploadKey 一致 */
+    uploadKey?: string;
+}
+/** 与 Kotlin assistsLogUploadResultToJson 对齐 */
+interface LogUploadResult {
+    success: boolean;
+    message: string;
+    httpCode?: number;
+    responseBody?: string;
+    data?: unknown;
+    localLogFilePath?: string;
+    localScreenshotFilePath?: string;
+    localNodeTreeFilePath?: string;
+    causeMessage?: string;
+}
+declare class Log {
+    private getBridge;
+    private asyncCall;
+    /** 读取当前日志全文 */
+    readAllText(timeout?: number): Promise<string>;
+    /**
+     * 获取日志服务当前域名（origin，无路径；与上传、管理后台同源）。
+     * 与 Kotlin getLogServiceBaseUrl / adminWebBaseUrl 对齐。
+     */
+    getLogServiceBaseUrl(timeout?: number): Promise<string>;
+    /** 清空日志 */
+    clear(timeout?: number): Promise<boolean>;
+    /** 从文件重新加载到内存 Flow */
+    refreshFromFile(timeout?: number): Promise<boolean>;
+    /** 追加一行 */
+    appendLine(line: string, maxLength?: number, timeout?: number): Promise<boolean>;
+    /** 追加带时间戳的条目 */
+    appendTimestampedEntry(message: string, timeout?: number): Promise<boolean>;
+    /** 替换全部内容 */
+    replaceAll(content: string, timeout?: number): Promise<boolean>;
+    /**
+     * 订阅 Flow：先收到 subscribed，再多次 update。
+     * resolve 后请保留 dispose 或调用 unsubscribe(subscriptionId) 以释放原生协程与 JS 回调。
+     */
+    subscribe(stream: LogStreamType, onUpdate: (payload: LogSubscribeUpdatePayload) => void, options?: {
+        timeout?: number;
+    }): Promise<{
+        subscriptionId: string;
+        dispose: () => Promise<void>;
+    }>;
+    /** 取消订阅（与 Kotlin handleUnsubscribe 对齐） */
+    unsubscribe(subscriptionId: string, timeout?: number): Promise<boolean>;
+    /** 截图 + 节点树 + 日志上传（需 Android API 30+） */
+    uploadLogs(options?: LogUploadOptions & {
+        timeout?: number;
+    }): Promise<LogUploadResult>;
+    /**
+     * 注册 onAssistsLogUpdate 推送监听（ASWebView 注入的 Base64 CallResponse，解码后见 LogUpdateEvent）
+     */
+    addLogUpdateListener(listener: (payload: LogUpdateEvent) => void): void;
+    /**
+     * 移除先前通过 addLogUpdateListener 注册的同一函数引用
+     */
+    removeLogUpdateListener(listener: (payload: LogUpdateEvent) => void): void;
+}
+/** 默认单例，用法与 floatingwindow 模块导出的 float 一致 */
+declare const log: Log;
+
+export { type AccessibilityEvent, type AccessibilityEventData, AccessibilityEventFilter, type AccessibilityEventFilterConfig, type AccessibilityEventListener, AppInfo, AssistsX, AssistsXAsync, BarUtils, BarUtilsCallMethod, type BarUtilsCallMethodType, Bounds, CallMethod, type CallMethodType, CallResponse, type Contact, DeviceInfo, FileIO, type FileInfo, type FileListItem, type FileUploadInfo, FileUtils, Float, FloatCallMethod, type FloatCallMethodType, Gallery, type GalleryDeleteResponse, type GalleryResponse, Http, type HttpConfig, type HttpDownloadResponse, type HttpResponse, type ImageProcessResult, type ImageRotateDegree, type ImageSaveResult, type ImageSize, type ImageType, ImageUtils, Ime, ImeAction, type IsCurrentInputMethodResponse, type IsInputMethodEnabledResponse, Log, LogCallMethod, type LogCallMethodType, LogStream, type LogStreamType, type LogSubscribeUpdatePayload, type LogUpdateData, type LogUpdateEvent, type LogUploadOptions, type LogUploadResult, Mlkit, MlkitCallMethod, type MlkitCallMethodType, type MlkitRegion, Node, NodeAsync, NodeClassValue, type OpenInputMethodSettingsResponse, Path, type PerformEditorActionResponse, type RecognizeTextInScreenshotPosition, type RecognizeTextInScreenshotResult, type RecognizeTextRegion, type Screen, type ScreenTextJsonResult, type ScreenTextRecognitionResult, Step, StepAsync, StepError, type StepImpl, type StepInterceptor, type StepResult, type StepState, type StepStatus, StepStopError, type TextPosition, type WebFloatingWindowOptions, WindowFlags, accessibilityEventListeners, barUtils, callbacks, decodeBase64UTF8, fileIO, fileUtils, float, gallery, generateUUID, http, imageUtils, ime, log, logUpdateListeners, mlkit, pathUtils, screen, sleep, useStepStore };