@notionhq/custom-blocks-host 0.4.1 → 0.4.3

package/dist/protocol/{messages/createPageResult.d.ts → pages/messages/createPage.d.ts}

@@ -1,7 +1,7 @@
 import * as v from "valibot";
-import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
+import type { CustomBlockCapabilityErrorCode, CustomBlockErrorCode, CustomBlockErrorInfo } from "../../utils/errors.js";
 export declare const customBlockCreatePageErrorCodeSchema: v.StringSchema<undefined>;
-export type CustomBlockCreatePageErrorCode = CustomBlockErrorCode<"create_page_failed" | "invalid_page_parent" | "page_unavailable" | "collection_access_failed" | "unknown_data_source_key" | "unmapped_data_source" | "unmapped_property" | "property_id_mismatch" | "duplicate_property" | "invalid_property_value">;
+export type CustomBlockCreatePageErrorCode = CustomBlockErrorCode<"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 CustomBlockCreatePageErrorInfo = CustomBlockErrorInfo<CustomBlockCreatePageErrorCode>;
 export declare const customBlockCreatePageErrorInfoSchema: v.ObjectSchema<{
     readonly code: v.StringSchema<undefined>;
@@ -895,3 +895,501 @@ export declare const createPageResultMessageWithProtocol3To5CompatibilitySchema:
 }, undefined>], undefined>;
 export type CreatePageResultMessage = v.InferOutput<typeof createPageResultMessageSchema>;
 export type CreatePageResultMessageWithProtocol3To5Compatibility = v.InferOutput<typeof createPageResultMessageWithProtocol3To5CompatibilitySchema>;
