@json-eval-rs/bundler 0.0.29

package/README.md

@@ -0,0 +1,155 @@
+# @json-eval-rs/bundler
+
+JSON Eval RS for modern bundlers (Webpack, Vite, Rollup, Next.js, etc.) with ergonomic API.
+
+## Installation
+
+```bash
+yarn install @json-eval-rs/bundler
+# or
+yarn add @json-eval-rs/bundler
+```
+
+## Usage
+
+```typescript
+import { JSONEval } from '@json-eval-rs/bundler';
+
+const evaluator = new JSONEval({
+  schema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+        rules: {
+          required: { value: true, message: 'Name is required' },
+          minLength: { value: 3, message: 'Min 3 characters' }
+        }
+      },
+      email: {
+        type: 'string',
+        rules: {
+          required: { value: true, message: 'Email is required' },
+          email: { value: true, message: 'Invalid email' }
+        }
+      }
+    }
+  }
+});
+
+// Initialize (loads WASM)
+await evaluator.init();
+
+// Validate data
+const result = await evaluator.validate({
+  data: { name: 'Jo', email: 'invalid' }
+});
+
+if (result.has_error) {
+  console.log('Validation errors:', result.errors);
+  // [{ path: 'name', rule_type: 'minLength', message: 'Min 3 characters' }, ...]
+}
+
+// Evaluate schema with data
+const evaluated = await evaluator.evaluate({
+  data: { name: 'John', email: 'john@example.com' }
+});
+
+// Get schema values
+const values = await evaluator.getSchemaValue();
+
+// Clean up when done
+evaluator.free();
+```
+
+## API
+
+### `new JSONEval(options)`
+
+Create a new evaluator instance.
+
+**Options:**
+- `schema` (required) - JSON schema object
+- `context` (optional) - Context data object
+- `data` (optional) - Initial data object
+
+### `await evaluator.init()`
+
+Initialize the WASM module. Must be called before other methods.
+
+### `await evaluator.validate({ data, context? })`
+
+Validate data against schema rules.
+
+Returns: `{ has_error: boolean, errors: ValidationError[] }`
+
+### `await evaluator.evaluate({ data, context? })`
+
+Evaluate schema with data and return evaluated schema.
+
+### `await evaluator.evaluateDependents({ changedPaths, data, context?, nested? })`
+
+Re-evaluate fields that depend on changed paths.
+
+### `await evaluator.getEvaluatedSchema({ skipLayout? })`
+
+Get the evaluated schema with optional layout resolution.
+
+### `await evaluator.getSchemaValue()`
+
+Get all schema values (evaluations ending with `.value`).
+
+### `await evaluator.reloadSchema({ schema, context?, data? })`
+
+Reload schema with new data.
+
+### `await evaluator.cacheStats()`
+
+Get cache statistics: `{ hits, misses, entries }`.
+
+### `await evaluator.clearCache()`
+
+Clear the evaluation cache.
+
+### `await evaluator.cacheLen()`
+
+Get number of cached entries.
+
+### `evaluator.free()`
+
+Free WASM resources. Always call when done.
+
+### `version()`
+
+Get library version string.
+
+## Example: Next.js
+
+```typescript
+'use client';
+
+import { JSONEval } from '@json-eval-rs/bundler';
+import { useEffect, useState } from 'react';
+
+export default function MyForm() {
+  const [evaluator, setEvaluator] = useState(null);
+
+  useEffect(() => {
+    // Dynamically import (client-side only)
+    import('@json-eval-rs/bundler').then(({ JSONEval }) => {
+      const instance = new JSONEval({ schema });
+      setEvaluator(instance);
+    });
+
+    return () => {
+      if (evaluator) evaluator.free();
+    };
+  }, []);
+
+  // ... use evaluator
+}
+```
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @json-eval-rs/bundler - TypeScript definitions
+ */
+
+export interface ValidationError {
+  path: string;
+  rule_type: string;
+  message: string;
+}
+
+export interface ValidationResult {
+  has_error: boolean;
+  errors: ValidationError[];
+}
+
+export interface JSONEvalOptions {
+  schema: any;
+  context?: any;
+  data?: any;
+}
+
+export interface ValidateOptions {
+  data: any;
+  context?: any;
+}
+
+export interface EvaluateOptions {
+  data: any;
+  context?: any;
+}
+
+export interface EvaluateDependentsOptions {
+  changedPaths: string[];
+  data: any;
+  context?: any;
+  nested?: boolean;
+}
+
+export interface GetEvaluatedSchemaOptions {
+  skipLayout?: boolean;
+}
+
+export interface ReloadSchemaOptions {
+  schema: any;
+  context?: any;
+  data?: any;
+}
+
+export interface CacheStats {
+  hits: number;
+  misses: number;
+  entries: number;
+}
+
+export interface EvaluateSubformOptions {
+  subformPath: string;
+  data: any;
+  context?: any;
+}
+
+export interface ValidateSubformOptions {
+  subformPath: string;
+  data: any;
+  context?: any;
+}
+
+export interface EvaluateDependentsSubformOptions {
+  subformPath: string;
+  changedPath: string;
+  data?: any;
+  context?: any;
+}
+
+export interface ResolveLayoutSubformOptions {
+  subformPath: string;
+  evaluate?: boolean;
+}
+
+export interface GetEvaluatedSchemaSubformOptions {
+  subformPath: string;
+  resolveLayout?: boolean;
+}
+
+export interface GetSchemaValueSubformOptions {
+  subformPath: string;
+}
+
+export interface GetEvaluatedSchemaByPathSubformOptions {
+  subformPath: string;
+  schemaPath: string;
+  skipLayout?: boolean;
+}
+
+export class JSONEval {
+  constructor(options: JSONEvalOptions);
+  init(): Promise<void>;
+  validate(options: ValidateOptions): Promise<ValidationResult>;
+  evaluate(options: EvaluateOptions): Promise<any>;
+  evaluateDependents(options: EvaluateDependentsOptions): Promise<any>;
+  getEvaluatedSchema(options?: GetEvaluatedSchemaOptions): Promise<any>;
+  getSchemaValue(): Promise<any>;
+  reloadSchema(options: ReloadSchemaOptions): Promise<void>;
+  cacheStats(): Promise<CacheStats>;
+  clearCache(): Promise<void>;
+  cacheLen(): Promise<number>;
+  
+  // Subform methods
+  evaluateSubform(options: EvaluateSubformOptions): Promise<void>;
+  validateSubform(options: ValidateSubformOptions): Promise<ValidationResult>;
+  evaluateDependentsSubform(options: EvaluateDependentsSubformOptions): Promise<any>;
+  resolveLayoutSubform(options: ResolveLayoutSubformOptions): Promise<void>;
+  getEvaluatedSchemaSubform(options: GetEvaluatedSchemaSubformOptions): Promise<any>;
+  getSchemaValueSubform(options: GetSchemaValueSubformOptions): Promise<any>;
+  getEvaluatedSchemaWithoutParamsSubform(options: GetEvaluatedSchemaSubformOptions): Promise<any>;
+  getEvaluatedSchemaByPathSubform(options: GetEvaluatedSchemaByPathSubformOptions): Promise<any | null>;
+  getSubformPaths(): Promise<string[]>;
+  hasSubform(subformPath: string): Promise<boolean>;
+  
+  free(): void;
+}
+
+export function version(): string;
+
+export default JSONEval;

