@notionhq/custom-blocks-host 0.1.10 → 0.1.12

package/README.md

@@ -48,7 +48,6 @@ import { createCustomBlockHost } from "@notionhq/custom-blocks-host";
 const host = createCustomBlockHost({
   iframe,
   sandboxOrigin: "https://example.com",
-  minBridgeProtocolVersion: 3,
   initialState: {
     theme,
     contrastMode,
@@ -90,6 +89,10 @@ const host = createCustomBlockHost({
 });
 ```
 
+`minBridgeProtocolVersion` is optional and defaults to the oldest protocol version the host runtime supports.
+Set a higher value to retire older SDKs. Lower values cannot enable versions the runtime no longer supports.
+The host does not enforce a maximum protocol version.
+
 Each host instance initializes once:
 
 - `onManifest` provides the selected manifest as soon as it is available after
@@ -114,6 +117,21 @@ request handler may return its result synchronously or as a promise. Results
 use a `status` discriminator: successful results carry their response payload,
 while errors carry `{ code, message, isRetryable }`.
 
+### Request types
+
+TypeScript infers request types for handlers passed to `createCustomBlockHost()`.
+For separately defined handlers and helpers, import the corresponding request
+and page-property types directly from `@notionhq/custom-blocks-host`.
+
+Request types such as `GetPageMessage` describe validated messages that handlers
+receive. The corresponding `*MessageInput` types accept plain string IDs for
+adapters and test fixtures that construct requests. These types do not validate
+values at runtime. The host runtime validates incoming messages before it calls
+handlers. Your implementation remains responsible for permissions and record
+access.
+
+### Query requests
+
 The `queryDataSource` handler receives raw data source and property IDs. Its
 optional `filter` and `sorts` fields have already been resolved by the SDK.
 The host validates that sorts contain at most 10 unique property IDs, checks

package/dist/createCustomBlockHost.d.ts

@@ -11,7 +11,12 @@ import type { CustomBlockHostHandlers, CustomBlockHostInitializationFailure, Cus
 export type CustomBlockHostOptions = {
     iframe: HTMLIFrameElement;
     sandboxOrigin: string;
-    minBridgeProtocolVersion: number;
+    /**
+     * Minimum sandbox protocol version to accept. Defaults to the host runtime
+     * minimum. Higher values retire older SDKs; lower values cannot enable
+     * protocol versions the runtime no longer supports.
+     */
+    minBridgeProtocolVersion?: number;
     noConnectTimeoutMs?: number;
     noInitResultTimeoutMs?: number;
     initialState: CustomBlockHostInitialState;

package/dist/createCustomBlockHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createCustomBlockHost.d.ts","sourceRoot":"","sources":["../src/createCustomBlockHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,kBAAkB,EACvB,MAAM,8CAA8C,CAAA;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAA;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AAavF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAA;AAatG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAA;AAGhF,OAAO,KAAK,EACX,iCAAiC,EACjC,2BAA2B,EAC3B,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EACX,uBAAuB,EACvB,oCAAoC,EACpC,2BAA2B,EAC3B,MAAM,qBAAqB,CAAA;AAS5B,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,iBAAiB,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,wBAAwB,EAAE,MAAM,CAAA;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,YAAY,EAAE,2BAA2B,CAAA;IACzC,QAAQ,EAAE,uBAAuB,CAAA;IACjC,oHAAoH;IACpH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACpD,gGAAgG;IAChG,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACvB,QAAQ,EAAE,mBAAmB,CAAA;QAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;KACtB,KAAK,IAAI,CAAA;IACV,6FAA6F;IAC7F,uBAAuB,CAAC,EAAE,CACzB,KAAK,EAAE,oCAAoC,KACvC,IAAI,CAAA;IACT;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,2BAA2B,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC1E,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,IAAI,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAC7C,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,eAAe,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC3D,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;IACxC,cAAc,EAAE,CAAC,WAAW,EAAE,iCAAiC,KAAK,IAAI,CAAA;IACxE,cAAc,EAAE,CAAC,WAAW,EAAE,UAAU,KAAK,IAAI,CAAA;IACjD,YAAY,EAAE,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,kBAAkB,CAAA;KAAE,KAAK,IAAI,CAAA;CAClE,CAAA;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,sBAAsB,GAC7B,qBAAqB,CAsYvB"}
+{"version":3,"file":"createCustomBlockHost.d.ts","sourceRoot":"","sources":["../src/createCustomBlockHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,kBAAkB,EACvB,MAAM,8CAA8C,CAAA;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAA;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AAavF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAA;AAatG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAA;AAGhF,OAAO,KAAK,EACX,iCAAiC,EACjC,2BAA2B,EAC3B,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EACX,uBAAuB,EACvB,oCAAoC,EACpC,2BAA2B,EAC3B,MAAM,qBAAqB,CAAA;AAU5B,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,iBAAiB,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,YAAY,EAAE,2BAA2B,CAAA;IACzC,QAAQ,EAAE,uBAAuB,CAAA;IACjC,oHAAoH;IACpH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACpD,gGAAgG;IAChG,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACvB,QAAQ,EAAE,mBAAmB,CAAA;QAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;KACtB,KAAK,IAAI,CAAA;IACV,6FAA6F;IAC7F,uBAAuB,CAAC,EAAE,CACzB,KAAK,EAAE,oCAAoC,KACvC,IAAI,CAAA;IACT;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,2BAA2B,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC1E,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,IAAI,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAC7C,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,eAAe,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC3D,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;IACxC,cAAc,EAAE,CAAC,WAAW,EAAE,iCAAiC,KAAK,IAAI,CAAA;IACxE,cAAc,EAAE,CAAC,WAAW,EAAE,UAAU,KAAK,IAAI,CAAA;IACjD,YAAY,EAAE,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,kBAAkB,CAAA;KAAE,KAAK,IAAI,CAAA;CAClE,CAAA;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,sBAAsB,GAC7B,qBAAqB,CAyYvB"}

package/dist/createCustomBlockHost.js

@@ -1,14 +1,17 @@
 import { DEFAULT_CONTRAST_MODE, } from "./protocol/contrast.js";
-import { CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION } from "./protocol/protocolVersion.js";
 import { initErrorForFailureReason } from "./lifecycle/initErrors.js";
 import { createInitializationController } from "./lifecycle/initializationController.js";
 import { createSandboxMessageRouter } from "./messages/sandboxMessageRouter.js";
+import { MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION } from "./protocolVersion.js";
 import { QuerySubscriptions, } from "./queries/querySubscriptions.js";
 import { validateQueryDataSourceFilter } from "./queries/validateQueryDataSourceFilter.js";
 import { validateQueryDataSourceSorts } from "./queries/validateQueryDataSourceSorts.js";
 export function createCustomBlockHost(options) {
     const { iframe, initialState, handlers, onManifest, onInitialized, onInitializationFailure, onRestartRequired, onLog, sandboxOrigin, minBridgeProtocolVersion: configuredMinBridgeProtocolVersion, noConnectTimeoutMs, noInitResultTimeoutMs, } = options;
-    const minBridgeProtocolVersion = Math.max(configuredMinBridgeProtocolVersion ?? CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION, CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION);
+    // Callers can retire older SDKs, but cannot restore support for protocols
+    // the runtime no longer implements. Omission uses the runtime minimum.
+    const minBridgeProtocolVersion = Math.max(configuredMinBridgeProtocolVersion ??
+        MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION, MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION);
     let theme = initialState.theme;
     let contrastMode = initialState.contrastMode ?? DEFAULT_CONTRAST_MODE;
     let parent = initialState.parent;

package/dist/index.d.ts

@@ -1,6 +1,14 @@
+export type { CreatePageMessage } from "./protocol/messages/createPage.js";
+export type { GetPageMessage } from "./protocol/messages/getPage.js";
+export type { GetUserMessage } from "./protocol/messages/getUser.js";
+export type { ListUsersMessage } from "./protocol/messages/listUsers.js";
+export type { QueryDataSourceMessage } from "./protocol/messages/queryDataSource.js";
+export type { ResizeMessage } from "./protocol/messages/resize.js";
+export type { UpdatePageMessage } from "./protocol/messages/updatePage.js";
+export type { NotionPagePropertyValue, NotionPagePropertyWriteMap, NotionRichTextItem, } from "./protocol/pages/page.js";
 export { type AutoBindableProperty, getAutoBoundPropertyIdsByKey, } from "./autoBindProperties.js";
 export { type CustomBlockHostHandle, type CustomBlockHostOptions, createCustomBlockHost, } from "./createCustomBlockHost.js";
 export type { ConnectSuccessMessage, CustomBlockHostDataSourcesPayload, CustomBlockHostInitialDataSources, CustomBlockHostInitialState, } from "./lifecycle/types.js";
-export type { CustomBlockHostCreatePageResult, CustomBlockHostGetPageResult, CustomBlockHostGetUserResult, CustomBlockHostHandlers, CustomBlockHostInitializationFailure, CustomBlockHostListUsersResult, CustomBlockHostLogDirection, CustomBlockHostUpdatePageResult, } from "./messages/types.js";
+export type { CreatePageMessageInput, CustomBlockHostCreatePageResult, CustomBlockHostGetPageResult, CustomBlockHostGetUserResult, CustomBlockHostHandlers, CustomBlockHostInitializationFailure, CustomBlockHostListUsersResult, CustomBlockHostLogDirection, CustomBlockHostUpdatePageResult, GetPageMessageInput, GetUserMessageInput, ListUsersMessageInput, QueryDataSourceMessageInput, ResizeMessageInput, UpdatePageMessageInput, } from "./messages/types.js";
 export type { CustomBlockHostQueryDataSourceResult } from "./queries/types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,oBAAoB,EACzB,4BAA4B,GAC5B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,qBAAqB,GACrB,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACX,qBAAqB,EACrB,iCAAiC,EACjC,iCAAiC,EACjC,2BAA2B,GAC3B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACX,+BAA+B,EAC/B,4BAA4B,EAC5B,4BAA4B,EAC5B,uBAAuB,EACvB,oCAAoC,EACpC,8BAA8B,EAC9B,2BAA2B,EAC3B,+BAA+B,GAC/B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,oCAAoC,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAA;AAChG,YAAY,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAA;AAC1F,YAAY,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAA;AAC1F,YAAY,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAA;AAC9F,YAAY,EAAE,sBAAsB,EAAE,MAAM,8DAA8D,CAAA;AAC1G,YAAY,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAA;AACxF,YAAY,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAA;AAChG,YAAY,EACX,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,GAClB,MAAM,gDAAgD,CAAA;AACvD,OAAO,EACN,KAAK,oBAAoB,EACzB,4BAA4B,GAC5B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,qBAAqB,GACrB,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACX,qBAAqB,EACrB,iCAAiC,EACjC,iCAAiC,EACjC,2BAA2B,GAC3B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACX,sBAAsB,EACtB,+BAA+B,EAC/B,4BAA4B,EAC5B,4BAA4B,EAC5B,uBAAuB,EACvB,oCAAoC,EACpC,8BAA8B,EAC9B,2BAA2B,EAC3B,+BAA+B,EAC/B,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,oCAAoC,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/lifecycle/initErrors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initErrors.d.ts","sourceRoot":"","sources":["../../src/lifecycle/initErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,wBAAwB,EACxB,wBAAwB,EACxB,MAAM,mDAAmD,CAAA;AAK1D;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,wBAAwB,EAChC,IAAI,GAAE;IACL,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,4BAA4B,CAAC,EAAE,MAAM,CAAA;CAChC,GACJ,wBAAwB,CAgJ1B"}
+{"version":3,"file":"initErrors.d.ts","sourceRoot":"","sources":["../../src/lifecycle/initErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,wBAAwB,EACxB,wBAAwB,EACxB,MAAM,mDAAmD,CAAA;AAK1D;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,wBAAwB,EAChC,IAAI,GAAE;IACL,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,4BAA4B,CAAC,EAAE,MAAM,CAAA;CAChC,GACJ,wBAAwB,CA+I1B"}

package/dist/lifecycle/initErrors.js

@@ -59,6 +59,12 @@ export function initErrorForFailureReason(reason, data = {}) {
                 isRetryable: false,
             };
         }
+        case "init_timeout":
+            return {
+                code: reason,
+                message: "Host dependencies did not finish loading before the timeout.",
+                isRetryable: true,
+            };
         case "context_unavailable":
             return {
                 code: reason,
@@ -127,12 +133,6 @@ export function initErrorForFailureReason(reason, data = {}) {
                 // The block must be embedded in an iframe.
                 isRetryable: false,
             };
-        case "init_timeout":
-            return {
-                code: reason,
-                message: "Host did not respond to the `connect` message before the timeout.",
-                isRetryable: true,
-            };
         case "unknown_error":
             return {
                 code: reason,

package/dist/lifecycle/types.d.ts

@@ -17,6 +17,10 @@ export type CustomBlockHostDataSourcesPayload = {
 export type CustomBlockHostInitialDataSources = CustomBlockHostDataSourcesPayload | ((connect: ConnectSuccessMessage) => CustomBlockHostDataSourcesPayload);
 export type CustomBlockHostInitialState = {
     theme: NotionTheme;
+    /**
+     * Defaults to standard for existing host integrations.
+     * TODO(custom-blocks): Make this required when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION increases to 4.
+     */
     contrastMode?: NotionContrastMode;
     blockId: NotionBlockId;
     parent: NotionParent;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4DAA4D,CAAA;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAA;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAA;AAEhF,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAC1C,cAAc,EACd;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GACnB,mBAAmB,GACnB,sBAAsB,GACtB,SAAS,GACT,OAAO,CAAA;AAEV,MAAM,MAAM,iCAAiC,GAAG;IAC/C,QAAQ,EAAE,wBAAwB,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,iCAAiC,GAC1C,iCAAiC,GACjC,CAAC,CAAC,OAAO,EAAE,qBAAqB,KAAK,iCAAiC,CAAC,CAAA;AAE1E,MAAM,MAAM,2BAA2B,GAAG;IACzC,KAAK,EAAE,WAAW,CAAA;IAElB,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAA;IAC9B,WAAW,EAAE,iCAAiC,CAAA;IAC9C,WAAW,EAAE,UAAU,CAAA;CACvB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4DAA4D,CAAA;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAA;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAA;AAEhF,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAC1C,cAAc,EACd;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GACnB,mBAAmB,GACnB,sBAAsB,GACtB,SAAS,GACT,OAAO,CAAA;AAEV,MAAM,MAAM,iCAAiC,GAAG;IAC/C,QAAQ,EAAE,wBAAwB,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,iCAAiC,GAC1C,iCAAiC,GACjC,CAAC,CAAC,OAAO,EAAE,qBAAqB,KAAK,iCAAiC,CAAC,CAAA;AAE1E,MAAM,MAAM,2BAA2B,GAAG;IACzC,KAAK,EAAE,WAAW,CAAA;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAA;IAC9B,WAAW,EAAE,iCAAiC,CAAA;IAC9C,WAAW,EAAE,UAAU,CAAA;CACvB,CAAA"}

package/dist/messages/types.d.ts

@@ -1,15 +1,16 @@
-import type { CreatePageMessage } from "../protocol/messages/createPage.js";
+import type { CreatePageMessage, createPageMessageSchema } from "../protocol/messages/createPage.js";
 import type { CreatePageResultMessage, CustomBlockCreatePageErrorInfo } from "../protocol/messages/createPageResult.js";
-import type { CustomBlockGetPageErrorInfo, GetPageMessage, GetPageResultMessage } from "../protocol/messages/getPage.js";
-import type { CustomBlockGetUserErrorInfo, GetUserMessage, GetUserResultMessage } from "../protocol/messages/getUser.js";
+import type { CustomBlockGetPageErrorInfo, GetPageMessage, GetPageResultMessage, getPageMessageSchema } from "../protocol/messages/getPage.js";
+import type { CustomBlockGetUserErrorInfo, GetUserMessage, GetUserResultMessage, getUserMessageSchema } from "../protocol/messages/getUser.js";
 import type { CustomBlockInitErrorInfo } from "../protocol/messages/init.js";
 import type { CustomBlockInitResultErrorInfo } from "../protocol/messages/initResult.js";
-import type { CustomBlockListUsersErrorInfo, ListUsersMessage, ListUsersResultMessage } from "../protocol/messages/listUsers.js";
+import type { CustomBlockListUsersErrorInfo, ListUsersMessage, ListUsersResultMessage, listUsersMessageSchema } from "../protocol/messages/listUsers.js";
 import type { BridgeMessagePayload } from "../protocol/messages/messagePayload.js";
-import type { QueryDataSourceMessage } from "../protocol/messages/queryDataSource.js";
-import type { ResizeMessage } from "../protocol/messages/resize.js";
-import type { UpdatePageMessage } from "../protocol/messages/updatePage.js";
+import type { QueryDataSourceMessage, queryDataSourceMessageSchema } from "../protocol/messages/queryDataSource.js";
+import type { ResizeMessage, resizeMessageSchema } from "../protocol/messages/resize.js";
+import type { UpdatePageMessage, updatePageMessageSchema } from "../protocol/messages/updatePage.js";
 import type { CustomBlockUpdatePageErrorInfo, UpdatePageResultMessage } from "../protocol/messages/updatePageResult.js";
+import type { InferInput } from "valibot";
 import type { CustomBlockHostQueryDataSourceResult } from "../queries/types.js";
 type MaybePromise<T> = T | Promise<T>;
 export type CustomBlockHostCreatePageResult = BridgeMessagePayload<CreatePageResultMessage, CustomBlockCreatePageErrorInfo>;
@@ -28,5 +29,12 @@ export type CustomBlockHostHandlers = {
 };
 export type CustomBlockHostInitializationFailure = CustomBlockInitErrorInfo | CustomBlockInitResultErrorInfo;
 export type CustomBlockHostLogDirection = "in" | "out" | "warn";
+export type CreatePageMessageInput = InferInput<typeof createPageMessageSchema>;
+export type GetPageMessageInput = InferInput<typeof getPageMessageSchema>;
+export type GetUserMessageInput = InferInput<typeof getUserMessageSchema>;
+export type ListUsersMessageInput = InferInput<typeof listUsersMessageSchema>;
+export type QueryDataSourceMessageInput = InferInput<typeof queryDataSourceMessageSchema>;
+export type ResizeMessageInput = InferInput<typeof resizeMessageSchema>;
+export type UpdatePageMessageInput = InferInput<typeof updatePageMessageSchema>;
 export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/messages/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAA;AAChG,OAAO,KAAK,EACX,uBAAuB,EACvB,8BAA8B,EAC9B,MAAM,+DAA+D,CAAA;AACtE,OAAO,KAAK,EACX,2BAA2B,EAC3B,cAAc,EACd,oBAAoB,EACpB,MAAM,sDAAsD,CAAA;AAC7D,OAAO,KAAK,EACX,2BAA2B,EAC3B,cAAc,EACd,oBAAoB,EACpB,MAAM,sDAAsD,CAAA;AAC7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAA;AACjG,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,yDAAyD,CAAA;AAC7G,OAAO,KAAK,EACX,6BAA6B,EAC7B,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,wDAAwD,CAAA;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAA;AACvG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8DAA8D,CAAA;AAC1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAA;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAA;AAChG,OAAO,KAAK,EACX,8BAA8B,EAC9B,uBAAuB,EACvB,MAAM,+DAA+D,CAAA;AACtE,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,qBAAqB,CAAA;AAE/E,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAErC,MAAM,MAAM,+BAA+B,GAAG,oBAAoB,CACjE,uBAAuB,EACvB,8BAA8B,CAC9B,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAC9D,oBAAoB,EACpB,2BAA2B,CAC3B,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG,oBAAoB,CACjE,uBAAuB,EACvB,8BAA8B,CAC9B,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAC9D,oBAAoB,EACpB,2BAA2B,CAC3B,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG,oBAAoB,CAChE,sBAAsB,EACtB,6BAA6B,CAC7B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACrC,eAAe,EAAE,CAChB,OAAO,EAAE,sBAAsB,KAC3B,YAAY,CAAC,oCAAoC,CAAC,CAAA;IACvD,UAAU,CAAC,EAAE,CACZ,OAAO,EAAE,iBAAiB,KACtB,YAAY,CAAC,+BAA+B,CAAC,CAAA;IAClD,OAAO,CAAC,EAAE,CACT,OAAO,EAAE,cAAc,KACnB,YAAY,CAAC,4BAA4B,CAAC,CAAA;IAC/C,OAAO,CAAC,EAAE,CACT,OAAO,EAAE,cAAc,KACnB,YAAY,CAAC,4BAA4B,CAAC,CAAA;IAC/C,SAAS,CAAC,EAAE,CACX,OAAO,EAAE,gBAAgB,KACrB,YAAY,CAAC,8BAA8B,CAAC,CAAA;IACjD,UAAU,CAAC,EAAE,CACZ,OAAO,EAAE,iBAAiB,KACtB,YAAY,CAAC,+BAA+B,CAAC,CAAA;IAClD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,oCAAoC,GAC7C,wBAAwB,GACxB,8BAA8B,CAAA;AAEjC,MAAM,MAAM,2BAA2B,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/messages/types.ts"],"names":[],"mappings":"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"}

package/dist/protocol/messages/connect.js

@@ -5,9 +5,10 @@ const connectMessageCommonEntries = {
     type: v.literal("connect"),
     initializationId: v.string(),
     /**
-     * Used to ensure that the host and client are using the same version of the bridge protocol. A
-     * single host needs to support multiple custom blocks built with different versions of the bridge
-     * protocol. Increment this number any time a breaking change is made to the bridge protocol.
+     * The bridge protocol version this sandbox uses to communicate with its host.
+     * Hosts control which versions they support and can support multiple versions
+     * at the same time. Support for older versions is eventually removed, so blocks
+     * may need to update their SDK to continue working.
      */
     bridgeProtocolVersion: v.number(),
     /**

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

@@ -2,14 +2,14 @@ import * as v from "valibot";
 import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
 import type { CustomBlockInitResultErrorCode } from "./initResult.js";
 export declare const customBlockInitErrorCodeSchema: v.StringSchema<undefined>;
-export type CustomBlockInitErrorCode = CustomBlockErrorCode<"manifest_unavailable" | "manifest_invalid" | "invalid_connect_payload" | "invalid_protocol_version" | "unsupported_protocol_version" | "context_unavailable" | "current_user_unavailable" | "missing_data_source_binding" | "data_source_unavailable" | "missing_property_binding" | "invalid_property_binding">;
+export type CustomBlockInitErrorCode = CustomBlockErrorCode<"manifest_unavailable" | "manifest_invalid" | "invalid_connect_payload" | "invalid_protocol_version" | "unsupported_protocol_version" | "init_timeout" | "context_unavailable" | "current_user_unavailable" | "missing_data_source_binding" | "data_source_unavailable" | "missing_property_binding" | "invalid_property_binding">;
 export type CustomBlockInitErrorInfo = CustomBlockErrorInfo<CustomBlockInitErrorCode>;
 /**
  * Every initialization failure visible to block code. This combines errors
  * received in `init`, errors the sandbox reports in `initResult`, and failures
  * detected locally while running `initCustomBlock()`.
  */
-export type CustomBlockInitializationErrorCode = CustomBlockInitErrorCode | CustomBlockInitResultErrorCode | CustomBlockErrorCode<"not_in_iframe" | "init_timeout">;
+export type CustomBlockInitializationErrorCode = CustomBlockInitErrorCode | CustomBlockInitResultErrorCode | CustomBlockErrorCode<"not_in_iframe">;
 export type CustomBlockInitializationErrorInfo = CustomBlockErrorInfo<CustomBlockInitializationErrorCode>;
 export declare const customBlockInitErrorInfoSchema: v.ObjectSchema<{
     readonly code: v.StringSchema<undefined>;

package/dist/protocol/messages/initResult.js

@@ -16,7 +16,8 @@ export const initResultMessageSchema = v.variant("status", [
         initializationId: v.string(),
         status: v.literal("success"),
         /** Height of the initial rendered custom-block content, in CSS pixels. */
-        // TODO(custom-blocks): Make this required when bumping bridge protocol version 4.
+        // Older SDKs can omit the height. Current SDKs always send it.
+        // TODO(custom-blocks): Make this required when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION increases to 4.
         initialHeight: v.optional(v.pipe(v.number(), v.finite(), v.minValue(0))),
     }),
     v.object({

package/dist/protocol/protocolVersion.d.ts

@@ -1,6 +1,6 @@
 /**
- * Used to ensure that the host and client are using the same version of the bridge protocol. A
- * single host needs to support multiple custom blocks built with different versions of the bridge
- * protocol. Increment this number any time a breaking change is made to the bridge protocol.
+ * The protocol version that the current SDK sends in `connect`.
+ * 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 CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION = 3;
+export declare const LATEST_BRIDGE_PROTOCOL_VERSION = 3;

package/dist/protocol/protocolVersion.js

@@ -1,6 +1,6 @@
 /**
- * Used to ensure that the host and client are using the same version of the bridge protocol. A
- * single host needs to support multiple custom blocks built with different versions of the bridge
- * protocol. Increment this number any time a breaking change is made to the bridge protocol.
+ * The protocol version that the current SDK sends in `connect`.
+ * 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 CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION = 3;
+export const LATEST_BRIDGE_PROTOCOL_VERSION = 3;

package/dist/protocolVersion.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The oldest bridge protocol version the host runtime supports.
+ * Used as the default and lower bound for minBridgeProtocolVersion.
+ * Increase only when retiring support for older SDKs, independently
+ * of the latest SDK protocol version.
+ */
+export declare const MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION = 3;
+//# sourceMappingURL=protocolVersion.d.ts.map

package/dist/protocolVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolVersion.d.ts","sourceRoot":"","sources":["../src/protocolVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,0CAA0C,IAAI,CAAA"}

package/dist/protocolVersion.js

@@ -0,0 +1,7 @@
+/**
+ * The oldest bridge protocol version the host runtime supports.
+ * Used as the default and lower bound for minBridgeProtocolVersion.
+ * Increase only when retiring support for older SDKs, independently
+ * of the latest SDK protocol version.
+ */
+export const MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION = 3;

package/package.json

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

package/src/createCustomBlockHost.ts

@@ -31,7 +31,6 @@ import type { UpdatePageMessage } from "@notionhq/custom-blocks-protocol/message
 import type { UpdatePageResultMessage } from "@notionhq/custom-blocks-protocol/messages/updatePageResult.js"
 import type { CustomBlockPage } from "@notionhq/custom-blocks-protocol/pages/page.js"
 import type { NotionParent } from "@notionhq/custom-blocks-protocol/parent.js"
-import { CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION } from "@notionhq/custom-blocks-protocol/protocolVersion.js"
 import type { NotionTheme } from "@notionhq/custom-blocks-protocol/theme.js"
 import type { NotionUser } from "@notionhq/custom-blocks-protocol/users/user.js"
 import { initErrorForFailureReason } from "./lifecycle/initErrors.js"
@@ -46,6 +45,7 @@ import type {
 	CustomBlockHostInitializationFailure,
 	CustomBlockHostLogDirection,
 } from "./messages/types.js"
+import { MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION } from "./protocolVersion.js"
 import {
 	QuerySubscriptions,
 	type QuerySubscriptionToken,
@@ -57,7 +57,12 @@ import { validateQueryDataSourceSorts } from "./queries/validateQueryDataSourceS
 export type CustomBlockHostOptions = {
 	iframe: HTMLIFrameElement
 	sandboxOrigin: string
-	minBridgeProtocolVersion: number
+	/**
+	 * Minimum sandbox protocol version to accept. Defaults to the host runtime
+	 * minimum. Higher values retire older SDKs; lower values cannot enable
+	 * protocol versions the runtime no longer supports.
+	 */
+	minBridgeProtocolVersion?: number
 	noConnectTimeoutMs?: number
 	noInitResultTimeoutMs?: number
 	initialState: CustomBlockHostInitialState
@@ -110,9 +115,12 @@ export function createCustomBlockHost(
 		noConnectTimeoutMs,
 		noInitResultTimeoutMs,
 	} = options
+	// Callers can retire older SDKs, but cannot restore support for protocols
+	// the runtime no longer implements. Omission uses the runtime minimum.
 	const minBridgeProtocolVersion = Math.max(
-		configuredMinBridgeProtocolVersion ?? CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION,
-		CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION,
+		configuredMinBridgeProtocolVersion ??
+			MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION,
+		MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION,
 	)
 
 	let theme = initialState.theme

package/src/index.ts

@@ -1,3 +1,15 @@
+export type { CreatePageMessage } from "@notionhq/custom-blocks-protocol/messages/createPage.js"
+export type { GetPageMessage } from "@notionhq/custom-blocks-protocol/messages/getPage.js"
+export type { GetUserMessage } from "@notionhq/custom-blocks-protocol/messages/getUser.js"
+export type { ListUsersMessage } from "@notionhq/custom-blocks-protocol/messages/listUsers.js"
+export type { QueryDataSourceMessage } from "@notionhq/custom-blocks-protocol/messages/queryDataSource.js"
+export type { ResizeMessage } from "@notionhq/custom-blocks-protocol/messages/resize.js"
+export type { UpdatePageMessage } from "@notionhq/custom-blocks-protocol/messages/updatePage.js"
+export type {
+	NotionPagePropertyValue,
+	NotionPagePropertyWriteMap,
+	NotionRichTextItem,
+} from "@notionhq/custom-blocks-protocol/pages/page.js"
 export {
 	type AutoBindableProperty,
 	getAutoBoundPropertyIdsByKey,
@@ -14,6 +26,7 @@ export type {
 	CustomBlockHostInitialState,
 } from "./lifecycle/types.js"
 export type {
+	CreatePageMessageInput,
 	CustomBlockHostCreatePageResult,
 	CustomBlockHostGetPageResult,
 	CustomBlockHostGetUserResult,
@@ -22,5 +35,11 @@ export type {
 	CustomBlockHostListUsersResult,
 	CustomBlockHostLogDirection,
 	CustomBlockHostUpdatePageResult,
+	GetPageMessageInput,
+	GetUserMessageInput,
+	ListUsersMessageInput,
+	QueryDataSourceMessageInput,
+	ResizeMessageInput,
+	UpdatePageMessageInput,
 } from "./messages/types.js"
 export type { CustomBlockHostQueryDataSourceResult } from "./queries/types.js"

package/src/lifecycle/initErrors.ts

@@ -72,6 +72,12 @@ export function initErrorForFailureReason(
 				isRetryable: false,
 			}
 		}
+		case "init_timeout":
+			return {
+				code: reason,
+				message: "Host dependencies did not finish loading before the timeout.",
+				isRetryable: true,
+			}
 		case "context_unavailable":
 			return {
 				code: reason,
@@ -140,13 +146,6 @@ export function initErrorForFailureReason(
 				// The block must be embedded in an iframe.
 				isRetryable: false,
 			}
-		case "init_timeout":
-			return {
-				code: reason,
-				message:
-					"Host did not respond to the `connect` message before the timeout.",
-				isRetryable: true,
-			}
 		case "unknown_error":
 			return {
 				code: reason,

package/src/lifecycle/types.ts

@@ -29,7 +29,10 @@ export type CustomBlockHostInitialDataSources =
 
 export type CustomBlockHostInitialState = {
 	theme: NotionTheme
-	// TODO(custom-blocks): Make this required when bumping bridge protocol version 4.
+	/**
+	 * Defaults to standard for existing host integrations.
+	 * TODO(custom-blocks): Make this required when MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION increases to 4.
+	 */
 	contrastMode?: NotionContrastMode
 	blockId: NotionBlockId
 	parent: NotionParent

package/src/messages/types.ts

@@ -1,4 +1,7 @@
-import type { CreatePageMessage } from "@notionhq/custom-blocks-protocol/messages/createPage.js"
+import type {
+	CreatePageMessage,
+	createPageMessageSchema,
+} from "@notionhq/custom-blocks-protocol/messages/createPage.js"
 import type {
 	CreatePageResultMessage,
 	CustomBlockCreatePageErrorInfo,
@@ -7,11 +10,13 @@ import type {
 	CustomBlockGetPageErrorInfo,
 	GetPageMessage,
 	GetPageResultMessage,
+	getPageMessageSchema,
 } from "@notionhq/custom-blocks-protocol/messages/getPage.js"
 import type {
 	CustomBlockGetUserErrorInfo,
 	GetUserMessage,
 	GetUserResultMessage,
+	getUserMessageSchema,
 } from "@notionhq/custom-blocks-protocol/messages/getUser.js"
 import type { CustomBlockInitErrorInfo } from "@notionhq/custom-blocks-protocol/messages/init.js"
 import type { CustomBlockInitResultErrorInfo } from "@notionhq/custom-blocks-protocol/messages/initResult.js"
@@ -19,15 +24,26 @@ import type {
 	CustomBlockListUsersErrorInfo,
 	ListUsersMessage,
 	ListUsersResultMessage,
+	listUsersMessageSchema,
 } from "@notionhq/custom-blocks-protocol/messages/listUsers.js"
 import type { BridgeMessagePayload } from "@notionhq/custom-blocks-protocol/messages/messagePayload.js"
-import type { QueryDataSourceMessage } from "@notionhq/custom-blocks-protocol/messages/queryDataSource.js"
-import type { ResizeMessage } from "@notionhq/custom-blocks-protocol/messages/resize.js"
-import type { UpdatePageMessage } from "@notionhq/custom-blocks-protocol/messages/updatePage.js"
+import type {
+	QueryDataSourceMessage,
+	queryDataSourceMessageSchema,
+} from "@notionhq/custom-blocks-protocol/messages/queryDataSource.js"
+import type {
+	ResizeMessage,
+	resizeMessageSchema,
+} from "@notionhq/custom-blocks-protocol/messages/resize.js"
+import type {
+	UpdatePageMessage,
+	updatePageMessageSchema,
+} from "@notionhq/custom-blocks-protocol/messages/updatePage.js"
 import type {
 	CustomBlockUpdatePageErrorInfo,
 	UpdatePageResultMessage,
 } from "@notionhq/custom-blocks-protocol/messages/updatePageResult.js"
+import type { InferInput } from "valibot"
 import type { CustomBlockHostQueryDataSourceResult } from "../queries/types.js"
 
 type MaybePromise<T> = T | Promise<T>
@@ -84,3 +100,19 @@ export type CustomBlockHostInitializationFailure =
 	| CustomBlockInitResultErrorInfo
 
 export type CustomBlockHostLogDirection = "in" | "out" | "warn"
+
+export type CreatePageMessageInput = InferInput<typeof createPageMessageSchema>
+
+export type GetPageMessageInput = InferInput<typeof getPageMessageSchema>
+
+export type GetUserMessageInput = InferInput<typeof getUserMessageSchema>
+
+export type ListUsersMessageInput = InferInput<typeof listUsersMessageSchema>
+
+export type QueryDataSourceMessageInput = InferInput<
+	typeof queryDataSourceMessageSchema
+>
+
+export type ResizeMessageInput = InferInput<typeof resizeMessageSchema>
+
+export type UpdatePageMessageInput = InferInput<typeof updatePageMessageSchema>

package/src/protocolVersion.ts

@@ -0,0 +1,7 @@
+/**
+ * The oldest bridge protocol version the host runtime supports.
+ * Used as the default and lower bound for minBridgeProtocolVersion.
+ * Increase only when retiring support for older SDKs, independently
+ * of the latest SDK protocol version.
+ */
+export const MIN_HOST_SUPPORTED_BRIDGE_PROTOCOL_VERSION = 3