@stacksjs/actions 0.70.87 → 0.70.90

package/dist/dev/api.js

@@ -1,6 +1,94 @@
-// @bun
-import{Lb as K}from"../chunk-h3d81wrg.js";import{existsSync as L}from"fs";import N from"process";import{parseOptions as Q}from"@stacksjs/cli";import{config as T,overridesReady as U}from"@stacksjs/config";import{path as V}from"@stacksjs/path";import{route as X}from"@stacksjs/router";import{generateAutoImportFiles as W,injectGlobalAutoImports as F}from"@stacksjs/server";var x=Q();await U;var $=Number(N.env.PORT_API)||T.ports?.api||3008,R=V.storagePath("framework/auto-imports/models.ts");if(!L(R))await W();await F();try{let z=V.appPath("Lib/typesense-dev.ts");if(L(z)){let B=await import(z);if(typeof B.ensureTypesenseRunning==="function")await B.ensureTypesenseRunning()}}catch(z){let{log:B}=await import("@stacksjs/cli");B.warn(`[api:dev] search engine bootstrap skipped: ${z.message}`)}try{let z=V.appPath("Listener.ts");if(L(z)){let B=await import(z);if(typeof B.handleEvents==="function")await B.handleEvents()}}catch(z){let{log:B}=await import("@stacksjs/cli");B.warn(`[api:dev] failed to bootstrap event listeners \u2014 dispatched events will be ignored: ${z.message}`)}try{let{startModelMigrationWatcher:z}=await import("./migrate-watcher.js");z()}catch(z){let{log:B}=await import("@stacksjs/cli");B.debug(`[api:dev] auto-migrate watcher not started: ${z.message}`)}function _(){let z=V.frameworkPath("defaults/app/Middleware/Cors.ts");if(L(z))return z;try{return`${Bun.resolveSync("@stacksjs/defaults/package.json",N.cwd()).replace(/package\.json$/,"")}app/Middleware/Cors.ts`}catch{return z}}var w=await import(_()),A=w.default;X.use(A.toRouterHandler());var E=/^[a-zA-Z0-9._-]{8,128}$/;X.use(async(z,B)=>{let Y=z?.headers?.get?.("x-request-id")||z?.headers?.get?.("X-Request-ID")||"",Z=typeof Y==="string"&&E.test(Y)?Y:crypto.randomUUID();z._requestId=Z,z._startNs=N.hrtime.bigint();let H=await B();if(H&&H.status===404&&(H.headers.get("content-type")||"").includes("json"))try{let J=await H.clone().json();if(J&&(J.message==="Not Found"||J.error==="Not Found")){let G=new URL(z.url),O={...J,path:G.pathname,method:z.method,request_id:Z},C=new Headers(H.headers);return C.set("X-Request-ID",Z),new Response(JSON.stringify(O),{status:404,headers:C})}}catch{}return H});await X.importRoutes();try{await X.serve({port:$,hostname:"127.0.0.1"}),console.log(`
-  \u279C  API server ready: http://localhost:${$}
-`)}catch(z){if((z?.code||z?.errno)==="EADDRINUSE"||String(z?.message||"").includes("EADDRINUSE"))console.error(`
-[dev/api] Port ${$} is already in use. Kill the other process and re-run \`./buddy dev\`, or set PORT_API to another port.
-`),N.exit(1);throw z}
+import { existsSync } from "node:fs";
+import process from "node:process";
+import { parseOptions } from "@stacksjs/cli";
+import { config, overridesReady } from "@stacksjs/config";
+import { path } from "@stacksjs/path";
+import { route } from "@stacksjs/router";
+import { generateAutoImportFiles, injectGlobalAutoImports } from "@stacksjs/server";
+const _options = parseOptions();
+await overridesReady;
+const port = Number(process.env.PORT_API) || config.ports?.api || 3008, modelsIndex = path.storagePath("framework/auto-imports/models.ts");
+if (!existsSync(modelsIndex))
+  await generateAutoImportFiles();
+await injectGlobalAutoImports();
+try {
+  const typesenseDev = path.appPath("Lib/typesense-dev.ts");
+  if (existsSync(typesenseDev)) {
+    const mod = await import(typesenseDev);
+    if (typeof mod.ensureTypesenseRunning === "function")
+      await mod.ensureTypesenseRunning();
+  }
+} catch (err) {
+  const { log } = await import("@stacksjs/cli");
+  log.warn(`[api:dev] search engine bootstrap skipped: ${err.message}`);
+}
+try {
+  const listenerPath = path.appPath("Listener.ts");
+  if (existsSync(listenerPath)) {
+    const listener = await import(listenerPath);
+    if (typeof listener.handleEvents === "function")
+      await listener.handleEvents();
+  }
+} catch (err) {
+  const { log } = await import("@stacksjs/cli");
+  log.warn(`[api:dev] failed to bootstrap event listeners \u2014 dispatched events will be ignored: ${err.message}`);
+}
+try {
+  const { startModelMigrationWatcher } = await import("./migrate-watcher");
+  startModelMigrationWatcher();
+} catch (err) {
+  const { log } = await import("@stacksjs/cli");
+  log.debug(`[api:dev] auto-migrate watcher not started: ${err.message}`);
+}
+function resolveDefaultsCorsPath() {
+  const vendored = path.frameworkPath("defaults/app/Middleware/Cors.ts");
+  if (existsSync(vendored))
+    return vendored;
+  try {
+    return `${Bun.resolveSync("@stacksjs/defaults/package.json", process.cwd()).replace(/package\.json$/, "")}app/Middleware/Cors.ts`;
+  } catch {
+    return vendored;
+  }
+}
+const corsMod = await import(resolveDefaultsCorsPath()), corsMiddleware = corsMod.default;
+route.use(corsMiddleware.toRouterHandler());
+const SAFE_REQUEST_ID = /^[a-zA-Z0-9._-]{8,128}$/;
+route.use(async (request, next) => {
+  const inbound = request?.headers?.get?.("x-request-id") || request?.headers?.get?.("X-Request-ID") || "", id = typeof inbound === "string" && SAFE_REQUEST_ID.test(inbound) ? inbound : crypto.randomUUID();
+  request._requestId = id;
+  request._startNs = process.hrtime.bigint();
+  const response = await next();
+  if (response && response.status === 404 && (response.headers.get("content-type") || "").includes("json"))
+    try {
+      const body = await response.clone().json();
+      if (body && (body.message === "Not Found" || body.error === "Not Found")) {
+        const url = new URL(request.url), enriched = {
+          ...body,
+          path: url.pathname,
+          method: request.method,
+          request_id: id
+        }, headers = new Headers(response.headers);
+        headers.set("X-Request-ID", id);
+        return new Response(JSON.stringify(enriched), { status: 404, headers });
+      }
+    } catch {}
+  return response;
+});
+await route.importRoutes();
+try {
+  await route.serve({
+    port,
+    hostname: "127.0.0.1"
+  });
+  console.log(`
+  \u279C  API server ready: http://localhost:${port}
+`);
+} catch (err) {
+  if ((err?.code || err?.errno) === "EADDRINUSE" || String(err?.message || "").includes("EADDRINUSE")) {
+    console.error(`
+[dev/api] Port ${port} is already in use. Kill the other process and re-run \`./buddy dev\`, or set PORT_API to another port.
+`);
+    process.exit(1);
+  }
+  throw err;
+}

