refactor: deprecate proxy class

src/AnonymousFactory.php

@@ -11,6 +11,8 @@
 
 namespace Zenstruck\Foundry;
 
+use Zenstruck\Foundry\Persistence\Proxy;
+
 /**
  * @template TModel of object
  * @template-extends Factory<TModel>

src/Bundle/Maker/Factory/MakeFactoryData.php

@@ -14,7 +14,7 @@
 use Symfony\Bundle\MakerBundle\Str;
 use Symfony\Bundle\MakerBundle\Util\ClassNameDetails;
 use Zenstruck\Foundry\Persistence\PersistentProxyObjectFactory;
-use Zenstruck\Foundry\Proxy;
+use Zenstruck\Foundry\Persistence\Proxy;
 use Zenstruck\Foundry\RepositoryProxy;
 
 /**

src/Configuration.php

@@ -16,6 +16,7 @@
 use Doctrine\Persistence\ObjectManager;
 use Faker;
 use Zenstruck\Foundry\Exception\FoundryBootException;
+use Zenstruck\Foundry\Persistence\Proxy;
 
 /**
  * @internal
@@ -184,7 +185,7 @@ public function repositoryFor(object|string $objectOrClass): RepositoryProxy
         }
 
         if ($objectOrClass instanceof Proxy) {
-            $objectOrClass = $objectOrClass->object();
+            $objectOrClass = $objectOrClass->_real();
         }
 
         if (!\is_string($objectOrClass)) {

src/Factory.php

@@ -18,6 +18,7 @@
 use Zenstruck\Foundry\Exception\FoundryBootException;
 use Zenstruck\Foundry\Persistence\InversedRelationshipPostPersistCallback;
 use Zenstruck\Foundry\Persistence\PostPersistCallback;
+use Zenstruck\Foundry\Persistence\Proxy;
 
 /**
  * @template TObject of object
@@ -152,8 +153,8 @@ final public function create(array|callable $attributes = []): Proxy
         }
 
         return $proxy
-            ->save()
-            ->withoutAutoRefresh(function(Proxy $proxy) use ($attributes, $postPersistCallbacks): void {
+            ->_save()
+            ->_withoutAutoRefresh(function(Proxy $proxy) use ($attributes, $postPersistCallbacks): void {
                 $callbacks = [...$postPersistCallbacks, ...$this->afterPersist];
 
                 if (!$callbacks) {
@@ -164,7 +165,7 @@ final public function create(array|callable $attributes = []): Proxy
                     $proxy->executeCallback($callback, $attributes);
                 }
 
-                $proxy->save(); // save again as afterPersist events may have modified
+                $proxy->_save(); // save again as afterPersist events may have modified
             })
         ;
     }
@@ -375,7 +376,7 @@ private function normalizeAttributes(array|callable $attributes): array
     private function normalizeAttribute(mixed $value, string $name): mixed
     {
         if ($value instanceof Proxy) {
-            return $value->isPersisted() ? $value->refresh()->object() : $value->object();
+            return $value->isPersisted(calledInternally: true) ? $value->_refresh()->_real() : $value->_real();
         }
 
         if ($value instanceof FactoryCollection) {
@@ -399,25 +400,25 @@ private function normalizeAttribute(mixed $value, string $name): mixed
         }
 
         if (!self::configuration()->hasManagerRegistry()) {
-            return $value->create()->object();
+            return $value->create()->_real();
         }
 
         try {
             $objectManager = self::configuration()->objectManagerFor($this->class);
 
             if (!$objectManager instanceof EntityManagerInterface || $objectManager->getClassMetadata($value->class)->isEmbeddedClass) {
                 // we may deal with ODM document or ORM\Embedded
-                return $value->create()->object();
+                return $value->create()->_real();
             }
         } catch (\Throwable) {
             // not persisted object
-            return $value->create()->object();
+            return $value->create()->_real();
         }
 
         $relationshipMetadata = self::getRelationshipMetadata($objectManager, $this->class, $name);
 
         if (!$relationshipMetadata) {
-            return $value->create()->object();
+            return $value->create()->_real();
         }
 
         if ($relationshipMetadata['isOwningSide']) {
@@ -436,13 +437,13 @@ private function normalizeAttribute(mixed $value, string $name): mixed
             $value = $value->withCascadePersist();
         }
 
-        return $value->create()->object();
+        return $value->create()->_real();
     }
 
     private static function normalizeObject(object $object): object
     {
         try {
-            return Proxy::createFromPersisted($object)->refresh()->object();
+            return Proxy::createFromPersisted($object)->_refresh()->_real();
         } catch (\RuntimeException) {
             return $object;
         }

src/FactoryCollection.php

@@ -11,6 +11,8 @@
 
 namespace Zenstruck\Foundry;
 
+use Zenstruck\Foundry\Persistence\Proxy;
+
 /**
  * @template TObject of object
  *

src/ModelFactory.php

@@ -12,6 +12,7 @@
 namespace Zenstruck\Foundry;
 
 use Zenstruck\Foundry\Persistence\PersistentProxyObjectFactory;
+use Zenstruck\Foundry\Persistence\Proxy;
 
 /**
  * @template TModel of object

src/Persistence/InversedRelationshipPostPersistCallback.php

@@ -14,7 +14,7 @@
 namespace Zenstruck\Foundry\Persistence;
 
 use Zenstruck\Foundry\Factory;
-use Zenstruck\Foundry\Proxy;
+use Zenstruck\Foundry\Persistence\Proxy;
 
 /**
  * @internal
@@ -34,6 +34,6 @@ public function __invoke(Proxy $proxy): void
             $this->relationshipField => $this->isCollection ? [$proxy] : $proxy,
         ]);
 
-        $proxy->refresh();
+        $proxy->_refresh();
     }
 }

src/Persistence/PersistentProxyObjectFactory.php

@@ -6,7 +6,6 @@
 
 use Zenstruck\Foundry\Exception\FoundryBootException;
 use Zenstruck\Foundry\Factory;
-use Zenstruck\Foundry\Proxy;
 use Zenstruck\Foundry\RepositoryAssertions;
 use Zenstruck\Foundry\RepositoryProxy;
 

src/Persistence/PostPersistCallback.php

@@ -13,7 +13,7 @@
 
 namespace Zenstruck\Foundry\Persistence;
 
-use Zenstruck\Foundry\Proxy;
+use Zenstruck\Foundry\Persistence\Proxy;
 
 /**
  * @internal