@objectstack/platform-objects 6.7.1 → 6.8.1

package/dist/apps/index.d.mts

@@ -27,6 +27,33 @@ import { TranslationBundle, TranslationData } from '@objectstack/spec/system';
 
 declare const SETUP_APP: App;
 
+/**
+ * Platform Studio App — static definition.
+ *
+ * The developer/maker workbench. Studio surfaces every editable
+ * metadata type (objects, views, flows, agents, …) — i.e. the
+ * "schema-side" of the platform — and is intentionally separate from
+ * Setup, which is the operator/admin app for users/permissions/system
+ * configuration.
+ *
+ * The split mirrors the industry convention:
+ *   - Salesforce: Setup (admin) ⟷ App Builder + Schema Builder + Flow Builder (developer)
+ *   - ServiceNow: System Definition ⟷ Studio
+ *   - Microsoft Power Platform: Admin Center ⟷ Maker Portal
+ *
+ * Rationale:
+ *   - Different audience (implementers/devs vs IT admins)
+ *   - Different risk surface (schema changes vs user/SSO changes)
+ *   - Independent permission gating (`studio.access` vs `setup.access`)
+ *   - Different operational cadence (continuous in dev/staging, gated in prod)
+ *   - Future home for source-control, change sets, sandbox refresh, deploy
+ *
+ * Registration: alongside SETUP_APP in plugin-auth, so it ships out of
+ * the box whenever the auth/security trio is loaded.
+ */
+
+declare const STUDIO_APP: App;
+
 /**
  * System Overview Dashboard
  *
@@ -271,4 +298,4 @@ declare const jaJP: TranslationData;
  */
 declare const esES: TranslationData;
 
-export { SETUP_APP, SetupAppTranslations, SystemOverviewDashboard, en, esES, jaJP, zhCN };
+export { SETUP_APP, STUDIO_APP, SetupAppTranslations, SystemOverviewDashboard, en, esES, jaJP, zhCN };

package/dist/apps/index.d.ts

@@ -27,6 +27,33 @@ import { TranslationBundle, TranslationData } from '@objectstack/spec/system';
 
 declare const SETUP_APP: App;
 
+/**
+ * Platform Studio App — static definition.
+ *
+ * The developer/maker workbench. Studio surfaces every editable
+ * metadata type (objects, views, flows, agents, …) — i.e. the
+ * "schema-side" of the platform — and is intentionally separate from
+ * Setup, which is the operator/admin app for users/permissions/system
+ * configuration.
+ *
+ * The split mirrors the industry convention:
+ *   - Salesforce: Setup (admin) ⟷ App Builder + Schema Builder + Flow Builder (developer)
+ *   - ServiceNow: System Definition ⟷ Studio
+ *   - Microsoft Power Platform: Admin Center ⟷ Maker Portal
+ *
+ * Rationale:
+ *   - Different audience (implementers/devs vs IT admins)
+ *   - Different risk surface (schema changes vs user/SSO changes)
+ *   - Independent permission gating (`studio.access` vs `setup.access`)
+ *   - Different operational cadence (continuous in dev/staging, gated in prod)
+ *   - Future home for source-control, change sets, sandbox refresh, deploy
+ *
+ * Registration: alongside SETUP_APP in plugin-auth, so it ships out of
+ * the box whenever the auth/security trio is loaded.
+ */
+
+declare const STUDIO_APP: App;
+
 /**
  * System Overview Dashboard
  *
@@ -271,4 +298,4 @@ declare const jaJP: TranslationData;
  */
 declare const esES: TranslationData;
 
-export { SETUP_APP, SetupAppTranslations, SystemOverviewDashboard, en, esES, jaJP, zhCN };
+export { SETUP_APP, STUDIO_APP, SetupAppTranslations, SystemOverviewDashboard, en, esES, jaJP, zhCN };

package/dist/apps/index.js

@@ -25,6 +25,36 @@ var SETUP_APP = {
         { id: "nav_system_overview", type: "dashboard", label: "System Overview", dashboardName: "system_overview", icon: "activity" }
       ]
     },
