@objectstack/spec 0.3.2 → 0.4.1

package/json-schema/data/HookContext.json

@@ -0,0 +1,88 @@
+{
+  "$ref": "#/definitions/HookContext",
+  "definitions": {
+    "HookContext": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique execution ID for tracing"
+        },
+        "object": {
+          "type": "string"
+        },
+        "event": {
+          "type": "string",
+          "enum": [
+            "beforeFind",
+            "afterFind",
+            "beforeFindOne",
+            "afterFindOne",
+            "beforeCount",
+            "afterCount",
+            "beforeAggregate",
+            "afterAggregate",
+            "beforeInsert",
+            "afterInsert",
+            "beforeUpdate",
+            "afterUpdate",
+            "beforeDelete",
+            "afterDelete",
+            "beforeUpdateMany",
+            "afterUpdateMany",
+            "beforeDeleteMany",
+            "afterDeleteMany"
+          ]
+        },
+        "input": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Mutable input parameters"
+        },
+        "result": {
+          "description": "Operation result (After hooks only)"
+        },
+        "previous": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Record state before operation"
+        },
+        "session": {
+          "type": "object",
+          "properties": {
+            "userId": {
+              "type": "string"
+            },
+            "tenantId": {
+              "type": "string"
+            },
+            "roles": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "accessToken": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Current session context"
+        },
+        "transaction": {
+          "description": "Database transaction handle"
+        },
+        "ql": {
+          "description": "ObjectQL Engine Reference"
+        }
+      },
+      "required": [
+        "object",
+        "event",
+        "input"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/data/HookEvent.json

@@ -0,0 +1,29 @@
+{
+  "$ref": "#/definitions/HookEvent",
+  "definitions": {
+    "HookEvent": {
+      "type": "string",
+      "enum": [
+        "beforeFind",
+        "afterFind",
+        "beforeFindOne",
+        "afterFindOne",
+        "beforeCount",
+        "afterCount",
+        "beforeAggregate",
+        "afterAggregate",
+        "beforeInsert",
+        "afterInsert",
+        "beforeUpdate",
+        "afterUpdate",
+        "beforeDelete",
+        "afterDelete",
+        "beforeUpdateMany",
+        "afterUpdateMany",
+        "beforeDeleteMany",
+        "afterDeleteMany"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/data/Index.json

@@ -18,6 +18,16 @@
         "unique": {
           "type": "boolean",
           "description": "Whether the index is unique"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "btree",
+            "hash",
+            "gin",
+            "gist"
+          ],
+          "description": "Index type (default: btree)"
         }
       },
       "required": [

package/json-schema/data/JSONValidation.json

@@ -0,0 +1,85 @@
+{
+  "$ref": "#/definitions/JSONValidation",
+  "definitions": {
+    "JSONValidation": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$",
+          "description": "Unique rule name (snake_case)"
+        },
+        "label": {
+          "type": "string",
+          "description": "Human-readable label for the rule listing"
+        },
+        "description": {
+          "type": "string",
+          "description": "Administrative notes explaining the business reason"
+        },
+        "active": {
+          "type": "boolean",
+          "default": true
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "insert",
+              "update",
+              "delete"
+            ]
+          },
+          "default": [
+            "insert",
+            "update"
+          ],
+          "description": "Validation contexts"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Categorization tags (e.g., \"compliance\", \"billing\")"
+        },
+        "severity": {
+          "type": "string",
+          "enum": [
+            "error",
+            "warning",
+            "info"
+          ],
+          "default": "error"
+        },
+        "message": {
+          "type": "string",
+          "description": "Error message to display to the user"
+        },
+        "type": {
+          "type": "string",
+          "const": "json_schema"
+        },
+        "field": {
+          "type": "string",
+          "description": "JSON field to validate"
+        },
+        "schema": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "JSON Schema object definition"
+        }
+      },
+      "required": [
+        "name",
+        "message",
+        "type",
+        "field",
+        "schema"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/data/JoinNode.json

@@ -14,6 +14,16 @@
           ],
           "description": "Join type"
         },
+        "strategy": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "database",
+            "hash",
+            "loop"
+          ],
+          "description": "Execution strategy hint"
+        },
         "object": {
           "type": "string",
           "description": "Object/table to join"
@@ -23,92 +33,86 @@
           "description": "Table alias"
         },
         "on": {
-          "anyOf": [
+          "allOf": [
             {
-              "type": "array",
-              "minItems": 3,
-              "maxItems": 3,
-              "items": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "string",
-                  "enum": [
-                    "=",
-                    "!=",
-                    "<>",
-                    ">",
-                    ">=",
-                    "<",
-                    "<=",
-                    "startswith",
-                    "contains",
-                    "notcontains",
-                    "between",
-                    "in",
-                    "notin",
-                    "is_null",
-                    "is_not_null"
-                  ]
-                },
-                {}
-              ]
+              "type": "object",
+              "additionalProperties": {}
             },
             {
-              "type": "array",
-              "items": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "anyOf": [
+              "type": "object",
+              "properties": {
+                "$and": {
+                  "type": "array",
+                  "items": {
+                    "allOf": [
                       {
-                        "type": "array",
-                        "minItems": 3,
-                        "maxItems": 3,
-                        "items": [
-                          {
-                            "type": "string"
+                        "type": "object",
+                        "additionalProperties": {}
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "$and": {
+                            "type": "array",
+                            "items": {}
                           },
-                          {
-                            "type": "string",
-                            "enum": [
-                              "=",
-                              "!=",
-                              "<>",
-                              ">",
-                              ">=",
-                              "<",
-                              "<=",
-                              "startswith",
-                              "contains",
-                              "notcontains",
-                              "between",
-                              "in",
-                              "notin",
-                              "is_null",
-                              "is_not_null"
-                            ]
+                          "$or": {
+                            "type": "array",
+                            "items": {}
                           },
-                          {}
-                        ]
+                          "$not": {}
+                        }
+                      }
+                    ]
+                  }
+                },
+                "$or": {
+                  "type": "array",
+                  "items": {
+                    "allOf": [
+                      {
+                        "type": "object",
+                        "additionalProperties": {}
                       },
                       {
-                        "type": "array",
-                        "items": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {}
-                          ]
+                        "type": "object",
+                        "properties": {
+                          "$and": {
+                            "type": "array",
+                            "items": {}
+                          },
+                          "$or": {
+                            "type": "array",
+                            "items": {}
+                          },
+                          "$not": {}
                         }
                       }
                     ]
                   }
-                ]
+                },
+                "$not": {
+                  "allOf": [
+                    {
+                      "type": "object",
+                      "additionalProperties": {}
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "$and": {
+                          "type": "array",
+                          "items": {}
+                        },
+                        "$or": {
+                          "type": "array",
+                          "items": {}
+                        },
+                        "$not": {}
+                      }
+                    }
+                  ]
+                }
               }
             }
           ],
