@notionhq/custom-blocks 0.0.77 → 0.0.78

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

@@ -1 +1 @@
-{"version":3,"file":"loadManifest.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/loadManifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,KAAK,mBAAmB,EAAkB,MAAM,eAAe,CAAA;AAIxE,MAAM,MAAM,yBAAyB,GAClC,sBAAsB,GACtB,kBAAkB,GAClB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEhB,MAAM,MAAM,qBAAqB,GAChC,oBAAoB,CAAC,yBAAyB,CAAC,CAAA;AAEhD,MAAM,MAAM,kBAAkB,GAC3B;IACA,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACpC,KAAK,CAAC,EAAE,SAAS,CAAA;CAChB,GACD;IACA,QAAQ,EAAE,IAAI,CAAA;IACd,KAAK,EAAE,qBAAqB,CAAA;CAC3B,CAAA;AAEJ;;;;;;GAMG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAkEhE"}
+{"version":3,"file":"loadManifest.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/loadManifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,KAAK,mBAAmB,EAAkB,MAAM,eAAe,CAAA;AAIxE,MAAM,MAAM,2BAA2B,GACpC,sBAAsB,GACtB,kBAAkB,GAClB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEhB,MAAM,MAAM,uBAAuB,GAClC,oBAAoB,CAAC,2BAA2B,CAAC,CAAA;AAElD,MAAM,MAAM,kBAAkB,GAC3B;IACA,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACpC,KAAK,CAAC,EAAE,SAAS,CAAA;CAChB,GACD;IACA,QAAQ,EAAE,IAAI,CAAA;IACd,KAAK,EAAE,uBAAuB,CAAA;CAC7B,CAAA;AAEJ;;;;;;GAMG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAkEhE"}

package/dist/bridge/loadManifest.js

@@ -6,7 +6,7 @@ const MANIFEST_URL = "custom_blocks.json";
  * A missing manifest means the block has no declared data requirements.
  * Other failures return a structured error so the host can reject the manifest.
  * The SDK validates the manifest locally for author feedback; the host still