package/dist/dev/components.js

@@ -1,2 +1,7 @@
-// @bun
-import{parseOptions as f,runCommand as q}from"@stacksjs/cli";import{libsPath as w}from"@stacksjs/path";var x=f();await q("bun run dev",{...x,cwd:w("components/vue")});
+import { parseOptions, runCommand } from "@stacksjs/cli";
+import { libsPath } from "@stacksjs/path";
+const options = parseOptions();
+await runCommand("bun run dev", {
+  ...options,
+  cwd: libsPath("components/vue")
+});

package/dist/dev/dashboard-globals.js

@@ -1,3 +1,89 @@
-// @bun
-import"../chunk-h3d81wrg.js";import{existsSync as $,readdirSync as U,statSync as k}from"fs";import{join as V}from"path";import w from"process";import{projectPath as W,storagePath as D}from"@stacksjs/path";var H=[D("framework/defaults/resources/functions/dashboard"),W("resources/functions"),W("app/Helpers")];async function F(q={}){let B=globalThis,C=[],G=0;for(let J of H){if(!$(J))continue;let K;try{K=U(J)}catch{continue}for(let A of K){let z=V(J,A),M;try{M=k(z)}catch{continue}if(M.isDirectory()){let O;try{O=U(z)}catch{continue}for(let Q of O){if(!X(Q))continue;let Z=V(z,Q),T=await Y(Z,B,q.verbose);G+=T.added,C.push(...T.collisions)}continue}if(!X(A))continue;let N=await Y(z,B,q.verbose);G+=N.added,C.push(...N.collisions)}}if(q.verbose)w.stdout.write(`[dashboard] hoisted ${G} helper globals`+(C.length>0?` (skipped ${C.length} collisions: ${C.slice(0,5).join(", ")}\u2026)`:"")+`
-`)}function X(q){if(!/\.(?:ts|tsx|js|mjs)$/.test(q))return!1;if(q.startsWith("_"))return!1;if(q.endsWith(".test.ts")||q.endsWith(".spec.ts"))return!1;if(q.endsWith(".d.ts"))return!1;return!0}async function Y(q,B,C){let G;try{G=await import(q)}catch{return{added:0,collisions:[]}}let J=[],K=0;for(let[A,z]of Object.entries(G)){if(A==="default"||A.startsWith("_"))continue;if(typeof z==="function"||z&&typeof z==="object"){if(B[A]===void 0)B[A]=z,K++;else if(B[A]!==z)J.push(A)}}return{added:K,collisions:J}}export{F as hoistDashboardGlobals};
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import process from "node:process";
+import { projectPath, storagePath } from "@stacksjs/path";
+const HELPER_DIRS = [
+  storagePath("framework/defaults/resources/functions/dashboard"),
+  projectPath("resources/functions"),
+  projectPath("app/Helpers")
+];
+export async function hoistDashboardGlobals(opts = {}) {
+  const g = globalThis, collisions = [];
+  let hoisted = 0;
+  for (const dir of HELPER_DIRS) {
+    if (!existsSync(dir))
+      continue;
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const full = join(dir, entry);
+      let s;
+      try {
+        s = statSync(full);
+      } catch {
+        continue;
+      }
+      if (s.isDirectory()) {
+        let subEntries;
+        try {
+          subEntries = readdirSync(full);
+        } catch {
+          continue;
+        }
+        for (const sub of subEntries) {
+          if (!isImportable(sub))
+            continue;
+          const subFull = join(full, sub), r = await hoistFile(subFull, g, opts.verbose);
+          hoisted += r.added;
+          collisions.push(...r.collisions);
+        }
+        continue;
+      }
+      if (!isImportable(entry))
+        continue;
+      const r = await hoistFile(full, g, opts.verbose);
+      hoisted += r.added;
+      collisions.push(...r.collisions);
+    }
+  }
+  if (opts.verbose)
+    process.stdout.write(`[dashboard] hoisted ${hoisted} helper globals` + (collisions.length > 0 ? ` (skipped ${collisions.length} collisions: ${collisions.slice(0, 5).join(", ")}\u2026)` : "") + `
+`);
+}
+function isImportable(name) {
+  if (!/\.(?:ts|tsx|js|mjs)$/.test(name))
+    return !1;
+  if (name.startsWith("_"))
+    return !1;
+  if (name.endsWith(".test.ts") || name.endsWith(".spec.ts"))
+    return !1;
+  if (name.endsWith(".d.ts"))
+    return !1;
+  return !0;
+}
+async function hoistFile(file, g, _verbose) {
+  let mod;
+  try {
+    mod = await import(file);
+  } catch {
+    return { added: 0, collisions: [] };
+  }
+  const collisions = [];
+  let added = 0;
+  for (const [name, value] of Object.entries(mod)) {
+    if (name === "default" || name.startsWith("_"))
+      continue;
+    if (typeof value === "function" || value && typeof value === "object") {
+      if (g[name] === void 0) {
+        g[name] = value;
+        added++;
+      } else if (g[name] !== value)
+        collisions.push(name);
+    }
+  }
+  return { added, collisions };
+}

