@notionhq/custom-blocks-host 0.5.2 → 0.7.0

package/dist/messages/invalidNativeIconColor.js

@@ -0,0 +1,34 @@
+import { notionIconColorSchema } from "../protocol/icons.js";
+import * as v from "valibot";
+const nativeIconMutationSchema = v.object({
+    type: v.picklist(["updatePage", "createPage"]),
+    requestId: v.string(),
+    icon: v.object({
+        type: v.literal("icon"),
+        icon: v.object({ color: v.unknown() }),
+    }),
+});
+/** Reject malformed colors with a correlated result before invoking a page mutation handler. */
+export function getInvalidNativeIconColorResponse(data) {
+    const parsed = v.safeParse(nativeIconMutationSchema, data);
+    if (!parsed.success) {
+        return;
+    }
+    const color = parsed.output.icon.icon.color;
+    if (color === undefined ||
+        v.safeParse(notionIconColorSchema, color).success) {
+        return;
+    }
+    return {
+        type: parsed.output.type === "createPage"
+            ? "createPageResult"
+            : "updatePageResult",
+        requestId: parsed.output.requestId,
+        status: "error",
+        error: {
+            code: "invalid_icon_color",
+            message: "Use a supported Notion icon color.",
+            isRetryable: false,
+        },
+    };
+}

package/dist/pages/types.d.ts

@@ -3,6 +3,7 @@ import type { createPageMessageSchema } from "../protocol/pages/messages/createP
 import type { getPageMessageSchema } from "../protocol/pages/messages/getPage.js";
 import type { openPageMessageSchema } from "../protocol/pages/messages/openPage.js";
 import type { updatePageMessageSchema } from "../protocol/pages/messages/updatePage.js";
+import type { notionPageIconSchema } from "../protocol/pages/pageAppearance.js";
 import type { InferInput } from "valibot";
 import type { CustomBlockHostResult } from "../messages/result.js";
 export type CreatePageMessageInput = InferInput<typeof createPageMessageSchema>;