package/index.js

@@ -0,0 +1,45 @@
+/**
+ * @json-eval-rs/bundler
+ * JSON Eval RS for modern bundlers (Webpack, Vite, Rollup, Next.js, etc.)
+ */
+
+import { JSONEvalCore, getVersion } from '@json-eval-rs/webcore';
+import * as wasm from './pkg/json_eval_rs.js';
+
+/**
+ * JSONEval class with bundler WASM pre-configured
+ */
+export class JSONEval extends JSONEvalCore {
+  constructor(options) {
+    super(wasm, options);
+  }
+
+  /**
+   * Create a new JSONEval instance from a cached ParsedSchema
+   * @param {string} cacheKey - Cache key to lookup in ParsedSchemaCache
+   * @param {object} [context] - Optional context data
+   * @param {object} [data] - Optional initial data
+   * @returns {JSONEval} New instance
+   */
+  static fromCache(cacheKey, context, data) {
+    return new JSONEval({
+      schema: cacheKey,
+      context,
+      data,
+      fromCache: true
+    });
+  }
+}
+
+/**
+ * Get library version
+ * @returns {string}
+ */
+export function version() {
+  return getVersion(wasm);
+}
+
+// Re-export types for convenience
+export * from '@json-eval-rs/webcore';
+
+export default JSONEval;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@json-eval-rs/bundler",
+  "version": "0.0.29",
+  "description": "JSON Eval RS for bundlers (Webpack, Vite, Next.js, etc.) with ergonomic API",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "type": "module",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "pkg/*.js",
+    "pkg/*.wasm",
+    "pkg/*.d.ts"
+  ],
+  "keywords": [
+    "json",
+    "json-logic",
+    "schema",
+    "validation",
+    "wasm",
+    "webpack",
+    "vite",
+    "bundler"
+  ],
+  "author": "Muhamad Rizki",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/byrizki/json-eval-rs.git",
+    "directory": "bindings/web/packages/bundler"
+  },
+  "dependencies": {
+    "@json-eval-rs/webcore": "*"
+  },
+  "sideEffects": false
+}