ms-types 0.0.8 → 0.0.9

package/package.json

@@ -1,29 +1,19 @@
 {
   "name": "ms-types",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
   "files": [
-    "dist"
+    "types"
   ],
-  "main": "./dist/MSTypes.umd.cjs",
-  "module": "./dist/MSTypes.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    "types": "./dist/index.d.ts",
-    "import": "./dist/MSTypes.js",
-    "require": "./dist/MSTypes.umd.cjs"
-  },
-  "scripts": {
-    "build": "tsc && vite build",
-    "prepublishOnly": "npm run build"
-  },
-  "devDependencies": {
-    "typescript": "~5.8.3",
-    "vite": "^7.0.0",
-    "vite-plugin-dts": "^4.5.4"
+  "typesVersions": {
+    "*": {
+      "*": [
+        "types/*"
+      ]
+    }
   }
 }

package/types/action.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 操作相关函数
+ */
+declare namespace action {
+  /**
+   * 点击
+   * @param x 坐标x
+   * @param y 坐标y
+   * @param duration 持续时间
+   * @param jitter 抖动
+   * @returns 点击是否成功
+   */
+  function click(
+    x: number,
+    y: number,
+    duration: number,
+    jitter: boolean
+  ): boolean;
+  /**
+   * 滑动
+   * @param startX 起始坐标x
+   * @param startY 起始坐标y
+   * @param endX 结束坐标x
+   * @param endY 结束坐标y
+   * @param duration 持续时间
+   * @param jitter 抖动
+   * @param steps 步数
+   * @returns 滑动是否成功
+   */
+  function swipe(
+    startX: number,
+    startY: number,
+    endX: number,
+    endY: number,
+    duration: number,
+    jitter: boolean,
+    steps: number
+  ): boolean;
+  /**
+   * 长按滑动
+   * @param startX 起始坐标x
+   * @param startY 起始坐标y
+   * @param endX 结束坐标x
+   * @param endY 结束坐标y
+   * @param touch_down_duration 按下持续时间
+   * @param touch_move_duration 移动持续时间
+   * @param touch_up_duration 松开持续时间
+   * @param jitter 抖动
+   * @param steps 步数
+   * @returns 长按滑动是否成功
+   */
+  function pressAndSwipe(
+    startX: number,
+    startY: number,
+    endX: number,
+    endY: number,
+    touch_down_duration: number,
+    touch_move_duration: number,
+    touch_up_duration: number,
+    jitter: boolean,
+    steps: number
+  ): boolean;
+  /**
+   * 返回首页
+   * @returns 返回首页是否成功
+   */
+  function homeScreen(): boolean;
+  /**
+   * 按下按钮
+   * @param button 按钮
+   * @returns 按下按钮是否成功
+   */
+  function pressButton(button: "home" | "volumeup" | "volumedown"): boolean;
+  /**
+   * 按下HID按钮
+   * @param button HID按钮
+   * @param duration 持续时间
+   * @returns 按下HID按钮是否成功
+   */
+  function pressHidButton(
+    button: "home" | "volumeup" | "volumedown" | "power" | "snapshot",
+    duration: number
+  ): boolean;
+}

package/types/config.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 配置相关函数
+ */
+declare namespace config {
+  /**
+   * 读取配置
+   * @param key 配置key
+   * @returns 配置值
+   */
+  function readConfig(key: string): any;
+  /**
+   * 删除配置
+   * @param key 配置key
+   * @returns 删除是否成功
+   */
+  function deleteConfig(key: string): boolean;
+  /**
+   * 更新配置
+   * @param key 配置key
+   * @param value 配置值
+   * @returns 更新是否成功
+   */
+  function updateConfig(key: string, value: any): boolean;
+  /**
+   * 读取配置Int
+   * @param key 配置key
+   * @returns 配置值
+   */
+  function readConfigInt(key: string): number;
+  /**
+   * 读取配置Double
+   * @param key 配置key
+   * @returns 配置值
+   */
+  function readConfigDouble(key: string): number;
+  /**
+   * 读取配置String
+   * @param key 配置key
+   * @returns 配置值
+   */
+  function readConfigString(key: string): string;
+  /**
+   * 读取配置Bool
+   * @param key 配置key
+   * @returns 配置值
+   */
+  function readConfigBool(key: string): boolean;
+  /**
+   * 获取所有配置JSON
+   * @returns 所有配置JSON
+   */
+  function getConfigJSON(): Record<string, any>;
+}

