@objectstack/spec 0.3.2 → 0.4.1

package/json-schema/hub/ConflictReport.json

@@ -0,0 +1,53 @@
+{
+  "$ref": "#/definitions/ConflictReport",
+  "definitions": {
+    "ConflictReport": {
+      "type": "object",
+      "properties": {
+        "resourceType": {
+          "type": "string",
+          "enum": [
+            "object",
+            "field",
+            "api",
+            "ui"
+          ],
+          "description": "Type of colliding resource"
+        },
+        "resourceId": {
+          "type": "string",
+          "description": "ID of the resource"
+        },
+        "sources": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of plugin IDs defining this resource"
+        },
+        "resolution": {
+          "type": "string",
+          "description": "How it was resolved (e.g. \"com.example.erp won\")"
+        },
+        "severity": {
+          "type": "string",
+          "enum": [
+            "info",
+            "warning",
+            "error"
+          ],
+          "description": "Severity of the conflict"
+        }
+      },
+      "required": [
+        "resourceType",
+        "resourceId",
+        "sources",
+        "resolution",
+        "severity"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/hub/DependencyRequirement.json

@@ -0,0 +1,36 @@
+{
+  "$ref": "#/definitions/DependencyRequirement",
+  "definitions": {
+    "DependencyRequirement": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Plugin ID (e.g. \"com.example.crm\")"
+        },
+        "version": {
+          "type": "string",
+          "default": "latest",
+          "description": "SemVer range or \"latest\""
+        },
+        "configuration": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Configuration overrides"
+        },
+        "features": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "boolean"
+          },
+          "description": "Feature toggles"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/hub/DeploymentTarget.json

@@ -0,0 +1,38 @@
+{
+  "$ref": "#/definitions/DeploymentTarget",
+  "definitions": {
+    "DeploymentTarget": {
+      "type": "object",
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": [
+            "vercel",
+            "docker",
+            "kubernetes"
+          ]
+        },
+        "region": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Public Access URL"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Runtime Environment Variables"
+        }
+      },
+      "required": [
+        "provider"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/hub/HubSpace.json

@@ -0,0 +1,279 @@
+{
+  "$ref": "#/definitions/HubSpace",
+  "definitions": {
+    "HubSpace": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid"
+        },
+        "name": {
+          "type": "string"
+        },
+        "slug": {
+          "type": "string",
+          "description": "URL friendly identifier"
+        },
+        "ownerId": {
+          "type": "string"
+        },
+        "runtime": {
+          "type": "object",
+          "properties": {
+            "isolation": {
+              "type": "string",
+              "enum": [
+                "shared_schema",
+                "isolated_schema",
+                "isolated_db"
+              ],
+              "description": "Data isolation strategy"
+            },
+            "quotas": {
+              "type": "object",
+              "properties": {
+                "maxUsers": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Maximum number of users"
+                },
+                "maxStorage": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "Maximum storage in bytes"
+                },
+                "apiRateLimit": {
+                  "type": "integer",
+                  "exclusiveMinimum": 0,
+                  "description": "API requests per minute"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Resource quotas"
+            }
+          },
+          "required": [
+            "isolation"
+          ],
+          "additionalProperties": false,
+          "description": "Runtime instance configuration"
+        },
+        "bom": {
+          "type": "object",
+          "properties": {
+            "tenantId": {
+              "type": "string",
+              "description": "Target Tenant ID"
+            },
+            "dependencies": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Plugin ID (e.g. \"com.example.crm\")"
+                  },
+                  "version": {
+                    "type": "string",
+                    "default": "latest",
+                    "description": "SemVer range or \"latest\""
+                  },
+                  "configuration": {
+                    "type": "object",
+                    "additionalProperties": {},
+                    "description": "Configuration overrides"
+                  },
+                  "features": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "boolean"
+                    },
+                    "description": "Feature toggles"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Installed packages"
+            },
+            "environment": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "resolutionStrategy": {
+              "type": "string",
+              "enum": [
+                "strict",
+                "override",
+                "merge"
+              ],
+              "default": "override",
+              "description": "Conflict resolution strategy (strict=fail, override=last-wins, merge=deep-merge)"
+            }
+          },
+          "required": [
+            "tenantId",
+            "dependencies"
+          ],
+          "additionalProperties": false
+        },
+        "lastBuild": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "timestamp": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "manifestUrl": {
+              "type": "string",
+              "format": "uri"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "pending",
+                "success",
+                "failed"
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "timestamp",
+            "status"
+          ],
+          "additionalProperties": false
+        },
+        "subscription": {
+          "type": "object",
+          "properties": {
+            "planId": {
+              "type": "string",
+              "description": "Reference to Plan Code"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "active",
+                "past_due",
+                "canceled",
+                "trialing",
+                "incomplete"
+              ]
+            },
+            "currentPeriodEnd": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "stripeCustomerId": {
+              "type": "string"
+            },
+            "stripeSubscriptionId": {
+              "type": "string"
+            },
+            "addons": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "pluginId": {
+                    "type": "string",
+                    "description": "Marketplace Plugin ID (NPM package name)"
+                  },
+                  "quantity": {
+                    "type": "number",
+                    "default": 1
+                  },
+                  "status": {
+                    "type": "string",
+                    "enum": [
+                      "active",
+                      "past_due",
+                      "canceled",
+                      "trialing",
+                      "incomplete"
+                    ],
+                    "default": "active"
+                  }
+                },
+                "required": [
+                  "pluginId"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "usage": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "number"
+              }
+            }
+          },
+          "required": [
+            "planId",
+            "status"
+          ],
+          "additionalProperties": false
+        },
+        "deployment": {
+          "type": "object",
+          "properties": {
+            "provider": {
+              "type": "string",
+              "enum": [
+                "vercel",
+                "docker",
+                "kubernetes"
+              ]
+            },
+            "region": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "description": "Public Access URL"
+            },
+            "env": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              },
+              "description": "Runtime Environment Variables"
+            }
+          },
+          "required": [
+            "provider"
+          ],
+          "additionalProperties": false
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "slug",
+        "ownerId",
+        "bom",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/{system → hub}/License.json

