feat(static-assets): cache-bust JS/CSS via ?v=<commit-sha>, immutable in prod

Adds a `static_v(request, name, path=...)` Jinja helper that appends
?v=<commit-sha> from app.core.build_info, plus a CachedStaticFiles
subclass that serves Cache-Control: public, max-age=31536000, immutable
in production and no-cache in development. Browsers refetch JS/CSS
automatically on every deploy without the user having to hard-reload.

- New: app/core/static_files.py (CachedStaticFiles)
- Updated: app/templates_config.py (static_v helper)
- Updated: main.py (use CachedStaticFiles for *_static mounts)
- Codemod: 143 url_for('*_static', path='*.js'|'*.css') → static_v(...)
  across 123 templates. Images/fonts/JSON locales intentionally
  unchanged (out of scope).
- Arch rule: FE-024 (warning) flags raw url_for on JS/CSS to prevent
  drift. Note: FE-008 was already taken by the number_stepper rule.
- docs/proposals/static-asset-cache-busting.md marked Done.

Closes plan from docs/proposals/static-asset-cache-busting.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.architecture-rules/frontend.yaml

@@ -936,6 +936,33 @@ frontend_component_rules:
       encouraged_patterns:
         - "{% from 'shared/macros/shop/trust-badges.html' import"
 
+  - id: "FE-024"
+    name: "Use static_v() for JS/CSS, not raw url_for()"
+    severity: "warning"
+    description: |
+      Static .js and .css URLs must use the cache-busting `static_v()` helper
+      so browsers refetch automatically after each deploy. The helper appends
+      `?v=<commit-sha>` from app.core.build_info — same SHA across one deploy,
+      flips on the next.
+
+      WRONG (browser keeps cached file after deploy):
+        <script src="{{ url_for('foo_static', path='admin/js/app.js') }}"></script>
+        <link href="{{ url_for('foo_static', path='admin/css/site.css') }}" rel="stylesheet">
+
+      RIGHT:
+        <script src="{{ static_v(request, 'foo_static', path='admin/js/app.js') }}"></script>
+        <link href="{{ static_v(request, 'foo_static', path='admin/css/site.css') }}" rel="stylesheet">
+
+      Images, fonts, and JSON locale files are intentionally out of scope —
+      keep using `url_for()` for those.
+    pattern:
+      file_pattern: "app/**/templates/**/*.html"
+      anti_patterns:
+        - "url_for\\(\\s*['\"]\\w+_static['\"]\\s*,\\s*path=['\"][^'\"]+\\.(?:js|css)['\"]"
+      exceptions:
+        - "base.html"
+        - "partials/"
+
 # ============================================================================
 # FRONTEND STYLING RULES
 # ============================================================================

app/core/static_files.py

@@ -0,0 +1,31 @@
+# app/core/static_files.py
+"""Static file serving with cache-busting-aware headers.
+
+In production, JS/CSS/etc. URLs are versioned by `static_v(...)` in
+`app/templates_config.py` (appends `?v=<commit-sha>`), so the file at a
+given URL never changes within a deploy. We can therefore tell browsers
+to cache it for a year and skip revalidation.
+
+In development the version still flips per commit, but the developer often
+edits files without committing, so we serve `no-cache` to force conditional
+GETs (the browser still gets a 304 when nothing changed).
+"""
+
+from fastapi.staticfiles import StaticFiles
+from starlette.responses import FileResponse
+
+from app.core.environment import is_development
+
+_IMMUTABLE = "public, max-age=31536000, immutable"
+_NO_CACHE = "no-cache"
+
+
+class CachedStaticFiles(StaticFiles):
+    """StaticFiles that sets Cache-Control based on environment."""
+
+    def file_response(self, *args, **kwargs) -> FileResponse:
+        response = super().file_response(*args, **kwargs)
+        response.headers["Cache-Control"] = (
+            _NO_CACHE if is_development() else _IMMUTABLE
+        )
+        return response

app/modules/analytics/templates/analytics/store/analytics.html

@@ -227,5 +227,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('analytics_static', path='store/js/analytics.js') }}"></script>
+<script defer src="{{ static_v(request, 'analytics_static', path='store/js/analytics.js') }}"></script>
 {% endblock %}

app/modules/billing/templates/billing/admin/billing-history.html

