validation

package module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 4, 2026 License: MIT Imports: 25 Imported by: 0

Documentation

Overview

Package validation validates Lambda inputs and outputs against JSON Schema.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Validate

func Validate(ctx context.Context, payload, schema any, options Options) (any, error)

Validate compiles for this call, then extracts and validates the payload. Use Compile once for warm-invocation reuse.

func WrapHandler

func WrapHandler[I, T, R any](inbound, outbound *Schema, handler func(context.Context, T) (R, error)) func(context.Context, I) (R, error)

WrapHandler validates a cloned inbound event and a successful outbound response. Only inbound validation applies an envelope; business errors and panics propagate.

Types

type CompileOptions

type CompileOptions struct {
	Regex   RegexOptions
	Formats map[string]func(any) error
	// NumberFormats applies callbacks to JSON numbers rather than strings.
	NumberFormats map[string]func(any) error
	// ExternalRefs registers URL-keyed documents in lexical URL order.
	ExternalRefs map[string]any
	// ExternalSchemas registers documents by $id in slice order, after ExternalRefs.
	// Use it when nested resource identities depend on registration order.
	ExternalSchemas []any
}

type Compiler

type Compiler interface {
	Compile(context.Context, any, CompileOptions) (Validator, error)
}

type Issue

type Issue struct {
	InstancePath string         `json:"instancePath"`
	SchemaPath   string         `json:"schemaPath"`
	Keyword      string         `json:"keyword"`
	Message      string         `json:"message"`
	Params       map[string]any `json:"params"`
	PropertyName *string        `json:"propertyName,omitempty"`
}

type Options

type Options struct {
	CompileOptions
	Envelope     string
	QueryOptions []jmespath.Option
	Compiler     Compiler
}

type RegexError

type RegexError struct {
	Pattern string
	Err     error
}

RegexError identifies an operational match failure, not an invalid payload.

func (*RegexError) Error

func (e *RegexError) Error() string

func (*RegexError) Unwrap

func (e *RegexError) Unwrap() error

type RegexOptions

type RegexOptions struct {
	MatchTimeout time.Duration
	// A positive value sets the stack bound; a negative value removes it.
	MaxBacktrackingStackSize int
}

RegexOptions configures operational limits without changing pattern syntax. Zero values use the engine's defaults: no timeout and a 100,000-entry stack.

type Schema

type Schema struct {
	// contains filtered or unexported fields
}

Schema retains a reusable validator and optional compiled extraction expression.

func Compile

func Compile(ctx context.Context, schema any, options Options) (*Schema, error)

func (*Schema) Validate

func (s *Schema) Validate(ctx context.Context, payload any) (any, error)

type SchemaCompilationError

type SchemaCompilationError struct{ Err error }

func (*SchemaCompilationError) Error

func (e *SchemaCompilationError) Error() string

func (*SchemaCompilationError) Unwrap

func (e *SchemaCompilationError) Unwrap() error

type SchemaValidationError

type SchemaValidationError struct {
	Message string
	Issues  []Issue
	Err     error
}

func (*SchemaValidationError) Error

func (e *SchemaValidationError) Error() string

func (*SchemaValidationError) Unwrap

func (e *SchemaValidationError) Unwrap() error

type Validator

type Validator interface {
	Validate(context.Context, any) ([]Issue, error)
}

Validator returns validation diagnostics separately from operational errors. Implementations reused across invocations must support concurrent calls.

type ValidatorFunc

type ValidatorFunc func(context.Context, any) ([]Issue, error)

func (ValidatorFunc) Validate

func (f ValidatorFunc) Validate(ctx context.Context, input any) ([]Issue, error)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL