Resolve misc to-dos (#26)

* Resolve delete tenant storage todo

* Delete outdated todo (resolved in #25)

* Delete resource syncing todo (resolved in #11)

* Make it clear that getArgsForTenant() is used during cache invalidation

* Delete redundant __call() and __callStatic() annotations

* Fix code style (php-cs-fixer)

* Revert %tenant_id% to-do removal

* Test all cached resolvers instead of just the domain one

* Make docblock more concise, delete renaming to-do (the name seems fine)

* Fix method in tests

* If route is the only resolver arg, use the tenant as the cache key instead of encoded route instance

* Resolve to-do

* make docblock more clear

* Add comments to getResolverArgument()

* Rename $id to $tenantKey

* Fix code style (php-cs-fixer)

* Add regression test for forgetting tenant parameters of cached tenants

* Forget route parameter when tenant gets resolved

* Add parameter type

* Simplify getCacheKey()

* Resolvers wip

* Resolvers wip

* Fix code style (php-cs-fixer)

* Bring back the route instance check to getCacheKey, fix test

* add todo

* add assertion

---------

Co-authored-by: PHP CS Fixer <phpcsfixer@example.com>
Co-authored-by: Samuel Štancl <samuel.stancl@gmail.com>
Co-authored-by: Samuel Štancl <samuel@archte.ch>

src/Contracts/Domain.php

@@ -11,8 +11,6 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
  *
  * @see \Stancl\Tenancy\Database\Models\Domain
  *
- * @method __call(string $method, array $parameters) IDE support. This will be a model. // todo check if we can remove these now
- * @method static __callStatic(string $method, array $parameters) IDE support. This will be a model.
  * @mixin \Illuminate\Database\Eloquent\Model
  */
 interface Domain

src/Database/DatabaseConfig.php

@@ -162,10 +162,7 @@ class DatabaseConfig
     }
 
     /**
-     * Purge host database connection.
-     *
-     * It's possible database has previous tenant connection.
-     * This will clean up the previous connection before creating it for the current tenant.
+     * Purge the previous tenant connection before opening it for another tenant.
      */
     public function purgeHostConnection(): void
     {
@@ -205,7 +202,7 @@ class DatabaseConfig
     public function manager(): Contracts\TenantDatabaseManager
     {
         // Laravel caches the previous PDO connection, so we purge it to be able to change the connection details
-        $this->purgeHostConnection(); // todo come up with a better name
+        $this->purgeHostConnection();
 
         // Create the tenant host connection config
         $tenantHostConnectionName = $this->getTenantHostConnectionName();

src/Listeners/DeleteTenantStorage.php

@@ -11,9 +11,6 @@ class DeleteTenantStorage
 {
     public function handle(DeletingTenant $event): void
     {
-        // todo@lukas since this is using the 'File' facade instead of low-level PHP functions, Tenancy might affect this?
-        //            Therefore, when Tenancy is initialized, this might look INSIDE the tenant's storage, instead of the main storage dir?
-        //            The DeletingTenant event will be fired in the central context in 99% of cases, but sometimes it might run in the tenant context (from another tenant) so we want to make sure this works well in all contexts.
         File::deleteDirectory($event->tenant->run(fn () => storage_path()));
     }
 }

src/Listeners/UpdateSyncedResource.php

@@ -16,8 +16,6 @@ use Stancl\Tenancy\Events\SyncedResourceSaved;
 use Stancl\Tenancy\Exceptions\ModelNotSyncMasterException;
 use Stancl\Tenancy\Tenancy;
 
-// todo@v4 review all code related to resource syncing
-
 class UpdateSyncedResource extends QueueableListener
 {
     public static bool $shouldQueue = false;

src/Resolvers/Contracts/CachedTenantResolver.php

@@ -62,11 +62,13 @@ abstract class CachedTenantResolver implements TenantResolver
     }
 
     /**
-     * Get all the arg combinations for resolve() that can be used to find this tenant.
+     * Get all possible argument combinations for resolve() which can be used for caching the tenant.
+     *
+     * This is used during tenant cache invalidation.
      *
      * @return array[]
      */
-    abstract public function getArgsForTenant(Tenant $tenant): array; // todo@v4 make it clear that this is only used for cache *invalidation*
+    abstract public function getArgsForTenant(Tenant $tenant): array;
 
     public static function shouldCache(): bool
     {

src/Resolvers/PathTenantResolver.php

@@ -7,6 +7,7 @@ namespace Stancl\Tenancy\Resolvers;
 use Illuminate\Routing\Route;
 use Stancl\Tenancy\Contracts\Tenant;
 use Stancl\Tenancy\Exceptions\TenantCouldNotBeIdentifiedByPathException;
+use Stancl\Tenancy\PathIdentificationManager;
 
 class PathTenantResolver extends Contracts\CachedTenantResolver
 {
@@ -37,6 +38,26 @@ class PathTenantResolver extends Contracts\CachedTenantResolver
         ];
     }
 
+    public function resolved(Tenant $tenant, mixed ...$args): void
+    {
+        /** @var Route $route */
+        $route = $args[0];
+
+        $route->forgetParameter(PathIdentificationManager::getTenantParameterName());
+    }
+
+    public function getCacheKey(mixed ...$args): string
+    {
+        // todo@samuel: fix the coupling here. when this is called from the cachedresolver, $args are the tenant key. when it's called from within this class, $args are a Route instance
+        // the logic shouldn't have to be coupled to where it's being called from
+
+        // $args[0] can be either a Route instance with the tenant key as a parameter
+        // Or the tenant key
+        $args = [$args[0] instanceof Route ? $args[0]->parameter(static::tenantParameterName()) : $args[0]];
+
+        return '_tenancy_resolver:' . static::class . ':' . json_encode($args);
+    }
+
     public static function tenantParameterName(): string
     {
         return config('tenancy.identification.resolvers.' . static::class . '.tenant_parameter_name') ?? 'tenant';