Add plugin pricing and addons support to schemas

Introduces plugin pricing models to MarketplacePlugin and a dedicated PluginPricing schema. Adds support for purchased addons in SpaceSubscription and HubSpace schemas, and tracks enabled plugins in License. Updates Zod schemas to reflect these new properties for better marketplace and subscription management.

Author: hotlong

packages/spec/json-schema/hub/HubSpace.json

@@ -180,6 +180,37 @@
             "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": {

packages/spec/json-schema/hub/License.json

@@ -40,6 +40,13 @@
             "type": "number"
           }
         },
+        "plugins": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of enabled plugin package IDs"
+        },
         "signature": {
           "type": "string",
           "description": "Cryptographic signature of the license"

packages/spec/json-schema/hub/MarketplacePlugin.json

@@ -86,6 +86,43 @@
           "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,

packages/spec/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#"
+}

packages/spec/json-schema/hub/SpaceSubscription.json

@@ -28,6 +28,37 @@
         "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": {

packages/spec/src/hub/license.zod.ts

@@ -69,6 +69,9 @@ export const LicenseSchema = z.object({
   customFeatures: z.array(z.string()).optional(),
   customLimits: z.record(z.number()).optional(),
 
+  /** Authorized Add-ons */
+  plugins: z.array(z.string()).optional().describe('List of enabled plugin package IDs'),
+
   /** Signature */
   signature: z.string().optional().describe('Cryptographic signature of the license'),
 });

packages/spec/src/hub/marketplace.zod.ts

@@ -16,6 +16,17 @@ export const PluginAuthorSchema = z.object({
   url: z.string().url().optional(),
 });
 
+/**
+ * Plugin Pricing Model Schema
+ */
+export const PluginPricingSchema = z.object({
+  type: z.enum(['free', 'one_time', 'recurring']),
+  currency: z.string().default('USD'),
+  amount: z.number().min(0),
+  interval: z.enum(['month', 'year']).optional().describe('Required if type is recurring'),
+  trialDays: z.number().int().optional(),
+});
+
 /**
  * Plugin Registry Entry Schema
  * Represents a listing in the Marketplace.
@@ -76,6 +87,12 @@ export const MarketplacePluginSchema = z.object({
    */
   downloads: z.number().int().optional(),
   rating: z.number().min(0).max(5).optional(),
+
+  /**
+   * Commercial Information
+   */
+  pricing: PluginPricingSchema.optional(),
+
   verified: z.boolean().default(false).describe('Is verified maintaned by ObjectStack'),
 });
 

packages/spec/src/hub/space.zod.ts

@@ -31,6 +31,15 @@ export const SpaceSubscriptionSchema = z.object({
   stripeCustomerId: z.string().optional(),
   stripeSubscriptionId: z.string().optional(),
 
+  /**
+   * Purchased Add-ons from Marketplace
+   */
+  addons: z.array(z.object({
+    pluginId: z.string().describe('Marketplace Plugin ID (NPM package name)'),
+    quantity: z.number().default(1),
+    status: SubscriptionStatus.default('active'),
+  })).optional(),
+
   /**
    * Quota Usage Snapshot
    * Cached usage metrics for quick display/validation.