@@ -203,5 +203,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('billing_static', path='admin/js/billing-history.js') }}"></script>
+<script defer src="{{ static_v(request, 'billing_static', path='admin/js/billing-history.js') }}"></script>
 {% endblock %}

app/modules/billing/templates/billing/admin/subscription-tiers.html

@@ -474,5 +474,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('billing_static', path='admin/js/subscription-tiers.js') }}"></script>
+<script defer src="{{ static_v(request, 'billing_static', path='admin/js/subscription-tiers.js') }}"></script>
 {% endblock %}

app/modules/billing/templates/billing/admin/subscriptions.html

@@ -316,5 +316,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('billing_static', path='admin/js/subscriptions.js') }}"></script>
+<script defer src="{{ static_v(request, 'billing_static', path='admin/js/subscriptions.js') }}"></script>
 {% endblock %}

app/modules/catalog/templates/catalog/admin/store-product-create.html

@@ -465,6 +465,6 @@
     document.head.appendChild(script);
 })();
 </script>
-<script defer src="{{ url_for('cms_static', path='shared/js/media-picker.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='shared/js/media-picker.js') }}"></script>
-<script defer src="{{ url_for('catalog_static', path='admin/js/product-create.js') }}"></script>
+<script defer src="{{ static_v(request, 'catalog_static', path='admin/js/product-create.js') }}"></script>
 {% endblock %}

app/modules/catalog/templates/catalog/admin/store-product-detail.html

@@ -354,5 +354,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('catalog_static', path='admin/js/product-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'catalog_static', path='admin/js/product-detail.js') }}"></script>
 {% endblock %}

app/modules/catalog/templates/catalog/admin/store-product-edit.html

@@ -498,6 +498,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('cms_static', path='shared/js/media-picker.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='shared/js/media-picker.js') }}"></script>
-<script defer src="{{ url_for('catalog_static', path='admin/js/product-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'catalog_static', path='admin/js/product-edit.js') }}"></script>
 {% endblock %}

app/modules/catalog/templates/catalog/admin/store-products.html

@@ -336,5 +336,5 @@
     document.head.appendChild(script);
 })();
 </script>
-<script defer src="{{ url_for('catalog_static', path='admin/js/products.js') }}"></script>
+<script defer src="{{ static_v(request, 'catalog_static', path='admin/js/products.js') }}"></script>
 {% endblock %}

app/modules/catalog/templates/catalog/store/product-create.html

@@ -170,5 +170,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('catalog_static', path='store/js/product-create.js') }}"></script>
+<script defer src="{{ static_v(request, 'catalog_static', path='store/js/product-create.js') }}"></script>
 {% endblock %}

app/modules/catalog/templates/catalog/store/products.html

@@ -364,5 +364,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('catalog_static', path='store/js/products.js') }}"></script>
+<script defer src="{{ static_v(request, 'catalog_static', path='store/js/products.js') }}"></script>
 {% endblock %}

app/modules/cms/templates/cms/admin/content-page-edit.html

@@ -701,5 +701,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('cms_static', path='admin/js/content-page-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='admin/js/content-page-edit.js') }}"></script>
 {% endblock %}

app/modules/cms/templates/cms/admin/content-pages.html

@@ -201,5 +201,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('cms_static', path='admin/js/content-pages.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='admin/js/content-pages.js') }}"></script>
 {% endblock %}

app/modules/cms/templates/cms/admin/store-theme.html

@@ -459,5 +459,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('cms_static', path='admin/js/store-theme.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='admin/js/store-theme.js') }}"></script>
 {% endblock %}

app/modules/cms/templates/cms/admin/store-themes.html

@@ -125,5 +125,5 @@
 
 {% block extra_scripts %}
 <script defer src="https://cdn.jsdelivr.net/npm/tom-select@2.3.1/dist/js/tom-select.complete.min.js"></script>
-<script defer src="{{ url_for('cms_static', path='admin/js/store-themes.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='admin/js/store-themes.js') }}"></script>
 {% endblock %}

app/modules/cms/templates/cms/store/content-page-edit.html

@@ -333,5 +333,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('cms_static', path='store/js/content-page-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='store/js/content-page-edit.js') }}"></script>
 {% endblock %}

app/modules/cms/templates/cms/store/content-pages.html

@@ -335,5 +335,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('cms_static', path='store/js/content-pages.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='store/js/content-pages.js') }}"></script>
 {% endblock %}

app/modules/cms/templates/cms/store/media.html

@@ -452,5 +452,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('cms_static', path='store/js/media.js') }}"></script>
+<script defer src="{{ static_v(request, 'cms_static', path='store/js/media.js') }}"></script>
 {% endblock %}

app/modules/core/templates/core/admin/dashboard.html

@@ -137,5 +137,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('core_static', path='admin/js/dashboard.js') }}"></script>
+<script defer src="{{ static_v(request, 'core_static', path='admin/js/dashboard.js') }}"></script>
 {% endblock %}

app/modules/core/templates/core/admin/settings.html

@@ -816,5 +816,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('core_static', path='admin/js/settings.js') }}"></script>
+<script defer src="{{ static_v(request, 'core_static', path='admin/js/settings.js') }}"></script>
 {% endblock %}

