Finesse/QueryScribe

<?php

namespace Finesse\QueryScribe;

use Finesse\QueryScribe\Exceptions\InvalidReturnValueException;

/**
 * Represents an object that turns closures to Query objects.
 *
 * @todo Expand it to resolving any values
 * @author Surgie
 */
interface ClosureResolverInterface
{
    /**
     * Resolves a closure given instead of a subquery.
     *
     * @param \Closure $callback
     * @return Query
     * @throws InvalidReturnValueException
     */
    public function resolveSubQueryClosure(\Closure $callback): Query;

    /**
     * Resolves a closure given instead of a criteria group query.
     *
     * @param \Closure $callback
     * @return Query
     * @throws InvalidReturnValueException
     */
    public function resolveCriteriaGroupClosure(\Closure $callback): Query;
}