chore: bump version to 2.1.2

fix: add PHPStan/Larastan support to CartFacade

.github/dependabot.yml

@@ -1,17 +1,33 @@
 version: 2
-
 updates:
   - package-ecosystem: "github-actions"
     directory: "/"
-    target-branch: "master"
     schedule:
       interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 10
+    groups:
+      actions:
+        patterns: ["*"]
+    commit-message:
+      prefix: "chore"
+      include: "scope"
     labels:
-      - "deps"
+      - "dependencies"
+
   - package-ecosystem: "composer"
     directory: "/"
-    target-branch: "master"
     schedule:
       interval: "weekly"
+      day: "tuesday"
+    open-pull-requests-limit: 10
+    groups:
+      php-minor-patch:
+        update-types:
+          - "minor"
+          - "patch"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
     labels:
-      - "deps"
+      - "dependencies"

.github/workflows/dependabot-auto-merge.yml

@@ -13,7 +13,7 @@ jobs:
 
       - name: Dependabot metadata
         id: metadata
-        uses: dependabot/fetch-metadata@v2.2.0
+        uses: dependabot/fetch-metadata@25dd0e34f4fe68f24cc83900b1fe3fe149efef98 # v3.1.0
         with:
           github-token: "${{ secrets.GITHUB_TOKEN }}"
 

.github/workflows/tests.yml

@@ -9,19 +9,19 @@ on:
 jobs:
   tests:
     name: Tests
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
     strategy:
       fail-fast: true
       matrix:
-        php: ['8.2', '8.3', '8.4']
+        php: ["8.3", "8.4", "8.5"]
         stability: [prefer-stable]
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Setup PHP
-        uses: shivammathur/setup-php@v2
+        uses: shivammathur/setup-php@7c071dfe9dc99bdf297fa79cb49ea005b9fcadbc # v2
         with:
           php-version: ${{ matrix.php }}
           extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite, gd, redis, memcached
@@ -29,12 +29,11 @@ jobs:
           coverage: none
 
       - name: Install dependencies
-        uses: nick-fields/retry@v3
+        uses: nick-fields/retry@ad984534de44a9489a53aefd81eb77f87c70dc60 # v4.0.0
         with:
           timeout_minutes: 5
           max_attempts: 5
           command: composer update --${{ matrix.stability }} --prefer-dist --no-interaction --no-progress ${{ matrix.flags }}
 
-
       - name: Execute tests
         run: vendor/bin/pest

.gitignore

@@ -4,3 +4,4 @@
 .phpunit.result.cache
 READMETODO.md
 build
+docs/superpowers/

README.md