package/types/device.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 设备相关函数
+ */
+declare namespace device {
+  /**
+   * 获取电池信息
+   * @returns 电池信息
+   */
+  function getBatteryInfo(): {
+    /**
+     * 电池电量
+     */
+    level: number;
+    /**
+     * 是否充电
+     */
+    isCharging: boolean;
+  };
+  /**
+   * 获取设备UDID
+   * @returns 设备UDID
+   */
+  function getDeviceUDID(): string;
+  /**
+   * 获取设备名称
+   * @returns 设备名称
+   */
+  function getDeviceName(): string;
+  /**
+   * 获取设备型号
+   * @returns 设备型号
+   */
+  function getDeviceModel(): string;
+  /**
+   * 获取屏幕大小
+   * @returns 屏幕大小
+   */
+  function getScreenSize(): {
+    width: number;
+    height: number;
+  };
+  /**
+   * 获取屏幕缩放比例
+   * @returns 屏幕缩放比例
+   */
+  function getScreenScale(): number;
+  /**
+   * 获取设备方向
+   * @returns 设备方向
+   */
+  function getOrientation(): "PORTRAIT" | "LANDSCAPE";
+  /**
+   * 获取系统版本
+   * @returns 系统版本
+   */
+  function getOSVersion(): string;
+  /**
+   * 获取局域网IP
+   * @returns 局域网IP
+   */
+  function getLanIp(): string;
+  /**
+   * 振动
+   * @param duration 持续时间
+   * @param intensity 强度 0.0-1.0
+   */
+  function vibrate(duration: number, intensity: number): void;
+}

package/types/file.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 文件相关函数
+ */
+declare namespace file {
+  /**
+   * 获取应用内部目录
+   * @param type 目录类型
+   * @returns 目录路径
+   */
+  function getInternalDir(
+    type: "documents" | "library" | "temp" | "libraryCaches"
+  ): string;
+  /**
+   * 获取应用数据目录
+   * @returns 目录路径
+   */
+  function getDataDir(): string;
+  /**
+   * 获取应用数据文件路径
+   * @param file 文件名
+   * @returns 文件路径
+   */
+  function getDataFile(file: string): string;
+  /**
+   * 创建文件
+   * @param path 文件路径
+   * @returns 是否创建成功
+   */
+  function create(path: string): boolean;
+  /**
+   * 创建目录
+   * @param path 目录路径
+   * @returns 是否创建成功
+   */
+  function mkdirs(path: string): boolean;
+  /**
+   * 删除文件或目录
+   * @param path 文件或目录路径
+   * @returns 是否删除成功
+   */
+  function deleteAllFile(path: string): boolean;
+  /**
+   * 读取文件内容
+   * @param path 文件路径
+   * @returns 文件内容
+   */
+  function readFile(path: string): string;
+  /**
+   * 删除文件内容
+   * @param path 文件路径
+   * @param line 行号 如果是-1 代表这个条件不生效
+   * @param contains 包含内容 如果是null 代表这个条件不生效
+   * @returns 是否删除成功
+   */
+  function deleteLine(path: string, line: number, contains?: string): boolean;
+  /**
+   * 列出目录下所有文件
+   * @param path 目录路径
+   * @param recursion 是否递归
+   * @returns 文件路径数组
+   */
+  function listDir(path: string, recursion: boolean): string[];
+  /**
+   * 写入文件内容
+   * @param path 文件路径
+   * @param content 文件内容
+   * @returns 是否写入成功
+   */
+  function writeFile(path: string, content: string): boolean;
+  /**
+   * 追加文件内容
+   * @param path 文件路径
+   * @param content 文件内容
+   * @returns 是否追加成功
+   */
+  function appendLine(path: string, content: string): boolean;
+  /**
+   * 读取文件第N行内容
+   * @param path 文件路径
+   * @param lineNo 行号
+   * @returns 行内容
+   */
+  function readLine(path: string, lineNo: number): string;
+  /**
+   * 读取文件所有行内容
+   * @param path 文件路径
+   * @returns 行内容数组
+   */
+  function readAllLines(path: string): string[];
+  /**
+   * 文件或者文件夹是否存在
+   * @param path 文件路径
+   * @returns 是否存在
+   */
+  function exists(path: string): boolean;
+  /**
+   * 复制文件
+   * @param src 源文件路径
+   * @param dest 目标文件路径
+   * @returns 是否复制成功
+   */
+  function copy(src: string, dest: string): boolean;
+  /**
+   * 获取文件MD5值
+   * @param path 文件路径
+   * @returns 文件MD5值
+   */
+  function fileMD5(path: string): string?;
+}

