chaff

type DocumentFetchOptions struct {
	// HTTP Fetch Options
	HTTPFetchOptions HTTPFetchOptions `json:"httpFetchOptions,omitempty" jsonschema:"title=HTTP Document Resolver Options"`

	// File System Fetch Options
	FileSystemFetchOptions FileSystemFetchOptions `json:"fileSystemFetchOptions,omitempty" jsonschema:"title=File System Document Resolver Options"`
}

type FileSystemFetchOptions struct {
	// If go-chaff is allowed to access the file system to resolve schema references
	//    THIS SHOULD BE DISABLED UNLESS YOU REALLY REALLY NEED IT (does not work in contexts without filesystems such as in browser)
	//    Please if doing so, limit the AllowedPaths field as much as possible )
	Enabled bool `json:"enabled,omitempty" jsonschema:"title=Fetch documents From File System Enabled"`

	// Overrides allowOutsideCwd to specifically allow for access to a list of paths schemas might reference
	// relative paths will be resolved against the current working directory at the time the parser is initialized
	// Symlinks that resolve to outside of the allowed paths will still be blocked
	AllowedPaths []string `json:"allowedPaths,omitempty" jsonschema:"title=Allowed Paths"`

	// Failsafe to prevent directory traversal attacks
	AllowOutsideCwd bool `json:"allowOutsideCwd,omitempty" jsonschema:"title=Allow Access To Paths Outside Of Current Working Directory"`
}

type Generator interface {
	fmt.Stringer
	Generate(*GeneratorOptions) interface{}
}

type GeneratorOptions struct {
	// The source of randomness to use for the given generation.
	// Please note that some parts of the generators use different sources of randomness.
	// ("regex" generation and "format" strings)
	Rand *rand.RandUtil `json:"-"`

	// The default minimum number value
	DefaultNumberMinimum int `json:"defaultNumberMinimum,omitempty" jsonschema:"title=Default Number Minimum"`

	// The default maximum number value
	DefaultNumberMaximum int `json:"defaultNumberMaximum,omitempty" jsonschema:"title=Default Number Maximum"`

	// The default minimum String length
	DefaultStringMinLength int `json:"defaultStringMinLength,omitempty" jsonschema:"title=Default String Minimum Length"`

	// The default maximum String length
	DefaultStringMaxLength int `json:"defaultStringMaxLength,omitempty" jsonschema:"title=Default String Maximum Length"`

	// The default minimum array length
	DefaultArrayMinItems int `json:"defaultArrayMinItems,omitempty" jsonschema:"title=Default Array Minimum Items"`

	// The default maximum array length
	// This will be set min + this inf the event a minimum value is set
	DefaultArrayMaxItems int `json:"defaultArrayMaxItems,omitempty" jsonschema:"title=Default Array Maximum Items"`

	// The default minimum object properties (Will be ignored if there are fewer properties available)
	DefaultObjectMinProperties int `json:"defaultObjectMinProperties,omitempty" jsonschema:"title=Default Object Minimum Properties"`

	// The default maximum object properties (Will be ignored if there are fewer properties available)
	DefaultObjectMaxProperties int `json:"defaultObjectMaxProperties,omitempty" jsonschema:"title=Default Object Maximum Properties"`

	// The maximum dnumber of references to resolve at once in terms of depth (Default: 10)
	MaximumReferenceDepth int `json:"maximumReferenceDepth,omitempty" jsonschema:"title=Maximum Reference Depth"`

	// In the event that schemas are recursive there is a good chance the generator
	// can run forever. This option will bypass the check for cyclic references
	// Please defer to the MaximumReferenceDepth option if possible when using this
	BypassCyclicReferenceCheck bool `json:"bypassCyclicReferenceCheck,omitempty" jsonschema:"title=Bypass Cyclic Reference Check"`

	// Used to keep track of references during a resolution cycle (Used internally and can be ignored)
	ReferenceResolver referenceResolver `json:"-"`

	// Though technically in some cases a schema may allow for additional
	// values it might not always be desireable. this option suppresses fallback_n values
	// so that they will only appear to make up a "minimum value" forces them to
	SuppressFallbackValues bool `json:"suppressFallbackValues,omitempty" jsonschema:"title=Suppress Fallback Values"`

	// The maximum number of times to attempt to generate a unique value
	// when using unique* constraints in schemas
	MaximumUniqueGeneratorAttempts int `json:"maximumUniqueGeneratorAttempts,omitempty" jsonschema:"title=Maximum Unique Generator Attempts"`

	// The maximum number of times to attempt to satisfy "if" statements
	// before giving up
	MaximumIfAttempts int `json:"maximumIfAttempts,omitempty" jsonschema:"title=Maximum If Attempts"`

	// The maximum number of times to attempt to satisfy "oneOf" statements
	// before giving up
	MaximumOneOfAttempts int `json:"maximumOneOfAttempts,omitempty" jsonschema:"title=Maximum OneOf Attempts"`

	// The maximum number of steps to take when generating a value
	// after which the the generator will begin to do the "bare minimum" to generate a value
	MaximumGenerationSteps int `json:"maximumGenerationSteps,omitempty" jsonschema:"title=Maximum Generation Steps"`

	// The maximum number of steps to take before giving up entirely and aborting generation
	// This is a hard cap on generation steps to prevent extremely long generation times
	CutoffGenerationSteps int `json:"cutoffGenerationSteps,omitempty" jsonschema:"title=Cutoff Generation Steps"`
	// contains filtered or unexported fields
}

type HTTPFetchOptions struct {
	// If go-chaff is allowed to make HTTP requests to resolve schema references
	Enabled bool `json:"enabled,omitempty" jsonschema:"title=Fetch documents Over HTTP(s) Enabled"`

	// Allowed hosts to fetch from (If empty, all hosts are allowed)
	AllowedHosts []string `json:"allowedHosts,omitempty" jsonschema:"title=Allowed Hosts"`

	// Allow insecure connections (http)
	AllowInsecure bool `json:"allowInsecure,omitempty" jsonschema:"title=Allow Insecure Connections"`
}

type ParserOptions struct {
	// Options for the regex generator used for generating strings with the "pattern property"
	RegexStringOptions *regen.GeneratorArgs `json:"regexStringOptions,omitempty" jsonschema:"title=Regex String Options"`

	// Options for the regex generator used for pattern properties
	RegexPatternPropertyOptions *regen.GeneratorArgs `json:"regexPatternPropertyOptions,omitempty" jsonschema:"title=Regex Pattern Property Options"`

	// Parser fetch configurations for external document fetching
	DocumentFetchOptions DocumentFetchOptions `json:"documentFetchOptions,omitempty" jsonschema:"title=Document Fetch Options"`

	// Base path to resolve relative document references against for $ref resolution when fetching external documents
	RelativeTo string `json:"relativeTo,omitempty" jsonschema:"title=Relative To"`

	// Maximum recursion depth during parsing to prevent stack overflow from circular schemas.
	// If zero, defaults to 100.
	MaxParseDepth int `json:"maxParseDepth,omitempty" jsonschema:"title=Max Parse Depth"`
}

type RootGenerator struct {
	Generator Generator
	// For any "$defs"
	Defs map[string]Generator
	// For any "definitions"
	Definitions map[string]Generator
	// Metadata related to parser operations
	Metadata *parserMetadata
}