anyvali 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7c53ac42dbac09b5549467769f54d5597699feb351c0f77975cced4cb11bd569
+  data.tar.gz: c73e7af5ae8c388e30fe3e9040a93bbd212d0d1ad16a05761d8db2bb4fe0348f
+SHA512:
+  metadata.gz: e3f43ec3aa8ff4310fd866208fadb24997c0304fb0cfda21ed8967d614b5695abd345ed63fc47dbedb39acfa5b97b183f61357c042ef723007d96ab43fb8a2e4
+  data.tar.gz: dbf001ffb2e24ac3d881fe4066b2f675f44f66f47123b684ab8828b8adf441f76c7d5b8665e91fce3939493e06b62e58f2a99902fda0a33869904b3daf640b59

data/README.md

@@ -0,0 +1,339 @@
+<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://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/js"><img src="https://img.shields.io/npm/v/%40anyvali%2Fjs.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
+
+```bash
+npm install @anyvali/js      # JavaScript / TypeScript
+pip install anyvali           # Python
+go get github.com/BetterCorp/AnyVali/sdk/go  # Go
+cargo add anyvali             # Rust
+dotnet add package AnyVali    # C#
+composer require anyvali/anyvali  # PHP
+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/js";
+
+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>
+
+## 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!
+```
+
+## 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/js";
+import { initForm } from "@anyvali/js/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/js";
+import { createFormBindings } from "@anyvali/js/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": "reject"
+  },
+  "definitions": {},
+  "extensions": {}
+}
+```
+
+## Supported SDKs
+
+| Language | Package | Status |
+|----------|---------|--------|
+| JavaScript / TypeScript | [`@anyvali/js`](https://www.npmjs.com/package/@anyvali/js) | 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` | v0.0.1 |
+| 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>

data/lib/anyvali/anyvali_document.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module AnyVali
+  class AnyValiDocument
+    ANYVALI_VERSION = "1.0"
+    SCHEMA_VERSION = "1"
+
+    attr_reader :anyvali_version, :schema_version, :root, :definitions, :extensions
+
+    def initialize(root:, definitions: {}, extensions: {}, anyvali_version: ANYVALI_VERSION, schema_version: SCHEMA_VERSION)
+      @anyvali_version = anyvali_version
+      @schema_version = schema_version
+      @root = root
+      @definitions = definitions
+      @extensions = extensions
+    end
+
+    def to_h
+      {
+        "anyvaliVersion" => @anyvali_version,
+        "schemaVersion" => @schema_version,
+        "root" => node_to_h(@root),
+        "definitions" => @definitions.transform_values { |v| node_to_h(v) },
+        "extensions" => @extensions
+      }
+    end
+
+    def to_json(*_args)
+      require "json"
+      JSON.generate(to_h)
+    end
+
+    private
+
+    def node_to_h(node)
+      case node
+      when Hash then node
+      when Schema then node.to_node
+      else node
+      end
+    end
+  end
+end

data/lib/anyvali/format/validators.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "uri"
+require "ipaddr"
+require "date"
+
+module AnyVali
+  module Format
+    module Validators
+      EMAIL_REGEX = /\A[^@\s]+@[^@\s]+\.[^@\s]+\z/
+      UUID_REGEX = /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/i
+      # Strict IPv4: no leading zeros, octets 0-255
+      IPV4_REGEX = /\A(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]?\d)\z/
+      DATETIME_REGEX = /\A\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})\z/
+      DATE_REGEX = /\A\d{4}-\d{2}-\d{2}\z/
+
+      module_function
+
+      def validate(value, format, path, issues)
+        valid = case format
+                when "email" then valid_email?(value)
+                when "url" then valid_url?(value)
+                when "uuid" then valid_uuid?(value)
+                when "ipv4" then valid_ipv4?(value)
+                when "ipv6" then valid_ipv6?(value)
+                when "date" then valid_date?(value)
+                when "date-time" then valid_datetime?(value)
+                else false
+                end
+
+        unless valid
+          issues << ValidationIssue.new(
+            code: IssueCodes::INVALID_STRING,
+            path: path,
+            expected: format,
+            received: value
+          )
+        end
+      end
+
+      def valid_email?(value)
+        EMAIL_REGEX.match?(value)
+      end
+
+      def valid_url?(value)
+        uri = URI.parse(value)
+        %w[http https].include?(uri.scheme) && !uri.host.nil?
+      rescue URI::InvalidURIError
+        false
+      end
+
+      def valid_uuid?(value)
+        UUID_REGEX.match?(value)
+      end
+
+      def valid_ipv4?(value)
+        # Must match strict pattern (no leading zeros)
+        return false unless IPV4_REGEX.match?(value)
+        # Check for leading zeros explicitly
+        parts = value.split(".")
+        parts.length == 4 && parts.all? { |p| p == "0" || !p.start_with?("0") }
+      end
+
+      def valid_ipv6?(value)
+        addr = IPAddr.new(value)
+        addr.ipv6?
+      rescue IPAddr::InvalidAddressError, IPAddr::AddressFamilyError
+        false
+      rescue ArgumentError
+        false
+      end
+
+      def valid_date?(value)
+        return false unless DATE_REGEX.match?(value)
+        Date.parse(value)
+        true
+      rescue Date::Error, ArgumentError
+        false
+      end
+
+      def valid_datetime?(value)
+        return false unless DATETIME_REGEX.match?(value)
+        # Validate the date part
+        date_part = value[0..9]
+        valid_date?(date_part)
+      end
+    end
+  end
+end

data/lib/anyvali/interchange/exporter.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "json"
+
+module AnyVali
+  module Interchange
+    module Exporter
+      module_function
+
+      def export(schema, mode: :portable, definitions: {})
+        if mode == :portable && !schema.portable?
+          raise ValidationError, [
+            ValidationIssue.new(
+              code: IssueCodes::CUSTOM_VALIDATION_NOT_PORTABLE,
+              expected: "portable schema",
+              received: "schema with custom validators"
+            )
+          ]
+        end
+
+        doc = {
+          "anyvaliVersion" => AnyValiDocument::ANYVALI_VERSION,
+          "schemaVersion" => AnyValiDocument::SCHEMA_VERSION,
+          "root" => schema_to_node(schema),
+          "definitions" => definitions.transform_values { |v| schema_to_node(v) },
+          "extensions" => {}
+        }
+        doc
+      end
+
+      def to_json(schema, mode: :portable, definitions: {})
+        JSON.generate(export(schema, mode: mode, definitions: definitions))
+      end
+
+      def schema_to_node(schema)
+        schema.to_node
+      end
+    end
+  end
+end