@notionhq/custom-blocks 0.0.76 → 0.0.78

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>;
@@ -412,8 +433,7 @@ export declare const hostToSandboxMessageSchema: v.VariantSchema<"type", [v.Vari
     }, undefined>;
 }, undefined>, v.VariantSchema<"status", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"queryDataSourceResult", undefined>;
-    readonly requestId: v.StringSchema<undefined>;
-    readonly snapshotId: v.StringSchema<undefined>;
+    readonly subscriptionId: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"success", undefined>;
     readonly items: v.ArraySchema<v.ObjectSchema<{
         readonly id: v.CustomSchema<import("../ids.js").NotionPageId, v.ErrorMessage<v.CustomIssue> | undefined>;
@@ -482,89 +502,14 @@ export declare const hostToSandboxMessageSchema: v.VariantSchema<"type", [v.Vari
     readonly hasMore: v.BooleanSchema<undefined>;
 }, undefined>, v.ObjectSchema<{
     readonly type: v.LiteralSchema<"queryDataSourceResult", undefined>;
-    readonly requestId: v.StringSchema<undefined>;
-    readonly snapshotId: v.StringSchema<undefined>;
+    readonly subscriptionId: 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<"queryDataSourceResult", undefined>;
-    readonly requestId: v.StringSchema<undefined>;
-    readonly snapshotId: v.StringSchema<undefined>;
-    readonly items: v.ArraySchema<v.ObjectSchema<{
-        readonly id: v.CustomSchema<import("../ids.js").NotionPageId, v.ErrorMessage<v.CustomIssue> | undefined>;
-        readonly propertiesById: v.RecordSchema<v.StringSchema<undefined>, v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>, v.BooleanSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
-            readonly type: v.LiteralSchema<"date", undefined>;
-            readonly start_date: v.StringSchema<undefined>;
-            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
-                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
-                readonly value: v.NumberSchema<undefined>;
-                readonly time: v.StringSchema<undefined>;
-                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            }, undefined>, v.ObjectSchema<{
-                readonly unit: v.LiteralSchema<"none", undefined>;
-            }, undefined>], undefined>, undefined>;
-        }, undefined>, v.ObjectSchema<{
-            readonly type: v.LiteralSchema<"daterange", undefined>;
-            readonly start_date: v.StringSchema<undefined>;
-            readonly end_date: v.StringSchema<undefined>;
-            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.ObjectSchema<{
-                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
-                readonly value: v.NumberSchema<undefined>;
-                readonly time: v.StringSchema<undefined>;
-                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            }, undefined>, v.ObjectSchema<{
-                readonly unit: v.LiteralSchema<"none", undefined>;
-            }, undefined>], undefined>, undefined>;
-        }, undefined>, v.ObjectSchema<{
-            readonly type: v.LiteralSchema<"datetime", undefined>;
-            readonly start_date: v.StringSchema<undefined>;
-            readonly start_time: v.StringSchema<undefined>;
-            readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
-                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
-                readonly value: v.NumberSchema<undefined>;
-                readonly time: v.StringSchema<undefined>;
-                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            }, undefined>, v.ObjectSchema<{
-                readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
-                readonly value: v.NumberSchema<undefined>;
-            }, undefined>], undefined>, v.ObjectSchema<{
-                readonly unit: v.LiteralSchema<"none", undefined>;
-            }, undefined>], undefined>, undefined>;
-        }, undefined>, v.ObjectSchema<{
-            readonly type: v.LiteralSchema<"datetimerange", undefined>;
-            readonly start_date: v.StringSchema<undefined>;
-            readonly start_time: v.StringSchema<undefined>;
-            readonly end_date: v.StringSchema<undefined>;
-            readonly end_time: v.StringSchema<undefined>;
-            readonly time_zone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly reminder: v.OptionalSchema<v.UnionSchema<[v.UnionSchema<[v.ObjectSchema<{
-                readonly unit: v.PicklistSchema<["year", "month", "week", "day"], undefined>;
-                readonly value: v.NumberSchema<undefined>;
-                readonly time: v.StringSchema<undefined>;
-                readonly defaultTimeZone: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            }, undefined>, v.ObjectSchema<{
-                readonly unit: v.PicklistSchema<["hour", "minute"], undefined>;
-                readonly value: v.NumberSchema<undefined>;
-            }, undefined>], undefined>, v.ObjectSchema<{
-                readonly unit: v.LiteralSchema<"none", undefined>;
-            }, undefined>], undefined>, undefined>;
-        }, undefined>], undefined>, v.ArraySchema<v.StringSchema<undefined>, undefined>, v.ArraySchema<v.ObjectSchema<{
-            readonly id: v.StringSchema<undefined>;
-            readonly table: v.StringSchema<undefined>;
-        }, undefined>, undefined>], undefined>, undefined>, undefined>;
-    }, undefined>, undefined>;
-    readonly hasMore: v.BooleanSchema<undefined>;
-    readonly error: v.OptionalSchema<v.ObjectSchema<{
-        readonly code: v.StringSchema<undefined>;
-        readonly message: v.StringSchema<undefined>;
-        readonly isRetryable: v.BooleanSchema<undefined>;
-    }, undefined>, undefined>;
-}, undefined>, v.VariantSchema<"status", [v.ObjectSchema<{
+}, undefined>], undefined>, v.VariantSchema<"status", [v.ObjectSchema<{
     readonly type: v.LiteralSchema<"createPageResult", undefined>;
     readonly requestId: v.StringSchema<undefined>;
     readonly status: v.LiteralSchema<"success", 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;AAkB5B;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAerC,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/hostToSandbox.js

@@ -9,7 +9,7 @@ import { invalidSandboxMessageSchema } from "./invalidSandboxMessage.js";
 import { listUsersResultMessageSchema } from "./listUsers.js";
 import { pageChangedMessageSchema } from "./pageChanged.js";
 import { parentChangedMessageSchema } from "./parentChanged.js";
-import { legacyQueryDataSourceResultMessageSchema, statusQueryDataSourceResultMessageSchema, } from "./queryDataSourceResult.js";
+import { queryDataSourceResultMessageSchema } from "./queryDataSourceResult.js";
 import { themeChangedMessageSchema } from "./themeChanged.js";
 import { updatePageResultMessageSchema } from "./updatePageResult.js";
 /**
@@ -22,8 +22,7 @@ export const hostToSandboxMessageSchema = v.variant("type", [
     pageChangedMessageSchema,
     currentUserChangedMessageSchema,
     dataSourcesChangedMessageSchema,
-    statusQueryDataSourceResultMessageSchema,
-    legacyQueryDataSourceResultMessageSchema,
+    queryDataSourceResultMessageSchema,
     createPageResultMessageSchema,
     getPageResultMessageSchema,
     getUserResultMessageSchema,

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

@@ -5,15 +5,11 @@ import * as v from "valibot";
  */
 export declare const queryDataSourceMessageSchema: v.ObjectSchema<{
     readonly type: v.LiteralSchema<"queryDataSource", undefined>;
-    readonly requestId: v.StringSchema<undefined>;
-    /**
-     * The stable snapshot ID that identifies the SDK result slot to update. This is stable for the
-     * lifetime of the subscription.
-     */
-    readonly snapshotId: v.StringSchema<undefined>;
+    /** Stable for the lifetime of this query subscription. */
+    readonly subscriptionId: v.StringSchema<undefined>;
     /** The raw Notion data source ID to read from. */
     readonly dataSourceId: v.CustomSchema<import("../ids.js").NotionDataSourceId, v.ErrorMessage<v.CustomIssue> | undefined>;
-    /** The number of items to return in the snapshot. */
+    /** The number of items to return in each subscription update. */
     readonly limit: v.NumberSchema<undefined>;
 }, undefined>;
 export type QueryDataSourceMessage = v.InferOutput<typeof queryDataSourceMessageSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"queryDataSource.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/queryDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;IAGxC;;;OAGG;;IAEH,kDAAkD;;IAElD,qDAAqD;;aAEpD,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CACjD,OAAO,4BAA4B,CACnC,CAAA"}
+{"version":3,"file":"queryDataSource.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/queryDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAG5B;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;IAExC,0DAA0D;;IAE1D,kDAAkD;;IAElD,iEAAiE;;aAEhE,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CACjD,OAAO,4BAA4B,CACnC,CAAA"}

package/dist/bridge/messages/queryDataSource.js

@@ -6,14 +6,10 @@ import { notionDataSourceIdSchema } from "../ids.js";
  */
 export const queryDataSourceMessageSchema = v.object({
     type: v.literal("queryDataSource"),
-    requestId: v.string(),
-    /**
-     * The stable snapshot ID that identifies the SDK result slot to update. This is stable for the
-     * lifetime of the subscription.
-     */
-    snapshotId: v.string(),
+    /** Stable for the lifetime of this query subscription. */
+    subscriptionId: v.string(),
     /** The raw Notion data source ID to read from. */
     dataSourceId: notionDataSourceIdSchema,
-    /** The number of items to return in the snapshot. */
+    /** The number of items to return in each subscription update. */
     limit: v.number(),
 });