@@ -1,19 +1,20 @@
 <a name="top"></a>
 [![Laravel Cart](./docs/laravel-cart.png)](https://joelmale.com)
-[![Latest Version on Packagist](https://img.shields.io/packagist/v/joelwmale/laravel-cart.svg?style=flat-square)](https://packagist.org/packages/joelwmale/laravel-cart)
+[![Latest Version on Packagist](https://img.shields.io/packagist/v/wearepixel/laravel-cart.svg?style=flat-square)](https://packagist.org/packages/wearepixel/laravel-cart)
-[![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/joelwmale/laravel-cart/tests.yml?branch=master&label=Tests)](https://github.com/joelwmale/laravel-cart/actions?query=workflow%3ATests+branch%3Amaster)
+[![GitHub Tests Action Status](https://img.shields.io/github/actions/workflow/status/wearepixel/laravel-cart/tests.yml?branch=master&label=Tests)](https://github.com/wearepixel/laravel-cart/actions?query=workflow%3ATests+branch%3Amaster)
-[![Total Downloads](https://img.shields.io/packagist/dt/joelwmale/laravel-cart.svg?style=flat-square)](https://packagist.org/packages/joelwmale/laravel-cart)
+[![Total Downloads](https://img.shields.io/packagist/dt/wearepixel/laravel-cart.svg?style=flat-square)](https://packagist.org/packages/wearepixel/laravel-cart)
-[![GitHub last commit](https://img.shields.io/github/last-commit/joelwmale/laravel-cart)](#)
+[![GitHub last commit](https://img.shields.io/github/last-commit/wearepixel/laravel-cart)](#)
-[![License](https://poser.pugx.org/joelwmale/laravel-cart/license.svg)](https://packagist.org/packages/joelwmale/laravel-cart)
+[![License](https://poser.pugx.org/wearepixel/laravel-cart/license.svg)](https://packagist.org/packages/wearepixel/laravel-cart)
 [![Free](https://img.shields.io/badge/free_for_non_commercial_use-brightgreen)](#-license)
 
 A Cart Implementation for Laravel.
 
-Supported Laravel Versions: 10, 11, and 12.
+Supported Laravel Versions: 10, 11, 12, and 13.
 
-For Laravel 9.0 and below, please use version [1.0](https://github.com/joelwmale/laravel-cart/releases/tag/1.0.12)
+For Laravel 9.0 and below, please use version [1.0](https://github.com/wearepixel/laravel-cart/releases/tag/1.0.12)
 
 ## Table of Contents
+
 - [Getting Started](#-getting-started)
 - [Demo](#-deni)
 - [Documentation](#-documentation)
@@ -27,11 +28,12 @@ ## Table of Contents
 - [License](#-license)
 
 ## 🚀 Getting Started
+
 ### 🔥 Installing
 
 Install the package through [Composer](http://getcomposer.org/).
 
-`composer require joelwmale/laravel-cart`
+`composer require wearepixel/laravel-cart`
 
 ## 🧑‍🍳 Demo
 
@@ -71,7 +73,7 @@ ### ⚙️ Configuration
 You can publish the configuration file to customize various options.
 
 ```php
-php artisan vendor:publish --provider="Joelwmale\Cart\CartServiceProvider" --tag="config"
+php artisan vendor:publish --provider="Wearepixel\Cart\CartServiceProvider" --tag="config"
 ```
 
 #### Formatting Numbers
@@ -107,24 +109,19 @@ #### Round Mode
 'round_mode' => env('LARAVEL_CART_ROUND_MODE', 'down'),
 ```
 
-
 ### Basic Usage
 
-The cart has a default sessionKey that holds the cart data and stores it in the session. 
+The cart has a default sessionKey that holds the cart data and stores it in the session, so you can have multiple carts for multiple users.
 
-This
+This also serves as a cart unique identifier which you can use to bind a cart to a specific user if you want to.
-also serves as a cart unique identifier which you can use to bind a cart to a specific user if you want to.
 
-Make sure to call `\Cart::session($sessionKey)` before calling any other cart methods.
+Make sure to call `\Cart::setSessionKey($sessionKey)` before calling any other cart methods.
 
 Usually this is not required.
 
 ```php
 // Binds the cart to a unique id (user id, session id, etc.)
-\Cart::session(User::first()->id);
+\Cart::setSessionKey(User::first()->id);
-
-// If you don't want to bind the cart on a project level, you can add it to each call
-\Cart::session(User::first()->id)->add(1, 'Product 1', 19.99, 2, ['size' => 'large']);
 ```
 
 #### Adding to the cart: **Cart::add()**
@@ -332,7 +329,7 @@ ##### Adding a condition to the cart: **Cart::condition()**
 
 ```php
 // Add a single condition to the cart
-$condition = new \Joelwmale\Cart\CartCondition([
+$condition = new \Wearepixel\Cart\CartCondition([
     'name' => 'Tax: 10%',
     'type' => 'tax',
     'target' => 'subtotal', // this condition will be applied to cart's subtotal when getSubTotal() is called.
@@ -345,7 +342,7 @@ ##### Adding a condition to the cart: **Cart::condition()**
 Cart::condition($condition);
 
 // Add multiple conditions
-$tax = new \Joelwmale\Cart\CartCondition([
+$tax = new \Wearepixel\Cart\CartCondition([
     'name' => 'Tax: 10%',
     'type' => 'tax',
     'target' => 'subtotal', // this condition will be applied to cart's subtotal when getSubTotal() is called.
@@ -353,7 +350,7 @@ ##### Adding a condition to the cart: **Cart::condition()**
     'order' => 2
 ]);
 
-$shipping = new \Joelwmale\Cart\CartCondition([
+$shipping = new \Wearepixel\Cart\CartCondition([
     'name' => 'Shipping: $15',
     'type' => 'shipping',
     'target' => 'subtotal', // this condition will be applied to cart's subtotal when getSubTotal() is called.
@@ -368,7 +365,7 @@ ##### Adding a condition to the cart: **Cart::condition()**
 Cart::condition([$tax, $shipping]);
 
 // add condition to only apply on totals, not in subtotal
-$shipping = new \Joelwmale\Cart\CartCondition([
+$shipping = new \Wearepixel\Cart\CartCondition([
     'name' => 'Express Shipping $15',
     'type' => 'shipping',
     'target' => 'total',
@@ -560,7 +557,7 @@ #### Conditions on items
 ```php
 
 // lets create first our condition instance
-$saleCondition = new \Joelwmale\Cart\CartCondition([
+$saleCondition = new \Wearepixel\Cart\CartCondition([
     'name' => '50% Off',
     'type' => 'tax',
     'value' => '-50%',
@@ -580,7 +577,7 @@ #### Conditions on items
 Cart::add($product);
 
 // You can of course also do multiple conditions on an item
-$saleCondition = new \Joelwmale\Cart\CartCondition([
+$saleCondition = new \Wearepixel\Cart\CartCondition([
     'name' => 'SALE 5%',
     'type' => 'sale',
     'value' => '-5%',

SECURITY.md

@@ -0,0 +1,11 @@
+# Security Policy
+
+**PLEASE DON'T DISCLOSE SECURITY-RELATED ISSUES PUBLICLY, [SEE BELOW](#reporting-a-vulnerability).**
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it privately using the below channel:
+
+**GitHub Private Vulnerability Reporting** — go to the repository's **Security** tab and click **"Report a vulnerability"**. This creates a private advisory visible only to maintainers and provides a structured workflow for triage, fix coordination, and CVE assignment.
+
+All security vulnerabilities will be promptly addressed.

composer.json

@@ -1,6 +1,6 @@
 {
-  "name": "joelwmale/laravel-cart",
+  "name": "wearepixel/laravel-cart",
-  "version": "1.2.0",
+  "version": "2.1.2",
   "description": "A cart implementation for Laravel",
   "keywords": [
     "laravel",
@@ -19,22 +19,22 @@
     }
   ],
   "require": {
-    "php": ">=8.2",
+    "php": ">=8.3",
-    "illuminate/support": "^10.0|^11.0|^12.0",
+    "illuminate/support": "^11.0|^12.0|^13.0",
-    "illuminate/auth": "^10.0|^11.0|^12.0",
+    "illuminate/auth": "^11.0|^12.0|^13.0",
-    "illuminate/container": "^10.0|^11.0|^12.0",
+    "illuminate/container": "^11.0|^12.0|^13.0",
-    "illuminate/database": "^10.0|^11.0|^12.0",
+    "illuminate/database": "^11.0|^12.0|^13.0",
-    "illuminate/validation": "^10.0|^11.0|^12.0"
+    "illuminate/validation": "^11.0|^12.0|^13.0"
   },
   "require-dev": {
-    "mockery/mockery": "^1.6",
+    "mockery/mockery": "^2.0",
     "laravel/pint": "^1.21",
-    "pestphp/pest": "^3.0",
+    "pestphp/pest": "^4.7",
     "larapack/dd": "dev-master"
   },
   "autoload": {
     "psr-4": {
-      "Joelwmale\\Cart\\": "src/"
+      "Wearepixel\\Cart\\": "src/"
     }
   },
   "autoload-dev": {
@@ -46,10 +46,10 @@
   "extra": {
     "laravel": {
       "providers": [
-        "Joelwmale\\Cart\\CartServiceProvider"
+        "Wearepixel\\Cart\\CartServiceProvider"
       ],
       "aliases": {
-        "Cart": "Joelwmale\\Cart\\Facades\\CartFacade"
+        "Cart": "Wearepixel\\Cart\\Facades\\CartFacade"
       }
     }
   },

phpunit.xml.dist

@@ -1,10 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" bootstrap="tests/bootstrap.php" colors="true" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.5/phpunit.xsd">
-         bootstrap="vendor/autoload.php"
+  <source ignoreIndirectDeprecations="true">
-         colors="true"
-         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.4/phpunit.xsd"
->
-<source>
     <include>
       <directory suffix=".php">./src</directory>
     </include>

src/Cart.php

@@ -1,12 +1,12 @@
 <?php
 
-namespace Joelwmale\Cart;
+namespace Wearepixel\Cart;
 
-use Joelwmale\Cart\Helpers\Helpers;
+use Wearepixel\Cart\Helpers\Helpers;
-use Joelwmale\Cart\Validators\CartItemValidator;
+use Wearepixel\Cart\Validators\CartItemValidator;
-use Joelwmale\Cart\Exceptions\InvalidItemException;
+use Wearepixel\Cart\Exceptions\InvalidItemException;
-use Joelwmale\Cart\Exceptions\UnknownModelException;
+use Wearepixel\Cart\Exceptions\UnknownModelException;
-use Joelwmale\Cart\Exceptions\InvalidConditionException;
+use Wearepixel\Cart\Exceptions\InvalidConditionException;
 
 class Cart
 {
@@ -56,6 +56,16 @@ private function validateConfig($config)
         }
     }
 
+    public function getSessionKey(): string
+    {
+        return $this->session->getSessionKey();
+    }
+
+    public function setSessionKey(string $sessionKey): void
+    {
+        $this->session->setSessionKey($sessionKey);
+    }
+
     /**
      * get instance name of the cart
      *
@@ -155,9 +165,31 @@ public function add(
 
         $this->currentItemId = $id;
 
+        // clean up any incomplete items
+        $this->removeInvalidItems();
+
         return $this;
     }
 
+    /**
+     * Remove any incomplete items
+     */
+    public function removeInvalidItems(): bool
+    {
+        $carts = $this->getContent();
+
+        foreach ($carts as $index => $cart) {
+
+            if (! (isset($cart['id'], $cart['name'], $cart['quantity']))) {
+
+                // remove item
+                $this->remove($index);
+            }
+        }
+
+        return true;
+    }
+
     /**
      * Update a cart item with whatever data is passed in
      */
@@ -222,11 +254,11 @@ public function setConfig($config)
     public function addItemCondition($productId, $itemCondition)
     {
         if ($product = $this->get($productId)) {
-            $conditionInstance = '\\Joelwmale\\Cart\\CartCondition';
+            $conditionInstance = '\\Wearepixel\\Cart\\CartCondition';
 
             if ($itemCondition instanceof $conditionInstance) {
                 // we need to copy first to a temporary variable to hold the conditions
-                // to avoid hitting this error "Indirect modification of overloaded element of Joelwmale\Cart\ItemCollection has no effect"
+                // to avoid hitting this error "Indirect modification of overloaded element of Wearepixel\Cart\ItemCollection has no effect"
                 // this is due to laravel Collection instance that implements Array Access
                 // // see link for more info: http://stackoverflow.com/questions/20053269/indirect-modification-of-overloaded-element-of-splfixedarray-has-no-effect
                 $itemConditionTempHolder = $product['conditions'];
@@ -313,7 +345,7 @@ public function condition(array|CartCondition $condition): self
         }
 
         if (! $condition instanceof CartCondition) {
-            throw new InvalidConditionException('Argument 1 must be an instance of \'Joelwmale\Cart\CartCondition\'');
+            throw new InvalidConditionException('Argument 1 must be an instance of \'Wearepixel\Cart\CartCondition\'');
         }
 
         $conditions = $this->getConditions();
@@ -455,7 +487,7 @@ public function removeItemCondition($itemId, $conditionName)
             // on the given condition name the user wants to remove, if so,
             // lets just make $item['conditions'] an empty array as there's just 1 condition on it anyway
             else {
-                $conditionInstance = 'Joelwmale\\Cart\\CartCondition';
+                $conditionInstance = 'Wearepixel\\Cart\\CartCondition';
 
                 if ($item['conditions'] instanceof $conditionInstance) {
                     if ($tempConditionsHolder->getName() == $conditionName) {
@@ -756,7 +788,7 @@ protected function itemHasConditions($item)
             return count($item['conditions']) > 0;
         }
 
-        $conditionInstance = 'Joelwmale\\Cart\\CartCondition';
+        $conditionInstance = 'Wearepixel\\Cart\\CartCondition';
 
         if ($item['conditions'] instanceof $conditionInstance) {
             return true;

src/CartCollection.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart;
+namespace Wearepixel\Cart;
 
 use Illuminate\Support\Collection;
 

src/CartCondition.php

@@ -1,10 +1,10 @@
 <?php
 
-namespace Joelwmale\Cart;
+namespace Wearepixel\Cart;
 
-use Joelwmale\Cart\Helpers\Helpers;
+use Wearepixel\Cart\Helpers\Helpers;
-use Joelwmale\Cart\Validators\CartConditionValidator;
+use Wearepixel\Cart\Validators\CartConditionValidator;
-use Joelwmale\Cart\Exceptions\InvalidConditionException;
+use Wearepixel\Cart\Exceptions\InvalidConditionException;
 
 class CartCondition
 {

src/CartConditionCollection.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart;
+namespace Wearepixel\Cart;
 
 use Illuminate\Support\Collection;
 

src/CartServiceProvider.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart;
+namespace Wearepixel\Cart;
 
 use Illuminate\Support\ServiceProvider;
 

src/CartSession.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart;
+namespace Wearepixel\Cart;
 
 class CartSession
 {
@@ -43,10 +43,38 @@ public function isInternalSession($session)
     {
         return in_array(is_object($session) ? get_class($session) : $session, [
             'Illuminate\Session\SessionManager',
-            'Joelwmale\Cart\Tests\Helpers\SessionMock',
+            'Wearepixel\Cart\Tests\Helpers\SessionMock',
         ]);
     }
 
+    public function getSessionKey()
+    {
+        return $this->sessionKey;
+    }
+
+    public function setSessionKey(string $sessionKey)
+    {
+        // set the session key and then update the session
+        $this->sessionKey = $sessionKey;
+
+        if ($this->driver == 'session') {
+            $session = $this->session->get($this->itemsKey);
+            $sessionKey = $this->session->get($this->conditionsKey);
+
+            $this->session->forget($this->itemsKey);
+            $this->session->forget($this->conditionsKey);
+
+            $this->itemsKey = $this->sessionKey . '_cart_items';
+            $this->conditionsKey = $this->sessionKey . '_cart_conditions';
+
+            $this->session->put($this->itemsKey, $session);
+            $this->session->put($this->conditionsKey, $sessionKey);
+        } elseif ($this->driver == 'database') {
+            $this->session[$this->sessionId] = $sessionKey;
+            $this->session->save();
+        }
+    }
+
     public function has($key)
     {
         return $this->session->has($key) ?? $this->session;

src/Exceptions/InvalidConditionException.php

@@ -1,5 +1,5 @@
 <?php
 
-namespace Joelwmale\Cart\Exceptions;
+namespace Wearepixel\Cart\Exceptions;
 
 class InvalidConditionException extends \Exception {}

src/Exceptions/InvalidItemException.php

@@ -1,5 +1,5 @@
 <?php
 
-namespace Joelwmale\Cart\Exceptions;
+namespace Wearepixel\Cart\Exceptions;
 
 class InvalidItemException extends \Exception {}

src/Exceptions/UnknownModelException.php

@@ -1,5 +1,5 @@
 <?php
 
-namespace Joelwmale\Cart\Exceptions;
+namespace Wearepixel\Cart\Exceptions;
 
 class UnknownModelException extends \Exception {}

src/Facades/CartFacade.php

@@ -1,12 +1,42 @@
 <?php
 
-namespace Joelwmale\Cart\Facades;
+namespace Wearepixel\Cart\Facades;
 
 use Illuminate\Support\Facades\Facade;
+use Wearepixel\Cart\Cart;
+use Wearepixel\Cart\CartCollection;
+use Wearepixel\Cart\CartCondition;
+use Wearepixel\Cart\CartConditionCollection;
+use Wearepixel\Cart\ItemCollection;
 
+/**
+ * @mixin Cart
+ *
+ * @method static ItemCollection|null get(int|string $itemId)
+ * @method static bool has(int|string $itemId)
+ * @method static void add(int|string $id, string $name, int|float $price, int $quantity, array $attributes = [], CartCondition|array $conditions = [], string $associatedModel = '')
+ * @method static bool update(int|string $id, array $data)
+ * @method static void remove(int|string $id)
+ * @method static void clear()
+ * @method static void clearItems()
+ * @method static Cart condition(array|CartCondition $condition)
+ * @method static CartConditionCollection|array getConditions(bool $array = false, bool $active = false)
+ * @method static CartCondition|null getCondition(string $conditionName)
+ * @method static CartConditionCollection getConditionsByType(string $type)
+ * @method static void removeConditionsByType(string $type)
+ * @method static void removeCartCondition(string $conditionName)
+ * @method static void clearItemConditions(int|string $itemId)
+ * @method static void clearAllConditions()
+ * @method static CartCollection getContent()
+ * @method static bool isEmpty()
+ * @method static int getTotalQuantity()
+ * @method static int|float|string getSubTotal(bool $formatted = true)
+ * @method static int|float|string getSubTotalWithoutConditions(bool $formatted = true)
+ * @method static int|float getTotal()
+ */
 class CartFacade extends Facade
 {
-    protected static function getFacadeAccessor()
+    protected static function getFacadeAccessor(): string
     {
         return 'cart';
     }

src/Helpers/Helpers.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart\Helpers;
+namespace Wearepixel\Cart\Helpers;
 
 class Helpers
 {

src/ItemAttributeCollection.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart;
+namespace Wearepixel\Cart;
 
 use Illuminate\Support\Collection;
 

src/ItemCollection.php

@@ -1,9 +1,9 @@
 <?php
 
-namespace Joelwmale\Cart;
+namespace Wearepixel\Cart;
 
 use Illuminate\Support\Collection;
-use Joelwmale\Cart\Helpers\Helpers;
+use Wearepixel\Cart\Helpers\Helpers;
 
 class ItemCollection extends Collection
 {
@@ -72,7 +72,7 @@ public function hasConditions()
         if (is_array($this['conditions'])) {
             return count($this['conditions']) > 0;
         }
-        $conditionInstance = 'Joelwmale\\Cart\\CartCondition';
+        $conditionInstance = 'Wearepixel\\Cart\\CartCondition';
         if ($this['conditions'] instanceof $conditionInstance) {
             return true;
         }

src/Validators/CartConditionValidator.php

@@ -1,5 +1,5 @@
 <?php
 
-namespace Joelwmale\Cart\Validators;
+namespace Wearepixel\Cart\Validators;
 
 class CartConditionValidator extends Validator {}

src/Validators/CartItemValidator.php

@@ -1,5 +1,5 @@
 <?php
 
-namespace Joelwmale\Cart\Validators;
+namespace Wearepixel\Cart\Validators;
 
 class CartItemValidator extends Validator {}

src/Validators/Validator.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart\Validators;
+namespace Wearepixel\Cart\Validators;
 
 use Illuminate\Validation\Factory;
 use Illuminate\Filesystem\Filesystem;

tests/Helpers/ConfigDatabaseMock.php

@@ -8,7 +8,7 @@
     'storage' => [
         'session',
         'database' => [
-            'model' => \Joelwmale\Cart\Tests\Helpers\MockCartModel::class,
+            'model' => \Wearepixel\Cart\Tests\Helpers\MockCartModel::class,
             'id' => 'session_id',
             'items' => 'items',
             'conditions' => 'conditions',

tests/Helpers/MockCartModel.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart\Tests\Helpers;
+namespace Wearepixel\Cart\Tests\Helpers;
 
 use Illuminate\Database\Eloquent\Model;
 

tests/Helpers/MockProduct.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart\Tests\Helpers;
+namespace Wearepixel\Cart\Tests\Helpers;
 
 use Illuminate\Contracts\Database\ModelIdentifier;
 

tests/Helpers/SessionMock.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Joelwmale\Cart\Tests\Helpers;
+namespace Wearepixel\Cart\Tests\Helpers;
 
 class SessionMock
 {

tests/Unit/CartConditionsTest.php

@@ -1,9 +1,9 @@
 <?php
 
-use Joelwmale\Cart\Cart;
+use Wearepixel\Cart\Cart;
-use Joelwmale\Cart\CartCondition;
+use Wearepixel\Cart\CartCondition;
-use Joelwmale\Cart\CartConditionCollection;
+use Wearepixel\Cart\CartConditionCollection;
-use Joelwmale\Cart\Tests\Helpers\SessionMock;
+use Wearepixel\Cart\Tests\Helpers\SessionMock;
 
 beforeEach(function () {
     $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');

tests/Unit/CartTest.php

@@ -1,8 +1,8 @@
 <?php
 
-use Joelwmale\Cart\Cart;
+use Wearepixel\Cart\Cart;
-use Joelwmale\Cart\Tests\Helpers\MockProduct;
+use Wearepixel\Cart\Tests\Helpers\MockProduct;
-use Joelwmale\Cart\Tests\Helpers\SessionMock;
+use Wearepixel\Cart\Tests\Helpers\SessionMock;
 
 beforeEach(function () {
     $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');
@@ -149,7 +149,7 @@
 
         $item = $this->cart->get(1);
 
-        expect($item->attributes)->toBeInstanceOf('Joelwmale\\Cart\\ItemAttributeCollection');
+        expect($item->attributes)->toBeInstanceOf('Wearepixel\\Cart\\ItemAttributeCollection');
 
         // now lets update the item with its new attributes
         // when we get that item from cart, it should still be an instance of ItemAttributeCollection
@@ -162,7 +162,7 @@
 
         $this->cart->update(1, $updatedItem);
 
-        expect($item->attributes)->toBeInstanceOf('Joelwmale\\Cart\\ItemAttributeCollection');
+        expect($item->attributes)->toBeInstanceOf('Wearepixel\\Cart\\ItemAttributeCollection');
     });
 
     test('item orders are preserved by the order they are added', function () {
@@ -298,19 +298,19 @@
     });
 
     test('should throw an exception when no quantity is provided', function () {
-        $this->expectException('Joelwmale\Cart\Exceptions\InvalidItemException');
+        $this->expectException('Wearepixel\Cart\Exceptions\InvalidItemException');
         $this->expectExceptionMessage('The quantity must be at least 0.1.');
         $this->cart->add(455, 'Sample Item', 100.99, 0, []);
     });
 
     test('should throw an exception when no id is provided', function () {
-        $this->expectException('Joelwmale\Cart\Exceptions\InvalidItemException');
+        $this->expectException('Wearepixel\Cart\Exceptions\InvalidItemException');
         $this->expectExceptionMessage('The id field is required.');
         $this->cart->add('', 'Sample Item', 100.99, 2, []);
     });
 
     test('should throw an exception when no name is provided', function () {
-        $this->expectException('Joelwmale\Cart\Exceptions\InvalidItemException');
+        $this->expectException('Wearepixel\Cart\Exceptions\InvalidItemException');
         $this->expectExceptionMessage('The name field is required.');
         $this->cart->add(523, '', 100.99, 2, []);
     });
@@ -646,7 +646,7 @@
     expect($this->cart->getContent()->count())->toEqual(1, 'Cart should have 1 item on it');
     expect($this->cart->getContent()->first()['id'])->toEqual(456, 'The first content must have ID of 456');
     expect($this->cart->getContent()->first()['name'])->toEqual('Sample Item', 'The first content must have name of "Sample Item"');
-    expect($addedItem->model)->toBeInstanceOf('Joelwmale\Cart\Tests\Helpers\MockProduct');
+    expect($addedItem->model)->toBeInstanceOf('Wearepixel\Cart\Tests\Helpers\MockProduct');
 });
 
 test('cart can add items with multidimensional array with associated model', function () {
@@ -681,7 +681,7 @@
 
     $content = $this->cart->getContent();
     foreach ($content as $item) {
-        expect($item->model)->toBeInstanceOf('Joelwmale\Cart\Tests\Helpers\MockProduct');
+        expect($item->model)->toBeInstanceOf('Wearepixel\Cart\Tests\Helpers\MockProduct');
     }
 
     expect($this->cart->isEmpty())->toBeFalse('Cart should not be empty');
@@ -689,3 +689,15 @@
     expect($this->cart->getTotalQuantity())->toBeInt('Return type should be INT');
     expect($this->cart->getTotalQuantity())->toEqual(12, 'Cart\'s quantity should be 4.');
 });
+
+test('can add to cart and then update the session key', function () {
+    $this->cart->add(1, 'Sample Item', 100.99, 2, []);
+
+    expect($this->cart->getContent()->count())->toEqual(1, 'Cart content should be 1');
+    expect($this->cart->getContent()->first()['id'])->toEqual(1, 'Item added has ID of 1 so first content ID should be 1');
+
+    $this->cart->setSessionKey('new_session_key');
+
+    expect($this->cart->getSessionKey())->toEqual('new_session_key', 'Session key should be updated to new_session_key');
+    expect($this->cart->getContent()->count())->toEqual(1, 'Cart content should still be 1');
+});

tests/Unit/CartTestEventsTest.php

@@ -1,7 +1,7 @@
 <?php
 
-use Joelwmale\Cart\Cart;
+use Wearepixel\Cart\Cart;
-use Joelwmale\Cart\Tests\Helpers\SessionMock;
+use Wearepixel\Cart\Tests\Helpers\SessionMock;
 
 beforeEach(function () {});
 
@@ -25,7 +25,7 @@
 });
 
 test('event cart adding', function () {
-    $events = Mockery::mock('Illuminate\Events\Dispatcher');
+    $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');
     $events->shouldReceive('dispatch')->once()->with('LaravelCart.Created', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->once()->with('LaravelCart.Adding', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->once()->with('LaravelCart.Added', Mockery::type('array'), true);
@@ -44,7 +44,7 @@
 });
 
 test('event cart adding multiple times', function () {
-    $events = Mockery::mock('Illuminate\Events\Dispatcher');
+    $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');
     $events->shouldReceive('dispatch')->once()->with('LaravelCart.Created', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->times(2)->with('LaravelCart.Adding', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->times(2)->with('LaravelCart.Added', Mockery::type('array'), true);
@@ -64,7 +64,7 @@
 });
 
 test('event cart adding multiple times scenario two', function () {
-    $events = Mockery::mock('Illuminate\Events\Dispatcher');
+    $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');
     $events->shouldReceive('dispatch')->once()->with('LaravelCart.Created', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->times(3)->with('LaravelCart.Adding', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->times(3)->with('LaravelCart.Added', Mockery::type('array'), true);
@@ -107,7 +107,7 @@
 });
 
 test('event cart remove item', function () {
-    $events = Mockery::mock('Illuminate\Events\Dispatcher');
+    $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');
     $events->shouldReceive('dispatch')->once()->with('LaravelCart.Created', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->times(3)->with('LaravelCart.Adding', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->times(3)->with('LaravelCart.Added', Mockery::type('array'), true);
@@ -154,7 +154,7 @@
 });
 
 test('event cart clear', function () {
-    $events = Mockery::mock('Illuminate\Events\Dispatcher');
+    $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');
     $events->shouldReceive('dispatch')->once()->with('LaravelCart.Created', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->times(3)->with('LaravelCart.Adding', Mockery::type('array'), true);
     $events->shouldReceive('dispatch')->times(3)->with('LaravelCart.Added', Mockery::type('array'), true);

tests/Unit/CartTestMultipleInstancesTest.php

@@ -1,7 +1,7 @@
 <?php
 
-use Joelwmale\Cart\Cart;
+use Wearepixel\Cart\Cart;
-use Joelwmale\Cart\Tests\Helpers\SessionMock;
+use Wearepixel\Cart\Tests\Helpers\SessionMock;
 
 beforeEach(function () {
     $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');

tests/Unit/DatabaseCartTest.php

@@ -1,8 +1,8 @@
 <?php
 
-use Joelwmale\Cart\Cart;
+use Wearepixel\Cart\Cart;
-use Joelwmale\Cart\CartCondition;
+use Wearepixel\Cart\CartCondition;
-use Joelwmale\Cart\Tests\Helpers\MockCartModel;
+use Wearepixel\Cart\Tests\Helpers\MockCartModel;
 
 beforeEach(function () {
     $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');

tests/Unit/ItemTest.php

@@ -1,9 +1,9 @@
 <?php
 
-use Joelwmale\Cart\Cart;
+use Wearepixel\Cart\Cart;
-use Joelwmale\Cart\CartCondition;
+use Wearepixel\Cart\CartCondition;
-use Joelwmale\Cart\Tests\Helpers\MockProduct;
+use Wearepixel\Cart\Tests\Helpers\MockProduct;
-use Joelwmale\Cart\Tests\Helpers\SessionMock;
+use Wearepixel\Cart\Tests\Helpers\SessionMock;
 
 beforeEach(function () {
     $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');
@@ -47,7 +47,7 @@
 });
 
 test('item get conditions with conditions', function () {
-    $itemCondition1 = new \Joelwmale\Cart\CartCondition([
+    $itemCondition1 = new \Wearepixel\Cart\CartCondition([
         'name' => 'SALE 5%',
         'type' => 'sale',
         'target' => 'item',
@@ -77,7 +77,7 @@
 });
 
 test('it will throw an exception when a non existing model is being associated', function () {
-    $this->expectException(\Joelwmale\Cart\Exceptions\UnknownModelException::class);
+    $this->expectException(\Wearepixel\Cart\Exceptions\UnknownModelException::class);
     $this->expectExceptionMessage('The supplied model SomeModel does not exist.');
 
     $this->cart->add(1, 'Test item', 1, 10.00)->associate('SomeModel');

tests/Unit/ItemTestOtherFormatTest.php

@@ -1,7 +1,7 @@
 <?php
 
-use Joelwmale\Cart\Cart;
+use Wearepixel\Cart\Cart;
-use Joelwmale\Cart\Tests\Helpers\SessionMock;
+use Wearepixel\Cart\Tests\Helpers\SessionMock;
 
 beforeEach(function () {
     $events = Mockery::mock('Illuminate\Contracts\Events\Dispatcher');

tests/bootstrap.php

@@ -0,0 +1,14 @@
+<?php
+
+require __DIR__ . '/../vendor/autoload.php';
+
+// Suppress PHP 8.4 deprecation notices that originate from vendor code.
+// These are typically from third-party packages (e.g. Mockery) that have not
+// yet updated implicit-nullable parameter signatures and are not actionable here.
+set_error_handler(static function (int $errno, string $errstr, string $errfile): bool {
+    if ($errno === E_DEPRECATED && str_contains($errfile, DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR)) {
+        return true;
+    }
+
+    return false;
+}, E_DEPRECATED);