typescript

type FieldDef struct {
	Name     string
	Type     string
	Optional bool
}

type GeneratedFile struct {
	Path    string
	Content string
}

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

type GeneratorConfig struct {
	// PackageName is the npm package name (default: "@authsome/client").
	PackageName string

	// PackageVersion is the npm package version (default: "0.5.0").
	PackageVersion string

	// OutputMode controls what files are generated.
	// "standalone" (default) — full npm package (types, client, index, package.json, tsconfig).
	// "embedded" — only api-types.ts and api-client.ts for embedding in another package.
	OutputMode string

	// MethodOverrides maps operationID to a custom method name.
	// e.g., {"refreshSession": "refresh", "deleteAccount": "deleteMe"}
	MethodOverrides map[string]string
}

type OperationDef struct {
	Name              string
	Method            string
	Path              string
	Summary           string
	HasBody           bool
	FormBody          bool
	BodyType          string
	ResponseType      string
	AuthRequired      bool
	Tags              []string
	PathParams        []PathParamDef
	QueryParams       []QueryParamDef
	NeedsRequestAlias bool // true when the request type alias differs from an existing schema type
}

type PathParamDef struct {
	Name   string // Original name from the spec (e.g., "orgId")
	TSName string // TypeScript parameter name (e.g., "orgId")
}

type QueryParamDef struct {
	Name     string // Original name from the spec (e.g., "limit")
	TSName   string // TypeScript parameter name (e.g., "limit")
	Type     string // TypeScript type (e.g., "number", "string[]")
	Required bool

	// Repeated marks an array-typed query parameter, which is sent once per
	// value rather than once in total. Query parameters default to style form
	// with explode true, so an array in the document means exactly that.
	Repeated bool
}

type TemplateData struct {
	PackageName        string
	PackageVersion     string
	OutputMode         string
	Types              []TypeDef
	Operations         []OperationDef
	RequestTypeImports []string // Additional request type names to import (not already in Types)
	HasSocial          bool
	HasMagicLink       bool
	HasMFA             bool
}

type TypeDef struct {
	Name       string
	Fields     []FieldDef
	IsResponse bool
}