Function RegisterExtension

modules/overrides/extension.go:60–100

RegisterExtension registers a per-tenant overrides extension. The extension e must be a non-nil pointer to the extension struct (pointer receivers are required). Panics if: - e is nil or not a pointer - Key() is empty or already registered - Key() conflicts with any built-in Overrides or LegacyOverr

(e T)

//
// Returns a typed getter that retrieves the extension value from an Overrides.
func RegisterExtension[T Extension](e T) func(*Overrides) T {
	// Check for nil / typed-nil before any method call so callers get a clear
	// panic message instead of a nil-dereference inside Key() or LegacyKeys().
	typ := reflect.TypeOf(e)
	if typ == nil || typ.Kind() != reflect.Ptr {
		panic("overrides: RegisterExtension requires a non-nil pointer to the extension struct")
	}
	if reflect.ValueOf(e).IsNil() {
		panic("overrides: RegisterExtension requires a non-nil pointer to the extension struct")
	}

	key := e.Key()
	if key == "" {
		panic("overrides: extension Key() cannot be empty")
	}
	legacyKeys := e.LegacyKeys()

	extensionRegistry.Lock()
	defer extensionRegistry.Unlock()

	validateExtensionKey(key)
	validateExtensionLegacyKeys(key, legacyKeys)

	extensionRegistry.entries[key] = &registryEntry{
		key:        key,
		legacyKeys: legacyKeys,
		elemType:   typ.Elem(),
	}
	for _, lk := range legacyKeys {
		extensionRegistry.allLegacyKeys[lk] = struct{}{}
	}

	return func(o *Overrides) T {
		if o == nil || o.Extensions == nil {
			var zero T
			return zero
		}
		v, _ := o.Extensions[key].(T)
		return v
	}
}

// validateExtensionKey checks that key does not conflict with any reserved name.
// Must be called with extensionRegistry.Lock held.