Initial release of the isend/laravel package v1.0.0

Author: Suliman Benhalim

.github/workflows/tests.yml

@@ -0,0 +1,43 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        php: [8.0, 8.1, 8.2, 8.3]
+        laravel: [11.*, 12.*]
+        dependency-version: [prefer-stable]
+        exclude:
+          - php: 8.0
+            laravel: 12.*
+          - php: 8.1
+            laravel: 12.*
+
+    name: P${{ matrix.php }} - L${{ matrix.laravel }} - ${{ matrix.dependency-version }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: dom, curl, libxml, mbstring, zip, json
+          coverage: none
+
+      - name: Install dependencies
+        run: |
+          composer require "laravel/framework:${{ matrix.laravel }}" --no-interaction --no-update
+          composer update --${{ matrix.dependency-version }} --prefer-dist --no-interaction
+
+      - name: Execute tests
+        run: vendor/bin/phpunit

.gitignore

@@ -0,0 +1,49 @@
+# Composer
+/vendor/
+composer.lock
+
+# PHPUnit
+/.phpunit.cache
+.phpunit.result.cache
+phpunit.xml
+
+# IDE and Editor files
+/.idea/
+/.vscode/
+*.sublime-project
+*.sublime-workspace
+.DS_Store
+Thumbs.db
+
+# Laravel
+/node_modules
+/public/hot
+/public/storage
+/storage/*.key
+/storage/logs/*
+.env
+.env.backup
+.env.production
+.phpunit.result.cache
+Homestead.json
+Homestead.yaml
+auth.json
+npm-debug.log
+yarn-error.log
+
+# Misc
+.php_cs.cache
+.php_cs.dist
+.php-cs-fixer.cache
+.php-cs-fixer.dist.php
+*.log
+*.cache
+*.bak
+*.swp
+*.swo
+.phpstan.neon
+.phpstan-baseline.neon
+
+# OS specific files
+.DS_Store
+Thumbs.db

CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to the `isend/laravel` package will be documented in this file.
+
+## 1.0.0 - 2025-05-03
+
+### Added
+- Initial release of the iSend SMS Laravel package
+- Interactive CLI setup wizard via `php artisan isend:setup` command
+- Support for sending SMS messages to single or multiple recipients
+- Scheduled message delivery functionality
+- Message status tracking and delivery reporting
+- Campaign management features
+- Account management (balance checking, profile info, sender IDs, transactions)
+- Comprehensive exception handling with detailed error information
+- Laravel Facade for easy integration
+- Full support for Laravel 11.x and 12.x
+- PHP 8.0+ compatibility
+- Complete documentation with examples
+
+### Fixed
+- URL path handling to correctly separate base URL from API version path
+- Proper normalization of API paths with and without leading slashes
+
+### Security
+- Secure API token management
+- Request and response logging with sensitive data masking

CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+Thank you for considering contributing to the iSend SMS Laravel package! This document outlines the guidelines for contributing to this project.
+
+## Code of Conduct
+
+This project adheres to a standard code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to [[email protected]](mailto:[email protected]).
+
+## Pull Requests
+
+1. Fork the repository
+2. Create a branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Development Setup
+
+1. Clone your fork of the repository
+2. Install dependencies:
+   ```bash
+   composer install
+   ```
+3. Run tests to ensure everything is working:
+   ```bash
+   composer test
+   ```
+
+## Coding Standards
+
+This package follows the PSR-12 coding standard and the PSR-4 autoloading standard.
+
+You can check the code style with:
+```bash
+composer format
+```
+
+And analyze the code with:
+```bash
+composer analyse
+```
+
+## Testing
+
+The package includes a test suite that you can run with:
+```bash
+composer test
+```
+
+Please make sure your code passes all tests, and add new tests for new features.
+
+## Documentation
+
+If your changes include functionality that should be documented, please update the README.md file.
+
+## Version Control
+
+- Follow [Semantic Versioning](https://semver.org/)
+- Use descriptive commit messages
+- Reference issues and pull requests in commit messages when applicable
+
+Thank you for your contributions!

LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2025 Suliman Benhalim
+
+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.