app/modules/core/templates/core/store/dashboard.html

@@ -180,5 +180,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('core_static', path='store/js/dashboard.js') }}"></script>
+<script defer src="{{ static_v(request, 'core_static', path='store/js/dashboard.js') }}"></script>
 {% endblock %}

app/modules/customers/templates/customers/admin/customers.html

@@ -217,5 +217,5 @@
     document.head.appendChild(script);
 })();
 </script>
-<script defer src="{{ url_for('customers_static', path='admin/js/customers.js') }}"></script>
+<script defer src="{{ static_v(request, 'customers_static', path='admin/js/customers.js') }}"></script>
 {% endblock %}

app/modules/customers/templates/customers/store/customer-detail.html

@@ -174,5 +174,5 @@
         customerId: {{ customer_id }}
     };
 </script>
-<script defer src="{{ url_for('customers_static', path='store/js/customer-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'customers_static', path='store/js/customer-detail.js') }}"></script>
 {% endblock %}

app/modules/customers/templates/customers/store/customers.html

@@ -210,5 +210,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('customers_static', path='store/js/customers.js') }}"></script>
+<script defer src="{{ static_v(request, 'customers_static', path='store/js/customers.js') }}"></script>
 {% endblock %}

app/modules/dev_tools/templates/dev_tools/admin/code-quality-dashboard.html

@@ -9,7 +9,7 @@
 {% block alpine_data %}codeQualityDashboard(){% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('dev_tools_static', path='admin/js/code-quality-dashboard.js') }}"></script>
+<script defer src="{{ static_v(request, 'dev_tools_static', path='admin/js/code-quality-dashboard.js') }}"></script>
 {% endblock %}
 
 {% block content %}

app/modules/dev_tools/templates/dev_tools/admin/code-quality-violations.html

@@ -10,7 +10,7 @@
 {% block alpine_data %}codeQualityViolations(){% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('dev_tools_static', path='admin/js/code-quality-violations.js') }}"></script>
+<script defer src="{{ static_v(request, 'dev_tools_static', path='admin/js/code-quality-violations.js') }}"></script>
 {% endblock %}
 
 {% block content %}

app/modules/dev_tools/templates/dev_tools/admin/components.html

@@ -3173,5 +3173,5 @@ new Chart(document.getElementById('barChart'), barConfig);
 
 {% block extra_scripts %}
 {# ✅ CRITICAL: Load JavaScript file #}
-<script defer src="{{ url_for('dev_tools_static', path='admin/js/components.js') }}"></script>
+<script defer src="{{ static_v(request, 'dev_tools_static', path='admin/js/components.js') }}"></script>
 {% endblock %}

app/modules/dev_tools/templates/dev_tools/admin/icons.html

@@ -318,5 +318,5 @@
 
 {% block extra_scripts %}
 {# ✅ CRITICAL: Load JavaScript file #}
-<script defer src="{{ url_for('dev_tools_static', path='admin/js/icons-page.js') }}"></script>
+<script defer src="{{ static_v(request, 'dev_tools_static', path='admin/js/icons-page.js') }}"></script>
 {% endblock %}

app/modules/dev_tools/templates/dev_tools/admin/sql-query.html

@@ -274,5 +274,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('dev_tools_static', path='admin/js/sql-query.js') }}"></script>
+<script defer src="{{ static_v(request, 'dev_tools_static', path='admin/js/sql-query.js') }}"></script>
 {% endblock %}

