@stacksjs/defaults 0.75.243 → 0.75.244

package/ai/skills/stacks-native/CATALOG.md

@@ -65,7 +65,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/newsletter` | [`stacks-newsletter`](../stacks-newsletter/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/newsletter/src/index.ts) | 7 |
 | `@stacksjs/notifications` | [`stacks-notifications`](../stacks-notifications/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/index.ts) | 16 |
 | `@stacksjs/objects` | [`stacks-objects`](../stacks-objects/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/objects/src/index.ts) | 4 |
-| `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 63 |
+| `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 64 |
 | `@stacksjs/pagination` | [`stacks-pagination`](../stacks-pagination/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/pagination/src/index.ts) | 0 |
 | `@stacksjs/path` | [`stacks-path`](../stacks-path/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/src/index.ts) | 11 |
 | `@stacksjs/payments` | [`stacks-payments`](../stacks-payments/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/payments/src/index.ts) | 28 |
@@ -633,7 +633,7 @@ Declared runtime exports: `Activity`, `AnalyticsEvent`, `Auction`, `AuctionItem`
 
 Local source modules: [src/auto-crud.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/auto-crud.ts), [src/batch-loader.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/batch-loader.ts), [src/db.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/db.ts), [src/define-model.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/define-model.ts), [src/extend-model.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/extend-model.ts), [src/gdpr/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/gdpr/index.ts), [src/generate-database-schema.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/generate-database-schema.ts), [src/locked-row.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/locked-row.ts), [src/messaging.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/messaging.ts), [src/model-types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/model-types.ts), [src/ownership.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/ownership.ts), [src/paginator-request.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/paginator-request.ts), [src/row-token.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/row-token.ts), [src/subquery.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/subquery.ts), [src/traits/audit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/audit.ts), [src/traits/billable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/billable.ts), [src/traits/categorizable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/categorizable.ts), [src/traits/commentable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/commentable.ts), [src/traits/likeable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/likeable.ts), [src/traits/taggable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/taggable.ts), [src/transaction.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/transaction.ts), [src/types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/types.ts), [src/utils/encrypted.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/encrypted.ts), [src/utils/prunable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/prunable.ts).
 
-Evidence directory: [63 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [64 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/pagination
 

package/app/Actions/Dashboard/DashboardHomeAction.ts

@@ -193,6 +193,12 @@ export default new Action({
       })
     }
 
-    return { stats, httpMetrics, services, activities, issues }
+    // Which feature-backed sections exist, so the home page does not offer a
+    // card for a section the sidebar has hidden and whose pages cannot load.
+    // `feature()` is server-side only, and this component runs on the client.
+    // See stacksjs/stacks#2928.
+    const sections = { commerce, content: feature('cms'), marketing: feature('marketing') }
+
+    return { stats, httpMetrics, services, activities, issues, sections }
   },
 })

package/app/Models/QueryLog.ts

@@ -142,38 +142,48 @@ export default defineModel({
         rule: schema.string().max(255),
       },
     },
+    // `text`, all of these: an EXPLAIN plan, the tables a query touched and the
+    // suggestions made about it run past the varchar(255) Postgres enforces, and
+    // a log row that does not fit is dropped ("value too long for type character
+    // varying(255)") - losing exactly the slow queries this table exists for.
     tags: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     affected_tables: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     indexes_used: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     missing_indexes: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     explain_plan: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },
     },
     optimization_suggestions: {
       fillable: true,
+      type: 'text',
       validation: {
         rule: schema.string(),
       },

package/functions/dashboard.ts

@@ -39,6 +39,11 @@ export interface DashboardIssue {
 }
 
 interface DashboardHomeResponse {
+  /**
+   * Which feature-backed sections the server has available, so the home page
+   * only offers cards for sections that exist. See stacksjs/stacks#2928.
+   */
+  sections?: Record<string, boolean>
   stats?: Array<{ label: string, value: string }>
   httpMetrics?: DashboardHttpMetric[]
   services?: SystemHealthItem[]
@@ -98,6 +103,7 @@ export async function fetchDashboardHome(): Promise<DashboardHomeResponse> {
 }
 
 export function useDashboard() {
+  const sections = ref<Record<string, boolean>>({})
   const stats = ref<DashboardStats[]>([])
   const httpMetrics = ref<DashboardHttpMetric[]>([])
   const recentActivity = ref<ActivityItem[]>([])
@@ -109,6 +115,7 @@ export function useDashboard() {
   async function fetchDashboardStats(timeRange = '7d') {
     void timeRange
     const data = await fetchDashboardHome()
+    sections.value = data.sections && typeof data.sections === 'object' ? data.sections : {}
     stats.value = normalizeStats(data.stats)
     issues.value = Array.isArray(data.issues) ? data.issues : []
   }
@@ -132,7 +139,8 @@ export function useDashboard() {
 
     try {
       const data = await fetchDashboardHome()
-      stats.value = normalizeStats(data.stats)
+      sections.value = data.sections && typeof data.sections === 'object' ? data.sections : {}
+    stats.value = normalizeStats(data.stats)
       httpMetrics.value = Array.isArray(data.httpMetrics) ? data.httpMetrics : []
       recentActivity.value = normalizeActivities(data.activities)
       systemHealth.value = Array.isArray(data.services) ? data.services : []
@@ -157,6 +165,7 @@ export function useDashboard() {
   }
 
   return {
+    sections,
     stats,
     httpMetrics,
     recentActivity,

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.243",
+  "version": "0.75.244",
   "description": "Stacks, built into VS Code: stx templates, pickier linting and formatting, encrypted env files, the dev server preview and every buddy command. No other extensions required.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.243",
+  "version": "0.75.244",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -44,7 +44,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "0.75.243",
+    "@stacksjs/mobile": "0.75.244",
     "@stacksjs/sanitizer": "^0.2.534",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",

package/resources/components/Dashboard/Home/DashboardHome.stx

@@ -4,13 +4,20 @@ import { useDashboard } from '../../../../functions/dashboard'
 const dashboard = useDashboard()
 const loadingCards = [1, 2, 3, 4]
 
-const quickLinks = [
+/**
+ * `section` names the feature-backed dashboard section a card belongs to.
+ * A card with one is only offered when the server says that section exists -
+ * otherwise the home page links to pages the sidebar has hidden and that
+ * cannot load. See stacksjs/stacks#2928.
+ */
+const allQuickLinks = [
   {
     title: 'Blog',
     description: 'Manage persisted posts',
     href: '/content/dashboard',
     icon: 'i-hugeicons-book-open-01',
     tone: 'blue',
+    section: 'content',
   },
   {
     title: 'Commerce',
@@ -18,6 +25,7 @@ const quickLinks = [
     href: '/commerce/dashboard',
     icon: 'i-hugeicons-store-01',
     tone: 'green',
+    section: 'commerce',
   },
   {
     title: 'Cloud',
@@ -35,6 +43,16 @@ const quickLinks = [
   },
 ]
 
+/**
+ * Cards without a `section` are always offered. A card with one waits for the
+ * server to say that section exists, so the home page never links to a
+ * section the sidebar has hidden and whose pages cannot load.
+ */
+function quickLinks() {
+  const available = dashboard.sections.value
+  return allQuickLinks.filter(link => !link.section || available[link.section] !== false)
+}
+
 const resourceLinks = [
   {
     title: 'Documentation',
@@ -153,7 +171,7 @@ onMount(() => {
     </div>
   </section>
 
-  <QuickLinks class="mb-8" :links="quickLinks" />
+  <QuickLinks class="mb-8" :links="quickLinks()" />
 
   <div class="grid gap-6 grid-cols-1 lg:grid-cols-2 mt-8">
     <ServiceHealth :services="services()" :loading="dashboard.isLoading.value" />

package/resources/functions/dashboard/toggles.ts

@@ -45,12 +45,46 @@ export interface ResolvedDashboardToggles {
   data: DashboardDataRowToggles
 }
 
-export function defaultDashboardToggles(): ResolvedDashboardToggles {
+/**
+ * Dashboard sections that mirror an installable feature.
+ *
+ * A section whose feature is off used to stay in the sidebar anyway, and every
+ * page under it failed: the models those pages query are never loaded, so the
+ * first call came back `Manufacturer.orderByDesc is not a function` and the
+ * endpoint 503'd. Switching commerce off took two edits in two files -
+ * `config/commerce.ts` and `config/dashboard.ts` - and missing the second left
+ * a Commerce section that could not load. See stacksjs/stacks#2928.
+ *
+ * `library`, `analytics`, `management` and `utilities` are deliberately absent:
+ * they have no feature of their own, so they stay on.
+ */
+const FEATURE_BACKED_SECTIONS = {
+  commerce: 'commerce',
+  content: 'cms',
+  marketing: 'marketing',
+} as const
+
+/**
+ * Reads whether a feature is on. Supplied by the caller rather than imported,
+ * because this module is loaded on the dashboard's synchronous path and stays
+ * free of `@stacksjs/*` imports - its sibling `sidebar.ts` says why.
+ *
+ * Omitted, every section defaults on exactly as it did before.
+ */
+export type FeatureResolver = (name: string) => boolean
+
+function sectionFallback(section: keyof typeof FEATURE_BACKED_SECTIONS, isFeatureEnabled?: FeatureResolver): boolean {
+  if (!isFeatureEnabled)
+    return true
+  return isFeatureEnabled(FEATURE_BACKED_SECTIONS[section])
+}
+
+export function defaultDashboardToggles(isFeatureEnabled?: FeatureResolver): ResolvedDashboardToggles {
   return {
     library: true,
-    content: true,
-    commerce: true,
-    marketing: true,
+    content: sectionFallback('content', isFeatureEnabled),
+    commerce: sectionFallback('commerce', isFeatureEnabled),
+    marketing: sectionFallback('marketing', isFeatureEnabled),
     analytics: true,
     management: true,
     utilities: true,
@@ -66,7 +100,7 @@ export function defaultDashboardToggles(): ResolvedDashboardToggles {
   }
 }
 
-export function resolveDashboardToggles(value: unknown): ResolvedDashboardToggles {
+export function resolveDashboardToggles(value: unknown, isFeatureEnabled?: FeatureResolver): ResolvedDashboardToggles {
   const config = objectValue(value, 'dashboard config')
   const sections = config.sections === undefined
     ? {}
@@ -77,9 +111,11 @@ export function resolveDashboardToggles(value: unknown): ResolvedDashboardToggle
 
   return {
     library: sectionEnabled(sections.library, 'library', true),
-    content: sectionEnabled(sections.content, 'content', true),
-    commerce: sectionEnabled(sections.commerce, 'commerce', true),
-    marketing: sectionEnabled(sections.marketing, 'marketing', true),
+    // An explicit `enabled` in config/dashboard.ts still wins, both ways: an
+    // app can show a section whose feature is off, or hide one that is on.
+    content: sectionEnabled(sections.content, 'content', sectionFallback('content', isFeatureEnabled)),
+    commerce: sectionEnabled(sections.commerce, 'commerce', sectionFallback('commerce', isFeatureEnabled)),
+    marketing: sectionEnabled(sections.marketing, 'marketing', sectionFallback('marketing', isFeatureEnabled)),
     analytics: sectionEnabled(sections.analytics, 'analytics', true),
     management: sectionEnabled(sections.management, 'management', true),
     utilities: sectionEnabled(sections.utilities, 'utilities', true),
@@ -157,16 +193,16 @@ export interface LoadedDashboardConfig {
  * One import rather than two: the config module is cache-busted on mtime, so a
  * second load of the same file would be a second evaluation of user code.
  */
-export async function loadDashboardConfig(configPath: string): Promise<LoadedDashboardConfig> {
+export async function loadDashboardConfig(configPath: string, isFeatureEnabled?: FeatureResolver): Promise<LoadedDashboardConfig> {
   if (!existsSync(configPath))
-    return { toggles: defaultDashboardToggles(), nav: [] }
+    return { toggles: defaultDashboardToggles(isFeatureEnabled), nav: [] }
 
   try {
     const moduleUrl = pathToFileURL(configPath)
     moduleUrl.searchParams.set('dashboard-config-mtime', String(statSync(configPath).mtimeMs))
     const configModule = await import(moduleUrl.href) as { default?: unknown }
     return {
-      toggles: resolveDashboardToggles(configModule.default),
+      toggles: resolveDashboardToggles(configModule.default, isFeatureEnabled),
       nav: resolveDashboardNav(configModule.default),
     }
   }