@objectstack/spec 2.0.5 → 2.0.7

package/json-schema/api/AppDefinitionResponse.json

@@ -68,7 +68,36 @@
           "description": "App unique machine name (lowercase snake_case)"
         },
         "label": {
-          "type": "string",
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "key": {
+                  "type": "string",
+                  "description": "Translation key (e.g., \"views.task_list.label\")"
+                },
+                "defaultValue": {
+                  "description": "Fallback value when translation key is not found",
+                  "type": "string"
+                },
+                "params": {
+                  "description": "Interpolation parameters (e.g., { count: 5 })",
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {}
+                }
+              },
+              "required": [
+                "key"
+              ],
+              "additionalProperties": false
+            }
+          ],
           "description": "App display label"
         },
         "version": {
@@ -77,7 +106,36 @@
         },
         "description": {
           "description": "App description",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "key": {
+                  "type": "string",
+                  "description": "Translation key (e.g., \"views.task_list.label\")"
+                },
+                "defaultValue": {
+                  "description": "Fallback value when translation key is not found",
+                  "type": "string"
+                },
+                "params": {
+                  "description": "Interpolation parameters (e.g., { count: 5 })",
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {}
+                }
+              },
+              "required": [
+                "key"
+              ],
+              "additionalProperties": false
+            }
+          ]
         },
         "icon": {
           "description": "App icon used in the App Launcher",
@@ -139,6 +197,81 @@
           "description": "Custom APIs belonging to this app",
           "type": "array",
           "items": {}
+        },
+        "mobileNavigation": {
+          "description": "Mobile-specific navigation configuration",
+          "type": "object",
+          "properties": {
+            "mode": {
+              "default": "drawer",
+              "description": "Mobile navigation mode: drawer sidebar, bottom navigation bar, or hamburger menu",
+              "type": "string",
+              "enum": [
+                "drawer",
+                "bottom_nav",
+                "hamburger"
+              ]
+            },
+            "bottomNavItems": {
+              "description": "Navigation item IDs to show in bottom nav (max 5)",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "additionalProperties": false
+        },
+        "aria": {
+          "description": "ARIA accessibility attributes for the application",
+          "type": "object",
+          "properties": {
+            "ariaLabel": {
+              "description": "Accessible label for screen readers (WAI-ARIA aria-label)",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "key": {
+                      "type": "string",
+                      "description": "Translation key (e.g., \"views.task_list.label\")"
+                    },
+                    "defaultValue": {
+                      "description": "Fallback value when translation key is not found",
+                      "type": "string"
+                    },
+                    "params": {
+                      "description": "Interpolation parameters (e.g., { count: 5 })",
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            },
+            "ariaDescribedBy": {
+              "description": "ID of element providing additional description (WAI-ARIA aria-describedby)",
+              "type": "string"
+            },
+            "role": {
+              "description": "WAI-ARIA role attribute (e.g., \"dialog\", \"navigation\", \"alert\")",
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
         }
       },
       "required": [
@@ -169,7 +302,36 @@
               "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
-              "type": "string",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "key": {
+                      "type": "string",
+                      "description": "Translation key (e.g., \"views.task_list.label\")"
+                    },
+                    "defaultValue": {
+                      "description": "Fallback value when translation key is not found",
+                      "type": "string"
+                    },
+                    "params": {
+                      "description": "Interpolation parameters (e.g., { count: 5 })",
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
               "description": "Display proper label"
             },
             "icon": {
@@ -218,7 +380,36 @@
               "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
-              "type": "string",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "key": {
+                      "type": "string",
+                      "description": "Translation key (e.g., \"views.task_list.label\")"
+                    },
+                    "defaultValue": {
+                      "description": "Fallback value when translation key is not found",
+                      "type": "string"
+                    },
+                    "params": {
+                      "description": "Interpolation parameters (e.g., { count: 5 })",
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
               "description": "Display proper label"
             },
             "icon": {
@@ -256,7 +447,36 @@
               "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
-              "type": "string",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "key": {
+                      "type": "string",
+                      "description": "Translation key (e.g., \"views.task_list.label\")"
+                    },
+                    "defaultValue": {
+                      "description": "Fallback value when translation key is not found",
+                      "type": "string"
+                    },
+                    "params": {
+                      "description": "Interpolation parameters (e.g., { count: 5 })",
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
               "description": "Display proper label"
             },
             "icon": {
@@ -302,7 +522,36 @@
               "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
-              "type": "string",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "key": {
+                      "type": "string",
+                      "description": "Translation key (e.g., \"views.task_list.label\")"
+                    },
+                    "defaultValue": {
+                      "description": "Fallback value when translation key is not found",
+                      "type": "string"
+                    },
+                    "params": {
+                      "description": "Interpolation parameters (e.g., { count: 5 })",
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
               "description": "Display proper label"
             },
             "icon": {
@@ -350,7 +599,36 @@
               "description": "Unique identifier for this navigation item (lowercase snake_case)"
             },
             "label": {
-              "type": "string",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "key": {
+                      "type": "string",
+                      "description": "Translation key (e.g., \"views.task_list.label\")"
+                    },
+                    "defaultValue": {
+                      "description": "Fallback value when translation key is not found",
+                      "type": "string"
+                    },
+                    "params": {
+                      "description": "Interpolation parameters (e.g., { count: 5 })",
+                      "type": "object",
+                      "propertyNames": {
+                        "type": "string"
+                      },
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "key"
+                  ],
+                  "additionalProperties": false
+                }
+              ],
               "description": "Display proper label"
             },
             "icon": {

package/json-schema/api/BasePresence.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "userId": {
+      "type": "string",
+      "description": "User identifier"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "online",
+        "away",
+        "busy",
+        "offline"
+      ],
+      "description": "Current presence status"
+    },
+    "lastSeen": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+      "description": "ISO 8601 datetime of last activity"
+    },
+    "metadata": {
+      "description": "Custom presence data (e.g., current page, custom status)",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {}
+    }
+  },
+  "required": [
+    "userId",
+    "status",
+    "lastSeen"
+  ],
+  "additionalProperties": false
+}

package/json-schema/api/BatchLoadingStrategy.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "strategy": {
+      "type": "string",
+      "enum": [
+        "dataloader",
+        "windowed",
+        "prefetch"
+      ],
+      "description": "Batch loading strategy type"
+    },
+    "windowMs": {
+      "description": "Collection window duration in milliseconds (for windowed strategy)",
+      "type": "number"
+    },
+    "prefetchDepth": {
+      "description": "Depth of relation prefetching (for prefetch strategy)",
+      "type": "integer",
+      "minimum": -9007199254740991,
+      "maximum": 9007199254740991
+    },
+    "associationLoading": {
+      "default": "batch",
+      "description": "How to load related associations",
+      "type": "string",
+      "enum": [
+        "lazy",
+        "eager",
+        "batch"
+      ]
+    }
+  },
+  "required": [
+    "strategy",
+    "associationLoading"
+  ],
+  "additionalProperties": false
+}

package/json-schema/api/Callback.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z_][a-z0-9_]*$",
+      "description": "Callback identifier (snake_case)"
+    },
+    "expression": {
+      "type": "string",
+      "description": "Runtime expression (e.g., {$request.body#/callbackUrl})"
+    },
+    "method": {
+      "type": "string",
+      "enum": [
+        "GET",
+        "POST",
+        "PUT",
+        "DELETE",
+        "PATCH",
+        "HEAD",
+        "OPTIONS"
+      ],
+      "description": "HTTP method for callback request"
+    },
+    "url": {
+      "type": "string",
+      "description": "Callback URL template with runtime expressions"
+    }
+  },
+  "required": [
+    "name",
+    "expression",
+    "method",
+    "url"
+  ],
+  "additionalProperties": false
+}

