@objectstack/spec 0.1.1 → 0.1.2

package/json-schema/Manifest.json

@@ -38,38 +38,263 @@
           },
           "description": "Array of required permission strings"
         },
-        "menus": {
+        "objects": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Glob patterns for ObjectQL schemas files"
+        },
+        "datasources": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Glob patterns for Datasource definitions"
+        },
+        "dependencies": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Package dependencies"
+        },
+        "configuration": {
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string"
+            },
+            "properties": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "string",
+                      "number",
+                      "boolean",
+                      "array",
+                      "object"
+                    ],
+                    "description": "Data type of the setting"
+                  },
+                  "default": {
+                    "description": "Default value"
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Tooltip description"
+                  },
+                  "required": {
+                    "type": "boolean",
+                    "description": "Is this setting required?"
+                  },
+                  "secret": {
+                    "type": "boolean",
+                    "description": "If true, value is encrypted/masked (e.g. API Keys)"
+                  },
+                  "enum": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Allowed values for select inputs"
+                  }
+                },
+                "required": [
+                  "type"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Map of configuration keys to their definitions"
+            }
+          },
+          "required": [
+            "properties"
+          ],
+          "additionalProperties": false,
+          "description": "Plugin configuration settings"
+        },
+        "contributes": {
+          "type": "object",
+          "properties": {
+            "kinds": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "The generic identifier of the kind (e.g., \"sys.bi.report\")"
+                  },
+                  "globs": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "File patterns to watch (e.g., [\"**/*.report.ts\"])"
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Description of what this kind represents"
+                  }
+                },
+                "required": [
+                  "id",
+                  "globs"
+                ],
+                "additionalProperties": false
+              },
+              "description": "New Metadata Types to recognize"
+            },
+            "events": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Events this plugin listens to"
+            },
+            "menus": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "label": {
+                      "type": "string"
+                    },
+                    "command": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "label"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "description": "UI Menu contributions"
+            },
+            "themes": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id",
+                  "label",
+                  "path"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Theme contributions"
+            },
+            "translations": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "locale": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "locale",
+                  "path"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Translation resources"
+            },
+            "actions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Unique action name"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "input": {
+                    "description": "Input validation schema"
+                  },
+                  "output": {
+                    "description": "Output schema"
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Exposed server actions"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Platform contributions"
+        },
+        "data": {
           "type": "array",
           "items": {
             "type": "object",
             "properties": {
-              "label": {
+              "object": {
                 "type": "string",
-                "description": "Display label for the menu item"
+                "description": "Target Object Name"
               },
-              "path": {
-                "type": "string",
-                "description": "Navigation path (route) for the menu item"
+              "records": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": {}
+                },
+                "description": "List of records to insert"
               },
-              "icon": {
+              "mode": {
                 "type": "string",
-                "description": "Optional icon identifier for the menu item"
+                "enum": [
+                  "upsert",
+                  "insert",
+                  "ignore"
+                ],
+                "default": "upsert",
+                "description": "Seeding mode"
               }
             },
             "required": [
-              "label",
-              "path"
+              "object",
+              "records"
             ],
             "additionalProperties": false
           },
-          "description": "Navigation menu structure"
-        },
-        "objects": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Glob patterns for ObjectQL schemas files"
+          "description": "Initial seed data"
         },
         "extensions": {
           "type": "object",

package/json-schema/Mapping.json

@@ -158,6 +158,148 @@
               },
               "description": "Fields to retrieve"
             },
