initiative-plugin-sdk 4.1.1 → 5.0.0

package/schemas/plugin-manifest.json

@@ -89,8 +89,8 @@
       "items": {
         "enum": [
           "dashboards",
-          "embeds",
           "endpoints",
+          "pages",
           "widgets"
         ]
       },
@@ -115,6 +115,11 @@
       },
       "description": "How old somebody must be to use this plug-in, by where they are. Keys are ISO 3166-1 alpha-2 country codes, upper case, and 'default' for every country not listed: {\"default\": 16, \"US\": 13}. The age of digital consent differs by country, inside the EU as well as outside it, which is why a region is a country rather than a regime. Absent, or a country with no entry and no 'default': the deployment's own minimum applies. A declaration, not a gate: whether a deployment enforces it, and how it learns somebody's age and country, are its decisions. At most 64 entries, each from 13 to 21."
     },
+    "min_plugin_api": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+$",
+      "description": "The oldest plug-in API contract this plug-in needs, as 'MAJOR.MINOR': '4.1'. The contract is the plug-in API published with initiative-plugin-sdk, versioned as that package is. A deployment serving contract S can run it when S has the same major version and a minor version at least this one's. Absent: any contract; the plug-in makes no claim. Beside a listing's min_app_version, the oldest Initiative release it runs on, this says what the plug-in calls rather than which release serves it."
+    },
     "hosts": {
       "type": "array",
       "minItems": 1,
@@ -168,11 +173,11 @@
         "$ref": "#/$defs/widget"
       }
     },
-    "embeds": {
+    "pages": {
       "type": "array",
       "maxItems": 12,
       "items": {
-        "$ref": "#/$defs/embed"
+        "$ref": "#/$defs/page"
       }
     },
     "dashboards": {
@@ -1090,7 +1095,7 @@
         }
       }
     },
-    "embed": {
+    "page": {
       "type": "object",
       "required": [
         "id",
@@ -1119,12 +1124,12 @@
           "default": [
             "community"
           ],
-          "description": "Where the surface renders. Declaring both gives it a community-wide entry and an entry inside each initiative."
+          "description": "Where the page renders. Declaring both gives it a community-wide entry and an entry inside each initiative."
         },
         "admin_only": {
           "type": "boolean",
           "default": false,
-          "description": "Only the community's admins open this surface, whatever roles a placement allows — a settings page, say. Who else may open a surface is chosen in the community, per initiative and per role, not declared here."
+          "description": "Only the community's admins open this page, whatever roles a placement allows — a settings page, say. Who else may open a page is chosen in the community, per initiative and per role, not declared here."
         },
         "capabilities": {
           "type": "array",
@@ -1140,7 +1145,7 @@
               "microphone"
             ]
           },
-          "description": "Browser features the frame is granted. A surface that names nothing is framed with all of them denied."
+          "description": "Browser features the frame is granted. A page that names nothing is framed with all of them denied."
         },
         "requires": {
           "$ref": "#/$defs/requires"