@salla.sa/twilight-theme-engine 1.0.103 → 1.0.105

package/tailwind/components/store/MaintenancePage.tsx.txt

@@ -0,0 +1,156 @@
+import { getTwilightContext } from '../../twilight/context';
+import { useTranslation } from '../../providers/I18nProvider';
+import type { Store, StoreSocial } from '../../types';
+
+const THUMB_URL = 'https://cdn.assets.salla.network/prod/stores/images/construction-01.png';
+
+/** Social networks the page links to, in the old page's order, with their Salla icon class. */
+const SOCIAL_ICONS: [keyof StoreSocial, string][] = [
+  ['twitter', 'sicon-x'],
+  ['snapchat', 'sicon-snapchat'],
+  ['youtube', 'sicon-youtube'],
+  ['tiktok', 'sicon-tiktok'],
+  ['facebook', 'sicon-facebook'],
+  ['instagram', 'sicon-instagram'],
+];
+
+// The platform's maintenance page (Store `pages/maintenance.blade.php` + `_maintenance.scss`),
+// trimmed to what it renders: greyscale, logo + title beside the message, contacts under a
+// rule, the illustration alongside; stacked and centred under 1024px.
+const STYLE = `
+.s-maintenance{display:flex;flex-direction:column;align-items:center;justify-content:center;width:100%;min-height:100vh;color:#a3a3a3;background:#fff;filter:grayscale(100%);box-sizing:border-box}
+.s-maintenance *{box-sizing:border-box}
+.s-maintenance .mt-container{width:100%;max-width:1200px;padding:0 15px}
+.s-maintenance .mt-panel{display:flex;flex-direction:row;align-items:center;justify-content:space-between;width:100%}
+.s-maintenance .mt-message{width:100%;padding-inline-start:80px;animation:revealMtBlock 1.5s forwards}
+.s-maintenance .mt-title{display:flex;align-items:center;margin:0 0 20px}
+.s-maintenance .mt-logo{display:block;flex-shrink:0;width:80px;height:80px;margin-inline-end:20px;border-radius:50%;overflow:hidden;box-shadow:0 0 5px rgb(0 0 0 / 10%)}
+.s-maintenance .mt-logo img{display:block;width:100%;height:100%;object-fit:cover}
+.s-maintenance .mt-title h1{font-size:2.25rem;line-height:1;margin:0;color:#666}
+.s-maintenance .mt-content p{margin:0;white-space:pre-line}
+.s-maintenance .mt-contact-list{display:inline-block;list-style:none;width:100%;max-width:500px;margin:20px 0 0;padding:20px 0 0;border-top:1px solid #eee}
+.s-maintenance .mt-contact-list li{display:inline-block;margin-inline-end:10px}
+.s-maintenance .mt-contact-list a{display:inline-flex;align-items:center;padding:5px;color:rgb(102 102 102 / 80%);text-decoration:none;font-size:1.25rem}
+.s-maintenance .mt-contact-list a:hover{color:#666}
+.s-maintenance .mt-contact--btn{padding:3px 20px 5px;border-radius:20px;color:#fff!important;background:rgb(102 102 102 / 80%);font-size:1rem!important}
+.s-maintenance .mt-contact--btn:hover{background:#666}
+.s-maintenance .mt-contact--btn i{margin-inline-end:10px}
+.s-maintenance .thumb{width:100%;animation:revealMtBlock 1.5s .1s forwards;opacity:0}
+.s-maintenance .thumb img{display:block;width:100%;max-width:450px;margin:0 auto}
+@media (max-width:1024px){
+.s-maintenance{padding:40px 0 10px}
+.s-maintenance .mt-panel{flex-direction:column}
+.s-maintenance .mt-message{order:2;text-align:center;padding:0;margin:50px 0 0}
+.s-maintenance .mt-title{flex-direction:column;margin-bottom:30px}
+.s-maintenance .mt-logo{margin:0 0 10px}
+.s-maintenance .mt-title h1{font-size:1.5rem}
+}
+@media (max-width:640px){.s-maintenance .thumb img{width:80%}}
+@keyframes revealMtBlock{from{opacity:0;transform:translateY(50%)}to{opacity:1;transform:translateY(0)}}
+`;
+
+/** The phone button and social links under the message; nothing when the store lists none. */
+function Contacts({ store, arabic }: { store: Store | undefined; arabic: boolean }) {
+  const { t } = useTranslation();
+  const mobile = store?.contacts?.mobile;
+  const socials = SOCIAL_ICONS.flatMap(([key, icon]) => {
+    const href = store?.social?.[key];
+    return href ? [{ key, icon, href }] : [];
+  });
+  if (!mobile && socials.length === 0) return null;
+
+  return (
+    <ul className="mt-contact-list">
+      {mobile && (
+        <li>
+          <a href={`tel:${mobile}`} className="mt-contact--btn">
+            <i className="sicon-phone" aria-hidden="true" />
+            {t('common.elements.contact_us', {
+              defaultValue: arabic ? 'تواصل معنا' : 'Contact us',
+            })}
+          </a>
+        </li>
+      )}
+      {socials.map(({ key, icon, href }) => (
+        <li key={key}>
+          <a href={href} target="_blank" rel="noreferrer" aria-label={key}>
+            <i className={icon} aria-hidden="true" />
+          </a>
+        </li>
+      ))}
+    </ul>
+  );
+}
+
+/**
+ * The page a customer sees while the store is closed: the platform's maintenance page,
+ * fed by the settings' `maintenance_details` (the merchant's title and message) and the
+ * store's contacts. Rendered by `TwilightProvider` in place of the layout; see
+ * `rootBeforeLoad` for who sees it.
+ */
+export function MaintenancePage() {
+  const { settings, locale } = getTwilightContext();
+  const { t } = useTranslation();
+  const store = settings.store;
+  const details = settings.maintenance_details;
+  const arabic = locale.startsWith('ar');
+
+  const title =
+    details?.title ||
+    t('pages.maintenance.title', {
+      defaultValue: arabic ? 'المتجر قيد الصيانة' : 'Store under maintenance',
+    });
+
+  return (
+    <div className="s-maintenance" data-testid="store-maintenance-page">
+      <style>{STYLE}</style>
+      <div className="mt-container">
+        <section className="mt-panel">
+          <div className="mt-message">
+            <div className="mt-title">
+              {store?.logo && (
+                <span className="mt-logo">
+                  <img
+                    src={store.logo}
+                    alt={
+                      store.name ||
+                      t('common.elements.store_logo', {
+                        defaultValue: arabic ? 'شعار المتجر' : 'Store logo',
+                      })
+                    }
+                  />
+                </span>
+              )}
+              <h1>{title}</h1>
+            </div>
+            <div className="mt-content">
+              {details?.message ? (
+                // The merchant's own wording: a plain string the dashboard caps at 200 characters.
+                <p>{details.message}</p>
+              ) : (
+                <>
+                  <p>
+                    {t('pages.maintenance.message', {
+                      defaultValue: arabic
+                        ? 'عذرا عزيزي العميل، المتجر حاليا قيد الصيانة و سنعاود العمل خلال فترة وجيزة'
+                        : 'Sorry, the store is under maintenance and will be back shortly.',
+                    })}
+                  </p>
+                  <p>
+                    {t('pages.maintenance.thanks', {
+                      defaultValue: arabic ? 'شكرا لتفهمكم' : 'Thank you for your understanding.',
+                    })}
+                  </p>
+                </>
+              )}
+            </div>
+            <Contacts store={store} arabic={arabic} />
+          </div>
+          <div className="thumb">
+            <img src={THUMB_URL} alt="" />
+          </div>
+        </section>
+      </div>
+    </div>
+  );
+}

package/tailwind/components/store/index.ts.txt

@@ -4,5 +4,8 @@ export {
   type StoreClosedNotificationProps,
 } from './StoreClosedNotification';
 
+// The page customers see while the store is in maintenance (TwilightProvider renders it).
+export { MaintenancePage } from './MaintenancePage';
+
 // Lazy component
-export { LazyStoreClosedNotification } from './lazy';
+export { LazyStoreClosedNotification, LazyMaintenancePage } from './lazy';

package/tailwind/components/store/lazy.ts.txt

@@ -6,3 +6,8 @@ export const LazyStoreClosedNotification = lazy(() =>
     default: m.StoreClosedNotification,
   }))
 );
+
+/** Lazy-loaded MaintenancePage: off the shell chunk, since almost no visit renders it. */
+export const LazyMaintenancePage = lazy(() =>
+  import('./MaintenancePage').then((m) => ({ default: m.MaintenancePage }))
+);

package/tailwind/routes/root/beforeLoad.ts.txt

@@ -31,6 +31,12 @@ import {
 import { syncSdkLocale, syncSdkThemeVersion } from '../../utils/sdk-helpers';
 import { SettingsError } from '../../utils/errors';
 import { resolveStoreBaseRedirect } from '../../utils/store-identity';
+import {
+  ownerCookieMatches,
+  ownerLinkMatches,
+  showsMaintenancePage,
+  VIEW_AS_OWNER_COOKIE_NAME,
+} from '../../utils/maintenance';
 
 // Reads the `token` cookie from the incoming request on the SERVER. twilightMiddleware
 // extracts the same cookie into a custom ALS, but that ALS does NOT propagate to the
@@ -128,6 +134,48 @@ export const persistRequestScope = createIsomorphicFn()
   })
   .client((): void => {});
 
