@notionhq/custom-blocks-host 0.5.2 → 0.7.0

package/dist/protocol/pages/messages/createPage.d.ts

@@ -1,7 +1,7 @@
 import * as v from "valibot";
 import type { CustomBlockCapabilityErrorCode, CustomBlockErrorCode, CustomBlockErrorInfo, CustomBlockRequestErrorCode } from "../../utils/errors.js";
 export declare const customBlockCreatePageErrorCodeSchema: v.StringSchema<undefined>;
-export type CustomBlockCreatePageErrorCode = CustomBlockErrorCode<CustomBlockRequestErrorCode | "create_page_failed" | "invalid_page_parent" | "page_unavailable" | "data_source_access_failed" | "unknown_data_source_key" | "unmapped_data_source" | "data_source_inaccessible" | "unmapped_property" | "property_id_mismatch" | "duplicate_property" | "invalid_property_value" | CustomBlockCapabilityErrorCode>;
+export type CustomBlockCreatePageErrorCode = CustomBlockErrorCode<CustomBlockRequestErrorCode | "create_page_failed" | "invalid_icon_name" | "invalid_icon_color" | "invalid_page_parent" | "page_unavailable" | "data_source_access_failed" | "unknown_data_source_key" | "unmapped_data_source" | "data_source_inaccessible" | "unmapped_property" | "property_id_mismatch" | "duplicate_property" | "invalid_property_value" | CustomBlockCapabilityErrorCode>;
 export type CustomBlockCreatePageErrorInfo = CustomBlockErrorInfo<CustomBlockCreatePageErrorCode>;
 export declare const customBlockCreatePageErrorInfoSchema: v.ObjectSchema<{
     readonly code: v.StringSchema<undefined>;
@@ -223,10 +223,6 @@ export declare const createPageResultMessageSchema: v.VariantSchema<"status", [v
                 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>;
@@ -262,10 +258,15 @@ export declare const createPageResultMessageSchema: v.VariantSchema<"status", [v
             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<{
@@ -526,10 +527,6 @@ export declare const createPageResultMessageWithProtocol3To5CompatibilitySchema:
                 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>;
@@ -565,10 +562,15 @@ export declare const createPageResultMessageWithProtocol3To5CompatibilitySchema:
             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<{
@@ -813,10 +815,6 @@ export declare const createPageResultMessageWithProtocol3To5CompatibilitySchema:
                 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>;
@@ -844,7 +842,13 @@ export declare const createPageResultMessageWithProtocol3To5CompatibilitySchema:
         }, 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<{
@@ -1121,10 +1125,6 @@ export declare const createPageMessageSchema: v.VariantSchema<"type", [v.ObjectS
             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>;
@@ -1150,6 +1150,46 @@ export declare const createPageMessageSchema: v.VariantSchema<"type", [v.ObjectS
         readonly type: v.LiteralSchema<"verification", undefined>;
         readonly verification: v.StringSchema<undefined>;
     }, undefined>], undefined>, undefined>;
+    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<{
+        readonly type: v.LiteralSchema<"custom_emoji", undefined>;
+        readonly custom_emoji: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"external", undefined>;
+        readonly external: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+        }, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"file", undefined>;
+        readonly file: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+            readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    }, undefined>], undefined>, undefined>;
+    readonly cover: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"external", undefined>;
+        readonly external: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+        }, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"file", undefined>;
+        readonly file: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+            readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    }, undefined>], undefined>, undefined>;
     readonly parent: v.ObjectSchema<{
         readonly type: v.LiteralSchema<"page_id", undefined>;
         readonly page_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
@@ -1354,10 +1394,6 @@ export declare const createPageMessageSchema: v.VariantSchema<"type", [v.ObjectS
             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>;
@@ -1383,6 +1419,46 @@ export declare const createPageMessageSchema: v.VariantSchema<"type", [v.ObjectS
         readonly type: v.LiteralSchema<"verification", undefined>;
         readonly verification: v.StringSchema<undefined>;
     }, undefined>], undefined>, undefined>;
+    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<{
+        readonly type: v.LiteralSchema<"custom_emoji", undefined>;
+        readonly custom_emoji: v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"external", undefined>;
+        readonly external: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+        }, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"file", undefined>;
+        readonly file: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+            readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    }, undefined>], undefined>, undefined>;
+    readonly cover: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"external", undefined>;
+        readonly external: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+        }, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"file", undefined>;
+        readonly file: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+            readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    }, undefined>], undefined>, undefined>;
     readonly parent: v.ObjectSchema<{
         readonly type: v.LiteralSchema<"data_source_id", undefined>;
         readonly data_source_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionDataSourceId">]>;

package/dist/protocol/pages/messages/createPage.js

@@ -3,6 +3,7 @@ import { bridgePageForProtocol3To5Schema } from "../../compatibility/protocol3To
 import { dataSourceParentSchema, pageParentSchema, } from "../../context/parent.js";
 import { notionBlockIdSchema } from "../../utils/ids.js";
 import { bridgePageSchema } from "../bridgePage.js";
+import { notionCreatePageIconSchema, notionPageCoverSchema, } from "../pageAppearance.js";
 import { bridgePagePropertyWriteMapSchema } from "../properties/bridgePagePropertyMaps.js";
 // The schema accepts any string code. The type lists known codes for
 // autocomplete, with an open string fallback for newer senders.
@@ -74,7 +75,6 @@ export const createPageParentSchema = v.variant("type", [
 ]);
 /**
  * The sandbox sends this message to ask the host to create a page.
- * The payload mirrors Notion's public `POST /v1/pages` API.
  */
 const createPageMessageBaseSchema = {
     type: v.literal("createPage"),
@@ -87,6 +87,8 @@ const createPageMessageBaseSchema = {
      * those keys before it sends this message.
      */
     properties: bridgePagePropertyWriteMapSchema,
+    icon: v.optional(notionCreatePageIconSchema),
+    cover: v.optional(notionPageCoverSchema),
 };
 // Use a variant so this parent-dependent union can be nested in
 // sandboxToHostMessageSchema's type discriminator.

package/dist/protocol/pages/messages/getPage.d.ts

@@ -229,10 +229,6 @@ export declare const getPageResultMessageSchema: v.VariantSchema<"status", [v.Ob
                 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>;
@@ -268,10 +264,15 @@ export declare const getPageResultMessageSchema: v.VariantSchema<"status", [v.Ob
             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<{
@@ -531,10 +532,6 @@ export declare const getPageResultMessageWithProtocol3To5CompatibilitySchema: v.
                 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>;
@@ -570,10 +567,15 @@ export declare const getPageResultMessageWithProtocol3To5CompatibilitySchema: v.
             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<{
@@ -818,10 +820,6 @@ export declare const getPageResultMessageWithProtocol3To5CompatibilitySchema: v.
                 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>;
@@ -849,7 +847,13 @@ export declare const getPageResultMessageWithProtocol3To5CompatibilitySchema: v.
         }, 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/pages/messages/updatePage.d.ts

@@ -1,7 +1,7 @@
 import * as v from "valibot";
 import type { CustomBlockCapabilityErrorCode, CustomBlockErrorCode, CustomBlockErrorInfo, CustomBlockRequestErrorCode } from "../../utils/errors.js";
 export declare const customBlockUpdatePageErrorCodeSchema: v.StringSchema<undefined>;
-export type CustomBlockUpdatePageErrorCode = CustomBlockErrorCode<CustomBlockRequestErrorCode | "update_page_failed" | "previous_write_incomplete" | "invalid_page_update" | "page_unavailable" | "data_source_access_failed" | "unmapped_property" | "property_id_mismatch" | "duplicate_property" | "invalid_property_value" | CustomBlockCapabilityErrorCode>;
+export type CustomBlockUpdatePageErrorCode = CustomBlockErrorCode<CustomBlockRequestErrorCode | "update_page_failed" | "previous_write_incomplete" | "invalid_page_update" | "invalid_icon_name" | "invalid_icon_color" | "page_unavailable" | "data_source_access_failed" | "unmapped_property" | "property_id_mismatch" | "duplicate_property" | "invalid_property_value" | CustomBlockCapabilityErrorCode>;
 export type CustomBlockUpdatePageErrorInfo = CustomBlockErrorInfo<CustomBlockUpdatePageErrorCode>;
 export declare const customBlockUpdatePageErrorInfoSchema: v.ObjectSchema<{
     readonly code: v.StringSchema<undefined>;
@@ -222,10 +222,6 @@ export declare const updatePageResultMessageSchema: v.VariantSchema<"status", [v
                 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>;
@@ -261,10 +257,15 @@ export declare const updatePageResultMessageSchema: v.VariantSchema<"status", [v
             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<{
@@ -524,10 +525,6 @@ export declare const updatePageResultMessageWithProtocol3To5CompatibilitySchema:
                 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>;
@@ -563,10 +560,15 @@ export declare const updatePageResultMessageWithProtocol3To5CompatibilitySchema:
             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<{
@@ -811,10 +813,6 @@ export declare const updatePageResultMessageWithProtocol3To5CompatibilitySchema:
                 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>;
@@ -842,7 +840,13 @@ export declare const updatePageResultMessageWithProtocol3To5CompatibilitySchema:
         }, 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<{
@@ -1094,10 +1098,6 @@ export declare const updatePageMessageSchema: 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>;
@@ -1123,7 +1123,13 @@ export declare const updatePageMessageSchema: v.ObjectSchema<{
         readonly type: v.LiteralSchema<"verification", undefined>;
         readonly verification: v.StringSchema<undefined>;
     }, undefined>], undefined>, 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/pages/pageAppearance.d.ts

@@ -24,7 +24,13 @@ export declare const notionHostedFileSchema: v.ObjectSchema<{
         readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>;
 }, undefined>;
-export declare const notionPageIconSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+export declare const notionPageIconSchema: 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<{
@@ -60,3 +66,32 @@ export declare const notionPageCoverSchema: v.VariantSchema<"type", [v.ObjectSch
     }, undefined>;
 }, undefined>], undefined>;
 export type NotionPageCover = v.InferOutput<typeof notionPageCoverSchema>;
+export declare const notionCreatePageIconSchema: 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<{
+    readonly type: v.LiteralSchema<"custom_emoji", undefined>;
+    readonly custom_emoji: v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"external", undefined>;
+    readonly external: v.ObjectSchema<{
+        readonly url: v.StringSchema<undefined>;
+    }, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"file", undefined>;
+    readonly file: v.ObjectSchema<{
+        readonly url: v.StringSchema<undefined>;
+        readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+export type NotionCreatePageIcon = v.InferOutput<typeof notionCreatePageIconSchema>;

package/dist/protocol/pages/pageAppearance.js

@@ -1,4 +1,5 @@
 import * as v from "valibot";
+import { notionNativeIconSchema } from "../icons.js";
 export const notionEmojiIconSchema = v.object({
     type: v.literal("emoji"),
     emoji: v.string(),
@@ -23,6 +24,7 @@ export const notionHostedFileSchema = v.object({
     }),
 });
 export const notionPageIconSchema = v.variant("type", [
+    notionNativeIconSchema,
     notionEmojiIconSchema,
     notionCustomEmojiIconSchema,
     notionExternalFileSchema,
@@ -32,3 +34,10 @@ export const notionPageCoverSchema = v.variant("type", [
     notionExternalFileSchema,
     notionHostedFileSchema,
 ]);
+export const notionCreatePageIconSchema = v.variant("type", [
+    notionNativeIconSchema,
+    notionEmojiIconSchema,
+    notionCustomEmojiIconSchema,
+    notionExternalFileSchema,
+    notionHostedFileSchema,
+]);

package/dist/protocol/pages/properties/bridgePagePropertyMaps.d.ts

@@ -185,10 +185,6 @@ export declare const bridgePagePropertyWriteMapSchema: v.RecordSchema<v.StringSc
         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>;
@@ -400,10 +396,6 @@ export declare const bridgePagePropertyReadMapSchema: v.RecordSchema<v.StringSch
         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>;

package/dist/protocol/pages/properties/bridgePagePropertyValue.d.ts

@@ -185,10 +185,6 @@ export declare const bridgePagePropertyValueSchema: v.VariantSchema<"type", [v.O
         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>;

package/dist/protocol/pages/properties/bridgePagePropertyValue.js

@@ -106,11 +106,6 @@ export const bridgePagePropertyValueSchema = v.variant("type", [
         type: v.literal("last_edited_by"),
         last_edited_by: metadataActorSchema,
     }),
-    v.object({
-        ...pagePropertyBaseSchema,
-        type: v.literal("last_visited_time"),
-        last_visited_time: nullableStringSchema,
-    }),
     v.object({
         ...pagePropertyBaseSchema,
         type: v.literal("unique_id"),

package/dist/protocol/utils/protocolVersion.d.ts

@@ -3,6 +3,7 @@
  * Increase this value for breaking wire changes. Hosts can continue to accept
  * older versions, so this value does not set the minimum or maximum they accept.
  */
-export declare const LATEST_BRIDGE_PROTOCOL_VERSION = 8;
+export declare const LATEST_BRIDGE_PROTOCOL_VERSION = 10;
 export declare const UNIFIED_PAGE_PROTOCOL_VERSION = 6;
 export declare const TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION = 7;
+export declare const NATIVE_ICON_PROTOCOL_VERSION = 9;

package/dist/protocol/utils/protocolVersion.js

@@ -3,9 +3,11 @@
  * Increase this value for breaking wire changes. Hosts can continue to accept
  * older versions, so this value does not set the minimum or maximum they accept.
  */
-export const LATEST_BRIDGE_PROTOCOL_VERSION = 8;
+export const LATEST_BRIDGE_PROTOCOL_VERSION = 10;
 // Protocol 6 introduces unified pages with name-keyed property objects.
 // Keep this cutoff fixed when the latest protocol version increases.
 export const UNIFIED_PAGE_PROTOCOL_VERSION = 6;
 // Protocol 7 adds typed text fallbacks for previously unsupported page properties.
 export const TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION = 7;
+// Protocol 9 adds native icon responses and writes throughout the page API.
+export const NATIVE_ICON_PROTOCOL_VERSION = 9;

package/docs/bridge/changelog.md

@@ -19,11 +19,31 @@ versions refer to `@notionhq/custom-blocks`.
 | 5 [†](#protocol-5-unavailable-containing-page-context) | `0.2.16`         | September 30, 2026 | Query filters and sorts must address actual database properties. Filter and sort payloads reject extra fields                                              |
 | 6 [‡](#protocol-6-richer-fallback-properties)          | `0.3.0`          | October 26, 2026   | Typed, display-name-keyed query properties and unified page responses replace the older query representation                                               |
 | 7                                                      | `0.3.3`          | October 30, 2026   | Typed text fallback properties for unique ID, button, formula, location, rollup, and verification                                                          |
-| 8                                                      | `0.4.0`          | November 2, 2026   | Local manifests move from `/manifest` to HTML metadata sent in `connect`; `manifestSource` selects the initialization manifest                             |
+| 8                                                      | `0.3.4`          | November 3, 2026   | Local manifests move from `/manifest` to HTML metadata sent in `connect`; `manifestSource` selects the initialization manifest                             |
+| 9                                                      | Unreleased       | —                  | Native page icons; older protocols receive external SVG URLs                                                                                               |
+| 10                                                     | `0.4.0`          | November 10, 2026  | Removes `last_visited_time` from property schemas, page properties, and page metadata                                                                      |
 
 The table lists SDK release boundaries, not complete supported version ranges. Host compatibility
 depends on `connect.bridgeProtocolVersion`, not the SDK package version.
 
+## Protocol 10: remove last visited time
+
+`last_visited_time` is viewer-specific recents data, not a database property type. Protocol 10
+removes it from manifests, binding schemas, page property values, and top-level page metadata. Older
+SDKs can still connect, but updated hosts no longer load or return viewer visit data. Older readers
+default the absent page field to `null`. Blocks that use this field must remove that use and
+rebuild.
+
+## Protocol 9: native page icons
+
+Page operations and query results can return `{ type: "icon", icon: { name, color } }`. Reads and
+writes share a loose shape: names and colors accept strings, color is optional, and additional
+native icon fields are retained. Hosts resolve names and default omitted colors to gray.
+
+Protocols 3–8 receive external SVG URLs in page operation results. Protocols 6–8 receive the same
+fallback in query results; protocols 3–5 keep their flat query format without appearance fields. The
+released-SDK compatibility corpus exercises these conversions.
+
 ## Protocol 8: local manifest declarations
 
 The dev shell removes the `/manifest` route and embeds the local manifest in block HTML. The SDK