@notionhq/custom-blocks-host 0.4.1 → 0.4.3

package/dist/protocol/messages/sandboxToHost.d.ts

@@ -34,6 +34,10 @@ export declare const sandboxToHostMessageSchema: v.VariantSchema<"type", [v.Vari
                 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>;
             }, undefined>, undefined>, {}>;
         }, undefined>, undefined>, {}>;
+        readonly capabilities: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly capability: v.StringSchema<undefined>;
+            readonly resource: v.StringSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
     }, undefined>, undefined>;
 }, undefined>, v.ObjectSchema<{
     readonly type: v.LiteralSchema<"connect", undefined>;
@@ -575,16 +579,9 @@ export declare const sandboxToHostMessageSchema: v.VariantSchema<"type", [v.Vari
 }, undefined>, v.ObjectSchema<{
     readonly type: v.LiteralSchema<"unsubscribeDataSourceQuery", undefined>;
     readonly subscriptionId: v.StringSchema<undefined>;
-}, undefined>, v.ObjectSchema<{
+}, undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"createPage", undefined>;
     readonly requestId: v.StringSchema<undefined>;
-    readonly parent: 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>;
     readonly properties: v.RecordSchema<v.StringSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
         readonly id: v.StringSchema<undefined>;
         readonly type: v.LiteralSchema<"title", undefined>;
@@ -800,6 +797,10 @@ export declare const sandboxToHostMessageSchema: v.VariantSchema<"type", [v.Vari
         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<{
@@ -812,6 +813,229 @@ export declare const sandboxToHostMessageSchema: v.VariantSchema<"type", [v.Vari
         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>, v.ObjectSchema<{
     readonly type: v.LiteralSchema<"getPage", undefined>;
     readonly requestId: v.StringSchema<undefined>;
     readonly pageId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;

package/dist/protocol/messages/sandboxToHost.js

@@ -1,17 +1,17 @@
 import * as v from "valibot";
-import { connectMessageSchema } from "./connect.js";
-import { createPageMessageSchema } from "./createPage.js";
-import { getPageMessageSchema } from "./getPage.js";
-import { getUserMessageSchema } from "./getUser.js";
-import { initResultMessageSchema } from "./initResult.js";
+import { resizeMessageSchema } from "../context/messages/resize.js";
+import { queryDataSourceMessageSchema } from "../dataSources/messages/queryDataSource.js";
+import { unsubscribeDataSourceQueryMessageSchema } from "../dataSources/messages/unsubscribeDataSourceQuery.js";
+import { connectMessageSchema } from "../handshake/connect.js";
+import { initResultMessageSchema } from "../handshake/initResult.js";
+import { openExternalUrlMessageSchema } from "../navigation/openExternalUrl.js";
+import { createPageMessageSchema } from "../pages/messages/createPage.js";
+import { getPageMessageSchema } from "../pages/messages/getPage.js";
+import { openPageMessageSchema } from "../pages/messages/openPage.js";
+import { updatePageMessageSchema } from "../pages/messages/updatePage.js";
+import { getUserMessageSchema } from "../users/messages/getUser.js";
+import { listUsersMessageSchema } from "../users/messages/listUsers.js";
 import { invalidHostMessageSchema } from "./invalidHostMessage.js";
-import { listUsersMessageSchema } from "./listUsers.js";
-import { openExternalUrlMessageSchema } from "./openExternalUrl.js";
-import { openPageMessageSchema } from "./openPage.js";
-import { queryDataSourceMessageSchema } from "./queryDataSource.js";
-import { resizeMessageSchema } from "./resize.js";
-import { unsubscribeDataSourceQueryMessageSchema } from "./unsubscribeDataSourceQuery.js";
-import { updatePageMessageSchema } from "./updatePage.js";
 /**
  * Discriminated union of every message the sandbox is allowed to send the host. Useful for hosts
  * to validate inbound traffic from sandboxes without re-implementing validation logic.

package/dist/protocol/{messages → navigation}/openExternalUrl.d.ts

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
+import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../utils/errors.js";
 export declare const customBlockOpenExternalUrlErrorCodeSchema: v.StringSchema<undefined>;
 export type CustomBlockOpenExternalUrlErrorCode = CustomBlockErrorCode<"user_decline" | "pending_navigation" | "invalid_url">;
 export type CustomBlockOpenExternalUrlErrorInfo = CustomBlockErrorInfo<CustomBlockOpenExternalUrlErrorCode>;

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

@@ -1,63 +1,26 @@
 import * as v from "valibot";
-/**
- * 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` is the internal collection ID.
- *
- * 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>;
-/**
- * The sandbox sends this message to ask the host to create a page.
- * The payload mirrors Notion's public `POST /v1/pages` API.
- */
-export declare const createPageMessageSchema: v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"createPage", undefined>;
-    readonly requestId: v.StringSchema<undefined>;
+export declare const bridgePageSchema: v.ObjectSchema<{
+    readonly object: v.LiteralSchema<"page", undefined>;
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;
     readonly parent: 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>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"workspace", undefined>;
+        readonly workspace: v.LiteralSchema<true, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"block_id", undefined>;
+        readonly block_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"agent_id", undefined>;
+        readonly agent_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionAgentId">]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"unavailable", undefined>;
     }, undefined>], undefined>;
-    /**
-     * 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.
-     */
-    readonly properties: v.RecordSchema<v.StringSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly properties: v.RecordSchema<v.StringSchema<undefined>, v.NullableSchema<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>;
@@ -271,20 +234,59 @@ export declare const createPageMessageSchema: v.ObjectSchema<{
         readonly id: v.StringSchema<undefined>;
         readonly type: v.LiteralSchema<"verification", undefined>;
         readonly verification: v.StringSchema<undefined>;
-    }, undefined>], undefined>, undefined>;
-    readonly position: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"start", undefined>;
+    }, undefined>], undefined>, undefined>, undefined>;
+    readonly created_by: v.OptionalSchema<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>, null>;
+    readonly last_edited_by: v.OptionalSchema<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>, 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 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<"end", undefined>;
+        readonly type: v.LiteralSchema<"external", undefined>;
+        readonly external: v.ObjectSchema<{
+            readonly url: v.StringSchema<undefined>;
+        }, undefined>;
     }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"before", undefined>;
