Files
gateway/internal/pkg/flatmap/tree/tree.go
zeekayandHanzo Dev 53350699b6 deps(vendor): fold the krakend/lura module set into internal/
Every import in this module now resolves to github.com/hanzoai/gateway/v2.
The 34 github.com/krakend/* + github.com/luraproject/lura modules that
supplied the engine and its components are vendored under internal/ and
their 91 packages rewritten onto our own path.

Why fold rather than mirror into 34 hanzoai/* repos:

  - It removes the exposure outright. 34 rows leave 34 rows of go.sum to
    reason about; zero modules leave nothing. `go list -m all` and go.sum
    now contain no krakend/lura entry at all.
  - Cross-references cannot go wrong. 28 of the 34 import lura (97 files
    inside lura self-reference it). Mirroring means rewriting every one of
    those to our lura, and a single miss silently links a SECOND copy of
    lura into the binary. With one module that is structurally impossible.
  - It creates no duplicates. These are lura-coupled gateway glue with no
    consumer outside this binary; publishing 34 repos would be 34 new
    things to maintain for zero second caller. internal/ makes that
    guarantee mechanical — Go forbids importing it from outside this
    module, so none of it can become a competing public package. Verified
    no repo outside gateway imports any hanzoai/gateway/v2 subpackage.

Layout mirrors provenance so an upstream re-sync stays a diff:

  luraproject/lura/v2  -> internal/lura         (the engine, 20 pkgs)
  krakend/krakend-<x>  -> internal/plugin/<x>   (28 components)
  krakend/<x>          -> internal/pkg/<x>      (6 standalone libs)

This commit is PURELY MECHANICAL: 196 of the 197 vendored files are
byte-identical to their upstream original once the import rewrite is
applied. The single exception is bloomfilter's subpackage, which upstream
names `krakend` — the one package name that could not survive as-is; it
becomes internal/pkg/bloomfilter/register. Hand edits land separately in
the next commit so they are readable on their own.

Per `go mod vendor` semantics, dependencies' _test.go files are not
vendored. They test upstream code at a pinned version that we do not
modify, several cannot run at all from a module distribution (they need
TLS certs and compiled .so plugins upstream generates but never ships),
and one is a 100k-request stress test that exhausts the ephemeral port
range and fails every package running beside it. Fold integrity is proven
by the byte-diff above instead, which is the stronger check.

Preserved deliberately — each of these is behaviour, not branding:
  - the `github.com/devopsfaith/krakend*` extra_config namespace strings
    (35 of them). These are config-surface keys, not import paths;
    renaming one silently stops that component finding its config. The
    jose validator namespace backs `auth/validator` on 212 endpoints.
  - core.KrakendVersion / KrakendUserAgent / the X-KRAKEND consts, whose
    VALUES rebrand.go overwrites — that seam is unchanged.
  - the KRAKEND_ koanf env prefix (a hardcoded upstream const).
  - every vendored module's LICENSE (34 files, Apache-2.0/MIT).

The Makefile/CI -X paths move with the engine. An -X naming a symbol that
does not exist is silently ignored by the linker, so a stale path here
would have shipped an "undefined" version in the backend User-Agent and
X-Api-Version with a perfectly green build. Verified live:
`gateway version` reports 2.13.0, not undefined.

Verification (GOWORK=off CGO_ENABLED=0, both tag modes):
  go build ./...              OK      go build -tags legacy ./...   OK
  go vet ./...                clean   go vet -tags legacy ./...     clean
  go test ./...               6/6 ok  go test -tags legacy          5/5 ok
  tests/ integration harness  47 fixtures pass
  gateway check -c configs/{hanzo,lux}/gateway.json  -> Syntax OK!
  go list -m all | grep -iE 'krakend|lura'  -> empty
  go mod verify -> all modules verified

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-25 14:57:19 -07:00

220 lines
4.3 KiB
Go

package tree
import (
"errors"
)
const wildcard = "*"
var errNoNilValuesAllowed = errors.New("no nil values allowed")
// Tree is a wrapper over tha root node od a tree
type Tree struct {
root *node
}
// New returns a new Tee containning a decomposed version of v
func New(v interface{}) (*Tree, error) {
if v == nil {
return nil, errNoNilValuesAllowed
}
tr := &Tree{
root: &node{},
}
tr.Add([]string{}, v)
return tr, nil
}
// Add introduces the value v at the path defined by ks
func (t *Tree) Add(ks []string, v interface{}) {
if v == nil {
return
}
t.root.Add(ks, v)
}
// Del removes all nodes and edges in the tree matching the path defined by ks
func (t *Tree) Del(ks []string) {
t.root.Del(ks...)
}
// Append appends the contents of the array src to the array dst
func (t *Tree) Append(src, dst []string) {
elements1, ok := t.root.Get(src...).([]interface{})
if !ok {
return
}
elements2, ok := t.root.Get(dst...).([]interface{})
if !ok {
return
}
t.root.Add(dst, append(elements2, elements1...))
t.root.Del(src...)
}
// Get returns all nodes and edges in the tree matching the path defined by ks
func (t *Tree) Get(ks []string) interface{} {
return t.root.Get(ks...)
}
// Move moves all nodes and edges in the tree matching the path defined by src to dst
func (t *Tree) Move(src, dst []string) {
next := []nodeAndPath{{n: t.root, p: []string{}}}
prefixLen := len(src)
// lookup for the nodes matching the src pattern without the last segment
if prefixLen > 1 {
next = t.collectMoveCandidates(src[:prefixLen-1], next)
}
// extract edges from the collected nodes that match the last segment of the src
edgesToMove := []edgeToMove{}
lenDst := len(dst)
// if len(src) == len(dst) this is just a relabeling
isEdgeRelabel := prefixLen == lenDst
for _, nap := range next {
for i, e := range nap.n.edges {
if e.label != src[prefixLen-1] {
continue
}
if isEdgeRelabel {
e.label = dst[prefixLen-1]
break
}
edgesToMove = append(edgesToMove, edgeToMove{nodeAndPath: nap, e: e})
copy(nap.n.edges[i:], nap.n.edges[i+1:])
nap.n.edges[len(nap.n.edges)-1] = nil
nap.n.edges = nap.n.edges[:len(nap.n.edges)-1]
break
}
}
if isEdgeRelabel {
return
}
// insert the extracted values
// if len(src) > len(dst) this is a promotion
if prefixLen > lenDst {
t.promoteEdges(edgesToMove, dst)
return
}
// this is an embedding, so intermediate nodes should be found or created
t.embeddingEdges(edgesToMove, dst[prefixLen-1:])
}
// Sort sorts the edges in the tree
func (t *Tree) Sort() {
t.root.sort()
}
func (*Tree) collectMoveCandidates(src []string, next []nodeAndPath) []nodeAndPath {
acc := []nodeAndPath{}
for _, step := range src {
if step == wildcard {
for _, nap := range next {
for _, e := range nap.n.edges {
acc = append(acc, nodeAndPath{n: e.n, p: append(nap.p, e.label)})
}
}
} else {
for _, nap := range next {
for _, e := range nap.n.edges {
if step == e.label {
acc = append(acc, nodeAndPath{n: e.n, p: append(nap.p, e.label)})
break
}
}
}
}
next, acc = acc, next[:0]
}
return next
}
func (t *Tree) promoteEdges(edgesToMove []edgeToMove, dst []string) {
var l string
lenDst := len(dst)
for _, n := range edgesToMove {
parent := t.root
for i, path := range dst[:lenDst-1] {
if path == wildcard {
l = n.p[i]
} else {
l = path
}
found := false
for _, e := range parent.edges {
if e.label != l {
continue
}
found = true
parent = e.n
break
}
if !found {
break
}
}
n.e.n.SetDepth(parent.depth + 1)
n.e.label = dst[lenDst-1]
parent.edges = append(parent.edges, n.e)
}
}
func (*Tree) embeddingEdges(edgesToMove []edgeToMove, dst []string) {
lenDst := len(dst)
for _, em := range edgesToMove {
root := em.n
for _, k := range dst[:lenDst-1] {
found := false
for _, e := range root.edges {
if e.label != k {
continue
}
found = true
root = e.n
break
}
if found {
continue
}
child := newNode(root.depth + 1)
root.edges = append(root.edges, &edge{label: k, n: child})
root = child
}
em.e.label = dst[lenDst-1]
em.e.n.SetDepth(root.depth + 1)
root.edges = append(root.edges, em.e)
}
}
type nodeAndPath struct {
n *node
p []string
}
type edgeToMove struct {
nodeAndPath
e *edge
}