@stacksjs/actions 0.70.88 → 0.70.90

package/dist/dev/dashboard-utils.js

@@ -0,0 +1,380 @@
+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`;
+}

package/dist/dev/dashboard.d.ts

@@ -0,0 +1,22 @@
+/* eslint-enable no-console */
+// Import Craft dynamically. Its static import triggers bun-router
+// config loading which prints warnings before our console.log override is
+// active. We also let it be missing — the native window is a nicety, not a
+// requirement; the dashboard runs fine as a plain web server in that case.
+declare interface CraftApplication {
+  show: () => Promise<void>
+  close: () => void
+}
+// Load dashboard section toggles from `config/dashboard.ts` if present.
+// Falls back to "everything enabled" when the file is missing or fails to
+// parse, so a fresh project (no dashboard config) still gets the full
+// sidebar. Shape mirrors `DashboardSectionToggles` in dashboard-utils.ts.
+declare type DataRowToggles = {
+  dashboard: boolean
+  activity: boolean
+  users: boolean
+  teams: boolean
+  subscribers: boolean
+  allModels: boolean
+}
+declare type CraftCreateApp = (options: Record<string, unknown>) => CraftApplication;