@objectstack/spec 0.3.2 → 0.4.1

package/json-schema/permission/SharingRule.json

@@ -0,0 +1,182 @@
+{
+  "$ref": "#/definitions/SharingRule",
+  "definitions": {
+    "SharingRule": {
+      "anyOf": [
+        {
+          "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"
+            },
+            "description": {
+              "type": "string",
+              "description": "Administrative notes"
+            },
+            "object": {
+              "type": "string",
+              "description": "Target Object Name"
+            },
+            "active": {
+              "type": "boolean",
+              "default": true
+            },
+            "accessLevel": {
+              "type": "string",
+              "enum": [
+                "read",
+                "edit",
+                "full"
+              ],
+              "default": "read"
+            },
+            "sharedWith": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "user",
+                    "group",
+                    "role",
+                    "role_and_subordinates",
+                    "guest"
+                  ]
+                },
+                "value": {
+                  "type": "string",
+                  "description": "ID or Code of the User/Group/Role"
+                }
+              },
+              "required": [
+                "type",
+                "value"
+              ],
+              "additionalProperties": false,
+              "description": "The recipient of the shared access"
+            },
+            "type": {
+              "type": "string",
+              "const": "criteria"
+            },
+            "condition": {
+              "type": "string",
+              "description": "Formula condition (e.g. \"department = 'Sales'\")"
+            }
+          },
+          "required": [
+            "name",
+            "object",
+            "sharedWith",
+            "type",
+            "condition"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "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"
+            },
+            "description": {
+              "type": "string",
+              "description": "Administrative notes"
+            },
+            "object": {
+              "type": "string",
+              "description": "Target Object Name"
+            },
+            "active": {
+              "type": "boolean",
+              "default": true
+            },
+            "accessLevel": {
+              "type": "string",
+              "enum": [
+                "read",
+                "edit",
+                "full"
+              ],
+              "default": "read"
+            },
+            "sharedWith": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "user",
+                    "group",
+                    "role",
+                    "role_and_subordinates",
+                    "guest"
+                  ]
+                },
+                "value": {
+                  "type": "string",
+                  "description": "ID or Code of the User/Group/Role"
+                }
+              },
+              "required": [
+                "type",
+                "value"
+              ],
+              "additionalProperties": false,
+              "description": "The recipient of the shared access"
+            },
+            "type": {
+              "type": "string",
+              "const": "owner"
+            },
+            "ownedBy": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "user",
+                    "group",
+                    "role",
+                    "role_and_subordinates",
+                    "guest"
+                  ]
+                },
+                "value": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "value"
+              ],
+              "additionalProperties": false,
+              "description": "Source group/role whose records are being shared"
+            }
+          },
+          "required": [
+            "name",
+            "object",
+            "sharedWith",
+            "type",
+            "ownedBy"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/{data → permission}/SharingRuleType.json

@@ -5,9 +5,7 @@
       "type": "string",
       "enum": [
         "owner",
-        "criteria",
-        "manual",
-        "guest"
+        "criteria"
       ]
     }
   },

package/json-schema/{system → permission}/Territory.json

