@json-eval-rs/webcore 0.0.48 → 0.0.50

package/dist/index.d.ts

@@ -70,13 +70,28 @@ export interface DependentChange {
  * Options for creating a JSONEval instance
  */
 export interface JSONEvalOptions {
-    /** JSON schema object */
+    /**
+     * JSON schema object or MessagePack binary or cache key string.
+     * - If object: Standard JSON Schema
+     * - If Uint8Array: MessagePack encoded schema
+     * - If string (and fromCache=true): Cache key for pre-parsed schema
+     */
     schema: any;
-    /** Optional context data */
+    /**
+     * Optional context data accessible via $context in logic.
+     * Useful for user sessions, environment variables, etc.
+     */
     context?: any;
-    /** Optional initial data */
+    /**
+     * Optional initial data object to evaluate against.
+     * Can be updated later with reloadSchema.
+     */
     data?: any;
-    /** If true, schema is treated as a cache key */
+    /**
+     * If true, the `schema` parameter is treated as a string cache key
+     * to lookup a pre-parsed schema from the global cache.
+     * Default: false
+     */
     fromCache?: boolean;
 }
 /**
@@ -317,17 +332,28 @@ export interface CompileAndRunLogicOptions {
  * ```
  */
 export declare class JSONEvalCore {
+    /** Internal storage for the schema (JSON, MsgPack, or Cache Key) */
     private _schema;
+    /** Reference to the loaded WASM module */
     private _wasmModule;
+    /** Current context data */
     private _context;
+    /** Current evaluation data */
     private _data;
+    /** The underlying WASM JSONEval instance */
     private _instance;
+    /** Initialization state flag */
     private _ready;
+    /** Flag indicating if schema provided is binary MessagePack */
     private _isMsgpackSchema;
+    /** Flag indicating if schema is a cache key reference */
     private _isFromCache;
     /**
-     * @param wasmModule - WASM module (injected by wrapper package)
-     * @param options
+     * Create a new JSONEval Core instance.
+     * Does not initialize WASM immediately; wait for `init()` or call async methods.
+     *
+     * @param wasmModule - The loaded WASM module (provided by wrapper packages like @json-eval-rs/node or /vanilla)
+     * @param options - Configuration options containing schema, data, and context
      */
     constructor(wasmModule: any, { schema, context, data, fromCache }: JSONEvalOptions);
     /**

package/dist/index.js

@@ -49,11 +49,16 @@ export var ReturnFormat;
  */
 export class JSONEvalCore {
     /**
-     * @param wasmModule - WASM module (injected by wrapper package)
-     * @param options
+     * Create a new JSONEval Core instance.
+     * Does not initialize WASM immediately; wait for `init()` or call async methods.
+     *
+     * @param wasmModule - The loaded WASM module (provided by wrapper packages like @json-eval-rs/node or /vanilla)
+     * @param options - Configuration options containing schema, data, and context
      */
     constructor(wasmModule, { schema, context, data, fromCache = false }) {
+        /** The underlying WASM JSONEval instance */
         this._instance = null;
+        /** Initialization state flag */
         this._ready = false;
         this._schema = schema;
         this._wasmModule = wasmModule;
@@ -343,8 +348,7 @@ export class JSONEvalCore {
         await this.init();
         const logic = typeof logicStr === 'string' ? logicStr : JSON.stringify(logicStr);
         const result = await this._instance.compileAndRunLogic(logic, data ? JSON.stringify(data) : null, context ? JSON.stringify(context) : null);
-        // Parse result if it's a string
-        return typeof result === 'string' ? JSON.parse(result) : result;
+        return result;
     }
     /**
      * Compile JSON logic and return a global ID
@@ -360,8 +364,7 @@ export class JSONEvalCore {
     async runLogic(logicId, data, context) {
         await this.init();
         const result = await this._instance.runLogic(logicId, data ? JSON.stringify(data) : null, context ? JSON.stringify(context) : null);
-        // Parse result if it's a string
-        return typeof result === 'string' ? JSON.parse(result) : result;
+        return result;
     }
     /**
      * Validate data against schema rules with optional path filtering

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-eval-rs/webcore",
-  "version": "0.0.48",
+  "version": "0.0.50",
   "description": "JSON Eval RS core JavaScript wrapper (internal package - not published)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",