@fleetbase/storefront-engine 0.4.7 → 0.4.9

package/addon/templates/networks/index/network/index.hbs

@@ -39,7 +39,11 @@
                 />
             </InputGroup>
 
-            <ContentPanel @title={{t "storefront.networks.index.network.index.general-network-settings-form.contact-social-panel.panel-title"}} @open={{false}} @pad={{false}} @wrapperClass="bordered-top">
+            <ContentPanel
+                @title={{t "storefront.networks.index.network.index.general-network-settings-form.contact-social-panel.panel-title"}}
+                @open={{false}}
+                @wrapperClass="bordered-classic"
+            >
                 <InputGroup @name={{t "storefront.networks.index.network.index.general-network-settings-form.contact-social-panel.phone"}}>
                     <PhoneInput @value={{@model.phone}} @onInput={{fn (mut @model.phone)}} class="form-input w-full" />
                 </InputGroup>
@@ -75,7 +79,11 @@
                 />
             </ContentPanel>
 
-            <ContentPanel @title={{t "storefront.networks.index.network.index.general-network-settings-form.logo-backdrop-panel.panel-title"}} @open={{false}} @pad={{false}} @wrapperClass="bordered-top">
+            <ContentPanel
+                @title={{t "storefront.networks.index.network.index.general-network-settings-form.logo-backdrop-panel.panel-title"}}
+                @open={{false}}
+                @wrapperClass="bordered-classic"
+            >
                 <InputGroup
                     @name={{t "storefront.networks.index.network.index.general-network-settings-form.logo-backdrop-panel.logo-label"}}
                     @helpText={{t "storefront.networks.index.network.index.general-network-settings-form.logo-backdrop-panel.logo-help-text"}}
@@ -125,12 +133,7 @@
                 </InputGroup>
             </ContentPanel>
 
-            <ContentPanel
-                @title={{t "storefront.networks.index.network.index.general-network-settings-form.alert-panel.panel-title"}}
-                @open={{false}}
-                @pad={{true}}
-                @panelBodyClass="bg-gray-800"
-            >
+            <ContentPanel @title={{t "storefront.networks.index.network.index.general-network-settings-form.alert-panel.panel-title"}} @open={{false}} @wrapperClass="bordered-classic">
                 <div>
                     <p class="dark:text-gray-100 mb-4">{{t "storefront.networks.index.network.index.general-network-settings-form.alert-panel.panel-description"}}</p>
                     <InputGroup @name={{t "storefront.networks.index.network.index.general-network-settings-form.alert-panel.new-order-alert-label"}} @wrapperClass="mb-0">
@@ -175,6 +178,25 @@
                         />
                     {{/if}}
                 </div>