package/dist/dev/dashboard-utils.js

@@ -1,2 +1,380 @@
-// @bun
-import{$a as e,Xa as a,Ya as b,Za as c,_a as d,ab as f,bb as g,cb as h,db as i,eb as j,fb as k,gb as l,hb as m}from"../chunk-ec4gky40.js";import"../chunk-h3d81wrg.js";export{k as waitForServer,f as scanModelsDir,d as modelNameToId,i as isPortAvailable,a as iconMap,e as getModelIcon,j as findAvailablePort,b as excludeModels,g as discoverModels,c as dedicatedPages,l as buildSidebarConfig,h as buildManifest,m as buildDashboardUrl};
+import { Glob } from "bun";
+import path from "node:path";
+export const iconMap = {
+  user: "person.fill",
+  team: "person.2.fill",
+  subscriber: "envelope.open.fill",
+  subscriberemail: "envelope.fill",
+  post: "doc.text.fill",
+  page: "doc.fill",
+  product: "cube.box.fill",
+  productvariant: "cube.fill",
+  productunit: "scalemass.fill",
+  order: "list.clipboard.fill",
+  orderitem: "list.bullet.clipboard.fill",
+  customer: "person.crop.circle.fill",
+  payment: "creditcard.fill",
+  paymentmethod: "creditcard.and.123",
+  paymentproduct: "creditcard.fill",
+  paymenttransaction: "creditcard.fill",
+  category: "tag.fill",
+  tag: "tag",
+  comment: "bubble.left.fill",
+  author: "person.text.rectangle.fill",
+  notification: "bell.fill",
+  job: "briefcase.fill",
+  log: "list.bullet.rectangle.portrait.fill",
+  campaign: "megaphone.fill",
+  review: "star.fill",
+  coupon: "ticket.fill",
+  giftcard: "giftcard.fill",
+  cart: "cart.fill",
+  cartitem: "cart.badge.plus",
+  taxrate: "percent",
+  transaction: "arrow.left.arrow.right.circle.fill",
+  subscription: "repeat.circle.fill",
+  emaillist: "envelope.badge.person.crop",
+  socialpost: "bubble.left.and.bubble.right.fill",
+  manufacturer: "building.2.fill",
+  shippingmethod: "shippingbox.fill",
+  shippingzone: "map.fill",
+  shippingrate: "dollarsign.circle.fill",
+  deliveryroute: "map.fill",
+  driver: "car.fill",
+  digitaldelivery: "arrow.down.doc.fill",
+  licensekey: "key.fill",
+  loyaltypoint: "star.circle.fill",
+  loyaltyreward: "gift.fill",
+  printdevice: "printer.fill",
+  receipt: "doc.text.fill",
+  waitlistproduct: "clock.fill",
+  waitlistrestaurant: "clock.badge.checkmark.fill",
+  websocket: "antenna.radiowaves.left.and.right",
+  default: "tablecells.fill"
+}, excludeModels = new Set(["activity", "request", "error", "failedjob"]), dedicatedPages = new Set(["user", "team", "subscriber", "post", "page", "product", "order", "customer", "payment", "coupon", "category", "tag", "comment", "author", "notification", "job", "campaign", "review", "gift-card"]);
+const ROOT_MODEL_CATEGORY = {
+  user: "data",
+  team: "data",
+  subscriber: "data",
+  activity: "data",
+  campaign: "marketing",
+  emaillist: "marketing",
+  socialpost: "marketing",
+  subscriberemail: "marketing",
+  comment: "content",
+  tag: "content",
+  paymentmethod: "commerce",
+  paymentproduct: "commerce",
+  paymenttransaction: "commerce",
+  subscription: "commerce",
+  deployment: "system",
+  error: "system",
+  failedjob: "system",
+  job: "system",
+  log: "system",
+  notification: "system",
+  release: "system",
+  request: "system"
+};
+export function modelNameToId(name) {
+  return name.replace(/([A-Z])/g, "-$1").toLowerCase().replace(/^-/, "");
+}
+export function getModelIcon(name) {
+  return iconMap[name.toLowerCase()] || iconMap.default || "database";
+}
+function categorizeModel(relativePath, modelId, defaultCategory) {
+  if (defaultCategory)
+    return defaultCategory;
+  const firstSeg = relativePath.includes("/") ? (relativePath.split("/")[0] ?? "").toLowerCase() : "";
+  if (firstSeg === "commerce")
+    return "commerce";
+  if (firstSeg === "content")
+    return "content";
+  if (firstSeg === "realtime")
+    return "system";
+  return ROOT_MODEL_CATEGORY[modelId.replace(/-/g, "")] ?? "data";
+}
+async function readModelDashboardConfig(absolutePath) {
+  try {
+    const mod = await import(absolutePath);
+    return (mod.default ?? mod).dashboard;
+  } catch {
+    return;
+  }
+}
+export async function scanModelsDir(dir, seenNames, models, defaultCategory) {
+  try {
+    const glob = new Glob("**/*.ts");
+    for await (const file of glob.scan({ cwd: dir })) {
+      if (file.includes("README") || file.includes(".d.ts"))
+        continue;
+      const name = file.replace(/\.ts$/, "").split("/").pop() || "", nameLower = name.toLowerCase();
+      if (name && !seenNames.has(nameLower) && !excludeModels.has(nameLower)) {
+        seenNames.add(nameLower);
+        const id = modelNameToId(name), absolutePath = path.join(dir, file), dashboard = await readModelDashboardConfig(absolutePath);
+        models.push({
+          name,
+          icon: dashboard?.icon ?? getModelIcon(name),
+          id,
+          category: categorizeModel(file, id, defaultCategory),
+          dashboard
+        });
+      }
+    }
+  } catch {}
+}
+export async function discoverModels(userModelsPath, defaultModelsPath) {
+  const models = [], seenNames = new Set;
+  await Promise.all([
+    scanModelsDir(userModelsPath, seenNames, models, "userland"),
+    scanModelsDir(defaultModelsPath, seenNames, models)
+  ]);
+  return models.sort((a, b) => a.name.localeCompare(b.name));
+}
+export function buildManifest(models) {
+  return models.map((m) => {
+    const row = {
+      id: m.id,
+      name: m.name,
+      icon: m.icon,
+      hasDedicatedPage: dedicatedPages.has(m.id),
+      category: m.category ?? "data"
+    };
+    if (m.dashboard)
+      row.dashboard = m.dashboard;
+    return row;
+  });
+}
+export async function isPortAvailable(port) {
+  try {
+    Bun.serve({ port, fetch: () => new Response }).stop(!0);
+    return !0;
+  } catch {
+    return !1;
+  }
+}
+export async function findAvailablePort(preferred, maxAttempts = 20) {
+  for (let i = 0;i < maxAttempts; i++) {
+    const port = preferred + i;
+    if (await isPortAvailable(port))
+      return port;
+  }
+  return preferred;
+}
+export async function waitForServer(port, maxWait = 500) {
+  const start = Date.now();
+  while (Date.now() - start < maxWait) {
+    try {
+      const res = await fetch(`http://localhost:${port}/`, { method: "HEAD" });
+      if (res.ok || res.status === 404)
+        return !0;
+    } catch {}
+    await new Promise((resolve) => setTimeout(resolve, 25));
+  }
+  return !1;
+}
+function effectiveCategory(m) {
+  if (m.dashboard?.enabled === !1)
+    return;
+  if (m.dashboard?.section)
+    return m.dashboard.section;
+  return m.category ?? "data";
+}
+function categoryRows(baseRoute, models, category, dedicated) {
+  return models.filter((m) => effectiveCategory(m) === category).filter((m) => !dedicatedPages.has(m.id) && !dedicated.has(m.id)).map((m) => ({
+    id: `model-${m.id}`,
+    label: m.dashboard?.label ?? m.name,
+    icon: m.icon,
+    url: `${baseRoute}/models/${m.id}`,
+    ...m.dashboard?.roles && m.dashboard.roles.length > 0 ? { roles: m.dashboard.roles } : {}
+  }));
+}
+export function buildSidebarConfig(baseRoute, discoveredModels, toggles = {}) {
+  const enabled = {
+    library: toggles.library ?? !0,
+    content: toggles.content ?? !0,
+    commerce: toggles.commerce ?? !0,
+    marketing: toggles.marketing ?? !0,
+    analytics: toggles.analytics ?? !0,
+    management: toggles.management ?? !0,
+    utilities: toggles.utilities ?? !0
+  }, dataRow = {
+    dashboard: toggles.data?.dashboard ?? !0,
+    activity: toggles.data?.activity ?? !0,
+    users: toggles.data?.users ?? !0,
+    teams: toggles.data?.teams ?? !0,
+    subscribers: toggles.data?.subscribers ?? !0,
+    allModels: toggles.data?.allModels ?? !0
+  }, sections = [], homeItems = [
+    { id: "home", label: "Dashboard", icon: "house.fill", url: `${baseRoute}/` },
+    { id: "dependencies", label: "Dependencies", icon: "shippingbox.fill", url: `${baseRoute}/dependencies` },
+    { id: "health", label: "Health", icon: "heart.text.square.fill", url: `${baseRoute}/health` }
+  ];
+  if (toggles.ci)
+    homeItems.push({ id: "ci", label: "CI", icon: "checkmark.seal.fill", url: `${baseRoute}/ci` });
+  sections.push({
+    id: "home",
+    title: "Home",
+    items: homeItems
+  });
+  if (enabled.library)
+    sections.push({
+      id: "library",
+      title: "Library",
+      items: [
+        { id: "functions", label: "Functions", icon: "function", url: `${baseRoute}/functions` },
+        { id: "packages", label: "Packages", icon: "shippingbox.fill", url: `${baseRoute}/packages` }
+      ]
+    });
+  if (enabled.content)
+    sections.push({
+      id: "content",
+      title: "Content",
+      items: [
+        { id: "content-dashboard", label: "Dashboard", icon: "gauge.with.dots.needle.33percent", url: `${baseRoute}/content/dashboard` },
+        { id: "files", label: "Files", icon: "folder.fill", url: `${baseRoute}/content/files` },
+        { id: "pages", label: "Pages", icon: "doc.fill", url: `${baseRoute}/content/pages` },
+        { id: "posts", label: "Posts", icon: "text.bubble.fill", url: `${baseRoute}/content/posts` },
+        { id: "categories", label: "Categories", icon: "tag.fill", url: `${baseRoute}/content/categories` },
+        { id: "tags", label: "Tags", icon: "tag", url: `${baseRoute}/content/tags` },
+        { id: "comments", label: "Comments", icon: "bubble.left.fill", url: `${baseRoute}/content/comments` },
+        { id: "authors", label: "Authors", icon: "person.text.rectangle.fill", url: `${baseRoute}/content/authors` },
+        { id: "seo", label: "SEO", icon: "magnifyingglass", url: `${baseRoute}/content/seo` },
+        ...categoryRows(baseRoute, discoveredModels, "content", new Set([
+          "page",
+          "post",
+          "category",
+          "tag",
+          "comment",
+          "author"
+        ]))
+      ]
+    });
+  sections.push({
+    id: "app",
+    title: "App",
+    items: [
+      { id: "deployments", label: "Deployments", icon: "rocket.fill", url: `${baseRoute}/deployments` },
+      { id: "requests", label: "Requests", icon: "arrow.left.arrow.right", url: `${baseRoute}/requests` },
+      { id: "realtime", label: "Realtime", icon: "link", url: `${baseRoute}/realtime` },
+      { id: "actions", label: "Actions", icon: "bolt.fill", url: `${baseRoute}/actions` },
+      { id: "commands", label: "Commands", icon: "terminal.fill", url: `${baseRoute}/commands` },
+      { id: "queue", label: "Queue", icon: "list.bullet.rectangle.fill", url: `${baseRoute}/queue` },
+      { id: "jobs", label: "Jobs", icon: "briefcase.fill", url: `${baseRoute}/jobs` },
+      { id: "inbox", label: "Inbox", icon: "tray.full.fill", url: `${baseRoute}/inbox` },
+      { id: "queries", label: "Queries", icon: "magnifyingglass.circle.fill", url: `${baseRoute}/queries` },
+      { id: "notifications", label: "Notifications", icon: "bell.fill", url: `${baseRoute}/notifications/dashboard` },
+      ...categoryRows(baseRoute, discoveredModels, "system", new Set)
+    ]
+  });
+  const dataItems = [];
+  if (dataRow.dashboard)
+    dataItems.push({ id: "data-dashboard", label: "Dashboard", icon: "gauge.with.dots.needle.33percent", url: `${baseRoute}/data/dashboard` });
+  if (dataRow.activity)
+    dataItems.push({ id: "activity", label: "Activity", icon: "waveform.path.ecg", url: `${baseRoute}/data/activity` });
+  if (dataRow.users)
+    dataItems.push({ id: "users", label: "Users", icon: "person.crop.circle.fill", url: `${baseRoute}/data/users` });
+  if (dataRow.teams)
+    dataItems.push({ id: "teams", label: "Teams", icon: "person.3.fill", url: `${baseRoute}/data/teams` });
+  if (dataRow.subscribers)
+    dataItems.push({ id: "subscribers", label: "Subscribers", icon: "envelope.fill", url: `${baseRoute}/data/subscribers` });
+  if (dataRow.allModels)
+    dataItems.push({ id: "data-models", label: "All Models", icon: "square.grid.2x2.fill", url: `${baseRoute}/models` });
+  const dynamicRows = discoveredModels.filter((m) => {
+    const eff = effectiveCategory(m);
+    return eff === "userland" || eff === "data";
+  }).filter((m) => !dedicatedPages.has(m.id)).map((model) => ({
+    id: `model-${model.id}`,
+    label: model.dashboard?.label ?? model.name,
+    icon: model.icon,
+    url: `${baseRoute}/models/${model.id}`,
+    ...model.dashboard?.roles && model.dashboard.roles.length > 0 ? { roles: model.dashboard.roles } : {}
+  }));
+  sections.push({
+    id: "data",
+    title: "Data",
+    items: [...dataItems, ...dynamicRows]
+  });
+  if (enabled.commerce)
+    sections.push({
+      id: "commerce",
+      title: "Commerce",
+      items: [
+        { id: "commerce-dashboard", label: "Dashboard", icon: "gauge.with.dots.needle.33percent", url: `${baseRoute}/commerce/dashboard` },
+        { id: "customers", label: "Customers", icon: "person.crop.circle.fill", url: `${baseRoute}/commerce/customers` },
+        { id: "orders", label: "Orders", icon: "list.clipboard.fill", url: `${baseRoute}/commerce/orders` },
+        { id: "products", label: "Products", icon: "cube.box.fill", url: `${baseRoute}/commerce/products` },
+        { id: "coupons", label: "Coupons", icon: "ticket.fill", url: `${baseRoute}/commerce/coupons` },
+        { id: "gift-cards", label: "Gift Cards", icon: "giftcard.fill", url: `${baseRoute}/commerce/gift-cards` },
+        { id: "payments", label: "Payments", icon: "creditcard.fill", url: `${baseRoute}/commerce/payments` },
+        { id: "delivery", label: "Delivery", icon: "truck.box.fill", url: `${baseRoute}/commerce/delivery` },
+        { id: "taxes", label: "Taxes", icon: "percent", url: `${baseRoute}/commerce/taxes` },
+        ...categoryRows(baseRoute, discoveredModels, "commerce", new Set([
+          "customer",
+          "order",
+          "product",
+          "coupon",
+          "gift-card",
+          "payment",
+          "review",
+          "category"
+        ]))
+      ]
+    });
+  if (enabled.marketing)
+    sections.push({
+      id: "marketing",
+      title: "Marketing",
+      items: [
+        { id: "lists", label: "Lists", icon: "list.bullet", url: `${baseRoute}/marketing/lists` },
+        { id: "social-posts", label: "Social Posts", icon: "clock.fill", url: `${baseRoute}/marketing/social-posts` },
+        { id: "campaigns", label: "Campaigns", icon: "megaphone.fill", url: `${baseRoute}/marketing/campaigns` },
+        { id: "marketing-reviews", label: "Reviews", icon: "star.fill", url: `${baseRoute}/marketing/reviews` },
+        ...categoryRows(baseRoute, discoveredModels, "marketing", new Set(["campaign"]))
+      ]
+    });
+  if (enabled.analytics)
+    sections.push({
+      id: "analytics",
+      title: "Analytics",
+      items: [
+        { id: "analytics-web", label: "Web", icon: "globe", url: `${baseRoute}/analytics/web` },
+        { id: "analytics-blog", label: "Blog", icon: "doc.text.fill", url: `${baseRoute}/analytics/blog` },
+        { id: "analytics-commerce", label: "Commerce", icon: "cart.fill", url: `${baseRoute}/analytics/commerce/web` },
+        { id: "analytics-marketing", label: "Marketing", icon: "megaphone.fill", url: `${baseRoute}/analytics/marketing` }
+      ]
+    });
+  if (enabled.management)
+    sections.push({
+      id: "management",
+      title: "Management",
+      items: [
+        { id: "cloud", label: "Cloud", icon: "cloud.fill", url: `${baseRoute}/cloud` },
+        { id: "servers", label: "Servers", icon: "server.rack", url: `${baseRoute}/servers` },
+        { id: "serverless", label: "Serverless", icon: "bolt.horizontal.circle.fill", url: `${baseRoute}/serverless` },
+        { id: "dns", label: "DNS", icon: "network", url: `${baseRoute}/dns` },
+        { id: "mailboxes", label: "Mailboxes", icon: "tray.full.fill", url: `${baseRoute}/mailboxes` },
+        { id: "logs", label: "Logs", icon: "list.bullet.rectangle.portrait.fill", url: `${baseRoute}/logs` },
+        { id: "kanban", label: "Kanban", icon: "rectangle.stack.fill", url: `${baseRoute}/kanban`, roles: ["admin", "dev"] }
+      ]
+    });
+  if (enabled.utilities)
+    sections.push({
+      id: "utilities",
+      title: "Utilities",
+      items: [
+        { id: "buddy", label: "AI Buddy", icon: "bubble.left.and.bubble.right.fill", url: `${baseRoute}/buddy` },
+        { id: "environment", label: "Environment", icon: "key.fill", url: `${baseRoute}/environment` },
+        { id: "access-tokens", label: "Access Tokens", icon: "key.horizontal.fill", url: `${baseRoute}/access-tokens` },
+        { id: "settings", label: "Settings", icon: "gear", url: `${baseRoute}/settings/billing` }
+      ]
+    });
+  return {
+    sections,
+    minWidth: 200,
+    maxWidth: 280
+  };
+}
+export function buildDashboardUrl(port) {
+  return `http://localhost:${port}/?native-sidebar=1`;
+}