@notionhq/custom-blocks 0.1.18 → 0.1.20

package/dist/bridge/SandboxBridge.d.ts

@@ -1,6 +1,6 @@
 import type { NotionDataSource } from "../protocol/dataSources/dataSource.js";
 import { type InitMessage } from "../protocol/messages/init.js";
-import type { CreatePageArgs, CreatePageResult, GetPageResult, GetUserResult, ListUsersArgs, ListUsersResult, NotionDataSourcePageUpdateArgs, NotionDataSourcePageUpdateResult, NotionPageId, NotionUserId, UpdatePageArgs, UpdatePageResult, UseDataSourceOptions } from "../types.js";
+import type { CreatePageArgs, CreatePageResult, GetPageResult, GetUserResult, ListUsersArgs, ListUsersResult, NotionDataSourcePageUpdateArgs, NotionPageId, NotionUserId, UpdatePageArgs, UpdatePageResult, UseDataSourceOptions } from "../types.js";
 import { type CustomBlockHostState } from "./hostState.js";
 import type { ManifestLoadResult } from "./loadManifest.js";
 /**
@@ -69,7 +69,7 @@ export declare class SandboxBridge {
         dataSource: NotionDataSource;
         pageId: NotionPageId;
         pageUpdateArgs: NotionDataSourcePageUpdateArgs;
-    }): Promise<NotionDataSourcePageUpdateResult>;
+    }): Promise<UpdatePageResult>;
     /**
      * Translates the public `CreatePageArgs["parent"]` into the bridge-native
      * `CreatePageMessageParent`. The `data_source_key` variant is resolved sandbox-side against

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

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

package/dist/bridge/SandboxBridge.js

@@ -6,6 +6,7 @@ import { CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION } from "../protocol/protocolVersio
 import * as v from "valibot";
 import { unreachable } from "../utils.js";
 import { CUSTOM_BLOCKS_SDK_VERSION } from "../version.js";
+import { NOTION_DARK_BACKGROUND_BASE, NOTION_LIGHT_BACKGROUND_BASE, } from "./appearance.js";
 import { resolveDataSources } from "./dataSources/resolve.js";
 import { resolvePropertyWriteMapForDataSource } from "./dataSources/resolveProperty.js";
 import { createEmptyDataSourceQueryState, } from "./hostState.js";
@@ -104,6 +105,10 @@ export class SandboxBridge {
                         ...hostState,
                         theme: message.theme,
                     };
+                    syncDocumentAppearance({
+                        theme: message.theme,
+                        contrastMode: hostState.contrastMode,
+                    });
                     this.notify();
                     return;
                 }
@@ -112,6 +117,10 @@ export class SandboxBridge {
                         ...hostState,
                         contrastMode: message.contrastMode,
                     };
+                    syncDocumentAppearance({
+                        theme: hostState.theme,
+                        contrastMode: message.contrastMode,
+                    });
                     this.notify();
                     return;
                 }
@@ -410,6 +419,10 @@ export class SandboxBridge {
             dataSources,
             dataSourceState: {},
         };
+        syncDocumentAppearance({
+            theme: message.theme,
+            contrastMode: message.contrastMode,
+        });
         this.notify();
         if (postResult) {
             const result = {
@@ -699,6 +712,27 @@ export class SandboxBridge {
     }
 }
 SandboxBridge.MAX_LOG_ENTRIES = 100;
+/**
+ * Makes the document canvas match the host appearance before acknowledging init.
+ *
+ * The host reveals the iframe as soon as it receives `initResult.success`. Applying these
+ * attributes synchronously prevents the browser's default white canvas from flashing while React
+ * mounts a token scope.
+ */
+function syncDocumentAppearance(args) {
+    if (typeof document === "undefined") {
+        return;
+    }
+    const { theme, contrastMode } = args;
+    const root = document.documentElement;
+    root.dataset.displayMode = theme;
+    root.dataset.contrastMode = contrastMode;
+    root.style.colorScheme = theme;
+    root.style.backgroundColor =
+        theme === "dark"
+            ? NOTION_DARK_BACKGROUND_BASE
+            : NOTION_LIGHT_BACKGROUND_BASE;
+}
 /**
  * `postMessage` cloning creates new objects even for bindings that did not change.
  * Preserve their resolved object identity so React effects only run for changed bindings.

package/dist/bridge/appearance.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Background color values used before the NDS token scope mounts.
+ *
+ * The light value matches NDS's semantic `--bg-base` token in light mode
+ * (`--gray-0`, white). The dark value is the existing SDK fallback canvas
+ * color; it is not an exact current generated NDS value. Current NDS maps
+ * dark `--bg-base` to `--gray-145` (approximately `#1b1b1b`), while the
+ * legacy notion-next gray surface is `rgba(32, 32, 32, 1)`.
+ *
+ * Keep the resolved values here because the document must be styled before the block's NDS
+ * stylesheet and token scope are guaranteed to be available.
+ */
+export declare const NOTION_DARK_BACKGROUND_BASE = "#191918";
+export declare const NOTION_LIGHT_BACKGROUND_BASE = "#ffffff";
+//# sourceMappingURL=appearance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/appearance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,YAAY,CAAA;AACpD,eAAO,MAAM,4BAA4B,YAAY,CAAA"}