+/**
+ * Describes where the newly created page should be inserted.
+ * - `start` / `end` (default): prepend / append to the request's `parent`
+ *   page's children.
+ * - `before` / `after`: insert as a sibling of the anchor block identified by
+ *   `blockId`, using the anchor's own structural parent. The anchor can be
+ *   nested anywhere below the page (inside a toggle, column, callout, etc.).
+ */
+export declare const notionCreatePagePositionSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"start", undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"end", undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"before", undefined>;
+    readonly blockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"after", undefined>;
+    readonly blockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
+}, undefined>], undefined>;
+export type NotionCreatePagePosition = v.InferOutput<typeof notionCreatePagePositionSchema>;
+/**
+ * Parent accepted by the outbound `createPage` bridge message.
+ *
+ * Mirrors Notion's public API `POST /v1/pages` parent shape: `page_id` for a page-parented child,
+ * `data_source_id` for a database row. `data_source_id` identifies the data source.
+ *
+ * The SDK additionally accepts a higher-level `data_source_key` variant that resolves to
+ * `data_source_id` locally, using the `dataSources` mapping.
+ */
+export declare const createPageParentSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"page_id", undefined>;
+    readonly page_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"data_source_id", undefined>;
+    readonly data_source_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionDataSourceId">]>;
+}, undefined>], undefined>;
+export type CreatePageMessageParent = v.InferOutput<typeof createPageParentSchema>;
+export declare const createPageMessageSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"createPage", undefined>;
+    readonly requestId: v.StringSchema<undefined>;
+    readonly properties: v.RecordSchema<v.StringSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"title", undefined>;
+        readonly title: v.ArraySchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"rich_text", undefined>;
+        readonly rich_text: v.ArraySchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"number", undefined>;
+        readonly number: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"url", undefined>;
+        readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"email", undefined>;
+        readonly email: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"phone_number", undefined>;
+        readonly phone_number: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"checkbox", undefined>;
+        readonly checkbox: v.BooleanSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"select", undefined>;
+        readonly select: v.NullableSchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"status", undefined>;
+        readonly status: v.NullableSchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"multi_select", undefined>;
+        readonly multi_select: v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"date", undefined>;
+        readonly date: v.NullableSchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly end: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly time_zone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+                readonly time: v.StringSchema<undefined>;
+                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+            }, undefined>], undefined>, v.ObjectSchema<{
+                readonly unit: v.LiteralSchema<"none", undefined>;
+            }, undefined>], undefined>, undefined>;
+            readonly start: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "T", undefined>]>;
+        }, undefined>, v.ObjectSchema<{
+            readonly start: v.StringSchema<undefined>;
+            readonly end: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+                readonly time: v.StringSchema<undefined>;
+                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+            }, undefined>], undefined>, v.ObjectSchema<{
+                readonly unit: v.LiteralSchema<"none", undefined>;
+            }, undefined>], undefined>, undefined>;
+            readonly time_zone: v.StringSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly start: v.StringSchema<undefined>;
+            readonly end: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly time_zone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+                readonly time: v.StringSchema<undefined>;
+                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly unit: v.LiteralSchema<"none", undefined>;
+            }, undefined>], undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"people", undefined>;
+        readonly people: v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly object: v.OptionalSchema<v.LiteralSchema<"user", undefined>, undefined>;
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly object: v.LiteralSchema<"group", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"relation", undefined>;
+        readonly has_more: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly relation: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"files", undefined>;
+        readonly files: v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"external", undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly external: v.ObjectSchema<{
+                readonly url: v.StringSchema<undefined>;
+            }, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"file", undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly file: v.ObjectSchema<{
+                readonly url: v.StringSchema<undefined>;
+                readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"place", undefined>;
+        readonly place: v.NullableSchema<v.ObjectSchema<{
+            readonly lat: v.NumberSchema<undefined>;
+            readonly lon: v.NumberSchema<undefined>;
+            readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly address: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly aws_place_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly google_place_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"created_time", undefined>;
+        readonly created_time: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"last_edited_time", undefined>;
+        readonly last_edited_time: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"created_by", undefined>;
+        readonly created_by: v.NullableSchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            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_edited_by", undefined>;
+        readonly last_edited_by: v.NullableSchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            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>;
+        readonly unique_id: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"button", undefined>;
+        readonly button: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"formula", undefined>;
+        readonly formula: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"location", undefined>;
+        readonly location: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"rollup", undefined>;
+        readonly rollup: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"verification", undefined>;
+        readonly verification: v.StringSchema<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">]>;
+    }, undefined>;
+    readonly position: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"start", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"end", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"before", undefined>;
+        readonly blockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"after", undefined>;
+        readonly blockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
+    }, undefined>], undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"createPage", undefined>;
+    readonly requestId: v.StringSchema<undefined>;
+    readonly properties: v.RecordSchema<v.StringSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"title", undefined>;
+        readonly title: v.ArraySchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"rich_text", undefined>;
+        readonly rich_text: v.ArraySchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"number", undefined>;
+        readonly number: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"url", undefined>;
+        readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"email", undefined>;
+        readonly email: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"phone_number", undefined>;
+        readonly phone_number: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"checkbox", undefined>;
+        readonly checkbox: v.BooleanSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"select", undefined>;
+        readonly select: v.NullableSchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"status", undefined>;
+        readonly status: v.NullableSchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"multi_select", undefined>;
+        readonly multi_select: v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly color: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"date", undefined>;
+        readonly date: v.NullableSchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly end: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly time_zone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+                readonly time: v.StringSchema<undefined>;
+                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+            }, undefined>], undefined>, v.ObjectSchema<{
+                readonly unit: v.LiteralSchema<"none", undefined>;
+            }, undefined>], undefined>, undefined>;
+            readonly start: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "T", undefined>]>;
+        }, undefined>, v.ObjectSchema<{
+            readonly start: v.StringSchema<undefined>;
+            readonly end: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+                readonly time: v.StringSchema<undefined>;
+                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+            }, undefined>], undefined>, v.ObjectSchema<{
+                readonly unit: v.LiteralSchema<"none", undefined>;
+            }, undefined>], undefined>, undefined>;
+            readonly time_zone: v.StringSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly start: v.StringSchema<undefined>;
+            readonly end: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly time_zone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
+                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
+                readonly value: v.NumberSchema<undefined>;
+                readonly time: v.StringSchema<undefined>;
+                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly unit: v.LiteralSchema<"none", undefined>;
+            }, undefined>], undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"people", undefined>;
+        readonly people: v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly object: v.OptionalSchema<v.LiteralSchema<"user", undefined>, undefined>;
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly object: v.LiteralSchema<"group", undefined>;
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"relation", undefined>;
+        readonly has_more: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly relation: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"files", undefined>;
+        readonly files: v.ArraySchema<v.UnionSchema<[v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"external", undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly external: v.ObjectSchema<{
+                readonly url: v.StringSchema<undefined>;
+            }, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"file", undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly file: v.ObjectSchema<{
+                readonly url: v.StringSchema<undefined>;
+                readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"place", undefined>;
+        readonly place: v.NullableSchema<v.ObjectSchema<{
+            readonly lat: v.NumberSchema<undefined>;
+            readonly lon: v.NumberSchema<undefined>;
+            readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly address: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly aws_place_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly google_place_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"created_time", undefined>;
+        readonly created_time: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"last_edited_time", undefined>;
+        readonly last_edited_time: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"created_by", undefined>;
+        readonly created_by: v.NullableSchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            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_edited_by", undefined>;
+        readonly last_edited_by: v.NullableSchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            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>;
+        readonly unique_id: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"button", undefined>;
+        readonly button: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"formula", undefined>;
+        readonly formula: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"location", undefined>;
+        readonly location: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"rollup", undefined>;
+        readonly rollup: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        readonly type: v.LiteralSchema<"verification", undefined>;
+        readonly verification: v.StringSchema<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">]>;
+    }, undefined>;
+    readonly position: v.OptionalSchema<v.NeverSchema<undefined>, undefined>;
+}, undefined>], undefined>;
+/**
+ * The sandbox sends this message to create a page.
+ */
+export type CreatePageMessage = v.InferOutput<typeof createPageMessageSchema>;

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

