=Cleaning up the Square integration (still a bit more to do yet). Also majo...

Jake Vanderwerf

2026-07-05 fff721dd185f5b97f7ae7a6e64189e55887ff590

 inc/integrations/Square.php

@@ -1,9 +1,18 @@
<?php
namespace JVBase\integrations;

use JVBase\meta\MetaManager;
use JVBase\meta\Form;
use JVBase\meta\Meta;
use Exception;
use JVBase\registrar\Fields;
use JVBase\registrar\Posts;
use JVBase\registrar\Registrar;
use JVBase\ui\CRUDSkeleton;
use WP_Error;
use JVBase\ui\Checkout;
use JVBase\managers\queue\TypeConfig;
use JVBase\managers\queue\executors\IntegrationExecutor;
use WP_Query;

if (!defined('ABSPATH')) {
   exit;
@@ -19,6 +28,14 @@
 */
class Square extends Integrations
{
   protected array $allowedContent = [
      'REGULAR',
      'FOOD_AND_BEV',
      'APPOINTMENTS_SERVICE',
      'DIGITAL',
      'EVENT',
      'DONATION'
   ];
   /**
    * Square API Configuration
    */
@@ -38,6 +55,9 @@
    * OAuth Configuration
    */
   protected bool $isOAuthService = true;

   protected string $orderPostType = '_square_order';
   protected array $newOrder = [];
   protected array $oauth = [
      'authorize' => '',
      'token' => '',
@@ -65,12 +85,30 @@
   protected string $locationId = '';
   protected array $locations = [];

   public function __construct(?int $userID = null)
   protected static array $instances = [];

   public static function getInstance(?int $userID = null):self
   {
      $key = is_null($userID) ? 'base' : $userID;
      if (!array_key_exists($key, self::$instances)) {
         self::$instances[$key] = new static($userID);
      }
      return self::$instances[$key];
   }

   protected function __construct(?int $userID = null)
   {
      // Display properties
      $this->title = 'Square';
      $this->icon = 'square-logo';

      $this->refresh_interval = 7 * DAY_IN_SECONDS;

      $this->newOrder = [
         'post_type'    => $this->orderPostType,
         'post_status'  => 'PROPOSED',
      ];

      // Define credential fields
      $this->fields = [
         'environment'  => [
@@ -171,6 +209,10 @@
            'sync_to_square' => 'Sync Site to Square',
         ]
      );

      add_action('init', [$this, 'registerSquarePostTypes'], 5);
      add_action('init', [$this, 'addDashboardPages'], 10);
      add_action(BASE.'dashboard_page_orders', [$this, 'renderDashPage']);
   }

   /**
@@ -207,6 +249,112 @@

   }

   public function getOrderFields():array
   {
      return [
               'post_title' => [
                  'type' => 'text',
                  'label' => 'Order Number'
               ],
               'square_order_id' => [
                  'type' => 'text',
                  'label' => 'Square Order ID',
               ],
               'square_payment_id' => [
                  'type' => 'text',
                  'label' => 'Square Payment ID',
               ],
               'square_customer_id' => [
                  'type' => 'text',
                  'label' => 'Square Customer ID',
               ],
               'amount' => [
                  'type' => 'number',
                  'label' => 'Total Amount (cents)',
               ],
               'square_payment_status' => [
                  'type' => 'select',
                  'label' => 'Order Status',
                  'options' => [
                     'PROPOSED' => 'Proposed',
                     'RESERVED' => 'Reserved',
                     'PREPARED' => 'Prepared (Ready for Pickup)',
                     'COMPLETED' => 'Completed',
                     'CANCELED' => 'Canceled'
                  ],
               ],
               'fulfillment_status' => [
                  'type' => 'select',
                  'label' => 'Fulfillment Status',
                  'options' => [
                     'PROPOSED' => 'Proposed',
                     'RESERVED' => 'Reserved',
                     'PREPARED' => 'Prepared',
                     'COMPLETED' => 'Completed',
                     'CANCELED' => 'Canceled',
                     'FAILED' => 'Failed'
                  ],
               ],
               'pickup_time' => [
                  'type' => 'datetime',
                  'label' => 'Pickup Time'
               ],
               'customer_email' => [
                  'type' => 'email',
                  'label' => 'Customer Email',
               ],
               'customer_name' => [
                  'type' => 'text',
                  'label' => 'Customer Name',
               ],
               'customer_phone' => [
                  'type' => 'phone',
                  'label' => 'Customer Phone',
                  'section'=> 'your-account'
               ],
               'special_instructions' => [
                  'type' => 'textarea',
                  'label' => 'Special Instructions',
               ],
               'items' => [
                  'type' => 'repeater',
                  'label' => 'Order Items',
                  'fields' => [
                     'name' => ['type' => 'text', 'label' => 'Item Name'],
                     'quantity' => ['type' => 'number', 'label' => 'Quantity'],
                     'price' => ['type' => 'number', 'label' => 'Price'],
                     'note' => ['type' => 'text', 'label' => 'Note']
                  ]
               ],
               'receipt_url' => [
                  'type' => 'url',
                  'label' => 'Receipt URL',
               ],
               'created_at' => [
                  'type' => 'datetime',
                  'label' => 'Created At',
               ],
               'updated_at' => [
                  'type' => 'datetime',
                  'label' => 'Last Updated',
               ]
            ];
   }

   public function registerSquarePostTypes():void
   {
      $orders = Registrar::forPost($this->orderPostType, 'Square Order', 'Square Orders');
      $orders->make([
         'public' => true
      ]);
      $orders->setAll(['system']);

      $fields = $orders->fields();
      foreach ($this->getOrderFields() as $fieldName => $config) {
         $fields->addField($fieldName, $config);
      }
   }

   /**
    * Get request headers for API calls
    */
@@ -245,8 +393,6 @@
    */
   protected function exchangeOAuthCode(string $code): ?array
   {
      error_log('Exchanging tokens with credentials: '.print_r($this->credentials, true));

      $this->ensureInitialized();

      // Prepare the request body as an array
@@ -272,7 +418,6 @@
      }

      $data = json_decode(wp_remote_retrieve_body($response), true);
      error_log('OAuth Response: '.print_r($data, true));
      if (isset($data['access_token'])) {
         return [
            'access_token' => $data['access_token'],
@@ -334,7 +479,6 @@

      $data = json_decode(wp_remote_retrieve_body($response), true);

      error_log('RefreshAccessToken Response: '.print_r($data, true));
      if (isset($data['access_token'])) {
         $this->credentials['access_token'] = $data['access_token'];
         $this->credentials['expires_at'] = time() + ($data['expires_in'] ?? 2592000); // 30 days
@@ -357,7 +501,6 @@
   {
      // Skip if we don't have credentials yet (during OAuth flow)
      if (empty($this->credentials['access_token'])) {
         error_log('[Square] Skipping loadLocations - no access token yet');
         return;
      }
      try {
@@ -643,7 +786,7 @@
                  'name' => $variation['name'],
                  'pricing_type' => 'FIXED_PRICING',
                  'price_money' => [
                     'amount' => intval($variation['price'] * 100), // Convert to cents
                     'amount' => intval($variation['_square_price'] * 100), // Convert to cents
                     'currency' => 'USD'
                  ]
               ]
@@ -658,7 +801,7 @@
               'name' => 'Regular',
               'pricing_type' => 'FIXED_PRICING',
               'price_money' => [
                  'amount' => intval(($itemData['price'] ?? 0) * 100),
                  'amount' => intval(($itemData['_square_price'] ?? 0) * 100),
                  'currency' => 'USD'
               ]
            ]
@@ -714,203 +857,92 @@
      if (!$this->isSetUp()) {
         return;
      }
      // User login tracking for security

      add_action('wp_login', [$this, 'trackUserLogin'], 10, 2);
        add_action('wp_enqueue_scripts', [$this, 'enqueueScripts']);

      add_action('wp_footer', [$this, 'outputCheckout']);
      add_filter('jvbAdditionalActions', [Checkout::class, 'render']);

      // Enqueue checkout scripts
      add_action('wp_enqueue_scripts', [$this, 'enqueueScripts']);
   }


   public function outputCheckout():void {
      if (is_singular(BASE.'dash') || is_post_type_archive(BASE.'dash')) {
         return;
      }
      ?>
      <button type="button" class="toggle-cart row" title="Your Cart" data-action="toggle-cart" aria-label="Open Cart" aria-controls="checkout" aria-expanded="false" hidden>
         <?= jvbIcon('cart')?><span class="abs"></span><span class="abs count"></span>
      </button>
      <aside id="cart">
         <form id="checkout" data-form-id="checkout" data-save="checkout">
            <?php
            $tabs = [
               'cartItems' => [
                  'title'  => 'Your Order',
                  'icon'   => 'cart',
                  'description' => 'Here\'s your order. You can change quantities, remove items, or clear your cart.',
                  'content'   => $this->cartContent()
               ],
               'checkout'  => [
                  'title'  => 'Checkout',
                  'icon'   => 'checkout',
                  'description' => 'Securely checkout with your name, email, and payments processed by Square.',
                  'content'   => '<div class="checkout-section">
                        <h3>Customer Information</h3>

                        <input type="text" name="name" placeholder="Full Name" required autocomplete="name">
                        <input type="email" name="email" placeholder="Email" required autocomplete="email">
                        <input type="tel" name="phone" placeholder="Phone" required autocomplete="tel"">
                        <h3>Pickup Details</h3>
                        <input type="time" name="pickup_time" min="11:00" max="20:00" required>
                        <textarea name="special_instructions" placeholder="Special instructions or dietary notes"></textarea>
                     </div>

                     <div class="checkout-section">
                        <h3>Payment Information</h3>
                        <div id="saved-cards"></div>
                        <div id="square-card-container"></div>
                     </div>'
               ],
               'order'  => [
                  'title'  => 'Your Order',
                  'icon' => 'truck',
                  'hidden' => true,
                  'description' => '',
                  'content'   => $this->renderOrderStatus()
               ]
            ];
            jvbRenderTabs($tabs);
            ?>

            <div class="cart-total row end"><p class="tax">Tax: <span></span></p><p class="total">GRAND TOTAL: <span></span></p></div>
         </form>
      </aside>
      <template class="restoredCart">
         <div class="restored">
            <h3>Looks like we left things hanging</h3>
            <p>We've restored your cart from your last session below.</p>
            <p>If you'd rather start over, click the button below.</p>
            <div class="row btw">
               <button type="button" onclick="window.squareCheckout.clearCart();this.closest('.restored').remove()"><?=jvbIcon('trash')?>Clear Cart</button>
               <button type="button" onclick="this.closest('.restored').remove()"><?= jvbIcon('x')?>Dismiss</button>
            </div>
         </div>
      </template>
      <template class="cartItem">
         <tr class="item">
            <td class="item">
               <label for="quantity"></label>
               <div class="quantity field" data-min="0" data-max="50" data-step="1" data-price="17" data-id="">

                  <button type="button" class="decrease"aria-label="Decrease Add to Order">
                     <i class="icon minus"><svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" fill="currentColor" viewBox="0 0 256 256"><path d="M208,36H48A12,12,0,0,0,36,48V208a12,12,0,0,0,12,12H208a12,12,0,0,0,12-12V48A12,12,0,0,0,208,36Zm4,172a4,4,0,0,1-4,4H48a4,4,0,0,1-4-4V48a4,4,0,0,1,4-4H208a4,4,0,0,1,4,4Zm-40-80a4,4,0,0,1-4,4H88a4,4,0,0,1,0-8h80A4,4,0,0,1,172,128Z"></path></svg></i>           </button>

                  <input type="number" id="quantity" name="quantity" value="0" min="0" max="50" step="1" class="quantity-input">

                  <button type="button" class="increase" aria-label="Increase Add to Order">
                     <i class="icon add"><svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" fill="currentColor" viewBox="0 0 256 256"><path d="M208,36H48A12,12,0,0,0,36,48V208a12,12,0,0,0,12,12H208a12,12,0,0,0,12-12V48A12,12,0,0,0,208,36Zm4,172a4,4,0,0,1-4,4H48a4,4,0,0,1-4-4V48a4,4,0,0,1,4-4H208a4,4,0,0,1,4,4Zm-40-80a4,4,0,0,1-4,4H132v36a4,4,0,0,1-8,0V132H88a4,4,0,0,1,0-8h36V88a4,4,0,0,1,8,0v36h36A4,4,0,0,1,172,128Z"></path></svg></i>             </button>
               </div>
            </td>
            <td class="price">
               <span class="price"></span>
            </td>
            <td class="total">
               <span class="total"></span>
            </td>
            <td>
               <button type="button" data-remove-from-cart><?= jvbIcon('trash')?></button>
            </td>
         </tr>
      </template>
      <template class="emptyCart">
         <div class="empty">
            <p><i><b>No items in cart.</b></i></p>
            <p>You can <a href="<?= get_post_type_archive_link(BASE.'menu_item')?>" title="Browse our menu">browse our menu</a> to order.</p>
         </div>
      </template>
      <?php
   }

   private function cartContent():string
   {
      ob_start();
      ?>
      <div class="cart-items">
         <table>
            <thead>
               <tr>
                  <th scope="col">Item</th>
                  <th scope="col">Price</th>
                  <th scope="col">Total</th>
               </tr>
            </thead>
            <tbody>

            </tbody>
         </table>
      </div>

      <details class="account">
         <summary>
            <?php
            if (is_user_logged_in()) {
               echo 'Your Favourites and Order History';
            } else {
               echo '<a href="'.wp_login_url(get_the_permalink()).'">Log in</a> to save your favourites and view order history.';
            }
            ?>
         </summary>
         <?php
         if (is_user_logged_in()) {
            $tabs = [
               'history' => [
                  'title'  => 'Order History',
                  'icon' => 'checkout',
                  'description' => 'View your past orders and quickly reorder',
                  'content'   => $this->renderOrderHistory()
               ],
               'favourites' => [
                  'title'  => 'Favourites',
                  'icon'   => 'heart',
                  'description'  => 'View your favourites from our menu',
                  'content'      => $this->renderFavourites()
               ]
            ];
            jvbRenderTabs($tabs);
      add_filter('jvb_checkout_description', function (string $desc, string $provider) {
         if ($provider === 'square') {
            return 'Securely checkout with your name, email, and payments processed by Square.';
         }
         return $desc;
      }, 10, 2);

         ?>
      </details>
      // Square-specific pickup fields (extracted from old outputCheckout)
      add_filter('jvb_checkout_fields', [$this, 'addPickupFields'], 10, 2);

      <?php
      return ob_get_clean();
      // Browse URL for this client (restaurant menu)
      add_filter('jvb_checkout_browse_url', function () {
         return get_post_type_archive_link(BASE . 'menu_item');
      });
      add_filter('jvb_checkout_browse_text', function () {
         return 'browse our menu';
      });
      // Register queue executor types
      add_action('init', [$this, 'registerQueueTypes'], 10);
   }

   private function renderOrderHistory():string
   /**
    * Pickup/ordering fields for the shared checkout form.
    * Specific to this Square client's food ordering use case.
    */
   public function addPickupFields(string $html, string $provider): string
   {
      ob_start();
      //TODO: getRequest, cache for 1 day
      return ob_get_clean();
   }
   private function renderFavourites():string
   {
      ob_start();
      //TODO: get user's favourites and list them
      return ob_get_clean();
      if ($provider !== 'square') {
         return $html;
      }

      return $html
         . '<h3>Pickup Details</h3>'
         . Form::render('pickup_time', null, [
            'type'     => 'datetime',
            'label'    => 'Pickup Time',
            'min'      => '11:00',
            'max'      => '20:00',
            'required' => true,
         ])
         . Form::render('special_instructions', null, [
            'type'  => 'textarea',
            'label' => 'Special Instructions',
            'quill' => true,
         ]);
   }

   protected function renderOrderStatus():string
   public function registerQueueTypes(): void
   {
      ob_start();
      ?>
      <div class="order-confirmation">
         <h2>Order Confirmed!</h2>
         <div id="order-status" data-order="">
            <p>Order #<span class="order-num"></span></p>
            <div class="status-timeline">
               <div class="status-item active" data-status="received">Order Received</div>
               <div class="status-item" data-status="preparing">Preparing</div>
               <div class="status-item" data-status="ready">Ready for Pickup</div>
            </div>
            <div class="pickup-time">
               Estimated pickup: <span id="eta">Calculating...</span>
            </div>
         </div>
      </div>
      <?php
      return ob_get_clean();
      $queue    = JVB()->queue();
      $executor = new IntegrationExecutor();

      $queue->registry()->register(self::$syncTo, new TypeConfig(
         executor:   $executor,
         chunkKey:   'items',
         chunkSize:  50,
         maxRetries: 3
      ));

      $queue->registry()->register(self::$deleteFrom, new TypeConfig(
         executor:   $executor,
         chunkKey:   'external_ids',
         chunkSize:  200,
         maxRetries: 2
      ));

      $queue->registry()->register(self::$syncFrom, new TypeConfig(
         executor:   $executor,
         maxRetries: 3
      ));

      $queue->registry()->register(self::$syncCustomer, new TypeConfig(
         executor:   $executor,
         maxRetries: 2
      ));

      $queue->registry()->register(self::$import, new TypeConfig(
         executor:   $executor,
         maxRetries: 3
      ));
   }

   /******************************************************************
@@ -922,14 +954,12 @@
    */
   protected function handleTheSavePost(int $postID, \WP_Post $post, bool $update, array $settings): void
   {
      error_log('Queuing Sync to Square');
      // Queue the sync operation
      $this->queueOperation('sync_to_square', [
         'items' => [$postID],
         'user_id' => $this->userID
      $this->queueOperation(self::$syncTo, [
         'items'   => [$postID],
         'user_id' => $this->userID,
      ], [
         'priority' => 'high',
         'delay' => 30, // Small delay to batch multiple saves
         'delay'    => 30,
      ]);

      update_post_meta($postID, BASE . '_square_sync_status', 'queued');
@@ -943,41 +973,16 @@
      $square_id = get_post_meta($postID, BASE . '_square_catalog_id', true);

      if ($square_id) {
         $this->queueOperation('delete_from_square', [
            'square_ids' => [$square_id],
            'post_id' => $postID
         $this->queueOperation(self::$deleteFrom, [
            'external_ids' => [$square_id],
            'post_id'      => $postID,
         ], [
            'priority' => 'high'
            'priority' => 'high',
         ]);
      }
   }

   /**
    * Process queued operations
    */
   public function processOperation(WP_Error|array $result, object $operation, array $data): WP_Error|array
   {
      $base = strtolower($this->service_name).'_';
      $square = (array_key_exists('user', $data)) ? new self((int)$data['user']) : $this;
      switch ($operation->type) {
         case $base.'sync_to_square':
            return $square->processSyncToSquare($data);

         case $base.'delete_from_square':
            return $square->processDeleteFromSquare($data);

         case $base.'sync_from_square':
            return $square->processSyncFromSquare($data);

         case $base.'sync_customer':
            return $square->processSyncCustomer($data);

         default:
            return $result;
      }
   }

   /**
    * Process sync to Square
    */
   private function processSyncToSquare(array $data): array
@@ -1028,19 +1033,6 @@

         if (!is_wp_error($response)) {
            $this->processBatchSyncResponse($response, $map, $success, $errors);
            $square_id = $response['objects'][0]['id'];
            update_post_meta($postID, BASE . '_square_catalog_id', $square_id);
            update_post_meta($postID, BASE . '_square_sync_status', 'synced');
            update_post_meta($postID, BASE . '_square_last_sync', current_time('mysql'));

            // Save variation IDs
            if (!empty($response['objects'][0]['item_data']['variations'])) {
               foreach ($response['objects'][0]['item_data']['variations'] as $index => $variation) {
                  update_post_meta($postID, BASE . '_square_variation_' . $index . '_id', $variation['id']);
               }
            }

            $success[] = $postID;
         } else {
            // Handle batch request failure
            $error_message = 'Batch sync failed';
@@ -1157,6 +1149,7 @@
    * @param string|null $square_image_id Previously uploaded Square image ID
    * @return array|WP_Error Catalog object or error
    */
   //TODO: Get to work with Registrar settings
   protected function buildCatalogObject(int $postID, ?string $square_image_id = null): array|WP_Error
   {
      $post = get_post($postID);
@@ -1164,7 +1157,7 @@
         return new WP_Error('post_not_found', "Post $postID not found");
      }

      $meta = new MetaManager($postID, 'post');
      $meta = Meta::forPost($postID);
      $post_type = get_post_type($postID);

      // Get existing Square catalog ID if it exists
@@ -1189,10 +1182,10 @@
      }

      // Add variations
      $variations = $meta->getValue('product_variations');
      $variations = $meta->get('product_variations');
      if (empty($variations)) {
         // Create default variation if none exist
         $price = floatval($meta->getValue('price') ?: 0);
         $price = floatval($meta->get('price') ?: 0);
         $catalog_object['item_data']['variations'][] = [
            'type' => 'ITEM_VARIATION',
            'id' => $existing_square_id ? null : '#'.BASE.'menu_item_' . $postID . '_var_default',
@@ -1245,7 +1238,7 @@
      }

      // Add modifiers if they exist
      $modifiers = $meta->getValue('modifiers');
      $modifiers = $meta->get('modifiers');
      if (!empty($modifiers)) {
         $modifier_ids = [];
         foreach ($modifiers as $modifier) {
@@ -1261,7 +1254,7 @@
      }

      // Add tax settings
      $tax_ids = $meta->getValue('tax_ids');
      $tax_ids = $meta->get('tax_ids');
      if (!empty($tax_ids)) {
         $catalog_object['item_data']['tax_ids'] = $tax_ids;
      }
@@ -1284,7 +1277,7 @@
      if (!empty($product_variations) && is_array($product_variations)) {
         foreach ($product_variations as $index => $variation_data) {
            // Skip empty variations
            if (empty($variation_data['name']) && empty($variation_data['sku'])) {
            if (empty($variation_data['name']) && empty($variation_data['_square_sku'])) {
               continue;
            }

@@ -1316,7 +1309,7 @@
                        break;

                     case 'sku':
                        $variation['item_variation_data']['sku'] = $variation_data[$wp_field];
                        $variation['item_variation_data']['_square_sku'] = $variation_data[$wp_field];
                        break;

                     case 'track_inventory':
@@ -1367,20 +1360,25 @@
    */
   protected function getVariationMapping(string $post_type): array
   {
      $product_type = JVB_CONTENT[jvbNoBase($post_type)]['integrations']['square']['content_type'] ?? 'REGULAR';
      $registrar = Registrar::getInstance($post_type);
      if (!$registrar) {
         return [];
      }
      $config = $registrar->getIntegrationConfig($this->service_name);
      $product_type = $config['content_type']??'REGULAR';
      $valid_fields = $this->getValidFieldsForProductType($product_type);

      $defaults = [
         'name' => 'name',
         'id' => '_square_catalog_id',
         'sku' => 'sku',
         'price' => 'price',
         'track_inventory' => 'track_inventory',
         'service_duration' => 'service_duration',
         'available_for_booking' => 'available_for_booking',
         'gift_card_type' => 'gift_card_type',
         'ingredients' => 'ingredients',
         'preparation_time_duration' => 'preparation_time_duration'
         'id' => '_square_item_id',
         'sku' => '_square_sku',
         'price' => '_square_price',
         'track_inventory' => '_square_track_inventory',
         'service_duration' => '_square_service_duration',
         'available_for_booking' => '_square_available_for_booking',
         'gift_card_type' => '_square_gift_card_type',
         'ingredients' => '_square_ingredients',
         'preparation_time_duration' => '_square_preparation_time_duration'
      ];

      $extended = apply_filters(
@@ -1436,7 +1434,12 @@
    */
   protected function getFieldMapping(string $post_type): array
   {
      $product_type = JVB_CONTENT[jvbNoBase($post_type)]['integrations']['square']['content_type'] ?? 'REGULAR';
      $registrar = Registrar::getInstance($post_type);
      if (!$registrar) {
         return [];
      }
      $config = $registrar->getIntegrationConfig($this->service_name);
      $product_type = $config['content_type']??'REGULAR';
      $valid_fields = $this->getValidFieldsForProductType($product_type);

      $defaults = [
@@ -1444,15 +1447,15 @@
         'description_html' => 'post_content',
         'abbreviation' => 'abbreviation',
         'id' => '_square_catalog_id',
         'sku' => 'sku',
         'sku' => '_square_sku',
         'category_id' => 'category',
         'image_ids' => 'post_thumbnail',
         'price' => 'price',
         'price' => '_square_price',
         'tax_ids' => 'tax_ids',
         // Availability
         'available_online' => 'available_online',
         'available_for_pickup' => 'available_for_pickup',
         'available_electronically' => 'available_electronically',
         'available_online' => '_square_available_online',
         'available_for_pickup' => '_square_available_for_pickup',
         'available_electronically' => '_square_available_electronically',
         // Modifiers
         'modifier_list_info' => 'modifiers',
         // Item options
@@ -1476,6 +1479,7 @@
   /**
    * Get valid fields for Square product type
    */
   //TODO: This feels redundant now, with how we've defined fields in getAdditionalFields
   private function getValidFieldsForProductType(string $product_type): array
   {
      $fields = ['name', 'description_html', 'sku', 'price', 'image_ids', 'category_id'];
@@ -1519,6 +1523,7 @@
   /**
    * Handle customer authentication during checkout
    */
   //TODO: Is this necessary?
   public function handleCustomerAuth($data):WP_Error|array
   {
      $email = sanitize_email($data['email'] ?? '');
@@ -1569,7 +1574,8 @@
               'message' => 'Email found. Would you like to create an account to save your order history?'
            ];
         }
      } else {
      }

         // Check Square for customer
         $response = $this->postRequest('customers/search', [
            'filter' => [
@@ -1592,7 +1598,6 @@
               'message' => 'New customer'
            ];
         }
      }
   }

   private function createCustomerAccount(string $email):WP_Error|array
@@ -1632,7 +1637,7 @@

      // Set user role (assuming you have a customer role defined)
      $user = new \WP_User($user_id);
      $user->set_role(BASE.'foodie'); // Or whatever role from JVB_USER
      $user->set_role(BASE.'foodie'); // Or whatever role

      // Generate password reset key
      $reset_key = get_password_reset_key($user);
@@ -1684,24 +1689,26 @@
   private function sendWelcomeEmail(\WP_User $user, string $reset_key): void
   {
      $site_name = get_bloginfo('name');
      $reset_url = get_home_url(2, "wp-login.php?action=rp&key=$reset_key&login=" . rawurlencode($user->user_login), 'login');
      $reset_url = get_home_url(null, "wp-login.php?action=rp&key=$reset_key&login=" . rawurlencode($user->user_login), 'login');

      $message = sprintf(
         "Welcome to %s!\n\n" .
         "Your account has been created. Please click the link below to set your password:\n\n" .
         "Your account has been created. Please click the button below to set your password:\n\n" .
         "%s\n\n" .
         "Once you've set your password, you can log in to:\n" .
         "Or, copy and paste the link below:\n\n".
         "%s\n\n" .
         "Once you've set your password, you can:\n" .
         "- View your order history\n" .
         "- Save your favorite items\n" .
         "- Speed up checkout with saved payment methods\n\n" .
         "If you didn't create this account, please ignore this email.\n\n" .
         "Thanks,\n%s",
         "Thanks,\n",
         $site_name,
         $reset_url,
         $site_name
         JVB()->email()->button('Reset Password', $reset_url),
         JVB()->email()->link($reset_url),
      );

      jvbMail(
      JVB()->email()->sendEmail(
         $user->user_email,
         sprintf('[%s] Welcome! Set Your Password', $site_name),
         $message
@@ -1714,11 +1721,11 @@
   public function trackUserLogin(string $user_login, \WP_User $user): void
   {
      // Check if user has Square integration
      $roles = array_keys(JVB_USER);
      $user_roles = $user->roles;

      foreach ($user_roles as $role) {
         if (isset(JVB_USER[$role]['integrations']['square']['is_customer'])) {
      $role = jvbUserRole($user->ID);
      $registrar = Registrar::getInstance($role);
      if ($registrar) {
         $config = $registrar->getIntegration($this->service_name);
         if ($config->isCustomer()) {
            $login_count = (int)get_user_meta($user->ID, BASE . '_square_login_count', true);
            $login_count++;

@@ -1729,8 +1736,6 @@
            if ($login_count % self::PASSWORD_RESET_INTERVAL === 0) {
               $this->schedulePasswordReset($user->ID);
            }

            break;
         }
      }
   }
@@ -1745,11 +1750,10 @@
      // Send notification
      $user = get_user_by('ID', $user_id);
      if ($user) {
         wp_mail(
         JVB()->email()->sendEmail(
            $user->user_email,
            '['.get_bloginfo('name').'] Security Code',
            'For your security, enter this code to continue accessing your account and saved payment methods.',
            ['Content-Type: text/html; charset=UTF-8']
         );
      }
   }
@@ -1838,14 +1842,40 @@
   {
      $order_id = $data['object']['order']['id'] ?? '';
      $state = $data['object']['order']['state'] ?? '';
      $fulfillments = $data['object']['order']['fulfillments'] ?? [];

      if (!$order_id) {
         return false;
      }

      // Update cached order status
      set_transient(BASE . 'square_order_' . $order_id, $state, HOUR_IN_SECONDS);
      // Find the WP post for this order
      $wp_order_id = $this->getOrderPost($order_id);

      if ($wp_order_id) {
         // Update the post meta
         $meta = Meta::forPost($wp_order_id);
         $updates = [
            'status' => $state,
            'updated_at' => current_time('mysql')
         ];

         // Extract fulfillment status and pickup time
         if (!empty($fulfillments[0])) {
            $fulfillment = $fulfillments[0];
            $updates['fulfillment_status'] = $fulfillment['state'] ?? $state;

            if (!empty($fulfillment['pickup_details']['pickup_at'])) {
               $updates['pickup_time'] = $fulfillment['pickup_details']['pickup_at'];
            }
         }

         $meta->setAll($updates);

         // Trigger notification to customer if order is ready
         if ($state === 'PREPARED') {
            do_action(BASE . 'square_order_ready', $wp_order_id, $order_id);
         }
      }
      // Trigger action for other integrations
      do_action(BASE . 'square_order_updated', $order_id, $state, $data);

@@ -1909,8 +1939,9 @@
   /**
    * Enqueue checkout scripts with Square configuration
    */
   public function enqueueScripts():void
   public function enqueueScripts(): void
   {
      jvbInlineStyles('forms');
      $this->loadCredentials();
      $sdk_url = $this->environment === 'production'
         ? 'https://web.squarecdn.com/v1/square.js'
@@ -1921,48 +1952,38 @@
         $sdk_url,
         [],
         null,
         [
            'strategy' => 'defer',
            'in_footer' => true
         ]
         ['strategy' => 'defer', 'in_footer' => true]
      );

      // Register your custom checkout script
      // Shared cart checkout base class
      wp_register_script(
         'jvb-checkout',
         JVB_URL . 'assets/js/min/checkout.min.js',
         ['jvb-utility', 'jvb-queue', 'jvb-a11y', 'jvb-cache', 'jvb-tabs', 'jvb-popup', 'jvb-login'],
         '1.1.32',
         ['strategy' => 'defer', 'in_footer' => true]
      );

      // Square checkout extends CartCheckout
      wp_register_script(
         'jvb-square-checkout',
         JVB_URL . 'assets/js/min/square.min.js',
         [
//          'square-payments-sdk',
            'jvb-utility',
            'jvb-queue',
            'jvb-a11y',
            'jvb-cache',
            'jvb-tabs',
            'jvb-modal',
         ],
         '1.0.0',
         [
            'strategy' => 'defer',
            'in_footer' => true
         ]
         ['jvb-checkout', 'square-payments-sdk'],
         '1.1.32',
         ['strategy' => 'defer', 'in_footer' => true]
      );

      wp_enqueue_script('jvb-square-checkout');

      // Localize the checkout script with Square config
      wp_localize_script(
         'jvb-square-checkout',
         'squareConfig',
         [
            'isOpen'    => jvbIsOpen(),
            'application_id' => $this->credentials['client_id'] ?? '',
            'location_id' => $this->locationId,
            'environment' => $this->environment,
            'api_url' => rest_url('jvb/v1/square/'),
            'nonce' => wp_create_nonce('wp_rest'),
            'currency' => get_option(BASE . 'currency', 'CAD')
         ]
      );
      wp_localize_script('jvb-square-checkout', 'squareConfig', [
         'isOpen'         => jvbIsOpen()?'1':'0',
         'application_id' => $this->credentials['client_id'] ?? '',
         'location_id'    => $this->locationId,
         'environment'    => $this->environment,
         'currency'       => $this->getCurrency(),
         'is_logged_in'   => is_user_logged_in(),
         'user_email'     => is_user_logged_in() ? wp_get_current_user()->user_email : '',
      ]);
   }

   /******************************************************************
@@ -1972,7 +1993,7 @@
   /**
    * Get or create Square customer
    */
   private function getOrCreateSquareCustomer(array $customer_info): ?string
   public function getOrCreateSquareCustomer(array $customer_info): ?string
   {
      if (empty($customer_info['email'])) {
         return null;
@@ -2005,92 +2026,6 @@
      return null;
   }

   /**
    * Save order reference for status tracking
    */
   public function saveOrderReference($data): array
   {
      $order_id = sanitize_text_field($data['order_id'] ?? '');
      $payment_id = sanitize_text_field($data['payment_id'] ?? '');

      if (!$order_id) {
         return ['success' => false, 'message' => 'Invalid order data'];
      }

      // Save to user if logged in
      if (is_user_logged_in()) {
         $user_id = get_current_user_id();
         $orders = get_user_meta($user_id, BASE . '_square_orders', true) ?: [];
         $orders[] = [
            'order_id' => $order_id,
            'payment_id' => $payment_id,
            'date' => current_time('mysql'),
            'customer' => $data['customer'] ?? []
         ];

         // Keep last 50 orders
         if (count($orders) > 50) {
            $orders = array_slice($orders, -50);
         }

         update_user_meta($user_id, BASE . '_square_orders', $orders);
      }

      return [
         'success' => true,
         'order_id' => $order_id,
         'message' => 'Order saved'
      ];
   }
   /**
    * Save order to user meta
    */
   private function saveOrderToUser(int $user_id, string $order_id): void
   {
      $orders = get_user_meta($user_id, BASE . '_square_orders', true) ?: [];
      $orders[] = [
         'order_id' => $order_id,
         'date' => current_time('mysql')
      ];

      // Keep only last 50 orders
      if (count($orders) > 50) {
         $orders = array_slice($orders, -50);
      }

      update_user_meta($user_id, BASE . '_square_orders', $orders);
   }

   /**
    * Get order status (for customer feedback)
    */
   public function getOrderStatus($data): WP_Error|array
   {
      $order_id = sanitize_text_field($data['order_id'] ?? '');

      if (!$order_id) {
         return new WP_Error('error', 'Order ID required');
      }

      // Fetch from Square
      $response = $this->getRequest('v2/orders/' . $order_id);

      if (is_wp_error($response)) {
         return new WP_Error('error', 'Could not fetch order status');
      }

      $order = $response['order'] ?? [];
      $status_data = [
         'state' => $order['state'] ?? 'UNKNOWN',
         'fulfillment_eta' => $order['fulfillments'][0]['pickup_details']['pickup_at'] ?? null
      ];

      return [
         'success' => true,
         'status' => $status_data['state'],
         'eta' => $status_data['fulfillment_eta']
      ];
   }

   /**
    * Process delete from Square
@@ -2192,16 +2127,21 @@
    */
   private function importSquareItem(array $item): bool|int
   {
      //TODO: We need to add the post type to custom meta for Square, this is not good if we have multiple post types with the same product type
      // Find matching content type
      $product_type = $item['item_data']['product_type'] ?? 'REGULAR';
      $post_type = null;

      foreach (JVB_CONTENT as $key => $config) {
         if (isset($config['integrations']['square']['content_type']) &&
            $config['integrations']['square']['content_type'] === $product_type) {
            $post_type = jvbCheckBase($key);
      foreach (Registrar::getRegistered() as $registrar) {
         if (!$registrar->hasIntegration($this->service_name)) {
            continue;
         }
         $config = $registrar->getIntegration($this->service_name);
         if ($config->getContent_type() && $config->getContent_type() === $product_type) {
            $post_type = jvbCheckBase($registrar->getSlug());
            break;
         }

      }

      if (!$post_type) {
@@ -2245,7 +2185,7 @@
    */
   private function mapSquareFieldsToWordPress(int $post_id, array $item): void
   {
      $meta = new MetaManager($post_id, 'post');
      $meta = Meta::forPost($post_id);
      $field_map = $this->getFieldMapping(get_post_type($post_id));

      $values_to_save = [];
@@ -2261,7 +2201,7 @@
         foreach ($item['item_data']['variations'] as $index => $variation) {
            $var_data = [
               'name' => $variation['item_variation_data']['name'] ?? '',
               'sku' => $variation['item_variation_data']['sku'] ?? '',
               'sku' => $variation['item_variation_data']['_square_sku'] ?? '',
            ];

            // Extract price
@@ -2381,7 +2321,7 @@
         update_user_meta($user->ID, BASE . '_square_customer_updated', current_time('mysql'));

         // Clear cached customer data
         $this->cache->delete('square_customer_' . $user->ID);
         $this->cache->forget('square_customer_' . $user->ID);
      }

      return true;
@@ -2400,8 +2340,12 @@
         return false;
      }

      // Update cached payment status
      set_transient(BASE . 'square_payment_' . $payment_id, $status, HOUR_IN_SECONDS);
      if ($order_id) {
         $order = $this->getOrderPost($order_id);
         if ($order) {
            Meta::forPost($order)->set('square_payment_status', $status);
         }
      }

      // Trigger action for other integrations
      do_action(BASE . 'square_payment_updated', $payment_id, $status, $order_id, $data);
@@ -2612,7 +2556,6 @@

         // Validate environment setting
         if (isset($credentials['environment'])) {
            error_log('Environment: '.print_r($credentials['environment'], true));
            $validEnvironments = ['sandbox', 'production'];
            if (!in_array($credentials['environment'], $validEnvironments)) {
               $this->logError('Invalid environment setting', [
@@ -2702,12 +2645,83 @@
         'GIFT_CARD' => array_merge($this->setGiftCardFields())
      ];
   }
   public function getAdditionalFields(?string $content_type = null):array {
      if ($content_type === 'customer') {
         return $this->getCustomerFields();
      }
      if ($content_type && array_key_exists($content_type, $this->contentTypes)){
         $array = $this->contentTypes[$content_type];
         return array_combine(
            array_map(fn($k) => '_square_' . $k, array_keys($array)),
            $array
         );
      } else if ($content_type && !array_key_exists($content_type, $this->contentTypes)) {
         error_log('Could not get default fields for '.$this->service_name.' content type: '.$content_type);
         return [];
      }
      $array = $this->setBaseFields();
        return array_combine(
            array_map(fn($k) => '_square_' . $k, array_keys($array)),
            $array
        );
   }

   protected function getCustomerFields():array
   {
      return [
         'customer_id'  => [
            'type'   => 'text',
            'label'  => 'Square Customer ID',
            'hidden'=> true,
            'section'=> 'your-account'
         ],
         'address_line_1'  => [
            'type'   => 'text',
            'label'  => 'Address Line 1',
            'hint'   => 'ex: 6551 111 St NW',
            'required'  => true,
            'section'   => 'address'
         ],
         'address_line_2'  => [
            'type'   => 'text',
            'label'  => 'Address Line 2',
            'hint'   => 'ex: Unit 2',
            'section'   => 'address'
         ],
         'city'   => [
            'type'   => 'text',
            'label'=> 'City',
            'section'   => 'address',
            'required'  => true,
         ],
         'state' => [
            'type'   => 'text',
            'label' => 'Province',
            'hint' => 'The two-character code, example: AB',
            'default'=> 'AB',
            'section'   => 'address',
            'required'  => true,
         ],
         'zip_code' => [
            'type'   => 'text',
            'label'  => 'Postal Code',
            'section'=> 'address'
         ],
         'countryCode'  => [
            'type'   => 'text',
            'label'  => 'Country Code',
            'hint'   => 'The tw-character country code, example: CA',
            'default'   => 'CA',
            'section'   => 'address',
            'required'  => true,
         ]
      ];
   }
   protected function setBaseFields():array
   {
      return [
         'price' => [
            'type'        => 'number',
            'bulkEdit'    => true,
            'label'       => 'Price',
            'step'        => 0.01,
            'max'         => 99999,
@@ -2752,6 +2766,11 @@
            'label'       => 'Variation Name',
            'description' => 'e.g., "Small", "Large", "Red", etc.'
         ],
            'sku' => [
                'type'        => 'text',
                'label'       => 'SKU',
                'description' => 'Stock keeping unit'
            ],
         'price' => [
            'type'        => 'number',
            'label'       => 'Price',
@@ -2759,18 +2778,17 @@
            'max'         => 99999,
            'description' => 'Price for this variation'
         ],

         'track_inventory' => [
            'type'   => 'true_false',
            'label'  => 'Track Inventory',
         ],
         '_square_item_id' => [
         'item_id' => [
            'type'        => 'text',
            'label'       => 'Square Variation ID',
            'description' => 'Square catalog ID for this variation',
            'hidden'      => true
         ],
         '_square_last_sync' => [
         'last_sync' => [
            'type'   => 'datetime',
            'label'  => 'Last Sync',
            'hidden' => true
@@ -2811,7 +2829,10 @@
            ];
            break;
      }
      return $fields;
      return array_combine(
            array_map(fn($k) => '_square_' . $k, array_keys($fields)),
            $fields
        );
   }
   protected function setFoodAndBevFields():array
   {
@@ -2947,7 +2968,8 @@
               'name' => $image_title ?: 'Image',
               'caption' => $alt_text ?: ''
            ]
         ]
         ],
         'object_id' => $supported_image_id
      ];

      $body = $this->buildMultipartBody($file_path, $request_json, $boundary);
@@ -3276,4 +3298,349 @@
         $this->deleteCredentials();
      }
   }

   public function createSquareOrder(array $items, ?string $customer_id, array $data): array|WP_Error
   {
      // Build line items for Square
      $line_items = [];
      foreach ($items as $item) {
         $line_item = [
            'quantity' => (string)$item['quantity'], // MUST be string!
         ];

         // Use catalog_object_id if available (recommended)
         if (!empty($item['catalog_object_id'])) {
            $line_item['catalog_object_id'] = $item['catalog_object_id'];
            $line_item['catalog_version'] = $item['catalog_version'] ?? null;
         } else {
            // Ad-hoc line item (not recommended - no tax/inventory automation)
            $line_item['name'] = $item['name'];
            $line_item['base_price_money'] = [
               'amount' => (int)$item['_square_price'],
               'currency' => $this->getCurrency()
            ];
         }

         if (!empty($item['note'])) {
            $line_item['note'] = $item['note'];
         }

         $line_items[] = $line_item;
      }

      $order_data = [
         'idempotency_key' => wp_generate_uuid4(), // Different from payment idempotency key
         'order' => [
            'location_id' => $this->locationId,
            'line_items' => $line_items,
            'state' => 'OPEN'
         ]
      ];

      // Add customer if available
      if ($customer_id) {
         $order_data['order']['customer_id'] = $customer_id;
      }

      // Add metadata
      if (!empty($data['note'])) {
         $order_data['order']['metadata'] = [
            'special_instructions' => $data['note']
         ];
      }

      if (!empty($data['pickup_time'])) {
         $order_data['order']['metadata']['pickup_time'] = $data['pickup_time'];
      }

      return $this->postRequest('orders', $order_data);
   }

   public function createSquarePayment(
      string $source_id,
      string $idempotency_key,
      int $amount_cents,
      string $order_id,
      ?string $customer_id
   ): array|WP_Error
   {
      $payment_data = [
         'idempotency_key' => $idempotency_key,
         'source_id' => $source_id,
         'amount_money' => [
            'amount' => $amount_cents, // Already in cents!
            'currency' => $this->getCurrency()
         ],
         'order_id' => $order_id,
         'location_id' => $this->locationId,
         'autocomplete' => true, // Capture immediately
      ];

      // Add customer if available
      if ($customer_id) {
         $payment_data['customer_id'] = $customer_id;
      }

      // Add reference ID for tracking
      $payment_data['reference_id'] = 'WP_' . time();

      return $this->postRequest('payments', $payment_data);
   }

   public function saveOrderToWordPress(array $order_data): int
   {
      // Extract customer info
      $customer_email = $order_data['customer']['email'] ?? '';
      $customer_name = $order_data['customer']['name'] ?? '';

      // Find or create WP user for logged-in association
      $user_id = 0;
      if ($customer_email) {
         $user = get_user_by('email', $customer_email);
         if ($user) {
            $user_id = $user->ID;
            // Store Square customer ID on user
            if (!empty($order_data['square_customer_id'])) {
               update_user_meta($user_id, BASE . '_square_customer_id', $order_data['square_customer_id']);
            }
         }
      }

      // Create order post
      $order_post_id = wp_insert_post([
         'post_type' => BASE.$this->orderPostType,
         'post_title' => 'Order #' . $order_data['square_order_id'],
         'post_status' => 'publish',
         'post_author' => $user_id // Associate with user if logged in
      ]);

      if (!$order_post_id || is_wp_error($order_post_id)) {
         $this->logError('Failed to create order post', ['order_data' => $order_data]);
         return 0;
      }

      // Save all order meta
      $meta = Meta::forPost($order_post_id);
      $fields = $this->getOrderFields();
      unset($fields['post_title']);

      $meta->setAll([
         'square_order_id' => $order_data['square_order_id'],
         'square_payment_id' => $order_data['square_payment_id'] ?? '',
         'square_customer_id' => $order_data['square_customer_id'] ?? '',
         'amount' => $order_data['amount'],
         'status' => $order_data['status'],
         'fulfillment_status' => $order_data['fulfillment_status'] ?? 'PROPOSED',
         'pickup_time' => $order_data['pickup_time'] ?? '',
         'customer_email' => $customer_email,
         'customer_name' => $customer_name,
         'customer_phone' => $order_data['customer']['phone'] ?? '',
         'special_instructions' => $order_data['note'] ?? '',
         'items' => $order_data['items'],
         'receipt_url' => $order_data['receipt_url'] ?? '',
         'created_at' => current_time('mysql'),
         'updated_at' => current_time('mysql')
      ]);

      return $order_post_id;
   }

   /**
    * Get currency code
    */
   private function getCurrency(): string
   {
      return get_option(BASE . 'currency', 'CAD');
   }

   /**
    * Get customer with saved cards (2025-compliant)
    */
   public function getUserCards(string $customer_id): array
   {
      $response = $this->getRequest('cards?customer_id=' . $customer_id);
      return $response['cards'] ?? [];
   }


   public function getUserOrders(string $customer_email): array
   {
      // First get Square customer ID
      $customer_response = $this->postRequest('customers/search', [
         'filter' => [
            'email_address' => ['exact' => $customer_email]
         ]
      ]);

      $customer_id = $customer_response['customers'][0]['id'] ?? null;
      if (!$customer_id) {
         return [];
      }

      // Get their orders
      $orders_response = $this->postRequest('orders/search', [
         'filter' => [
            'customer_filter' => [
               'customer_ids' => [$customer_id]
            ]
         ],
         'sort' => [
            'sort_field' => 'CREATED_AT',
            'sort_order' => 'DESC'
         ],
         'limit' => 50
      ]);

      return $orders_response['orders'] ?? [];
   }

   public function checkOrderStatus(string $order_id): ?string
   {
      // Fetch from Square
      $response = $this->getRequest('orders/' . $order_id);
      if (!is_wp_error($response)) {
         $state = $response['order']['state'] ?? null;
         return $state;
      }

      return null;
   }

   /**
    * Single-item sync. Called by IntegrationExecutor::processSyncTo().
    * Delegates to syncBatchToService since Square uses batch-upsert.
    */
   public function syncPostToService(int $postID): array|WP_Error
   {
      return $this->syncBatchToService(['items' => [$postID]]);
   }

   /**
    * Batch sync — preferred by IntegrationExecutor when available.
    * Wraps existing processSyncToSquare which already handles batches.
    */
   public function syncBatchToService(array $data): array|WP_Error
   {
      $result = $this->processSyncToSquare($data);

      if (empty($result['success'])) {
         $errors = implode(', ', $result['result']['errors'] ?? ['Sync failed']);
         return new WP_Error('square_sync_failed', $errors);
      }

      return $result;
   }

   /**
    * Delete catalog object from Square.
    * Called by IntegrationExecutor::processDeleteFrom().
    */
   public function deleteFromService(string $externalId): array|WP_Error
   {
      $result = $this->processDeleteFromSquare(['square_ids' => [$externalId]]);

      if (empty($result['success'])) {
         return new WP_Error('square_delete_failed', $result['result']['error'] ?? 'Delete failed');
      }

      return $result;
   }

   /**
    * Import from Square catalog → WordPress.
    * Called by IntegrationExecutor::processImport().
    */
   public function importFromService(array $data): array|WP_Error
   {
      $result = $this->processSyncFromSquare($data);

      if (empty($result['success'])) {
         return new WP_Error('square_import_failed', $result['result']['error'] ?? 'Import failed');
      }

      return $result;
   }

   /**
    * Sync customer to Square.
    * Called by IntegrationExecutor::processSyncCustomer().
    */
   public function syncCustomer(array $data): array|WP_Error
   {
      $result = $this->processSyncCustomer($data);

      if (empty($result['success'])) {
         return new WP_Error('square_customer_sync_failed', $result['result']['error'] ?? 'Customer sync failed');
      }

      return $result;
   }

   public function addDashboardPages():void
   {
      $page = JVB()->dashboard()->addPage('Your Orders', 'orders', 'receipt');
      $page->setScripts(['jvb-crud']);
   }
   public function renderDashPage():void
   {
      $instance = $this->determineInstance();

      $crud = new CRUDSkeleton();
      $crud->icon('receipt');
      $crud->title('Your Orders','Here you can see your past orders, and reorder from there if you\'d like');
      $crud->content($this->orderPostType, 'Order', 'Orders');
      $crud->addSearch();
      $crud->addCapabilities(['view']);
      $crud->setEmptyState(sprintf(
         '<div class="empty-state">
            <h3>%sNothing here%s</h3>
            <p>It doesn\'t look like you have any orders yet.</p>
            <p>Head on over to <a href="%s">our menu</a> and make your first order!</p>
         </div>',
         jvbDashIcon($crud->getIcon()),
         jvbDashIcon($crud->getIcon()),
         get_post_type_archive_link(BASE.'menu_item')
      ));


      $crud->render();
   }
   protected function determineInstance():self
   {
      if (current_user_can('manage_options')) {
         return self::$instances['base'];
      }
      return self::getInstance(get_current_user_id());
   }

   public function getOrderPost(string $order_id):int|false
   {
      $posts = new WP_Query([
         'post_type'       => BASE.$this->orderPostType,
         'posts_per_page'  => 1,
         'meta_key'        => BASE.'square_order_id',
         'meta_value'      => $order_id,
         'fields'       => 'ids',
      ]);
      wp_reset_postdata();
      return $posts->have_posts() ? $posts[0] : false;
   }
   public function getOrderHistory(int $user_id):array
   {
      $posts = new WP_Query([
         'post_type'       => BASE.$this->orderPostType,
         'posts_per_page'  => 25,
         'author'       => $user_id,
         'orderby'         => 'date',
         'order'           => 'desc',
         'fields'       => 'ids',
      ]);
      wp_reset_postdata();
      return array_map(function ($post) {
         $fields = Meta::forPost($post);
         $fields['wp_order_id'] = $post;
         return $fields;
      }, $posts->posts);

   }
}