@notionhq/custom-blocks 0.0.76 → 0.0.78

package/dist/bridge/SandboxBridge.js

@@ -6,14 +6,13 @@ import { resolvePropertyWriteMapForDataSource } from "./dataSources/resolvePrope
 import { createEmptyDataSourceQueryState, } from "./hostState.js";
 import { readIncomingType } from "./incomingType.js";
 import { hostToSandboxMessageSchema } from "./messages/hostToSandbox.js";
-import { CustomBlockInitError } from "./messages/init.js";
+import { CustomBlockInitializationError, initMessageSchema, } from "./messages/init.js";
 import { PendingRequests } from "./pendingRequests.js";
 /**
  * Used to ensure that the host and client are using the same version of the bridge protocol. A
  * single host needs to support multiple custom blocks built with different versions of the bridge
  * protocol. Increment this number any time a breaking change is made to the bridge protocol.
  */
-// TODO(custom-blocks): Update when bumping bridge protocol version to 3.
 export const CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION = 2;
 export class SandboxBridge {
     constructor() {
@@ -30,13 +29,14 @@ export class SandboxBridge {
         this.pendingGetUser = new PendingRequests("custom-block-get-user");
         this.pendingListUsers = new PendingRequests("custom-block-list-users");
         this.pendingUpdatePage = new PendingRequests("custom-block-update-page");
-        this.hasSentReady = false;
+        this.hasSentConnect = false;
+        this.hasReceivedInit = false;
         this.latestDataSourceBindings = {};
+        this.isMockState = false;
         this.initMessage = new Promise((resolve, reject) => {
             this.resolveInit = resolve;
             this.rejectInit = reject;
         });
-        this.manifest = null;
         this.notify = () => {
             for (const listener of this.listeners) {
                 listener();
@@ -81,7 +81,16 @@ export class SandboxBridge {
             // `init` is the only message valid before initialization. Handle it up
             // front so every later case can assume `status === "initialized"`.
             if (message.type === "init") {
-                this.applyInit(message);
+                if (message.initializationId !== this.initializationId) {
+                    console.warn(`[custom-blocks-sdk] ignoring init for unknown initializationId ${message.initializationId}`);
+                    return;
+                }
+                if (this.hasReceivedInit) {
+                    console.warn("[custom-blocks-sdk] ignoring duplicate init message");
+                    return;
+                }
+                this.hasReceivedInit = true;
+                this.applyInit(message, true);
                 return;
             }
             // Alias to keep TS's narrowed `InitializedHostState` across the switch
@@ -129,10 +138,12 @@ export class SandboxBridge {
                     const dataSources = reuseDataSourcesForUnchangedBindings({
                         previousDataSources: hostState.dataSources,
                         previousBindings: this.latestDataSourceBindings,
-                        nextDataSources: resolveDataSources({
-                            manifest: this.manifest,
-                            dataSourceBindings: nextBindings,
-                        }),
+                        nextDataSources: this.isMockState
+                            ? resolveMockDataSources(nextBindings)
+                            : resolveDataSources({
+                                manifest: hostState.manifest,
+                                dataSourceBindings: nextBindings,
+                            }),
                         nextBindings,
                     });
                     this.latestDataSourceBindings = nextBindings;
@@ -198,30 +209,21 @@ export class SandboxBridge {
                     return;
                 }
                 case "queryDataSourceResult": {
-                    const queryEntry = Object.entries(hostState.dataSourceState).find(([, state]) => state.latestSnapshotId === message.snapshotId);
+                    const queryEntry = Object.entries(hostState.dataSourceState).find(([, state]) => state.subscriptionId === message.subscriptionId);
                     if (queryEntry === undefined) {
                         return;
                     }
                     const [key, currentState] = queryEntry;
-                    if (currentState.latestRequestId !== message.requestId) {
-                        return;
-                    }
-                    const queryResult = "status" in message
-                        ? message.status === "error"
-                            ? {
-                                items: [],
-                                hasMore: false,
-                                error: message.error,
-                            }
-                            : {
-                                items: message.items,
-                                hasMore: message.hasMore,
-                                error: undefined,
-                            }
+                    const queryResult = message.status === "error"
+                        ? {
+                            items: [],
+                            hasMore: false,
+                            error: message.error,
+                        }
                         : {
                             items: message.items,
                             hasMore: message.hasMore,
-                            error: message.error,
+                            error: undefined,
                         };
                     this.hostState = {
                         ...hostState,
@@ -232,10 +234,7 @@ export class SandboxBridge {
                                 isLoading: false,
                                 hasMore: queryResult.hasMore,
                                 error: queryResult.error,
-                                // Keep the request ID so later host-pushed refreshes for the
-                                // same subscription still match.
-                                latestRequestId: message.requestId,
-                                latestSnapshotId: message.snapshotId,
+                                subscriptionId: message.subscriptionId,
                                 latestLimit: currentState.latestLimit,
                             },
                         },
@@ -248,7 +247,7 @@ export class SandboxBridge {
                 }
             }
         };
-        // `ready` is sent later by `initCustomBlock` (after the manifest fetch
+        // `connect` is sent later by `initCustomBlock` (after the manifest fetch
         // resolves). Top-level / no-iframe rejection is handled there too, so
         // the constructor just attaches the listener.
         if (typeof window !== "undefined") {
@@ -286,42 +285,46 @@ export class SandboxBridge {
             }
             const onAbort = () => reject(signal.reason);
             signal.addEventListener("abort", onAbort, { once: true });
-            this.initMessage.then(message => {
+            this.initMessage.then(() => {
                 signal.removeEventListener("abort", onAbort);
-                resolve(message);
+                resolve();
             }, err => {
                 signal.removeEventListener("abort", onAbort);
                 reject(err);
             });
         });
     }
-    sendReady(manifestResult) {
+    sendConnect(manifestResult) {
         if (typeof window === "undefined") {
             return;
         }
-        if (this.hasSentReady) {
-            console.warn("[custom-blocks-sdk] ignoring duplicate ready message");
+        if (this.hasSentConnect) {
+            console.warn("[custom-blocks-sdk] ignoring duplicate connect message");
             return;
         }
         const { manifest, error } = manifestResult;
-        this.hasSentReady = true;
-        this.manifest = manifest;
-        const readyMessage = error !== undefined
+        this.hasSentConnect = true;
+        const initializationId = `custom-block-initialization-${this.nextRequestId}`;
+        this.nextRequestId += 1;
+        this.initializationId = initializationId;
+        const connectMessage = error !== undefined
             ? {
-                type: "ready",
+                type: "connect",
+                initializationId,
                 status: "error",
                 bridgeProtocolVersion: CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION,
                 sdkVersion: CUSTOM_BLOCKS_SDK_VERSION,
                 error,
             }
             : {
-                type: "ready",
+                type: "connect",
+                initializationId,
                 status: "success",
                 bridgeProtocolVersion: CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION,
                 sdkVersion: CUSTOM_BLOCKS_SDK_VERSION,
-                manifest,
+                ...(manifest !== null ? { manifest } : {}),
             };
-        this.postToHost(readyMessage);
+        this.postToHost(connectMessage);
     }
     postToHost(message) {
         console.debug("[custom-blocks-sdk] outbound postMessage", message);
@@ -335,15 +338,6 @@ export class SandboxBridge {
     getHostState() {
         return this.hostState;
     }
-    /**
-     * The author-declared manifest loaded from `custom_blocks.json` and forwarded
-     * to the host in `ready`. `null` when it failed to load/parse and the host
-     * should reject init via `ready.status: "error"`. Static for the lifetime
-     * of the sandbox.
-     */
-    getManifest() {
-        return this.manifest;
-    }
     /**
      * Apply an `init` payload as if it had arrived from the host. Lets callers
      * seed the bridge directly (e.g. the React provider's standalone preview
@@ -351,9 +345,13 @@ export class SandboxBridge {
      * of why it's being seeded.
      */
     setMockState(message) {
-        this.applyInit(message);
+        this.isMockState = true;
+        this.applyInit(v.parse(initMessageSchema, message), false);
     }
-    applyInit(message) {
+    applyInit(message, postResult) {
+        if (postResult) {
+            this.isMockState = false;
+        }
         if (message.status === "error") {
             // The host couldn't construct block location for this block (most commonly the parent record
             // failed to resolve). Surface the failure through the `awaitInit` promise so callers see
@@ -363,7 +361,7 @@ export class SandboxBridge {
             // back over the bridge since the host has already given up.
             console.error(`[custom-blocks-sdk] host reported init error (${message.error.code}): ${message.error.message}`);
             if (this.rejectInit) {
-                this.rejectInit(new CustomBlockInitError(message.error));
+                this.rejectInit(new CustomBlockInitializationError(message.error));
                 this.resolveInit = undefined;
                 this.rejectInit = undefined;
             }
@@ -371,10 +369,28 @@ export class SandboxBridge {
         }
         const { blockId, parent, page } = message;
         this.latestDataSourceBindings = message.dataSources.bindings;
-        const dataSources = resolveDataSources({
-            manifest: this.manifest,
-            dataSourceBindings: this.latestDataSourceBindings,
-        });
+        const dataSources = postResult
+            ? resolveDataSources({
+                manifest: message.manifest,
+                dataSourceBindings: this.latestDataSourceBindings,
+            })
+            : resolveMockDataSources(this.latestDataSourceBindings);
+        const bindingError = getInitBindingError(message.manifest, dataSources);
+        if (postResult && bindingError !== undefined) {
+            const result = {
+                type: "initResult",
+                initializationId: message.initializationId,
+                status: "error",
+                error: bindingError,
+            };
+            this.postToHost(result);
+            if (this.rejectInit) {
+                this.rejectInit(new CustomBlockInitializationError(bindingError));
+                this.resolveInit = undefined;
+                this.rejectInit = undefined;
+            }
+            return;
+        }
         this.hostState = {
             status: "initialized",
             theme: message.theme,
@@ -382,15 +398,24 @@ export class SandboxBridge {
             parent,
             page,
             currentUser: message.currentUser,
+            manifest: message.manifest,
             dataSources,
             dataSourceState: {},
         };
         this.notify();
+        if (postResult) {
+            const result = {
+                type: "initResult",
+                initializationId: message.initializationId,
+                status: "success",
+            };
+            this.postToHost(result);
+        }
         // Resolve the awaitInit promise once. Subsequent `init` messages
         // (the host shouldn't send these, but be tolerant) update state but
         // don't re-resolve.
         if (this.resolveInit) {
-            this.resolveInit(message);
+            this.resolveInit();
             this.resolveInit = undefined;
             this.rejectInit = undefined;
         }
@@ -418,16 +443,14 @@ export class SandboxBridge {
             return;
         }
         const limit = resolveDataSourceQueryLimit(options.limit);
-        const snapshotId = makeDataSourceSnapshotId({
+        const subscriptionId = makeDataSourceSubscriptionId({
             key,
         });
         if (currentState.isLoading &&
-            currentState.latestSnapshotId === snapshotId &&
+            currentState.subscriptionId === subscriptionId &&
             currentState.latestLimit === limit) {
             return;
         }
-        const requestId = `custom-block-query-${this.nextRequestId}`;
-        this.nextRequestId += 1;
         this.hostState = {
             ...this.hostState,
             dataSourceState: {
@@ -436,8 +459,7 @@ export class SandboxBridge {
                     ...currentState,
                     isLoading: true,
                     error: undefined,
-                    latestRequestId: requestId,
-                    latestSnapshotId: snapshotId,
+                    subscriptionId,
                     latestLimit: limit,
                 },
             },
@@ -445,8 +467,7 @@ export class SandboxBridge {
         this.notify();
         const outbound = {
             type: "queryDataSource",
-            requestId,
-            snapshotId,
+            subscriptionId,
             dataSourceId: dataSource.collectionPointer.id,
             limit,
         };
@@ -464,8 +485,7 @@ export class SandboxBridge {
                     ...currentState,
                     isLoading: false,
                     error,
-                    latestRequestId: undefined,
-                    latestSnapshotId: undefined,
+                    subscriptionId: undefined,
                     latestLimit: undefined,
                 },
             },
@@ -708,10 +728,42 @@ function resolveDataSourceQueryLimit(limit) {
     }
     return limit;
 }
-function makeDataSourceSnapshotId(args) {
+function makeDataSourceSubscriptionId(args) {
     const { key } = args;
     return `data-source:${encodeURIComponent(key)}`;
 }
+function getInitBindingError(manifest, dataSources) {
+    for (const [dataSourceKey, manifestDataSource] of Object.entries(manifest.dataSources)) {
+        const dataSource = dataSources.find(entry => entry.key === dataSourceKey);
+        if (dataSource?.collectionPointer === undefined ||
+            dataSource.collectionSchema === undefined) {
+            return {
+                code: "invalid_init_bindings",
+                message: `Host did not provide a complete binding for data source "${dataSourceKey}".`,
+                isRetryable: false,
+            };
+        }
+        for (const propertyKey of Object.keys(manifestDataSource.properties ?? {})) {
+            if (dataSource.propertyIdsByKey[propertyKey] === undefined) {
+                return {
+                    code: "invalid_init_bindings",
+                    message: `Host did not provide a valid binding for property "${dataSourceKey}.${propertyKey}".`,
+                    isRetryable: false,
+                };
+            }
+        }
+    }
+    return undefined;
+}
+function resolveMockDataSources(bindings) {
+    return Object.entries(bindings).map(([key, binding]) => ({
+        key,
+        collectionPointer: binding.collectionPointer,
+        collectionSchema: binding.collectionSchema,
+        propertyIdsByKey: { ...(binding.propertyIdsByKey ?? {}) },
+        propertySchemasById: binding.collectionSchema?.propertiesById ?? {},
+    }));
+}
 function formatInvalidHostReason(incomingType, issues) {
     const labelled = incomingType
         ? `host message of type "${incomingType}"`

package/dist/bridge/dataSources/resolve.d.ts

@@ -1,16 +1,15 @@
 import type { CustomBlockManifest } from "../manifest.js";
 import type { NotionDataSource, NotionDataSourceBindings } from "./dataSource.js";
 type ResolveDataSourcesArgs = {
-    manifest: CustomBlockManifest | null;
+    manifest: CustomBlockManifest;
     dataSourceBindings: NotionDataSourceBindings;
 };
 /**
  * Builds the public {@link NotionDataSource} list the SDK exposes to consumers.
  *
  * Combines the host-supplied bindings (collection pointers + schemas) with the
- * manifest's declared data-source keys. Property mappings are host-owned: the
- * SDK validates the supplied property id against the manifest and live schema,
- * but does not infer a missing mapping.
+ * manifest's declared data-source keys. The host owns every mapping; the SDK
+ * validates supplied IDs but never infers omitted bindings.
  */
 export declare function resolveDataSources(args: ResolveDataSourcesArgs): NotionDataSource[];
 export {};

package/dist/bridge/dataSources/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/dataSources/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,KAAK,EACX,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,iBAAiB,CAAA;AAExB,KAAK,sBAAsB,GAAG;IAC7B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACpC,kBAAkB,EAAE,wBAAwB,CAAA;CAC5C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,sBAAsB,GAC1B,gBAAgB,EAAE,CAyCpB"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/dataSources/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,KAAK,EACX,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,iBAAiB,CAAA;AAExB,KAAK,sBAAsB,GAAG;IAC7B,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,kBAAkB,EAAE,wBAAwB,CAAA;CAC5C,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,sBAAsB,GAC1B,gBAAgB,EAAE,CA+BpB"}

package/dist/bridge/dataSources/resolve.js

@@ -2,20 +2,10 @@
  * Builds the public {@link NotionDataSource} list the SDK exposes to consumers.
  *
  * Combines the host-supplied bindings (collection pointers + schemas) with the
- * manifest's declared data-source keys. Property mappings are host-owned: the
- * SDK validates the supplied property id against the manifest and live schema,
- * but does not infer a missing mapping.
+ * manifest's declared data-source keys. The host owns every mapping; the SDK
+ * validates supplied IDs but never infers omitted bindings.
  */
 export function resolveDataSources(args) {
-    if (args.manifest === null) {
-        return Object.entries(args.dataSourceBindings).map(([key, binding]) => ({
-            key,
-            collectionPointer: binding.collectionPointer,
-            collectionSchema: binding.collectionSchema,
-            propertyIdsByKey: { ...(binding.propertyIdsByKey ?? {}) },
-            propertySchemasById: binding.collectionSchema?.propertiesById ?? {},
-        }));
-    }
     return Object.entries(args.manifest.dataSources).map(([key, manifestDataSource]) => {
         const binding = args.dataSourceBindings[key];
         const propertySchemasById = binding?.collectionSchema?.propertiesById ?? {};

package/dist/bridge/hostState.d.ts

@@ -2,6 +2,7 @@ import type { NotionDataSource } from "./dataSources/dataSource.js";
 import type { NotionDataSourcePage, NotionDataSourcePageBridge, NotionDataSourcePageUpdateInput, NotionDataSourcePageUpdateResult } from "./dataSources/dataSourcePage.js";
 import type { NotionPropertySchema } from "./dataSources/propertySchema.js";
 import type { NotionBlockId } from "./ids.js";
+import type { CustomBlockManifest } from "./manifest.js";
 import type { CustomBlockQueryDataSourceErrorInfo } from "./messages/queryDataSourceResult.js";
 import type { CustomBlockPage, NotionPageId } from "./pages/page.js";
 import type { NotionParent } from "./parent.js";
@@ -19,6 +20,7 @@ export type InitializedHostState = {
     parent: NotionParent;
     page: CustomBlockPage;
     currentUser: NotionUser;
+    manifest: CustomBlockManifest;
     dataSources: NotionDataSource[];
     dataSourceState: Record<string, DataSourceQueryState>;
 };
@@ -28,8 +30,7 @@ export type DataSourceQueryState = {
     isLoading: boolean;
     hasMore: boolean;
     error?: CustomBlockQueryDataSourceErrorInfo;
-    latestRequestId?: string;
-    latestSnapshotId?: string;
+    subscriptionId?: string;
     latestLimit?: number;
 };
 export declare function createEmptyDataSourceQueryState(): DataSourceQueryState;

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

@@ -1 +1 @@
-{"version":3,"file":"hostState.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/hostState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EACX,oBAAoB,EACpB,0BAA0B,EAC1B,+BAA+B,EAC/B,gCAAgC,EAChC,MAAM,iCAAiC,CAAA;AAExC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,qCAAqC,CAAA;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,oBAAoB,CAAA;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,WAAW,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,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;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;CACrD,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,iGAAiG;IACjG,KAAK,EAAE,0BAA0B,EAAE,CAAA;IACnC,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,mCAAmC,CAAA;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAgB,+BAA+B,IAAI,oBAAoB,CAMtE;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,oBAAoB,EAAE,CAAA;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,CAAA;IACvD,mBAAmB,EAAE;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAAA;KAAE,CAAA;IACnE,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACvD,oBAAoB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAAA;KAAE,CAAA;IACzE,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,mCAAmC,CAAA;CAC3C,CAAA;AAWD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAC3C,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,+BAA+B,CAAA;CACtC,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAA;AAE/C,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,oBAAoB,EAC/B,GAAG,EAAE,MAAM,EACX,oBAAoB,EAAE,sBAAsB,GAC1C,mBAAmB,CAgErB"}
+{"version":3,"file":"hostState.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/hostState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EACX,oBAAoB,EACpB,0BAA0B,EAC1B,+BAA+B,EAC/B,gCAAgC,EAChC,MAAM,iCAAiC,CAAA;AAExC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,qCAAqC,CAAA;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,oBAAoB,CAAA;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,WAAW,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,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,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;CACrD,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IAClC,iGAAiG;IACjG,KAAK,EAAE,0BAA0B,EAAE,CAAA;IACnC,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,mCAAmC,CAAA;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAgB,+BAA+B,IAAI,oBAAoB,CAMtE;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,oBAAoB,EAAE,CAAA;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,CAAA;IACvD,mBAAmB,EAAE;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAAA;KAAE,CAAA;IACnE,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACvD,oBAAoB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAAA;KAAE,CAAA;IACzE,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,mCAAmC,CAAA;CAC3C,CAAA;AAWD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAC3C,UAAU,EAAE,gBAAgB,CAAA;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,KAAK,EAAE,+BAA+B,CAAA;CACtC,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAA;AAE/C,wBAAgB,sBAAsB,CACrC,SAAS,EAAE,oBAAoB,EAC/B,GAAG,EAAE,MAAM,EACX,oBAAoB,EAAE,sBAAsB,GAC1C,mBAAmB,CAgErB"}

package/dist/bridge/loadManifest.d.ts

@@ -1,20 +1,20 @@
 import type { CustomBlockErrorInfo } from "./errors.js";
 import { type CustomBlockManifest } from "./manifest.js";
-export type CustomBlockReadyErrorCode = "manifest_unavailable" | "manifest_invalid" | (string & {});
-export type CustomBlockReadyError = CustomBlockErrorInfo<CustomBlockReadyErrorCode>;
+export type CustomBlockConnectErrorCode = "manifest_unavailable" | "manifest_invalid" | (string & {});
+export type CustomBlockConnectError = CustomBlockErrorInfo<CustomBlockConnectErrorCode>;
 export type ManifestLoadResult = {
     manifest: CustomBlockManifest | null;
     error?: undefined;
 } | {
     manifest: null;
-    error: CustomBlockReadyError;
+    error: CustomBlockConnectError;
 };
 /**
  * Attempts to load a `custom_blocks.json` manifest co-located with the bundle.
  * 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 declare function loadManifest(): Promise<ManifestLoadResult>;
 //# sourceMappingURL=loadManifest.d.ts.map

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"}