Skip to main content
ast-guard is a production-ready AST validation library for JavaScript. It inspects user-provided or LLM-generated code before execution, blocking dangerous constructs and enforcing API usage policies. ast-guard powers Enclave’s first security layer and can be used standalone for any JavaScript validation needs.

21 Built-in Rules

Block eval, dangerous globals, prototype manipulation, unbounded loops, ReDoS, and more with battle-tested validation rules.

Pre-Scanner Defense

Layer 0 checks that run before parsing: size, nesting and line limits, and by preset regex and Unicode checks.

AgentScript Preset

Purpose-built preset for LLM-generated orchestration code with whitelist-only globals and strict control flow.

When to Use ast-guard

  • LLM-generated code - Validate AI-written JavaScript before execution
  • User scripts - Accept arbitrary JavaScript with deterministic guardrails
  • Workflow builders - Enforce API usage and block dangerous constructs
  • Compliance requirements - Audit trails showing exactly which rule blocked a script
ast-guard is a pure TypeScript package with zero native dependencies. It works in Node.js 22+ and can be used standalone or as part of the Enclave execution environment.

Installation

Quick Start

valid means that every rule ran and none reported an error. It does not mean the code is safe to run on its own: a validator is a filter on source text, and what code does when it runs is decided by where it runs (see the warning below).
Instantiate JSAstValidator once and reuse it. This keeps presets, custom rules, and caches consistent across requests.

Validation Result

Validation Options

A validation result is bounded. Without maxIssues a validation collects at most DEFAULT_MAX_ISSUES (100) issues; 0 collects every issue. At the cap the validation stops as soon as an error is on the list. While only warnings were found the remaining rules still run, because one of them may refuse the source, and further warnings are not collected. A result whose list is not everything the rules had to report has incomplete: true. A validation that stopped early, at the cap or by stopOnFirstError, is never valid: valid is true only when every rule ran and none reported an error.
AST Guard prevents unsafe syntax from entering your sandbox, but it does not execute or sandbox code itself. Pair it with enclave-vm for complete defense-in-depth.