- * validates the ready message as the iframe trust boundary.
+ * validates the connect message as the iframe trust boundary.
  */
 export async function loadManifest() {
     if (typeof fetch !== "function") {
@@ -28,7 +28,7 @@ export async function loadManifest() {
             manifest: null,
             // Consider this retryable because it may have just been a network issue. Because `init`
             // errors are considered terminal, the host should "retry" by reloading the iframe and
-            // sending another `ready` message.
+            // sending another `connect` message.
             error: { code: "manifest_unavailable", message, isRetryable: true },
         };
     }

package/dist/bridge/manifest.d.ts

@@ -1,9 +1,9 @@
 import * as v from "valibot";
 /**
  * User-authored manifest declaring the data sources the custom block expects.
- * Lives at `custom_blocks.json` in the project root and is forwarded to the host with
- * the bridge `ready` message so the host can pre-bind data sources, surface
- * configuration UI, etc. The `notionCustomBlock` Vite plugin from
+ * Lives at `custom_blocks.json` in the project root. The sandbox may send it in
+ * `connect`, and the host returns the authoritative manifest in `init`. The
+ * `notionCustomBlock` Vite plugin from
  * `@notionhq/custom-blocks/vite` wires the JSON file into the dev server and
  * the build output.
  */

package/dist/bridge/manifest.js

@@ -2,9 +2,9 @@ import * as v from "valibot";
 import { notionPropertyTypeSchema } from "./dataSources/propertySchema.js";
 /**
  * User-authored manifest declaring the data sources the custom block expects.
- * Lives at `custom_blocks.json` in the project root and is forwarded to the host with
- * the bridge `ready` message so the host can pre-bind data sources, surface
- * configuration UI, etc. The `notionCustomBlock` Vite plugin from
+ * Lives at `custom_blocks.json` in the project root. The sandbox may send it in
+ * `connect`, and the host returns the authoritative manifest in `init`. The
+ * `notionCustomBlock` Vite plugin from
  * `@notionhq/custom-blocks/vite` wires the JSON file into the dev server and
  * the build output.
  */

package/dist/bridge/messages/{ready.d.ts → connect.d.ts}

@@ -1,18 +1,19 @@
 import * as v from "valibot";
 /**
- * First message the sandbox sends after mount, kicking off the bridge handshake. The host replies
- * with `init`.
+ * First message the sandbox sends after mount. It identifies the sandbox and starts the bridge
+ * initialization exchange. The host echoes `initializationId` in its `init` response.
  */
-export declare const readyMessageSchema: v.UnionSchema<[v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"ready", undefined>;
+export declare const connectMessageSchema: v.VariantSchema<"status", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"connect", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
     readonly bridgeProtocolVersion: v.NumberSchema<undefined>;
     readonly sdkVersion: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"success", undefined>;
     /**
-     * The data sources and settings the custom block expects, or null when the
-     * block has no manifest and no declared data requirements.
+     * The data sources and settings the custom block expects. Hosts may omit
+     * this when they already have an authoritative manifest.
      */
-    readonly manifest: v.UnionSchema<[v.ObjectSchema<{
+    readonly manifest: v.OptionalSchema<v.ObjectSchema<{
         readonly version: v.LiteralSchema<1, undefined>;
         readonly dataSources: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
             readonly name: v.StringSchema<undefined>;
@@ -30,9 +31,10 @@ export declare const readyMessageSchema: v.UnionSchema<[v.ObjectSchema<{
                 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>;
-    }, undefined>, v.NullSchema<undefined>], undefined>;
+    }, undefined>, undefined>;
 }, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"ready", undefined>;
+    readonly type: v.LiteralSchema<"connect", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
     readonly bridgeProtocolVersion: v.NumberSchema<undefined>;
     readonly sdkVersion: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"error", undefined>;
@@ -42,5 +44,5 @@ export declare const readyMessageSchema: v.UnionSchema<[v.ObjectSchema<{
         readonly isRetryable: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>;
 }, undefined>], undefined>;
-export type ReadyMessage = v.InferOutput<typeof readyMessageSchema>;
-//# sourceMappingURL=ready.d.ts.map
+export type ConnectMessage = v.InferOutput<typeof connectMessageSchema>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/bridge/messages/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/connect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA2B5B;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;IAG/B;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BASH,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/bridge/messages/{ready.js → connect.js}

@@ -1,7 +1,8 @@
 import * as v from "valibot";
 import { manifestSchema } from "../manifest.js";
-const readyMessageCommonEntries = {
-    type: v.literal("ready"),
+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
@@ -9,35 +10,35 @@ const readyMessageCommonEntries = {
      */
     bridgeProtocolVersion: v.number(),
     /**
-     * Semver version of the SDK package that sent this ready message. Should only be used for
+     * Semver version of the SDK package that sent this connect message. Should only be used for
      * analytics purposes. Business logic should compare against `bridgeProtocolVersion` instead.
      */
     sdkVersion: v.string(),
 };
 // TODO(custom-blocks): Replace with `customBlockErrorInfoSchema` which makes `isRetryable` required
 // once min supported bridge protocol version is bumped to 3.
-const readyErrorSchema = v.object({
+const connectErrorSchema = v.object({
     code: v.string(),
     message: v.string(),
     isRetryable: v.optional(v.boolean(), false),
 });
 /**
- * First message the sandbox sends after mount, kicking off the bridge handshake. The host replies
- * with `init`.
+ * First message the sandbox sends after mount. It identifies the sandbox and starts the bridge
+ * initialization exchange. The host echoes `initializationId` in its `init` response.
  */
-export const readyMessageSchema = v.union([
+export const connectMessageSchema = v.variant("status", [
     v.object({
         status: v.literal("success"),
         /**
-         * The data sources and settings the custom block expects, or null when the
-         * block has no manifest and no declared data requirements.
+         * The data sources and settings the custom block expects. Hosts may omit
+         * this when they already have an authoritative manifest.
          */
-        manifest: v.union([manifestSchema, v.null_()]),
-        ...readyMessageCommonEntries,
+        manifest: v.optional(manifestSchema),
+        ...connectMessageCommonEntries,
     }),
     v.object({
         status: v.literal("error"),
-        error: readyErrorSchema,
-        ...readyMessageCommonEntries,
+        error: connectErrorSchema,
+        ...connectMessageCommonEntries,
     }),
 ]);

package/dist/bridge/messages/hostToSandbox.d.ts

@@ -4,6 +4,7 @@ import * as v from "valibot";
  */
 export declare const hostToSandboxMessageSchema: v.VariantSchema<"type", [v.VariantSchema<"status", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"init", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"success", undefined>;
     readonly theme: v.PicklistSchema<["light", "dark"], undefined>;
     readonly blockId: v.CustomSchema<import("../ids.js").NotionBlockId, v.ErrorMessage<v.CustomIssue> | undefined>;
@@ -42,6 +43,25 @@ export declare const hostToSandboxMessageSchema: v.VariantSchema<"type", [v.Vari
             readonly agent_id: v.CustomSchema<import("../ids.js").NotionAgentId, v.ErrorMessage<v.CustomIssue> | undefined>;
         }, undefined>], undefined>;
     }, undefined>;
+    readonly manifest: v.ObjectSchema<{
+        readonly version: v.LiteralSchema<1, undefined>;
+        readonly dataSources: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"emoji", undefined>;
+                readonly emoji: v.StringSchema<undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"external", undefined>;
+                readonly url: v.StringSchema<undefined>;
+            }, undefined>], undefined>, undefined>;
+            readonly properties: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                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>;
+    }, undefined>;
     readonly dataSources: v.ObjectSchema<{
         readonly bindings: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
             readonly collectionPointer: v.OptionalSchema<v.ObjectSchema<{
@@ -201,6 +221,7 @@ export declare const hostToSandboxMessageSchema: v.VariantSchema<"type", [v.Vari
     }, undefined>;
 }, undefined>, v.ObjectSchema<{
     readonly type: v.LiteralSchema<"init", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"error", undefined>;
     readonly error: v.ObjectSchema<{
         readonly code: v.StringSchema<undefined>;

package/dist/bridge/messages/hostToSandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostToSandbox.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/hostToSandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAe5B;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAcrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAC/C,OAAO,0BAA0B,CACjC,CAAA"}
+{"version":3,"file":"hostToSandbox.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/hostToSandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAe5B;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAcrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAC/C,OAAO,0BAA0B,CACjC,CAAA"}

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

@@ -1,25 +1,34 @@
 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<"no_ready" | "invalid_ready" | "manifest_unavailable" | "manifest_invalid" | "invalid_protocol_version" | "unsupported_protocol_version" | "context_unavailable" | "current_user_unavailable" | "missing_data_source_binding" | "data_source_unavailable" | "missing_property_binding" | "invalid_property_binding" | "not_in_iframe" | "init_timeout">;
+export type CustomBlockInitErrorCode = CustomBlockErrorCode<"manifest_unavailable" | "manifest_invalid" | "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 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 CustomBlockInitializationErrorInfo = CustomBlockErrorInfo<CustomBlockInitializationErrorCode>;
 export declare const customBlockInitErrorInfoSchema: v.ObjectSchema<{
     readonly code: v.StringSchema<undefined>;
     readonly message: v.StringSchema<undefined>;
     readonly isRetryable: v.BooleanSchema<undefined>;
 }, undefined>;
-export declare class CustomBlockInitError extends Error implements CustomBlockErrorInfo {
-    constructor(error: CustomBlockInitErrorInfo);
-    code: CustomBlockInitErrorCode;
+export declare class CustomBlockInitializationError extends Error implements CustomBlockErrorInfo {
+    constructor(error: CustomBlockInitializationErrorInfo);
+    code: CustomBlockInitializationErrorCode;
     isRetryable: boolean;
 }
 /**
  * Initialization message sent by the host to the sandbox exactly once, in response to the
- * sandbox's `ready` message. After init, live updates flow through narrower messages
- * (`themeChanged`, `parentChanged`, `pageChanged`, `dataSourcesChanged`).
+ * sandbox's `connect` message. The sandbox echoes `initializationId` in `initResult`. After
+ * successful initialization, live updates flow through narrower messages.
  */
 export declare const initMessageSchema: v.VariantSchema<"status", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"init", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"success", undefined>;
     readonly theme: v.PicklistSchema<["light", "dark"], undefined>;
     readonly blockId: v.CustomSchema<import("../ids.js").NotionBlockId, v.ErrorMessage<v.CustomIssue> | undefined>;
@@ -58,6 +67,25 @@ export declare const initMessageSchema: v.VariantSchema<"status", [v.ObjectSchem
             readonly agent_id: v.CustomSchema<import("../ids.js").NotionAgentId, v.ErrorMessage<v.CustomIssue> | undefined>;
         }, undefined>], undefined>;
     }, undefined>;
+    readonly manifest: v.ObjectSchema<{
+        readonly version: v.LiteralSchema<1, undefined>;
+        readonly dataSources: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"emoji", undefined>;
+                readonly emoji: v.StringSchema<undefined>;
+            }, undefined>, v.ObjectSchema<{
+                readonly type: v.LiteralSchema<"external", undefined>;
+                readonly url: v.StringSchema<undefined>;
+            }, undefined>], undefined>, undefined>;
+            readonly properties: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                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>;
+    }, undefined>;
     readonly dataSources: v.ObjectSchema<{
         readonly bindings: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
             readonly collectionPointer: v.OptionalSchema<v.ObjectSchema<{
@@ -217,6 +245,7 @@ export declare const initMessageSchema: v.VariantSchema<"status", [v.ObjectSchem
     }, undefined>;
 }, undefined>, v.ObjectSchema<{
     readonly type: v.LiteralSchema<"init", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"error", undefined>;
     readonly error: v.ObjectSchema<{
         readonly code: v.StringSchema<undefined>;

package/dist/bridge/messages/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAS9E,eAAO,MAAM,8BAA8B,2BAAa,CAAA;AAExD,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,CACxD,UAAU,GACV,eAAe,GACf,sBAAsB,GACtB,kBAAkB,GAClB,0BAA0B,GAC1B,8BAA8B,GAC9B,qBAAqB,GACrB,0BAA0B,GAC1B,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,eAAe,GACf,cAAc,CAChB,CAAA;AAED,MAAM,MAAM,wBAAwB,GACnC,oBAAoB,CAAC,wBAAwB,CAAC,CAAA;AAE/C,eAAO,MAAM,8BAA8B;;;;aAIzC,CAAA;AAEF,qBAAa,oBACZ,SAAQ,KACR,YAAW,oBAAoB;gBAEnB,KAAK,EAAE,wBAAwB;IAO3C,IAAI,EAAE,wBAAwB,CAAA;IAC9B,WAAW,EAAE,OAAO,CAAA;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAkB5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAO9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAA;AAIrE,eAAO,MAAM,8BAA8B,2BAAa,CAAA;AAExD,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,CACxD,sBAAsB,GACtB,kBAAkB,GAClB,0BAA0B,GAC1B,8BAA8B,GAC9B,qBAAqB,GACrB,0BAA0B,GAC1B,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,GAC1B,0BAA0B,CAC5B,CAAA;AAED,MAAM,MAAM,wBAAwB,GACnC,oBAAoB,CAAC,wBAAwB,CAAC,CAAA;AAE/C;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAC3C,wBAAwB,GACxB,8BAA8B,GAC9B,oBAAoB,CAAC,eAAe,GAAG,cAAc,CAAC,CAAA;AAEzD,MAAM,MAAM,kCAAkC,GAC7C,oBAAoB,CAAC,kCAAkC,CAAC,CAAA;AAEzD,eAAO,MAAM,8BAA8B;;;;aAIzC,CAAA;AAEF,qBAAa,8BACZ,SAAQ,KACR,YAAW,oBAAoB;gBAEnB,KAAK,EAAE,kCAAkC;IAOrD,IAAI,EAAE,kCAAkC,CAAA;IACxC,WAAW,EAAE,OAAO,CAAA;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAqB5B,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA"}

package/dist/bridge/messages/init.js

@@ -1,6 +1,7 @@
 import * as v from "valibot";
 import { notionDataSourceBindingsSchema } from "../dataSources/dataSource.js";
 import { notionBlockIdSchema } from "../ids.js";
+import { manifestSchema } from "../manifest.js";
 import { customBlockPageSchema } from "../pages/page.js";
 import { notionParentSchema } from "../parent.js";
 import { notionThemeSchema } from "../theme.js";
@@ -13,27 +14,29 @@ export const customBlockInitErrorInfoSchema = v.object({
     message: v.string(),
     isRetryable: v.boolean(),
 });
-export class CustomBlockInitError extends Error {
+export class CustomBlockInitializationError extends Error {
     constructor(error) {
         super(error.message);
-        this.name = "CustomBlockInitError";
+        this.name = "CustomBlockInitializationError";
         this.code = error.code;
         this.isRetryable = error.isRetryable;
     }
 }
 /**
  * Initialization message sent by the host to the sandbox exactly once, in response to the
- * sandbox's `ready` message. After init, live updates flow through narrower messages
- * (`themeChanged`, `parentChanged`, `pageChanged`, `dataSourcesChanged`).
+ * sandbox's `connect` message. The sandbox echoes `initializationId` in `initResult`. After
+ * successful initialization, live updates flow through narrower messages.
  */
 export const initMessageSchema = v.variant("status", [
     v.object({
         type: v.literal("init"),
+        initializationId: v.string(),
         status: v.literal("success"),
         theme: notionThemeSchema,
         blockId: notionBlockIdSchema,
         parent: notionParentSchema,
         page: customBlockPageSchema,
+        manifest: manifestSchema,
         dataSources: v.object({
             bindings: notionDataSourceBindingsSchema,
         }),
@@ -41,6 +44,7 @@ export const initMessageSchema = v.variant("status", [
     }),
     v.object({
         type: v.literal("init"),
+        initializationId: v.string(),
         status: v.literal("error"),
         error: customBlockInitErrorInfoSchema,
     }),

package/dist/bridge/messages/initResult.d.ts

@@ -0,0 +1,29 @@
+import * as v from "valibot";
+import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
+export declare const customBlockInitResultErrorCodeSchema: v.StringSchema<undefined>;
+export type CustomBlockInitResultErrorCode = CustomBlockErrorCode<"invalid_init_bindings">;
+export type CustomBlockInitResultErrorInfo = CustomBlockErrorInfo<CustomBlockInitResultErrorCode>;
+export declare const customBlockInitResultErrorInfoSchema: v.ObjectSchema<{
+    readonly code: v.StringSchema<undefined>;
+    readonly message: v.StringSchema<undefined>;
+    readonly isRetryable: v.BooleanSchema<undefined>;
+}, undefined>;
+/**
+ * Acknowledges whether the sandbox successfully applied the host's `init` response.
+ */
+export declare const initResultMessageSchema: v.VariantSchema<"status", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"initResult", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
+    readonly status: v.LiteralSchema<"success", undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"initResult", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
+    readonly status: v.LiteralSchema<"error", undefined>;
+    readonly error: v.ObjectSchema<{
+        readonly code: v.StringSchema<undefined>;
+        readonly message: v.StringSchema<undefined>;
+        readonly isRetryable: v.BooleanSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+export type InitResultMessage = v.InferOutput<typeof initResultMessageSchema>;
+//# sourceMappingURL=initResult.d.ts.map

package/dist/bridge/messages/initResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initResult.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/initResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAI9E,eAAO,MAAM,oCAAoC,2BAAa,CAAA;AAE9D,MAAM,MAAM,8BAA8B,GACzC,oBAAoB,CAAC,uBAAuB,CAAC,CAAA;AAE9C,MAAM,MAAM,8BAA8B,GACzC,oBAAoB,CAAC,8BAA8B,CAAC,CAAA;AAErD,eAAO,MAAM,oCAAoC;;;;aAI/C,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;0BAYlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA"}

package/dist/bridge/messages/initResult.js

@@ -0,0 +1,25 @@
+import * as v from "valibot";
+// The schema accepts any string code. The type lists known codes for
+// autocomplete, with an open string fallback for newer senders.
+export const customBlockInitResultErrorCodeSchema = v.string();
+export const customBlockInitResultErrorInfoSchema = v.object({
+    code: customBlockInitResultErrorCodeSchema,
+    message: v.string(),
+    isRetryable: v.boolean(),
+});
+/**
+ * Acknowledges whether the sandbox successfully applied the host's `init` response.
+ */
+export const initResultMessageSchema = v.variant("status", [
+    v.object({
+        type: v.literal("initResult"),
+        initializationId: v.string(),
+        status: v.literal("success"),
+    }),
+    v.object({
+        type: v.literal("initResult"),
+        initializationId: v.string(),
+        status: v.literal("error"),
+        error: customBlockInitResultErrorInfoSchema,
+    }),
+]);

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

@@ -3,12 +3,13 @@ import * as v from "valibot";
  * 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.
  */
-export declare const sandboxToHostMessageSchema: v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"ready", undefined>;
+export declare const sandboxToHostMessageSchema: v.UnionSchema<[v.VariantSchema<"status", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"connect", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
     readonly bridgeProtocolVersion: v.NumberSchema<undefined>;
     readonly sdkVersion: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"success", undefined>;
-    readonly manifest: v.UnionSchema<[v.ObjectSchema<{
+    readonly manifest: v.OptionalSchema<v.ObjectSchema<{
         readonly version: v.LiteralSchema<1, undefined>;
         readonly dataSources: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
             readonly name: v.StringSchema<undefined>;
@@ -26,9 +27,10 @@ export declare const sandboxToHostMessageSchema: v.UnionSchema<[v.UnionSchema<[v
                 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>;
-    }, undefined>, v.NullSchema<undefined>], undefined>;
+    }, undefined>, undefined>;
 }, undefined>, v.ObjectSchema<{
-    readonly type: v.LiteralSchema<"ready", undefined>;
+    readonly type: v.LiteralSchema<"connect", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
     readonly bridgeProtocolVersion: v.NumberSchema<undefined>;
     readonly sdkVersion: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"error", undefined>;
@@ -37,6 +39,19 @@ export declare const sandboxToHostMessageSchema: v.UnionSchema<[v.UnionSchema<[v
         readonly message: v.StringSchema<undefined>;
         readonly isRetryable: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>;
+}, undefined>], undefined>, v.VariantSchema<"status", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"initResult", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
+    readonly status: v.LiteralSchema<"success", undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"initResult", undefined>;
+    readonly initializationId: v.StringSchema<undefined>;
+    readonly status: v.LiteralSchema<"error", undefined>;
+    readonly error: v.ObjectSchema<{
+        readonly code: v.StringSchema<undefined>;
+        readonly message: v.StringSchema<undefined>;
+        readonly isRetryable: v.BooleanSchema<undefined>;
+    }, undefined>;
 }, undefined>], undefined>, v.ObjectSchema<{
     readonly type: v.LiteralSchema<"queryDataSource", undefined>;
     readonly subscriptionId: v.StringSchema<undefined>;

package/dist/bridge/messages/sandboxToHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxToHost.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/sandboxToHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAW5B;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAUrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAC/C,OAAO,0BAA0B,CACjC,CAAA"}
+{"version":3,"file":"sandboxToHost.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/sandboxToHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAY5B;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAWrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAC/C,OAAO,0BAA0B,CACjC,CAAA"}

package/dist/bridge/messages/sandboxToHost.js

@@ -1,11 +1,12 @@
 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 { invalidHostMessageSchema } from "./invalidHostMessage.js";
 import { listUsersMessageSchema } from "./listUsers.js";
 import { queryDataSourceMessageSchema } from "./queryDataSource.js";
-import { readyMessageSchema } from "./ready.js";
 import { resizeMessageSchema } from "./resize.js";
 import { updatePageMessageSchema } from "./updatePage.js";
 /**
@@ -13,7 +14,8 @@ import { updatePageMessageSchema } from "./updatePage.js";
  * inbound traffic from sandboxes without re-implementing validation logic.
  */
 export const sandboxToHostMessageSchema = v.union([
-    readyMessageSchema,
+    connectMessageSchema,
+    initResultMessageSchema,
     queryDataSourceMessageSchema,
     createPageMessageSchema,
     getPageMessageSchema,

package/dist/bridge/sandboxClient.d.ts

@@ -1,16 +1,14 @@
 import type { CreatePageInput, CreatePageResult, GetPageResult, GetUserResult, ListUsersInput, ListUsersResult, NotionPageId, NotionUserId, UpdatePageInput, UpdatePageResult, UseDataSourceOptions } from "../types.js";
 import { type CustomBlockHostState, type DataSourceQueryView } from "./hostState.js";
 import type { ManifestLoadResult } from "./loadManifest.js";
-import type { CustomBlockManifest } from "./manifest.js";
 import type { InitMessage } from "./messages/init.js";
 import { type MessageLogEntry } from "./SandboxBridge.js";
 export type { MessageLogEntry };
 export declare const customBlockHost: {
-    sendReady: (manifestResult: ManifestLoadResult) => void;
-    awaitInit: (signal?: AbortSignal) => Promise<InitMessage>;
+    sendConnect: (manifestResult: ManifestLoadResult) => void;
+    awaitInit: (signal?: AbortSignal) => Promise<void>;
     subscribe: (listener: () => void) => () => boolean;
     getState: () => CustomBlockHostState;
-    getManifest: () => CustomBlockManifest | null;
     /**
      * Apply an `init` payload directly, bypassing the postMessage handshake for
      * standalone preview state.

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

@@ -1 +1 @@
-{"version":3,"file":"sandboxClient.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/sandboxClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,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,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,oBAAoB,CAAA;AAExE,YAAY,EAAE,eAAe,EAAE,CAAA;AAI/B,eAAO,MAAM,eAAe;gCACC,kBAAkB;yBAIzB,WAAW,KAAG,OAAO,CAAC,WAAW,CAAC;0BAIjC,MAAM,IAAI;oBAIlB,oBAAoB;uBAIjB,mBAAmB,GAAG,IAAI;IAI3C;;;OAGG;4BACqB,WAAW;yBAId,MAAM;CAG3B,CAAA;AAED,eAAO,MAAM,sBAAsB;iBACrB,MAAM,YAAY,oBAAoB;yBAKvC,oBAAoB,OAC1B,MAAM,KACT,mBAAmB;CAKtB,CAAA;AAED,eAAO,MAAM,UAAU;uBACL,SAAS,eAAe,EAAE;0BAIrB,MAAM,IAAI;CAGhC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;oBACa,eAAe,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3D;;OAEG;kBACW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;IAInD;;OAEG;oBACa,eAAe,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3D;;OAEG;qBACc,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;CAGzD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;mBACY,cAAc,KAAG,OAAO,CAAC,eAAe,CAAC;IAIxD;;OAEG;kBACW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;CAGnD,CAAA"}
+{"version":3,"file":"sandboxClient.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/sandboxClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,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,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,oBAAoB,CAAA;AAExE,YAAY,EAAE,eAAe,EAAE,CAAA;AAI/B,eAAO,MAAM,eAAe;kCACG,kBAAkB;yBAI3B,WAAW,KAAG,OAAO,CAAC,IAAI,CAAC;0BAI1B,MAAM,IAAI;oBAIlB,oBAAoB;IAIlC;;;OAGG;4BACqB,WAAW;yBAId,MAAM;CAG3B,CAAA;AAED,eAAO,MAAM,sBAAsB;iBACrB,MAAM,YAAY,oBAAoB;yBAKvC,oBAAoB,OAC1B,MAAM,KACT,mBAAmB;CAKtB,CAAA;AAED,eAAO,MAAM,UAAU;uBACL,SAAS,eAAe,EAAE;0BAIrB,MAAM,IAAI;CAGhC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;oBACa,eAAe,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3D;;OAEG;kBACW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;IAInD;;OAEG;oBACa,eAAe,KAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3D;;OAEG;qBACc,YAAY,KAAG,OAAO,CAAC,gBAAgB,CAAC;CAGzD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB;;OAEG;mBACY,cAAc,KAAG,OAAO,CAAC,eAAe,CAAC;IAIxD;;OAEG;kBACW,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC;CAGnD,CAAA"}

package/dist/bridge/sandboxClient.js

@@ -2,8 +2,8 @@ import { getDataSourceQueryView as getDataSourceQueryViewWithBridge, } from "./h
 import { SandboxBridge } from "./SandboxBridge.js";
 const bridge = new SandboxBridge();
 export const customBlockHost = {
-    sendReady: (manifestResult) => {
-        bridge.sendReady(manifestResult);
+    sendConnect: (manifestResult) => {
+        bridge.sendConnect(manifestResult);
     },
     awaitInit: (signal) => {
         return bridge.awaitInit(signal);
@@ -14,9 +14,6 @@ export const customBlockHost = {
     getState: () => {
         return bridge.getHostState();
     },
-    getManifest: () => {
-        return bridge.getManifest();
-    },
     /**
      * Apply an `init` payload directly, bypassing the postMessage handshake for
      * standalone preview state.

package/dist/customBlock.d.ts

@@ -30,7 +30,7 @@ export declare const customBlock: {
     getBlockId(): NotionBlockId;
     getParent(): NotionParent;
     getPage(): CustomBlockPage;
-    getManifest(): CustomBlockManifest | null;
+    getManifest(): CustomBlockManifest;
     autoResize: typeof autoResize;
 };
 //# sourceMappingURL=customBlock.d.ts.map

package/dist/customBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customBlock.d.ts","sourceRoot":"","sources":["../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/customBlock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAK1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,MAAM,gBAAgB,GACzB;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAC/C;IACA,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,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;kBAIT,aAAa;iBAId,YAAY;eAId,eAAe;mBAIX,mBAAmB,GAAG,IAAI;;CAKzC,CAAA"}
+{"version":3,"file":"customBlock.d.ts","sourceRoot":"","sources":["../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/customBlock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAK1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,MAAM,gBAAgB,GACzB;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAC/C;IACA,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,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;kBAIT,aAAa;iBAId,YAAY;eAId,eAAe;mBAIX,mBAAmB;;CAKlC,CAAA"}

package/dist/customBlock.js

@@ -27,7 +27,7 @@ export const customBlock = {
         return getInitializedHostState("getPage").page;
     },
     getManifest() {
-        return customBlockHost.getManifest();
+        return getInitializedHostState("getManifest").manifest;
     },
     autoResize,
 };

package/dist/host/createCustomBlockHost.d.ts

@@ -1,20 +1,23 @@
 import type { NotionDataSourceId } from "../bridge/ids.js";
 import type { HostToSandboxMessage } from "../bridge/messages/hostToSandbox.js";
+import type { InitResultMessage } from "../bridge/messages/initResult.js";
 import type { CustomBlockPage } from "../bridge/pages/page.js";
 import type { NotionParent } from "../bridge/parent.js";
 import type { NotionTheme } from "../bridge/theme.js";
 import type { NotionUser } from "../bridge/users/user.js";
-import type { CustomBlockHostDataSourcesPayload, CustomBlockHostInitialState, ReadySuccessMessage } from "./lifecycle/types.js";
+import type { ConnectSuccessMessage, CustomBlockHostDataSourcesPayload, CustomBlockHostInitialState } from "./lifecycle/types.js";
 import type { CustomBlockHostHandlers, CustomBlockHostLogDirection } from "./messages/types.js";
 import type { CustomBlockHostQueryDataSourceResult } from "./queries/types.js";
 export type CustomBlockHostOptions = {
     iframe: HTMLIFrameElement;
     targetOrigin?: string;
     minBridgeProtocolVersion?: number;
-    noReadyTimeoutMs?: number;
+    noConnectTimeoutMs?: number;
+    noInitResultTimeoutMs?: number;
     initialState: CustomBlockHostInitialState;
     handlers: CustomBlockHostHandlers;
-    onReady?: (message: ReadySuccessMessage) => void;
+    onConnect?: (message: ConnectSuccessMessage) => void;
+    onInitResult?: (message: InitResultMessage) => void;
     onLog?: (direction: CustomBlockHostLogDirection, payload: unknown) => void;
 };
 export type CustomBlockHostHandle = {