allow using closures to signal things

src/DurableClient.php

@@ -32,8 +32,9 @@
 
 class DurableClient implements DurableClientInterface
 {
-    public function __construct(private EntityClientInterface $entityClient, private OrchestrationClientInterface $orchestrationClient)
-    {
+    public function __construct(
+        private EntityClientInterface $entityClient, private OrchestrationClientInterface $orchestrationClient
+    ) {
     }
 
     public function cleanEntityStorage(): void
@@ -109,4 +110,9 @@ public function getEntitySnapshot(EntityId $entityId): EntityState|null
     {
         return $this->entityClient->getEntitySnapshot($entityId);
     }
+
+    public function signal(EntityId|string $entityId, \Closure $signal): void
+    {
+        $this->entityClient->signal($entityId, $signal);
+    }
 }

src/EntityClient.php

@@ -30,6 +30,7 @@
 use Bottledcode\DurablePhp\Events\RaiseEvent;
 use Bottledcode\DurablePhp\Events\WithDelay;
 use Bottledcode\DurablePhp\Events\WithEntity;
+use Bottledcode\DurablePhp\Proxy\SpyProxy;
 use Bottledcode\DurablePhp\State\EntityHistory;
 use Bottledcode\DurablePhp\State\EntityId;
 use Bottledcode\DurablePhp\State\EntityState;
@@ -40,7 +41,7 @@ class EntityClient implements EntityClientInterface
     use PartitionCalculator;
 
 
-    public function __construct(private Config $config, private Source $source)
+    public function __construct(private Config $config, private Source $source, private SpyProxy $spyProxy)
     {
     }
 
@@ -54,6 +55,23 @@ public function listEntities(): \Generator
         throw new \Exception('Not implemented');
     }
 
+    public function getEntitySnapshot(EntityId $entityId): EntityState|null
+    {
+        return $this->source->get(StateId::fromEntityId($entityId), EntityHistory::class)?->getState();
+    }
+
+    public function signal(EntityId|string $entityId, \Closure $signal): void
+    {
+        $interfaceReflector = new \ReflectionFunction($signal);
+        $interfaceName = $interfaceReflector->getParameters()[0]->getName();
+        $spy = $this->spyProxy->define($interfaceName);
+        $class = new $spy($operationName, $arguments);
+        $signal($class);
+        $this->signalEntity(
+            is_string($entityId) ? new EntityId($interfaceName, $entityId) : $entityId, $operationName, $arguments
+        );
+    }
+
     public function signalEntity(
         EntityId $entityId,
         string $operationName,
@@ -70,9 +88,4 @@ public function signalEntity(
 
         $this->source->storeEvent($event, false);
     }
-
-    public function getEntitySnapshot(EntityId $entityId): EntityState|null
-    {
-        return $this->source->get(StateId::fromEntityId($entityId), EntityHistory::class)?->getState();
-    }
 }

src/EntityClientInterface.php

@@ -59,6 +59,15 @@ public function signalEntity(
         \DateTimeImmutable $scheduledTime = null
     ): void;
 
+    /**
+     * Signals an entity using a closure
+     *
+     * @param EntityId|string $entityId The id of the entity to signal
+     * @param \Closure $signal
+     * @return void
+     */
+    public function signal(EntityId|string $entityId, \Closure $signal): void;
+
     /**
      * @template T
      * @param EntityId $entityId

src/Proxy/SpyProxy.php

@@ -0,0 +1,77 @@
+<?php
+/*
+ * Copyright ©2023 Robert Landers
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the “Software”), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
+ * OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
+ * OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+namespace Bottledcode\DurablePhp\Proxy;
+
+class SpyProxy extends Generator
+{
+    protected function pureMethod(\ReflectionMethod $method): string
+    {
+        return $this->impureCall($method);
+    }
+
+    protected function impureCall(\ReflectionMethod $method): string
+    {
+        $name = $method->getName();
+        $params = $method->getParameters();
+        $params = array_map(
+            function (\ReflectionParameter $param) {
+                $type = $param->getType();
+                if ($type !== null) {
+                    $type = $this->getTypes($type);
+                }
+
+                return "$type \${$param->getName()}";
+            },
+            $params
+        );
+        $params = implode(', ', $params);
+        $return = $method->getReturnType();
+        $return = $return ? ": {$this->getTypes($return)}" : '';
+
+        return <<<EOT
+public function $name($params)$return {
+    \$this->operation = __METHOD__;
+    \$this->arguments = func_get_args();
+    throw new \Exception('Not implemented');
+}
+EOT;
+    }
+
+    protected function getName(\ReflectionClass $class): string
+    {
+        return "__SpyProxy_{$class->getShortName()}";
+    }
+
+    protected function impureSignal(\ReflectionMethod $method): string
+    {
+        return $this->impureCall($method);
+    }
+
+    protected function preamble(\ReflectionClass $class): string
+    {
+        return <<<'EOT'
+public function __construct(private string|null &$operation = null, private array|null &$arguments = null) {}
+EOT;
+    }
+}