@objectstack/spec 0.1.1 → 0.1.2

package/json-schema/Object.json

@@ -28,11 +28,11 @@
         "datasource": {
           "type": "string",
           "default": "default",
-          "description": "Datasource name"
+          "description": "Target Datasource ID (e.g. \"postgres\", \"salesforce\"). references sys_datasource."
         },
         "tableName": {
           "type": "string",
-          "description": "Physical DB table override"
+          "description": "Physical table/collection name in the target datasource"
         },
         "isSystem": {
           "type": "boolean",
@@ -64,6 +64,7 @@
                   "password",
                   "markdown",
                   "html",
+                  "richtext",
                   "number",
                   "currency",
                   "percent",
@@ -72,7 +73,6 @@
                   "time",
                   "boolean",
                   "select",
-                  "multiselect",
                   "lookup",
                   "master_detail",
                   "image",
@@ -80,7 +80,13 @@
                   "avatar",
                   "formula",
                   "summary",
-                  "autonumber"
+                  "autonumber",
+                  "location",
+                  "address",
+                  "code",
+                  "color",
+                  "rating",
+                  "signature"
                 ],
                 "description": "Field Data Type"
               },
@@ -88,11 +94,20 @@
                 "type": "string",
                 "description": "Tooltip/Help text"
               },
+              "format": {
+                "type": "string",
+                "description": "Format string (e.g. email, phone)"
+              },
               "required": {
                 "type": "boolean",
                 "default": false,
                 "description": "Is required"
               },
+              "searchable": {
+                "type": "boolean",
+                "default": false,
+                "description": "Is searchable"
+              },
               "multiple": {
                 "type": "boolean",
                 "default": false,
@@ -221,6 +236,64 @@
                 "additionalProperties": false,
                 "description": "Roll-up summary definition"
               },
+              "language": {
+                "type": "string",
+                "description": "Programming language for syntax highlighting (e.g., javascript, python, sql)"
+              },
+              "theme": {
+                "type": "string",
+                "description": "Code editor theme (e.g., dark, light, monokai)"
+              },
+              "lineNumbers": {
+                "type": "boolean",
+                "description": "Show line numbers in code editor"
+              },
+              "maxRating": {
+                "type": "number",
+                "description": "Maximum rating value (default: 5)"
+              },
+              "allowHalf": {
+                "type": "boolean",
+                "description": "Allow half-star ratings"
+              },
+              "displayMap": {
+                "type": "boolean",
+                "description": "Display map widget for location field"
+              },
+              "allowGeocoding": {
+                "type": "boolean",
+                "description": "Allow address-to-coordinate conversion"
+              },
+              "addressFormat": {
+                "type": "string",
+                "enum": [
+                  "us",
+                  "uk",
+                  "international"
+                ],
+                "description": "Address format template"
+              },
+              "colorFormat": {
+                "type": "string",
+                "enum": [
+                  "hex",
+                  "rgb",
+                  "rgba",
+                  "hsl"
+                ],
+                "description": "Color value format"
+              },
+              "allowAlpha": {
+                "type": "boolean",
+                "description": "Allow transparency/alpha channel"
+              },
+              "presetColors": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Preset color options"
+              },
               "hidden": {
                 "type": "boolean",
                 "default": false,
@@ -248,8 +321,6 @@
               }
             },
             "required": [
-              "name",
-              "label",
               "type"
             ],
             "additionalProperties": false
@@ -303,6 +374,32 @@
               "type": "boolean",
               "default": true
             },
+            "apiMethods": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "get",
+                  "list",
+                  "create",
+                  "update",
+                  "delete",
+                  "upsert",
+                  "bulkCreate",
+                  "bulkUpdate",
+                  "bulkDelete",
+                  "bulkUpsert",
+                  "aggregate",
+                  "history",
+                  "search",
+                  "restore",
+                  "purge",
+                  "import",
+                  "export"
+                ]
+              },
+              "description": "Allowed API operations"
+            },
             "files": {
               "type": "boolean",
               "default": false

package/json-schema/ObjectCapabilities.json

@@ -16,6 +16,32 @@
           "type": "boolean",
           "default": true
         },
+        "apiMethods": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "get",
+              "list",
+              "create",
+              "update",
+              "delete",
+              "upsert",
+              "bulkCreate",
+              "bulkUpdate",
+              "bulkDelete",
+              "bulkUpsert",
+              "aggregate",
+              "history",
+              "search",
+              "restore",
+              "purge",
+              "import",
+              "export"
+            ]
+          },
+          "description": "Allowed API operations"
+        },
         "files": {
           "type": "boolean",
           "default": false

package/json-schema/ObjectQLClient.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/ObjectQLClient",
+  "definitions": {
+    "ObjectQLClient": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false,
+      "description": "ObjectQL Data Access Client"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Plugin.json

@@ -0,0 +1,20 @@
+{
+  "$ref": "#/definitions/Plugin",
+  "definitions": {
+    "Plugin": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Plugin identifier"
+        },
+        "version": {
+          "type": "string",
+          "description": "Plugin version"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/PluginContext.json

@@ -0,0 +1,91 @@
+{
+  "$ref": "#/definitions/PluginContext",
+  "definitions": {
+    "PluginContext": {
+      "type": "object",
+      "properties": {
+        "ql": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false,
+          "description": "ObjectQL Data Access Client"
+        },
+        "os": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false,
+          "description": "Access to System Core"
+        },
+        "logger": {
+          "type": "object",
+          "properties": {
+            "debug": {
+              "description": "(message: string, ...meta: any[]) => void"
+            },
+            "info": {
+              "description": "(message: string, ...meta: any[]) => void"
+            },
+            "warn": {
+              "description": "(message: string, ...meta: any[]) => void"
+            },
+            "error": {
+              "description": "(message: string, ...meta: any[]) => void"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Structured Logger"
+        },
+        "storage": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false,
+          "description": "Plugin Scoped Data Storage (KV)"
+        },
+        "i18n": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false,
+          "description": "Internationalization Helper"
+        },
+        "metadata": {
+          "description": "Metadata registry"
+        },
+        "events": {
+          "description": "Event bus"
+        },
+        "app": {
+          "type": "object",
+          "properties": {
+            "router": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": false,
+              "description": "HTTP Router Interface"
+            },
+            "scheduler": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": false,
+              "description": "Job Scheduler Interface"
+            }
+          },
+          "required": [
+            "router"
+          ],
+          "additionalProperties": false,
+          "description": "App Runtime Capabilities"
+        }
+      },
+      "required": [
+        "ql",
+        "os",
+        "logger",
+        "storage",
+        "i18n",
+        "app"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/PluginLifecycle.json

@@ -0,0 +1,11 @@
+{
+  "$ref": "#/definitions/PluginLifecycle",
+  "definitions": {
+    "PluginLifecycle": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Query.json

@@ -38,6 +38,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": [
             {
@@ -85,6 +227,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": {
@@ -116,6 +440,10 @@
         "skip": {
           "type": "number",
           "description": "Offset results"
+        },
+        "distinct": {
+          "type": "boolean",
+          "description": "SELECT DISTINCT flag"
         }
       },
       "required": [