package/dist/bridge/appearance.js

@@ -0,0 +1,14 @@
+/**
+ * Background color values used before the NDS token scope mounts.
+ *
+ * The light value matches NDS's semantic `--bg-base` token in light mode
+ * (`--gray-0`, white). The dark value is the existing SDK fallback canvas
+ * color; it is not an exact current generated NDS value. Current NDS maps
+ * dark `--bg-base` to `--gray-145` (approximately `#1b1b1b`), while the
+ * legacy notion-next gray surface is `rgba(32, 32, 32, 1)`.
+ *
+ * Keep the resolved values here because the document must be styled before the block's NDS
+ * stylesheet and token scope are guaranteed to be available.
+ */
+export const NOTION_DARK_BACKGROUND_BASE = "#191918";
+export const NOTION_LIGHT_BACKGROUND_BASE = "#ffffff";

package/dist/bridge/hostState.d.ts

@@ -9,7 +9,7 @@ import type { CustomBlockPage, NotionPageId } from "../protocol/pages/page.js";
 import type { NotionParent } from "../protocol/parent.js";
 import type { NotionTheme } from "../protocol/theme.js";
 import type { NotionUser } from "../protocol/users/user.js";
-import type { NotionDataSourcePage, NotionDataSourcePageUpdateArgs, NotionDataSourcePageUpdateResult } from "../types.js";
+import type { NotionDataSourcePage, NotionDataSourcePageUpdateArgs, UpdatePageResult } from "../types.js";
 export type CustomBlockHostState = UninitializedHostState | InitializedHostState;
 export type UninitializedHostState = {
     status: "uninitialized";
@@ -68,6 +68,6 @@ export type UpdateDataSourcePageFn = (args: {
     dataSource: NotionDataSource;
     pageId: NotionPageId;
     pageUpdateArgs: NotionDataSourcePageUpdateArgs;
-}) => Promise<NotionDataSourcePageUpdateResult>;
+}) => Promise<UpdatePageResult>;
 export declare function getDataSourceQueryView(hostState: CustomBlockHostState, key: string, updateDataSourcePage: UpdateDataSourcePageFn): DataSourceQueryView;
 //# sourceMappingURL=hostState.d.ts.map

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":"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"}
+{"version":3,"file":"hostState.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/hostState.ts"],"names":[],"mappings":"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"}

package/dist/protocol/index.d.ts

@@ -17,6 +17,7 @@ export * from "./errors.js";
 export * from "./ids.js";
 export * from "./incomingType.js";
 export * from "./manifest.js";
+export * from "./messagePayload.js";
 export * from "./messages/connect.js";
 export * from "./messages/contrastModeChanged.js";
 export * from "./messages/createPage.js";

