Merge branch 'develop'

* develop:
  specify next release
  fix documentation
  update documentation
  remove unused exception
  make Native constructor private
  Session\Id and Session\Name constructors are now private
  make the Session immutable
  add Session::maybe()
  make Session constructor private
  use mixed type instead of annotation
  update dependencies
  change email
  test against php 8.2
  use ramsey/composer-install
  use CS 2
  require php 8.1

Author: Baptouuuu

.github/workflows/ci.yml

@@ -8,7 +8,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macOS-latest]
-        php-version: ['7.4', '8.0']
+        php-version: ['8.1', '8.2']
     name: 'PHPUnit'
     steps:
       - name: Checkout
@@ -20,17 +20,8 @@ jobs:
           extensions: mbstring, intl
           coverage: xdebug
           ini-values: xdebug.max_nesting_level=2048
-      - name: Get Composer Cache Directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache dependencies
-        uses: actions/cache@v2
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
-          restore-keys: ${{ runner.os }}-composer-
-      - name: Install Dependencies
-        run: composer install --no-progress
+      - name: Composer
+        uses: "ramsey/composer-install@v2"
       - name: PHPUnit
         run: vendor/bin/phpunit --coverage-clover=coverage.clover
       - uses: codecov/codecov-action@v1
@@ -40,7 +31,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php-version: ['7.4', '8.0']
+        php-version: ['8.1', '8.2']
     name: 'Psalm'
     steps:
       - name: Checkout
@@ -50,24 +41,15 @@ jobs:
         with:
           php-version: ${{ matrix.php-version }}
           extensions: mbstring, intl
-      - name: Get Composer Cache Directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache dependencies
-        uses: actions/cache@v2
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
-          restore-keys: ${{ runner.os }}-composer-
-      - name: Install Dependencies
-        run: composer install --no-progress
+      - name: Composer
+        uses: "ramsey/composer-install@v2"
       - name: Psalm
         run: vendor/bin/psalm --shepherd
   cs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php-version: ['7.4']
+        php-version: ['8.1']
     name: 'CS'
     steps:
       - name: Checkout
@@ -77,16 +59,7 @@ jobs:
         with:
           php-version: ${{ matrix.php-version }}
           extensions: mbstring, intl
-      - name: Get Composer Cache Directory
-        id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-      - name: Cache dependencies
-        uses: actions/cache@v2
-        with:
-          path: ${{ steps.composer-cache.outputs.dir }}
-          key: ${{ runner.os }}-${{ matrix.php-version }}-composer-${{ hashFiles('**/composer.json') }}
-          restore-keys: ${{ runner.os }}-${{ matrix.php-version }}-composer-
-      - name: Install Dependencies
-        run: composer install --no-progress
+      - name: Composer
+        uses: "ramsey/composer-install@v2"
       - name: CS
-        run: vendor/bin/php-cs-fixer fix --diff --dry-run --diff-format udiff
+        run: vendor/bin/php-cs-fixer fix --diff --dry-run

.php_cs.dist .php-cs-fixer.dist.php.php_cs.dist renamed to .php-cs-fixer.dist.php

@@ -0,0 +1,28 @@
+# Changelog
+
+## 3.0.0 - 2023-01-14
+
+### Added
+
+- `Innmind\HttpSession\Session::maybe()`
+
+### Changed
+
+- `Innmind\HttpSession\Manager\Native` constructor is now private, use `::of()` named constructor instead
+- `Innmind\HttpSession\Session` is now immutable
+- `Innmind\HttpSession\Session\Id` is now immutable
+- `Innmind\HttpSession\Session\Name` is now immutable
+- `Innmind\HttpSession\Sesssion::set()` has been renamed to `::with()`
+- `Innmind\HttpSession\Manager::start()` now returns `Innmind\Immutable\Maybe<Innmind\HttpSession\Session>` instead of throwing
+- `Innmind\HttpSession\Manager::save()`
+    - now expects the `Session` instead of the `Innmind\Http\Message\ServerRequest`
+    - now returns `Innmind\Immutable\Maybe<Innmind\Immutable\SideEffect>` instead of throwing
+- `Innmind\HttpSession\Manager::close()`
+    - now expects the `Session` instead of the `Innmind\Http\Message\ServerRequest`
+    - now returns `Innmind\Immutable\Maybe<Innmind\Immutable\SideEffect>` instead of throwing
+- Require php 8.1
+
+### Removed
+
+- `Innmind\HttpSession\Manager::get()`
+- `Innmind\HttpSession\Manager::contains()`

CHANGELOG.md

@@ -6,7 +6,7 @@
 
 Library to manage session for http requests.
 
-The goal is to break the paradigm of considering the request and response as a global environment. Request and response should be delt as transiting data. The session for a request should obey this principle as well, thus the signature `Manager::start(ServerRequest): Session`.
+The goal is to break the paradigm of considering the request and response as a global environment. Request and response should be delt as transiting data. The session for a request should obey this principle as well, thus the signature `Manager::start(ServerRequest): Maybe<Session>`.
 
 ## Installation
 
@@ -20,6 +20,7 @@ composer require innmind/http-session
 use Innmind\HttpSession\Manager\Native;
 use Innmind\Http\{
     Message\Response\Response,
+    Message\ServerRequest,
     Message\StatusCode,
     Headers,
     Header\SetCookie,
@@ -28,16 +29,18 @@ use Innmind\Http\{
     Header\Parameter\Parameter,
 };
 
-$manager = new Native;
-$request = /* an instance of Innmind\Http\Message\ServerRequest */
+$manager = Native::of();
+$request = /* an instance of ServerRequest */
 
-$session = $manager->start($request);
+$session = $manager->start($request)->match(
+    static fn($session) => $session,
+    static fn() => throw new \RuntimeException('Unable to start the exception'),
+);
 // inject some data in the session
-$manager->save($request);
+$manager->save($session);
 
 $response = new Response(
-    $code = StatusCode::of('OK'),
-    $code->associatedReasonPhrase(),
+    $code = StatusCode::ok,
     $request->protocolVersion(),
     Headers::of(
         SetCookie::of(

README.md

@@ -8,16 +8,16 @@
     "authors": [
         {
             "name": "Baptiste Langlade",
-            "email": "langlade.baptiste@gmail.com"
+            "email": "baptiste.langlade@hey.com"
         }
     ],
     "support": {
         "issues": "http://github.com/Innmind/HttpSession/issues"
     },
     "require": {
-        "php": "~7.4|~8.0",
-        "innmind/immutable": "~3.5",
-        "innmind/http": "~4.2"
+        "php": "~8.1",
+        "innmind/immutable": "~4.9",
+        "innmind/http": "~5.3"
     },
     "autoload": {
         "psr-4": {
@@ -33,6 +33,6 @@
     "require-dev": {
         "phpunit/phpunit": "~9.0",
         "vimeo/psalm": "~4.4",
-        "innmind/coding-standard": "^1.1"
+        "innmind/coding-standard": "~2.0"
     }
 }