+/** The request's cookie header: the framework's on the server, the document's in the browser. */
+const requestCookies = createIsomorphicFn()
+  .server((): string | null => {
+    try {
+      return getRequestHeader('cookie') ?? null;
+    } catch {
+      return null;
+    }
+  })
+  .client((): string | null => (typeof document !== 'undefined' ? document.cookie : null));
+
+/** Remembers the owner view for the rest of this browser session; see {@link VIEW_AS_OWNER_COOKIE_NAME}. */
+const rememberOwnerView = createIsomorphicFn()
+  .server((storeId: string): void => {
+    try {
+      setCookie(VIEW_AS_OWNER_COOKIE_NAME, storeId, { path: '/', sameSite: 'lax' });
+    } catch {
+      // Outside a request (prerender): there is no response to write to.
+    }
+  })
+  .client((storeId: string): void => {
+    document.cookie = `${VIEW_AS_OWNER_COOKIE_NAME}=${storeId}; path=/; SameSite=Lax`;
+  });
+
+/**
+ * Whether this visitor sees the maintenance page instead of the store, deciding and
+ * remembering the merchant's owner view on the way.
+ *
+ * Twig's backend lets the merchant into their closed store when the dashboard's link
+ * brings them (`?utm_source=dashboard&identifier=<store id>`), and keeps that in the
+ * session. Here the link grants a session cookie, and the cookie or the link is the
+ * owner view. A customer gets the maintenance page, and `twilightMiddleware` turns the
+ * render into a 503 (see `withMaintenanceStatus`).
+ */
+export function resolveMaintenance(href: string, settings: StoreContext): boolean {
+  const fromLink = ownerLinkMatches(href, settings);
+  const storeId = settings.store?.id;
+  if (fromLink && storeId != null) rememberOwnerView(String(storeId));
+  const viewAsOwner = fromLink || ownerCookieMatches(requestCookies(), settings);
+  return showsMaintenancePage(settings, viewAsOwner);
+}
+
 /** On the server, once the settings are in: {@link alignRequestScopeType}, then {@link persistRequestScope}. */
 function settleRequestScope(queryClient: QueryClient, settings: StoreContext): void {
   if (typeof window !== 'undefined') return;
@@ -146,6 +194,8 @@ export interface BeforeLoadResult {
   /** Per-app public `app.*` buckets, threaded the same way so rootHead can install the
    *  `Salla.appScope` factory inline in the SSR head. */
   appsSettings?: AppSettings;
+  /** This visitor sees the maintenance page, not the store; see {@link resolveMaintenance}. */
+  maintenance: boolean;
 }
 
 /**
@@ -279,6 +329,8 @@ export async function rootBeforeLoad(ctx: {
     throw redirect({ href: storeBaseHref, reloadDocument: true, replace: true });
   }
 
+  const maintenance = resolveMaintenance(ctx.location.href, settingsResult);
+
   // The merchant's own wording, laid over the platform's — but only when the
   // settings say this language has any.
   //
@@ -341,6 +393,7 @@ export async function rootBeforeLoad(ctx: {
     authToken,
     appsSnippets: snippetsResult,
     appsSettings: appSettingsResult,
+    maintenance,
   });
 
   return {
@@ -350,5 +403,6 @@ export async function rootBeforeLoad(ctx: {
     authToken,
     appsSnippets: snippetsResult,
     appsSettings: appSettingsResult,
+    maintenance,
   };
 }

package/tailwind/routes/root/head.ts.txt

@@ -219,6 +219,8 @@ interface RootHeadParts {
   isCustomCssUrl?: boolean;
   isCustomJsUrl?: boolean;
   twilightSdkUrl: string;
+  /** The visitor gets the maintenance page, which loads no SDK and no app snippets. */
+  maintenance: boolean;
   snippetPreconnects: Array<{ rel: 'preconnect'; href: string }>;
   appScopeInstallScript: string;
   themeHookSlotsScript: string | null;
@@ -268,6 +270,7 @@ function deriveHeadParts(settings?: StoreContext): RootHeadParts {
     ...deriveFontParts(settings?.theme),
     ...deriveCustomizationParts(settings?.theme),
     twilightSdkUrl: resolveTwilightSdkUrl(settings),
+    maintenance: getTwilightContext().maintenance,
     // Warm the connection to the snippet host(s) during head parse, so the body's deferred
     // `<script src>` snippet tags fetch off an already-open socket instead of DNS+TCP+TLS.
     snippetPreconnects: snippetPreconnectOrigins(getTwilightContext().appsSnippets).map((href) => ({
@@ -313,7 +316,8 @@ function buildRootLinks(p: RootHeadParts): NonNullable<HeadDescriptor['links']>
     { rel: 'preconnect', href: 'https://cdn.salla.sa' },
     { rel: 'preconnect', href: 'https://cdn.assets.salla.network', crossOrigin: 'anonymous' },
     // Warm the installed apps' CDN snippet host(s) — see snippetPreconnectOrigins.
-    ...p.snippetPreconnects,
+    // Not on the maintenance page: it renders neither the snippets nor the SDK.
+    ...(p.maintenance ? [] : p.snippetPreconnects),
     ...(p.isGoogleFont
       ? [
           {
@@ -323,7 +327,7 @@ function buildRootLinks(p: RootHeadParts): NonNullable<HeadDescriptor['links']>
           },
         ]
       : []),
-    { rel: 'modulepreload', href: p.twilightSdkUrl },
+    ...(p.maintenance ? [] : [{ rel: 'modulepreload' as const, href: p.twilightSdkUrl }]),
     ...(p.fontUrlWithDisplay
       ? [
           {

package/dist/Header-CXJ3TFHO.js

@@ -1,22 +0,0 @@
-export { Header } from './chunk-IYD3EN22.js';
-import './chunk-GT2L5IJ4.js';
-import './chunk-OUW6WESU.js';
-import './chunk-7YH3A5BT.js';
-import './chunk-ZMCFSOYF.js';
-import './chunk-5XDPAKF5.js';
-import './chunk-GCPEMNSU.js';
-import './chunk-ZPX4LBQZ.js';
-import './chunk-TYNZ5B2B.js';
-import './chunk-44FMRCHW.js';
-import './chunk-AXW67SY7.js';
-import './chunk-BYMOPN2S.js';
-import './chunk-SKLEJJ6M.js';
-import './chunk-VPGOT3JO.js';
-import './chunk-VEWF3NFM.js';
-import './chunk-GNLCPK6N.js';
-import './chunk-H3PJJKAQ.js';
-import './chunk-T72DAX7R.js';
-import './chunk-DF6FBKDN.js';
-import './chunk-DGUM43GV.js';
-//# sourceMappingURL=Header-CXJ3TFHO.js.map
-//# sourceMappingURL=Header-CXJ3TFHO.js.map

package/dist/StoreClosedNotification-2CIG5LX6.js

@@ -1,54 +0,0 @@
-export { StoreClosedNotification } from './chunk-RPVHCIR4.js';
-import './chunk-UIXEKYTM.js';
-import './chunk-IYD3EN22.js';
-import './chunk-7RL4DG54.js';
-import './chunk-JZDJO2CK.js';
-import './chunk-P4XV656A.js';
-import './chunk-GLWSJZJZ.js';
-import './chunk-OXMUPNMH.js';
-import './chunk-PENQTLAN.js';
-import './chunk-VVZNW5CB.js';
-import './chunk-HIAHDZI5.js';
-import './chunk-GD26FI4J.js';
-import './chunk-4SZZPXM2.js';
-import './chunk-GT2L5IJ4.js';
-import './chunk-OUW6WESU.js';
-import './chunk-6YWW5Y22.js';
-import './chunk-HI5V5X3S.js';
-import './chunk-PXHFHHTW.js';
-import './chunk-XMO7HDZZ.js';
-import './chunk-MVT5AF2A.js';
-import './chunk-Z653O7MX.js';
-import './chunk-ZCH7W7DZ.js';
-import './chunk-JUUKZRE5.js';
-import './chunk-JWXJPJBO.js';
-import './chunk-CW625T2E.js';
-import './chunk-7V36I5GT.js';
-import './chunk-6WI7R2BD.js';
-import './chunk-OOCN4RFV.js';
-import './chunk-OAMIDZKW.js';
-import './chunk-7YH3A5BT.js';
-import './chunk-V2ZDTY6H.js';
-import './chunk-ZMCFSOYF.js';
-import './chunk-5XDPAKF5.js';
-import './chunk-GCPEMNSU.js';
-import './chunk-ZPX4LBQZ.js';
-import './chunk-TYNZ5B2B.js';
-import './chunk-44FMRCHW.js';
-import './chunk-AXW67SY7.js';
-import './chunk-BYMOPN2S.js';
-import './chunk-SKLEJJ6M.js';
-import './chunk-6BZ5TKEV.js';
-import './chunk-FZKRSGLP.js';
-import './chunk-7V5HOZW4.js';
-import './chunk-YA6ABQB7.js';
-import './chunk-46JZXQRS.js';
-import './chunk-VPGOT3JO.js';
-import './chunk-VEWF3NFM.js';
-import './chunk-GNLCPK6N.js';
-import './chunk-H3PJJKAQ.js';
-import './chunk-T72DAX7R.js';
-import './chunk-DF6FBKDN.js';
-import './chunk-DGUM43GV.js';
-//# sourceMappingURL=StoreClosedNotification-2CIG5LX6.js.map
-//# sourceMappingURL=StoreClosedNotification-2CIG5LX6.js.map

package/dist/chunk-CXONF653.js

@@ -1,14 +0,0 @@
-import { lazy } from 'react';
-
-// src/components/cart/lazy.ts
-var LazyCartItem = lazy(() => import('./CartItem-KO34MYXT.js').then((m) => ({ default: m.CartItem })));
-var LazyCartSummary = lazy(
-  () => import('./CartSummary-NPFAJI7C.js').then((m) => ({ default: m.CartSummary }))
-);
-var LazySeoCartWidget = lazy(
-  () => import('./SeoCartWidget-DWJT2WXI.js').then((m) => ({ default: m.SeoCartWidget }))
-);
-
-export { LazyCartItem, LazyCartSummary, LazySeoCartWidget };
-//# sourceMappingURL=chunk-CXONF653.js.map
-//# sourceMappingURL=chunk-CXONF653.js.map

package/dist/chunk-GT2L5IJ4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/NavigationProvider.ts"],"names":[],"mappings":"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","file":"chunk-GT2L5IJ4.js","sourcesContent":["import {\n  createElement,\n  createContext,\n  useContext,\n  useCallback,\n  useRef,\n  useEffect,\n  useSyncExternalStore,\n  type ReactNode,\n} from 'react';\nimport { useTwilight } from './twilight-context';\nimport { getTwilightContext, subscribeTwilight, type TwilightLocation } from '../twilight/context';\nimport { RouteId } from '../router/route-ids';\nimport { withoutStoreUrlBase } from '../utils/store-base';\nimport { extractScopeFromUrl } from '../utils/cookies';\nimport { getActiveScope } from '../api/client';\nimport { openNativeBrowser } from '../native-app';\n\n// Re-export RouteId from centralized location\nexport { RouteId } from '../router/route-ids';\nexport type { RouteIdType } from '../router/route-ids';\n\n// Re-export TwilightLocation as Location for convenience\nexport type { TwilightLocation as Location } from '../twilight/context';\n\nexport type NavigateOptions = { replace?: boolean };\nexport type NavigateFn = (to: string, opts?: NavigateOptions) => void;\n\n/** Redirect error - thrown to trigger a redirect */\nexport class RedirectError extends Error {\n  constructor(\n    public path: string,\n    public replace = false\n  ) {\n    super(`Redirect to ${path}`);\n    this.name = 'RedirectError';\n  }\n}\n\n/** NotFound error - thrown to trigger 404 */\nexport class NotFoundError extends Error {\n  constructor(message?: string) {\n    super(message ?? 'Not Found');\n    this.name = 'NotFoundError';\n  }\n}\n\n/** Unauthorized error - thrown to trigger 401 */\nexport class UnauthorizedError extends Error {\n  constructor(message?: string) {\n    super(message ?? 'Unauthorized');\n    this.name = 'UnauthorizedError';\n  }\n}\n\nexport { SettingsError } from '../utils/errors';\n\nexport const defaultNavigate: NavigateFn = (to, opts) => {\n  if (opts?.replace) window.location.replace(to);\n  else window.location.href = to;\n};\n\nexport interface RedirectOptions {\n  replace?: boolean;\n  /** HTTP status of a server redirect, e.g. 301 for a URL that moved for good. Defaults to 307. */\n  statusCode?: number;\n}\n\n/** Default redirect - throws RedirectError with browser navigation as fallback */\nexport const defaultRedirect = (path: string, opts?: RedirectOptions): never => {\n  const replace = opts?.replace ?? false;\n\n  // In browser, perform actual navigation before throwing\n  if (typeof window !== 'undefined') {\n    if (replace) window.location.replace(path);\n    else window.location.href = path;\n  }\n\n  throw new RedirectError(path, replace);\n};\n\n/** Default notFound - throws generic error */\nexport const defaultNotFound = (message?: string): never => {\n  throw new NotFoundError(message);\n};\n\n/** Default unauthorized - throws generic error */\nexport const defaultUnauthorized = (message?: string): never => {\n  throw new UnauthorizedError(message);\n};\n\n// ─── Framework-agnostic functions for loaders (outside React context) ──────\n\ninterface NavigationHandlers {\n  notFound: (message?: string) => never;\n  redirect: (path: string, opts?: RedirectOptions) => never;\n  unauthorized: (message?: string) => never;\n}\n\n// One set per isolate, so a loader in another copy of this module (a separate\n// package entry, a dev reload) still throws what the framework adapter configured.\nconst HANDLERS_KEY = Symbol.for('salla.twilight.navigation.handlers');\nconst registry = globalThis as { [HANDLERS_KEY]?: NavigationHandlers };\nconst handlers: NavigationHandlers = (registry[HANDLERS_KEY] ??= {\n  notFound: defaultNotFound,\n  redirect: defaultRedirect,\n  unauthorized: defaultUnauthorized,\n});\n\n/**\n * Throw a notFound error. Use in route loaders.\n * Framework adapters will override this to throw framework-specific errors.\n *\n * @example\n * ```ts\n * // In loader\n * import { notFound } from '@salla.sa/twilight-theme-engine/providers';\n *\n * if (!data) throw notFound();\n * ```\n */\nexport function notFound(message?: string): never {\n  return handlers.notFound(message);\n}\n\n/**\n * Throw an unauthorized error. Use in route loaders to protect authenticated routes.\n * Framework adapters will override this to throw framework-specific errors.\n *\n * @example\n * ```ts\n * import { unauthorized } from '@salla.sa/twilight-theme-engine/providers';\n *\n * if (!user) throw unauthorized();\n * ```\n */\nexport function unauthorized(message?: string): never {\n  return handlers.unauthorized(message);\n}\n\n/**\n * Throw a redirect. Use in route loaders.\n * Framework adapters will override this to throw framework-specific redirects.\n *\n * @param path - Path to redirect to\n * @param opts - Redirect options\n *\n * @example\n * ```ts\n * // In loader\n * import { redirect } from '@salla.sa/twilight-theme-engine/providers';\n *\n * throw redirect('/ar/cart');\n * ```\n */\nexport function redirect(path: string, opts?: RedirectOptions): never {\n  return handlers.redirect(path, opts);\n}\n\n/**\n * Configure navigation functions for a specific framework.\n * Called by framework adapters during setup.\n */\nexport function configureNavigation(config: {\n  notFound?: (message?: string) => never;\n  redirect?: (path: string, opts?: RedirectOptions) => never;\n  unauthorized?: (_message?: string) => never;\n}): void {\n  if (config.notFound) handlers.notFound = config.notFound;\n  if (config.redirect) handlers.redirect = config.redirect;\n  if (config.unauthorized) handlers.unauthorized = config.unauthorized;\n}\n\n// ─── Loader Error Handling Helpers ─────────────────────────────────────────────\n\n/**\n * Wraps an API promise with error handling for route loaders.\n * On a 404/410 response throws notFound(); other errors propagate.\n *\n * @example\n * ```ts\n * findOrThrow: (id, locale) => orThrow(product.find(id, locale)),\n * const data = await product.findOrThrow(id, locale);\n * ```\n */\nexport async function orThrow<T>(promise: Promise<T>): Promise<T> {\n  try {\n    return await promise;\n  } catch (error) {\n    console.debug('[loader error]', error);\n    const status = (error as unknown as { response?: { status?: number } })?.response?.status;\n    // The API answers a missing resource with 410, sometimes 404.\n    if (status === 404 || status === 410) return notFound();\n    throw error;\n  }\n}\n\n/**\n * Wraps an API promise with error handling for authenticated route loaders.\n * On a 401/403 response throws unauthorized(); other errors propagate.\n *\n * @example\n * ```ts\n * const data = await orUnauthorized(order.find(id, locale));\n * ```\n */\nexport async function orUnauthorized<T>(promise: Promise<T>): Promise<T> {\n  try {\n    return await promise;\n  } catch (error) {\n    const status = (error as unknown as { response?: { status?: number } })?.response?.status;\n    if (status === 401 || status === 403) {\n      throw unauthorized();\n    }\n    throw error;\n  }\n}\n\n// ─── Navigation Context ──────────────────────────────────────────────────────\n\ninterface NavigationContextValue {\n  navigate: NavigateFn;\n}\n\nconst NavigationContext = createContext<NavigationContextValue>({\n  navigate: defaultNavigate,\n});\n\nexport function NavigationProvider({\n  navigate,\n  children,\n}: {\n  navigate: NavigateFn;\n  children: ReactNode;\n}) {\n  return createElement(NavigationContext.Provider, { value: { navigate } }, children);\n}\n\n// ─── Primary Hooks (High Compatibility) ───────────────────────────────────────\n\n/**\n * Get the navigate function.\n * Matches React Router, TanStack Router, and Remix naming convention.\n *\n * @returns Navigate function\n *\n * @example\n * ```tsx\n * const navigate = useNavigate();\n * navigate('/cart');\n * navigate('/cart', { replace: true });\n * ```\n */\nexport function useNavigate(): NavigateFn {\n  return useContext(NavigationContext).navigate;\n}\n\n/**\n * Get the current route ID.\n * Used for route detection (isHome, isProduct, etc.)\n *\n * @returns Current route ID string\n *\n * @example\n * ```tsx\n * const routeId = useRouteId();\n * if (routeId === RouteId.INDEX) { ... }\n * ```\n */\nexport function useRouteId(): string {\n  return useSyncExternalStore(\n    subscribeTwilight,\n    () => getTwilightContext().routeId,\n    () => getTwilightContext().routeId\n  );\n}\n\n/**\n * Get the current location (TanStack Router compatible).\n * Reads from the router context for SSR compatibility.\n *\n * @returns Location object matching TanStack's ParsedLocation\n *\n * @example\n * ```tsx\n * const location = useLocation();\n * console.log(location.pathname);  // '/ar/products'\n * console.log(location.searchStr);  // '?q=shoes&page=2'\n * console.log(location.search);    // { q: 'shoes', page: '2' }\n * console.log(location.href);      // 'https://store.com/ar/products?q=shoes'\n * console.log(location.hash);      // '#section-1'\n * console.log(location.state);     // { scrollY: 100 }\n * ```\n */\nexport function useLocation<TSearch = Record<string, unknown>>(): TwilightLocation<TSearch> {\n  useTwilight();\n  return getTwilightContext().location as TwilightLocation<TSearch>;\n}\n\n// ─── Selector Hooks ───────────────────────────────────────────────────────────\n\n/**\n * Check if current page is homepage */\nexport function useIsHome(): boolean {\n  return useRouteId() === RouteId.INDEX;\n}\n\n/** Check if current page is product detail */\nexport function useIsProduct(): boolean {\n  return useRouteId() === RouteId.PRODUCT_SINGLE;\n}\n\n/** Check if current page is cart */\nexport function useIsCart(): boolean {\n  return useRouteId() === RouteId.CART;\n}\n\n/** Check if current page is in customer area */\nexport function useIsCustomer(): boolean {\n  return useRouteId().startsWith('customer');\n}\n\n/** Check if current page is blog related */\nexport function useIsBlog(): boolean {\n  const routeId = useRouteId();\n  return routeId === RouteId.BLOG_INDEX || routeId === RouteId.BLOG_SINGLE;\n}\n\n/** Check if current page is brands related */\nexport function useIsBrands(): boolean {\n  const routeId = useRouteId();\n  return routeId === RouteId.BRANDS_INDEX || routeId === RouteId.BRANDS_SINGLE;\n}\n\n/** Check if current page is search */\nexport function useIsSearch(): boolean {\n  return useRouteId() === RouteId.SEARCH;\n}\n\n// ─── Navigation Interceptor ──────────────────────────────────────────────────\n\n/**\n * NavigationInterceptor - Framework-agnostic SPA navigation interceptor.\n *\n * Uses navigate function from NavigationProvider context and store URL\n * from TwilightProvider to intercept same-origin navigations.\n */\nexport function NavigationInterceptor(): null {\n  const navigate = useNavigate();\n  const { store } = useTwilight();\n  useNavigationInterceptor(navigate, store?.url, store?.username);\n  return null;\n}\n\n/**\n * resolveRelativePath - Resolve href to store-relative path\n *\n * Returns `null` when the URL is not on the same origin as the store,\n * keeping this helper safe against open-redirect misuse.\n *\n * The path is the application's, not the address on Salla's host: a store served\n * under its username there (`https://demostore.salla.sa/ar/dev-…/`) hands out links\n * carrying that segment, and it is removed. On a host where the store is the root\n * of every URL, the router adds its own segment back when it navigates.\n *\n * @param href - The URL to resolve\n * @param storeUrl - The store's base URL\n * @param username - The store's username, which tells that segment apart from a\n *   locale spelled the same way (see `withoutStoreUrlBase`)\n * @returns The relative path string, or null if the URL is external\n */\nexport function resolveRelativePath(\n  href: string,\n  storeUrl: string,\n  username?: string | null\n): string | null {\n  try {\n    const target = new URL(href, window.location.href);\n    const base = new URL(storeUrl);\n\n    if (target.origin !== base.origin) return null;\n\n    const pathname = withoutStoreUrlBase(target.pathname, base.pathname, username);\n    const path = pathname + target.search + target.hash;\n    return path || '/';\n  } catch {\n    return null;\n  }\n}\n\n/**\n * EXTERNAL_TARGETS - Target attribute values that indicate external navigation\n */\nconst EXTERNAL_TARGETS = new Set(['_blank', '_parent', '_top']);\n\n/**\n * shouldIntercept - Determine if an anchor click should be intercepted by SPA router\n *\n * Follows browser conventions: modifier keys, external targets, downloads,\n * and non-HTTP(S) protocols are left to the browser's default behavior.\n *\n * @param anchor - The anchor element that was clicked\n * @param event - The click event\n * @returns true if the click should be intercepted by the router\n */\nexport function shouldIntercept(anchor: HTMLAnchorElement, event: MouseEvent): boolean {\n  if (event.defaultPrevented) return false;\n\n  if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return false;\n\n  const targetAttr = anchor.getAttribute('target');\n  if (targetAttr && EXTERNAL_TARGETS.has(targetAttr)) return false;\n\n  if (anchor.hasAttribute('download')) return false;\n\n  const rel = (anchor.getAttribute('rel') ?? '').split(/\\s+/);\n  if (rel.includes('external')) return false;\n\n  const href = anchor.getAttribute('href') ?? '';\n  if (!href) return false;\n\n  try {\n    const url = new URL(href, window.location.href);\n    if (url.protocol.startsWith('javascript:')) return false;\n  } catch {\n    return false;\n  }\n\n  return true;\n}\n\n/**\n * Whether `href` switches market: its `?scope=` names another scope than the active one,\n * or the same scope with another branch (`allocation_type` / `allocation_id`).\n *\n * Twig switches market with a full load (the SDK's scopes modal calls\n * `location.replace('?scope=<id>')`), and only a document request lets the server render\n * the new market and record it in the `scope` cookie. Left to the browser, not the router.\n */\nexport function switchesScope(href: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(href, window.location.href);\n  } catch {\n    return false;\n  }\n  const requested = extractScopeFromUrl(url.href);\n  if (!requested) return false;\n  const active = getActiveScope();\n  if (requested.id !== active?.id) return true;\n  return (\n    requested.allocation_id != null &&\n    (requested.allocation_id !== active.allocation_id ||\n      requested.allocation_type !== active.allocation_type)\n  );\n}\n\n/**\n * Whether an untouched tap on `anchor` would load a page off the store: an\n * http(s) link to neither this page's origin nor the store's. `mailto:`, `tel:`\n * and the like are the device's to handle, and are left alone.\n */\nexport function leavesStore(\n  anchor: HTMLAnchorElement,\n  event: MouseEvent,\n  storeUrl: string | undefined\n): boolean {\n  if (event.defaultPrevented || anchor.hasAttribute('download')) return false;\n  let url: URL;\n  try {\n    url = new URL(anchor.getAttribute('href') ?? '', window.location.href);\n  } catch {\n    return false;\n  }\n  if (url.protocol !== 'http:' && url.protocol !== 'https:') return false;\n  if (url.origin === window.location.origin) return false;\n  try {\n    return !storeUrl || url.origin !== new URL(storeUrl).origin;\n  } catch {\n    return true;\n  }\n}\n\nfunction isSamePage(href: string): boolean {\n  const url = new URL(href, window.location.href);\n  return url.pathname === window.location.pathname && url.search === window.location.search;\n}\n\nfunction closeEnclosingModal(path: EventTarget[]): void {\n  const modal = path.find(\n    (el): el is HTMLElement & { close?: () => unknown } =>\n      el instanceof HTMLElement && el.localName === 'salla-modal'\n  );\n  void modal?.close?.();\n}\n\n// ─── Navigation Interceptor Hook (framework-agnostic) ─────────────────────────\n\n/**\n * Hook for navigation interception using framework-agnostic navigate function.\n * Framework adapters call this with their navigate implementation.\n */\nexport function useNavigationInterceptor(\n  navigate: NavigateFn,\n  storeUrl: string | undefined,\n  username?: string\n): void {\n  const storeUrlRef = useRef<string | undefined>(storeUrl);\n  const usernameRef = useRef<string | undefined>(username);\n\n  useEffect(() => {\n    storeUrlRef.current = storeUrl;\n    usernameRef.current = username;\n  }, [storeUrl, username]);\n\n  const tryNavigate = useCallback(\n    (href: string, replace = false): boolean => {\n      const currentStoreUrl = storeUrlRef.current;\n      if (!currentStoreUrl || switchesScope(href)) return false;\n\n      const relativePath = resolveRelativePath(href, currentStoreUrl, usernameRef.current);\n      if (!relativePath) return false;\n\n      navigate(relativePath, { replace });\n      return true;\n    },\n    [navigate]\n  );\n\n  useEffect(() => {\n    // ── Pointer movement tracking ────────────────────────────────────────────\n    // Detect drag/scroll gestures to avoid intercepting clicks from swipes.\n    let pointerStartX = 0;\n    let pointerStartY = 0;\n    let pointerSwiped = false;\n    const MOVE_THRESHOLD = 10;\n\n    function handlePointerDown(event: PointerEvent): void {\n      pointerStartX = event.clientX;\n      pointerStartY = event.clientY;\n      pointerSwiped = false;\n    }\n\n    function handlePointerUp(event: PointerEvent): void {\n      const dx = Math.abs(event.clientX - pointerStartX);\n      const dy = Math.abs(event.clientY - pointerStartY);\n      pointerSwiped = dx > MOVE_THRESHOLD || dy > MOVE_THRESHOLD;\n    }\n\n    // ── Anchor click interception ────────────────────────────────────────────\n    function handleClick(event: MouseEvent): void {\n      // Ignore clicks that resulted from swipe/drag gestures.\n      if (pointerSwiped) {\n        pointerSwiped = false;\n        return;\n      }\n\n      const path = event.composedPath();\n      const anchor = path.find((el): el is HTMLAnchorElement => el instanceof HTMLAnchorElement);\n\n      // Inside the Salla app, a link that leaves the store opens in the device's\n      // browser; loaded in the app's webview it would strand the shopper there.\n      if (\n        anchor &&\n        leavesStore(anchor, event, storeUrlRef.current) &&\n        openNativeBrowser(anchor.href)\n      ) {\n        event.preventDefault();\n        return;\n      }\n\n      if (!anchor || !shouldIntercept(anchor, event)) return;\n\n      const samePage = isSamePage(anchor.href);\n      if (tryNavigate(anchor.href, false)) {\n        event.preventDefault();\n        // A page load would close a web component's modal; an in-app navigation leaves it open.\n        if (!samePage) closeEnclosingModal(path);\n      }\n    }\n\n    // ── window.location.assign patch ─────────────────────────────────────────\n    const origAssign = window.location.assign;\n    function patchedAssign(url: string): void {\n      if (!tryNavigate(url, false)) origAssign.call(window.location, url);\n    }\n\n    // ── window.location.replace patch ────────────────────────────────────────\n    const origReplace = window.location.replace;\n    function patchedReplace(url: string): void {\n      if (!tryNavigate(url, true)) origReplace.call(window.location, url);\n    }\n\n    let assignPatched = false;\n    let replacePatched = false;\n    try {\n      window.location.assign = patchedAssign;\n      assignPatched = true;\n    } catch {\n      /* non-writable in this environment */\n    }\n    try {\n      window.location.replace = patchedReplace;\n      replacePatched = true;\n    } catch {\n      /* non-writable in this environment */\n    }\n\n    document.addEventListener('click', handleClick, { capture: true });\n    document.addEventListener('pointerdown', handlePointerDown, { passive: true });\n    document.addEventListener('pointerup', handlePointerUp, { passive: true });\n\n    return () => {\n      document.removeEventListener('click', handleClick, { capture: true });\n      document.removeEventListener('pointerdown', handlePointerDown);\n      document.removeEventListener('pointerup', handlePointerUp);\n      if (assignPatched) {\n        try {\n          window.location.assign = origAssign;\n        } catch {\n          /* ignore */\n        }\n      }\n      if (replacePatched) {\n        try {\n          window.location.replace = origReplace;\n        } catch {\n          /* ignore */\n        }\n      }\n    };\n  }, [tryNavigate]);\n}\n\n// ─── Client navigation config ─────────────────────────────────────────────────\n\nexport interface ClientNav {\n  /** Framework adapter to use for client-side navigation. @default 'tanstack' */\n  framework?: 'tanstack' | 'nextjs';\n  /**\n   * Intercept same-origin `<a>` clicks and `window.location` calls from web\n   * components and route them through the framework router.\n   * @default true\n   */\n  interceptLinks?: boolean;\n}\n\n// Framework adapter setups are registered in navigation-setups.ts to avoid circular imports.\n"]}

package/dist/chunk-H3PJJKAQ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/api/translations-key.ts","../src/api/messages.ts","../src/utils/errors.ts","../src/providers/i18n-factory.ts","../src/twilight/context.ts"],"names":[],"mappings":"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","file":"chunk-H3PJJKAQ.js","sourcesContent":["/**\n * @fileoverview The translations query key, on its own, importing nothing.\n *\n * Three places read the cached translations — `rootBeforeLoad`, the hydration\n * path in `tanstack/router.tsx`, and the lazy `i18n` accessor in\n * `twilight/context.ts` — and all three have to agree on the key or the\n * hydrated page misses the entry it was just handed and refetches. One\n * definition is the only way to keep that true.\n *\n * It lives here rather than in `api/translations.ts`, where it would naturally\n * sit, because **`twilight/context.ts` cannot afford that module's imports**.\n * `api/translations` pulls in `api/client`, which pulls in `ky`; `context.ts`\n * is imported directly by tests that mock `ky`, and adding that edge made six\n * of them stop being mocked and start issuing real requests to `api.salla.dev`\n * (`tests/routes/rootBeforeLoad.test.ts`, bisected to exactly this import). A\n * leaf module with no imports of its own cannot do that to anyone.\n */\n\n/**\n * @param locale is part of the key because each file on the CDN holds one\n * language. The global file this replaced carried every language and was\n * sliced after the cache, so a key without the locale was correct then and is\n * a wrong-language bug now: `/ar` → `/en` would reuse the Arabic entry.\n */\nexport function translationsQueryKey(locale: string): [string, string] {\n  return ['translations', locale];\n}\n\n/**\n * The merchant's own wording for one store and one language.\n *\n * Separate from {@link translationsQueryKey} rather than folded into it,\n * because the two files have different lifetimes and different audiences: the\n * platform's copy is the same object for every store on the CDN, and this one\n * is a single merchant's overrides. Keeping them apart means a store with no\n * overrides never invalidates, refetches or dehydrates anything on its account.\n *\n * @param storeId is `settings.store.id` — the Optimus-encoded numeric id, which\n * is what names the object. It is safe in a key even though the locale-only key\n * deliberately avoids naming a store: that warning is about a store *resolved\n * from the request*, which differs between server and client. This one is read\n * out of the settings payload, so both sides compute it from the same\n * dehydrated data and agree.\n */\nexport function storeTranslationsQueryKey(\n  storeId: string | number,\n  locale: string\n): [string, string, string] {\n  return ['translations', String(storeId), locale];\n}\n","/**\n * @fileoverview Composing one language's messages out of the query cache.\n *\n * **There are three places that build an i18n instance**, and they have to\n * agree on more than the key: `rootBeforeLoad`, the hydration path in\n * `tanstack/router.tsx`, and the lazy `i18n` accessor in `twilight/context.ts`.\n * When the platform's copy was the only source, agreeing on\n * `translationsQueryKey` was enough. It is not any more — a merchant's own\n * wording is a second cache entry, and a reader that knows about one and not\n * the other renders different text from the page beside it.\n *\n * That is exactly what shipped in #366: the server rendered the merchant's\n * words and hydration replaced them with the platform's, because only\n * `rootBeforeLoad` had been taught to merge. Greptile caught it. This module is\n * the single answer to \"what are the messages for this locale\", so the next\n * source cannot be added to one reader and forgotten in two.\n *\n * It lives beside `translations-key.ts` and imports nothing at runtime for the\n * same reason that file does: `twilight/context.ts` cannot afford\n * `api/translations`, which pulls in `api/client` and therefore `ky`, and tests\n * that mock `ky` stop being mocked the moment that edge exists.\n */\nimport type { QueryClient } from '@tanstack/react-query';\nimport { translationsQueryKey } from './translations-key';\nimport type { TranslationMessages } from '../providers/I18nProvider';\n\nexport type Messages = Record<string, unknown>;\n\nexport function isPlainObject(value: unknown): value is Messages {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * `overrides` laid over `base`, one leaf at a time.\n *\n * Recursive rather than a spread, because both files are nested by group\n * (`common.errors.500`) and a top-level spread would make a merchant who\n * overrode one string inside `common` lose every other string in it. The\n * merchant's value wins at the leaf, and a group they never touched is left\n * exactly as the platform sent it.\n *\n * A type conflict — one side an object where the other is a string — resolves\n * to the merchant's value. It is the more specific of the two and there is no\n * sensible way to merge a string into a group; the alternative, keeping the\n * platform's, would mean a merchant's edit silently doing nothing.\n */\nexport function mergeMessages(base: Messages, overrides: Messages): Messages {\n  const merged: Messages = { ...base };\n\n  for (const [key, value] of Object.entries(overrides)) {\n    const existing = merged[key];\n    merged[key] =\n      isPlainObject(existing) && isPlainObject(value) ? mergeMessages(existing, value) : value;\n  }\n\n  return merged;\n}\n\n/**\n * This store's overrides for `locale`, if any were fetched into the cache.\n *\n * Found by **shape** rather than by asking the settings for a store id, and\n * that is deliberate: the two readers that were missing the merge have a\n * `queryClient` and a locale between them and nothing else, and reaching for\n * `api/store` from `twilight/context.ts` would drag `ky` in through the back\n * door. One document serves one store — a request naming a different one is\n * redirected with `reloadDocument` — so at most one such entry per locale\n * exists, and matching `['translations', <anything>, <locale>]` cannot pick up\n * somebody else's.\n */\nfunction cachedOverrides(queryClient: QueryClient, locale: string): Messages | undefined {\n  const entries = queryClient.getQueriesData<Messages>({ queryKey: ['translations'] });\n\n  for (const [key, data] of entries) {\n    if (key.length === 3 && key[2] === locale && isPlainObject(data)) {\n      return data;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * The messages for `locale`: the platform's copy with this merchant's over it.\n *\n * Reads only — whoever wants the merchant's file in the cache has to have put\n * it there, which `rootBeforeLoad` does and only when the settings say there is\n * one. A reader that runs without it simply gets the platform's copy, which is\n * the same thing it got before any of this existed.\n */\nexport function messagesForLocale(\n  queryClient: QueryClient | undefined,\n  locale: string\n): TranslationMessages | undefined {\n  const common = queryClient?.getQueryData<TranslationMessages>(translationsQueryKey(locale));\n  const overrides = queryClient ? cachedOverrides(queryClient, locale) : undefined;\n\n  return composeMessages(common, overrides, locale);\n}\n\n/**\n * The same composition from values rather than from the cache.\n *\n * `rootBeforeLoad` has both in hand already — it just awaited them — so it\n * composes directly instead of reading back what it put in.\n */\nexport function composeMessages(\n  common: TranslationMessages | null | undefined,\n  overrides: Messages | null | undefined,\n  locale: string\n): TranslationMessages | undefined {\n  if (!overrides || Object.keys(overrides).length === 0) return common ?? undefined;\n\n  const base = common?.[`${locale}.trans`];\n\n  return {\n    [`${locale}.trans`]: mergeMessages(isPlainObject(base) ? base : {}, overrides) as Record<\n      string,\n      string\n    >,\n  };\n}\n","export class SettingsError extends Error {\n  constructor(message?: string) {\n    super(message ?? 'Store settings could not be loaded.');\n    this.name = 'SettingsError';\n  }\n}\n","import { createInstance, type i18n as I18nInstance } from 'i18next';\nimport { initReactI18next } from 'react-i18next';\n\nexport type TranslationMessages = Record<string, Record<string, string>>;\n\n/**\n * Creates a new i18next instance for the given locale.\n *\n * @param locale - Active locale code, e.g. `'ar'`\n * @param translations - App translations from the Salla API (store-specific)\n * @param themeTranslations - Bundled theme translations (static defaults)\n */\nexport function createI18nInstance(\n  locale: string,\n  translations?: TranslationMessages,\n  themeTranslations?: TranslationMessages\n): I18nInstance {\n  const instance = createInstance();\n  const transKey = `${locale}.trans`;\n\n  instance.use(initReactI18next).init({\n    lng: locale,\n    fallbackLng: locale,\n    ns: ['app', 'theme'],\n    defaultNS: 'app',\n    fallbackNS: 'theme',\n    resources: {\n      [locale]: {\n        app: translations?.[transKey] ?? {},\n        theme: themeTranslations?.[transKey] ?? {},\n      },\n    },\n    interpolation: { escapeValue: false },\n    react: { useSuspense: false },\n    keySeparator: '.',\n    nsSeparator: false,\n  });\n\n  return instance;\n}\n\n/**\n * Creates i18n instance for testing\n * @param locale - Locale code (default: 'ar')\n * @param translations - Optional translations\n */\nexport function createTestI18n(locale = 'ar', translations?: TranslationMessages): I18nInstance {\n  return createI18nInstance(locale, translations);\n}\n","import type { QueryClient } from '@tanstack/react-query';\nimport type { i18n } from 'i18next';\nimport type { StoreContext } from '../api/store';\nimport type { AppSnippet, AppSettings } from '../api/apps';\nimport { FALLBACK_LOCALE, getLanguageInfo } from '../providers/locale-constants';\nimport { createI18nInstance } from '../providers/i18n-factory';\nimport { messagesForLocale } from '../api/messages';\nimport { SettingsError } from '../utils/errors';\nimport type { ActiveScope } from '../utils/cookies';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface TwilightLocation<TSearch = Record<string, unknown>> {\n  href: string;\n  pathname: string;\n  search: TSearch;\n  searchStr: string;\n  state: Record<string, unknown>;\n  hash: string;\n}\n\nexport interface PageContext {\n  slug: string;\n  id?: string | number;\n  title: string;\n  url?: string;\n  parent?: { id: string | number; name: string; url: string } | null;\n  breadcrumbs?: { name: string; url: string }[];\n}\n\nexport interface TwilightContext {\n  queryClient: QueryClient;\n  settings: StoreContext;\n  locale: string;\n  routeId: string;\n  location: TwilightLocation;\n  authToken: string | null;\n  /**\n   * The selected market and, once bullet delivery confirmed one, its branch\n   * allocation — the full object the SDK sends as `s-scope-*` headers. Seeded from\n   * the `scope` cookie on the server; see {@link ActiveScope}.\n   */\n  scope: ActiveScope | null;\n  /** `scope.id`, kept for callers that only need the market. */\n  scopeId: string | null;\n  /**\n   * Which store this request is for, when something other than the hostname says\n   * so — the `?storeId=` a preview was opened with, or the cookie remembering it.\n   *\n   * Null on a live storefront, where the hostname is the answer and there is\n   * nothing to carry. See {@link resolveRequestStoreId}.\n   */\n  storeId: string | null;\n  /**\n   * Which store the first segment of this request's path named, on a host where\n   * the store is the root of every URL: `mtgr-alaatr-2` for\n   * `https://preview.salla.design/mtgr-alaatr-2/cart`.\n   *\n   * Null whenever something else named the store, and on every merchant domain.\n   * See {@link resolveRequestStoreBase}.\n   */\n  storeBase: string | null;\n  /**\n   * Where {@link storeBase} sits in this request's paths: behind the locale on a\n   * Salla shared host (`/ar/dev-x/cart`, named by the dispatcher), in front of it\n   * everywhere else. See {@link resolveAddressedStore}.\n   */\n  storeBaseFollowsLocale: boolean;\n  /**\n   * Which version of the theme's settings this request asked for — the\n   * `?versionId=` an editor preview or a local dev session was opened with, or\n   * the cookie remembering it.\n   *\n   * Null on an ordinary storefront visit, which is the common case: nothing\n   * named a version, so the store's live one is what the API answers with. See\n   * {@link resolveRequestVersionId}.\n   */\n  versionId: string | null;\n  /**\n   * The host this request arrived on, captured server-side.\n   *\n   * A theme worker is deployed with no vars and no bindings, so the request is\n   * the only thing that knows which storefront it is serving. On the client this\n   * is `window.location.host`; on the server nothing else has it.\n   */\n  requestHost: string | null;\n  i18n: i18n;\n  dir: 'ltr' | 'rtl';\n  page?: PageContext;\n  /** Installed apps' snippets, fetched in rootBeforeLoad so AppsSnippets can render CDN\n   *  <script> tags during SSR (React Query isn't dehydrated here, so useQuery has no SSR data). */\n  appsSnippets?: AppSnippet[];\n  /** Per-app public `app.*` buckets, fetched in rootBeforeLoad so rootHead can install the\n   *  `Salla.appScope` factory inline at parse time — ahead of the snippets' onReady callbacks. */\n  appsSettings?: AppSettings;\n  extras?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Internal Store\n// ============================================================================\n\nconst DEFAULT_LOCATION: TwilightLocation = {\n  href: '',\n  pathname: '',\n  search: {},\n  searchStr: '',\n  state: {},\n  hash: '',\n};\n\ninterface ContextData {\n  queryClient: QueryClient;\n  settings: StoreContext | null;\n  locale: string;\n  routeId: string;\n  location: TwilightLocation;\n  authToken: string | null;\n  scope: ActiveScope | null;\n  storeId: string | null;\n  storeBase: string | null;\n  storeBaseFollowsLocale: boolean;\n  versionId: string | null;\n  requestHost: string | null;\n  i18n?: i18n;\n  page?: PageContext;\n  appsSnippets?: AppSnippet[];\n  appsSettings?: AppSettings;\n  extras?: Record<string, unknown>;\n}\n\nconst DEFAULT_DATA: ContextData = {\n  queryClient: null as unknown as QueryClient,\n  settings: null,\n  locale: FALLBACK_LOCALE,\n  routeId: '',\n  location: { ...DEFAULT_LOCATION },\n  authToken: null,\n  scope: null,\n  storeId: null,\n  storeBase: null,\n  storeBaseFollowsLocale: false,\n  versionId: null,\n  requestHost: null,\n  i18n: undefined,\n  page: undefined,\n};\n\n// ============================================================================\n// Storage: AsyncLocalStorage (server) or module-level store (client)\n// ============================================================================\n\ntype AsyncLocalStore<T> = { getStore(): T | undefined; run(val: T, fn: () => unknown): unknown };\n\n// Initialize ALS at module load time for SSR — no race condition\ntype AsyncHooks = { AsyncLocalStorage: new <T>() => AsyncLocalStore<T> };\n\n// workerd has no global `require`, so a bundled `require()` throws there; it does have\n// `process.getBuiltinModule` (so does Node >= 20.16), which keeps this out of the browser bundle.\nfunction loadAsyncHooks(): AsyncHooks | null {\n  const proc = (globalThis as { process?: { getBuiltinModule?: (id: string) => unknown } }).process;\n  try {\n    const builtin = proc?.getBuiltinModule?.('node:async_hooks') as AsyncHooks | undefined;\n    if (builtin?.AsyncLocalStorage) return builtin;\n  } catch {\n    /* fall through to require */\n  }\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    return require('node:async_hooks') as AsyncHooks;\n  } catch {\n    return null;\n  }\n}\n\nconst isServer = typeof window === 'undefined';\n// One instance per isolate, so a re-evaluated or duplicated copy of this module (dev\n// reloads, src next to dist) reads the scope the request middleware opened.\nconst ALS_KEY = Symbol.for('salla.twilight.context.als');\nlet _als: AsyncLocalStore<ContextData> | null = null;\nif (isServer) {\n  const registry = globalThis as { [ALS_KEY]?: AsyncLocalStore<ContextData> };\n  const hooks = registry[ALS_KEY] ? null : loadAsyncHooks();\n  if (hooks) registry[ALS_KEY] = new hooks.AsyncLocalStorage<ContextData>();\n  _als = registry[ALS_KEY] ?? null;\n}\n\n// Without request isolation every request would share `clientStore`: one visitor's\n// auth token and store settings rendered into another's page.\nfunction assertRequestIsolation(): void {\n  if (isServer && !_als) {\n    throw new Error(\n      '[Twilight] AsyncLocalStorage is unavailable; refusing to share request state.'\n    );\n  }\n}\n\n// The browser's store, shared by every copy of this module on the page like the ALS above,\n// so a loader in one copy reads the location and token the router wrote through another.\nconst CLIENT_KEY = Symbol.for('salla.twilight.context.client');\nconst clientRegistry = globalThis as {\n  [CLIENT_KEY]?: { store: ContextData; listeners: Set<() => void> };\n};\nconst clientShared = (clientRegistry[CLIENT_KEY] ??= {\n  store: { ...DEFAULT_DATA },\n  listeners: new Set<() => void>(),\n});\nconst clientStore: ContextData = clientShared.store;\n\nfunction getTwilightStore(): ContextData {\n  assertRequestIsolation();\n  if (_als) {\n    const store = _als.getStore();\n    if (!store)\n      throw new Error('[Twilight] No request context. Wrap with runWithTwilightContext().');\n    return store;\n  }\n  return clientStore;\n}\n\nfunction writableStore(): ContextData {\n  if (_als) {\n    const store = _als.getStore();\n    if (store) return store;\n  }\n  return clientStore;\n}\n\nfunction mergeIntoStore(store: ContextData, partial: Partial<TwilightContext>): void {\n  if ('queryClient' in partial && partial.queryClient) store.queryClient = partial.queryClient;\n  if ('settings' in partial && partial.settings != null) store.settings = partial.settings;\n  if ('locale' in partial && partial.locale != null) store.locale = partial.locale;\n  if ('routeId' in partial && partial.routeId != null) store.routeId = partial.routeId;\n  if ('location' in partial && partial.location != null)\n    store.location = { ...store.location, ...partial.location };\n  if ('authToken' in partial && partial.authToken !== undefined)\n    store.authToken = partial.authToken ?? null;\n  if ('scope' in partial && partial.scope !== undefined) store.scope = partial.scope ?? null;\n  else if ('scopeId' in partial && partial.scopeId !== undefined)\n    store.scope = partial.scopeId == null ? null : { id: partial.scopeId };\n  if ('storeId' in partial && partial.storeId !== undefined)\n    store.storeId = partial.storeId ?? null;\n  if ('storeBase' in partial && partial.storeBase !== undefined)\n    store.storeBase = partial.storeBase ?? null;\n  if ('storeBaseFollowsLocale' in partial && partial.storeBaseFollowsLocale !== undefined)\n    store.storeBaseFollowsLocale = partial.storeBaseFollowsLocale === true;\n  if ('versionId' in partial && partial.versionId !== undefined)\n    store.versionId = partial.versionId ?? null;\n  if ('requestHost' in partial && partial.requestHost !== undefined)\n    store.requestHost = partial.requestHost ?? null;\n  if ('i18n' in partial && partial.i18n != null) store.i18n = partial.i18n;\n  if ('page' in partial) store.page = partial.page;\n  if ('appsSnippets' in partial) store.appsSnippets = partial.appsSnippets;\n  if ('appsSettings' in partial) store.appsSettings = partial.appsSettings;\n  if ('extras' in partial) store.extras = partial.extras;\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\nexport function runWithTwilightContext<T>(partial: Partial<TwilightContext>, fn: () => T): T {\n  assertRequestIsolation();\n  if (_als) {\n    const data: ContextData = { ...DEFAULT_DATA };\n    mergeIntoStore(data, partial);\n    return _als.run(data, fn) as T;\n  }\n  mergeIntoStore(clientStore, partial);\n  return fn();\n}\n\n// Client-only subscription so React consumers (useRouteId/useIsHome/…) re-render\n// when navigation mutates the module store. Mirrors hooks/useWishlist.ts.\nconst listeners = clientShared.listeners;\n\nexport function subscribeTwilight(listener: () => void): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\nexport function updateTwilightContext(partial: Partial<TwilightContext>): void {\n  mergeIntoStore(getTwilightStore(), partial);\n  // Server uses AsyncLocalStorage and has no React subscribers; notify on client only.\n  if (typeof window !== 'undefined') {\n    for (const listener of listeners) listener();\n  }\n}\n\n/**\n * Whether store settings are available, without throwing.\n *\n * `getTwilightContext().settings` throws a `SettingsError` when the store is\n * empty, which is fatal inside a head function during hydration. Callers that\n * need to *test* availability must use this instead of a try/catch around the\n * getter. Returns false when there is no request context at all (server-side\n * calls outside `runWithTwilightContext`).\n */\nexport function hasTwilightSettings(): boolean {\n  try {\n    return getTwilightStore().settings != null;\n  } catch {\n    return false;\n  }\n}\n\n/** What a request addressed, as opposed to what it is. */\nexport interface RequestAddressing {\n  storeId: string | null;\n  storeBase: string | null;\n  storeBaseFollowsLocale: boolean;\n  versionId: string | null;\n  requestHost: string | null;\n}\n\n/**\n * What this request named and the host it arrived on, without throwing.\n *\n * Separate from {@link getTwilightContext} because store identity is read while\n * deciding *what to fetch* — before there is a context worth having — and on the\n * server outside a request the getter throws. A caller asking \"which store?\" has\n * a sane answer for \"none named\"; it has none for an exception.\n *\n * The version rides along rather than getting an accessor of its own: it is read\n * at the same moment, for the same reason, and by the same callers, and a second\n * copy of this try/catch would be a second thing to remember to widen.\n */\nexport function getRequestStore(): RequestAddressing {\n  try {\n    const data = getTwilightStore();\n    return {\n      storeId: data.storeId,\n      storeBase: data.storeBase,\n      storeBaseFollowsLocale: data.storeBaseFollowsLocale,\n      versionId: data.versionId,\n      requestHost: data.requestHost,\n    };\n  } catch {\n    return {\n      storeId: null,\n      storeBase: null,\n      storeBaseFollowsLocale: false,\n      versionId: null,\n      requestHost: null,\n    };\n  }\n}\n\nexport function getTwilightContext(): TwilightContext {\n  const data = getTwilightStore();\n  return {\n    get queryClient() {\n      return data.queryClient;\n    },\n    get settings() {\n      if (!data.settings) throw new SettingsError();\n      return data.settings;\n    },\n    get locale() {\n      return data.locale;\n    },\n    get routeId() {\n      return data.routeId;\n    },\n    get location() {\n      return data.location;\n    },\n    get authToken() {\n      return data.authToken;\n    },\n    get scope() {\n      return data.scope;\n    },\n    get scopeId() {\n      return data.scope?.id ?? null;\n    },\n    get storeId() {\n      return data.storeId;\n    },\n    get storeBase() {\n      return data.storeBase;\n    },\n    get storeBaseFollowsLocale() {\n      return data.storeBaseFollowsLocale;\n    },\n    get versionId() {\n      return data.versionId;\n    },\n    get requestHost() {\n      return data.requestHost;\n    },\n    get i18n() {\n      if (!data.i18n) {\n        // Composed the same way as `rootBeforeLoad` and the hydration path —\n        // the platform's copy with this merchant's over it. See\n        // `api/messages.ts`: this accessor reading one entry while the others\n        // read two is precisely the drift that module exists to stop.\n        data.i18n = createI18nInstance(\n          data.locale,\n          messagesForLocale(data.queryClient, data.locale)\n        );\n      }\n      return data.i18n;\n    },\n    get dir() {\n      return getLanguageInfo(data.locale).dir;\n    },\n    get page() {\n      return data.page;\n    },\n    get appsSnippets() {\n      return data.appsSnippets;\n    },\n    get appsSettings() {\n      return data.appsSettings;\n    },\n    get extras() {\n      return data.extras;\n    },\n  };\n}\n\n/** @internal Reset store for testing */\nexport function resetForTesting(): void {\n  Object.assign(writableStore(), { ...DEFAULT_DATA });\n}\n"]}

package/dist/chunk-JDLXT6VI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/api/store.ts"],"names":[],"mappings":";;;;;AASA,IAAM,qBAAA,GAAwB;AAAA,EAC5B,OAAA;AAAA,EACA,UAAA;AAAA,EACA,OAAA;AAAA,EACA,gBAAA;AAAA,EACA,mBAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA;AAAA,EACA,UAAA;AAAA,EACA,iBAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA;AACF,CAAA;AA2EA,SAAS,iBAAiB,SAAA,EAA8D;AACtF,EAAA,IAAI,CAAC,WAAW,OAAO,MAAA;AAGvB,EAAA,OAAO,MAAA,CAAO,MAAA,CAAO,SAAS,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,MAAU,EAAE,QAAA,EAAU,IAAA,CAAK,IAAA,EAAM,GAAG,MAAK,CAAE,CAAA;AAClF;AAEO,IAAM,KAAA,GAAQ;AAAA,EACnB,QAAA,EAAU,OAAO,eAAA,KAA2D;AAC1E,IAAA,MAAM,UAAA,GAAa,mBAAmB,sBAAA,EAAuB;AAE7D,IAAA,IAAI,CAAC,UAAA,EAAY;AACf,MAAA,OAAA,CAAQ,KAAK,gDAAgD,CAAA;AAC7D,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,MAAM,aAAA,GAAgB,qBAAA,CAAsB,GAAA,CAAI,CAAC,CAAA,KAAM,aAAa,CAAC,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AACjF,IAAA,MAAM,QAAQ,cAAA,EAAe;AAC7B,IAAA,MAAM,MAAA,GAAS,SAAS,IAAA,GAAO,CAAA,EAAG,aAAa,CAAA,OAAA,EAAU,KAAA,CAAM,EAAE,CAAA,CAAA,GAAK,aAAA;AAEtE,IAAA,IAAI;AACF,MAAA,MAAM,OAAO,MAAM,GAAA,CAKhB,GAAA,CAAI,CAAA,eAAA,EAAkB,MAAM,CAAA,CAAA,EAAI;AAAA,QAC/B,OAAA,EAAS,GAAA;AAAA,QACT,OAAA,EAAS,EAAE,CAAC,uBAAuB,GAAG,UAAA;AAAW,OAClD,EACA,IAAA,EAAqC;AAExC,MAAA,MAAM,OAAO,IAAA,EAAM,IAAA;AACnB,MAAA,IAAI,CAAC,MAAM,OAAO,IAAA;AAGlB,MAAA,MAAM,SAAA,GAAY,gBAAA,CAAiB,IAAA,CAAK,SAAS,CAAA;AAEjD,MAAA,OAAO;AAAA,QACL,OAAO,IAAA,CAAK,KAAA;AAAA,QACZ,OAAO,IAAA,CAAK,KAAA;AAAA,QACZ,SAAA;AAAA,QACA,YAAY,IAAA,CAAK,UAAA;AAAA,QACjB,mBAAmB,IAAA,CAAK,iBAAA;AAAA,QACxB,SAAS,IAAA,CAAK,OAAA;AAAA,QACd,OAAO,IAAA,CAAK,KAAA;AAAA,QACZ,WAAW,IAAA,CAAK,SAAA;AAAA,QAChB,YAAY,IAAA,CAAK,UAAA;AAAA,QACjB,MAAM,IAAA,CAAK,IAAA;AAAA,QACX,QAAQ,IAAA,CAAK,MAAA;AAAA,QACb,OAAO,IAAA,CAAK,KAAA;AAAA,QACZ,GAAI,KAAA,IAAS,EAAE,gBAAA,EAAkB,MAAM,EAAA;AAAG,OAC5C;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,4BAA4B,KAAK,CAAA;AAC/C,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA;AAAA,EAEA,OAAA,EAAS;AAAA,IACP,QAAA,EAAU,CAAC,eAAA,KACT,YAAA,CAAkC;AAAA,MAChC,QAAA,EAAU;AAAA,QACR,OAAA;AAAA,QACA,UAAA;AAAA,QACA,eAAA;AAAA,QACA,oBAAmB,CAAE,MAAA;AAAA,QACrB,cAAA,EAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAQf,uBAAA;AAAwB,OAC1B;AAAA,MACA,OAAA,EAAS,MAAM,KAAA,CAAM,QAAA,CAAS,eAAe;AAAA,KAC9C;AAAA;AAEP","file":"chunk-JDLXT6VI.js","sourcesContent":["import { queryOptions } from '@tanstack/react-query';\nimport { api, getActiveScope, STORE_IDENTIFIER_HEADER } from './client';\nimport type { Store, Theme, Language, JitsuConfig } from '../types';\nimport { getTwilightContext } from '../twilight/context';\nimport { resolveStoreIdentifier } from '../utils/store-identity';\nimport { requestedThemeVersionId } from '../utils/theme-version';\n\nexport { resolveStoreIdentifier };\n\nconst DEFAULT_INCLUDE_ITEMS = [\n  'store',\n  'settings',\n  'theme',\n  'theme_settings',\n  'external_services',\n  'currencies',\n  'languages',\n  'payments',\n  'product_widgets',\n  'rating',\n  'ratings',\n  'user',\n];\n\n/** Twig's `salla.init({ user })` object; the endpoint ignores the token, so always the guest. */\nexport interface SettingsUser {\n  type: 'guest' | 'user';\n  id?: number | string | null;\n  language_code?: string;\n  currency_code?: string;\n  country_code?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Raw API response for settings endpoint.\n * Languages come as object: { \"AR\": { code, name, ... }, \"EN\": {...} }\n */\ninterface SettingsApiResponse {\n  store?: Store;\n  theme?: Theme;\n  languages?: Record<string, Language>;\n  currencies?: Record<\n    string,\n    { code: string; name: string; symbol: string; amount: number; country_code: string }\n  >;\n  external_services?: Record<string, unknown>;\n  headers?: Record<string, unknown>;\n  login?: { url: string; turnstile_site_key: string };\n  affiliate?: { utm_url: string; cta_enabled: boolean };\n  debug?: boolean;\n  trace_console?: boolean;\n  policy_url?: string;\n  user?: SettingsUser;\n  swoole?: string[];\n  jitsu?: JitsuConfig;\n}\n\n/**\n * Central settings context - single source of truth for all API data.\n * Contains everything from the settings endpoint response after processing.\n */\nexport interface StoreContext {\n  store?: Store;\n  theme?: Theme;\n  /** Languages as array after conversion from API object format */\n  languages?: Language[];\n  currencies?: Record<\n    string,\n    { code: string; name: string; symbol: string; amount: number; country_code: string }\n  >;\n  external_services?: Record<string, unknown>;\n  headers?: Record<string, unknown>;\n  login?: { url: string; turnstile_site_key: string };\n  affiliate?: { utm_url: string; cta_enabled: boolean };\n  debug?: boolean;\n  trace_console?: boolean; // todo:: remove it\n  policy_url?: string;\n  user?: SettingsUser;\n  /** API paths the SDK sends with `s-store-api-version: swoole` */\n  swoole?: string[];\n  /** Where the SDK's analytics send events, and which ones; without it the SDK tracks nothing. */\n  jitsu?: JitsuConfig;\n  /**\n   * The scope these settings were requested with; absent when none was. Not from\n   * the API: stamped by `store.settings`, so `resolveThemeVersionId` can tell\n   * whether the version they name still answers the scope that is active now.\n   */\n  requestedScopeId?: string;\n}\n\n/**\n * Converts languages object from API to array format.\n * API returns: { \"AR\": { code, name, ... }, \"EN\": { ... } }\n * We need: [{ code, name, ... }, { code, name, ... }]\n * todo:: return the languages as object from the APIs to avoid this\n */\nfunction languagesToArray(languages?: Record<string, Language>): Language[] | undefined {\n  if (!languages) return undefined;\n  // The SDK's localization modal reads `lang.iso_code` (not `code`) when a language is\n  // selected — without it the switch navigates to `/undefined/...`.\n  return Object.values(languages).map((lang) => ({ iso_code: lang.code, ...lang }));\n}\n\nexport const store = {\n  settings: async (storeIdentifier?: string): Promise<StoreContext | null> => {\n    const identifier = storeIdentifier ?? resolveStoreIdentifier();\n\n    if (!identifier) {\n      console.warn('[store.settings] No store identifier available');\n      return null;\n    }\n\n    const includeParams = DEFAULT_INCLUDE_ITEMS.map((i) => `include[]=${i}`).join('&');\n    const scope = getActiveScope();\n    const params = scope != null ? `${includeParams}&scope=${scope.id}` : includeParams;\n\n    try {\n      const json = await api\n        // Sent explicitly rather than left to the client's own resolution, so\n        // the identifier this function checked is the identifier that travels.\n        // They agree today; a caller passing one and being answered about\n        // another is the failure this makes impossible rather than unlikely.\n        .get(`store/settings?${params}`, {\n          timeout: 5000,\n          headers: { [STORE_IDENTIFIER_HEADER]: identifier },\n        })\n        .json<{ data?: SettingsApiResponse }>();\n\n      const data = json?.data;\n      if (!data) return null;\n\n      // Convert languages from object to array\n      const languages = languagesToArray(data.languages);\n\n      return {\n        store: data.store,\n        theme: data.theme,\n        languages,\n        currencies: data.currencies,\n        external_services: data.external_services,\n        headers: data.headers,\n        login: data.login,\n        affiliate: data.affiliate,\n        policy_url: data.policy_url,\n        user: data.user,\n        swoole: data.swoole,\n        jitsu: data.jitsu,\n        ...(scope && { requestedScopeId: scope.id }),\n      };\n    } catch (error) {\n      console.error('[store.settings] Failed:', error);\n      return null;\n    }\n  },\n\n  queries: {\n    settings: (storeIdentifier?: string) =>\n      queryOptions<StoreContext | null>({\n        queryKey: [\n          'store',\n          'settings',\n          storeIdentifier,\n          getTwilightContext().locale,\n          getActiveScope(),\n          // Two versions of one store's settings are two different answers, and\n          // this is the query whose answer decides what every other call is\n          // pinned to. `requestedThemeVersionId` rather than the resolved one:\n          // the resolved value falls back to what these settings report, so it\n          // is not knowable until after this query has run — the key would be\n          // one thing on the server and another on the client, and the hydrated\n          // page would refetch the settings it was just handed.\n          requestedThemeVersionId(),\n        ],\n        queryFn: () => store.settings(storeIdentifier),\n      }),\n  },\n};\n"]}