package/dist/protocol/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/protocol/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,mCAAmC,CAAA;AACjD,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kCAAkC,CAAA;AAChD,cAAc,qCAAqC,CAAA;AACnD,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,qCAAqC,CAAA;AACnD,cAAc,sBAAsB,CAAA;AACpC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/protocol/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mCAAmC,CAAA;AACjD,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kCAAkC,CAAA;AAChD,cAAc,qCAAqC,CAAA;AACnD,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,qCAAqC,CAAA;AACnD,cAAc,sBAAsB,CAAA;AACpC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/dist/protocol/index.js

@@ -17,6 +17,7 @@ export * from "./errors.js";
 export * from "./ids.js";
 export * from "./incomingType.js";
 export * from "./manifest.js";
+export * from "./messagePayload.js";
 export * from "./messages/connect.js";
 export * from "./messages/contrastModeChanged.js";
 export * from "./messages/createPage.js";

package/dist/protocol/messagePayload.d.ts

@@ -0,0 +1,20 @@
+import type { CustomBlockErrorInfo } from "./errors.js";
+type WithTypedErrorInfo<T, TErrorInfo extends CustomBlockErrorInfo | undefined> = TErrorInfo extends CustomBlockErrorInfo ? T extends {
+    error: CustomBlockErrorInfo;
+} ? Omit<T, "error"> & {
+    error: TErrorInfo;
+} : T : T;
+/**
+ * Removes bridge envelope fields from every member of a message union.
+ *
+ * The conditional type makes the operation distributive, preserving
+ * success/error-specific fields such as `page` and `error`.
+ *
+ * Pass an API-specific error-info type to preserve its known error-code
+ * literals while still accepting unknown string codes at runtime.
+ */
+export type BridgeMessagePayload<T extends {
+    type: string;
+}, TErrorInfo extends CustomBlockErrorInfo | undefined = undefined> = T extends unknown ? WithTypedErrorInfo<Omit<T, "type" | "requestId" | "subscriptionId">, TErrorInfo> : never;
+export {};
+//# sourceMappingURL=messagePayload.d.ts.map

package/dist/protocol/messagePayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messagePayload.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/protocol/src/messagePayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,KAAK,kBAAkB,CACtB,CAAC,EACD,UAAU,SAAS,oBAAoB,GAAG,SAAS,IAChD,UAAU,SAAS,oBAAoB,GACxC,CAAC,SAAS;IAAE,KAAK,EAAE,oBAAoB,CAAA;CAAE,GACxC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GACxC,CAAC,GACF,CAAC,CAAA;AAEJ;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,CAC/B,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1B,UAAU,SAAS,oBAAoB,GAAG,SAAS,GAAG,SAAS,IAC5D,CAAC,SAAS,OAAO,GAClB,kBAAkB,CAClB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,gBAAgB,CAAC,EAChD,UAAU,CACV,GACA,KAAK,CAAA"}

package/dist/protocol/messagePayload.js

@@ -0,0 +1 @@
+export {};

package/dist/types.d.ts

@@ -2,16 +2,16 @@ import type { NotionCollectionSchema } from "./protocol/dataSources/dataSource.j
 import type { NotionDataSourceValue } from "./protocol/dataSources/dataSourceValue.js";
 import type { NotionPropertySchema } from "./protocol/dataSources/propertySchema.js";
 import type { NotionDataSourceId, NotionPageId } from "./protocol/ids.js";
+import type { BridgeMessagePayload } from "./protocol/messagePayload.js";
 import type { NotionCreatePagePosition } from "./protocol/messages/createPage.js";
