# getEarlyPodReference method

Future<ObjectHolder<Object>> getEarlyPodReference(

1. ObjectHolder<Object> podHolder,
2. Class podClass,
3. String name

)

Early Pod Reference

Provides an opportunity to return a reference to a pod before its full lifecycle initialization has completed.

# Purpose

- Enables support for circular dependencies by exposing a partially constructed pod to other dependents.
- Acts as a hook point where frameworks can intercept and substitute proxy instances, such as for:
  - AOP (aspect-oriented programming) proxies
  - Scoped proxies (e.g., request/session scoped)
  - Lazy-initialization wrappers

# Behavior

- By default, simply returns the given `pod` unchanged.
- Subclasses or frameworks may override this to return an alternate proxy object.
- The returned reference is used by dependents until full initialization of the pod is complete.

# Parameters

- `podHolder`: The raw pod instance just created.
- `podClass`: The reflective class metadata for the pod.
- `name`: The logical pod name.

# Example

    final myService = await getEarlyPodReference(
      rawInstance,
      Class.of<MyService>(),
      "myService",
    );

    // myService may be a proxy if overridden
    print(myService.runtimeType);

# Notes

- The default implementation is identity (`=> pod`).
- Framework users rarely call this directly; it is used internally during pod creation.
- Implementors must be careful not to break initialization contracts.

## Implementation

    Future<ObjectHolder<Object>> getEarlyPodReference(ObjectHolder<Object> podHolder, Class podClass, String name) async => podHolder;