@notionhq/custom-blocks 0.1.45 → 0.1.47

package/README.md

@@ -113,10 +113,9 @@ Hosts that omit a contrast mode use standard contrast.
 
 `NotionTokenScopeProps` has one required `children` prop.
 
-The CSS variables apply within the scope, not globally.
-Place portal containers inside `<NotionTokenScope>`, or wrap the portal content in another `<NotionTokenScope>`.
-Framework-neutral renderers can read the current appearance with `customBlock.getTheme()` and `customBlock.getContrastMode()`.
-See [Block location and appearance](./docs/block-location.md).
+CSS variables apply only within `<NotionTokenScope>`. Place portal containers inside that scope, or wrap the portal content in another `<NotionTokenScope>`.
+
+Outside React, use `customBlock.getTheme()` and `customBlock.getContrastMode()` to read the current appearance, or `customBlock.subscribeToTheme()` and `customBlock.subscribeToContrastMode()` to follow changes. See [Block location and appearance](./docs/block-location.md) for details.
 
 ## Reference
 

package/dist/bridge/SandboxBridge.d.ts

@@ -47,7 +47,7 @@ export declare class SandboxBridge {
     private logMessage;
     getMessageLog(): readonly MessageLogEntry[];
     subscribeToMessageLog(listener: () => void): () => boolean;
-    awaitInit(signal?: AbortSignal): Promise<void>;
+    awaitInit(): Promise<void>;
     sendConnect(manifestResult: ManifestLoadResult): void;
     private postToHost;
     private sendToHost;

package/dist/bridge/SandboxBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxBridge.d.ts","sourceRoot":"","sources":["../../src/bridge/SandboxBridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SandboxBridge.d.ts","sourceRoot":"","sources":["../../src/bridge/SandboxBridge.ts"],"names":[],"mappings":"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"}

package/dist/bridge/SandboxBridge.js

@@ -1,6 +1,6 @@
 import { DEFAULT_CONTRAST_MODE } from "../protocol/contrast.js";
-import { readIncomingType } from "../protocol/incomingType.js";
 import { hostToSandboxMessageSchema, } from "../protocol/messages/hostToSandbox.js";
+import { readIncomingType } from "../protocol/messages/incomingType.js";
 import { CustomBlockInitializationError, initMessageSchema, } from "../protocol/messages/init.js";
 import { CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION } from "../protocol/protocolVersion.js";
 import * as v from "valibot";
@@ -80,25 +80,8 @@ export class SandboxBridge {
         this.messageLogListeners.add(listener);
         return () => this.messageLogListeners.delete(listener);
     }
-    awaitInit(signal) {
-        if (!signal) {
-            return this.initMessage;
-        }
-        return new Promise((resolve, reject) => {
-            if (signal.aborted) {
-                reject(signal.reason);
-                return;
-            }
-            const onAbort = () => reject(signal.reason);
-            signal.addEventListener("abort", onAbort, { once: true });
-            this.initMessage.then(() => {
-                signal.removeEventListener("abort", onAbort);
-                resolve();
-            }, err => {
-                signal.removeEventListener("abort", onAbort);
-                reject(err);
-            });
-        });
+    awaitInit() {
+        return this.initMessage;
     }
     sendConnect(manifestResult) {
         if (typeof window === "undefined") {

package/dist/bridge/sandboxClient.d.ts

@@ -7,7 +7,7 @@ import { type MessageLogEntry, type QueryDataSourceArgs } from "./SandboxBridge.
 export declare const customBlockHost: {
     start: () => void;
     sendConnect: (manifestResult: ManifestLoadResult) => void;
-    awaitInit: (signal?: AbortSignal) => Promise<void>;
+    awaitInit: () => Promise<void>;
     subscribe: (listener: () => void) => () => boolean;
     getState: () => CustomBlockHostState;
     /**

package/dist/bridge/sandboxClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxClient.d.ts","sourceRoot":"","sources":["../../src/bridge/sandboxClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mDAAmD,CAAA;AACpF,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAExB,MAAM,oBAAoB,CAAA;AAY3B,eAAO,MAAM,eAAe;IAC3B,KAAK;IAIL,WAAW,mBAAmB,kBAAkB;IAIhD,SAAS,YAAY,WAAW,KAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,SAAS,aAAa,MAAM,IAAI;IAIhC,QAAQ,QAAM,oBAAoB;IAIlC;;;OAGG;IACH,YAAY,YAAY,WAAW;IAInC,sBAAsB;IAItB,UAAU,WAAW,MAAM;CAG3B,CAAA;AAED,eAAO,MAAM,sBAAsB;IAClC,oBAAoB;IAIpB,KAAK,SAAS,mBAAmB;IAIjC,OAAO,mBAAmB,MAAM;IAIhC,OAAO,cACK,oBAAoB,OAC1B,MAAM,kBACK,MAAM,KACpB,mBAAmB;CAQtB,CAAA;AAED,eAAO,MAAM,UAAU;IACtB,WAAW,QAAM,SAAS,eAAe,EAAE;IAI3C,SAAS,aAAa,MAAM,IAAI;CAGhC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;IACH,MAAM,UAAU,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;IACH,GAAG,WAAW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;IAInD;;OAEG;IACH,MAAM,UAAU,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;IACH,OAAO,WAAW,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;IACH,SAAS,WAAW,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI5D;;;OAGG;IACH,MAAM,WAAW,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;CASzD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;IACH,IAAI,WAAW,aAAa,KAAG,OAAO,CAAC,eAAe,CAAC;IAIvD;;OAEG;IACH,GAAG,WAAW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;CAGnD,CAAA"}
+{"version":3,"file":"sandboxClient.d.ts","sourceRoot":"","sources":["../../src/bridge/sandboxClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mDAAmD,CAAA;AACpF,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAExB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAExB,MAAM,oBAAoB,CAAA;AAY3B,eAAO,MAAM,eAAe;IAC3B,KAAK;IAIL,WAAW,mBAAmB,kBAAkB;IAIhD,SAAS,QAAM,OAAO,CAAC,IAAI,CAAC;IAI5B,SAAS,aAAa,MAAM,IAAI;IAIhC,QAAQ,QAAM,oBAAoB;IAIlC;;;OAGG;IACH,YAAY,YAAY,WAAW;IAInC,sBAAsB;IAItB,UAAU,WAAW,MAAM;CAG3B,CAAA;AAED,eAAO,MAAM,sBAAsB;IAClC,oBAAoB;IAIpB,KAAK,SAAS,mBAAmB;IAIjC,OAAO,mBAAmB,MAAM;IAIhC,OAAO,cACK,oBAAoB,OAC1B,MAAM,kBACK,MAAM,KACpB,mBAAmB;CAQtB,CAAA;AAED,eAAO,MAAM,UAAU;IACtB,WAAW,QAAM,SAAS,eAAe,EAAE;IAI3C,SAAS,aAAa,MAAM,IAAI;CAGhC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;IACH,MAAM,UAAU,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;IACH,GAAG,WAAW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;IAInD;;OAEG;IACH,MAAM,UAAU,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;IACH,OAAO,WAAW,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D;;OAEG;IACH,SAAS,WAAW,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI5D;;;OAGG;IACH,MAAM,WAAW,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;CASzD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;IACH,IAAI,WAAW,aAAa,KAAG,OAAO,CAAC,eAAe,CAAC;IAIvD;;OAEG;IACH,GAAG,WAAW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;CAGnD,CAAA"}

package/dist/bridge/sandboxClient.js

@@ -15,8 +15,8 @@ export const customBlockHost = {
     sendConnect: (manifestResult) => {
         getBridge().sendConnect(manifestResult);
     },
-    awaitInit: (signal) => {
-        return getBridge().awaitInit(signal);
+    awaitInit: () => {
+        return getBridge().awaitInit();
     },
     subscribe: (listener) => {
         return getBridge().subscribe(listener);

package/dist/customBlock.d.ts

@@ -8,6 +8,7 @@ import type { NotionTheme } from "./protocol/theme.js";
 import type { NotionUser } from "./protocol/users/user.js";
 import { autoResize } from "./autoResize.js";
 import { subscribeToDataSource } from "./bridge/dataSources/subscribe.js";
+/** @deprecated Use individual context types and getters after `initCustomBlock` resolves. */
 export type CustomBlockState = {
     status: "uninitialized";
     theme: NotionTheme;
@@ -22,20 +23,91 @@ export type CustomBlockState = {
     currentUser: NotionUser;
     dataSources: NotionDataSource[];
 };
+type Unsubscribe = () => void;
 /**
- * Framework-neutral runtime state APIs for a custom block. Call `initCustomBlock`
- * before reading initialized values, and use `subscribe` to react to host pushes.
+ * Read block and app context with getters, or follow changes with subscriptions.
+ * Getters throw if called before `initCustomBlock()` completes. Subscriptions
+ * can be registered before initialization and deliver the initial value once
+ * initialization completes, followed by changes to that value.
+ *
+ * Each subscription returns an unsubscribe function. Call it when the
+ * subscription is no longer needed.
  */
 export declare const customBlock: {
-    subscribe(listener: () => void): () => void;
+    /** @deprecated Use an individual subscription method, such as `subscribeToTheme()` or `subscribeToCurrentUser()`. */
+    subscribe(listener: () => void): Unsubscribe;
+    /** @deprecated Use an individual getter method, such as `getTheme()` or `getCurrentUser()`, after `initCustomBlock()` resolves. */
     getState(): CustomBlockState;
+    /**
+     * Get the current user viewing the block.
+     * Throws if called before SDK initialization completes.
+     */
     getCurrentUser(): NotionUser;
+    /**
+     * Subscribes to the current `currentUser` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToCurrentUser(listener: (value: NotionUser) => void): Unsubscribe;
+    /**
+     * Get the host's current theme.
+     * Throws if called before SDK initialization completes.
+     */
     getTheme(): NotionTheme;
+    /**
+     * Subscribes to the current `theme` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToTheme(listener: (value: NotionTheme) => void): Unsubscribe;
+    /**
+     * Get the host's current contrast mode.
+     * Throws if called before SDK initialization completes.
+     */
     getContrastMode(): NotionContrastMode;
+    /**
+     * Subscribes to the current `contrastMode` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToContrastMode(listener: (value: NotionContrastMode) => void): Unsubscribe;
+    /**
+     * Get the custom block's ID. The ID is stable for the lifetime of the block.
+     * Throws if called before SDK initialization completes.
+     */
     getBlockId(): NotionBlockId;
+    /**
+     * Delivers the block ID once. The ID is stable for the lifetime of the block.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToBlockId(listener: (value: NotionBlockId) => void): Unsubscribe;
+    /**
+     * Get the custom block's parent.
+     * Throws if called before SDK initialization completes.
+     */
     getParent(): NotionParent;
+    /**
+     * Subscribes to the current `parent` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToParent(listener: (value: NotionParent) => void): Unsubscribe;
+    /**
+     * Get the containing page and its parent.
+     * Throws if called before SDK initialization completes.
+     */
     getPage(): CustomBlockPage;
+    /**
+     * Subscribes to the current `page` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToPage(listener: (value: CustomBlockPage) => void): Unsubscribe;
+    /**
+     * Get the block's declared data source manifest.
+     * Throws if called before SDK initialization completes.
+     */
     getManifest(): CustomBlockManifest;
+    /**
+     * Subscribes to the current `manifest` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToManifest(listener: (value: CustomBlockManifest) => void): Unsubscribe;
     autoResize: typeof autoResize;
     /**
      * Registers a listener that receives the current query snapshot and later updates.
@@ -43,4 +115,5 @@ export declare const customBlock: {
      */
     subscribeToDataSource: typeof subscribeToDataSource;
 };
+export {};
 //# sourceMappingURL=customBlock.d.ts.map

package/dist/customBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customBlock.d.ts","sourceRoot":"","sources":["../src/customBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAA;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AACvF,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;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAOzE,MAAM,MAAM,gBAAgB,GACzB;IACA,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;CAC/B,GACD;IACA,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,WAAW,EAAE,UAAU,CAAA;IACvB,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAC9B,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,WAAW;wBACH,MAAM,IAAI,GAAG,MAAM,IAAI;gBAI/B,gBAAgB;sBAIV,UAAU;gBAIhB,WAAW;uBAIJ,kBAAkB;kBAIvB,aAAa;iBAId,YAAY;eAId,eAAe;mBAIX,mBAAmB;;IAMlC;;;OAGG;;CAEH,CAAA"}
+{"version":3,"file":"customBlock.d.ts","sourceRoot":"","sources":["../src/customBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAA;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAA;AACvF,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;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAQzE,6FAA6F;AAC7F,MAAM,MAAM,gBAAgB,GACzB;IACA,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;CAC/B,GACD;IACA,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,WAAW,EAAE,UAAU,CAAA;IACvB,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAC9B,CAAA;AAEJ,KAAK,WAAW,GAAG,MAAM,IAAI,CAAA;AAE7B;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;IACvB,qHAAqH;wBACjG,MAAM,IAAI,GAAG,WAAW;IAI5C,mIAAmI;gBACvH,gBAAgB;IAI5B;;;OAGG;sBACe,UAAU;IAI5B;;;OAGG;qCAC8B,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,WAAW;IAI1E;;;OAGG;gBACS,WAAW;IAIvB;;;OAGG;+BACwB,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,WAAW;IAIrE;;;OAGG;uBACgB,kBAAkB;IAIrC;;;OAGG;sCAEQ,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC3C,WAAW;IAId;;;OAGG;kBACW,aAAa;IAI3B;;;OAGG;iCAC0B,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,WAAW;IAIzE;;;OAGG;iBACU,YAAY;IAIzB;;;OAGG;gCACyB,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,WAAW;IAIvE;;;OAGG;eACQ,eAAe;IAI1B;;;OAGG;8BACuB,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,WAAW;IAIxE;;;OAGG;mBACY,mBAAmB;IAIlC;;;OAGG;kCAEQ,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAC5C,WAAW;;IAMd;;;OAGG;;CAEH,CAAA"}

package/dist/customBlock.js

@@ -1,38 +1,123 @@
 import { autoResize } from "./autoResize.js";
 import { subscribeToDataSource } from "./bridge/dataSources/subscribe.js";
+import { notifyListener } from "./bridge/notifyListener.js";
 import { customBlockHost } from "./bridge/sandboxClient.js";
 /**
- * Framework-neutral runtime state APIs for a custom block. Call `initCustomBlock`
- * before reading initialized values, and use `subscribe` to react to host pushes.
+ * Read block and app context with getters, or follow changes with subscriptions.
+ * Getters throw if called before `initCustomBlock()` completes. Subscriptions
+ * can be registered before initialization and deliver the initial value once
+ * initialization completes, followed by changes to that value.
+ *
+ * Each subscription returns an unsubscribe function. Call it when the
+ * subscription is no longer needed.
  */
 export const customBlock = {
+    /** @deprecated Use an individual subscription method, such as `subscribeToTheme()` or `subscribeToCurrentUser()`. */
     subscribe(listener) {
         return customBlockHost.subscribe(listener);
     },
+    /** @deprecated Use an individual getter method, such as `getTheme()` or `getCurrentUser()`, after `initCustomBlock()` resolves. */
     getState() {
         return toPublicState(customBlockHost.getState());
     },
+    /**
+     * Get the current user viewing the block.
+     * Throws if called before SDK initialization completes.
+     */
     getCurrentUser() {
         return getInitializedHostState("getCurrentUser").currentUser;
     },
+    /**
+     * Subscribes to the current `currentUser` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToCurrentUser(listener) {
+        return subscribeToContext({ key: "currentUser", listener });
+    },
+    /**
+     * Get the host's current theme.
+     * Throws if called before SDK initialization completes.
+     */
     getTheme() {
         return getInitializedHostState("getTheme").theme;
     },
+    /**
+     * Subscribes to the current `theme` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToTheme(listener) {
+        return subscribeToContext({ key: "theme", listener });
+    },
+    /**
+     * Get the host's current contrast mode.
+     * Throws if called before SDK initialization completes.
+     */
     getContrastMode() {
         return getInitializedHostState("getContrastMode").contrastMode;
     },
+    /**
+     * Subscribes to the current `contrastMode` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToContrastMode(listener) {
+        return subscribeToContext({ key: "contrastMode", listener });
+    },
+    /**
+     * Get the custom block's ID. The ID is stable for the lifetime of the block.
+     * Throws if called before SDK initialization completes.
+     */
     getBlockId() {
         return getInitializedHostState("getBlockId").blockId;
     },
+    /**
+     * Delivers the block ID once. The ID is stable for the lifetime of the block.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToBlockId(listener) {
+        return subscribeToContext({ key: "blockId", listener });
+    },
+    /**
+     * Get the custom block's parent.
+     * Throws if called before SDK initialization completes.
+     */
     getParent() {
         return getInitializedHostState("getParent").parent;
     },
+    /**
+     * Subscribes to the current `parent` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToParent(listener) {
+        return subscribeToContext({ key: "parent", listener });
+    },
+    /**
+     * Get the containing page and its parent.
+     * Throws if called before SDK initialization completes.
+     */
     getPage() {
         return getInitializedHostState("getPage").page;
     },
+    /**
+     * Subscribes to the current `page` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToPage(listener) {
+        return subscribeToContext({ key: "page", listener });
+    },
+    /**
+     * Get the block's declared data source manifest.
+     * Throws if called before SDK initialization completes.
+     */
     getManifest() {
         return getInitializedHostState("getManifest").manifest;
     },
+    /**
+     * Subscribes to the current `manifest` and future changes.
+     * Waits for initialization before delivering the initial value.
+     */
+    subscribeToManifest(listener) {
+        return subscribeToContext({ key: "manifest", listener });
+    },
     autoResize,
     /**
      * Registers a listener that receives the current query snapshot and later updates.
@@ -74,3 +159,36 @@ function getInitializedHostState(methodName) {
     }
     return hostState;
 }
+/**
+ * Subscribe to one context value. Wait for initialization before delivering
+ * the initial value, then deliver updates when that value changes.
+ * Return a function that stops delivery, including before initialization.
+ */
+function subscribeToContext(args) {
+    const { key, listener } = args;
+    let active = true;
+    let delivered = false;
+    let previous;
+    const deliverIfChanged = () => {
+        const state = customBlockHost.getState();
+        if (!active || state.status !== "initialized") {
+            return;
+        }
+        const next = state[key];
+        // Use referential equality to keep the implementation simple.
+        // Callbacks can receive different objects with the same contents.
+        // We have not benchmarked this choice. Deep equality may also be suitable.
+        if (delivered && Object.is(previous, next)) {
+            return;
+        }
+        previous = next;
+        delivered = true;
+        notifyListener(() => listener(next));
+    };
+    const unsubscribe = customBlockHost.subscribe(deliverIfChanged);
+    deliverIfChanged();
+    return () => {
+        active = false;
+        unsubscribe();
+    };
+}

package/dist/index.d.ts

@@ -31,6 +31,6 @@ export type { NotionParent } from "./protocol/parent.js";
 export type { NotionTheme } from "./protocol/theme.js";
 export { pages, users } from "./bridge/sandboxClient.js";
 export { type CustomBlockState, customBlock } from "./customBlock.js";
-export { type CustomBlockInitPayload, type InitCustomBlockOptions, initCustomBlock, NotInIframeError, } from "./init.js";
+export { type CustomBlockInitPayload, initCustomBlock, NotInIframeError, } from "./init.js";
 export * from "./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;;;;;;;GAOG;AAEH,YAAY,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,YAAY,EACX,sBAAsB,EACtB,gBAAgB,GAChB,MAAM,4DAA4D,CAAA;AACnE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iEAAiE,CAAA;AAC5G,YAAY,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,2DAA2D,CAAA;AAClE,YAAY,EACX,wCAAwC,EACxC,wCAAwC,EACxC,4BAA4B,EAC5B,4BAA4B,GAC5B,MAAM,wDAAwD,CAAA;AAC/D,YAAY,EACX,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,gEAAgE,CAAA;AACvE,OAAO,EACN,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,gEAAgE,CAAA;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAA;AACxG,YAAY,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAA;AACtF,YAAY,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACb,MAAM,yCAAyC,CAAA;AAChD,YAAY,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GAChB,MAAM,8CAA8C,CAAA;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAA;AACvG,YAAY,EACX,8BAA8B,EAC9B,8BAA8B,GAC9B,MAAM,+DAA+D,CAAA;AACtE,YAAY,EACX,2BAA2B,EAC3B,2BAA2B,GAC3B,MAAM,sDAAsD,CAAA;AAC7D,YAAY,EACX,2BAA2B,EAC3B,2BAA2B,GAC3B,MAAM,sDAAsD,CAAA;AAC7D,YAAY,EACX,kCAAkC,EAClC,kCAAkC,GAClC,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAA;AAClG,YAAY,EACX,6BAA6B,EAC7B,6BAA6B,GAC7B,MAAM,wDAAwD,CAAA;AAC/D,YAAY,EACX,mCAAmC,EACnC,mCAAmC,GACnC,MAAM,oEAAoE,CAAA;AAC3E,YAAY,EACX,8BAA8B,EAC9B,8BAA8B,GAC9B,MAAM,+DAA+D,CAAA;AACtE,YAAY,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,0BAA0B,GAC1B,MAAM,gDAAgD,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAC9E,YAAY,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EACN,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,eAAe,EACf,gBAAgB,GAChB,MAAM,WAAW,CAAA;AAClB,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,YAAY,EACX,sBAAsB,EACtB,gBAAgB,GAChB,MAAM,4DAA4D,CAAA;AACnE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iEAAiE,CAAA;AAC5G,YAAY,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,2DAA2D,CAAA;AAClE,YAAY,EACX,wCAAwC,EACxC,wCAAwC,EACxC,4BAA4B,EAC5B,4BAA4B,GAC5B,MAAM,wDAAwD,CAAA;AAC/D,YAAY,EACX,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,gEAAgE,CAAA;AACvE,OAAO,EACN,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,gEAAgE,CAAA;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,+DAA+D,CAAA;AACxG,YAAY,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAA;AACtF,YAAY,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACb,MAAM,yCAAyC,CAAA;AAChD,YAAY,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GAChB,MAAM,8CAA8C,CAAA;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAA;AACvG,YAAY,EACX,8BAA8B,EAC9B,8BAA8B,GAC9B,MAAM,+DAA+D,CAAA;AACtE,YAAY,EACX,2BAA2B,EAC3B,2BAA2B,GAC3B,MAAM,sDAAsD,CAAA;AAC7D,YAAY,EACX,2BAA2B,EAC3B,2BAA2B,GAC3B,MAAM,sDAAsD,CAAA;AAC7D,YAAY,EACX,kCAAkC,EAClC,kCAAkC,GAClC,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAA;AAClG,YAAY,EACX,6BAA6B,EAC7B,6BAA6B,GAC7B,MAAM,wDAAwD,CAAA;AAC/D,YAAY,EACX,mCAAmC,EACnC,mCAAmC,GACnC,MAAM,oEAAoE,CAAA;AAC3E,YAAY,EACX,8BAA8B,EAC9B,8BAA8B,GAC9B,MAAM,+DAA+D,CAAA;AACtE,YAAY,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,0BAA0B,GAC1B,MAAM,gDAAgD,CAAA;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAA;AAC9E,YAAY,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAC5E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EACN,KAAK,sBAAsB,EAC3B,eAAe,EACf,gBAAgB,GAChB,MAAM,WAAW,CAAA;AAClB,cAAc,YAAY,CAAA"}

package/dist/init.d.ts

@@ -28,18 +28,6 @@ export declare class NotInIframeError extends CustomBlockInitializationError {
     constructor(message?: string);
     code: "not_in_iframe";
 }
-/**
- * Options for {@link initCustomBlock}.
- */
-export type InitCustomBlockOptions = {
-    /**
-     * How long to wait for the host's `init` response before rejecting with an error.
-     *
-     * @default 15000 - Intentionally longer than Notion's 10s host-dependency watchdog
-     * so host-owned init errors can arrive before the SDK's generic fallback appears.
-     */
-    timeoutMs?: number;
-};
 /**
  * Initializes the custom block by running the SDK <-> host handshake.
  *
@@ -47,8 +35,8 @@ export type InitCustomBlockOptions = {
  * user, data sources) once the host has initialized the block. Rejects with a
  * `CustomBlockInitializationError` if initialization fails.
  *
- * Idempotent: subsequent calls return the same promise as the first and ignore any new options.
+ * Idempotent: subsequent calls return the same promise as the first.
  * Mount your React tree (or call any SDK hook) only after the returned promise resolves.
  */
-export declare function initCustomBlock(opts?: InitCustomBlockOptions): Promise<CustomBlockInitPayload>;
+export declare function initCustomBlock(): Promise<CustomBlockInitPayload>;
 //# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAA;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAA;AAClG,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;AAKhF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,WAAW,EAAE,UAAU,CAAA;IACvB,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAC/B,CAAA;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,8BAA8B;IACnE,YAAY,OAAO,GAAE,MAA8B,EAOlD;IAEO,IAAI,EAAE,eAAe,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACpC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AASD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC9B,IAAI,GAAE,sBAA2B,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAMjC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAA;AACtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAA;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAA;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAA;AAClG,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;AAKhF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,WAAW,CAAA;IAClB,YAAY,EAAE,kBAAkB,CAAA;IAChC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,WAAW,EAAE,UAAU,CAAA;IACvB,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAC/B,CAAA;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,8BAA8B;IACnE,YAAY,OAAO,GAAE,MAA8B,EAOlD;IAEO,IAAI,EAAE,eAAe,CAAA;CAC7B;AAOD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAMjE"}

package/dist/init.js

@@ -18,7 +18,6 @@ export class NotInIframeError extends CustomBlockInitializationError {
         this.name = "NotInIframeError";
     }
 }
-const DEFAULT_INIT_TIMEOUT_MS = 15_000;
 const NOT_IN_IFRAME_MESSAGE = "<NotionCustomBlock> only works inside an iframe — use the dev shell or deploy to Notion.";
 let initPromise;
 /**
@@ -28,13 +27,13 @@ let initPromise;
  * user, data sources) once the host has initialized the block. Rejects with a
  * `CustomBlockInitializationError` if initialization fails.
  *
- * Idempotent: subsequent calls return the same promise as the first and ignore any new options.
+ * Idempotent: subsequent calls return the same promise as the first.
  * Mount your React tree (or call any SDK hook) only after the returned promise resolves.
  */
-export function initCustomBlock(opts = {}) {
+export function initCustomBlock() {
     if (initPromise === undefined) {
         customBlockHost.start();
-        initPromise = performHandshake(opts);
+        initPromise = performHandshake();
     }
     return initPromise;
 }
@@ -49,19 +48,18 @@ export function initCustomBlock(opts = {}) {
  * Resolves with the `init` payload after the process above. Rejects with a
  * `CustomBlockInitializationError` if any step fails.
  */
-async function performHandshake(opts) {
+async function performHandshake() {
     try {
         // Fail fast with a typed error when rendered as a standalone tab and not in a parent frame.
-        // Otherwise, it would eventually hit the timeout, since `postMessage` to `window.parent`
-        // would just hit the same window and never arrive.
+        // Otherwise, `postMessage` to `window.parent` would just hit the same window and never
+        // arrive.
         if (typeof window !== "undefined" && window.parent === window) {
             throw new NotInIframeError();
         }
         // Load the manifest and send it to the host.
         const manifestResult = await attemptToLoadSelfHostedManifest();
         customBlockHost.sendConnect(manifestResult);
-        const timeoutMs = opts.timeoutMs ?? DEFAULT_INIT_TIMEOUT_MS;
-        await awaitHostInitWithTimeout(timeoutMs);
+        await customBlockHost.awaitInit();
         const hostState = customBlockHost.getState();
         switch (hostState.status) {
             case "initialized":
@@ -96,24 +94,3 @@ async function performHandshake(opts) {
         });
     }
 }
-async function awaitHostInitWithTimeout(timeoutMs) {
-    try {
-        await customBlockHost.awaitInit(AbortSignal.timeout(timeoutMs));
-    }
-    catch (error) {
-        if (isTimeoutError(error)) {
-            throw new CustomBlockInitializationError({
-                code: "init_timeout",
-                message: "Host did not respond to the `connect` message before the timeout.",
-                isRetryable: true,
-            });
-        }
-        throw error;
-    }
-}
-function isTimeoutError(error) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "name" in error &&
-        (error.name === "TimeoutError" || error.name === "AbortError"));
-}

package/dist/protocol/index.d.ts

@@ -15,9 +15,7 @@ export * from "./dataSources/propertySchema.js";
 export * from "./dataSources/recordPointer.js";
 export * from "./errors.js";
 export * from "./ids.js";
-export * from "./incomingType.js";
 export * from "./manifest.js";
-export * from "./messagePayload.js";
 export * from "./messages/connect.js";
 export * from "./messages/contrastModeChanged.js";
 export * from "./messages/createPage.js";
@@ -27,11 +25,14 @@ export * from "./messages/dataSourcesChanged.js";
 export * from "./messages/getPage.js";
 export * from "./messages/getUser.js";
 export * from "./messages/hostToSandbox.js";
+export * from "./messages/incomingType.js";
 export * from "./messages/init.js";
 export * from "./messages/initResult.js";
 export * from "./messages/invalidHostMessage.js";
 export * from "./messages/invalidSandboxMessage.js";
+export * from "./messages/isInitHandshakeMessage.js";
 export * from "./messages/listUsers.js";
+export * from "./messages/messagePayload.js";
 export * from "./messages/pageChanged.js";
 export * from "./messages/parentChanged.js";
 export * from "./messages/queryDataSource.js";

package/dist/protocol/index.js

@@ -15,9 +15,7 @@ export * from "./dataSources/propertySchema.js";
 export * from "./dataSources/recordPointer.js";
 export * from "./errors.js";
 export * from "./ids.js";
-export * from "./incomingType.js";
 export * from "./manifest.js";
-export * from "./messagePayload.js";
 export * from "./messages/connect.js";
 export * from "./messages/contrastModeChanged.js";
 export * from "./messages/createPage.js";
@@ -27,11 +25,14 @@ export * from "./messages/dataSourcesChanged.js";
 export * from "./messages/getPage.js";
 export * from "./messages/getUser.js";
 export * from "./messages/hostToSandbox.js";
+export * from "./messages/incomingType.js";
 export * from "./messages/init.js";
 export * from "./messages/initResult.js";
 export * from "./messages/invalidHostMessage.js";
 export * from "./messages/invalidSandboxMessage.js";
+export * from "./messages/isInitHandshakeMessage.js";
 export * from "./messages/listUsers.js";
+export * from "./messages/messagePayload.js";
 export * from "./messages/pageChanged.js";
 export * from "./messages/parentChanged.js";
 export * from "./messages/queryDataSource.js";

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/isInitHandshakeMessage.d.ts

@@ -0,0 +1,4 @@
+import type { HostToSandboxMessage } from "./hostToSandbox.js";
+import type { SandboxToHostMessage } from "./sandboxToHost.js";
+/** Returns whether a message belongs to the initialization handshake. */
+export declare function isInitHandshakeMessage(message: SandboxToHostMessage | HostToSandboxMessage): boolean;

package/dist/protocol/messages/isInitHandshakeMessage.js

@@ -0,0 +1,11 @@
+/** Returns whether a message belongs to the initialization handshake. */
+export function isInitHandshakeMessage(message) {
+    switch (message.type) {
+        case "connect":
+        case "init":
+        case "initResult":
+            return true;
+        default:
+            return false;
+    }
+}

package/dist/protocol/{messagePayload.d.ts → messages/messagePayload.d.ts}

@@ -1,4 +1,4 @@
-import type { CustomBlockErrorInfo } from "./errors.js";
+import type { CustomBlockErrorInfo } from "../errors.js";
 type WithTypedErrorInfo<T, TErrorInfo extends CustomBlockErrorInfo | undefined> = TErrorInfo extends CustomBlockErrorInfo ? T extends {
     error: CustomBlockErrorInfo;
 } ? Omit<T, "error"> & {