logcore

type CloserRegistrar = gscore.CloserRegistrar

type Incoming struct {
	Req          *Req    `json:"req"`
	Res          *Res    `json:"res"`
	Error        *string `json:"error,omitempty"`
	ResponseTime string  `json:"responseTime"`
}

type Logger struct{ *zap.Logger }

type Options struct {
	// Level is the minimum log level. Default: InfoLevel.
	Level zapcore.Level

	// Encoding selects the zap encoder. "json" (default) or "console".
	Encoding string

	// DisableAPMCore turns off the apmzap.Core wrap. By default the
	// logger's core is wrapped so .Error/.Fatal calls are auto-emitted
	// as APM error events in Kibana → APM → Errors. Set to true to
	// disable (e.g. in tests where you don't want APM noise).
	DisableAPMCore bool

	// Service / Version / Environment are added as permanent fields on
	// every log line — useful as Kibana filters when many services
	// share an index.
	Service     string
	Version     string
	Environment string

	// RedactFields wraps the logger core with NewRedactCore so the values
	// of sensitive fields (Authorization, Cookie, password, token, card
	// data, …) are masked globally before encoding — for every log call,
	// not just the HTTP request/response logs. Defaults to false to stay
	// backwards-compatible; new services should enable it.
	RedactFields bool

	// Redactor overrides the policy used when RedactFields is true. Nil
	// uses DefaultRedactor (the package default key/pattern set).
	Redactor *Redactor

	// Extra is appended to the zap.New options list. Use it for hooks,
	// custom AddCallerSkip, ReplaceCore, etc.
	Extra []zap.Option
}

type Outgoing struct {
	Req          *Req    `json:"req"`
	Res          *Res    `json:"res"`
	Error        *string `json:"error,omitempty"`
	ResponseTime string  `json:"responseTime"`
}

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

type RedactorOptions struct {
	// Keys is the set of exact (case-insensitive) key names to mask. When
	// nil, DefaultSensitiveKeys is used. Pass a non-nil empty slice to opt
	// out of exact matching entirely.
	Keys []string

	// Patterns is the set of case-insensitive substrings; any key that
	// contains one is masked. When nil, DefaultSensitivePatterns is used.
	// Pass a non-nil empty slice to disable substring matching.
	Patterns []string

	// Extra is merged into the resolved Keys set. Use it to add app-specific
	// fields without restating the defaults.
	Extra []string

	// RemoveKeys drops keys from the resolved exact set (case-insensitive),
	// applied after Keys and Extra. Use it to un-redact a default field
	// without restating the whole Keys list — e.g. keep "x-request-id"
	// visible while everything else in the defaults stays masked.
	//
	// Note: RemoveKeys only affects exact-key matching. A key that is also
	// caught by a substring Pattern (e.g. "secret") stays masked unless you
	// also override Patterns.
	RemoveKeys []string

	// Mask overrides the replacement string. Default: RedactMask.
	Mask string

	// MaxDepth bounds recursion into nested maps/slices, guarding against
	// pathological or cyclic-looking decoded payloads. Default: 32.
	MaxDepth int

	// PartialReveal opts specific sensitive keys into partial redaction:
	// instead of replacing the whole value with Mask, the last N characters
	// are kept and the rest is masked, producing "[REDACTED]…1111". The map
	// is keyed by field name (case-insensitive) → N, the count of trailing
	// characters to reveal.
	//
	// Only keys already considered sensitive (via Keys/Patterns/Extra) are
	// eligible — listing a non-sensitive key here has no effect. Keys not
	// listed here stay fully masked, so the default policy is unchanged.
	//
	// Partial reveal only applies to string values long enough that the
	// revealed tail is at most half the value (so a short secret is never
	// mostly exposed); otherwise the value falls back to a full mask. This
	// guards against, e.g., a 5-char password leaking 4 of its characters.
	PartialReveal map[string]int
}

type Req struct {
	Params      any `json:"params,omitempty"`
	QueryString any `json:"queryString,omitempty"`
	Headers     any `json:"headers,omitempty"`
	Body        any `json:"body,omitempty"`
}

type Res struct {
	Headers    any    `json:"headers,omitempty"`
	Body       any    `json:"body,omitempty"`
	StatusCode string `json:"statusCode"`
}