+                <div class="input-group">
+                    <Toggle
+                        @isToggled={{@model.options.required_checkout_min}}
+                        @onToggle={{fn (mut @model.options.required_checkout_min)}}
+                        @helpText={{t "storefront.networks.index.network.index.general-network-settings-form.config-switches.minimum-order-amount-input-help-text"}}
+                    >
+                        <FaIcon @icon="dollar-sign" class="text-gray-600 dark:text-gray-400 mx-2" /><span class="dark:text-gray-100 text-sm">{{t
+                                "storefront.networks.index.network.index.general-network-settings-form.config-switches.enable-minimum-order-amount"
+                            }}</span>
+                    </Toggle>
+                    {{#if @model.options.required_checkout_min}}
+                        <MoneyInput
+                            @wrapperClass="mb-0 mt-2"
+                            @name={{t "storefront.networks.index.network.index.general-network-settings-form.config-switches.minimum-order-amount-input-label"}}
+                            @value={{@model.options.required_checkout_min_amount}}
+                            @currency={{@model.currency}}
+                        />
+                    {{/if}}
+                </div>
                 <div class="input-group">
                     <Toggle @isToggled={{@model.options.auto_accept_orders}} @onToggle={{fn (mut @model.options.auto_accept_orders)}}>
                         <FaIcon @icon="robot" class="text-gray-600 dark:text-gray-400 mx-2" /><span class="dark:text-gray-100 text-sm">{{t

package/addon/templates/networks/index/network.hbs

@@ -2,37 +2,16 @@
     <Overlay::Header @title={{t "storefront.networks.index.network.manage-network"}} @onPressCancel={{this.transitionBack}} />
     <Overlay::Body class="p-0i" @increaseInnerBodyHeightBy="0" @wrapperClass="space-y-4 pt-4">
         <div class="flex flex-col">
-            <div class="px-4 flex items-center section-header-title mb-4">
+            <div class="px-4 flex items-center section-header-title">
                 <FaIcon @icon="network-wired" @size="lg" class="text-sky-500 mr-3" />
                 <h3 class="text-lg font-semibold dark:text-white">
                     {{@model.name}}
                 </h3>
             </div>
-            <div class="section-header-actions w-full overflow-x-scroll lg:overflow-x-auto">
-                <div class="ui-tabs">
-                    <nav>
-                        <LinkTo @route="networks.index.network.index" class="ui-tab">
-                            <FaIcon @icon="cogs" class="mr-2" />
-                            <span>{{t "storefront.networks.index.network.settings"}}</span>
-                        </LinkTo>
-                        <LinkTo @route="networks.index.network.stores" class="ui-tab">
-                            <FaIcon @icon="store" class="mr-2" />
-                            <span>{{t "storefront.networks.index.network.stores.store"}}</span>
-                        </LinkTo>
-                        <LinkTo @route="networks.index.network.orders" class="ui-tab">
-                            <FaIcon @icon="file-invoice-dollar" class="mr-2" />
-                            <span>{{t "storefront.networks.index.network.orders"}}</span>
-                        </LinkTo>
-                        <LinkTo @route="networks.index.network.customers" class="ui-tab">
-                            <FaIcon @icon="users" class="mr-2" />
-                            <span>{{t "storefront.networks.index.network.customers"}}</span>
-                        </LinkTo>
-                    </nav>
-                </div>
-            </div>
         </div>
-
-        <div>{{outlet}}</div>
-        <Spacer @height="300px" />
+        <TabNavigation @tabs={{this.tabs}}>
+            {{outlet}}
+            <Spacer @height="400px" />
+        </TabNavigation>
     </Overlay::Body>
 </Overlay>

package/addon/templates/promotions/push-notifications.hbs

@@ -0,0 +1,85 @@
+<div class="overflow-y-scroll h-screen">
+    <div class="h-screen">
+        <main class="h-screen max-w-xl mx-auto pt-4">
+            <form class="h-screen" {{on "submit" this.sendPushNotification}}>
+                <div class="space-y-4 h-screen">
+                    <div>
+                        <h1 class="text-lg leading-6 font-bold text-gray-900 dark:text-gray-100">
+                            {{t "storefront.promotions.push-notifications.header"}}
+                        </h1>
+                        <p class="mt-1 text-sm text-gray-500">
+                            {{t "storefront.promotions.push-notifications.description"}}
+                        </p>
+                    </div>
+
+                    <InputGroup
+                        @name={{t "storefront.promotions.push-notifications.title-label"}}
+                        @value={{this.title}}
+                        @placeholder={{t "storefront.promotions.push-notifications.title-placeholder"}}
+                        @helpText={{t "storefront.promotions.push-notifications.title-help-text"}}
+                    />
+
+                    <InputGroup @name={{t "storefront.promotions.push-notifications.body-label"}} @helpText={{t "storefront.promotions.push-notifications.body-help-text"}}>
+                        <Textarea @value={{this.body}} placeholder={{t "storefront.promotions.push-notifications.body-placeholder"}} rows="4" class="form-input w-full" />
+                    </InputGroup>
+
+                    <div class="mb-4">
+                        <Toggle
+                            @isToggled={{this.selectAllCustomers}}
+                            @onToggle={{fn (mut this.selectAllCustomers)}}
+                            @wrapperClass="justify-start"
+                            @label={{t "storefront.promotions.push-notifications.select-all-customers"}}
+                            @helpText={{t "storefront.promotions.push-notifications.select-all-customers-help-text"}}
+                        />
+                    </div>
+
+                    {{#unless this.selectAllCustomers}}
+                        <InputGroup @name={{t "storefront.promotions.push-notifications.customers-label"}}>
+                            <ModelSelectMultiple
+                                @modelName="contact"
+                                @query={{hash type="customer"}}
+                                @selectedModel={{this.selectedCustomers}}
+                                @placeholder={{t "storefront.promotions.push-notifications.customers-placeholder"}}
+                                @infiniteScroll={{true}}
+                                @renderInPlace={{true}}
+                                @onChange={{fn (mut this.selectedCustomers)}}
+                                @triggerClass="form-select form-input w-full"
+                                as |model|
+                            >
+                                <div class="flex flex-row space-x-2">
+                                    <div class="hide-from-trigger">
+                                        <Image
+                                            src={{model.photo_url}}
+                                            @fallbackSrc={{config "defaultValues.customerImage"}}
+                                            alt={{model.name}}
+                                            height="40"
+                                            width="40"
+                                            class="h-10 w-10 rounded-lg shadow-sm"
+                                        />
+                                    </div>
+                                    <div>
+                                        <div class="font-semibold normalize-in-trigger">{{model.name}}</div>
+                                        <div class="text-xs hide-from-trigger">{{n-a model.email}}</div>
+                                        <div class="text-xs hide-from-trigger">{{n-a model.phone}}</div>
+                                    </div>
+                                </div>
+                            </ModelSelectMultiple>
+                        </InputGroup>
+                    {{/unless}}
+
+                    <div class="flex justify-end">
+                        <Button
+                            @type="primary"
+                            @icon={{if this.isLoading "spinner" "paper-plane"}}
+                            @iconPrefix={{if this.isLoading "fas fa-spin" "fas"}}
+                            @text={{t "storefront.promotions.push-notifications.send-button"}}
+                            @isLoading={{this.isLoading}}
+                            @disabled={{this.isLoading}}
+                            @onClick={{this.sendPushNotification}}
+                        />
+                    </div>
+                </div>
+            </form>
+        </main>
+    </div>
+</div>

package/addon/templates/promotions.hbs

@@ -0,0 +1,8 @@
+<TabNavigation @tabs={{this.tabs}} @contentClass="scrollable" @tablistClass="px-4 flex-row-reverse">
+    <:actions>
+        <h3 class="uppercase text-xs tracking-wide text-gray-700 dark:text-gray-400 font-semibold">{{t "storefront.promotions.title"}}</h3>
+    </:actions>
+    <:default>
+        {{outlet}}
+    </:default>
+</TabNavigation>

package/addon/templates/settings/index.hbs

@@ -254,6 +254,25 @@
                                 />
                             {{/if}}
                         </div>
+                        <div class="input-group">
+                            <Toggle
+                                @isToggled={{@model.options.required_checkout_min}}
+                                @onToggle={{fn (mut @model.options.required_checkout_min)}}
+                                @helpText={{t "storefront.settings.index.minimum-order-amount-help-text"}}
+                            >
+                                <FaIcon @icon="dollar-sign" class="text-gray-600 dark:text-gray-400 mx-2" /><span class="dark:text-gray-100 text-sm">{{t
+                                        "storefront.settings.index.enable-minimum-order-amount"
+                                    }}</span>
+                            </Toggle>
+                            {{#if @model.options.required_checkout_min}}
+                                <MoneyInput
+                                    @wrapperClass="mb-0 mt-2"
+                                    @name={{t "storefront.settings.index.minimum-order-amount"}}
+                                    @value={{@model.options.required_checkout_min_amount}}
+                                    @currency={{@model.currency}}
+                                />
+                            {{/if}}
+                        </div>
                         <div class="input-group">
                             <Toggle @isToggled={{@model.options.auto_accept_orders}} @onToggle={{fn (mut @model.options.auto_accept_orders)}}>
                                 <FaIcon @icon="robot" class="text-gray-600 dark:text-gray-400 mx-2" /><span class="dark:text-gray-100 text-sm">{{t

package/app/controllers/promotions/push-notifications.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/storefront-engine/controllers/promotions/push-notifications';

package/app/controllers/promotions.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/storefront-engine/controllers/promotions';

package/app/routes/promotions/push-notifications.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/storefront-engine/routes/promotions/push-notifications';

package/app/routes/promotions.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/storefront-engine/routes/promotions';

package/app/templates/promotions/push-notifications.hbs

@@ -0,0 +1 @@
+{{outlet}}

package/app/templates/promotions.hbs

@@ -0,0 +1 @@
+{{outlet}}

package/composer.json

@@ -1,6 +1,6 @@
 {
     "name": "fleetbase/storefront-api",
-    "version": "0.4.7",
+    "version": "0.4.9",
     "description": "Headless Commerce & Marketplace Extension for Fleetbase",
     "keywords": [
         "fleetbase-extension",

package/config/environment.js

@@ -29,7 +29,7 @@ function getMountedEngineRoutePrefix() {
         mountedEngineRoutePrefix = fleetbase.route;
     }
 
-    return `console.${mountedEngineRoutePrefix}.`;
+    return `console.${mountedEngineRoutePrefix}`;
 }
 
 function getenv(variable, defaultValue = null) {

package/extension.json

@@ -1,6 +1,6 @@
 {
     "name": "Storefront",
-    "version": "0.4.7",
+    "version": "0.4.9",
     "description": "Headless Commerce & Marketplace Extension for Fleetbase",
     "repository": "https://github.com/fleetbase/storefront",
     "license": "AGPL-3.0-or-later",

package/index.js

@@ -8,16 +8,6 @@ const path = require('path');
 module.exports = buildEngine({
     name,
 
-    postprocessTree(type, tree) {
-        if (type === 'css') {
-            tree = new Funnel(tree, {
-                exclude: ['**/@fleetbase/ember-ui/**/*.css'],
-            });
-        }
-
-        return tree;
-    },
-
     lazyLoading: {
         enabled: true,
     },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@fleetbase/storefront-engine",
-    "version": "0.4.7",
+    "version": "0.4.9",
     "description": "Headless Commerce & Marketplace Extension for Fleetbase",
     "fleetbase": {
         "route": "storefront",
@@ -44,9 +44,9 @@
     },
     "dependencies": {
         "@babel/core": "^7.23.2",
-        "@fleetbase/ember-core": "^0.3.6",
-        "@fleetbase/ember-ui": "^0.3.9",
-        "@fleetbase/fleetops-data": "^0.1.20",
+        "@fleetbase/ember-core": "^0.3.8",
+        "@fleetbase/ember-ui": "^0.3.14",
+        "@fleetbase/fleetops-data": "^0.1.23",
         "@fortawesome/ember-fontawesome": "^2.0.0",
         "@fortawesome/fontawesome-svg-core": "6.4.0",
         "@fortawesome/free-brands-svg-icons": "6.4.0",

package/server/src/Http/Controllers/ActionController.php

@@ -95,4 +95,65 @@ class ActionController extends Controller
 
         return response()->json($metrics);
     }
+
+    /**
+     * Send promotional push notification to selected customers.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function sendPushNotification(Request $request)
+    {
+        $title       = $request->input('title');
+        $body        = $request->input('body');
+        $customerIds = $request->input('customers', []);
+        $storeId     = $request->input('store');
+        $selectAll   = $request->boolean('select_all', false);
+
+        // Validate inputs
+        if (!$title || !$body) {
+            return response()->json(['error' => 'Title and body are required'], 400);
+        }
+
+        if (!$selectAll && empty($customerIds)) {
+            return response()->json(['error' => 'At least one customer must be selected'], 400);
+        }
+
+        // Get the store
+        $store = Store::where('public_id', $storeId)->first();
+        if (!$store) {
+            return response()->json(['error' => 'Store not found'], 404);
+        }
+
+        // Get customers
+        if ($selectAll) {
+            // Get all customers for this store's company
+            $customers = Contact::where('company_uuid', session('company'))
+                ->where('type', 'customer')
+                ->get();
+        } else {
+            // Get only selected customers
+            $customers = Contact::whereIn('uuid', $customerIds)
+                ->where('company_uuid', session('company'))
+                ->where('type', 'customer')
+                ->get();
+        }
+
+        // Send notifications
+        $sentCount = 0;
+        foreach ($customers as $customer) {
+            try {
+                $customer->notify(new \Fleetbase\Storefront\Notifications\PromotionalPushNotification($title, $body, $store));
+                $sentCount++;
+            } catch (\Exception $e) {
+                // Log error but continue with other customers
+                \Log::error('Failed to send push notification to customer: ' . $customer->uuid, ['error' => $e->getMessage()]);
+            }
+        }
+
+        return response()->json([
+            'status'     => 'OK',
+            'sent_count' => $sentCount,
+            'total'      => count($customers),
+        ]);
+    }
 }

package/server/src/Http/Controllers/v1/CheckoutController.php

@@ -63,7 +63,7 @@ class CheckoutController extends Controller
 
         // handle cash orders
         if ($isCashOnDelivery) {
-            return static::initializeCashCheckout($customer, $gateway, $serviceQuote, $cart, $checkoutOptions);
+            return static::initializeCashCheckout($customer, $gateway, $serviceQuote, $cart, $checkoutOptions, $request);
         }
 
         if (!$gateway) {
@@ -72,18 +72,18 @@ class CheckoutController extends Controller
 
         // handle checkout initialization based on gateway
         if ($gateway->isStripeGateway) {
-            return static::initializeStripeCheckout($customer, $gateway, $serviceQuote, $cart, $checkoutOptions);
+            return static::initializeStripeCheckout($customer, $gateway, $serviceQuote, $cart, $checkoutOptions, $request);
         }
 
         // handle checkout initialization based on gateway
         if ($gateway->isQPayGateway) {
-            return static::initializeQPayCheckout($customer, $gateway, $serviceQuote, $cart, $checkoutOptions);
+            return static::initializeQPayCheckout($customer, $gateway, $serviceQuote, $cart, $checkoutOptions, $request);
         }
 
         return response()->apiError('Unable to initialize checkout!');
     }
 
-    public static function initializeCashCheckout(Contact $customer, Gateway $gateway, ServiceQuote $serviceQuote, Cart $cart, $checkoutOptions)
+    public static function initializeCashCheckout(Contact $customer, Gateway $gateway, ServiceQuote $serviceQuote, Cart $cart, $checkoutOptions, $request)
     {
         // check if pickup order
         $isPickup = $checkoutOptions->is_pickup;
@@ -132,7 +132,7 @@ class CheckoutController extends Controller
         ]);
     }
 
-    public static function initializeStripeCheckout(Contact $customer, Gateway $gateway, ?ServiceQuote $serviceQuote, Cart $cart, $checkoutOptions)
+    public static function initializeStripeCheckout(Contact $customer, Gateway $gateway, ?ServiceQuote $serviceQuote, Cart $cart, $checkoutOptions, $request)
     {
         // check if pickup order
         $isPickup = $checkoutOptions->is_pickup;
@@ -416,7 +416,7 @@ class CheckoutController extends Controller
         ]);
     }
 
-    public static function initializeQPayCheckout(Contact $customer, Gateway $gateway, ?ServiceQuote $serviceQuote, Cart $cart, $checkoutOptions)
+    public static function initializeQPayCheckout(Contact $customer, Gateway $gateway, ?ServiceQuote $serviceQuote, Cart $cart, $checkoutOptions, $request)
     {
         // Get store info
         $about = Storefront::about();
@@ -424,6 +424,12 @@ class CheckoutController extends Controller
         // check if pickup order
         $isPickup = $checkoutOptions->is_pickup;
 
+        // Get ebarimt company registration number if any
+        $ebarimtRegistationNumber = $request->ebarimt_registration_no ?? '';
+        if ($ebarimtRegistationNumber) {
+            $customer->updateMeta('ebarimt_registration_no', $ebarimtRegistationNumber);
+        }
+
         // get amount/subtotal
         $amount   = static::calculateCheckoutAmount($cart, $serviceQuote, $checkoutOptions);
         $currency = $cart->getCurrency();
@@ -470,6 +476,7 @@ class CheckoutController extends Controller
         $callbackUrl = Utils::apiUrl('storefront/v1/checkouts/capture-qpay', $callbackParams);
 
         // Create invoice description
+        $taxType             = '1'; // Start with VAT required
         $ebarimtInvoiceCode  = $gateway->sandbox ? 'TEST_INVOICE' : $gateway->config?->ebarimt_invoice_id ?? null;
         $invoiceAmount       = $amount;
         $invoiceCode         = $gateway->sandbox ? 'TEST_INVOICE' : $gateway->config?->invoice_id ?? null;
@@ -478,18 +485,25 @@ class CheckoutController extends Controller
         $senderInvoiceNo     = $checkout->public_id;
         $districtCode        = $gateway->config?->district_code ?? null;
         $invoiceReceiverData = Utils::filterArray([
+            'register' => $ebarimtRegistationNumber,
             'name'     => $customer->name,
             'email'    => $customer->email ?? null,
             'phone'    => $customer->phone ?? null,
         ]);
+
+        // Create QPay line items
         $lines = QPay::createQpayInitialLines($cart, $serviceQuote, $checkoutOptions);
         foreach ($cart->items as $item) {
-            $lines[] = [
+            $classificationCode = QPay::getCartItemClassificationCode($item);
+            $isVatExempt        = QPay::isTaxFreeClassificationCode($classificationCode);
+
+            $line = [
                 'line_description'    => $item->name,
                 'line_quantity'       => number_format($item->quantity ?? 1, 2, '.', ''),
                 'line_unit_price'     => number_format($item->price, 2, '.', ''),
                 'note'                => $checkout->public_id,
-                'classification_code' => '6511100',
+                'classification_code' => $classificationCode,
+                'tax_product_code'    => QPay::getCartItemTaxProductCode($item),
                 'taxes'               => [
                     [
                         'tax_code'    => 'VAT',
@@ -499,12 +513,14 @@ class CheckoutController extends Controller
                     ],
                 ],
             ];
+
+            $lines[] = $line;
         }
 
         // Create qpay invoice
         $invoice = null;
         if ($ebarimtInvoiceCode) {
-            $invoice = $qpay->createEbarimtInvoice($ebarimtInvoiceCode, $senderInvoiceNo, $invoiceReceiverCode, $invoiceReceiverData, $invoiceDescription, '1', $districtCode, $lines);
+            $invoice = $qpay->createEbarimtInvoice($ebarimtInvoiceCode, $senderInvoiceNo, $invoiceReceiverCode, $invoiceReceiverData, $invoiceDescription, $taxType, $districtCode, $lines);
         } else {
             $invoice = $qpay->createSimpleInvoice($invoiceAmount, $invoiceCode, $invoiceDescription, $invoiceReceiverCode, $senderInvoiceNo, $callbackUrl);
         }

package/server/src/Models/Cart.php

@@ -332,6 +332,7 @@ class Cart extends StorefrontModel
             'subtotal'          => $subtotal,
             'variants'          => $variants,
             'addons'            => $addons,
+            'meta'              => $product->meta ?? [],
         ];
 
         // If item was added from a food truck
@@ -677,7 +678,7 @@ class Cart extends StorefrontModel
      */
     public static function findProduct(string $id): ?Product
     {
-        return Product::select(['uuid', 'store_uuid', 'public_id', 'name', 'description', 'price', 'currency', 'sale_price', 'is_on_sale'])->where(['public_id' => $id])->with([])->first();
+        return Product::select(['uuid', 'store_uuid', 'public_id', 'name', 'description', 'price', 'currency', 'sale_price', 'is_on_sale', 'meta'])->where(['public_id' => $id])->with([])->first();
     }
 
     public function getCurrency(?string $fallbackCurrency = null): ?string

package/server/src/Models/Network.php

@@ -3,6 +3,7 @@
 namespace Fleetbase\Storefront\Models;
 
 use Fleetbase\Casts\Json;
+use Fleetbase\Casts\Money;
 use Fleetbase\FleetOps\Models\OrderConfig;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\Models\Category;
@@ -228,6 +229,30 @@ class Network extends StorefrontModel
         return $this->stores()->count();
     }
 
+    /**
+     * Mutator for the `options` attribute.
+     * Allows special handling for nested keys while keeping JSON casting intact.
+     */
+    public function setOptionsAttribute($value)
+    {
+        // Ensure we operate on a PHP array
+        if (is_string($value)) {
+            $value = json_decode($value, true) ?? [];
+        }
+
+        if (!is_array($value)) {
+            $value = [];
+        }
+
+        // Special handling for `required_checkout_min_amount`
+        if (array_key_exists('required_checkout_min_amount', $value)) {
+            $value['required_checkout_min_amount'] = Money::apply($value['required_checkout_min_amount']);
+        }
+
+        // Assign the array back — JSON cast handles encoding
+        $this->attributes['options'] = $value;
+    }
+
     /**
      * Adds a new store to the network.
      */

package/server/src/Models/Store.php

@@ -3,6 +3,7 @@
 namespace Fleetbase\Storefront\Models;
 
 use Fleetbase\Casts\Json;
+use Fleetbase\Casts\Money;
 use Fleetbase\FleetOps\Models\OrderConfig;
 use Fleetbase\FleetOps\Models\Place;
 use Fleetbase\Models\Category;
@@ -292,6 +293,30 @@ class Store extends StorefrontModel
             ->wherePivotNull('deleted_at');
     }
 
+    /**
+     * Mutator for the `options` attribute.
+     * Allows special handling for nested keys while keeping JSON casting intact.
+     */
+    public function setOptionsAttribute($value)
+    {
+        // Ensure we operate on a PHP array
+        if (is_string($value)) {
+            $value = json_decode($value, true) ?? [];
+        }
+
+        if (!is_array($value)) {
+            $value = [];
+        }
+
+        // Special handling for `required_checkout_min_amount`
+        if (array_key_exists('required_checkout_min_amount', $value)) {
+            $value['required_checkout_min_amount'] = Money::apply($value['required_checkout_min_amount']);
+        }
+
+        // Assign the array back — JSON cast handles encoding
+        $this->attributes['options'] = $value;
+    }
+
     /**
      * @var string
      */