@notionhq/custom-blocks-host 0.4.1 → 0.4.2

package/dist/compatibility/pageForProtocol3To5.d.ts

@@ -1,4 +1,4 @@
-import type { NotionPageForProtocol3To5, notionPageDataSchema } from "../protocol/pages/page.js";
+import type { bridgePageSchema, NotionPageForProtocol3To5 } from "../protocol/pages/page.js";
 import type { InferOutput } from "valibot";
 /**
  * Converts current page data to the page-operation format used by protocols 3–5.
@@ -8,7 +8,7 @@ import type { InferOutput } from "valibot";
  *
  * Delete when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION >= 6.
  */
-export declare function toPageForProtocol3To5(page: InferOutput<typeof notionPageDataSchema>): NotionPageForProtocol3To5;
+export declare function toPageForProtocol3To5(page: InferOutput<typeof bridgePageSchema>): NotionPageForProtocol3To5;
 /**
  * Converts a current page to a protocol 3–5 query row, keeping its ID and archive
  * flags while flattening typed property objects into raw-ID-keyed values.
@@ -17,7 +17,7 @@ export declare function toPageForProtocol3To5(page: InferOutput<typeof notionPag
  *
  * Delete when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION >= 6.
  */
-export declare function toQueryPageForProtocol3To5(page: InferOutput<typeof notionPageDataSchema>): {
+export declare function toQueryPageForProtocol3To5(page: InferOutput<typeof bridgePageSchema>): {
     id: string & import("valibot").Brand<"NotionPageId">;
     is_archived: boolean;
     in_trash: boolean;

package/dist/compatibility/pageForProtocol3To5.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pageForProtocol3To5.d.ts","sourceRoot":"","sources":["../../src/compatibility/pageForProtocol3To5.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,yBAAyB,EAEzB,oBAAoB,EACpB,MAAM,gDAAgD,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAI1C;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,WAAW,CAAC,OAAO,oBAAoB,CAAC,GAC5C,yBAAyB,CAe3B;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,WAAW,CAAC,OAAO,oBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB9C"}
+{"version":3,"file":"pageForProtocol3To5.d.ts","sourceRoot":"","sources":["../../src/compatibility/pageForProtocol3To5.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,gBAAgB,EAChB,yBAAyB,EAEzB,MAAM,gDAAgD,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAI1C;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,WAAW,CAAC,OAAO,gBAAgB,CAAC,GACxC,yBAAyB,CAe3B;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,WAAW,CAAC,OAAO,gBAAgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB1C"}

package/dist/compatibility/pageWithNullTextFallbackProperties.d.ts

@@ -1,9 +1,9 @@
-import type { notionPageDataSchema } from "../protocol/pages/page.js";
+import type { bridgePageSchema } from "../protocol/pages/page.js";
 import type { InferOutput } from "valibot";
 /**
  * Shared field conversion for receivers that cannot decode text fallback objects.
  *
  * Delete when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION >= 7.
  */
-export declare function toPageWithNullTextFallbackProperties(page: InferOutput<typeof notionPageDataSchema>): InferOutput<typeof notionPageDataSchema>;
+export declare function toPageWithNullTextFallbackProperties(page: InferOutput<typeof bridgePageSchema>): InferOutput<typeof bridgePageSchema>;
 //# sourceMappingURL=pageWithNullTextFallbackProperties.d.ts.map

package/dist/compatibility/pageWithNullTextFallbackProperties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pageWithNullTextFallbackProperties.d.ts","sourceRoot":"","sources":["../../src/compatibility/pageWithNullTextFallbackProperties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAA;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C;;;;GAIG;AACH,wBAAgB,oCAAoC,CACnD,IAAI,EAAE,WAAW,CAAC,OAAO,oBAAoB,CAAC,GAC5C,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAyC1C"}
+{"version":3,"file":"pageWithNullTextFallbackProperties.d.ts","sourceRoot":"","sources":["../../src/compatibility/pageWithNullTextFallbackProperties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C;;;;GAIG;AACH,wBAAgB,oCAAoC,CACnD,IAAI,EAAE,WAAW,CAAC,OAAO,gBAAgB,CAAC,GACxC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAyCtC"}

package/dist/protocol/messages/createPageResult.js

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import { notionPageDataSchema, notionPageForProtocol3To5Schema, } from "../pages/page.js";
+import { bridgePageSchema, notionPageForProtocol3To5Schema, } from "../pages/page.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();
@@ -17,7 +17,7 @@ export const createPageResultMessageSchema = v.variant("status", [
         requestId: v.string(),
         status: v.literal("success"),
         /** The newly created page. */
-        page: notionPageDataSchema,
+        page: bridgePageSchema,
     }),
     v.object({
         type: v.literal("createPageResult"),
@@ -32,7 +32,7 @@ export const createPageResultMessageWithProtocol3To5CompatibilitySchema = v.vari
         requestId: v.string(),
         status: v.literal("success"),
         /** The newly created page. */
-        page: v.union([notionPageDataSchema, notionPageForProtocol3To5Schema]),
+        page: v.union([bridgePageSchema, notionPageForProtocol3To5Schema]),
     }),
     v.object({
         type: v.literal("createPageResult"),

package/dist/protocol/messages/getPage.js

@@ -1,6 +1,6 @@
 import * as v from "valibot";
 import { notionDataSourceIdSchema, notionPageIdSchema } from "../ids.js";
-import { notionPageDataSchema, notionPageForProtocol3To5Schema, } from "../pages/page.js";
+import { bridgePageSchema, notionPageForProtocol3To5Schema, } from "../pages/page.js";
 // The schema accepts any string code. The type lists known codes for
 // autocomplete, with an open string fallback for newer senders.
 export const customBlockGetPageErrorCodeSchema = v.string();
@@ -23,7 +23,7 @@ export const getPageResultMessageSchema = v.variant("status", [
         type: v.literal("getPageResult"),
         requestId: v.string(),
         status: v.literal("success"),
-        page: notionPageDataSchema,
+        page: bridgePageSchema,
     }),
     v.object({
         type: v.literal("getPageResult"),
@@ -37,7 +37,7 @@ export const getPageResultMessageWithProtocol3To5CompatibilitySchema = v.variant
         type: v.literal("getPageResult"),
         requestId: v.string(),
         status: v.literal("success"),
-        page: v.union([notionPageDataSchema, notionPageForProtocol3To5Schema]),
+        page: v.union([bridgePageSchema, notionPageForProtocol3To5Schema]),
     }),
     v.object({
         type: v.literal("getPageResult"),

package/dist/protocol/messages/queryDataSourceResult.js

@@ -1,6 +1,6 @@
 import * as v from "valibot";
 import { notionDataSourcePageForProtocol3To5Schema } from "../dataSources/dataSourcePage.js";
-import { notionPageDataSchema } from "../pages/page.js";
+import { bridgePageSchema } from "../pages/page.js";
 // The schema accepts any string code. The type lists known codes for
 // autocomplete, with an open string fallback for newer senders.
 export const customBlockQueryDataSourceErrorCodeSchema = v.string();
@@ -17,7 +17,7 @@ export const queryDataSourceResultMessageSchema = v.variant("status", [
         type: v.literal("queryDataSourceResult"),
         subscriptionId: v.string(),
         status: v.literal("success"),
-        items: v.array(notionPageDataSchema),
+        items: v.array(bridgePageSchema),
         hasMore: v.boolean(),
     }),
     v.object({
@@ -32,10 +32,7 @@ export const queryDataSourceResultMessageWithProtocol3To5CompatibilitySchema = v
         type: v.literal("queryDataSourceResult"),
         subscriptionId: v.string(),
         status: v.literal("success"),
-        items: v.array(v.union([
-            notionPageDataSchema,
-            notionDataSourcePageForProtocol3To5Schema,
-        ])),
+        items: v.array(v.union([bridgePageSchema, notionDataSourcePageForProtocol3To5Schema])),
         hasMore: v.boolean(),
     }),
     v.object({

package/dist/protocol/messages/updatePageResult.js

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import { notionPageDataSchema, notionPageForProtocol3To5Schema, } from "../pages/page.js";
+import { bridgePageSchema, notionPageForProtocol3To5Schema, } from "../pages/page.js";
 // The schema accepts any string code. The type lists known codes for
 // autocomplete, with an open string fallback for newer senders.
 export const customBlockUpdatePageErrorCodeSchema = v.string();
@@ -16,7 +16,7 @@ export const updatePageResultMessageSchema = v.variant("status", [
         type: v.literal("updatePageResult"),
         requestId: v.string(),
         status: v.literal("success"),
-        page: notionPageDataSchema,
+        page: bridgePageSchema,
     }),
     v.object({
         type: v.literal("updatePageResult"),
@@ -30,7 +30,7 @@ export const updatePageResultMessageWithProtocol3To5CompatibilitySchema = v.vari
         type: v.literal("updatePageResult"),
         requestId: v.string(),
         status: v.literal("success"),
-        page: v.union([notionPageDataSchema, notionPageForProtocol3To5Schema]),
+        page: v.union([bridgePageSchema, notionPageForProtocol3To5Schema]),
     }),
     v.object({
         type: v.literal("updatePageResult"),

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

@@ -848,7 +848,7 @@ export type NotionPagePropertyWriteMap = v.InferInput<typeof notionPagePropertyW
 /**
  * The `Page` object returned in `createPageResult` messages.
  */
-export declare const notionPageDataSchema: v.ObjectSchema<{
+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<{
@@ -1138,7 +1138,7 @@ export declare const notionPageDataSchema: v.ObjectSchema<{
     /** Whether the page or an ancestor is in Trash. */
     readonly in_trash: v.BooleanSchema<undefined>;
 }, undefined>;
-export type NotionPageData = v.InferInput<typeof notionPageDataSchema>;
+export type BridgePage = v.InferInput<typeof bridgePageSchema>;
 export declare const notionPageForProtocol3To5Schema: v.ObjectSchema<{
     readonly object: v.LiteralSchema<"page", undefined>;
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionPageId">]>;

package/dist/protocol/pages/page.js

@@ -281,7 +281,7 @@ export const notionPagePropertyReadMapSchema = v.record(v.string(), v.nullable(n
 /**
  * The `Page` object returned in `createPageResult` messages.
  */
-export const notionPageDataSchema = v.object({
+export const bridgePageSchema = v.object({
     object: v.literal("page"),
     id: notionPageIdSchema,
     parent: notionParentSchema,

package/docs/bridge/protocol.md

@@ -175,10 +175,10 @@ must carry the same raw property ID in its `id` field.
 
 ## Page responses
 
-Host handlers return unified `NotionPageData` for queries and page operations. Properties use
-display names as keys and typed values that include their raw property IDs. Only actual schema
-properties are returned. Query results contain `items` and `hasMore`. `notionPageDataSchema` defines
-the page fields, including archive state and creation, edit, and visit metadata.
+Host handlers return unified `BridgePage` for queries and page operations. Properties use display
+names as keys and typed values that include their raw property IDs. Only actual schema properties
+are returned. Query results contain `items` and `hasMore`. `bridgePageSchema` defines the page
+fields, including archive state and creation, edit, and visit metadata.
 
 Page reads return string values for `unique_id`, `formula`, `rollup`, `button`, `verification`, and
 `location`, preserving each property's type. These properties are read-only. Values use stored text,

package/docs/handlers.md

@@ -42,7 +42,7 @@ import type {
   CustomBlockHostDataSourcesPayload,
   CustomBlockHostHandlers,
 } from "@notionhq/custom-blocks-host"
-import type { CustomBlockManifest, NotionPageData } from "@notionhq/custom-blocks-host/protocol"
+import type { CustomBlockManifest, BridgePage } from "@notionhq/custom-blocks-host/protocol"
 
 const tasksId = "44444444-4444-4444-8444-444444444444"
 
@@ -109,7 +109,7 @@ const handlers: CustomBlockHostHandlers = {
       }
     }
 
-    const items: NotionPageData[] = [
+    const items: BridgePage[] = [
       {
         object: "page",
         id: "55555555-5555-4555-8555-555555555555",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@notionhq/custom-blocks-host",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Reusable host runtime for Notion custom blocks.",
   "license": "MIT",
   "type": "module",

package/src/compatibility/pageForProtocol3To5.ts

@@ -1,8 +1,8 @@
 import type { NotionDataSourceValue } from "@notionhq/custom-blocks-protocol/dataSources/dataSourceValue.js"
 import type {
+	bridgePageSchema,
 	NotionPageForProtocol3To5,
 	NotionPagePropertyValue,
-	notionPageDataSchema,
 } from "@notionhq/custom-blocks-protocol/pages/page.js"
 import type { InferOutput } from "valibot"
 import { toNotionDateValue } from "../dateValue.js"
@@ -17,7 +17,7 @@ import { unreachable } from "../utils.js"
  * Delete when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION >= 6.
  */
 export function toPageForProtocol3To5(
-	page: InferOutput<typeof notionPageDataSchema>,
+	page: InferOutput<typeof bridgePageSchema>,
 ): NotionPageForProtocol3To5 {
 	return {
 		...page,
@@ -44,7 +44,7 @@ export function toPageForProtocol3To5(
  * Delete when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION >= 6.
  */
 export function toQueryPageForProtocol3To5(
-	page: InferOutput<typeof notionPageDataSchema>,
+	page: InferOutput<typeof bridgePageSchema>,
 ) {
 	const propertiesById: Record<string, NotionDataSourceValue | undefined> = {}
 	for (const property of Object.values(page.properties)) {

package/src/compatibility/pageWithNullTextFallbackProperties.ts

@@ -1,4 +1,4 @@
-import type { notionPageDataSchema } from "@notionhq/custom-blocks-protocol/pages/page.js"
+import type { bridgePageSchema } from "@notionhq/custom-blocks-protocol/pages/page.js"
 import type { InferOutput } from "valibot"
 import { unreachable } from "../utils.js"
 
@@ -8,8 +8,8 @@ import { unreachable } from "../utils.js"
  * Delete when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION >= 7.
  */
 export function toPageWithNullTextFallbackProperties(
-	page: InferOutput<typeof notionPageDataSchema>,
-): InferOutput<typeof notionPageDataSchema> {
+	page: InferOutput<typeof bridgePageSchema>,
+): InferOutput<typeof bridgePageSchema> {
 	return {
 		...page,
 		properties: Object.fromEntries(