app/modules/dev_tools/templates/dev_tools/admin/testing-dashboard.html

@@ -8,7 +8,7 @@
 {% block alpine_data %}testingDashboard(){% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('dev_tools_static', path='admin/js/testing-dashboard.js') }}"></script>
+<script defer src="{{ static_v(request, 'dev_tools_static', path='admin/js/testing-dashboard.js') }}"></script>
 {% endblock %}
 
 {% block content %}

app/modules/dev_tools/templates/dev_tools/admin/testing-hub.html

@@ -218,5 +218,5 @@
 
 {% block extra_scripts %}
 {# ✅ CRITICAL: Load JavaScript file #}
-<script defer src="{{ url_for('dev_tools_static', path='admin/js/testing-hub.js') }}"></script>
+<script defer src="{{ static_v(request, 'dev_tools_static', path='admin/js/testing-hub.js') }}"></script>
 {% endblock %}

app/modules/dev_tools/templates/dev_tools/admin/translation-editor.html

@@ -159,5 +159,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('dev_tools_static', path='admin/js/translation-editor.js') }}"></script>
+<script defer src="{{ static_v(request, 'dev_tools_static', path='admin/js/translation-editor.js') }}"></script>
 {% endblock %}

app/modules/inventory/templates/inventory/admin/inventory.html

@@ -599,5 +599,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('inventory_static', path='admin/js/inventory.js') }}"></script>
+<script defer src="{{ static_v(request, 'inventory_static', path='admin/js/inventory.js') }}"></script>
 {% endblock %}

app/modules/inventory/templates/inventory/store/inventory.html

@@ -370,5 +370,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('inventory_static', path='store/js/inventory.js') }}"></script>
+<script defer src="{{ static_v(request, 'inventory_static', path='store/js/inventory.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/analytics.html

@@ -175,5 +175,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-analytics.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-analytics.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/merchant-card-detail.html

@@ -21,6 +21,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-card-detail-view.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-card-detail-view.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-merchant-card-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-merchant-card-detail.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/merchant-cards.html

@@ -23,6 +23,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-cards-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-cards-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-merchant-cards.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-merchant-cards.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/merchant-detail.html

@@ -428,5 +428,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-merchant-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-merchant-detail.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/merchant-devices.html

@@ -22,6 +22,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-devices-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-devices-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-merchant-devices.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-merchant-devices.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/merchant-pins.html

@@ -22,6 +22,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-pins-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-pins-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-merchant-pins.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-merchant-pins.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/merchant-settings.html

@@ -178,5 +178,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-merchant-settings.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-merchant-settings.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/merchant-transactions.html

@@ -21,6 +21,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-transactions-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-transactions-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-merchant-transactions.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-merchant-transactions.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/program-edit.html

@@ -41,6 +41,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-program-form.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-program-form.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-program-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-program-edit.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/admin/programs.html

@@ -342,5 +342,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='admin/js/loyalty-programs.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='admin/js/loyalty-programs.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/merchant/analytics.html

@@ -63,5 +63,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='merchant/js/loyalty-analytics.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='merchant/js/loyalty-analytics.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/merchant/card-detail.html

@@ -25,6 +25,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-card-detail-view.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-card-detail-view.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='merchant/js/loyalty-card-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='merchant/js/loyalty-card-detail.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/merchant/cards.html

@@ -29,6 +29,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-cards-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-cards-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='merchant/js/loyalty-cards.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='merchant/js/loyalty-cards.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/merchant/devices.html

@@ -31,6 +31,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-devices-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-devices-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='merchant/js/loyalty-devices.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='merchant/js/loyalty-devices.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/merchant/pins.html

@@ -33,6 +33,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-pins-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-pins-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='merchant/js/loyalty-pins.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='merchant/js/loyalty-pins.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/merchant/program-edit.html

@@ -39,6 +39,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-program-form.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-program-form.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='merchant/js/loyalty-settings.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='merchant/js/loyalty-settings.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/merchant/settings.html

@@ -85,5 +85,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='merchant/js/loyalty-merchant-settings.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='merchant/js/loyalty-merchant-settings.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/merchant/transactions.html

@@ -27,6 +27,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-transactions-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-transactions-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='merchant/js/loyalty-transactions.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='merchant/js/loyalty-transactions.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/store/analytics.html

