# anyvali

> Native validation with portable schema interchange

Latest version **1.1.6** (published 2026-09-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install anyvali
pnpm add anyvali
yarn add anyvali
bun add anyvali
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.1.6 |
| Published | 2026-09-10 |
| First published | 2026-06-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=22 |
| Dependencies | 0 |
| Unpacked size | 511 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 0 |
| Maintainers | mrinc |

## Links

- npm: https://www.npmjs.com/package/anyvali
- Repository: https://github.com/BetterCorp/AnyVali
- Homepage: https://anyvali.com
- Issues: https://github.com/BetterCorp/AnyVali/issues
- npm.io page: https://npm.io/package/anyvali

## Recent versions

- 1.1.6 (latest) — 2026-09-10
- 1.1.5 — 2026-09-08
- 1.1.4 — 2026-09-07
- 1.1.3 — 2026-09-07
- 1.1.2 — 2026-09-07
- 1.1.1 — 2026-09-05
- 1.1.0 — 2026-08-31
- 1.0.7 — 2026-08-24
- 1.0.6 — 2026-06-20
- 1.0.5 — 2026-06-20
- 1.0.4 — 2026-06-20
- 1.0.3 — 2026-06-20
- 1.0.2 — 2026-06-20
- 0.3.6 — 2026-06-20
- 0.3.5 — 2026-06-17
- … 3 more at https://npm.io/package/anyvali/versions

## README

<p align="center">
  <img src="logo.png" alt="AnyVali" width="200" />
</p>

<h1 align="center">AnyVali</h1>

<p align="center">
  <strong>Native validation libraries for 10 languages, one portable schema model.</strong>
</p>

<p align="center">
  <a href="https://github.com/BetterCorp/AnyVali/actions/workflows/ci.yml"><img src="https://github.com/BetterCorp/AnyVali/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
  <a href="https://codecov.io/gh/BetterCorp/AnyVali"><img src="https://codecov.io/gh/BetterCorp/AnyVali/graph/badge.svg?token=3H068H51QN" alt="codecov" /></a>
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT" /></a>
  <a href="https://www.npmjs.com/package/anyvali"><img src="https://img.shields.io/npm/v/anyvali.svg?label=npm" alt="npm" /></a>
  <a href="https://pypi.org/project/anyvali/"><img src="https://img.shields.io/pypi/v/anyvali.svg?label=pypi" alt="PyPI" /></a>
  <a href="https://crates.io/crates/anyvali"><img src="https://img.shields.io/crates/v/anyvali.svg?label=crates.io" alt="crates.io" /></a>
  <a href="https://pkg.go.dev/github.com/BetterCorp/AnyVali/sdk/go"><img src="https://img.shields.io/badge/go-pkg.go.dev-blue.svg" alt="Go" /></a>
  <a href="https://www.nuget.org/packages/AnyVali"><img src="https://img.shields.io/nuget/v/AnyVali.svg?label=nuget" alt="NuGet" /></a>
  <a href="https://rubygems.org/gems/anyvali"><img src="https://img.shields.io/gem/v/anyvali.svg?label=gem" alt="Gem" /></a>
</p>

<p align="center">
  <a href="https://anyvali.com">Website</a> &middot;
  <a href="https://docs.anyvali.com">Docs</a> &middot;
  <a href="https://github.com/BetterCorp/AnyVali/issues">Issues</a> &middot;
  <a href="CONTRIBUTING.md">Contributing</a>
</p>

---

AnyVali lets you write validation schemas in your language, then share them across any of 10 supported runtimes via a portable JSON format. Think Zod, but for every language.

## Why AnyVali?

- **Write schemas natively** -- idiomatic APIs for each language, not a separate DSL
- **Share across languages** -- export to JSON, import in any other SDK
- **Safe numeric defaults** -- `number` = float64, `int` = int64 everywhere
- **Deterministic parsing** -- coerce, default, then validate, in that order
- **Conformance tested** -- shared test corpus ensures identical behavior across SDKs

## Install

PHP uses a [pinned Composer source installation](docs/sdk-php.md#installation).

```bash
npm install anyvali          # JavaScript / TypeScript
pip install anyvali           # Python
go get github.com/BetterCorp/AnyVali/sdk/go  # Go
cargo add anyvali             # Rust
dotnet add package AnyVali    # C#
# PHP: pinned Composer source installation (see installation link above)
gem install anyvali           # Ruby
```

<details>
<summary>Java / Kotlin / C++</summary>

**Java (Maven)**
```xml
<dependency>
  <groupId>com.anyvali</groupId>
  <artifactId>anyvali</artifactId>
  <version>0.0.1</version>
</dependency>
```

**Kotlin (Gradle)**
```kotlin
implementation("com.anyvali:anyvali:0.0.1")
```

**C++ (CMake)**
```cmake
FetchContent_Declare(anyvali GIT_REPOSITORY https://github.com/BetterCorp/AnyVali)
FetchContent_MakeAvailable(anyvali)
target_link_libraries(your_target PRIVATE anyvali)
```
</details>

## Quick Start

Define a schema, parse input, get structured errors or clean data.

<table>
<tr><th>JavaScript / TypeScript</th><th>Python</th></tr>
<tr>
<td>

```typescript
import { string, int, object, array } from "anyvali";

const User = object({
  name:  string().minLength(1),
  email: string().format('email'),
  age:   int().min(0).optional(),
  tags:  array(string()).maxItems(5),
});

// Throws on failure
const user = User.parse(input);

// Or get a result object
const result = User.safeParse(input);
if (!result.success) {
  console.log(result.issues);
}
```

</td>
<td>

```python
import anyvali as v

User = v.object_({
    "name":  v.string().min_length(1),
    "email": v.string().format("email"),
    "age":   v.int_().min(0).optional(),
    "tags":  v.array(v.string()).max_items(5),
})

# Raises on failure
user = User.parse(input_data)

# Or get a result object
result = User.safe_parse(input_data)
if not result.success:
    print(result.issues)
```

</td>
</tr>
</table>

<details>
<summary>Go example</summary>

```go
import av "github.com/BetterCorp/AnyVali/sdk/go"

User := av.Object(map[string]av.Schema{
    "name":  av.String().MinLength(1),
    "email": av.String().Format("email"),
    "age":   av.Optional(av.Int().Min(0)),
    "tags":  av.Array(av.String()).MaxItems(5),
})

result := User.SafeParse(input)
if !result.Success {
    for _, issue := range result.Issues {
        fmt.Printf("[%s] %s at %v\n", issue.Code, issue.Message, issue.Path)
    }
}
```
</details>

## Type Inference

All 10 SDKs now provide static type inference, so parsed values carry the correct type without manual casts. The TypeScript SDK offers full Zod-style `Infer<T>`:

```typescript
import { object, string, int, type Infer } from "anyvali";

const User = object({
  name: string().minLength(1),
  email: string().format('email'),
  age: int().min(0).optional(),
});

type User = Infer<typeof User>;
// => { name: string; email: string; age?: number | undefined }

const user = User.parse(input); // fully typed, no cast needed
```

Other SDKs use the type inference mechanism native to each language:

- **Python** -- `BaseSchema(Generic[T])`, `ParseResult(Generic[T])`; `parse()` returns `T`
- **C# / Kotlin** -- `Schema<T>` generic base class, `ParseResult<T>`
- **Java** -- `Schema<T>` generic base, `ParseResult<T>` record
- **Go** -- `TypedParse[T]()` and `TypedSafeParse[T]()` generic helper functions
- **Rust** -- `TypedSchema` trait with associated `Output` type, `parse_as<T>()` free function
- **C++** -- Template `parse_as<T>()` and `safe_parse_as<T>()` helpers
- **PHP** -- `@template` phpDoc annotations for PHPStan/Psalm
- **Ruby** -- RBS type signature file for Steep/Sorbet

## Cross-Language Schema Sharing

AnyVali's core feature: export a schema from one language, import it in another.

```typescript
// TypeScript frontend -- export
const doc = User.export();
const json = JSON.stringify(doc);
// Send to your backend, save to DB, put in a config file...
```

```python
# Python backend -- import
import json, anyvali as v

schema = v.import_schema(json.loads(schema_json))
result = schema.safe_parse(request_body)  # Same validation rules!
```

## Sensitive Data

Mark secrets with `sensitive: true`, then supply your own encryption function. AnyVali validates before and after transformation but never ships encryption logic or keys.

```typescript
import { decrypt, encrypt, object, safeParseEncrypted, string } from "anyvali";

const Credentials = object({
  username: string(),
  password: string().minLength(12).describe("Password", { sensitive: true }),
});

const stored = encrypt(Credentials, input, (path, value) =>
  `encrypted:${encryptWithYourKms(path, value)}`,
);

safeParseEncrypted(Credentials, stored); // validates the encrypted storage shape

const clear = decrypt(Credentials, stored, (path, value) =>
  decryptWithYourKms(path, value.slice("encrypted:".length)),
);
```

Sensitive objects and arrays are encrypted as one opaque value. See the [sensitive data guide](docs/sensitive-data.md) for behavior, security boundaries, and every SDK's API names.

## Forms

The JS SDK also ships a small forms layer for browser-native fields, HTML5 attributes, and AnyVali validation.

```typescript
import { object, string, int } from "anyvali";
import { initForm } from "anyvali/forms";

const Signup = object({
  email: string().format("email"),
  age: int().min(18),
});

initForm("#signup", { schema: Signup });
```

```html
<form id="signup">
  <input name="email" type="email" />
  <input name="age" type="number" />
  <button type="submit">Create account</button>
</form>
```

For JSX-style attribute binding:

```tsx
import { object, string } from "anyvali";
import { createFormBindings } from "anyvali/forms";

const Signup = object({
  email: string().format("email"),
});

const form = createFormBindings({ schema: Signup });

<input {...form.field("email")} />;
```

The portable JSON format:

```json
{
  "anyvaliVersion": "1.0",
  "schemaVersion": "1",
  "root": {
    "kind": "object",
    "properties": {
      "name": { "kind": "string", "minLength": 1 },
      "email": { "kind": "string", "format": "email" }
    },
    "required": ["name", "email"],
    "unknownKeys": "strip"
  },
  "definitions": {},
  "extensions": {}
}
```

## Supported SDKs

| Language | Package | Status |
|----------|---------|--------|
| JavaScript / TypeScript | [`anyvali`](https://www.npmjs.com/package/anyvali) | v0.0.1 |
| Python | [`anyvali`](https://pypi.org/project/anyvali/) | v0.0.1 |
| Go | [`github.com/BetterCorp/AnyVali/sdk/go`](https://pkg.go.dev/github.com/BetterCorp/AnyVali/sdk/go) | v0.0.1 |
| Java | `com.anyvali:anyvali` | v0.0.1 |
| C# | [`AnyVali`](https://www.nuget.org/packages/AnyVali) | v0.0.1 |
| Rust | [`anyvali`](https://crates.io/crates/anyvali) | v0.0.1 |
| PHP | [`anyvali/anyvali` from source](docs/sdk-php.md#installation) | Pinned repository release |
| Ruby | [`anyvali`](https://rubygems.org/gems/anyvali) | v0.0.1 |
| Kotlin | `com.anyvali:anyvali` | v0.0.1 |
| C++ | `anyvali` (CMake) | v0.0.1 |

## CLI & HTTP API

Don't need an SDK? Use AnyVali from the command line or as a validation microservice.

```bash
# Validate from the command line
anyvali validate schema.json '{"name": "Alice", "email": "alice@test.com"}'

# Pipe from stdin
cat payload.json | anyvali validate schema.json -

# Start a validation server
anyvali serve --port 8080 --schemas ./schemas/

# Validate via HTTP
curl -X POST http://localhost:8080/validate/user \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "email": "alice@test.com"}'
```

Pre-built binaries for Linux, macOS, and Windows are available on the [releases page](https://github.com/BetterCorp/AnyVali/releases). Docker image: `docker pull anyvali/cli`.

See the [CLI Reference](https://docs.anyvali.com/docs/cli) and [HTTP API Reference](https://docs.anyvali.com/docs/api) for full documentation.

## Schema Types

| Category | Types |
|----------|-------|
| **Primitives** | `string`, `bool`, `null` |
| **Numbers** | `number` (float64), `int` (int64), `float32`, `float64`, `int8`-`int64`, `uint8`-`uint64` |
| **Special** | `any`, `unknown`, `never` |
| **Values** | `literal`, `enum` |
| **Collections** | `array`, `tuple`, `object`, `record` |
| **Composition** | `union`, `intersection` |
| **Modifiers** | `optional`, `nullable` |

## Documentation

| Guide | Description |
|-------|-------------|
| [Getting Started](https://docs.anyvali.com) | Installation, API reference, examples |
| [Numeric Semantics](https://docs.anyvali.com/docs/numeric-semantics) | Why `number` = float64 and `int` = int64 |
| [Portability Guide](https://docs.anyvali.com/docs/portability-guide) | Design schemas that work across all languages |
| [SDK Authors Guide](https://docs.anyvali.com/docs/sdk-authors-guide) | Implement a new AnyVali SDK |
| [Canonical Spec](https://docs.anyvali.com/spec/spec) | The normative specification |
| [JSON Format](https://docs.anyvali.com/spec/json-format) | Interchange format details |
| [CLI Reference](https://docs.anyvali.com/docs/cli) | Command-line validation tool |
| [HTTP API](https://docs.anyvali.com/docs/api) | Validation microservice / sidecar |
| [Development](https://docs.anyvali.com/docs/development) | Building, testing, contributing |

## Repository Layout

```
.
├── docs/           Documentation guides
├── spec/           Canonical spec, JSON format, conformance corpus
├── sdk/
│   ├── js/         JavaScript / TypeScript SDK
│   ├── python/     Python SDK
│   ├── go/         Go SDK
│   ├── java/       Java SDK
│   ├── csharp/     C# SDK
│   ├── rust/       Rust SDK
│   ├── php/        PHP SDK
│   ├── ruby/       Ruby SDK
│   ├── kotlin/     Kotlin SDK
│   └── cpp/        C++ SDK
├── cli/            CLI binary and HTTP API server (Go)
├── runner.sh       Build/test/CI runner
└── site/           anyvali.com source
```

## Contributing

Contributions are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.

```bash
./runner.sh help       # See all commands
./runner.sh test js    # Test a specific SDK
./runner.sh ci         # Run the full CI pipeline locally
pwsh -File tools/release/build_release.ps1  # Build release artifacts with Docker
```

## License

AnyVali is licensed under the [MIT License](LICENSE).

---

<p align="center">
  <a href="https://anyvali.com">anyvali.com</a>
</p>

---
_Source: https://npm.io/package/anyvali · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._