@@ -151,6 +155,71 @@
               },
               "description": "Fields to retrieve"
             },
+            "where": {
+              "allOf": [
+                {
+                  "type": "object",
+                  "additionalProperties": {}
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "$and": {
+                      "type": "array",
+                      "items": {}
+                    },
+                    "$or": {
+                      "type": "array",
+                      "items": {}
+                    },
+                    "$not": {}
+                  }
+                }
+              ],
+              "description": "Filtering criteria (WHERE)"
+            },
+            "orderBy": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "order": {
+                    "type": "string",
+                    "enum": [
+                      "asc",
+                      "desc"
+                    ],
+                    "default": "asc"
+                  }
+                },
+                "required": [
+                  "field"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Sorting instructions (ORDER BY)"
+            },
+            "limit": {
+              "type": "number",
+              "description": "Max records to return (LIMIT)"
+            },
+            "offset": {
+              "type": "number",
+              "description": "Records to skip (OFFSET)"
+            },
+            "cursor": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "Cursor for keyset pagination"
+            },
+            "joins": {
+              "type": "array",
+              "items": {},
+              "description": "Explicit Table Joins"
+            },
             "aggregations": {
               "type": "array",
               "items": {
@@ -181,6 +250,29 @@
                   "distinct": {
                     "type": "boolean",
                     "description": "Apply DISTINCT before aggregation"
+                  },
+                  "filter": {
+                    "allOf": [
+                      {
+                        "type": "object",
+                        "additionalProperties": {}
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "$and": {
+                            "type": "array",
+                            "items": {}
+                          },
+                          "$or": {
+                            "type": "array",
+                            "items": {}
+                          },
+                          "$not": {}
+                        }
+                      }
+                    ],
+                    "description": "Filter/Condition to apply to the aggregation (FILTER WHERE clause)"
                   }
                 },
                 "required": [
@@ -189,7 +281,37 @@
                 ],
                 "additionalProperties": false
               },
-              "description": "Aggregation functions (GROUP BY)"
+              "description": "Aggregation functions"
+            },
+            "groupBy": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "GROUP BY fields"
+            },
+            "having": {
+              "allOf": [
+                {
+                  "type": "object",
+                  "additionalProperties": {}
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "$and": {
+                      "type": "array",
+                      "items": {}
+                    },
+                    "$or": {
+                      "type": "array",
+                      "items": {}
+                    },
+                    "$not": {}
+                  }
+                }
+              ],
+              "description": "HAVING clause for aggregation filtering"
             },
             "windowFunctions": {
               "type": "array",
@@ -293,144 +415,6 @@
               },
               "description": "Window functions with OVER clause"
             },
-            "filters": {
-              "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": "Filtering criteria"
-            },
-            "joins": {
-              "type": "array",
-              "items": {},
-              "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": {
-                "type": "object",
-                "properties": {
-                  "field": {
-                    "type": "string"
-                  },
-                  "order": {
-                    "type": "string",
-                    "enum": [
-                      "asc",
-                      "desc"
-                    ],
-                    "default": "asc"
-                  }
-                },
-                "required": [
-                  "field"
-                ],
-                "additionalProperties": false
-              },
-              "description": "Sorting instructions"
-            },
-            "top": {
-              "type": "number",
-              "description": "Limit results"
-            },
-            "skip": {
-              "type": "number",
-              "description": "Offset results"
-            },
             "distinct": {
               "type": "boolean",
               "description": "SELECT DISTINCT flag"

package/json-schema/data/JoinStrategy.json

@@ -0,0 +1,15 @@
+{
+  "$ref": "#/definitions/JoinStrategy",
+  "definitions": {
+    "JoinStrategy": {
+      "type": "string",
+      "enum": [
+        "auto",
+        "database",
+        "hash",
+        "loop"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}