@midscene/shared 1.7.10-beta-20260508024212.0 → 1.7.10

package/dist/es/env/parse-model-config.mjs

@@ -5,7 +5,7 @@ import { assert } from "../utils.mjs";
 import { maskConfig, parseJson } from "./helper.mjs";
 import { initDebugConfig } from "./init-debug.mjs";
 const MODEL_CONFIG_DOC_URL = 'https://midscenejs.com/model-common-config.html';
-const getCurrentVersion = ()=>"1.7.10-beta-20260508024212.0";
+const getCurrentVersion = ()=>"1.7.10";
 const getInvalidModelFamilyMessage = (modelFamily)=>`Invalid MIDSCENE_MODEL_FAMILY value: ${modelFamily}. Current version v${getCurrentVersion()} accepts the following model families: ${MODEL_FAMILY_VALUES.join(', ')}. You can also visit ${MODEL_CONFIG_DOC_URL} for the latest configuration information.`;
 const KEYS_MAP = {
     insight: INSIGHT_MODEL_CONFIG_KEYS,

package/dist/es/img/index.mjs

@@ -1,4 +1,4 @@
-import { imageInfoOfBase64, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer } from "./info.mjs";
+import { imageInfoOfBase64, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer, validateScreenshotBuffer } from "./info.mjs";
 import { createImgBase64ByFormat, cropByRect, httpImg2Base64, localImg2Base64, paddingToMatchBlockByBase64, parseBase64, preProcessImageUrl, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, zoomForGPT4o } from "./transform.mjs";
 import { annotateRects, compositeElementInfoImg, processImageElementInfo } from "./box-select.mjs";
-export { annotateRects, compositeElementInfoImg, createImgBase64ByFormat, cropByRect, httpImg2Base64, imageInfoOfBase64, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer, localImg2Base64, paddingToMatchBlockByBase64, parseBase64, preProcessImageUrl, processImageElementInfo, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, zoomForGPT4o };
+export { annotateRects, compositeElementInfoImg, createImgBase64ByFormat, cropByRect, httpImg2Base64, imageInfoOfBase64, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer, localImg2Base64, paddingToMatchBlockByBase64, parseBase64, preProcessImageUrl, processImageElementInfo, resizeAndConvertImgBuffer, resizeImgBase64, saveBase64Image, scaleImage, validateScreenshotBuffer, zoomForGPT4o };

package/dist/es/img/info.mjs

@@ -26,4 +26,10 @@ function isValidJPEGImageBuffer(buffer) {
 function isValidImageBuffer(buffer) {
     return isValidPNGImageBuffer(buffer) || isValidJPEGImageBuffer(buffer);
 }
-export { imageInfoOfBase64, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer };
+function validateScreenshotBuffer(screenshotBuffer, { label, minBufferSize = 0 }) {
+    const bufferSize = screenshotBuffer?.length ?? 0;
+    if (!screenshotBuffer || 0 === bufferSize) throw new Error(`${label} validation failed: buffer size ${bufferSize} bytes`);
+    if (!isValidImageBuffer(screenshotBuffer)) throw new Error(`${label} buffer has invalid image format`);
+    if (minBufferSize > 0 && bufferSize < minBufferSize) throw new Error(`${label} validation failed: buffer size ${bufferSize} bytes (minimum: ${minBufferSize})`);
+}
+export { imageInfoOfBase64, isValidImageBuffer, isValidJPEGImageBuffer, isValidPNGImageBuffer, validateScreenshotBuffer };

package/dist/lib/env/parse-model-config.js

@@ -37,7 +37,7 @@ const external_utils_js_namespaceObject = require("../utils.js");
 const external_helper_js_namespaceObject = require("./helper.js");
 const external_init_debug_js_namespaceObject = require("./init-debug.js");
 const MODEL_CONFIG_DOC_URL = 'https://midscenejs.com/model-common-config.html';
-const getCurrentVersion = ()=>"1.7.10-beta-20260508024212.0";
+const getCurrentVersion = ()=>"1.7.10";
 const getInvalidModelFamilyMessage = (modelFamily)=>`Invalid MIDSCENE_MODEL_FAMILY value: ${modelFamily}. Current version v${getCurrentVersion()} accepts the following model families: ${external_types_js_namespaceObject.MODEL_FAMILY_VALUES.join(', ')}. You can also visit ${MODEL_CONFIG_DOC_URL} for the latest configuration information.`;
 const KEYS_MAP = {
     insight: external_constants_js_namespaceObject.INSIGHT_MODEL_CONFIG_KEYS,

package/dist/lib/img/index.js

@@ -31,6 +31,7 @@ __webpack_require__.d(__webpack_exports__, {
     resizeImgBase64: ()=>external_transform_js_namespaceObject.resizeImgBase64,
     saveBase64Image: ()=>external_transform_js_namespaceObject.saveBase64Image,
     isValidImageBuffer: ()=>external_info_js_namespaceObject.isValidImageBuffer,
+    validateScreenshotBuffer: ()=>external_info_js_namespaceObject.validateScreenshotBuffer,
     preProcessImageUrl: ()=>external_transform_js_namespaceObject.preProcessImageUrl,
     annotateRects: ()=>external_box_select_js_namespaceObject.annotateRects,
     compositeElementInfoImg: ()=>external_box_select_js_namespaceObject.compositeElementInfoImg,
@@ -65,6 +66,7 @@ exports.resizeAndConvertImgBuffer = __webpack_exports__.resizeAndConvertImgBuffe
 exports.resizeImgBase64 = __webpack_exports__.resizeImgBase64;
 exports.saveBase64Image = __webpack_exports__.saveBase64Image;
 exports.scaleImage = __webpack_exports__.scaleImage;
+exports.validateScreenshotBuffer = __webpack_exports__.validateScreenshotBuffer;
 exports.zoomForGPT4o = __webpack_exports__.zoomForGPT4o;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "annotateRects",
@@ -85,6 +87,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "resizeImgBase64",
     "saveBase64Image",
     "scaleImage",
+    "validateScreenshotBuffer",
     "zoomForGPT4o"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/lib/img/info.js

@@ -35,6 +35,7 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     isValidPNGImageBuffer: ()=>isValidPNGImageBuffer,
     isValidImageBuffer: ()=>isValidImageBuffer,
+    validateScreenshotBuffer: ()=>validateScreenshotBuffer,
     imageInfoOfBase64: ()=>imageInfoOfBase64,
     isValidJPEGImageBuffer: ()=>isValidJPEGImageBuffer
 });
@@ -68,15 +69,23 @@ function isValidJPEGImageBuffer(buffer) {
 function isValidImageBuffer(buffer) {
     return isValidPNGImageBuffer(buffer) || isValidJPEGImageBuffer(buffer);
 }
+function validateScreenshotBuffer(screenshotBuffer, { label, minBufferSize = 0 }) {
+    const bufferSize = screenshotBuffer?.length ?? 0;
+    if (!screenshotBuffer || 0 === bufferSize) throw new Error(`${label} validation failed: buffer size ${bufferSize} bytes`);
+    if (!isValidImageBuffer(screenshotBuffer)) throw new Error(`${label} buffer has invalid image format`);
+    if (minBufferSize > 0 && bufferSize < minBufferSize) throw new Error(`${label} validation failed: buffer size ${bufferSize} bytes (minimum: ${minBufferSize})`);
+}
 exports.imageInfoOfBase64 = __webpack_exports__.imageInfoOfBase64;
 exports.isValidImageBuffer = __webpack_exports__.isValidImageBuffer;
 exports.isValidJPEGImageBuffer = __webpack_exports__.isValidJPEGImageBuffer;
 exports.isValidPNGImageBuffer = __webpack_exports__.isValidPNGImageBuffer;
+exports.validateScreenshotBuffer = __webpack_exports__.validateScreenshotBuffer;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "imageInfoOfBase64",
     "isValidImageBuffer",
     "isValidJPEGImageBuffer",
-    "isValidPNGImageBuffer"
+    "isValidPNGImageBuffer",
+    "validateScreenshotBuffer"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/types/img/index.d.ts

@@ -1,3 +1,3 @@
-export { imageInfoOfBase64, isValidPNGImageBuffer, isValidJPEGImageBuffer, isValidImageBuffer, } from './info';
+export { imageInfoOfBase64, isValidPNGImageBuffer, isValidJPEGImageBuffer, isValidImageBuffer, validateScreenshotBuffer, type ValidateScreenshotBufferOptions, } from './info';
 export { resizeAndConvertImgBuffer, resizeImgBase64, zoomForGPT4o, saveBase64Image, paddingToMatchBlockByBase64, cropByRect, scaleImage, localImg2Base64, httpImg2Base64, preProcessImageUrl, parseBase64, createImgBase64ByFormat, } from './transform';
 export { processImageElementInfo, compositeElementInfoImg, annotateRects, } from './box-select';

package/dist/types/img/info.d.ts

@@ -27,3 +27,8 @@ export declare function isValidJPEGImageBuffer(buffer: Buffer): boolean;
  * @returns true if the Buffer is a valid PNG or JPEG image, otherwise false
  */
 export declare function isValidImageBuffer(buffer: Buffer): boolean;
+export interface ValidateScreenshotBufferOptions {
+    label: string;
+    minBufferSize?: number;
+}
+export declare function validateScreenshotBuffer(screenshotBuffer: Buffer | undefined, { label, minBufferSize }: ValidateScreenshotBufferOptions): asserts screenshotBuffer is Buffer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/shared",
-  "version": "1.7.10-beta-20260508024212.0",
+  "version": "1.7.10",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "types": "./dist/types/index.d.ts",

package/src/img/index.ts

@@ -3,6 +3,8 @@ export {
   isValidPNGImageBuffer,
   isValidJPEGImageBuffer,
   isValidImageBuffer,
+  validateScreenshotBuffer,
+  type ValidateScreenshotBufferOptions,
 } from './info';
 export {
   resizeAndConvertImgBuffer,

package/src/img/info.ts

@@ -73,3 +73,30 @@ export function isValidJPEGImageBuffer(buffer: Buffer): boolean {
 export function isValidImageBuffer(buffer: Buffer): boolean {
   return isValidPNGImageBuffer(buffer) || isValidJPEGImageBuffer(buffer);
 }
+
+export interface ValidateScreenshotBufferOptions {
+  label: string;
+  minBufferSize?: number;
+}
+
+export function validateScreenshotBuffer(
+  screenshotBuffer: Buffer | undefined,
+  { label, minBufferSize = 0 }: ValidateScreenshotBufferOptions,
+): asserts screenshotBuffer is Buffer {
+  const bufferSize = screenshotBuffer?.length ?? 0;
+  if (!screenshotBuffer || bufferSize === 0) {
+    throw new Error(
+      `${label} validation failed: buffer size ${bufferSize} bytes`,
+    );
+  }
+
+  if (!isValidImageBuffer(screenshotBuffer)) {
+    throw new Error(`${label} buffer has invalid image format`);
+  }
+
+  if (minBufferSize > 0 && bufferSize < minBufferSize) {
+    throw new Error(
+      `${label} validation failed: buffer size ${bufferSize} bytes (minimum: ${minBufferSize})`,
+    );
+  }
+}