package/json-schema/api/DataLoaderConfig.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "maxBatchSize": {
+      "default": 100,
+      "description": "Maximum number of keys per batch load",
+      "type": "integer",
+      "minimum": -9007199254740991,
+      "maximum": 9007199254740991
+    },
+    "batchScheduleFn": {
+      "default": "microtask",
+      "description": "Scheduling strategy for collecting batch keys",
+      "type": "string",
+      "enum": [
+        "microtask",
+        "timeout",
+        "manual"
+      ]
+    },
+    "cacheEnabled": {
+      "default": true,
+      "description": "Enable per-request result caching",
+      "type": "boolean"
+    },
+    "cacheKeyFn": {
+      "description": "Name or identifier of the cache key function",
+      "type": "string"
+    },
+    "cacheTtl": {
+      "description": "Cache time-to-live in seconds (0 = no expiration)",
+      "type": "number",
+      "minimum": 0
+    },
+    "coalesceRequests": {
+      "default": true,
+      "description": "Deduplicate identical requests within a batch window",
+      "type": "boolean"
+    },
+    "maxConcurrency": {
+      "description": "Maximum parallel batch requests",
+      "type": "integer",
+      "minimum": -9007199254740991,
+      "maximum": 9007199254740991
+    }
+  },
+  "required": [
+    "maxBatchSize",
+    "batchScheduleFn",
+    "cacheEnabled",
+    "coalesceRequests"
+  ],
+  "additionalProperties": false
+}