+            "aggregations": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "function": {
+                    "type": "string",
+                    "enum": [
+                      "count",
+                      "sum",
+                      "avg",
+                      "min",
+                      "max",
+                      "count_distinct",
+                      "array_agg",
+                      "string_agg"
+                    ],
+                    "description": "Aggregation function"
+                  },
+                  "field": {
+                    "type": "string",
+                    "description": "Field to aggregate (optional for COUNT(*))"
+                  },
+                  "alias": {
+                    "type": "string",
+                    "description": "Result column alias"
+                  },
+                  "distinct": {
+                    "type": "boolean",
+                    "description": "Apply DISTINCT before aggregation"
+                  }
+                },
+                "required": [
+                  "function",
+                  "alias"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Aggregation functions (GROUP BY)"
+            },
+            "windowFunctions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "function": {
+                    "type": "string",
+                    "enum": [
+                      "row_number",
+                      "rank",
+                      "dense_rank",
+                      "percent_rank",
+                      "lag",
+                      "lead",
+                      "first_value",
+                      "last_value",
+                      "sum",
+                      "avg",
+                      "count",
+                      "min",
+                      "max"
+                    ],
+                    "description": "Window function name"
+                  },
+                  "field": {
+                    "type": "string",
+                    "description": "Field to operate on (for aggregate window functions)"
+                  },
+                  "alias": {
+                    "type": "string",
+                    "description": "Result column alias"
+                  },
+                  "over": {
+                    "type": "object",
+                    "properties": {
+                      "partitionBy": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "PARTITION BY fields"
+                      },
+                      "orderBy": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "field": {
+                              "type": "string"
+                            },
+                            "order": {
+                              "type": "string",
+                              "enum": [
+                                "asc",
+                                "desc"
+                              ],
+                              "default": "asc"
+                            }
+                          },
+                          "required": [
+                            "field"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "description": "ORDER BY specification"
+                      },
+                      "frame": {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "enum": [
+                              "rows",
+                              "range"
+                            ]
+                          },
+                          "start": {
+                            "type": "string",
+                            "description": "Frame start (e.g., \"UNBOUNDED PRECEDING\", \"1 PRECEDING\")"
+                          },
+                          "end": {
+                            "type": "string",
+                            "description": "Frame end (e.g., \"CURRENT ROW\", \"1 FOLLOWING\")"
+                          }
+                        },
+                        "additionalProperties": false,
+                        "description": "Window frame specification"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "description": "Window specification (OVER clause)"
+                  }
+                },
+                "required": [
+                  "function",
+                  "alias",
+                  "over"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Window functions with OVER clause"
+            },
             "filters": {
               "anyOf": [
                 {
@@ -205,6 +347,188 @@
               ],
               "description": "Filtering criteria"
             },
+            "joins": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "inner",
+                      "left",
+                      "right",
+                      "full"
+                    ],
+                    "description": "Join type"
+                  },
+                  "object": {
+                    "type": "string",
+                    "description": "Object/table to join"
+                  },
+                  "alias": {
+                    "type": "string",
+                    "description": "Table alias"
+                  },
+                  "on": {
+                    "anyOf": [
+                      {
+                        "type": "array",
+                        "minItems": 3,
+                        "maxItems": 3,
+                        "items": [
+                          {
+                            "type": "string"
+                          },
+                          {
+                            "type": "string",
+                            "enum": [
+                              "=",
+                              "!=",
+                              "<>",
+                              ">",
+                              ">=",
+                              "<",
+                              "<=",
+                              "startswith",
+                              "contains",
+                              "notcontains",
+                              "between",
+                              "in",
+                              "notin",
+                              "is_null",
+                              "is_not_null"
+                            ]
+                          },
+                          {}
+                        ]
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "anyOf": [
+                                {
+                                  "type": "array",
+                                  "minItems": 3,
+                                  "maxItems": 3,
+                                  "items": [
+                                    {
+                                      "type": "string"
+                                    },
+                                    {
+                                      "type": "string",
+                                      "enum": [
+                                        "=",
+                                        "!=",
+                                        "<>",
+                                        ">",
+                                        ">=",
+                                        "<",
+                                        "<=",
+                                        "startswith",
+                                        "contains",
+                                        "notcontains",
+                                        "between",
+                                        "in",
+                                        "notin",
+                                        "is_null",
+                                        "is_not_null"
+                                      ]
+                                    },
+                                    {}
+                                  ]
+                                },
+                                {
+                                  "type": "array",
+                                  "items": {
+                                    "anyOf": [
+                                      {
+                                        "type": "string"
+                                      },
+                                      {}
+                                    ]
+                                  }
+                                }
+                              ]
+                            }
+                          ]
+                        }
+                      }
+                    ],
+                    "description": "Join condition"
+                  },
+                  "subquery": {
+                    "description": "Subquery instead of object"
+                  }
+                },
+                "required": [
+                  "type",
+                  "object",
+                  "on"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Table joins"
+            },
+            "groupBy": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "GROUP BY fields"
+            },
+            "having": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "minItems": 3,
+                  "maxItems": 3,
+                  "items": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "string",
+                      "enum": [
+                        "=",
+                        "!=",
+                        "<>",
+                        ">",
+                        ">=",
+                        "<",
+                        "<=",
+                        "startswith",
+                        "contains",
+                        "notcontains",
+                        "between",
+                        "in",
+                        "notin",
+                        "is_null",
+                        "is_not_null"
+                      ]
+                    },
+                    {}
+                  ]
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {}
+                    ]
+                  }
+                }
+              ],
+              "description": "HAVING clause for aggregation filtering"
+            },
             "sort": {
               "type": "array",
               "items": {
@@ -236,6 +560,10 @@
             "skip": {
               "type": "number",
               "description": "Offset results"
+            },
+            "distinct": {
+              "type": "boolean",
+              "description": "SELECT DISTINCT flag"
             }
           },
           "required": [

package/json-schema/ModificationResult.json

@@ -0,0 +1,46 @@
+{
+  "$ref": "#/definitions/ModificationResult",
+  "definitions": {
+    "ModificationResult": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Record ID if processed"
+        },
+        "success": {
+          "type": "boolean"
+        },
+        "errors": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "code": {
+                "type": "string",
+                "description": "Error code (e.g. validation_error)"
+              },
+              "message": {
+                "type": "string",
+                "description": "Readable error message"
+              },
+              "details": {
+                "description": "Additional error context (e.g. field validation errors)"
+              }
+            },
+            "required": [
+              "code",
+              "message"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "success"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}