@json-eval-rs/webcore 0.0.47 → 0.0.49

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;
@@ -146,8 +151,9 @@ export class JSONEvalCore {
     async evaluateDependents({ changedPaths, data, context, reEvaluate = false }) {
         await this.init();
         try {
-            return this._instance.evaluateDependentsJS(changedPaths, // Pass array directly
-            data ? JSON.stringify(data) : null, context ? JSON.stringify(context) : null, reEvaluate);
+            // Ensure paths is an array for WASM
+            const paths = Array.isArray(changedPaths) ? changedPaths : [changedPaths];
+            return this._instance.evaluateDependentsJS(JSON.stringify(paths), data ? JSON.stringify(data) : null, context ? JSON.stringify(context) : null, reEvaluate);
         }
         catch (error) {
             throw new Error(`Dependent evaluation failed: ${error.message || error}`);
@@ -194,7 +200,7 @@ export class JSONEvalCore {
      */
     async getEvaluatedSchemaByPaths({ paths, skipLayout = false, format = 0 }) {
         await this.init();
-        return this._instance.getEvaluatedSchemaByPathsJS(paths, skipLayout, format);
+        return this._instance.getEvaluatedSchemaByPathsJS(JSON.stringify(paths), skipLayout, format);
     }
     /**
      * Get a value from the schema using dotted path notation
@@ -209,7 +215,7 @@ export class JSONEvalCore {
      */
     async getSchemaByPaths({ paths, format = 0 }) {
         await this.init();
-        return this._instance.getSchemaByPathsJS(paths, format);
+        return this._instance.getSchemaByPathsJS(JSON.stringify(paths), format);
     }
     /**
      * Reload schema with new data
@@ -342,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
@@ -359,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
@@ -399,8 +403,7 @@ export class JSONEvalCore {
         await this.init();
         // For backward compatibility, accept single changedPath too (though types say array)
         const paths = Array.isArray(changedPaths) ? changedPaths : [changedPaths];
-        return this._instance.evaluateDependentsSubformJS(subformPath, paths, // Pass array directly (WASM now accepts array)
-        data ? JSON.stringify(data) : null, context ? JSON.stringify(context) : null);
+        return this._instance.evaluateDependentsSubformJS(subformPath, JSON.stringify(paths), data ? JSON.stringify(data) : null, context ? JSON.stringify(context) : null);
     }
     /**
      * Resolve layout for subform
@@ -443,7 +446,7 @@ export class JSONEvalCore {
      */
     async getEvaluatedSchemaByPathsSubform({ subformPath, schemaPaths, skipLayout = false, format = 0 }) {
         await this.init();
-        return this._instance.getEvaluatedSchemaByPathsSubformJS(subformPath, schemaPaths, skipLayout, format);
+        return this._instance.getEvaluatedSchemaByPathsSubformJS(subformPath, JSON.stringify(schemaPaths), skipLayout, format);
     }
     /**
      * Get list of available subform paths
@@ -465,7 +468,7 @@ export class JSONEvalCore {
      */
     async getSchemaByPathsSubform({ subformPath, schemaPaths, format = 0 }) {
         await this.init();
-        return this._instance.getSchemaByPathsSubformJS(subformPath, schemaPaths, format);
+        return this._instance.getSchemaByPathsSubformJS(subformPath, JSON.stringify(schemaPaths), format);
     }
     /**
      * Check if a subform exists at the given path

package/package.json

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