Merge pull request #94 from codebar-ag/feature-direct

Feature Direct

Author: StanBarrows

README.md

@@ -460,14 +460,20 @@ You only need to provide correct credentials. Everything else is automatically
 handled from the package. Under the hood we are storing the authentication
 cookie in the cache named *docuware.cookies*.
 
-You can run `php artisan docuware:list-auth-cookie` command to get your auth session that you can use in your `.env` file `DOCUWARE_COOKIES` key.
+You can run `php artisan docuware:list-auth-cookie` command to get your auth session that you can use in your `.env`
+file `DOCUWARE_COOKIES` key.
 
 But if you need further control you can use the following methods to login and
 logout with DocuWare:
 
 ```php
 use CodebarAg\DocuWare\Facades\DocuWare;
 
+/**
+ * If you would like to handle the cookie storage by yourself you can get a fresh cookie with the getCookie() method.
+ */
+DocuWare::getCookie();
+
 /**
  * Login with your credentials. You only need to login once. Afterwards the
  * authentication cookie is stored in the cache as `docuware.cookies` and
@@ -566,6 +572,15 @@ This is the contents of the published config file:
 <?php
 
 return [
+    /*
+    |--------------------------------------------------------------------------
+    | Connection
+    |--------------------------------------------------------------------------
+    | Select a connector to authenticate with. You can choose between: WITHOUT_COOKIE, STATIC_COOKIE
+    |
+    */
+
+    'connection' => ConnectionEnum::WITHOUT_COOKIE,
 
     /*
     |--------------------------------------------------------------------------
@@ -698,6 +713,7 @@ cp phpunit.xml.dist phpunit.xml
 Modify environment variables in the phpunit.xml-file:
 
 ```xml
+
 <env name="DOCUWARE_URL" value="https://domain.docuware.cloud"/>
 <env name="DOCUWARE_USERNAME" value="[email protected]"/>
 <env name="DOCUWARE_PASSWORD" value="password"/>

config/docuware.php

@@ -8,7 +8,7 @@
     |--------------------------------------------------------------------------
     | Connection
     |--------------------------------------------------------------------------
-    | Select a connector to authenticate with. You can choose between: WITHOUT_COOKIE, STATIC_COOKIE, DYNAMIC_COOKIE
+    | Select a connector to authenticate with. You can choose between: WITHOUT_COOKIE, STATIC_COOKIE
     |
     */
 

src/Console/ListAuthCookie.php renamed to src/Commands/ListAuthCookie.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace CodebarAg\DocuWare\Console;
+namespace CodebarAg\DocuWare\Commands;
 
 use CodebarAg\DocuWare\Support\Auth;
 use Illuminate\Console\Command;

src/DocuWare.php

@@ -52,13 +52,43 @@
 
 class DocuWare
 {
+    const COOKIE_NAME = '.DWPLATFORMAUTH';
+
     protected $connection;
 
     public function __construct(protected ?string $cookie = null)
     {
         $this->connection = self::connection();
     }
 
+    /**
+     * @throws InvalidResponseClassException
+     * @throws \Throwable
+     * @throws \ReflectionException
+     * @throws PendingRequestException
+     */
+    public function getCookie(): string
+    {
+        EnsureValidCredentials::check();
+
+        $request = new PostLogonRequest();
+
+        $response = $this->connection->send($request);
+
+        event(new DocuWareResponseLog($response));
+
+        throw_if($response->status() === Response::HTTP_UNAUTHORIZED, UnableToLogin::create());
+        throw_if($this->connection->getCoookieJar()->toArray() === [], UnableToLoginNoCookies::create());
+
+        $cookies = $this->connection->getCoookieJar();
+
+        $cookie = collect($cookies->toArray())
+            ->reject(fn (array $cookie) => Arr::get($cookie, 'Value') === '')
+            ->firstWhere('Name', self::COOKIE_NAME);
+
+        return Arr::get($cookie, 'Value');
+    }
+
     /**
      * @throws InvalidResponseClassException
      * @throws \Throwable

src/DocuWareServiceProvider.php

@@ -2,7 +2,7 @@
 
 namespace CodebarAg\DocuWare;
 
-use CodebarAg\DocuWare\Console\ListAuthCookie;
+use CodebarAg\DocuWare\Commands\ListAuthCookie;
 use Spatie\LaravelPackageTools\Package;
 use Spatie\LaravelPackageTools\PackageServiceProvider;
 

src/Facades/DocuWare.php

@@ -18,6 +18,7 @@
 /**
  * @see \CodebarAg\DocuWare\DocuWare
  *
+ * @method static string getCookie()
  * @method static string login()
  * @method static void logout()
  * @method static Organization getOrganization(string $organizationId)

tests/Core/ArchTest.php

@@ -0,0 +1,6 @@
+<?php
+
+test('it will not use any debug function')
+    ->expect(['dd', 'ray', 'dump'])
+    ->not()
+    ->toBeUsed();

tests/Feature/AuthorizationTest.php

@@ -14,6 +14,11 @@
     expect(Auth::cookies())->toBeNull();
 });
 
+it('can receive a ', function () {
+    $cookie = DocuWare::getCookie();
+    expect($cookie)->not()->toBeEmpty()->toBeString($cookie);
+})->group('authorization');
+
 it('can authenticate with a cookie', function () {
     EnsureValidCookie::check();
     expect(Auth::cookies())->toHaveKey(Auth::COOKIE_NAME);