-import type { CustomBlockCreatePageErrorInfo } from "./protocol/messages/createPageResult.js";
-import type { CustomBlockGetPageErrorInfo } from "./protocol/messages/getPage.js";
-import type { CustomBlockGetUserErrorInfo } from "./protocol/messages/getUser.js";
-import type { CustomBlockListUsersErrorInfo, ListUsersMessage } from "./protocol/messages/listUsers.js";
+import type { CreatePageResultMessage, CustomBlockCreatePageErrorInfo } from "./protocol/messages/createPageResult.js";
+import type { CustomBlockGetPageErrorInfo, GetPageResultMessage } from "./protocol/messages/getPage.js";
+import type { CustomBlockGetUserErrorInfo, GetUserResultMessage } from "./protocol/messages/getUser.js";
+import type { CustomBlockListUsersErrorInfo, ListUsersMessage, ListUsersResultMessage } from "./protocol/messages/listUsers.js";
 import type { CustomBlockQueryDataSourceErrorInfo } from "./protocol/messages/queryDataSourceResult.js";
 import type { UpdatePageMessage } from "./protocol/messages/updatePage.js";
-import type { CustomBlockUpdatePageErrorInfo } from "./protocol/messages/updatePageResult.js";
-import type { NotionPage, NotionPageCover, NotionPageIcon, NotionPagePropertyValue } from "./protocol/pages/page.js";
-import type { NotionUser, NotionUserList } from "./protocol/users/user.js";
+import type { CustomBlockUpdatePageErrorInfo, UpdatePageResultMessage } from "./protocol/messages/updatePageResult.js";
+import type { NotionPageCover, NotionPageIcon, NotionPagePropertyValue } from "./protocol/pages/page.js";
 export type { CustomBlockErrorInfo } from "./protocol/errors.js";
 export type { NotionDataSourceId, NotionPageId, NotionSpaceId, } from "./protocol/ids.js";
 export type { NotionUser, NotionUserId, NotionUserList, } from "./protocol/users/user.js";
