Feature / v2 endpoint

.github/workflows/tests.yml

@@ -0,0 +1,69 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          extensions: json, curl, bcmath
+          coverage: xdebug
+
+      - name: Validate composer.json
+        run: composer validate --strict
+
+      - name: Cache Composer dependencies
+        uses: actions/cache@v4
+        with:
+          path: vendor
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+
+      - name: Run PHPUnit tests
+        run: vendor/bin/phpunit --testdox
+
+  code-quality:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          extensions: json, curl, bcmath
+
+      - name: Cache Composer dependencies
+        uses: actions/cache@v4
+        with:
+          path: vendor
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+
+      - name: Run PHPStan
+        run: vendor/bin/phpstan analyse
+
+      - name: Run PHP CodeSniffer
+        run: vendor/bin/phpcs src tests

.ralph-tui/config.toml

@@ -0,0 +1,12 @@
+# Ralph TUI Configuration
+# Generated by setup wizard
+# See: ralph-tui config help
+
+configVersion = "2.0"
+tracker = "json"
+agent = "claude"
+maxIterations = 10
+autoCommit = true
+
+[trackerOptions]
+[agentOptions]

.ralph-tui/progress.md

@@ -0,0 +1,11 @@
+# Ralph Progress Log
+
+This file tracks progress across iterations. It's automatically updated
+after each iteration and included in agent prompts for context.
+
+## Codebase Patterns (Study These First)
+
+*Add reusable patterns discovered during development here.*
+
+---
+

.ralph-tui/session-meta.json

@@ -0,0 +1,15 @@
+{
+  "id": "30036f8a-76f6-46f1-af2b-b5b264aa3420",
+  "status": "completed",
+  "startedAt": "2026-01-30T12:06:59.963Z",
+  "updatedAt": "2026-01-30T12:07:14.726Z",
+  "agentPlugin": "claude",
+  "trackerPlugin": "json",
+  "prdPath": "./tasks/prd.json",
+  "currentIteration": 0,
+  "maxIterations": 10,
+  "totalTasks": 0,
+  "tasksCompleted": 0,
+  "cwd": "/Users/tomasilginis/Desktop/projects/brad-search-php-sdk",
+  "endedAt": "2026-01-30T12:07:14.726Z"
+}

composer.json

@@ -22,8 +22,9 @@
     "ext-bcmath": "*"
   },
   "require-dev": {
-    "phpunit/phpunit": "^11.0",
+    "laravel/pint": "^1.27",
     "phpstan/phpstan": "^1.10",
+    "phpunit/phpunit": "^11.0",
     "squizlabs/php_codesniffer": "^3.7"
   },
   "autoload": {

phpcs.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0"?>
+<ruleset name="BradSearch SDK">
+    <description>Coding standard for BradSearch Sync SDK</description>
+
+    <file>src</file>
+    <file>tests</file>
+
+    <arg name="colors"/>
+    <arg value="sp"/>
+    <!-- Only report errors, not warnings -->
+    <arg name="warning-severity" value="0"/>
+
+    <!-- Use PSR-12 as base -->
+    <rule ref="PSR12"/>
+
+    <!-- Disable line length limits -->
+    <rule ref="Generic.Files.LineLength">
+        <severity>0</severity>
+    </rule>
+
+    <!-- Allow multiple classes in test files -->
+    <rule ref="PSR1.Classes.ClassDeclaration.MultipleClasses">
+        <exclude-pattern>tests/*</exclude-pattern>
+    </rule>
+
+    <!-- Allow non-standard default parameter order (PHP 8 nullable types) -->
+    <rule ref="PEAR.Functions.ValidDefaultValue.NotAtEnd">
+        <severity>0</severity>
+    </rule>
+</ruleset>

phpstan.neon

@@ -0,0 +1,10 @@
+parameters:
+    level: 4
+    paths:
+        - src
+    excludePaths:
+        - vendor
+    ignoreErrors:
+        - '#PHPDoc tag @param references unknown parameter#'
+        - '#Deprecated in PHP 8.0: Required parameter .* follows optional parameter#'
+        - '#Strict comparison using === between .* and null will always evaluate to false#'

src/Adapters/PrestaShopAdapter.php

@@ -8,11 +8,13 @@
 
 class PrestaShopAdapter
 {
-    public function __construct() {}
+    public function __construct()
+    {
+    }
 
     /**
      * Transform PrestaShop product data to BradSearch format
-     * 
+     *
      * @param array $prestaShopData The PrestaShop API response
      * @return array<array> Array of products in BradSearch format
      */
@@ -485,7 +487,7 @@ private function getRequiredField(array $data, string $field): string
 
     /**
      * Validate and convert a field value to a proper boolean or null
-     * 
+     *
      * @param mixed $value The value to validate
      * @return bool|null Returns true/false for valid boolean values, null for invalid/missing values
      */