@tokenoftrust/storefront-runner 2.4.84 → 2.4.85

package/apps/storefront/src/lib/admin/README.md

@@ -81,8 +81,8 @@ lib/admin/
   testable source of truth for what the floating Ask button emits — the full
   tenant envelope, active tab, selected record id (if any), role +
   permissions (derived from `isStaff`), active filters, and evidence context.
-  `admin.astro`'s `is:inline` script mirrors this logic in plain JS (inline
-  scripts can't import modules) and emits it on Ask-button click as
+  The processed `adminShell.ts` client imports this builder and emits its
+  result on Ask-button click as
   `window.__toTAdminAsk` and a `tot:admin-ask` `CustomEvent` — **dev-inspectable
   only, no chat backend yet.** The envelope changes whenever the active tab
   changes (kept current by `setAskContext`) and is rebuilt fresh on click so a
@@ -117,6 +117,6 @@ const orders = getOrdersViewModel({
 - **Tabs/pages → lib, never lib → tabs/pages.** Nothing under `lib/admin/**`
   imports from `components/admin/**` or `pages/admin.astro`. Tab components
   and `admin.astro` are free to import from here (`admin.astro` already does,
-  for `resolveAdminTenantMode` and the Ask-envelope logic it mirrors inline).
+  for `resolveAdminTenantMode` and the shared shell configuration).
 - Gaps in these contracts should go back to the workstream board as a
   decision, not get patched from a tab's unit.

package/apps/storefront/src/lib/admin/adminShell.ts

@@ -4,7 +4,7 @@
  * the tablists. Imported from a processed `<script>` in admin.astro (ADR 0013):
  * type-checked, bundled, tree-shaken, and its bundle hash is in the enforced
  * CSP. The Ask envelope is built with the shared, unit-tested
- * `buildAskEnvelope` (ai/askEnvelope) instead of a hand-copied inline mirror.
+ * `buildAskEnvelope` (ai/askEnvelope).
  *
  * There is no chat backend yet — the Ask envelope is emitted for dev inspection
  * only (window.__toTAdminAsk + a "tot:admin-ask" CustomEvent), never sent over
@@ -12,33 +12,23 @@
  */
 import { buildAskEnvelope, type AskEnvelope } from "./ai/askEnvelope";
 
-const TAB_IDS = [
-  "orders",
-  "products",
-  "subscriptions",
-  "customers",
-  "fulfillment",
-  "reporting",
-  "ai-workflows",
-  "blog",
-  "publish",
-  "integrations",
-  "settings",
-] as const;
-
-const ASK_CONTEXTS: Record<string, string> = {
-  orders: "Orders",
-  products: "Products",
-  subscriptions: "Subscriptions",
-  customers: "Customers",
-  fulfillment: "Fulfillment",
-  reporting: "Reporting",
-  "ai-workflows": "AI Workflows",
-  blog: "Blog",
-  publish: "Publish",
-  integrations: "Integrations",
-  settings: "Settings",
-};
+/** Static shell data shared by server-rendered navigation and browser startup. */
+export const ADMIN_SHELL_CONFIG = {
+  workAreas: [
+    { id: "orders", label: "Orders", icon: "i-file" },
+    { id: "products", label: "Products", icon: "i-box" },
+    { id: "subscriptions", label: "Subscriptions", icon: "i-refresh" },
+    { id: "customers", label: "Customers", icon: "i-users" },
+    { id: "fulfillment", label: "Fulfillment", icon: "i-truck" },
+    { id: "reporting", label: "Reporting", icon: "i-chart" },
+    { id: "ai-workflows", label: "AI Workflows", icon: "i-workflows" },
+    { id: "blog", label: "Blog", icon: "i-file" },
+    { id: "publish", label: "Publish", icon: "i-export" },
+    { id: "integrations", label: "Integrations", icon: "i-workflows" },
+    { id: "settings", label: "Settings", icon: "i-gear" },
+  ],
+  defaultTabs: { staff: "orders", merchant: "settings" },
+} as const;
 
 declare global {
   interface Window {
@@ -47,11 +37,13 @@ declare global {
 }
 
 export function initAdminShell(): void {
-  const tabSet = new Set<string>(TAB_IDS);
-  const tabHashPattern = new RegExp(`^#(${TAB_IDS.join("|")})$`);
+  const tabIds = ADMIN_SHELL_CONFIG.workAreas.map(({ id }) => id);
+  const tabSet = new Set<string>(tabIds);
+  const tabHashPattern = new RegExp(`^#(${tabIds.join("|")})$`);
   const canViewInternalGuide =
     document.documentElement.dataset.internalAdminGuide === "true";
-  const defaultTab = canViewInternalGuide ? "orders" : "settings";
+  const defaultTab =
+    ADMIN_SHELL_CONFIG.defaultTabs[canViewInternalGuide ? "staff" : "merchant"];
 
   const buildAskEnvelopeForTab = (id: string): AskEnvelope => {
     const root = document.documentElement.dataset;
@@ -74,7 +66,9 @@ export function initAdminShell(): void {
   };
 
   const setAskContext = (id: string): void => {
-    const label = ASK_CONTEXTS[id] ?? "Storefront";
+    const label =
+      ADMIN_SHELL_CONFIG.workAreas.find((area) => area.id === id)?.label ??
+      "Storefront";
     const askButton = document.querySelector<HTMLElement>("[data-admin-ask]");
     const askContext = document.querySelector<HTMLElement>(
       "[data-admin-ask-context]",
@@ -196,7 +190,7 @@ export function initAdminShell(): void {
       // normalized away to #settings for merchant viewers.
       const hashTab = window.location.hash.slice(1).split("?")[0] ?? "";
       if (!canViewInternalGuide && !tabSet.has(hashTab)) {
-        history.replaceState(null, "", "#settings");
+        history.replaceState(null, "", `#${defaultTab}`);
       }
       if (scroll) requestAnimationFrame(() => scrollToHashTarget(panelId));
       return;
@@ -229,12 +223,6 @@ export function initAdminShell(): void {
     const envelope = buildAskEnvelopeForTab(activeTab);
     window.__toTAdminAsk = envelope;
     document.dispatchEvent(new CustomEvent("tot:admin-ask", { detail: envelope }));
-    if (
-      window.location.hostname === "localhost" ||
-      window.location.hostname === "127.0.0.1"
-    ) {
-      console.debug("[admin:ask]", envelope);
-    }
   });
 
   document.addEventListener("click", (event) => {

package/apps/storefront/src/lib/admin/ai/askEnvelope.ts

@@ -1,10 +1,9 @@
 /**
  * The floating `Ask` button's context envelope (baseline §Horizontal AI
  * Concepts / Ask; ai-evidence-substrate item a). PURE + no I/O so it is
- * unit-testable and reusable from both the inline admin.astro script (via a
- * plain-object mirror, since `is:inline` scripts cannot import modules) and
+ * unit-testable and reusable from the processed adminShell.ts client and
  * any future server-side Ask route. There is no chat backend yet — today
- * this is emitted for dev inspection only (see admin.astro's `data-admin-ask`
+ * this is emitted for dev inspection only (see adminShell.ts's `data-admin-ask`
  * click handler), never sent over the network.
  */
 import type { AdminTenantEnvelope } from "../envelope";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenoftrust/storefront-runner",
-  "version": "2.4.84",
+  "version": "2.4.85",
   "license": "SEE LICENSE IN LICENSE",
   "description": "World-shareable storefront runner: multi-tenant renderer on Astro/Cloudflare. No control plane.",
   "packageManager": "pnpm@11.9.0",