package/types/global.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 是否是调试模式
+ */
+declare const __debug__: boolean;
+/**
+ * 是否应该退出应用
+ */
+declare const __shouldExit__: boolean;
+/**
+ * 应用版本
+ */
+declare const __appVersion__: string;
+/**
+ * 应用构建号
+ */
+declare const __appBuildNumber__: string;
+/**
+ * 应用名称
+ */
+declare const __appName__: string;
+/**
+ * 应用 bundleId
+ */
+declare const __bundleId__: string;
+/**
+ * 应用包信息
+ */
+declare const __package__: {
+  /**
+   * 应用名称
+   */
+  name: string;
+  /**
+   * 应用版本
+   */
+  version: string;
+  /**
+   * 应用描述
+   */
+  description: string;
+  [key: string]: any;
+};
+
+/**
+ * 线程睡眠
+ * @param ms 毫秒
+ */
+declare function sleep(ms: number): void;
+/**
+ * 退出应用
+ */
+declare function exit(): void;
+/**
+ * 获取当前时间戳
+ * @returns 时间戳
+ */
+declare function time(): number;
+/**
+ * 把 app 切换到前台
+ */
+declare function takeMeToFront(): void;

package/types/http.d.ts

@@ -0,0 +1,270 @@
+declare namespace http {
+  /**
+   * 通用发送HTTP请求
+   * @param params 请求参数
+   * @returns 请求结果
+   */
+  function request(params: {
+    /**
+     * 请求地址
+     */
+    url: string;
+    /**
+     * 请求超时时间
+     */
+    timeout?: number;
+    /**
+     * 请求方法 GET POST PUT DELETE PATCH HEAD OPTIONS
+     */
+    method?: string;
+    /**
+     * 代理服务器
+     */
+    proxy?: {
+      /**
+       * 代理服务器地址
+       */
+      host: string;
+      /**
+       * 代理服务器端口
+       */
+      port: number;
+    };
+    /**
+     * 是否跟随重定向
+     */
+    followRedirects?: boolean;
+    /**
+     * 请求体 仅在POST方法下有效 json 需要进行JSON.stringify
+     */
+    requestBody?: string;
+    /**
+     * 请求头
+     */
+    userAgent?: string;
+    /**
+     * 是否忽略内容类型
+     */
+    ignoreContentType?: boolean;
+    /**
+     * 是否忽略HTTP错误
+     */
+    ignoreHttpErrors?: boolean;
+    /**
+     * 最大响应体大小 默认 10MB
+     */
+    maxBodySize?: number;
+    /**
+     * 引用来源
+     */
+    referrer?: string;
+    /**
+     * 请求头
+     */
+    header?: Record<string, string>;
+    /**
+     * Cookie
+     */
+    cookie?: Record<string, string>;
+    /**
+     * 请求参数
+     */
+    data?: Record<string, any>;
+    /**
+     * 请求文件
+     */
+    file?: Record<string, string>;
+    /**
+     * 响应字符集
+     */
+    responseCharset?: string;
+  }): {
+    /**
+     * 响应头
+     */
+    header: Record<string, string>;
+    /**
+     * 响应Cookie
+     */
+    cookie: Record<string, string>;
+    /**
+     * 响应状态码
+     */
+    statusCode: number;
+    /**
+     * 响应状态消息
+     */
+    statusMessage: string;
+    /**
+     * 响应字符集
+     */
+    charset: string;
+    /**
+     * 响应内容类型
+     */
+    contentType: string;
+    /**
+     * 响应体
+     */
+    body: string;
+  };
+
+  /**
+   * 下载文件 支持断点续传
+   * @param url 请求地址
+   * @param file 文件路径
+   * @param timeout 超时时间
+   * @param headers 请求头
+   * @returns 下载是否成功
+   */
+  function downloadFile(
+    url: string,
+    file: string,
+    timeout?: number,
+    headers?: Record<string, string>
+  ): boolean;
+
+  /**
+   * 发送GET请求
+   * @param url 请求地址
+   * @param params 请求参数
+   * @param timeout 超时时间
+   * @param headers 请求头
+   * @returns 请求结果
+   */
+  function httpGet(
+    url: string,
+    params?: Record<string, string>,
+    timeout?: number,
+    headers?: Record<string, string>
+  ): string;
+
+  /**
+   * 发送POST请求
+   * @param url 请求地址
+   * @param params 请求参数
+   * @param files 请求文件
+   * @param timeout 超时时间
+   * @param headers 请求头
+   * @returns 请求结果
+   */
+  function httpPost(
+    url: string,
+    params?: Record<string, string>,
+    files?: Record<string, string>,
+    timeout?: number,
+    headers?: Record<string, string>
+  ): string;
+
+  /**
+   * 发送JSON请求
+   * @param url 请求地址
+   * @param json 请求JSON数据
+   * @param timeout 超时时间
+   * @param headers 请求头
+   * @returns 请求结果
+   */
+  function postJSON(
+    url: string,
+    json?: Record<string, string>,
+    timeout?: number,
+    headers?: Record<string, string>
+  ): string;
+
+  interface WebSocket {
+    /**
+     * 连接WebSocket服务器
+     */
+    connect(): void;
+    /**
+     * 关闭WebSocket连接
+     */
+    close(): void;
+    /**
+     * 重置WebSocket连接
+     * @returns 重置是否成功
+     */
+    reset(): boolean;
+    /**
+     * 获取WebSocket是否已关闭
+     * @returns 是否已关闭
+     */
+    isClosed(): boolean;
+    /**
+     * 获取WebSocket是否已连接
+     * @returns 是否已连接
+     */
+    isConnected(): boolean;
+    /**
+     * 发送文本消息
+     * @param data 文本消息内容
+     */
+    sendText(data: string): void;
+    /**
+     * 发送二进制消息
+     * @param data 二进制消息内容
+     */
+    sendBinary(data: ArrayBuffer): void;
+    /**
+     * 设置打开回调
+     * @param callback 打开回调函数
+     */
+    onOpen(callback: () => void): void;
+    /**
+     * 设置关闭回调
+     * @param callback 关闭回调函数
+     */
+    onClose(callback: () => void): void;
+    /**
+     * 设置文本消息回调
+     * @param callback 文本消息回调函数
+     */
+    onText(callback: (data: string) => void): void;
+    /**
+     * 设置二进制消息回调
+     * @param callback 二进制消息回调函数
+     */
+    onBinary(callback: (data: ArrayBuffer) => void): void;
+    /**
+     * 设置错误回调
+     * @param callback 错误回调函数
+     */
+    onError(callback: (error: string) => void): void;
+    /**
+     * 设置连接超时时间
+     * @param timeout 超时时间，单位秒
+     */
+    setConnectionTimeout(timeout: number): void;
+    /**
+     * 设置写入超时时间
+     * @param timeout 超时时间，单位秒
+     */
+    setWriteTimeout(timeout: number): void;
+    /**
+     * 设置心跳间隔时间
+     * @param interval 间隔时间，单位秒
+     * @param callback 心跳回调函数
+     */
+    startHeartbeatInterval(interval: number, callback: () => string): void;
+    /**
+     * 停止心跳间隔
+     */
+    stopHeartbeatInterval(): void;
+    /**
+     * 设置自动重连
+     * @param autoReconnect 是否自动重连
+     */
+    setAutoReconnect(autoReconnect: boolean): void;
+  }
+
+  /**
+   * 创建WebSocket连接
+   * @param url 连接地址
+   * @param header 连接头
+   * @returns WebSocket连接对象
+   */
+  function newWebsocket(
+    url: string,
+    header?: Record<string, string>
+  ): WebSocket;
+}