@objectstack/spec 0.2.0 → 0.3.1

package/json-schema/system/OnceSchedule.json

@@ -0,0 +1,25 @@
+{
+  "$ref": "#/definitions/OnceSchedule",
+  "definitions": {
+    "OnceSchedule": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "once"
+        },
+        "at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 datetime when to execute"
+        }
+      },
+      "required": [
+        "type",
+        "at"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/Organization.json

@@ -0,0 +1,52 @@
+{
+  "$ref": "#/definitions/Organization",
+  "definitions": {
+    "Organization": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique organization identifier"
+        },
+        "name": {
+          "type": "string",
+          "description": "Organization display name"
+        },
+        "slug": {
+          "type": "string",
+          "pattern": "^[a-z0-9_-]+$",
+          "description": "Unique URL-friendly slug (lowercase alphanumeric, hyphens, underscores)"
+        },
+        "logo": {
+          "type": "string",
+          "format": "uri",
+          "description": "Organization logo URL"
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Custom metadata"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Organization creation timestamp"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Last update timestamp"
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "slug",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/Presence.json

@@ -0,0 +1,40 @@
+{
+  "$ref": "#/definitions/Presence",
+  "definitions": {
+    "Presence": {
+      "type": "object",
+      "properties": {
+        "userId": {
+          "type": "string",
+          "description": "User identifier"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "online",
+            "away",
+            "offline"
+          ],
+          "description": "Current presence status"
+        },
+        "lastSeen": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 datetime of last activity"
+        },
+        "metadata": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Custom presence data (e.g., current page, custom status)"
+        }
+      },
+      "required": [
+        "userId",
+        "status",
+        "lastSeen"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/PresenceStatus.json

@@ -0,0 +1,14 @@
+{
+  "$ref": "#/definitions/PresenceStatus",
+  "definitions": {
+    "PresenceStatus": {
+      "type": "string",
+      "enum": [
+        "online",
+        "away",
+        "offline"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/RealtimeAction.json

@@ -0,0 +1,14 @@
+{
+  "$ref": "#/definitions/RealtimeAction",
+  "definitions": {
+    "RealtimeAction": {
+      "type": "string",
+      "enum": [
+        "created",
+        "updated",
+        "deleted"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/RealtimeEvent.json

@@ -0,0 +1,51 @@
+{
+  "$ref": "#/definitions/RealtimeEvent",
+  "definitions": {
+    "RealtimeEvent": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Unique event identifier"
+        },
+        "type": {
+          "type": "string",
+          "description": "Event type (e.g., record.created, record.updated)"
+        },
+        "object": {
+          "type": "string",
+          "description": "Object name the event relates to"
+        },
+        "action": {
+          "type": "string",
+          "enum": [
+            "created",
+            "updated",
+            "deleted"
+          ],
+          "description": "Action performed"
+        },
+        "payload": {
+          "description": "Event payload data"
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 datetime when event occurred"
+        },
+        "userId": {
+          "type": "string",
+          "description": "User who triggered the event"
+        }
+      },
+      "required": [
+        "id",
+        "type",
+        "timestamp"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/RealtimeEventType.json

@@ -0,0 +1,15 @@
+{
+  "$ref": "#/definitions/RealtimeEventType",
+  "definitions": {
+    "RealtimeEventType": {
+      "type": "string",
+      "enum": [
+        "record.created",
+        "record.updated",
+        "record.deleted",
+        "field.changed"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/RetryPolicy.json

@@ -0,0 +1,30 @@
+{
+  "$ref": "#/definitions/RetryPolicy",
+  "definitions": {
+    "RetryPolicy": {
+      "type": "object",
+      "properties": {
+        "maxRetries": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 3,
+          "description": "Maximum number of retry attempts"
+        },
+        "backoffMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "default": 1000,
+          "description": "Initial backoff delay in milliseconds"
+        },
+        "backoffMultiplier": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "default": 2,
+          "description": "Multiplier for exponential backoff"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/RowLevelIsolationStrategy.json

@@ -0,0 +1,74 @@
+{
+  "$ref": "#/definitions/RowLevelIsolationStrategy",
+  "definitions": {
+    "RowLevelIsolationStrategy": {
+      "type": "object",
+      "properties": {
+        "strategy": {
+          "type": "string",
+          "const": "shared_schema",
+          "description": "Row-level isolation strategy"
+        },
+        "database": {
+          "type": "object",
+          "properties": {
+            "enableRLS": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable PostgreSQL Row-Level Security"
+            },
+            "contextMethod": {
+              "type": "string",
+              "enum": [
+                "session_variable",
+                "search_path",
+                "application_name"
+              ],
+              "default": "session_variable",
+              "description": "How to set tenant context"
+            },
+            "contextVariable": {
+              "type": "string",
+              "default": "app.current_tenant",
+              "description": "Session variable name"
+            },
+            "applicationValidation": {
+              "type": "boolean",
+              "default": true,
+              "description": "Application-level tenant validation"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Database configuration"
+        },
+        "performance": {
+          "type": "object",
+          "properties": {
+            "usePartialIndexes": {
+              "type": "boolean",
+              "default": true,
+              "description": "Use partial indexes per tenant"
+            },
+            "usePartitioning": {
+              "type": "boolean",
+              "default": false,
+              "description": "Use table partitioning by tenant_id"
+            },
+            "poolSizePerTenant": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "description": "Connection pool size per tenant"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Performance settings"
+        }
+      },
+      "required": [
+        "strategy"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/{SAMLConfig.json → system/SAMLConfig.json}

@@ -4,6 +4,10 @@
     "SAMLConfig": {
       "type": "object",
       "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false
+        },
         "entryPoint": {
           "type": "string",
           "format": "uri",
@@ -11,7 +15,7 @@
         },
         "cert": {
           "type": "string",
-          "description": "IdP Public Certificate"
+          "description": "IdP Public Certificate (PEM format)"
         },
         "issuer": {
           "type": "string",
@@ -23,13 +27,23 @@
             "sha256",
             "sha512"
           ],
-          "default": "sha256"
+          "default": "sha256",
+          "description": "Signature algorithm"
         },
         "attributeMapping": {
           "type": "object",
           "additionalProperties": {
             "type": "string"
-          }
+          },
+          "description": "Map SAML attributes to User fields"
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Display name for the provider button"
+        },
+        "icon": {
+          "type": "string",
+          "description": "Icon URL or identifier"
         }
       },
       "required": [

package/json-schema/system/Schedule.json

@@ -0,0 +1,71 @@
+{
+  "$ref": "#/definitions/Schedule",
+  "definitions": {
+    "Schedule": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "cron"
+            },
+            "expression": {
+              "type": "string",
+              "description": "Cron expression (e.g., \"0 0 * * *\" for daily at midnight)"
+            },
+            "timezone": {
+              "type": "string",
+              "default": "UTC",
+              "description": "Timezone for cron execution (e.g., \"America/New_York\")"
+            }
+          },
+          "required": [
+            "type",
+            "expression"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "interval"
+            },
+            "intervalMs": {
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "description": "Interval in milliseconds"
+            }
+          },
+          "required": [
+            "type",
+            "intervalMs"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "const": "once"
+            },
+            "at": {
+              "type": "string",
+              "format": "date-time",
+              "description": "ISO 8601 datetime when to execute"
+            }
+          },
+          "required": [
+            "type",
+            "at"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/system/Session.json

@@ -0,0 +1,63 @@
+{
+  "$ref": "#/definitions/Session",
+  "definitions": {
+    "Session": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique session identifier"
+        },
+        "sessionToken": {
+          "type": "string",
+          "description": "Session token"
+        },
+        "userId": {
+          "type": "string",
+          "description": "Associated user ID"
+        },
+        "activeOrganizationId": {
+          "type": "string",
+          "description": "Active organization ID for context switching"
+        },
+        "expires": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Session expiry timestamp"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Session creation timestamp"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Last update timestamp"
+        },
+        "ipAddress": {
+          "type": "string",
+          "description": "IP address"
+        },
+        "userAgent": {
+          "type": "string",
+          "description": "User agent string"
+        },
+        "fingerprint": {
+          "type": "string",
+          "description": "Device fingerprint"
+        }
+      },
+      "required": [
+        "id",
+        "sessionToken",
+        "userId",
+        "expires",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}