+    {
+      // App Marketplace — browse + install packages. The browse page is
+      // always available: single-environment runtimes use the
+      // `MarketplaceProxy` plugin to browse the remote catalog;
+      // control-plane (cloud) deployments add `sys_package_installation`
+      // to track per-env installs. The "Installed Apps" entry is gated
+      // on that object so it only appears when the catalog backend
+      // exposes installations (i.e. control-plane / multi-tenant).
+      id: "group_apps",
+      type: "group",
+      label: "Apps",
+      icon: "package",
+      children: [
+        {
+          id: "nav_marketplace_browse",
+          type: "url",
+          label: "Browse Marketplace",
+          url: "/apps/setup/system/marketplace",
+          icon: "store"
+        },
+        {
+          id: "nav_marketplace_installed",
+          type: "url",
+          label: "Installed Apps",
+          url: "/apps/setup/system/marketplace/installed",
+          icon: "package-check",
+          requiresObject: "sys_package_installation"
+        }
+      ]
+    },
     {
       id: "group_people_org",
       type: "group",
@@ -154,18 +184,272 @@ var SETUP_APP = {
         //    from sys_user / org members.
         //  - Demoted "All Metadata" from the (now-deleted) Platform group
         //    to this Advanced/debug bucket.
-        //  - The marketplace-only `sys_app` / `sys_package` /
-        //    `sys_package_installation` menus have been removed entirely;
-        //    they are contributed by `@objectstack/service-tenant`
-        //    (control-plane) and are not present in single-environment runtimes.
+        //  - The raw `sys_app` / `sys_package` / `sys_package_installation`
+        //    object-list menus stay removed (they are control-plane admin
+        //    surfaces and live in `cloud-control.app.ts`). End-user
+        //    marketplace access lives in the top-level `Apps` group above,
+        //    pointing at the React browse/installed pages.
         { id: "nav_oauth_apps", type: "object", label: "OAuth Applications", objectName: "sys_oauth_application", icon: "app-window" },
         { id: "nav_jwks", type: "object", label: "Signing Keys (JWKS)", objectName: "sys_jwks", icon: "key-round" },
         { id: "nav_verifications", type: "object", label: "Verifications", objectName: "sys_verification", icon: "mail-check" },
         { id: "nav_two_factor", type: "object", label: "Two-Factor", objectName: "sys_two_factor", icon: "smartphone" },
         { id: "nav_device_codes", type: "object", label: "Device Codes", objectName: "sys_device_code", icon: "qr-code" },
         { id: "nav_accounts", type: "object", label: "Identity Links", objectName: "sys_account", icon: "link-2" },
-        { id: "nav_user_preferences", type: "object", label: "User Preferences", objectName: "sys_user_preference", icon: "sliders" },
-        { id: "nav_metadata", type: "object", label: "All Metadata", objectName: "sys_metadata", icon: "file-cog" }
+        { id: "nav_user_preferences", type: "object", label: "User Preferences", objectName: "sys_user_preference", icon: "sliders" }
+      ]
+    }
+  ]
+};
+
+// src/apps/studio.app.ts
+var STUDIO_APP = {
+  name: "studio",
+  label: "Studio",
+  description: "Metadata workbench for developers, analysts, and implementers",
+  icon: "hammer",
+  active: true,
+  isDefault: false,
+  branding: {
+    primaryColor: "#6366f1"
+    // Indigo-500 — distinct from Setup's slate
+  },
+  requiredPermissions: ["studio.access"],
+  navigation: [
+    {
+      id: "group_overview",
+      type: "group",
+      label: "Overview",
+      icon: "layout-dashboard",
+      children: [
+        {
+          id: "nav_metadata_directory",
+          type: "component",
+          label: "All Metadata Types",
+          componentRef: "metadata:directory",
+          icon: "layers"
+        }
+      ]
+    },
+    {
+      // Data Model — schema-design surfaces. Objects are the primary
+      // entry; field management happens in-context on each object's
+      // detail form (master-detail), so no top-level field link.
+      id: "group_data_model",
+      type: "group",
+      label: "Data Model",
+      icon: "database",
+      children: [
+        {
+          id: "nav_objects",
+          type: "component",
+          label: "Objects",
+          componentRef: "metadata:resource",
+          params: { type: "object" },
+          icon: "box"
+        },
+        {
+          id: "nav_validations",
+          type: "component",
+          label: "Validations",
+          componentRef: "metadata:resource",
+          params: { type: "validation" },
+          icon: "check-square"
+        }
+      ]
+    },
+    {
+      // User Experience — the metadata that shapes what end users see.
+      id: "group_ux",
+      type: "group",
+      label: "User Experience",
+      icon: "layout",
+      children: [
+        {
+          id: "nav_apps",
+          type: "component",
+          label: "Apps",
+          componentRef: "metadata:resource",
+          params: { type: "app" },
+          icon: "app-window"
+        },
+        {
+          id: "nav_views",
+          type: "component",
+          label: "Views",
+          componentRef: "metadata:resource",
+          params: { type: "view" },
+          icon: "table"
+        },
+        {
+          id: "nav_pages",
+          type: "component",
+          label: "Pages",
+          componentRef: "metadata:resource",
+          params: { type: "page" },
+          icon: "file-text"
+        },
+        {
+          id: "nav_dashboards",
+          type: "component",
+          label: "Dashboards",
+          componentRef: "metadata:resource",
+          params: { type: "dashboard" },
+          icon: "layout-dashboard"
+        },
+        {
+          id: "nav_reports",
+          type: "component",
+          label: "Reports",
+          componentRef: "metadata:resource",
+          params: { type: "report" },
+          icon: "bar-chart-3"
+        }
+      ]
+    },
+    {
+      // Logic — declarative + scripted business rules.
+      id: "group_logic",
+      type: "group",
+      label: "Logic",
+      icon: "function-square",
+      children: [
+        {
+          id: "nav_actions",
+          type: "component",
+          label: "Actions",
+          componentRef: "metadata:resource",
+          params: { type: "action" },
+          icon: "mouse-pointer-click"
+        },
+        {
+          id: "nav_hooks",
+          type: "component",
+          label: "Hooks",
+          componentRef: "metadata:resource",
+          params: { type: "hook" },
+          icon: "webhook"
+        }
+      ]
+    },
+    {
+      // Automation — flows, declarative workflow rules, approval processes.
+      id: "group_automation",
+      type: "group",
+      label: "Automation",
+      icon: "workflow",
+      children: [
+        {
+          id: "nav_flows",
+          type: "component",
+          label: "Flows",
+          componentRef: "metadata:resource",
+          params: { type: "flow" },
+          icon: "git-branch"
+        },
+        {
+          id: "nav_workflows",
+          type: "component",
+          label: "Workflow Rules",
+          componentRef: "metadata:resource",
+          params: { type: "workflow" },
+          icon: "zap"
+        },
+        {
+          id: "nav_approvals",
+          type: "component",
+          label: "Approval Processes",
+          componentRef: "metadata:resource",
+          params: { type: "approval" },
+          icon: "check-circle"
+        }
+      ]
+    },
+    {
+      // AI — agent/tool/skill metadata. Configured together by the
+      // same team in practice; runtime conversations live in their
+      // own app surface, not here.
+      id: "group_ai",
+      type: "group",
+      label: "AI",
+      icon: "sparkles",
+      children: [
+        {
+          id: "nav_agents",
+          type: "component",
+          label: "Agents",
+          componentRef: "metadata:resource",
+          params: { type: "agent" },
+          icon: "bot"
+        },
+        {
+          id: "nav_tools",
+          type: "component",
+          label: "Tools",
+          componentRef: "metadata:resource",
+          params: { type: "tool" },
+          icon: "wrench"
+        },
+        {
+          id: "nav_skills",
+          type: "component",
+          label: "Skills",
+          componentRef: "metadata:resource",
+          params: { type: "skill" },
+          icon: "brain"
+        }
+      ]
+    },
+    {
+      // Developer — first-party developer tooling surfaces hosted by the
+      // console (API console, flow run inspector, public forms registry).
+      // Registered as built-in components in the console's
+      // ComponentRegistry under the `developer:*` namespace.
+      id: "group_developer",
+      type: "group",
+      label: "Developer",
+      icon: "terminal",
+      children: [
+        {
+          id: "nav_api_console",
+          type: "component",
+          label: "API Console",
+          componentRef: "developer:api-console",
+          icon: "terminal"
+        },
+        {
+          id: "nav_flow_runs",
+          type: "component",
+          label: "Flow Runs",
+          componentRef: "developer:flow-runs",
+          icon: "activity"
+        },
+        {
+          id: "nav_public_forms",
+          type: "component",
+          label: "Public Forms",
+          componentRef: "developer:public-forms",
+          icon: "file-text"
+        }
+      ]
+    },
+    {
+      // Integration — outbound shapes: datasources, email templates,
+      // routes/functions/services live here too once they have CRUD
+      // surfaces. Email templates are a developer artefact (templates
+      // referenced by transactional sends), not a Setup item.
+      id: "group_integration",
+      type: "group",
+      label: "Integration",
+      icon: "plug",
+      children: [
+        {
+          id: "nav_email_templates",
+          type: "component",
+          label: "Email Templates",
+          componentRef: "metadata:resource",
+          params: { type: "email_template" },
+          icon: "mail"
+        }
       ]
     }
   ]
@@ -3234,6 +3518,7 @@ var en = {
       navigation: {
         // Groups
         group_overview: { label: "Overview" },
+        group_apps: { label: "Apps" },
         group_people_org: { label: "People & Organization" },
         group_access_control: { label: "Access Control" },
         group_approvals: { label: "Approvals" },
@@ -3242,6 +3527,9 @@ var en = {
         group_advanced: { label: "Advanced" },
         // Overview
         nav_system_overview: { label: "System Overview" },
+        // Apps / Marketplace
+        nav_marketplace_browse: { label: "Browse Marketplace" },
+        nav_marketplace_installed: { label: "Installed Apps" },
         // People & Organization
         nav_users: { label: "Users" },
         nav_departments: { label: "Departments" },
@@ -6249,6 +6537,9 @@ var zhCN = {
       description: "\u5E73\u53F0\u8BBE\u7F6E\u4E0E\u7BA1\u7406",
       navigation: {
         group_overview: { label: "\u603B\u89C8" },
+        group_apps: { label: "\u5E94\u7528" },
+        nav_marketplace_browse: { label: "\u6D4F\u89C8\u5E94\u7528\u5E02\u573A" },
+        nav_marketplace_installed: { label: "\u5DF2\u5B89\u88C5\u5E94\u7528" },
         group_people_org: { label: "\u4EBA\u5458\u4E0E\u7EC4\u7EC7" },
         group_access_control: { label: "\u8BBF\u95EE\u63A7\u5236" },
         group_approvals: { label: "\u5BA1\u6279" },
@@ -9223,6 +9514,9 @@ var jaJP = {
       description: "\u30D7\u30E9\u30C3\u30C8\u30D5\u30A9\u30FC\u30E0\u8A2D\u5B9A\u3068\u7BA1\u7406",
       navigation: {
         group_overview: { label: "\u6982\u8981" },
+        group_apps: { label: "\u30A2\u30D7\u30EA" },
+        nav_marketplace_browse: { label: "\u30DE\u30FC\u30B1\u30C3\u30C8\u30D7\u30EC\u30A4\u30B9\u3092\u95B2\u89A7" },
+        nav_marketplace_installed: { label: "\u30A4\u30F3\u30B9\u30C8\u30FC\u30EB\u6E08\u307F\u30A2\u30D7\u30EA" },
         group_people_org: { label: "\u30E6\u30FC\u30B6\u30FC\u3068\u7D44\u7E54" },
         group_access_control: { label: "\u30A2\u30AF\u30BB\u30B9\u5236\u5FA1" },
         group_approvals: { label: "\u627F\u8A8D" },
@@ -12197,6 +12491,9 @@ var esES = {
       description: "Configuraci\xF3n y administraci\xF3n de la plataforma",
       navigation: {
         group_overview: { label: "Resumen" },
+        group_apps: { label: "Aplicaciones" },
+        nav_marketplace_browse: { label: "Explorar Marketplace" },
+        nav_marketplace_installed: { label: "Aplicaciones instaladas" },
         group_people_org: { label: "Personas y Organizaci\xF3n" },
         group_access_control: { label: "Control de Acceso" },
         group_approvals: { label: "Aprobaciones" },
@@ -12264,6 +12561,7 @@ var SetupAppTranslations = {
 };
 
 exports.SETUP_APP = SETUP_APP;
+exports.STUDIO_APP = STUDIO_APP;
 exports.SetupAppTranslations = SetupAppTranslations;
 exports.SystemOverviewDashboard = SystemOverviewDashboard;
 exports.en = en;