@objectstack/spec 0.1.0 → 0.1.1

package/json-schema/AuthProvider.json

@@ -0,0 +1,171 @@
+{
+  "$ref": "#/definitions/AuthProvider",
+  "definitions": {
+    "AuthProvider": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$",
+          "description": "Provider ID"
+        },
+        "label": {
+          "type": "string",
+          "description": "Button Label (e.g. \"Login with Okta\")"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "oidc",
+            "saml",
+            "ldap",
+            "oauth2",
+            "local",
+            "mock"
+          ]
+        },
+        "config": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "issuer": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "OIDC Issuer URL (.well-known/openid-configuration)"
+                },
+                "clientId": {
+                  "type": "string"
+                },
+                "clientSecret": {
+                  "type": "string"
+                },
+                "scopes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "default": [
+                    "openid",
+                    "profile",
+                    "email"
+                  ]
+                },
+                "attributeMapping": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "string"
+                  },
+                  "description": "Map IdP claims to User fields"
+                }
+              },
+              "required": [
+                "issuer",
+                "clientId",
+                "clientSecret"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "entryPoint": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "IdP SSO URL"
+                },
+                "cert": {
+                  "type": "string",
+                  "description": "IdP Public Certificate"
+                },
+                "issuer": {
+                  "type": "string",
+                  "description": "Entity ID of the IdP"
+                },
+                "signatureAlgorithm": {
+                  "type": "string",
+                  "enum": [
+                    "sha256",
+                    "sha512"
+                  ],
+                  "default": "sha256"
+                },
+                "attributeMapping": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "entryPoint",
+                "cert",
+                "issuer"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "format": "uri",
+                  "description": "LDAP Server URL (ldap:// or ldaps://)"
+                },
+                "bindDn": {
+                  "type": "string"
+                },
+                "bindCredentials": {
+                  "type": "string"
+                },
+                "searchBase": {
+                  "type": "string"
+                },
+                "searchFilter": {
+                  "type": "string"
+                },
+                "groupSearchBase": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "url",
+                "bindDn",
+                "bindCredentials",
+                "searchBase",
+                "searchFilter"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "additionalProperties": {}
+            }
+          ],
+          "description": "Provider specific configuration"
+        },
+        "icon": {
+          "type": "string",
+          "description": "Icon URL or helper class"
+        },
+        "active": {
+          "type": "boolean",
+          "default": true
+        },
+        "registrationEnabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Allow new users to sign up via this provider"
+        }
+      },
+      "required": [
+        "name",
+        "label",
+        "type",
+        "config"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/CalendarConfig.json

@@ -0,0 +1,28 @@
+{
+  "$ref": "#/definitions/CalendarConfig",
+  "definitions": {
+    "CalendarConfig": {
+      "type": "object",
+      "properties": {
+        "startDateField": {
+          "type": "string"
+        },
+        "endDateField": {
+          "type": "string"
+        },
+        "titleField": {
+          "type": "string"
+        },
+        "colorField": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "startDateField",
+        "titleField"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/ChartType.json

@@ -0,0 +1,19 @@
+{
+  "$ref": "#/definitions/ChartType",
+  "definitions": {
+    "ChartType": {
+      "type": "string",
+      "enum": [
+        "metric",
+        "bar",
+        "line",
+        "pie",
+        "donut",
+        "funnel",
+        "table",
+        "text"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Dashboard.json

@@ -0,0 +1,117 @@
+{
+  "$ref": "#/definitions/Dashboard",
+  "definitions": {
+    "Dashboard": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$",
+          "description": "Dashboard unique name"
+        },
+        "label": {
+          "type": "string",
+          "description": "Dashboard label"
+        },
+        "description": {
+          "type": "string",
+          "description": "Dashboard description"
+        },
+        "widgets": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "title": {
+                "type": "string",
+                "description": "Widget title"
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "metric",
+                  "bar",
+                  "line",
+                  "pie",
+                  "donut",
+                  "funnel",
+                  "table",
+                  "text"
+                ],
+                "default": "metric",
+                "description": "Visualization type"
+              },
+              "object": {
+                "type": "string",
+                "description": "Data source object name"
+              },
+              "filter": {
+                "description": "Data filter criteria"
+              },
+              "categoryField": {
+                "type": "string",
+                "description": "Field for grouping (X-Axis)"
+              },
+              "valueField": {
+                "type": "string",
+                "description": "Field for values (Y-Axis)"
+              },
+              "aggregate": {
+                "type": "string",
+                "enum": [
+                  "count",
+                  "sum",
+                  "avg",
+                  "min",
+                  "max"
+                ],
+                "default": "count",
+                "description": "Aggregate function"
+              },
+              "layout": {
+                "type": "object",
+                "properties": {
+                  "x": {
+                    "type": "number"
+                  },
+                  "y": {
+                    "type": "number"
+                  },
+                  "w": {
+                    "type": "number"
+                  },
+                  "h": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "x",
+                  "y",
+                  "w",
+                  "h"
+                ],
+                "additionalProperties": false,
+                "description": "Grid layout position"
+              },
+              "options": {
+                "description": "Widget specific configuration"
+              }
+            },
+            "required": [
+              "layout"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Widgets to display"
+        }
+      },
+      "required": [
+        "name",
+        "label",
+        "widgets"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/DashboardNavItem.json

@@ -0,0 +1,42 @@
+{
+  "$ref": "#/definitions/DashboardNavItem",
+  "definitions": {
+    "DashboardNavItem": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier for this navigation item"
+        },
+        "label": {
+          "type": "string",
+          "description": "Display proper label"
+        },
+        "icon": {
+          "type": "string",
+          "description": "Icon name"
+        },
+        "visible": {
+          "type": "string",
+          "description": "Visibility formula condition"
+        },
+        "type": {
+          "type": "string",
+          "const": "dashboard"
+        },
+        "dashboardName": {
+          "type": "string",
+          "description": "Target dashboard name"
+        }
+      },
+      "required": [
+        "id",
+        "label",
+        "type",
+        "dashboardName"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/DashboardWidget.json

@@ -0,0 +1,89 @@
+{
+  "$ref": "#/definitions/DashboardWidget",
+  "definitions": {
+    "DashboardWidget": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Widget title"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "metric",
+            "bar",
+            "line",
+            "pie",
+            "donut",
+            "funnel",
+            "table",
+            "text"
+          ],
+          "default": "metric",
+          "description": "Visualization type"
+        },
+        "object": {
+          "type": "string",
+          "description": "Data source object name"
+        },
+        "filter": {
+          "description": "Data filter criteria"
+        },
+        "categoryField": {
+          "type": "string",
+          "description": "Field for grouping (X-Axis)"
+        },
+        "valueField": {
+          "type": "string",
+          "description": "Field for values (Y-Axis)"
+        },
+        "aggregate": {
+          "type": "string",
+          "enum": [
+            "count",
+            "sum",
+            "avg",
+            "min",
+            "max"
+          ],
+          "default": "count",
+          "description": "Aggregate function"
+        },
+        "layout": {
+          "type": "object",
+          "properties": {
+            "x": {
+              "type": "number"
+            },
+            "y": {
+              "type": "number"
+            },
+            "w": {
+              "type": "number"
+            },
+            "h": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "x",
+            "y",
+            "w",
+            "h"
+          ],
+          "additionalProperties": false,
+          "description": "Grid layout position"
+        },
+        "options": {
+          "description": "Widget specific configuration"
+        }
+      },
+      "required": [
+        "layout"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Dataset.json

@@ -0,0 +1,63 @@
+{
+  "$ref": "#/definitions/Dataset",
+  "definitions": {
+    "Dataset": {
+      "type": "object",
+      "properties": {
+        "object": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$",
+          "description": "Target Object Name"
+        },
+        "externalId": {
+          "type": "string",
+          "default": "name",
+          "description": "Field match for uniqueness check"
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "insert",
+            "update",
+            "upsert",
+            "replace",
+            "ignore"
+          ],
+          "default": "upsert",
+          "description": "Conflict resolution strategy"
+        },
+        "env": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "prod",
+              "dev",
+              "test"
+            ]
+          },
+          "default": [
+            "prod",
+            "dev",
+            "test"
+          ],
+          "description": "Applicable environments"
+        },
+        "records": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": {}
+          },
+          "description": "Data records"
+        }
+      },
+      "required": [
+        "object",
+        "records"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/DatasetMode.json

@@ -0,0 +1,16 @@
+{
+  "$ref": "#/definitions/DatasetMode",
+  "definitions": {
+    "DatasetMode": {
+      "type": "string",
+      "enum": [
+        "insert",
+        "update",
+        "upsert",
+        "replace",
+        "ignore"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/Datasource.json

@@ -0,0 +1,93 @@
+{
+  "$ref": "#/definitions/Datasource",
+  "definitions": {
+    "Datasource": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$",
+          "description": "Unique datasource identifier"
+        },
+        "label": {
+          "type": "string",
+          "description": "Display label"
+        },
+        "driver": {
+          "type": "string",
+          "enum": [
+            "postgres",
+            "mysql",
+            "sqlserver",
+            "oracle",
+            "sqlite",
+            "mongo",
+            "redis",
+            "excel",
+            "csv",
+            "airtable",
+            "rest_api",
+            "graphql",
+            "odata",
+            "salesforce",
+            "sap",
+            "workday"
+          ],
+          "description": "Underlying driver type"
+        },
+        "config": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Driver specific configuration"
+        },
+        "capabilities": {
+          "type": "object",
+          "properties": {
+            "joins": {
+              "type": "boolean",
+              "default": false
+            },
+            "transactions": {
+              "type": "boolean",
+              "default": false
+            },
+            "fullTextSearch": {
+              "type": "boolean",
+              "default": false
+            },
+            "aggregation": {
+              "type": "boolean",
+              "default": false
+            },
+            "dynamicSchema": {
+              "type": "boolean",
+              "default": false
+            },
+            "readOnly": {
+              "type": "boolean",
+              "default": false
+            }
+          },
+          "additionalProperties": false,
+          "description": "Capability overrides"
+        },
+        "description": {
+          "type": "string",
+          "description": "Internal description"
+        },
+        "active": {
+          "type": "boolean",
+          "default": true,
+          "description": "Is datasource enabled"
+        }
+      },
+      "required": [
+        "name",
+        "driver",
+        "config"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/DatasourceCapabilities.json

@@ -0,0 +1,36 @@
+{
+  "$ref": "#/definitions/DatasourceCapabilities",
+  "definitions": {
+    "DatasourceCapabilities": {
+      "type": "object",
+      "properties": {
+        "joins": {
+          "type": "boolean",
+          "default": false
+        },
+        "transactions": {
+          "type": "boolean",
+          "default": false
+        },
+        "fullTextSearch": {
+          "type": "boolean",
+          "default": false
+        },
+        "aggregation": {
+          "type": "boolean",
+          "default": false
+        },
+        "dynamicSchema": {
+          "type": "boolean",
+          "default": false
+        },
+        "readOnly": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}