Add PassAudit package.

Author: Abdalrhman Emad Saad

.gitignore

@@ -0,0 +1,23 @@
+/vendor/
+node_modules/
+npm-debug.log
+yarn-error.log
+
+# Laravel 4 specific
+bootstrap/compiled.php
+app/storage/
+
+# Laravel 5 & Lumen specific
+public/storage
+public/hot
+
+# Laravel 5 & Lumen specific with changed public path
+public_html/storage
+public_html/hot
+
+storage/*.key
+.env
+Homestead.yaml
+Homestead.json
+/.vagrant
+.phpunit.result.cache

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Abdalrhman Emad Saad
+
+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.

README.md

@@ -0,0 +1,133 @@
+# PassAudit
+
+<p align="center">
+  <a href="https://github.com/kettasoft/PassAudit/releases">
+    <img src="https://img.shields.io/github/release/kettasoft/PassAudit.svg?style=flat-square" alt="Latest Version">
+  </a>
+  <a href="https://travis-ci.org/kettasoft/PassAudit">
+    <img src="https://img.shields.io/travis/kettasoft/PassAudit/master.svg?style=flat-square" alt="Build Status">
+  </a>
+  <a href="https://packagist.org/packages/kettasoft/PassAudit">
+    <img src="https://img.shields.io/packagist/dt/kettasoft/PassAudit.svg?style=flat-square" alt="Total Downloads">
+  </a>
+</p>
+
+PassAudit is a powerful and efficient Laravel package designed to enhance the security of user passwords in your application. This package provides a comprehensive solution to prevent users from reusing their previous passwords, thereby mitigating the risk of unauthorized access.
+
+## Installation
+
+You can install the package via Composer:
+
+```bash
+composer require kettasoft/PassAudit
+```
+
+## Configuration
+
+<!-- ### Steps to Configure -->
+
+1. **Register Service Provider**
+
+- Add the service provider to the config/app.php file in the providers array:
+
+```php
+'providers' => [
+    Kettasoft\PassAudit\PassAuditServiceProvider::class,
+    ...
+],
+```
+
+**Publish Configuration**
+
+- Publish the package configuration file:
+
+```dash
+php artisan vendor:publish --provider="Kettasoft\PassAudit\PassAuditServiceProvider" --tag="config"
+```
+
+- This will create a passaudit.php file in your config directory where you can customize the settings.
+
+**Publish Migration**
+
+- Publish the migration file:
+
+```dash
+php artisan vendor:publish --provider="Kettasoft\PassAudit\PassAuditServiceProvider" --tag="migrations"
+```
+
+Then, run the migration:
+
+```dash
+php artisan migrate
+```
+
+## Usage
+
+**Use Trait in User Model**
+
+Add the `PassAudit` trait to your `User` model:
+
+```php
+namespace App\Models;
+
+use Illuminate\Foundation\Auth\User as Authenticatable;
+use Kettasoft\PassAudit\PassAudit;
+
+class User extends Authenticatable
+{
+    use PassAudit;
+
+    //...
+}
+```
+
+**Implement Interface to User Model**
+
+- Ensure your `User` model implements the `HasPassAuditChecker`:
+
+```php
+namespace App\Models;
+
+use Kettasoft\PassAudit\Contracts\HasPassAuditChecker;
+
+class User extends Authenticatable implements HasPassAuditChecker
+{
+    //
+}
+```
+
+**Use Rule Validation in Request**
+
+- You can use the `PassAuditRule` in your request validation to prevent users from reusing their previous passwords:
+
+```php
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Kettasoft\PassAudit\Rules\PassAuditRule;
+
+class UpdatePasswordRequest extends FormRequest
+{
+    public function rules()
+    {
+        return [
+            'password' => ['required', 'string', 'min:8', new PassAuditRule($this->user())],
+        ];
+    }
+}
+```
+
+### Customization
+
+You can customize the behavior of the package by modifying the `passaudit.php` configuration file. Options include:
+
+- The number of previous passwords to keep track of
+- The hashing algorithm to use
+
+### Contributing
+
+Thank you for considering contributing to PassAudit! Please read the contributing guide before making a pull request.
+
+### License
+
+PassAudit is open-sourced software licensed under the MIT license.

composer.json

@@ -0,0 +1,40 @@
+{
+  "name": "kettasoft/pass-audit",
+  "description": "PassAudit is a powerful and efficient Laravel package designed to enhance the security of user passwords in your application. This package provides a comprehensive solution to prevent users from reusing their previous passwords, thereby mitigating the risk of unauthorized access.",
+  "type": "library",
+  "license": "MIT",
+  "autoload": {
+    "psr-4": {
+      "Kettasoft\\PassAudit\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Kettasoft\\PassAudit\\Tests\\": "tests/",
+      "Kettasoft\\PassAudit\\Tests\\Database\\Factories\\": "tests/database/factories/"
+    }
+  },
+  "authors": [
+    {
+      "name": "Abdalrhman Emad Saad",
+      "email": "kettasoft@gmail.com"
+    }
+  ],
+  "minimum-stability": "dev",
+  "require-dev": {
+    "laravel/framework": "^10",
+    "pestphp/pest": "2.x-dev",
+    "orchestra/testbench": "^8.0",
+    "mockery/mockery": "1.6.x-dev"
+  },
+  "scripts": {
+    "test": [
+      "vendor/bin/pest --configuration=phpunit.xml"
+    ]
+  },
+  "config": {
+    "allow-plugins": {
+      "pestphp/pest-plugin": true
+    }
+  }
+}