@@ -156,5 +156,5 @@
 
 {% block extra_scripts %}
 <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.1/dist/chart.umd.min.js"></script>
-<script defer src="{{ url_for('loyalty_static', path='store/js/loyalty-analytics.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='store/js/loyalty-analytics.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/store/card-detail.html

@@ -201,5 +201,5 @@ window._cardDetailLabels = {
     }
 };
 </script>
-<script defer src="{{ url_for('loyalty_static', path='store/js/loyalty-card-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='store/js/loyalty-card-detail.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/store/cards.html

@@ -167,5 +167,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='store/js/loyalty-cards.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='store/js/loyalty-cards.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/store/enroll.html

@@ -147,5 +147,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='store/js/loyalty-enroll.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='store/js/loyalty-enroll.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/store/pins.html

@@ -44,6 +44,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-pins-list.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-pins-list.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='store/js/loyalty-pins.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='store/js/loyalty-pins.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/store/settings.html

@@ -61,6 +61,6 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='shared/js/loyalty-program-form.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='shared/js/loyalty-program-form.js') }}"></script>
-<script defer src="{{ url_for('loyalty_static', path='store/js/loyalty-settings.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='store/js/loyalty-settings.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/store/terminal.html

@@ -407,5 +407,5 @@ window._txLabels = {
     reward_redeemed: {{ _('loyalty.transactions.reward_redeemed')|tojson }},
 };
 </script>
-<script defer src="{{ url_for('loyalty_static', path='store/js/loyalty-terminal.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='store/js/loyalty-terminal.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/storefront/dashboard.html

@@ -232,5 +232,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='storefront/js/loyalty-dashboard.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='storefront/js/loyalty-dashboard.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/storefront/enroll.html

@@ -170,5 +170,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='storefront/js/loyalty-enroll.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='storefront/js/loyalty-enroll.js') }}"></script>
 {% endblock %}

app/modules/loyalty/templates/loyalty/storefront/history.html

@@ -105,5 +105,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('loyalty_static', path='storefront/js/loyalty-history.js') }}"></script>
+<script defer src="{{ static_v(request, 'loyalty_static', path='storefront/js/loyalty-history.js') }}"></script>
 {% endblock %}

app/modules/marketplace/templates/marketplace/admin/background-tasks.html

@@ -8,7 +8,7 @@
 {% block alpine_data %}backgroundTasks(){% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('marketplace_static', path='admin/js/background-tasks.js') }}"></script>
+<script defer src="{{ static_v(request, 'marketplace_static', path='admin/js/background-tasks.js') }}"></script>
 {% endblock %}
 
 {% block content %}

app/modules/marketplace/templates/marketplace/admin/imports.html

@@ -11,7 +11,7 @@
 {% block alpine_data %}adminImports(){% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('marketplace_static', path='admin/js/imports.js') }}"></script>
+<script defer src="{{ static_v(request, 'marketplace_static', path='admin/js/imports.js') }}"></script>
 {% endblock %}
 
 {% block content %}

app/modules/marketplace/templates/marketplace/admin/letzshop-store-directory.html

@@ -426,5 +426,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('marketplace_static', path='admin/js/letzshop-store-directory.js') }}"></script>
+<script defer src="{{ static_v(request, 'marketplace_static', path='admin/js/letzshop-store-directory.js') }}"></script>
 {% endblock %}

app/modules/marketplace/templates/marketplace/admin/letzshop.html

@@ -11,7 +11,7 @@
 {% block alpine_data %}adminLetzshop(){% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('marketplace_static', path='admin/js/letzshop.js') }}"></script>
+<script defer src="{{ static_v(request, 'marketplace_static', path='admin/js/letzshop.js') }}"></script>
 {% endblock %}
 
 {% block content %}

app/modules/marketplace/templates/marketplace/admin/marketplace-letzshop.html

@@ -570,5 +570,5 @@
     document.head.appendChild(script);
 })();
 </script>
-<script defer src="{{ url_for('marketplace_static', path='admin/js/marketplace-letzshop.js') }}"></script>
+<script defer src="{{ static_v(request, 'marketplace_static', path='admin/js/marketplace-letzshop.js') }}"></script>
 {% endblock %}

app/modules/marketplace/templates/marketplace/admin/marketplace-product-detail.html