@@ -55,7 +55,7 @@ export type NotionDataSourcePage = {
      * Updates this page using the data source's property-key bindings. The SDK resolves property
      * keys to raw property IDs before sending the bridge message to the host.
      */
-    update: (args: NotionDataSourcePageUpdateArgs) => Promise<NotionDataSourcePageUpdateResult>;
+    update: (args: NotionDataSourcePageUpdateArgs) => Promise<UpdatePageResult>;
 };
 export type NotionDataSourcePageUpdateArgs = {
     properties?: NotionPagePropertyInputMap;
@@ -69,13 +69,12 @@ export type NotionDataSourcePageUpdateArgs = {
  * TODO(custom-blocks): Remove this alias when bumping the SDK version to 0.2.0.
  */
 export type NotionDataSourcePageUpdateInput = NotionDataSourcePageUpdateArgs;
-export type NotionDataSourcePageUpdateResult = {
-    status: "success";
-    page: NotionPage;
-} | {
-    status: "error";
-    error: CustomBlockUpdatePageErrorInfo;
-};
+/**
+ * @deprecated Use `UpdatePageResult` instead.
+ *
+ * TODO(custom-blocks): Remove this alias when bumping the SDK version to 0.2.0.
+ */
+export type NotionDataSourcePageUpdateResult = UpdatePageResult;
 /**
  * Return shape of `useDataSource`.
  *
@@ -162,14 +161,7 @@ export type CreatePageInput = CreatePageArgs;
 /**
  * The result of a `sdk.pages.create` API call.
  */
-export type CreatePageResult = {
-    status: "success";
-    /** The newly created page. */
-    page: NotionPage;
-} | {
-    status: "error";
-    error: CustomBlockCreatePageErrorInfo;
-};
+export type CreatePageResult = BridgeMessagePayload<CreatePageResultMessage, CustomBlockCreatePageErrorInfo>;
 export type UpdatePageArgs = Omit<UpdatePageMessage, "type" | "requestId">;
 /**
  * @deprecated Use `UpdatePageArgs` instead.
@@ -180,23 +172,11 @@ export type UpdatePageInput = UpdatePageArgs;
 /**
  * Result of `sdk.pages.get`.
  */
-export type GetPageResult = {
-    status: "success";
-    page: NotionPage;
-} | {
-    status: "error";
-    error: CustomBlockGetPageErrorInfo;
-};
+export type GetPageResult = BridgeMessagePayload<GetPageResultMessage, CustomBlockGetPageErrorInfo>;
 /**
  * Result of `sdk.pages.update` / `sdk.pages.delete`.
  */
-export type UpdatePageResult = {
-    status: "success";
-    page: NotionPage;
-} | {
-    status: "error";
-    error: CustomBlockUpdatePageErrorInfo;
-};
+export type UpdatePageResult = BridgeMessagePayload<UpdatePageResultMessage, CustomBlockUpdatePageErrorInfo>;
 export type ListUsersArgs = Omit<ListUsersMessage, "type" | "requestId">;
 /**
  * @deprecated Use `ListUsersArgs` instead.
@@ -204,18 +184,6 @@ export type ListUsersArgs = Omit<ListUsersMessage, "type" | "requestId">;
  * TODO(custom-blocks): Remove this alias when bumping the SDK version to 0.2.0.
  */
 export type ListUsersInput = ListUsersArgs;
-export type ListUsersResult = {
-    status: "success";
-    list: NotionUserList;
-} | {
-    status: "error";
-    error: CustomBlockListUsersErrorInfo;
-};
-export type GetUserResult = {
-    status: "success";
-    user: NotionUser;
-} | {
-    status: "error";
-    error: CustomBlockGetUserErrorInfo;
-};
+export type ListUsersResult = BridgeMessagePayload<ListUsersResultMessage, CustomBlockListUsersErrorInfo>;
+export type GetUserResult = BridgeMessagePayload<GetUserResultMessage, CustomBlockGetUserErrorInfo>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/types.ts"],"names":[],"mappings":"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"}

package/dist/version.js

@@ -4,4 +4,4 @@
  *
  * WARNING: Generated during SDK publish. Do not edit in the published package.
  */
-export const CUSTOM_BLOCKS_SDK_VERSION = "0.1.18"
+export const CUSTOM_BLOCKS_SDK_VERSION = "0.1.20"

package/docs/data-sources.md

@@ -158,8 +158,9 @@ export function ScoreList() {
 - `NotionDataSource` — a resolved data source: semantic key, `collectionSchema`, `propertyIdsByKey`, `propertySchemasById`.
 - `NotionDataSourcePage` — a single row exposed to app code: `{ id, propertiesById, propertiesByKey, update }`.
 - `NotionDataSourceValue` — the discriminated union of values that can appear inside `propertiesById[propertyId]`. Date values branch into the `NotionDateValue` union below.
-- `NotionDataSourcePageUpdateArgs` / `NotionDataSourcePageUpdateResult` — arguments and result for the per-page `update` helper.
+- `NotionDataSourcePageUpdateArgs` / `UpdatePageResult` — arguments and result for the per-page `update` helper.
 - `NotionDataSourcePageUpdateInput` — deprecated alias for `NotionDataSourcePageUpdateArgs`.
+- `NotionDataSourcePageUpdateResult` — deprecated alias for `UpdatePageResult`.
 - `UseDataSourceOptions` — options accepted by `useDataSource`, currently `{ limit?: number }`.
 
 ### Property schemas

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@notionhq/custom-blocks",
-	"version": "0.1.18",
+	"version": "0.1.20",
 	"license": "MIT",
 	"type": "module",
 	"publishConfig": {

package/src/bridge/SandboxBridge.ts

@@ -1,3 +1,4 @@
+import type { NotionContrastMode } from "@notionhq/custom-blocks-protocol/contrast.js"
 import { DEFAULT_CONTRAST_MODE } from "@notionhq/custom-blocks-protocol/contrast.js"
 import type {
 	NotionDataSource,
@@ -29,6 +30,7 @@ import type { CustomBlockQueryDataSourceErrorInfo } from "@notionhq/custom-block
 import type { ResizeMessage } from "@notionhq/custom-blocks-protocol/messages/resize.js"
 import type { UpdatePageMessage } from "@notionhq/custom-blocks-protocol/messages/updatePage.js"
 import { CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION } from "@notionhq/custom-blocks-protocol/protocolVersion.js"
+import type { NotionTheme } from "@notionhq/custom-blocks-protocol/theme.js"
 import type { NotionUser } from "@notionhq/custom-blocks-protocol/users/user.js"
 import * as v from "valibot"
 import type {
@@ -39,7 +41,6 @@ import type {
 	ListUsersArgs,
 	ListUsersResult,
 	NotionDataSourcePageUpdateArgs,
-	NotionDataSourcePageUpdateResult,
 	NotionPageId,
 	NotionUserId,
 	UpdatePageArgs,
@@ -48,6 +49,10 @@ import type {
 } from "../types.js"
 import { unreachable } from "../utils.js"
 import { CUSTOM_BLOCKS_SDK_VERSION } from "../version.js"
+import {
+	NOTION_DARK_BACKGROUND_BASE,
+	NOTION_LIGHT_BACKGROUND_BASE,
+} from "./appearance.js"
 import { resolveDataSources } from "./dataSources/resolve.js"
 import { resolvePropertyWriteMapForDataSource } from "./dataSources/resolveProperty.js"
 import {
@@ -291,6 +296,10 @@ export class SandboxBridge {
 					...hostState,
 					theme: message.theme,
 				}
+				syncDocumentAppearance({
+					theme: message.theme,
+					contrastMode: hostState.contrastMode,
+				})
 				this.notify()
 				return
 			}
@@ -300,6 +309,10 @@ export class SandboxBridge {
 					...hostState,
 					contrastMode: message.contrastMode,
 				}
+				syncDocumentAppearance({
+					theme: hostState.theme,
+					contrastMode: message.contrastMode,
+				})
 				this.notify()
 				return
 			}
@@ -550,6 +563,10 @@ export class SandboxBridge {
 			dataSources,
 			dataSourceState: {},
 		}
+		syncDocumentAppearance({
+			theme: message.theme,
+			contrastMode: message.contrastMode,
+		})
 		this.notify()
 		if (postResult) {
 			const result: InitResultMessage = {
@@ -789,7 +806,7 @@ export class SandboxBridge {
 		dataSource: NotionDataSource
 		pageId: NotionPageId
 		pageUpdateArgs: NotionDataSourcePageUpdateArgs
-	}): Promise<NotionDataSourcePageUpdateResult> {
+	}): Promise<UpdatePageResult> {
 		const { dataSource, pageId, pageUpdateArgs } = args
 		const resolvedProperties =
 			pageUpdateArgs.properties === undefined
@@ -885,6 +902,31 @@ export class SandboxBridge {
 	}
 }
 
+/**
+ * Makes the document canvas match the host appearance before acknowledging init.
+ *
+ * The host reveals the iframe as soon as it receives `initResult.success`. Applying these
+ * attributes synchronously prevents the browser's default white canvas from flashing while React
+ * mounts a token scope.
+ */
+function syncDocumentAppearance(args: {
+	theme: NotionTheme
+	contrastMode: NotionContrastMode
+}): void {
+	if (typeof document === "undefined") {
+		return
+	}
+	const { theme, contrastMode } = args
+	const root = document.documentElement
+	root.dataset.displayMode = theme
+	root.dataset.contrastMode = contrastMode
+	root.style.colorScheme = theme
+	root.style.backgroundColor =
+		theme === "dark"
+			? NOTION_DARK_BACKGROUND_BASE
+			: NOTION_LIGHT_BACKGROUND_BASE
+}
+
 /**
  * `postMessage` cloning creates new objects even for bindings that did not change.
  * Preserve their resolved object identity so React effects only run for changed bindings.

package/src/bridge/appearance.ts

@@ -0,0 +1,14 @@
+/**
+ * Background color values used before the NDS token scope mounts.
+ *
+ * The light value matches NDS's semantic `--bg-base` token in light mode
+ * (`--gray-0`, white). The dark value is the existing SDK fallback canvas
+ * color; it is not an exact current generated NDS value. Current NDS maps
+ * dark `--bg-base` to `--gray-145` (approximately `#1b1b1b`), while the
+ * legacy notion-next gray surface is `rgba(32, 32, 32, 1)`.
+ *
+ * Keep the resolved values here because the document must be styled before the block's NDS
+ * stylesheet and token scope are guaranteed to be available.
+ */
+export const NOTION_DARK_BACKGROUND_BASE = "#191918"
+export const NOTION_LIGHT_BACKGROUND_BASE = "#ffffff"

package/src/bridge/hostState.ts

@@ -16,7 +16,7 @@ import type { NotionUser } from "@notionhq/custom-blocks-protocol/users/user.js"
 import type {
 	NotionDataSourcePage,
 	NotionDataSourcePageUpdateArgs,
-	NotionDataSourcePageUpdateResult,
+	UpdatePageResult,
 } from "../types.js"
 
 export type CustomBlockHostState = UninitializedHostState | InitializedHostState
@@ -92,7 +92,7 @@ export type UpdateDataSourcePageFn = (args: {
 	dataSource: NotionDataSource
 	pageId: NotionPageId
 	pageUpdateArgs: NotionDataSourcePageUpdateArgs
-}) => Promise<NotionDataSourcePageUpdateResult>
+}) => Promise<UpdatePageResult>
 
 export function getDataSourceQueryView(
 	hostState: CustomBlockHostState,

package/src/types.ts

@@ -5,27 +5,36 @@ import type {
 	NotionDataSourceId,
 	NotionPageId,
 } from "@notionhq/custom-blocks-protocol/ids.js"
+import type { BridgeMessagePayload } from "@notionhq/custom-blocks-protocol/messagePayload.js"
 import type { NotionCreatePagePosition } from "@notionhq/custom-blocks-protocol/messages/createPage.js"
-import type { CustomBlockCreatePageErrorInfo } from "@notionhq/custom-blocks-protocol/messages/createPageResult.js"
-import type { CustomBlockGetPageErrorInfo } from "@notionhq/custom-blocks-protocol/messages/getPage.js"
-import type { CustomBlockGetUserErrorInfo } from "@notionhq/custom-blocks-protocol/messages/getUser.js"
+import type {
+	CreatePageResultMessage,
+	CustomBlockCreatePageErrorInfo,
+} from "@notionhq/custom-blocks-protocol/messages/createPageResult.js"
+import type {
+	CustomBlockGetPageErrorInfo,
+	GetPageResultMessage,
+} from "@notionhq/custom-blocks-protocol/messages/getPage.js"
+import type {
+	CustomBlockGetUserErrorInfo,
+	GetUserResultMessage,
+} from "@notionhq/custom-blocks-protocol/messages/getUser.js"
 import type {
 	CustomBlockListUsersErrorInfo,
 	ListUsersMessage,
+	ListUsersResultMessage,
 } from "@notionhq/custom-blocks-protocol/messages/listUsers.js"
 import type { CustomBlockQueryDataSourceErrorInfo } from "@notionhq/custom-blocks-protocol/messages/queryDataSourceResult.js"
 import type { UpdatePageMessage } from "@notionhq/custom-blocks-protocol/messages/updatePage.js"
-import type { CustomBlockUpdatePageErrorInfo } from "@notionhq/custom-blocks-protocol/messages/updatePageResult.js"
 import type {
-	NotionPage,
+	CustomBlockUpdatePageErrorInfo,
+	UpdatePageResultMessage,
+} from "@notionhq/custom-blocks-protocol/messages/updatePageResult.js"
+import type {
 	NotionPageCover,
 	NotionPageIcon,
 	NotionPagePropertyValue,
 } from "@notionhq/custom-blocks-protocol/pages/page.js"
-import type {
-	NotionUser,
-	NotionUserList,
-} from "@notionhq/custom-blocks-protocol/users/user.js"
 
 export type { CustomBlockErrorInfo } from "@notionhq/custom-blocks-protocol/errors.js"
 export type {
@@ -84,9 +93,7 @@ export type NotionDataSourcePage = {
 	 * Updates this page using the data source's property-key bindings. The SDK resolves property
 	 * keys to raw property IDs before sending the bridge message to the host.
 	 */
-	update: (
-		args: NotionDataSourcePageUpdateArgs,
-	) => Promise<NotionDataSourcePageUpdateResult>
+	update: (args: NotionDataSourcePageUpdateArgs) => Promise<UpdatePageResult>
 }
 
 export type NotionDataSourcePageUpdateArgs = {
@@ -103,12 +110,12 @@ export type NotionDataSourcePageUpdateArgs = {
  */
 export type NotionDataSourcePageUpdateInput = NotionDataSourcePageUpdateArgs
 
-export type NotionDataSourcePageUpdateResult =
-	| {
-			status: "success"
-			page: NotionPage
-	  }
-	| { status: "error"; error: CustomBlockUpdatePageErrorInfo }
+/**
+ * @deprecated Use `UpdatePageResult` instead.
+ *
+ * TODO(custom-blocks): Remove this alias when bumping the SDK version to 0.2.0.
+ */
+export type NotionDataSourcePageUpdateResult = UpdatePageResult
 
 /**
  * Return shape of `useDataSource`.
@@ -190,13 +197,10 @@ export type CreatePageInput = CreatePageArgs
 /**
  * The result of a `sdk.pages.create` API call.
  */
-export type CreatePageResult =
-	| {
-			status: "success"
-			/** The newly created page. */
-			page: NotionPage
-	  }
-	| { status: "error"; error: CustomBlockCreatePageErrorInfo }
+export type CreatePageResult = BridgeMessagePayload<
+	CreatePageResultMessage,
+	CustomBlockCreatePageErrorInfo
+>
 
 export type UpdatePageArgs = Omit<UpdatePageMessage, "type" | "requestId">
 
@@ -210,22 +214,18 @@ export type UpdatePageInput = UpdatePageArgs
 /**
  * Result of `sdk.pages.get`.
  */
-export type GetPageResult =
-	| {
-			status: "success"
-			page: NotionPage
-	  }
-	| { status: "error"; error: CustomBlockGetPageErrorInfo }
+export type GetPageResult = BridgeMessagePayload<
+	GetPageResultMessage,
+	CustomBlockGetPageErrorInfo
+>
 
 /**
  * Result of `sdk.pages.update` / `sdk.pages.delete`.
  */
-export type UpdatePageResult =
-	| {
-			status: "success"
-			page: NotionPage
-	  }
-	| { status: "error"; error: CustomBlockUpdatePageErrorInfo }
+export type UpdatePageResult = BridgeMessagePayload<
+	UpdatePageResultMessage,
+	CustomBlockUpdatePageErrorInfo
+>
 
 export type ListUsersArgs = Omit<ListUsersMessage, "type" | "requestId">
 
@@ -236,16 +236,12 @@ export type ListUsersArgs = Omit<ListUsersMessage, "type" | "requestId">
  */
 export type ListUsersInput = ListUsersArgs
 
-export type ListUsersResult =
-	| {
-			status: "success"
-			list: NotionUserList
-	  }
-	| { status: "error"; error: CustomBlockListUsersErrorInfo }
-
-export type GetUserResult =
-	| {
-			status: "success"
-			user: NotionUser
-	  }
-	| { status: "error"; error: CustomBlockGetUserErrorInfo }
+export type ListUsersResult = BridgeMessagePayload<
+	ListUsersResultMessage,
+	CustomBlockListUsersErrorInfo
+>
+
+export type GetUserResult = BridgeMessagePayload<
+	GetUserResultMessage,
+	CustomBlockGetUserErrorInfo
+>