♻️ Refactor to injectable architecture with tests & CI

Restructure the library to match the wp-cache-helper/freemius-plugin-licensing
template: split the monolithic Async/Task classes into injectable collaborators
(StoreInterface, OptionStore, Batch, ServerLimits, ProcessLock, QueueException),
add a Brain\Monkey test suite, phpcs/phpunit config, and GitHub workflows.

- PHP 7.4+ typed properties/signatures (was 5.6)
- Swappable storage driver + server-load guard + process lock via constructor
- Fix latent stdClass fatal and null-row deref in get_batch()
- Public API and filters unchanged; bump to 2.0.0
- Rewrite README, replace misnamed gitignore

Author: Joel-James

.github/workflows/phpcs.yml

@@ -0,0 +1,39 @@
+name: PHPCS
+
+on:
+  push:
+    branches: [main,dev]
+  pull_request:
+
+jobs:
+  phpcs:
+    name: WPCS lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.1'
+          coverage: none
+          tools: composer:v2, cs2pr
+
+      - name: Get Composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
+
+      - name: Cache Composer dependencies
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          key: ${{ runner.os }}-composer-phpcs-${{ hashFiles('**/composer.json') }}
+          restore-keys: |
+            ${{ runner.os }}-composer-phpcs-
+
+      - name: Install dependencies
+        run: composer update --no-interaction --no-progress --prefer-dist
+
+      - name: Run PHPCS
+        run: vendor/bin/phpcs -q --report=checkstyle | cs2pr

.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Generate release notes
+        id: notes
+        run: |
+          previous_tag=$(git describe --tags --abbrev=0 "${GITHUB_REF_NAME}^" 2>/dev/null || true)
+          {
+            echo "notes<<EOF"
+            if [ -n "$previous_tag" ]; then
+              echo "## Changes since ${previous_tag}"
+              echo
+              git log --pretty=format:'- %s (%h)' "${previous_tag}..${GITHUB_REF_NAME}"
+            else
+              echo "## Changes"
+              echo
+              git log --pretty=format:'- %s (%h)' "${GITHUB_REF_NAME}"
+            fi
+            echo
+            echo EOF
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Create release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ github.ref_name }}
+          body: ${{ steps.notes.outputs.notes }}
+          draft: false
+          prerelease: ${{ contains(github.ref_name, '-') }}

.github/workflows/tests.yml

@@ -0,0 +1,43 @@
+name: Tests
+
+on:
+  push:
+    branches: [main,dev]
+  pull_request:
+
+jobs:
+  phpunit:
+    name: PHPUnit (PHP ${{ matrix.php }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        php: ['7.4', '8.0', '8.1', '8.2', '8.3']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: none
+          tools: composer:v2
+
+      - name: Get Composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
+
+      - name: Cache Composer dependencies
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          key: ${{ runner.os }}-composer-${{ matrix.php }}-${{ hashFiles('**/composer.json') }}
+          restore-keys: |
+            ${{ runner.os }}-composer-${{ matrix.php }}-
+
+      - name: Install dependencies
+        run: composer update --no-interaction --no-progress --prefer-dist
+
+      - name: Run PHPUnit
+        run: vendor/bin/phpunit --no-coverage

.gitignore

@@ -0,0 +1,33 @@
+.DS_Store
+node_modules
+vendor
+.phpunit.result.cache
+.phpcs-cache
+phpcs.xml
+phpunit.xml
+
+# Generated
+/tests/.tmp
+
+# local env files
+.env.local
+.env.*.local
+
+# Log files
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Editor directories and files
+.idea
+.vscode
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Unwanted config files
+package-lock.json
+composer.lock