@@ -15,4 +16,5 @@ export type CustomBlockHostPageResult = CustomBlockHostResult<{
 export type CustomBlockHostOpenPageResult = CustomBlockHostResult<{
     pageId: string;
 }>;
+export type CustomBlockHostPageIcon = InferInput<typeof notionPageIconSchema>;
 //# sourceMappingURL=types.d.ts.map

package/dist/pages/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pages/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sDAAsD,CAAA;AACtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAA;AAC5G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAA;AACtG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAA;AACxG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAA;AAC5G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE/E,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEzE,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE3E,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE/E,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;IAC7D,IAAI,EAAE,UAAU,CAAA;CAChB,CAAC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;IACjE,MAAM,EAAE,MAAM,CAAA;CACd,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pages/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sDAAsD,CAAA;AACtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAA;AAC5G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAA;AACtG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAA;AACxG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+DAA+D,CAAA;AAC5G,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAA;AACpG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE/E,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEzE,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE3E,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE/E,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,CAAC;IAC7D,IAAI,EAAE,UAAU,CAAA;CAChB,CAAC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;IACjE,MAAM,EAAE,MAAM,CAAA;CACd,CAAC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/protocol/compatibility/protocol3To5/bridgePage.d.ts

@@ -206,10 +206,6 @@ export declare const bridgePageForProtocol3To5Schema: v.ObjectSchema<{
             readonly table: v.PicklistSchema<["notion_user", "bot", "organization_bot"], undefined>;
             readonly spaceId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly id: v.StringSchema<undefined>;
-        readonly type: v.LiteralSchema<"last_visited_time", undefined>;
-        readonly last_visited_time: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>, v.ObjectSchema<{
         readonly id: v.StringSchema<undefined>;
         readonly type: v.LiteralSchema<"unique_id", undefined>;
@@ -237,7 +233,13 @@ export declare const bridgePageForProtocol3To5Schema: v.ObjectSchema<{
     }, undefined>], undefined>, undefined>;
     readonly created_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly last_edited_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"icon", undefined>;
+        readonly icon: v.LooseObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly color: v.OptionalSchema<v.GenericSchema<import("../../icons.js").NotionIconColor>, undefined>;
+        }, undefined>;
+    }, undefined>, v.ObjectSchema<{
         readonly type: v.LiteralSchema<"emoji", undefined>;
         readonly emoji: v.StringSchema<undefined>;
     }, undefined>, v.ObjectSchema<{

package/dist/protocol/dataSources/bridgeDataSourceBinding.d.ts

@@ -121,10 +121,6 @@ export declare const bridgeDataSourceBindingSchema: v.ObjectSchema<{
             readonly name: v.StringSchema<undefined>;
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly type: v.LiteralSchema<"verification", undefined>;
-        }, undefined>, v.ObjectSchema<{
-            readonly name: v.StringSchema<undefined>;
-            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly type: v.LiteralSchema<"last_visited_time", undefined>;
         }, undefined>, v.ObjectSchema<{
             readonly name: v.StringSchema<undefined>;
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/protocol/dataSources/bridgeDataSourceBindings.d.ts

@@ -116,10 +116,6 @@ export declare const bridgeDataSourceBindingsSchema: v.RecordSchema<v.StringSche
             readonly name: v.StringSchema<undefined>;
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly type: v.LiteralSchema<"verification", undefined>;
-        }, undefined>, v.ObjectSchema<{
-            readonly name: v.StringSchema<undefined>;
-            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly type: v.LiteralSchema<"last_visited_time", undefined>;
         }, undefined>, v.ObjectSchema<{
             readonly name: v.StringSchema<undefined>;
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/protocol/dataSources/collectionSchema.d.ts

@@ -115,10 +115,6 @@ export declare const notionCollectionSchemaValidator: v.ObjectSchema<{
         readonly name: v.StringSchema<undefined>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.LiteralSchema<"verification", undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly name: v.StringSchema<undefined>;
-        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        readonly type: v.LiteralSchema<"last_visited_time", undefined>;
     }, undefined>, v.ObjectSchema<{
         readonly name: v.StringSchema<undefined>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/protocol/dataSources/messages/dataSourcesChanged.d.ts

@@ -124,10 +124,6 @@ export declare const dataSourcesChangedMessageSchema: v.ObjectSchema<{
                     readonly name: v.StringSchema<undefined>;
                     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                     readonly type: v.LiteralSchema<"verification", undefined>;
-                }, undefined>, v.ObjectSchema<{
-                    readonly name: v.StringSchema<undefined>;
-                    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                    readonly type: v.LiteralSchema<"last_visited_time", undefined>;
                 }, undefined>, v.ObjectSchema<{
                     readonly name: v.StringSchema<undefined>;
                     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/protocol/dataSources/messages/queryDataSource.d.ts

@@ -745,10 +745,6 @@ export declare const queryDataSourceResultMessageSchema: v.VariantSchema<"status
                 readonly table: v.PicklistSchema<["notion_user", "bot", "organization_bot"], undefined>;
                 readonly spaceId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             }, undefined>, undefined>;
-        }, undefined>, v.ObjectSchema<{
-            readonly id: v.StringSchema<undefined>;
-            readonly type: v.LiteralSchema<"last_visited_time", undefined>;
-            readonly last_visited_time: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, v.ObjectSchema<{
             readonly id: v.StringSchema<undefined>;
             readonly type: v.LiteralSchema<"unique_id", undefined>;
@@ -784,10 +780,15 @@ export declare const queryDataSourceResultMessageSchema: v.VariantSchema<"status
             readonly table: v.PicklistSchema<["notion_user", "bot", "organization_bot"], undefined>;
             readonly spaceId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, undefined>, null>;
-        readonly last_visited_time: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>;
         readonly created_time: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>;
         readonly last_edited_time: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>;
-        readonly icon: v.OptionalSchema<v.NullableSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly icon: v.OptionalSchema<v.NullableSchema<v.VariantSchema<"type", [v.LooseObjectSchema<{
+            readonly type: v.LiteralSchema<"icon", undefined>;
+            readonly icon: v.LooseObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly color: v.OptionalSchema<v.GenericSchema<import("../../icons.js").NotionIconColor>, undefined>;
+            }, undefined>;
+        }, undefined>, v.ObjectSchema<{
             readonly type: v.LiteralSchema<"emoji", undefined>;
             readonly emoji: v.StringSchema<undefined>;
         }, undefined>, v.ObjectSchema<{
@@ -1048,10 +1049,6 @@ export declare const queryDataSourceResultMessageWithProtocol3To5CompatibilitySc
                 readonly table: v.PicklistSchema<["notion_user", "bot", "organization_bot"], undefined>;
                 readonly spaceId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             }, undefined>, undefined>;
-        }, undefined>, v.ObjectSchema<{
-            readonly id: v.StringSchema<undefined>;
-            readonly type: v.LiteralSchema<"last_visited_time", undefined>;
-            readonly last_visited_time: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, v.ObjectSchema<{
             readonly id: v.StringSchema<undefined>;
             readonly type: v.LiteralSchema<"unique_id", undefined>;
@@ -1087,10 +1084,15 @@ export declare const queryDataSourceResultMessageWithProtocol3To5CompatibilitySc
             readonly table: v.PicklistSchema<["notion_user", "bot", "organization_bot"], undefined>;
             readonly spaceId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, undefined>, null>;
-        readonly last_visited_time: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>;
         readonly created_time: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>;
         readonly last_edited_time: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>;
-        readonly icon: v.OptionalSchema<v.NullableSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly icon: v.OptionalSchema<v.NullableSchema<v.VariantSchema<"type", [v.LooseObjectSchema<{
+            readonly type: v.LiteralSchema<"icon", undefined>;
+            readonly icon: v.LooseObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly color: v.OptionalSchema<v.GenericSchema<import("../../icons.js").NotionIconColor>, undefined>;
+            }, undefined>;
+        }, undefined>, v.ObjectSchema<{
             readonly type: v.LiteralSchema<"emoji", undefined>;
             readonly emoji: v.StringSchema<undefined>;
         }, undefined>, v.ObjectSchema<{

package/dist/protocol/dataSources/notionDataSource.d.ts

@@ -122,10 +122,6 @@ export declare const notionDataSourceSchema: v.ObjectSchema<{
             readonly name: v.StringSchema<undefined>;
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly type: v.LiteralSchema<"verification", undefined>;
-        }, undefined>, v.ObjectSchema<{
-            readonly name: v.StringSchema<undefined>;
-            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly type: v.LiteralSchema<"last_visited_time", undefined>;
         }, undefined>, v.ObjectSchema<{
             readonly name: v.StringSchema<undefined>;
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -274,10 +270,6 @@ export declare const notionDataSourceSchema: v.ObjectSchema<{
         readonly name: v.StringSchema<undefined>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.LiteralSchema<"verification", undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly name: v.StringSchema<undefined>;
-        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        readonly type: v.LiteralSchema<"last_visited_time", undefined>;
     }, undefined>, v.ObjectSchema<{
         readonly name: v.StringSchema<undefined>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/protocol/dataSources/properties/propertySchema.d.ts

@@ -30,12 +30,12 @@ export type NotionDualProperty = v.InferOutput<typeof notionDualPropertySchema>;
  * Mirrors the Notion public API
  * [property object](https://developers.notion.com/reference/property-object)
  * type field. Internal-only types (`button`, `verification`,
- * `last_visited_time`, `location`) and the four built-ins (`created_time`,
+ * `location`) and the four built-ins (`created_time`,
  * `last_edited_time`, `created_by`, `last_edited_by`) are included under their
  * bridge-native names.
  */
-export declare const NOTION_PROPERTY_TYPES: readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"];
-export declare const notionPropertyTypeSchema: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
+export declare const NOTION_PROPERTY_TYPES: readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"];
+export declare const notionPropertyTypeSchema: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
 /**
  * String literal union of every supported Notion property type. Same set as
  * the discriminator in `NotionPropertySchema` — split out so the manifest
@@ -163,10 +163,6 @@ export declare const notionPropertySchemaSchema: v.VariantSchema<"type", [v.Obje
     readonly name: v.StringSchema<undefined>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly type: v.LiteralSchema<"verification", undefined>;
-}, undefined>, v.ObjectSchema<{
-    readonly name: v.StringSchema<undefined>;
-    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly type: v.LiteralSchema<"last_visited_time", undefined>;
 }, undefined>, v.ObjectSchema<{
     readonly name: v.StringSchema<undefined>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/protocol/dataSources/properties/propertySchema.js

@@ -51,7 +51,7 @@ const baseProp = v.object({
  * Mirrors the Notion public API
  * [property object](https://developers.notion.com/reference/property-object)
  * type field. Internal-only types (`button`, `verification`,
- * `last_visited_time`, `location`) and the four built-ins (`created_time`,
+ * `location`) and the four built-ins (`created_time`,
  * `last_edited_time`, `created_by`, `last_edited_by`) are included under their
  * bridge-native names.
  */
@@ -76,7 +76,6 @@ export const NOTION_PROPERTY_TYPES = [
     "rollup",
     "button",
     "verification",
-    "last_visited_time",
     "location",
     "created_time",
     "last_edited_time",
@@ -147,7 +146,6 @@ export const notionPropertySchemaSchema = v.variant("type", [
     // Internal-only types passed through under their bridge-native names.
     v.object({ ...baseProp.entries, type: v.literal("button") }),
     v.object({ ...baseProp.entries, type: v.literal("verification") }),
-    v.object({ ...baseProp.entries, type: v.literal("last_visited_time") }),
     v.object({ ...baseProp.entries, type: v.literal("location") }),
     // Synthetic built-ins. The host always emits one of each per data source.
     v.object({ ...baseProp.entries, type: v.literal("created_time") }),

package/dist/protocol/handshake/connect.d.ts

@@ -35,12 +35,23 @@ export declare const connectMessageSchema: v.VariantSchema<"status", [v.ObjectSc
             readonly properties: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
                 readonly name: v.StringSchema<undefined>;
                 readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
+                readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
             }, undefined>, undefined>, {}>;
         }, undefined>, undefined>, {}>;
+        readonly pages: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"emoji", undefined>;
+                readonly emoji: v.StringSchema<undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"external", undefined>;
+                readonly url: v.StringSchema<undefined>;
+            }, undefined>], undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly capabilities: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
             readonly capability: v.StringSchema<undefined>;
-            readonly resource: v.StringSchema<undefined>;
+            readonly resource: v.UnionSchema<[v.StringSchema<undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.MinLengthAction<string[], 1, undefined>]>], undefined>;
         }, undefined>, undefined>, undefined>;
     }, undefined>, undefined>;
 }, undefined>, v.ObjectSchema<{

package/dist/protocol/handshake/init.d.ts

@@ -99,12 +99,23 @@ export declare const initMessageSchema: v.VariantSchema<"status", [v.ObjectSchem
             readonly properties: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
                 readonly name: v.StringSchema<undefined>;
                 readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
+                readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
             }, undefined>, undefined>, {}>;
         }, undefined>, undefined>, {}>;
+        readonly pages: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"emoji", undefined>;
+                readonly emoji: v.StringSchema<undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"external", undefined>;
+                readonly url: v.StringSchema<undefined>;
+            }, undefined>], undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly capabilities: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
             readonly capability: v.StringSchema<undefined>;
-            readonly resource: v.StringSchema<undefined>;
+            readonly resource: v.UnionSchema<[v.StringSchema<undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.MinLengthAction<string[], 1, undefined>]>], undefined>;
         }, undefined>, undefined>, undefined>;
     }, undefined>;
     readonly dataSources: v.ObjectSchema<{
@@ -225,10 +236,6 @@ export declare const initMessageSchema: v.VariantSchema<"status", [v.ObjectSchem
                     readonly name: v.StringSchema<undefined>;
                     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                     readonly type: v.LiteralSchema<"verification", undefined>;
-                }, undefined>, v.ObjectSchema<{
-                    readonly name: v.StringSchema<undefined>;
-                    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                    readonly type: v.LiteralSchema<"last_visited_time", undefined>;
                 }, undefined>, v.ObjectSchema<{
                     readonly name: v.StringSchema<undefined>;
                     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/protocol/icons.d.ts

@@ -0,0 +1,17 @@
+import * as v from "valibot";
+/** Icon names stay open as hosts add to their catalogs. */
+export declare const notionIconNameSchema: v.StringSchema<undefined>;
+export type NotionIconName = v.InferOutput<typeof notionIconNameSchema>;
+declare const knownNotionIconColorSchema: v.PicklistSchema<["gray", "lightgray", "brown", "yellow", "orange", "green", "blue", "purple", "pink", "red"], undefined>;
+/** Known colors remain discoverable while reads and writes accept future colors. */
+export type NotionIconColor = v.InferOutput<typeof knownNotionIconColorSchema> | (string & {});
+export declare const notionIconColorSchema: v.GenericSchema<NotionIconColor>;
+/** Reads and writes share an open shape; hosts resolve names and default omitted colors. */
+export declare const notionNativeIconSchema: v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"icon", undefined>;
+    readonly icon: v.LooseObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly color: v.OptionalSchema<v.GenericSchema<NotionIconColor>, undefined>;
+    }, undefined>;
+}, undefined>;
+export {};