@@ -4,8 +4,9 @@
     "License": {
       "type": "object",
       "properties": {
-        "tenantId": {
-          "type": "string"
+        "spaceId": {
+          "type": "string",
+          "description": "Target Space ID"
         },
         "planCode": {
           "type": "string"
@@ -39,13 +40,20 @@
             "type": "number"
           }
         },
+        "plugins": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of enabled plugin package IDs"
+        },
         "signature": {
           "type": "string",
           "description": "Cryptographic signature of the license"
         }
       },
       "required": [
-        "tenantId",
+        "spaceId",
         "planCode",
         "issuedAt",
         "status"

package/json-schema/hub/MarketplacePlugin.json

@@ -0,0 +1,141 @@
+{
+  "$ref": "#/definitions/MarketplacePlugin",
+  "definitions": {
+    "MarketplacePlugin": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "readme": {
+          "type": "string"
+        },
+        "version": {
+          "type": "string"
+        },
+        "author": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "email": {
+              "type": "string",
+              "format": "email"
+            },
+            "url": {
+              "type": "string",
+              "format": "uri"
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "additionalProperties": false
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "app",
+            "integration",
+            "theme",
+            "utility",
+            "driver"
+          ]
+        },
+        "icon": {
+          "type": "string",
+          "format": "uri"
+        },
+        "screenshots": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "uri"
+          }
+        },
+        "homepage": {
+          "type": "string",
+          "format": "uri"
+        },
+        "repository": {
+          "type": "string",
+          "format": "uri"
+        },
+        "bugs": {
+          "type": "string",
+          "format": "uri"
+        },
+        "downloads": {
+          "type": "integer"
+        },
+        "rating": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 5
+        },
+        "pricing": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "free",
+                "one_time",
+                "recurring"
+              ]
+            },
+            "currency": {
+              "type": "string",
+              "default": "USD"
+            },
+            "amount": {
+              "type": "number",
+              "minimum": 0
+            },
+            "interval": {
+              "type": "string",
+              "enum": [
+                "month",
+                "year"
+              ],
+              "description": "Required if type is recurring"
+            },
+            "trialDays": {
+              "type": "integer"
+            }
+          },
+          "required": [
+            "type",
+            "amount"
+          ],
+          "additionalProperties": false
+        },
+        "verified": {
+          "type": "boolean",
+          "default": false,
+          "description": "Is verified maintaned by ObjectStack"
+        }
+      },
+      "required": [
+        "id",
+        "label",
+        "version"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/hub/PluginAuthor.json

@@ -0,0 +1,26 @@
+{
+  "$ref": "#/definitions/PluginAuthor",
+  "definitions": {
+    "PluginAuthor": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string",
+          "format": "email"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/hub/PluginPricing.json

@@ -0,0 +1,43 @@
+{
+  "$ref": "#/definitions/PluginPricing",
+  "definitions": {
+    "PluginPricing": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "free",
+            "one_time",
+            "recurring"
+          ]
+        },
+        "currency": {
+          "type": "string",
+          "default": "USD"
+        },
+        "amount": {
+          "type": "number",
+          "minimum": 0
+        },
+        "interval": {
+          "type": "string",
+          "enum": [
+            "month",
+            "year"
+          ],
+          "description": "Required if type is recurring"
+        },
+        "trialDays": {
+          "type": "integer"
+        }
+      },
+      "required": [
+        "type",
+        "amount"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}