@json-eval-rs/bundler 0.0.29

package/pkg/json_eval_rs.d.ts

@@ -0,0 +1,501 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Get the library version
+ */
+export function getVersion(): string;
+/**
+ * Get library version (alias)
+ */
+export function version(): string;
+/**
+ * Initialize the library (sets up panic hook)
+ */
+export function init(): void;
+/**
+ * WebAssembly wrapper for JSONEval
+ */
+export class JSONEvalWasm {
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Create a new JSONEval instance
+   * 
+   * @param schema - JSON schema string
+   * @param context - Optional context data JSON string
+   * @param data - Optional initial data JSON string
+   */
+  constructor(schema: string, context?: string | null, data?: string | null);
+  /**
+   * Create a new JSONEval instance from MessagePack-encoded schema
+   * 
+   * @param schemaMsgpack - MessagePack-encoded schema bytes (Uint8Array)
+   * @param context - Optional context data JSON string
+   * @param data - Optional initial data JSON string
+   */
+  static newFromMsgpack(schema_msgpack: Uint8Array, context?: string | null, data?: string | null): JSONEvalWasm;
+  /**
+   * Create a new JSONEval instance from a cached ParsedSchema
+   * 
+   * @param cacheKey - Cache key to lookup in the global ParsedSchemaCache
+   * @param context - Optional context data JSON string
+   * @param data - Optional initial data JSON string
+   */
+  static newFromCache(cache_key: string, context?: string | null, data?: string | null): JSONEvalWasm;
+  /**
+   * Evaluate schema with provided data (does not return schema - use getEvaluatedSchema() for that)
+   * 
+   * @param data - JSON data string
+   * @param context - Optional context data JSON string
+   * @throws Error if evaluation fails
+   */
+  evaluate(data: string, context?: string | null): void;
+  /**
+   * Evaluate and return as JsValue for direct JavaScript object access
+   * 
+   * @param data - JSON data string
+   * @param context - Optional context data JSON string
+   * @returns Evaluated schema as JavaScript object
+   */
+  evaluateJS(data: string, context?: string | null): any;
+  /**
+   * Evaluate dependents when a field changes (returns array of changes as JSON string)
+   * 
+   * @param changedPath - Path of the field that changed
+   * @param data - Optional updated JSON data string
+   * @param context - Optional context data JSON string
+   * @returns Array of dependent change objects as JSON string
+   */
+  evaluateDependents(changed_path: string, data?: string | null, context?: string | null): string;
+  /**
+   * Evaluate dependents and return as JavaScript object
+   * 
+   * @param changedPathsJson - JSON array of field paths that changed
+   * @param data - Optional updated JSON data string
+   * @param context - Optional context data JSON string
+   * @param reEvaluate - If true, performs full evaluation after processing dependents
+   * @returns Array of dependent change objects as JavaScript object
+   */
+  evaluateDependentsJS(changed_paths_json: string, data: string | null | undefined, context: string | null | undefined, re_evaluate: boolean): any;
+  /**
+   * Compile and run JSON logic from a JSON logic string
+   * @param logic_str - JSON logic expression as a string
+   * @param data - Optional JSON data string
+   * @param context - Optional JSON context string
+   * @returns Result as JavaScript object
+   */
+  compileAndRunLogic(logic_str: string, data?: string | null, context?: string | null): any;
+  /**
+   * Compile JSON logic and return a global ID
+   * @param logic_str - JSON logic expression as a string
+   * @returns Compiled logic ID as number (u64)
+   */
+  compileLogic(logic_str: string): number;
+  /**
+   * Run pre-compiled logic by ID
+   * @param logic_id - Compiled logic ID from compileLogic
+   * @param data - Optional JSON data string
+   * @param context - Optional JSON context string
+   * @returns Result as JavaScript object
+   */
+  runLogic(logic_id: number, data?: string | null, context?: string | null): any;
+  /**
+   * Validate data against schema rules
+   * 
+   * @param data - JSON data string
+   * @param context - Optional context data JSON string
+   * @returns ValidationResult
+   */
+  validate(data: string, context?: string | null): ValidationResult;
+  /**
+   * Validate data and return as plain JavaScript object (Worker-safe)
+   * 
+   * @param data - JSON data string
+   * @param context - Optional context data JSON string
+   * @returns Plain JavaScript object with validation result
+   */
+  validateJS(data: string, context?: string | null): any;
+  /**
+   * Validate data against schema rules with optional path filtering
+   * 
+   * @param data - JSON data string
+   * @param context - Optional context data JSON string
+   * @param paths - Optional array of paths to validate (null for all)
+   * @returns ValidationResult
+   */
+  validatePaths(data: string, context?: string | null, paths?: string[] | null): ValidationResult;
+  /**
+   * Validate with path filtering and return as plain JavaScript object (Worker-safe)
+   * 
+   * @param data - JSON data string
+   * @param context - Optional context data JSON string
+   * @param paths - Optional array of paths to validate (null for all)
+   * @returns Plain JavaScript object with validation result
+   */
+  validatePathsJS(data: string, context?: string | null, paths?: string[] | null): any;
+  /**
+   * Get the evaluated schema with optional layout resolution
+   * 
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Evaluated schema as JSON string
+   */
+  getEvaluatedSchema(skip_layout: boolean): string;
+  /**
+   * Get the evaluated schema as JavaScript object
+   * 
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Evaluated schema as JavaScript object
+   */
+  getEvaluatedSchemaJS(skip_layout: boolean): any;
+  /**
+   * Get the evaluated schema in MessagePack format
+   * 
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Evaluated schema as MessagePack bytes (Uint8Array)
+   * 
+   * # Zero-Copy Optimization
+   * 
+   * This method returns MessagePack binary data with minimal copying:
+   * 1. Serializes schema to Vec<u8> in Rust (unavoidable)
+   * 2. wasm-bindgen transfers Vec<u8> to JS as Uint8Array (optimized)
+   * 3. Result is a Uint8Array view (minimal overhead)
+   * 
+   * MessagePack format is 20-50% smaller than JSON, ideal for web/WASM.
+   */
+  getEvaluatedSchemaMsgpack(skip_layout: boolean): Uint8Array;
+  /**
+   * Get all schema values (evaluations ending with .value)
+   * Mutates internal data by overriding with values from value evaluations
+   * 
+   * @returns Modified data as JavaScript object
+   */
+  getSchemaValue(): any;
+  /**
+   * Get the evaluated schema without $params field
+   * 
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Evaluated schema as JSON string
+   */
+  getEvaluatedSchemaWithoutParams(skip_layout: boolean): string;
+  /**
+   * Get the evaluated schema without $params as JavaScript object
+   * 
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Evaluated schema as JavaScript object
+   */
+  getEvaluatedSchemaWithoutParamsJS(skip_layout: boolean): any;
+  /**
+   * Get a value from the evaluated schema using dotted path notation
+   * 
+   * @param path - Dotted path to the value (e.g., "properties.field.value")
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Value as JSON string or null if not found
+   */
+  getEvaluatedSchemaByPath(path: string, skip_layout: boolean): string | undefined;
+  /**
+   * Get a value from the evaluated schema using dotted path notation as JavaScript object
+   * 
+   * @param path - Dotted path to the value (e.g., "properties.field.value")
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Value as JavaScript object or null if not found
+   */
+  getEvaluatedSchemaByPathJS(path: string, skip_layout: boolean): any;
+  /**
+   * Get values from evaluated schema using multiple dotted paths
+   * @param pathsJson - JSON array of dotted paths
+   * @param skipLayout - Whether to skip layout resolution
+   * @param format - Return format (0=Nested, 1=Flat, 2=Array)
+   * @returns Data in specified format as JSON string
+   */
+  getEvaluatedSchemaByPaths(paths_json: string, skip_layout: boolean, format: number): string;
+  /**
+   * Get values from evaluated schema using multiple dotted paths (JS object)
+   * @param pathsJson - JSON array of dotted paths
+   * @param skipLayout - Whether to skip layout resolution
+   * @param format - Return format (0=Nested, 1=Flat, 2=Array)
+   * @returns Data in specified format as JavaScript object
+   */
+  getEvaluatedSchemaByPathsJS(paths_json: string, skip_layout: boolean, format: number): any;
+  /**
+   * Get a value from the schema using dotted path notation
+   * 
+   * @param path - Dotted path to the value (e.g., "properties.field.value")
+   * @returns Value as JSON string or null if not found
+   */
+  getSchemaByPath(path: string): string | undefined;
+  /**
+   * Get a value from the schema using dotted path notation as JavaScript object
+   * 
+   * @param path - Dotted path to the value (e.g., "properties.field.value")
+   * @returns Value as JavaScript object or null if not found
+   */
+  getSchemaByPathJS(path: string): any;
+  /**
+   * Get values from schema using multiple dotted paths
+   * @param pathsJson - JSON array of dotted paths
+   * @param format - Return format (0=Nested, 1=Flat, 2=Array)
+   * @returns Data in specified format as JSON string
+   */
+  getSchemaByPaths(paths_json: string, format: number): string;
+  /**
+   * Get values from schema using multiple dotted paths (JS object)
+   * @param pathsJson - JSON array of dotted paths
+   * @param format - Return format (0=Nested, 1=Flat, 2=Array)
+   * @returns Data in specified format as JavaScript object
+   */
+  getSchemaByPathsJS(paths_json: string, format: number): any;
+  /**
+   * Reload schema with new data
+   * 
+   * @param schema - New JSON schema string
+   * @param context - Optional context data JSON string
+   * @param data - Optional initial data JSON string
+   */
+  reloadSchema(schema: string, context?: string | null, data?: string | null): void;
+  /**
+   * Reload schema from MessagePack-encoded bytes
+   * 
+   * @param schemaMsgpack - MessagePack-encoded schema bytes (Uint8Array)
+   * @param context - Optional context data JSON string
+   * @param data - Optional initial data JSON string
+   */
+  reloadSchemaMsgpack(schema_msgpack: Uint8Array, context?: string | null, data?: string | null): void;
+  /**
+   * Reload schema from ParsedSchemaCache using a cache key
+   * 
+   * @param cacheKey - Cache key to lookup in the global ParsedSchemaCache
+   * @param context - Optional context data JSON string
+   * @param data - Optional initial data JSON string
+   */
+  reloadSchemaFromCache(cache_key: string, context?: string | null, data?: string | null): void;
+  /**
+   * Get cache statistics
+   * 
+   * @returns Cache statistics as JavaScript object with hits, misses, and entries
+   */
+  cacheStats(): any;
+  /**
+   * Clear the evaluation cache
+   */
+  clearCache(): void;
+  /**
+   * Get the number of cached entries
+   * 
+   * @returns Number of cached entries
+   */
+  cacheLen(): number;
+  /**
+   * Enable evaluation caching
+   * Useful for reusing JSONEval instances with different data
+   */
+  enableCache(): void;
+  /**
+   * Disable evaluation caching
+   * Useful for web API usage where each request creates a new JSONEval instance
+   * Improves performance by skipping cache operations that have no benefit for single-use instances
+   */
+  disableCache(): void;
+  /**
+   * Check if evaluation caching is enabled
+   * 
+   * @returns true if caching is enabled, false otherwise
+   */
+  isCacheEnabled(): boolean;
+  /**
+   * Resolve layout with optional evaluation
+   * 
+   * @param evaluate - If true, runs evaluation before resolving layout
+   * @throws Error if resolve fails
+   */
+  resolveLayout(evaluate: boolean): void;
+  /**
+   * Evaluate a subform with data
+   * 
+   * @param subformPath - Path to the subform (e.g., "#/riders")
+   * @param data - JSON data string for the subform
+   * @param context - Optional context data JSON string
+   * @throws Error if evaluation fails
+   */
+  evaluateSubform(subform_path: string, data: string, context?: string | null): void;
+  /**
+   * Validate subform data against its schema rules
+   * 
+   * @param subformPath - Path to the subform
+   * @param data - JSON data string for the subform
+   * @param context - Optional context data JSON string
+   * @returns ValidationResult
+   */
+  validateSubform(subform_path: string, data: string, context?: string | null): ValidationResult;
+  /**
+   * Evaluate dependents in subform when a field changes
+   * 
+   * @param subformPath - Path to the subform
+   * @param changedPath - Path of the field that changed
+   * @param data - Optional updated JSON data string
+   * @param context - Optional context data JSON string
+   * @returns Array of dependent change objects as JSON string
+   */
+  evaluateDependentsSubform(subform_path: string, changed_path: string, data?: string | null, context?: string | null): string;
+  /**
+   * Evaluate dependents in subform and return as JavaScript object
+   * 
+   * @param subformPath - Path to the subform
+   * @param changedPath - Path of the field that changed
+   * @param data - Optional updated JSON data string
+   * @param context - Optional context data JSON string
+   * @returns Array of dependent change objects as JavaScript object
+   */
+  evaluateDependentsSubformJS(subform_path: string, changed_path: string, data?: string | null, context?: string | null): any;
+  /**
+   * Resolve layout for subform
+   * 
+   * @param subformPath - Path to the subform
+   * @param evaluate - If true, runs evaluation before resolving layout
+   * @throws Error if resolve fails
+   */
+  resolveLayoutSubform(subform_path: string, evaluate: boolean): void;
+  /**
+   * Get evaluated schema from subform
+   * 
+   * @param subformPath - Path to the subform
+   * @param resolveLayout - Whether to resolve layout
+   * @returns Evaluated schema as JSON string
+   */
+  getEvaluatedSchemaSubform(subform_path: string, resolve_layout: boolean): string;
+  /**
+   * Get evaluated schema from subform as JavaScript object
+   * 
+   * @param subformPath - Path to the subform
+   * @param resolveLayout - Whether to resolve layout
+   * @returns Evaluated schema as JavaScript object
+   */
+  getEvaluatedSchemaSubformJS(subform_path: string, resolve_layout: boolean): any;
+  /**
+   * Get schema value from subform (all .value fields)
+   * 
+   * @param subformPath - Path to the subform
+   * @returns Modified data as JavaScript object
+   */
+  getSchemaValueSubform(subform_path: string): any;
+  /**
+   * Get evaluated schema without $params from subform
+   * 
+   * @param subformPath - Path to the subform
+   * @param resolveLayout - Whether to resolve layout
+   * @returns Evaluated schema as JSON string
+   */
+  getEvaluatedSchemaWithoutParamsSubform(subform_path: string, resolve_layout: boolean): string;
+  /**
+   * Get evaluated schema without $params from subform as JavaScript object
+   * 
+   * @param subformPath - Path to the subform
+   * @param resolveLayout - Whether to resolve layout
+   * @returns Evaluated schema as JavaScript object
+   */
+  getEvaluatedSchemaWithoutParamsSubformJS(subform_path: string, resolve_layout: boolean): any;
+  /**
+   * Get evaluated schema by specific path from subform
+   * 
+   * @param subformPath - Path to the subform
+   * @param schemaPath - Dotted path to the value within the subform
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Value as JSON string or null if not found
+   */
+  getEvaluatedSchemaByPathSubform(subform_path: string, schema_path: string, skip_layout: boolean): string | undefined;
+  /**
+   * Get evaluated schema by specific path from subform as JavaScript object
+   * 
+   * @param subformPath - Path to the subform
+   * @param schemaPath - Dotted path to the value within the subform
+   * @param skipLayout - Whether to skip layout resolution
+   * @returns Value as JavaScript object or null if not found
+   */
+  getEvaluatedSchemaByPathSubformJS(subform_path: string, schema_path: string, skip_layout: boolean): any;
+  /**
+   * Get values from the evaluated schema of a subform using multiple dotted path notations (returns JSON string)
+   * @param subformPath - Path to the subform
+   * @param pathsJson - JSON array of dotted paths
+   * @param skipLayout - Whether to skip layout resolution
+   * @param format - Return format (0=Nested, 1=Flat, 2=Array)
+   * @returns Data in specified format as JSON string
+   */
+  getEvaluatedSchemaByPathsSubform(subform_path: string, paths_json: string, skip_layout: boolean, format: number): string;
+  /**
+   * Get values from the evaluated schema of a subform using multiple dotted path notations (returns JS object)
+   * @param subformPath - Path to the subform
+   * @param pathsJson - JSON array of dotted paths
+   * @param skipLayout - Whether to skip layout resolution
+   * @param format - Return format (0=Nested, 1=Flat, 2=Array)
+   * @returns Data in specified format as JavaScript object
+   */
+  getEvaluatedSchemaByPathsSubformJS(subform_path: string, paths_json: string, skip_layout: boolean, format: number): any;
+  /**
+   * Get schema by specific path from subform (returns JSON string)
+   * @param subformPath - Path to the subform
+   * @param schemaPath - Path within the subform
+   * @returns Value as JSON string or null if not found
+   */
+  getSchemaByPathSubform(subform_path: string, schema_path: string): string | undefined;
+  /**
+   * Get schema by specific path from subform (returns JS object)
+   * @param subformPath - Path to the subform
+   * @param schemaPath - Path within the subform
+   * @returns Value as JavaScript object or null if not found
+   */
+  getSchemaByPathSubformJS(subform_path: string, schema_path: string): any;
+  /**
+   * Get schema by multiple paths from subform
+   * @param subformPath - Path to the subform
+   * @param pathsJson - JSON array of dotted paths
+   * @param format - Return format (0=Nested, 1=Flat, 2=Array)
+   * @returns Data in specified format as JSON string
+   */
+  getSchemaByPathsSubform(subform_path: string, paths_json: string, format: number): string;
+  /**
+   * Get schema by multiple paths from subform (JS object)
+   * @param subformPath - Path to the subform
+   * @param pathsJson - JSON array of dotted paths
+   * @param format - Return format (0=Nested, 1=Flat, 2=Array)
+   * @returns Data in specified format as JavaScript object
+   */
+  getSchemaByPathsSubformJS(subform_path: string, paths_json: string, format: number): any;
+  /**
+   * Get list of available subform paths
+   * 
+   * @returns Array of subform paths
+   */
+  getSubformPaths(): string[];
+  /**
+   * Check if a subform exists at the given path
+   * 
+   * @param subformPath - Path to check
+   * @returns True if subform exists, false otherwise
+   */
+  hasSubform(subform_path: string): boolean;
+}
+/**
+ * Validation error for JavaScript
+ */
+export class ValidationError {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  readonly path: string;
+  readonly rule_type: string;
+  readonly message: string;
+  readonly code: string | undefined;
+  readonly pattern: string | undefined;
+  readonly field_value: string | undefined;
+  readonly data: any;
+}
+/**
+ * Validation result for JavaScript
+ */
+export class ValidationResult {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  toJSON(): any;
+  readonly has_error: boolean;
+  readonly errors: ValidationError[];
+}

package/pkg/json_eval_rs.js

@@ -0,0 +1,5 @@
+import * as wasm from "./json_eval_rs_bg.wasm";
+export * from "./json_eval_rs_bg.js";
+import { __wbg_set_wasm } from "./json_eval_rs_bg.js";
+__wbg_set_wasm(wasm);
+wasm.__wbindgen_start();