@@ -0,0 +1,104 @@
+import * as v from "valibot";
+import { bridgePageForProtocol3To5Schema } from "../../compatibility/protocol3To5/bridgePage.js";
+import { dataSourceParentSchema, pageParentSchema, } from "../../context/parent.js";
+import { notionBlockIdSchema } from "../../utils/ids.js";
+import { bridgePageSchema } from "../bridgePage.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.
+export const customBlockCreatePageErrorCodeSchema = v.string();
+export const customBlockCreatePageErrorInfoSchema = v.object({
+    code: customBlockCreatePageErrorCodeSchema,
+    message: v.string(),
+    isRetryable: v.boolean(),
+});
+/**
+ * Message sent by the host in response to a sandbox `createPage` request.
+ */
+export const createPageResultMessageSchema = v.variant("status", [
+    v.object({
+        type: v.literal("createPageResult"),
+        requestId: v.string(),
+        status: v.literal("success"),
+        /** The newly created page. */
+        page: bridgePageSchema,
+    }),
+    v.object({
+        type: v.literal("createPageResult"),
+        requestId: v.string(),
+        status: v.literal("error"),
+        error: customBlockCreatePageErrorInfoSchema,
+    }),
+]);
+export const createPageResultMessageWithProtocol3To5CompatibilitySchema = v.variant("status", [
+    v.object({
+        type: v.literal("createPageResult"),
+        requestId: v.string(),
+        status: v.literal("success"),
+        /** The newly created page. */
+        page: v.union([bridgePageSchema, bridgePageForProtocol3To5Schema]),
+    }),
+    v.object({
+        type: v.literal("createPageResult"),
+        requestId: v.string(),
+        status: v.literal("error"),
+        error: customBlockCreatePageErrorInfoSchema,
+    }),
+]);
+/**
+ * Describes where the newly created page should be inserted.
+ * - `start` / `end` (default): prepend / append to the request's `parent`
+ *   page's children.
+ * - `before` / `after`: insert as a sibling of the anchor block identified by
+ *   `blockId`, using the anchor's own structural parent. The anchor can be
+ *   nested anywhere below the page (inside a toggle, column, callout, etc.).
+ */
+export const notionCreatePagePositionSchema = v.variant("type", [
+    v.object({ type: v.literal("start") }),
+    v.object({ type: v.literal("end") }),
+    v.object({ type: v.literal("before"), blockId: notionBlockIdSchema }),
+    v.object({ type: v.literal("after"), blockId: notionBlockIdSchema }),
+]);
+/**
+ * Parent accepted by the outbound `createPage` bridge message.
+ *
+ * Mirrors Notion's public API `POST /v1/pages` parent shape: `page_id` for a page-parented child,
+ * `data_source_id` for a database row. `data_source_id` identifies the data source.
+ *
+ * The SDK additionally accepts a higher-level `data_source_key` variant that resolves to
+ * `data_source_id` locally, using the `dataSources` mapping.
+ */
+export const createPageParentSchema = v.variant("type", [
+    pageParentSchema,
+    dataSourceParentSchema,
+]);
+/**
+ * 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"),
+    requestId: v.string(),
+    /**
+     * Property values, keyed by raw property IDs from Notion.
+     *
+     * Each value must carry the same raw property ID in its `id` field.
+     * To create a page with manifest-defined property keys, call `pages.create`. The SDK resolves
+     * those keys before it sends this message.
+     */
+    properties: bridgePagePropertyWriteMapSchema,
+};
+// Use a variant so this parent-dependent union can be nested in
+// sandboxToHostMessageSchema's type discriminator.
+export const createPageMessageSchema = v.variant("type", [
+    v.object({
+        ...createPageMessageBaseSchema,
+        parent: pageParentSchema,
+        position: v.optional(notionCreatePagePositionSchema),
+    }),
+    v.object({
+        ...createPageMessageBaseSchema,
+        parent: dataSourceParentSchema,
+        position: v.optional(v.never()),
+    }),
+]);

package/dist/protocol/{messages → pages/messages}/getPage.d.ts

@@ -1,7 +1,7 @@
 import * as v from "valibot";
-import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
+import type { CustomBlockCapabilityErrorCode, CustomBlockErrorCode, CustomBlockErrorInfo } from "../../utils/errors.js";
 export declare const customBlockGetPageErrorCodeSchema: v.StringSchema<undefined>;
-export type CustomBlockGetPageErrorCode = CustomBlockErrorCode<"get_page_failed" | "page_unavailable">;
+export type CustomBlockGetPageErrorCode = CustomBlockErrorCode<"get_page_failed" | "page_unavailable" | CustomBlockCapabilityErrorCode>;
 export type CustomBlockGetPageErrorInfo = CustomBlockErrorInfo<CustomBlockGetPageErrorCode>;
 export declare const customBlockGetPageErrorInfoSchema: v.ObjectSchema<{
     readonly code: v.StringSchema<undefined>;