-        readonly blockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
+        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>, null>;
+    readonly cover: v.OptionalSchema<v.NullableSchema<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<"after", undefined>;
-        readonly blockId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionBlockId">]>;
-    }, undefined>], undefined>, undefined>;
+        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>, null>;
+    readonly url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>;
+    readonly public_url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, null>;
+    /** Whether the page or an ancestor is archived. */
+    readonly is_archived: v.BooleanSchema<undefined>;
+    /** Whether the page or an ancestor is in Trash. */
+    readonly in_trash: v.BooleanSchema<undefined>;
 }, undefined>;
-/**
- * The sandbox sends this message to create a page.
- */
-export type CreatePageMessage = v.InferOutput<typeof createPageMessageSchema>;
+export type BridgePage = v.InferOutput<typeof bridgePageSchema>;

package/dist/protocol/pages/bridgePage.js

@@ -0,0 +1,25 @@
+import * as v from "valibot";
+import { notionParentSchema } from "../context/parent.js";
+import { notionPageIdSchema } from "../utils/ids.js";
+import { notionPageCoverSchema, notionPageIconSchema, } from "./pageAppearance.js";
+import { bridgePagePropertyReadMapSchema } from "./properties/bridgePagePropertyMaps.js";
+import { metadataActorSchema } from "./properties/metadataActor.js";
+export const bridgePageSchema = v.object({
+    object: v.literal("page"),
+    id: notionPageIdSchema,
+    parent: notionParentSchema,
+    properties: bridgePagePropertyReadMapSchema,
+    created_by: v.optional(metadataActorSchema, null),
+    last_edited_by: v.optional(metadataActorSchema, null),
+    last_visited_time: v.optional(v.nullable(v.string()), null),
+    created_time: v.optional(v.nullable(v.string()), null),
+    last_edited_time: v.optional(v.nullable(v.string()), null),
+    icon: v.optional(v.nullable(notionPageIconSchema), null),
+    cover: v.optional(v.nullable(notionPageCoverSchema), null),
+    url: v.optional(v.nullable(v.string()), null),
+    public_url: v.optional(v.nullable(v.string()), null),
+    /** Whether the page or an ancestor is archived. */
+    is_archived: v.boolean(),
+    /** Whether the page or an ancestor is in Trash. */
+    in_trash: v.boolean(),
+});

package/dist/protocol/pages/makeBridgePage.d.ts

@@ -0,0 +1,4 @@
+import type { BridgePage } from "./bridgePage.js";
+export type MakeBridgePageArgs = Pick<BridgePage, "id" | "parent"> & Partial<Omit<BridgePage, "object" | "id" | "parent">>;
+/** Builds a complete bridge page without inventing identity or Notion data. */
+export declare function makeBridgePage(args: MakeBridgePageArgs): BridgePage;

package/dist/protocol/pages/makeBridgePage.js

@@ -0,0 +1,12 @@
+import * as v from "valibot";
+import { bridgePageSchema } from "./bridgePage.js";
+/** Builds a complete bridge page without inventing identity or Notion data. */
+export function makeBridgePage(args) {
+    return v.parse(bridgePageSchema, {
+        ...args,
+        object: "page",
+        properties: args.properties ?? {},
+        is_archived: args.is_archived ?? false,
+        in_trash: args.in_trash ?? false,
+    });
+}