package/json-schema/api/DisablePackageResponse.json

@@ -391,6 +391,32 @@
                     ],
                     "additionalProperties": false
                   }
+                },
+                "commands": {
+                  "description": "CLI command contributions",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9-]*$",
+                        "description": "CLI command name"
+                      },
+                      "description": {
+                        "description": "Command description for help text",
+                        "type": "string"
+                      },
+                      "module": {
+                        "description": "Module path exporting Commander.js commands",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "additionalProperties": false

package/json-schema/api/Discovery.json

@@ -82,64 +82,6 @@
       ],
       "additionalProperties": false
     },
-    "features": {
-      "type": "object",
-      "properties": {
-        "graphql": {
-          "default": false,
-          "type": "boolean"
-        },
-        "search": {
-          "default": false,
-          "type": "boolean"
-        },
-        "websockets": {
-          "default": false,
-          "type": "boolean"
-        },
-        "files": {
-          "default": true,
-          "type": "boolean"
-        },
-        "analytics": {
-          "default": false,
-          "description": "Is the Analytics/BI engine enabled?",
-          "type": "boolean"
-        },
-        "ai": {
-          "default": false,
-          "description": "Is the AI engine enabled?",
-          "type": "boolean"
-        },
-        "workflow": {
-          "default": false,
-          "description": "Is the Workflow engine enabled?",
-          "type": "boolean"
-        },
-        "notifications": {
-          "default": false,
-          "description": "Is the Notification service enabled?",
-          "type": "boolean"
-        },
-        "i18n": {
-          "default": false,
-          "description": "Is the i18n service enabled?",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "graphql",
-        "search",
-        "websockets",
-        "files",
-        "analytics",
-        "ai",
-        "workflow",
-        "notifications",
-        "i18n"
-      ],
-      "additionalProperties": false
-    },
     "locale": {
       "type": "object",
       "properties": {
@@ -164,7 +106,6 @@
       "additionalProperties": false
     },
     "services": {
-      "description": "Per-service availability map keyed by CoreServiceName",
       "type": "object",
       "propertyNames": {
         "type": "string"
@@ -203,7 +144,8 @@
           "status"
         ],
         "additionalProperties": false
-      }
+      },
+      "description": "Per-service availability map keyed by CoreServiceName"
     },
     "metadata": {
       "description": "Custom metadata key-value pairs for extensibility",
@@ -219,8 +161,8 @@
     "version",
     "environment",
     "routes",
-    "features",
-    "locale"
+    "locale",
+    "services"
   ],
   "additionalProperties": false
 }

package/json-schema/api/EnablePackageResponse.json

@@ -391,6 +391,32 @@
                     ],
                     "additionalProperties": false
                   }
+                },
+                "commands": {
+                  "description": "CLI command contributions",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9-]*$",
+                        "description": "CLI command name"
+                      },
+                      "description": {
+                        "description": "Command description for help text",
+                        "type": "string"
+                      },
+                      "module": {
+                        "description": "Module path exporting Commander.js commands",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "name"
+                    ],
+                    "additionalProperties": false
+                  }
                 }
               },
               "additionalProperties": false