package/dist/protocol/icons.js

@@ -0,0 +1,27 @@
+import * as v from "valibot";
+/** Icon names stay open as hosts add to their catalogs. */
+export const notionIconNameSchema = v.string();
+const knownNotionIconColorSchema = v.picklist([
+    "gray",
+    "lightgray",
+    "brown",
+    "yellow",
+    "orange",
+    "green",
+    "blue",
+    "purple",
+    "pink",
+    "red",
+]);
+export const notionIconColorSchema = v.union([
+    knownNotionIconColorSchema,
+    v.string(),
+]);
+/** Reads and writes share an open shape; hosts resolve names and default omitted colors. */
+export const notionNativeIconSchema = v.looseObject({
+    type: v.literal("icon"),
+    icon: v.looseObject({
+        name: notionIconNameSchema,
+        color: v.optional(notionIconColorSchema),
+    }),
+});

package/dist/protocol/index.d.ts

@@ -85,10 +85,11 @@ export { CustomBlockInitializationError, customBlockInitErrorCodeSchema, customB
 export type { CustomBlockInitResultErrorCode, CustomBlockInitResultErrorInfo, InitResultMessage, } from "./handshake/initResult.js";
 export { customBlockInitResultErrorCodeSchema, customBlockInitResultErrorInfoSchema, initResultMessageSchema, } from "./handshake/initResult.js";
 export { isInitHandshakeMessage } from "./handshake/isInitHandshakeMessage.js";
-export type { CustomBlockCapabilityDeclaration, CustomBlockCapabilityName, CustomBlockCapabilityResourceName, CustomBlockOriginResourceName, } from "./manifest/capabilities.js";
+export * from "./icons.js";
+export type { CustomBlockCapabilityDeclaration, CustomBlockCapabilityName, CustomBlockCapabilityResourceName, CustomBlockDataSourceResourceName, CustomBlockOriginResourceName, } from "./manifest/capabilities.js";
 export { customBlockCapabilityDeclarationSchema } from "./manifest/capabilities.js";
-export type { BridgeCustomBlockManifest, ManifestDataSource, ManifestIcon, ManifestProperty, } from "./manifest/manifest.js";
-export { manifestDataSourceSchema, manifestIconSchema, manifestPropertySchema, manifestSchema, } from "./manifest/manifest.js";
+export type { BridgeCustomBlockManifest, ManifestDataSource, ManifestIcon, ManifestPage, ManifestProperty, } from "./manifest/manifest.js";
+export { manifestDataSourceSchema, manifestIconSchema, manifestPageSchema, manifestPropertySchema, manifestSchema, } from "./manifest/manifest.js";
 export type { HostToSandboxMessage, HostToSandboxMessageWithProtocol3To5Compatibility, } from "./messages/hostToSandbox.js";
 export { hostToSandboxMessageSchema, hostToSandboxMessageWithProtocol3To5CompatibilitySchema, } from "./messages/hostToSandbox.js";
 export { readIncomingType } from "./messages/incomingType.js";
@@ -114,7 +115,7 @@ export { customBlockOpenPageErrorCodeSchema, customBlockOpenPageErrorInfoSchema,
 export type { CustomBlockUpdatePageErrorCode, CustomBlockUpdatePageErrorInfo, UpdatePageMessage, UpdatePageResultMessage, UpdatePageResultMessageWithProtocol3To5Compatibility, } from "./pages/messages/updatePage.js";
 export { customBlockUpdatePageErrorCodeSchema, customBlockUpdatePageErrorInfoSchema, updatePageMessageSchema, updatePageResultMessageSchema, updatePageResultMessageWithProtocol3To5CompatibilitySchema, } from "./pages/messages/updatePage.js";
 export type { NotionPageCover, NotionPageIcon } from "./pages/pageAppearance.js";
-export { notionCustomEmojiIconSchema, notionEmojiIconSchema, notionExternalFileSchema, notionHostedFileSchema, notionPageCoverSchema, notionPageIconSchema, } from "./pages/pageAppearance.js";
+export { type NotionCreatePageIcon, notionCreatePageIconSchema, notionCustomEmojiIconSchema, notionEmojiIconSchema, notionExternalFileSchema, notionHostedFileSchema, notionPageCoverSchema, notionPageIconSchema, } from "./pages/pageAppearance.js";
 export type { BridgePagePropertyReadMap, BridgePagePropertyWriteMap, } from "./pages/properties/bridgePagePropertyMaps.js";
 export { bridgePagePropertyReadMapSchema, bridgePagePropertyWriteMapSchema, } from "./pages/properties/bridgePagePropertyMaps.js";
 export type { BridgePagePropertyValue } from "./pages/properties/bridgePagePropertyValue.js";
@@ -145,7 +146,7 @@ export { CAPABILITY_NOT_GRANTED_ERROR_CODE, customBlockErrorInfoSchema, } from "
 export type { NotionAgentId, NotionBlockId, NotionDataSourceId, NotionPageId, NotionSpaceId, } from "./utils/ids.js";
 export { notionAgentIdSchema, notionBlockIdSchema, notionDataSourceIdSchema, notionPageIdSchema, notionSpaceIdSchema, } from "./utils/ids.js";
 export { isLocalBlockServerUrl } from "./utils/isLocalBlockServerUrl.js";
-export { LATEST_BRIDGE_PROTOCOL_VERSION, TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION, UNIFIED_PAGE_PROTOCOL_VERSION, } from "./utils/protocolVersion.js";
+export { LATEST_BRIDGE_PROTOCOL_VERSION, NATIVE_ICON_PROTOCOL_VERSION, TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION, UNIFIED_PAGE_PROTOCOL_VERSION, } from "./utils/protocolVersion.js";
 export { readRequestId } from "./utils/readRequestId.js";
 export type { NotionRecordPointer } from "./utils/recordPointer.js";
 export { notionRecordPointerSchema } from "./utils/recordPointer.js";

package/dist/protocol/index.js

@@ -42,8 +42,9 @@ export { connectMessageSchema } from "./handshake/connect.js";
 export { CustomBlockInitializationError, customBlockInitErrorCodeSchema, customBlockInitErrorInfoSchema, initMessageSchema, } from "./handshake/init.js";
 export { customBlockInitResultErrorCodeSchema, customBlockInitResultErrorInfoSchema, initResultMessageSchema, } from "./handshake/initResult.js";
 export { isInitHandshakeMessage } from "./handshake/isInitHandshakeMessage.js";
+export * from "./icons.js";
 export { customBlockCapabilityDeclarationSchema } from "./manifest/capabilities.js";
-export { manifestDataSourceSchema, manifestIconSchema, manifestPropertySchema, manifestSchema, } from "./manifest/manifest.js";
+export { manifestDataSourceSchema, manifestIconSchema, manifestPageSchema, manifestPropertySchema, manifestSchema, } from "./manifest/manifest.js";
 export { hostToSandboxMessageSchema, hostToSandboxMessageWithProtocol3To5CompatibilitySchema, } from "./messages/hostToSandbox.js";
 export { readIncomingType } from "./messages/incomingType.js";
 export { invalidHostMessageSchema } from "./messages/invalidHostMessage.js";
@@ -56,7 +57,7 @@ export { createPageMessageSchema, createPageParentSchema, createPageResultMessag
 export { customBlockGetPageErrorCodeSchema, customBlockGetPageErrorInfoSchema, getPageMessageSchema, getPageResultMessageSchema, getPageResultMessageWithProtocol3To5CompatibilitySchema, } from "./pages/messages/getPage.js";
 export { customBlockOpenPageErrorCodeSchema, customBlockOpenPageErrorInfoSchema, openPageMessageSchema, openPageModeSchema, openPageResultMessageSchema, } from "./pages/messages/openPage.js";
 export { customBlockUpdatePageErrorCodeSchema, customBlockUpdatePageErrorInfoSchema, updatePageMessageSchema, updatePageResultMessageSchema, updatePageResultMessageWithProtocol3To5CompatibilitySchema, } from "./pages/messages/updatePage.js";
-export { notionCustomEmojiIconSchema, notionEmojiIconSchema, notionExternalFileSchema, notionHostedFileSchema, notionPageCoverSchema, notionPageIconSchema, } from "./pages/pageAppearance.js";
+export { notionCreatePageIconSchema, notionCustomEmojiIconSchema, notionEmojiIconSchema, notionExternalFileSchema, notionHostedFileSchema, notionPageCoverSchema, notionPageIconSchema, } from "./pages/pageAppearance.js";
 export { bridgePagePropertyReadMapSchema, bridgePagePropertyWriteMapSchema, } from "./pages/properties/bridgePagePropertyMaps.js";
 export { bridgePagePropertyValueSchema } from "./pages/properties/bridgePagePropertyValue.js";
 export { bridgeUserSchema } from "./users/bridgeUser.js";
@@ -69,6 +70,6 @@ export { notionUserIdSchema } from "./users/userId.js";
 export { CAPABILITY_NOT_GRANTED_ERROR_CODE, customBlockErrorInfoSchema, } from "./utils/errors.js";
 export { notionAgentIdSchema, notionBlockIdSchema, notionDataSourceIdSchema, notionPageIdSchema, notionSpaceIdSchema, } from "./utils/ids.js";
 export { isLocalBlockServerUrl } from "./utils/isLocalBlockServerUrl.js";
-export { LATEST_BRIDGE_PROTOCOL_VERSION, TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION, UNIFIED_PAGE_PROTOCOL_VERSION, } from "./utils/protocolVersion.js";
+export { LATEST_BRIDGE_PROTOCOL_VERSION, NATIVE_ICON_PROTOCOL_VERSION, TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION, UNIFIED_PAGE_PROTOCOL_VERSION, } from "./utils/protocolVersion.js";
 export { readRequestId } from "./utils/readRequestId.js";
 export { notionRecordPointerSchema } from "./utils/recordPointer.js";

package/dist/protocol/manifest/capabilities.d.ts

@@ -4,12 +4,18 @@ import * as v from "valibot";
  * (`capability`) and what it acts on (`resource`). Viewers approve declared
  * entries before the block loads.
  *
- * Both fields accept any string so a newer vocabulary never makes an older host
- * or SDK reject a manifest.
+ * `resource` is one resource or a non-empty array of them. An array declares
+ * the capability on each element. A resource string is never split, so
+ * `"data_source:tasks,projects"` names one key.
+ *
+ * Names are open strings so a newer vocabulary never makes an older host or SDK
+ * reject a manifest. Notion stores each array element as its own entry at
+ * deploy, so the manifest a deployed block receives in `init` has string
+ * resources only.
  */
 export declare const customBlockCapabilityDeclarationSchema: v.ObjectSchema<{
     readonly capability: v.StringSchema<undefined>;
-    readonly resource: v.StringSchema<undefined>;
+    readonly resource: v.UnionSchema<[v.StringSchema<undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.MinLengthAction<string[], 1, undefined>]>], undefined>;
 }, undefined>;
 export type CustomBlockCapabilityDeclaration = v.InferOutput<typeof customBlockCapabilityDeclarationSchema>;
 /**
@@ -23,12 +29,17 @@ export type CustomBlockCapabilityName = "user" | "user.read" | "user.read_email"
 /**
  * Resource names that hosts recognize. User capabilities take `current_user`
  * or `workspace` (every member of the workspace). Page capabilities take
- * `workspace` (every page the viewer can access), `containing_page`, or
- * `data_source`. `private` is reserved for a future
- * `page.insert` into the viewer's Private section and is not accepted yet.
- * `network.fetch` takes a bare HTTPS origin.
+ * `workspace` (every page the viewer can access), `containing_page`,
+ * `data_source:<key>`, or `data_source` (every declared data source).
+ * `private` is reserved for a future `page.insert` into the viewer's Private
+ * section and is not accepted yet. `network.fetch` takes a bare HTTPS origin.
+ */
+export type CustomBlockCapabilityResourceName = "current_user" | "workspace" | "containing_page" | "data_source" | CustomBlockDataSourceResourceName | CustomBlockOriginResourceName;
+/**
+ * The data source bound to one key of the manifest's `dataSources`, such as
+ * `data_source:tasks`. The key must match a declared data source exactly.
  */
-export type CustomBlockCapabilityResourceName = "current_user" | "workspace" | "containing_page" | "data_source" | CustomBlockOriginResourceName;
+export type CustomBlockDataSourceResourceName = `data_source:${string}`;
 /**
  * An HTTPS origin the block loads content from and connects to, such as
  * `https://api.example.com`. `https://*.example.com` covers subdomains. Hosts

package/dist/protocol/manifest/capabilities.js

@@ -4,10 +4,16 @@ import * as v from "valibot";
  * (`capability`) and what it acts on (`resource`). Viewers approve declared
  * entries before the block loads.
  *
- * Both fields accept any string so a newer vocabulary never makes an older host
- * or SDK reject a manifest.
+ * `resource` is one resource or a non-empty array of them. An array declares
+ * the capability on each element. A resource string is never split, so
+ * `"data_source:tasks,projects"` names one key.
+ *
+ * Names are open strings so a newer vocabulary never makes an older host or SDK
+ * reject a manifest. Notion stores each array element as its own entry at
+ * deploy, so the manifest a deployed block receives in `init` has string
+ * resources only.
  */
 export const customBlockCapabilityDeclarationSchema = v.object({
     capability: v.string(),
-    resource: v.string(),
+    resource: v.union([v.string(), v.pipe(v.array(v.string()), v.minLength(1))]),
 });

package/dist/protocol/manifest/manifest.d.ts

@@ -15,9 +15,21 @@ export type ManifestIcon = v.InferOutput<typeof manifestIconSchema>;
 export declare const manifestPropertySchema: v.ObjectSchema<{
     readonly name: v.StringSchema<undefined>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
+    readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
 }, undefined>;
 export type ManifestProperty = v.InferOutput<typeof manifestPropertySchema>;
+export declare const manifestPageSchema: v.ObjectSchema<{
+    readonly name: v.StringSchema<undefined>;
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"emoji", undefined>;
+        readonly emoji: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"external", undefined>;
+        readonly url: v.StringSchema<undefined>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>;
+export type ManifestPage = v.InferOutput<typeof manifestPageSchema>;
 export declare const manifestDataSourceSchema: v.ObjectSchema<{
     readonly name: v.StringSchema<undefined>;
     readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -31,7 +43,7 @@ export declare const manifestDataSourceSchema: v.ObjectSchema<{
     readonly properties: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
         readonly name: v.StringSchema<undefined>;
         readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
+        readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
     }, undefined>, undefined>, {}>;
 }, undefined>;
 export type ManifestDataSource = v.InferOutput<typeof manifestDataSourceSchema>;
@@ -57,9 +69,20 @@ export declare const manifestSchema: v.ObjectSchema<{
         readonly properties: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
             readonly name: v.StringSchema<undefined>;
             readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
+            readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
         }, undefined>, undefined>, {}>;
     }, undefined>, undefined>, {}>;
+    readonly pages: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"emoji", undefined>;
+            readonly emoji: v.StringSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"external", undefined>;
+            readonly url: v.StringSchema<undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
     /**
      * Capabilities the block needs. Omitted means the block predates capability
      * approval, so hosts do not ask the viewer. An empty array declares no
@@ -67,7 +90,7 @@ export declare const manifestSchema: v.ObjectSchema<{
      */
     readonly capabilities: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
         readonly capability: v.StringSchema<undefined>;
-        readonly resource: v.StringSchema<undefined>;
+        readonly resource: v.UnionSchema<[v.StringSchema<undefined>, v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.MinLengthAction<string[], 1, undefined>]>], undefined>;
     }, undefined>, undefined>, undefined>;
 }, undefined>;
 /**

package/dist/protocol/manifest/manifest.js

@@ -21,6 +21,11 @@ export const manifestPropertySchema = v.object({
     description: v.optional(v.string()),
     type: notionPropertyTypeSchema,
 });
+export const manifestPageSchema = v.object({
+    name: v.string(),
+    description: v.optional(v.string()),
+    icon: v.optional(manifestIconSchema),
+});
 export const manifestDataSourceSchema = v.object({
     name: v.string(),
     description: v.optional(v.string()),
@@ -34,6 +39,7 @@ export const manifestSchema = v.object({
     slashCommand: v.optional(v.string()),
     icon: v.optional(v.object({ type: v.literal("emoji"), emoji: v.string() })),
     dataSources: v.optional(v.record(v.string(), manifestDataSourceSchema), {}),
+    pages: v.optional(v.record(v.string(), manifestPageSchema)),
     /**
      * Capabilities the block needs. Omitted means the block predates capability
      * approval, so hosts do not ask the viewer. An empty array declares no