@@ -388,5 +388,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('marketplace_static', path='admin/js/marketplace-product-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'marketplace_static', path='admin/js/marketplace-product-detail.js') }}"></script>
 {% endblock %}

app/modules/marketplace/templates/marketplace/admin/marketplace-products.html

@@ -412,5 +412,5 @@
     document.head.appendChild(script);
 })();
 </script>
-<script defer src="{{ url_for('marketplace_static', path='admin/js/marketplace-products.js') }}"></script>
+<script defer src="{{ static_v(request, 'marketplace_static', path='admin/js/marketplace-products.js') }}"></script>
 {% endblock %}

app/modules/marketplace/templates/marketplace/admin/marketplace.html

@@ -347,5 +347,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('marketplace_static', path='admin/js/marketplace.js') }}?v=2"></script>
+<script defer src="{{ static_v(request, 'marketplace_static', path='admin/js/marketplace.js') }}?v=2"></script>
 {% endblock %}

app/modules/marketplace/templates/marketplace/store/onboarding.html

@@ -378,6 +378,6 @@
     <script defer src="{{ url_for('static', path='shared/js/utils.js') }}"></script>
     <script defer src="{{ url_for('static', path='shared/js/api-client.js') }}"></script>
     <script defer src="https://cdn.jsdelivr.net/npm/alpinejs@3.14.0/dist/cdn.min.js"></script>
-    <script defer src="{{ url_for('marketplace_static', path='store/js/onboarding.js') }}"></script>
+    <script defer src="{{ static_v(request, 'marketplace_static', path='store/js/onboarding.js') }}"></script>
 </body>
 </html>

app/modules/messaging/templates/messaging/admin/email-logs.html

@@ -347,5 +347,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('messaging_static', path='admin/js/email-logs.js') }}"></script>
+<script defer src="{{ static_v(request, 'messaging_static', path='admin/js/email-logs.js') }}"></script>
 {% endblock %}

app/modules/messaging/templates/messaging/admin/email-templates.html

@@ -364,5 +364,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('messaging_static', path='admin/js/email-templates.js') }}"></script>
+<script defer src="{{ static_v(request, 'messaging_static', path='admin/js/email-templates.js') }}"></script>
 {% endblock %}

app/modules/messaging/templates/messaging/admin/messages.html

@@ -335,5 +335,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('messaging_static', path='admin/js/messages.js') }}"></script>
+<script defer src="{{ static_v(request, 'messaging_static', path='admin/js/messages.js') }}"></script>
 {% endblock %}

app/modules/messaging/templates/messaging/admin/notifications.html

@@ -361,5 +361,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('messaging_static', path='admin/js/notifications.js') }}"></script>
+<script defer src="{{ static_v(request, 'messaging_static', path='admin/js/notifications.js') }}"></script>
 {% endblock %}

app/modules/messaging/templates/messaging/store/email-templates.html

@@ -329,5 +329,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('messaging_static', path='store/js/email-templates.js') }}"></script>
+<script defer src="{{ static_v(request, 'messaging_static', path='store/js/email-templates.js') }}"></script>
 {% endblock %}

app/modules/messaging/templates/messaging/store/messages.html

@@ -278,5 +278,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('messaging_static', path='store/js/messages.js') }}"></script>
+<script defer src="{{ static_v(request, 'messaging_static', path='store/js/messages.js') }}"></script>
 {% endblock %}

app/modules/messaging/templates/messaging/store/notifications.html

@@ -229,5 +229,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('messaging_static', path='store/js/notifications.js') }}"></script>
+<script defer src="{{ static_v(request, 'messaging_static', path='store/js/notifications.js') }}"></script>
 {% endblock %}

app/modules/monitoring/templates/monitoring/admin/logs.html

@@ -407,5 +407,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('monitoring_static', path='admin/js/logs.js') }}"></script>
+<script defer src="{{ static_v(request, 'monitoring_static', path='admin/js/logs.js') }}"></script>
 {% endblock %}

app/modules/monitoring/templates/monitoring/admin/platform-health.html

@@ -263,5 +263,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('monitoring_static', path='admin/js/platform-health.js') }}"></script>
+<script defer src="{{ static_v(request, 'monitoring_static', path='admin/js/platform-health.js') }}"></script>
 {% endblock %}

app/modules/orders/templates/orders/admin/orders.html