@@ -6,7 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_]*$"
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Territory unique name (lowercase snake_case)"
         },
         "label": {
           "type": "string",

package/json-schema/shared/EventName.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/EventName",
+  "definitions": {
+    "EventName": {
+      "type": "string",
+      "minLength": 3,
+      "pattern": "^[a-z][a-z0-9_.]*$",
+      "description": "Event name (lowercase with dot notation for namespacing)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/shared/SnakeCaseIdentifier.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/SnakeCaseIdentifier",
+  "definitions": {
+    "SnakeCaseIdentifier": {
+      "type": "string",
+      "minLength": 2,
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Snake case identifier (lowercase with underscores only)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/shared/SystemIdentifier.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/SystemIdentifier",
+  "definitions": {
+    "SystemIdentifier": {
+      "type": "string",
+      "minLength": 2,
+      "pattern": "^[a-z][a-z0-9_.]*$",
+      "description": "System identifier (lowercase with underscores or dots)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/Datasource.json

@@ -22,6 +22,41 @@
           "additionalProperties": {},
           "description": "Driver specific configuration"
         },
+        "pool": {
+          "type": "object",
+          "properties": {
+            "min": {
+              "type": "number",
+              "default": 0,
+              "description": "Minimum connections"
+            },
+            "max": {
+              "type": "number",
+              "default": 10,
+              "description": "Maximum connections"
+            },
+            "idleTimeoutMillis": {
+              "type": "number",
+              "default": 30000,
+              "description": "Idle timeout"
+            },
+            "connectionTimeoutMillis": {
+              "type": "number",
+              "default": 3000,
+              "description": "Connection establishment timeout"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Connection pool settings"
+        },
+        "readReplicas": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": {}
+          },
+          "description": "Read-only replica configurations"
+        },
         "capabilities": {
           "type": "object",
           "properties": {

package/json-schema/system/DriverCapabilities.json

@@ -47,6 +47,16 @@
         "arrayFields": {
           "type": "boolean",
           "description": "Supports array field types"
+        },
+        "vectorSearch": {
+          "type": "boolean",
+          "default": false,
+          "description": "Supports vector embeddings and similarity search"
+        },
+        "geoSpatial": {
+          "type": "boolean",
+          "default": false,
+          "description": "Supports geospatial queries"
         }
       },
       "required": [

package/json-schema/system/DriverInterface.json

@@ -58,6 +58,16 @@
             "arrayFields": {
               "type": "boolean",
               "description": "Supports array field types"
+            },
+            "vectorSearch": {
+              "type": "boolean",
+              "default": false,
+              "description": "Supports vector embeddings and similarity search"
+            },
+            "geoSpatial": {
+              "type": "boolean",
+              "default": false,
+              "description": "Supports geospatial queries"
             }
           },
           "required": [

package/json-schema/system/DriverOptions.json

@@ -14,6 +14,17 @@
         "skipCache": {
           "type": "boolean",
           "description": "Bypass cache"
+        },
+        "traceContext": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "OpenTelemetry context or request ID"
+        },
+        "tenantId": {
+          "type": "string",
+          "description": "Tenant Isolation identifier"
         }
       },
       "additionalProperties": false

package/json-schema/system/Event.json

@@ -6,8 +6,9 @@
       "properties": {
         "name": {
           "type": "string",
-          "pattern": "^[a-z_][a-z0-9_.]*$",
-          "description": "Event name (snake_case with dots, e.g., user.created)"
+          "minLength": 3,
+          "pattern": "^[a-z][a-z0-9_.]*$",
+          "description": "Event name (lowercase with dots, e.g., user.created, order.paid)"
         },
         "payload": {
           "description": "Event payload schema"

package/json-schema/system/FeatureFlag.json

@@ -0,0 +1,87 @@
+{
+  "$ref": "#/definitions/FeatureFlag",
+  "definitions": {
+    "FeatureFlag": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 2,
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Feature key (snake_case)"
+        },
+        "label": {
+          "type": "string",
+          "description": "Display label"
+        },
+        "description": {
+          "type": "string"
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Is globally enabled"
+        },
+        "strategy": {
+          "type": "string",
+          "enum": [
+            "boolean",
+            "percentage",
+            "user_list",
+            "group",
+            "custom"
+          ],
+          "default": "boolean"
+        },
+        "conditions": {
+          "type": "object",
+          "properties": {
+            "percentage": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            "users": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "groups": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "expression": {
+              "type": "string",
+              "description": "Custom formula expression"
+            }
+          },
+          "additionalProperties": false
+        },
+        "environment": {
+          "type": "string",
+          "enum": [
+            "dev",
+            "staging",
+            "prod",
+            "all"
+          ],
+          "default": "all",
+          "description": "Environment validity"
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Feature flag expiration date"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/FeatureStrategy.json

@@ -0,0 +1,16 @@
+{
+  "$ref": "#/definitions/FeatureStrategy",
+  "definitions": {
+    "FeatureStrategy": {
+      "type": "string",
+      "enum": [
+        "boolean",
+        "percentage",
+        "user_list",
+        "group",
+        "custom"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/FileMetadata.json

@@ -0,0 +1,43 @@
+{
+  "$ref": "#/definitions/FileMetadata",
+  "definitions": {
+    "FileMetadata": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "size": {
+          "type": "integer"
+        },
+        "mimeType": {
+          "type": "string"
+        },
+        "lastModified": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "created": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "etag": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "path",
+        "name",
+        "size",
+        "mimeType",
+        "lastModified",
+        "created"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/KernelContext.json

@@ -0,0 +1,62 @@
+{
+  "$ref": "#/definitions/KernelContext",
+  "definitions": {
+    "KernelContext": {
+      "type": "object",
+      "properties": {
+        "instanceId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Unique UUID for this running kernel process"
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "development",
+            "production",
+            "test",
+            "provisioning"
+          ],
+          "description": "Kernel operating mode",
+          "default": "production"
+        },
+        "version": {
+          "type": "string",
+          "description": "Kernel version"
+        },
+        "appName": {
+          "type": "string",
+          "description": "Host application name"
+        },
+        "cwd": {
+          "type": "string",
+          "description": "Current working directory"
+        },
+        "workspaceRoot": {
+          "type": "string",
+          "description": "Workspace root if different from cwd"
+        },
+        "startTime": {
+          "type": "integer",
+          "description": "Boot timestamp (ms)"
+        },
+        "features": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "boolean"
+          },
+          "default": {},
+          "description": "Global feature toggles"
+        }
+      },
+      "required": [
+        "instanceId",
+        "version",
+        "cwd",
+        "startTime"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/LogEntry.json

@@ -0,0 +1,63 @@
+{
+  "$ref": "#/definitions/LogEntry",
+  "definitions": {
+    "LogEntry": {
+      "type": "object",
+      "properties": {
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp"
+        },
+        "level": {
+          "type": "string",
+          "enum": [
+            "debug",
+            "info",
+            "warn",
+            "error",
+            "fatal"
+          ],
+          "description": "Log severity level"
+        },
+        "message": {
+          "type": "string",
+          "description": "Log message"
+        },
+        "context": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Structured context data"
+        },
+        "error": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Error object if present"
+        },
+        "traceId": {
+          "type": "string",
+          "description": "Distributed trace ID"
+        },
+        "spanId": {
+          "type": "string",
+          "description": "Span ID"
+        },
+        "service": {
+          "type": "string",
+          "description": "Service name"
+        },
+        "component": {
+          "type": "string",
+          "description": "Component name (e.g. plugin id)"
+        }
+      },
+      "required": [
+        "timestamp",
+        "level",
+        "message"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/LogFormat.json

@@ -0,0 +1,15 @@
+{
+  "$ref": "#/definitions/LogFormat",
+  "definitions": {
+    "LogFormat": {
+      "type": "string",
+      "enum": [
+        "json",
+        "text",
+        "pretty"
+      ],
+      "description": "Log output format"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/LogLevel.json

@@ -0,0 +1,17 @@
+{
+  "$ref": "#/definitions/LogLevel",
+  "definitions": {
+    "LogLevel": {
+      "type": "string",
+      "enum": [
+        "debug",
+        "info",
+        "warn",
+        "error",
+        "fatal"
+      ],
+      "description": "Log severity level"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}