@objectstack/spec 0.1.1 → 0.2.0

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": [

package/json-schema/QueryFilter.json

@@ -0,0 +1,34 @@
+{
+  "$ref": "#/definitions/QueryFilter",
+  "definitions": {
+    "QueryFilter": {
+      "type": "object",
+      "properties": {
+        "where": {
+          "allOf": [
+            {
+              "type": "object",
+              "additionalProperties": {}
+            },
+            {
+              "type": "object",
+              "properties": {
+                "$and": {
+                  "type": "array",
+                  "items": {}
+                },
+                "$or": {
+                  "type": "array",
+                  "items": {}
+                },
+                "$not": {}
+              }
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/RangeOperator.json

@@ -0,0 +1,41 @@
+{
+  "$ref": "#/definitions/RangeOperator",
+  "definitions": {
+    "RangeOperator": {
+      "type": "object",
+      "properties": {
+        "$between": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 2,
+          "items": [
+            {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              ]
+            },
+            {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "string",
+                  "format": "date-time"
+                }
+              ]
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/RateLimitConfig.json

@@ -0,0 +1,36 @@
+{
+  "$ref": "#/definitions/RateLimitConfig",
+  "definitions": {
+    "RateLimitConfig": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "maxAttempts": {
+          "type": "number",
+          "default": 5,
+          "description": "Maximum login attempts"
+        },
+        "windowMs": {
+          "type": "number",
+          "default": 900000,
+          "description": "Time window in milliseconds (default 15 min)"
+        },
+        "blockDuration": {
+          "type": "number",
+          "default": 900000,
+          "description": "Block duration after max attempts in ms"
+        },
+        "skipSuccessfulRequests": {
+          "type": "boolean",
+          "default": false,
+          "description": "Only count failed requests"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/RecordData.json

@@ -0,0 +1,11 @@
+{
+  "$ref": "#/definitions/RecordData",
+  "definitions": {
+    "RecordData": {
+      "type": "object",
+      "additionalProperties": {},
+      "description": "Key-value map of record data"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Report.json

@@ -137,33 +137,27 @@
           "description": "Column groupings (Matrix only)"
         },
         "filter": {
-          "type": "string",
-          "description": "Filter logic (e.g. \"1 AND (2 OR 3)\")"
-        },
-        "filterItems": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "number"
-              },
-              "field": {
-                "type": "string"
-              },
-              "operator": {
-                "type": "string"
-              },
-              "value": {}
+          "allOf": [
+            {
+              "type": "object",
+              "additionalProperties": {}
             },
-            "required": [
-              "id",
-              "field",
-              "operator"
-            ],
-            "additionalProperties": false
-          },
-          "description": "Filter criteria lines"
+            {
+              "type": "object",
+              "properties": {
+                "$and": {
+                  "type": "array",
+                  "items": {}
+                },
+                "$or": {
+                  "type": "array",
+                  "items": {}
+                },
+                "$not": {}
+              }
+            }
+          ],
+          "description": "Filter criteria"
         },
         "chart": {
           "type": "object",

package/json-schema/Router.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/Router",
+  "definitions": {
+    "Router": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false,
+      "description": "HTTP Router Interface"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Scheduler.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/Scheduler",
+  "definitions": {
+    "Scheduler": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false,
+      "description": "Job Scheduler Interface"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}