@@ -580,5 +580,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('orders_static', path='admin/js/orders.js') }}"></script>
+<script defer src="{{ static_v(request, 'orders_static', path='admin/js/orders.js') }}"></script>
 {% endblock %}

app/modules/orders/templates/orders/store/order-detail.html

@@ -451,5 +451,5 @@
         orderId: {{ order_id }}
     };
 </script>
-<script defer src="{{ url_for('orders_static', path='store/js/order-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'orders_static', path='store/js/order-detail.js') }}"></script>
 {% endblock %}

app/modules/orders/templates/orders/store/orders.html

@@ -330,5 +330,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('orders_static', path='store/js/orders.js') }}"></script>
+<script defer src="{{ static_v(request, 'orders_static', path='store/js/orders.js') }}"></script>
 {% endblock %}

app/modules/prospecting/templates/prospecting/admin/campaigns.html

@@ -156,5 +156,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('prospecting_static', path='admin/js/campaigns.js') }}"></script>
+<script defer src="{{ static_v(request, 'prospecting_static', path='admin/js/campaigns.js') }}"></script>
 {% endblock %}

app/modules/prospecting/templates/prospecting/admin/capture.html

@@ -148,5 +148,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('prospecting_static', path='admin/js/capture.js') }}"></script>
+<script defer src="{{ static_v(request, 'prospecting_static', path='admin/js/capture.js') }}"></script>
 {% endblock %}

app/modules/prospecting/templates/prospecting/admin/dashboard.html

@@ -127,5 +127,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('prospecting_static', path='admin/js/dashboard.js') }}"></script>
+<script defer src="{{ static_v(request, 'prospecting_static', path='admin/js/dashboard.js') }}"></script>
 {% endblock %}

app/modules/prospecting/templates/prospecting/admin/leads.html

@@ -139,5 +139,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('prospecting_static', path='admin/js/leads.js') }}"></script>
+<script defer src="{{ static_v(request, 'prospecting_static', path='admin/js/leads.js') }}"></script>
 {% endblock %}

app/modules/prospecting/templates/prospecting/admin/prospect-detail.html

@@ -429,5 +429,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('prospecting_static', path='admin/js/prospect-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'prospecting_static', path='admin/js/prospect-detail.js') }}"></script>
 {% endblock %}

app/modules/prospecting/templates/prospecting/admin/prospects.html

@@ -241,5 +241,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('prospecting_static', path='admin/js/prospects.js') }}"></script>
+<script defer src="{{ static_v(request, 'prospecting_static', path='admin/js/prospects.js') }}"></script>
 {% endblock %}

app/modules/prospecting/templates/prospecting/admin/scan-jobs.html

@@ -98,5 +98,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('prospecting_static', path='admin/js/scan-jobs.js') }}"></script>
+<script defer src="{{ static_v(request, 'prospecting_static', path='admin/js/scan-jobs.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/admin-user-detail.html

@@ -271,5 +271,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/admin-user-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/admin-user-detail.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/admin-user-edit.html

@@ -353,5 +353,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/admin-user-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/admin-user-edit.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/admin-users.html

@@ -283,5 +283,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/admin-users.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/admin-users.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/login.html

@@ -210,6 +210,6 @@
     </script>
 
     <!-- 6. Login Logic -->
-    <script defer src="{{ url_for('core_static', path='admin/js/login.js') }}"></script>
+    <script defer src="{{ static_v(request, 'core_static', path='admin/js/login.js') }}"></script>
 </body>
 </html>

app/modules/tenancy/templates/tenancy/admin/merchant-detail.html

@@ -483,5 +483,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-detail.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchant-edit.html

@@ -490,5 +490,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-edit.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchant-user-detail.html

@@ -281,5 +281,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-user-detail.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-user-detail.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchant-user-edit.html

@@ -247,5 +247,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-user-edit.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-user-edit.js') }}"></script>
 {% endblock %}

app/modules/tenancy/templates/tenancy/admin/merchant-users.html

@@ -250,5 +250,5 @@
 {% endblock %}
 
 {% block extra_scripts %}
-<script defer src="{{ url_for('tenancy_static', path='admin/js/merchant-users.js') }}"></script>
+<script defer src="{{ static_v(request, 'tenancy_static', path='admin/js/merchant-users.js') }}"></script>
 {% endblock %}