@notionhq/custom-blocks 0.0.62 → 0.0.64

package/dist/react/NotionCustomBlock.css

@@ -1,27 +1,27 @@
-.ncblock-standalone-banner {
-	--ncblock-standalone-banner-background: #fff8e1;
-	--ncblock-standalone-banner-border: #f0d77b;
-	--ncblock-standalone-banner-text: #5d4200;
+.custom-blocks-standalone-banner {
+	--custom-blocks-standalone-banner-background: #fff8e1;
+	--custom-blocks-standalone-banner-border: #f0d77b;
+	--custom-blocks-standalone-banner-text: #5d4200;
 
 	padding: 8px 12px;
-	background: var(--ncblock-standalone-banner-background);
-	color: var(--ncblock-standalone-banner-text);
-	border-bottom: 1px solid var(--ncblock-standalone-banner-border);
+	background: var(--custom-blocks-standalone-banner-background);
+	color: var(--custom-blocks-standalone-banner-text);
+	border-bottom: 1px solid var(--custom-blocks-standalone-banner-border);
 	font-size: 13px;
 	font-family: system-ui, sans-serif;
 	line-height: 1.4;
 }
 
-.ncblock-default-init-error {
-	--ncblock-init-error-background: #f7f7f5;
-	--ncblock-init-error-card-background: #ffffff;
-	--ncblock-init-error-border: #e5e5e1;
-	--ncblock-init-error-text: #1f1f1d;
-	--ncblock-init-error-muted-text: #5f5e5b;
-	--ncblock-init-error-eyebrow-text: #787774;
-	--ncblock-init-error-pre-background: #f1f1ef;
-	--ncblock-init-error-pre-text: #37352f;
-	--ncblock-init-error-shadow: rgba(0, 0, 0, 0.08);
+.custom-blocks-default-init-error {
+	--custom-blocks-init-error-background: #f7f7f5;
+	--custom-blocks-init-error-card-background: #ffffff;
+	--custom-blocks-init-error-border: #e5e5e1;
+	--custom-blocks-init-error-text: #1f1f1d;
+	--custom-blocks-init-error-muted-text: #5f5e5b;
+	--custom-blocks-init-error-eyebrow-text: #787774;
+	--custom-blocks-init-error-pre-background: #f1f1ef;
+	--custom-blocks-init-error-pre-text: #37352f;
+	--custom-blocks-init-error-shadow: rgba(0, 0, 0, 0.08);
 
 	box-sizing: border-box;
 	min-height: 240px;
@@ -29,81 +29,81 @@
 	align-items: center;
 	justify-content: center;
 	padding: 24px;
-	background: var(--ncblock-init-error-background);
-	color: var(--ncblock-init-error-text);
+	background: var(--custom-blocks-init-error-background);
+	color: var(--custom-blocks-init-error-text);
 	font-family: system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
 	color-scheme: light;
 }
 
-.ncblock-default-init-error__card {
+.custom-blocks-default-init-error__card {
 	box-sizing: border-box;
 	width: 100%;
 	max-width: 420px;
 	padding: 20px;
-	border: 1px solid var(--ncblock-init-error-border);
+	border: 1px solid var(--custom-blocks-init-error-border);
 	border-radius: 12px;
-	background: var(--ncblock-init-error-card-background);
-	box-shadow: 0 8px 24px var(--ncblock-init-error-shadow);
+	background: var(--custom-blocks-init-error-card-background);
+	box-shadow: 0 8px 24px var(--custom-blocks-init-error-shadow);
 }
 
-.ncblock-default-init-error__eyebrow {
+.custom-blocks-default-init-error__eyebrow {
 	margin-bottom: 8px;
 	font-size: 11px;
 	font-weight: 600;
 	letter-spacing: 0.08em;
 	text-transform: uppercase;
-	color: var(--ncblock-init-error-eyebrow-text);
+	color: var(--custom-blocks-init-error-eyebrow-text);
 }
 
-.ncblock-default-init-error__title {
+.custom-blocks-default-init-error__title {
 	margin: 0;
 	font-size: 18px;
 	line-height: 1.3;
 	font-weight: 650;
 }
 
-.ncblock-default-init-error__body {
+.custom-blocks-default-init-error__body {
 	margin: 8px 0 0;
 	font-size: 14px;
 	line-height: 1.5;
-	color: var(--ncblock-init-error-muted-text);
+	color: var(--custom-blocks-init-error-muted-text);
 }
 
-.ncblock-default-init-error__details {
+.custom-blocks-default-init-error__details {
 	margin-top: 14px;
 	font-size: 12px;
-	color: var(--ncblock-init-error-muted-text);
+	color: var(--custom-blocks-init-error-muted-text);
 }
 
-.ncblock-default-init-error__pre {
+.custom-blocks-default-init-error__pre {
 	margin: 8px 0 0;
 	padding: 10px;
 	overflow: auto;
 	border-radius: 8px;
-	background: var(--ncblock-init-error-pre-background);
-	color: var(--ncblock-init-error-pre-text);
+	background: var(--custom-blocks-init-error-pre-background);
+	color: var(--custom-blocks-init-error-pre-text);
 	font-size: 12px;
 	line-height: 1.4;
 	white-space: pre-wrap;
 }
 
 @media (prefers-color-scheme: dark) {
-	.ncblock-standalone-banner {
-		--ncblock-standalone-banner-background: #3b2f0b;
-		--ncblock-standalone-banner-border: #6f5713;
-		--ncblock-standalone-banner-text: #f5d36c;
+	.custom-blocks-standalone-banner {
+		--custom-blocks-standalone-banner-background: #3b2f0b;
+		--custom-blocks-standalone-banner-border: #6f5713;
+		--custom-blocks-standalone-banner-text: #f5d36c;
 	}
 
-	.ncblock-default-init-error {
-		--ncblock-init-error-background: #191918;
-		--ncblock-init-error-card-background: #20201f;
-		--ncblock-init-error-border: #373633;
-		--ncblock-init-error-text: #f1f1ef;
-		--ncblock-init-error-muted-text: #b9b8b3;
-		--ncblock-init-error-eyebrow-text: #9b9a97;
-		--ncblock-init-error-pre-background: #2a2a28;
-		--ncblock-init-error-pre-text: #e8e8e4;
-		--ncblock-init-error-shadow: rgba(0, 0, 0, 0.35);
+	.custom-blocks-default-init-error {
+		--custom-blocks-init-error-background: #191918;
+		--custom-blocks-init-error-card-background: #20201f;
+		--custom-blocks-init-error-border: #373633;
+		--custom-blocks-init-error-text: #f1f1ef;
+		--custom-blocks-init-error-muted-text: #b9b8b3;
+		--custom-blocks-init-error-eyebrow-text: #9b9a97;
+		--custom-blocks-init-error-pre-background: #2a2a28;
+		--custom-blocks-init-error-pre-text: #e8e8e4;
+		--custom-blocks-init-error-shadow: rgba(0, 0, 0, 0.35);
 
 		color-scheme: dark;
 	}

package/dist/react/NotionCustomBlock.js

@@ -45,7 +45,7 @@ export function NotionCustomBlock({ children, timeoutMs, fallback = null, errorF
         if (!isStandalone) {
             return;
         }
-        console.warn(`[notion-custom-sdk] ${init.error?.message}`);
+        console.warn(`[custom-blocks-sdk] ${init.error?.message}`);
         seedStandalonePreviewState();
     }, [isStandalone, init.error]);
     if (debugOpen) {
@@ -65,7 +65,7 @@ export function NotionCustomBlock({ children, timeoutMs, fallback = null, errorF
         if (host.status !== "initialized") {
             return _jsx(_Fragment, { children: fallback });
         }
-        return (_jsxs(_Fragment, { children: [_jsx("div", { role: "status", className: "ncblock-standalone-banner", children: "Notion host not detected \u2014 running in standalone preview. SDK hooks return placeholder values until embedded in Notion." }), children] }));
+        return (_jsxs(_Fragment, { children: [_jsx("div", { role: "status", className: "custom-blocks-standalone-banner", children: "Notion host not detected \u2014 running in standalone preview. SDK hooks return placeholder values until embedded in Notion." }), children] }));
     }
     if (!init.isLoaded) {
         return _jsx(_Fragment, { children: fallback });
@@ -75,7 +75,7 @@ export function NotionCustomBlock({ children, timeoutMs, fallback = null, errorF
 // TODO(custom-blocks): Align the styling of this with the host-side error states.
 function DefaultInitErrorFallback({ error }) {
     useEffect(() => {
-        console.warn(`[notion-custom-sdk] Custom block init failed: ${error.message}`);
+        console.warn(`[custom-blocks-sdk] Custom block init failed: ${error.message}`);
     }, [error]);
-    return (_jsx("div", { role: "alert", className: "ncblock-default-init-error", children: _jsxs("div", { className: "ncblock-default-init-error__card", children: [_jsx("div", { className: "ncblock-default-init-error__eyebrow", children: "Custom block" }), _jsx("h2", { className: "ncblock-default-init-error__title", children: "Couldn't connect to Notion" }), _jsx("p", { className: "ncblock-default-init-error__body", children: "This custom block loaded, but the setup handshake didn't finish. Try again from Notion. If this keeps happening, check the browser console for SDK details." }), _jsxs("details", { className: "ncblock-default-init-error__details", children: [_jsx("summary", { children: "Developer details" }), _jsx("pre", { className: "ncblock-default-init-error__pre", children: error.message })] })] }) }));
+    return (_jsx("div", { role: "alert", className: "custom-blocks-default-init-error", children: _jsxs("div", { className: "custom-blocks-default-init-error__card", children: [_jsx("div", { className: "custom-blocks-default-init-error__eyebrow", children: "Custom block" }), _jsx("h2", { className: "custom-blocks-default-init-error__title", children: "Couldn't connect to Notion" }), _jsx("p", { className: "custom-blocks-default-init-error__body", children: "This custom block loaded, but the setup handshake didn't finish. Try again from Notion. If this keeps happening, check the browser console for SDK details." }), _jsxs("details", { className: "custom-blocks-default-init-error__details", children: [_jsx("summary", { children: "Developer details" }), _jsx("pre", { className: "custom-blocks-default-init-error__pre", children: error.message })] })] }) }));
 }

package/dist/react/standalonePreview.js

@@ -10,7 +10,7 @@ export function seedStandalonePreviewState() {
         theme: "light",
         blockId: previewBlockId,
         parent: { type: "page_id", page_id: previewPageId },
-        page: { id: previewPageId },
+        page: { id: previewPageId, parent: { type: "workspace", workspace: true } },
         dataSources: { bindings: {} },
         currentUser: {
             object: "user",

package/dist/react/useCustomBlockInit.d.ts

@@ -1,5 +1,5 @@
 import { CustomBlockInitError } from "../bridge/messages/init.js";
-import { type CustomBlockInitial, type InitCustomBlockOptions, NotInIframeError } from "../init.js";
+import { type CustomBlockInitPayload, type InitCustomBlockOptions, NotInIframeError } from "../init.js";
 export type CustomBlockInitFailure = CustomBlockInitError | NotInIframeError;
 /**
  * Discriminated state returned by {@link useCustomBlockInit}.
@@ -20,7 +20,7 @@ export type UseCustomBlockInitResult = {
 } | {
     isLoaded: true;
     error: undefined;
-    initial: CustomBlockInitial;
+    initial: CustomBlockInitPayload;
 };
 /**
  * React wrapper around {@link initCustomBlock}. Kicks off the SDK ↔ host

package/dist/react/useCustomBlockInit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCustomBlockInit.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/react/useCustomBlockInit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAE3B,gBAAgB,EAChB,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG,gBAAgB,CAAA;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GACjC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GAClD;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,CAAC,EAAE,sBAAsB,GAC3B,wBAAwB,CA8B1B"}
+{"version":3,"file":"useCustomBlockInit.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/react/useCustomBlockInit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EACN,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAE3B,gBAAgB,EAChB,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG,gBAAgB,CAAA;AAE5E;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GACjC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAA;CAAE,GAClD;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,CAAA;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,CAAC,EAAE,sBAAsB,GAC3B,wBAAwB,CA8B1B"}

package/dist/utils.js

@@ -6,5 +6,5 @@
  * are covered when using discriminated unions.
  */
 export function unreachable(value) {
-    throw new Error(`[notion-custom-sdk] Unexpected value encountered: ${JSON.stringify(value)}`);
+    throw new Error(`[custom-blocks-sdk] Unexpected value encountered: ${JSON.stringify(value)}`);
 }

package/dist/version.d.ts

@@ -5,5 +5,5 @@
  * This checked-in value intentionally stays generic for local development. The SDK publish build
  * overwrites the compiled runtime module with package.json's semver before publishing.
  */
-export declare const NCBLOCK_SDK_VERSION: string;
+export declare const CUSTOM_BLOCKS_SDK_VERSION: string;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAgB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAgB,CAAA"}

package/dist/version.js

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

package/docs/block-location.md

@@ -46,7 +46,7 @@ For non-React renderers, use `customBlock.getParent()` after `initCustomBlock()`
 To identify custom blocks in agent-owned instruction content:
 
 ```tsx
-import { useParent } from "ncblock"
+import { useParent } from "@notionhq/custom-blocks"
 
 export function AgentInstructionBadge() {
   const parent = useParent()
@@ -63,12 +63,26 @@ export function AgentInstructionBadge() {
 
 Returns the nearest enclosing `page` / `collection_view_page` ancestor.
 
-Re-renders when the host sends a block location update.
+Re-renders when the host sends a block location update — including when the containing page itself moves (its `parent` changes) without the page ID changing.
 
 ```ts
-function usePage(): { id: NotionPageId };
+function usePage(): CustomBlockPage;
+
+type CustomBlockPage = {
+  id: NotionPageId;
+  parent: NotionParent; // the containing page's own parent
+};
 ```
 
+`page.parent` allows determining if the custom block is in a freestanding page or part of a database. Don't confuse it with `useParent()`, which is the custom block's own parent.
+
+```tsx
+const page = usePage();
+const isInsideDatabaseRow = page.parent.type === "data_source_id";
+```
+
+For anything beyond location — title, icon, properties — fetch the page through the pages API: `pages.get(page.id)`.
+
 For non-React renderers, use `customBlock.getPage()` after `initCustomBlock()` resolves.
 
 ### `useTheme()`

package/docs/lifecycle.md

@@ -4,7 +4,7 @@ The SDK ↔ host handshake, the React wrapper that runs it, and the auto-resize
 
 ## Handshake
 
-`initCustomBlock()` posts `ready` to `window.parent` and awaits the host's `init` (theme, block ID/parent/page ID, current user, and `dataSources: { bindings }` keyed by semantic data-source key, which the SDK resolves against the manifest). The promise resolves with the normalized initial state, captured in `CustomBlockInitial` — `await` it before mounting React so hooks always see populated state.
+`initCustomBlock()` posts `ready` to `window.parent` and awaits the host's `init` (theme, block ID/parent/page ID, current user, and `dataSources: { bindings }` keyed by semantic data-source key, which the SDK resolves against the manifest). The promise resolves with the normalized initial state, captured in `CustomBlockInitPayload` — `await` it before mounting React so hooks always see populated state.
 
 - Default `timeoutMs` is 15000; rejects with `CustomBlockInitError` code `init_timeout` if the host doesn't respond.
 - In a top-level browser tab (no parent frame), rejects with `NotInIframeError` code `not_in_iframe`. `<NotionCustomBlock>` catches this, seeds placeholders, and renders `children` behind a warning banner so dev-time previews still work.
@@ -45,7 +45,7 @@ function useCustomBlockInit(
 type UseCustomBlockInitResult =
   | { isLoaded: false; error: undefined }
   | { isLoaded: false; error: CustomBlockInitFailure }
-  | { isLoaded: true; error: undefined; initial: CustomBlockInitial };
+  | { isLoaded: true; error: undefined; initial: CustomBlockInitPayload };
 ```
 
 React wrapper around `initCustomBlock` for templates that prefer not to use top-level `await`. Multiple components calling it share the same handshake.
@@ -64,7 +64,7 @@ function Root() {
 ```ts
 function initCustomBlock(
   opts?: InitCustomBlockOptions,
-): Promise<CustomBlockInitial>;
+): Promise<CustomBlockInitPayload>;
 
 type InitCustomBlockOptions = { timeoutMs?: number };
 ```

package/docs/manifest.md

@@ -1,6 +1,6 @@
 # Manifest
 
-A custom view declares its required data sources in `custom_blocks.json` at the project root. Notion uses the manifest to know what semantic keys the block expects, what shape each property should be, and what to show when an admin is configuring the block.
+A custom block declares its required data sources in `custom_blocks.json` at the project root. Notion uses the manifest to know what semantic keys the block expects, what shape each property should be, and what to show when an admin is configuring the block.
 
 ```json
 {

package/docs/pages.md

@@ -53,7 +53,7 @@ type CreatePageParent =
   | { type: "data_source_key"; key: string };
 ```
 
-`type: "data_source_key"` is the recommended form inside a custom view. Pass the semantic key you declared in `custom_blocks.json` (e.g. `"tasks"`) and the SDK looks up the corresponding data source for you. The other two variants exist for the rarer case where you already have a raw Notion ID in hand.
+`type: "data_source_key"` is the recommended form inside a custom block. Pass the semantic key you declared in `custom_blocks.json` (e.g. `"tasks"`) and the SDK looks up the corresponding data source for you. The other two variants exist for the rarer case where you already have a raw Notion ID in hand.
 
 ### Property keys
 

package/package.json

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

package/src/bridge/SandboxBridge.ts

@@ -13,7 +13,7 @@ import type {
 	UseDataSourceOptions,
 } from "../types.js"
 import { unreachable } from "../utils.js"
-import { NCBLOCK_SDK_VERSION } from "../version.js"
+import { CUSTOM_BLOCKS_SDK_VERSION } from "../version.js"
 import type {
 	NotionDataSource,
 	NotionDataSourceBindings,
@@ -167,7 +167,7 @@ export class SandboxBridge {
 			return
 		}
 		if (this.hasSentReady) {
-			console.warn("[notion-custom-sdk] ignoring duplicate ready message")
+			console.warn("[custom-blocks-sdk] ignoring duplicate ready message")
 			return
 		}
 		const { manifest, error } = manifestResult
@@ -179,21 +179,21 @@ export class SandboxBridge {
 						type: "ready",
 						status: "error",
 						bridgeProtocolVersion: CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION,
-						sdkVersion: NCBLOCK_SDK_VERSION,
+						sdkVersion: CUSTOM_BLOCKS_SDK_VERSION,
 						error,
 					}
 				: {
 						type: "ready",
 						status: "success",
 						bridgeProtocolVersion: CUSTOM_BLOCK_BRIDGE_PROTOCOL_VERSION,
-						sdkVersion: NCBLOCK_SDK_VERSION,
+						sdkVersion: CUSTOM_BLOCKS_SDK_VERSION,
 						manifest,
 					}
 		this.postToHost(readyMessage)
 	}
 
 	private postToHost(message: unknown) {
-		console.debug("[notion-custom-sdk] outbound postMessage", message)
+		console.debug("[custom-blocks-sdk] outbound postMessage", message)
 		this.logMessage("sent", message)
 		window.parent.postMessage(message, "*")
 	}
@@ -205,7 +205,7 @@ export class SandboxBridge {
 	}
 
 	private handleMessage = (event: MessageEvent) => {
-		console.debug("[notion-custom-sdk] incoming postMessage", {
+		console.debug("[custom-blocks-sdk] incoming postMessage", {
 			data: event.data,
 			fromParent: event.source === window.parent,
 		})
@@ -217,7 +217,7 @@ export class SandboxBridge {
 		const parsed = v.safeParse(hostToSandboxMessageSchema, event.data)
 		if (!parsed.success) {
 			console.warn(
-				"[notion-custom-sdk] ignoring malformed host message",
+				"[custom-blocks-sdk] ignoring malformed host message",
 				parsed.issues,
 			)
 			const incomingType = readIncomingType(event.data)
@@ -245,7 +245,7 @@ export class SandboxBridge {
 		// failure on its own.
 		if (message.type === "invalidSandboxMessage") {
 			console.warn(
-				"[notion-custom-sdk] host reported invalid sandbox message:",
+				"[custom-blocks-sdk] host reported invalid sandbox message:",
 				message.reason,
 			)
 			return
@@ -263,7 +263,7 @@ export class SandboxBridge {
 		const hostState = this.hostState
 
 		if (hostState.status !== "initialized") {
-			console.warn(`[notion-custom-sdk] ignoring ${message.type} before init`)
+			console.warn(`[custom-blocks-sdk] ignoring ${message.type} before init`)
 			return
 		}
 
@@ -340,7 +340,7 @@ export class SandboxBridge {
 						: { status: "error", error: message.error }
 				if (!this.pendingCreatePage.resolve(message.requestId, result)) {
 					console.warn(
-						`[notion-custom-sdk] createPageResult for unknown requestId ${message.requestId}`,
+						`[custom-blocks-sdk] createPageResult for unknown requestId ${message.requestId}`,
 					)
 				}
 				return
@@ -353,7 +353,7 @@ export class SandboxBridge {
 						: { status: "error", error: message.error }
 				if (!this.pendingGetPage.resolve(message.requestId, result)) {
 					console.warn(
-						`[notion-custom-sdk] getPageResult for unknown requestId ${message.requestId}`,
+						`[custom-blocks-sdk] getPageResult for unknown requestId ${message.requestId}`,
 					)
 				}
 				return
@@ -366,7 +366,7 @@ export class SandboxBridge {
 						: { status: "error", error: message.error }
 				if (!this.pendingGetUser.resolve(message.requestId, result)) {
 					console.warn(
-						`[notion-custom-sdk] getUserResult for unknown requestId ${message.requestId}`,
+						`[custom-blocks-sdk] getUserResult for unknown requestId ${message.requestId}`,
 					)
 				}
 				return
@@ -379,7 +379,7 @@ export class SandboxBridge {
 						: { status: "error", error: message.error }
 				if (!this.pendingListUsers.resolve(message.requestId, result)) {
 					console.warn(
-						`[notion-custom-sdk] listUsersResult for unknown requestId ${message.requestId}`,
+						`[custom-blocks-sdk] listUsersResult for unknown requestId ${message.requestId}`,
 					)
 				}
 				return
@@ -392,7 +392,7 @@ export class SandboxBridge {
 						: { status: "error", error: message.error }
 				if (!this.pendingUpdatePage.resolve(message.requestId, result)) {
 					console.warn(
-						`[notion-custom-sdk] updatePageResult for unknown requestId ${message.requestId}`,
+						`[custom-blocks-sdk] updatePageResult for unknown requestId ${message.requestId}`,
 					)
 				}
 				return
@@ -492,7 +492,7 @@ export class SandboxBridge {
 			// the browser console either way. We deliberately don't NACK the host or post anything
 			// back over the bridge since the host has already given up.
 			console.error(
-				`[notion-custom-sdk] host reported init error (${message.error.code}): ${message.error.message}`,
+				`[custom-blocks-sdk] host reported init error (${message.error.code}): ${message.error.message}`,
 			)
 			if (this.rejectInit) {
 				this.rejectInit(new CustomBlockInitError(message.error))
@@ -900,13 +900,13 @@ function resolveDataSourceQueryLimit(limit: number | undefined): number {
 	}
 	if (!Number.isFinite(limit) || !Number.isInteger(limit) || limit < 1) {
 		console.warn(
-			`[notion-custom-sdk] useDataSource limit must be a positive integer; using ${DEFAULT_DATA_SOURCE_QUERY_LIMIT}.`,
+			`[custom-blocks-sdk] useDataSource limit must be a positive integer; using ${DEFAULT_DATA_SOURCE_QUERY_LIMIT}.`,
 		)
 		return DEFAULT_DATA_SOURCE_QUERY_LIMIT
 	}
 	if (limit > MAX_DATA_SOURCE_QUERY_LIMIT) {
 		console.warn(
-			`[notion-custom-sdk] useDataSource limit is capped at ${MAX_DATA_SOURCE_QUERY_LIMIT}.`,
+			`[custom-blocks-sdk] useDataSource limit is capped at ${MAX_DATA_SOURCE_QUERY_LIMIT}.`,
 		)
 		return MAX_DATA_SOURCE_QUERY_LIMIT
 	}

package/src/bridge/loadManifest.ts

@@ -41,7 +41,7 @@ export type ManifestLoadResult =
 export async function loadManifest(): Promise<ManifestLoadResult> {
 	if (typeof fetch !== "function") {
 		const message = `No fetch API available; cannot load ${MANIFEST_URL}.`
-		console.warn(`[notion-custom-sdk] ${message}`)
+		console.warn(`[custom-blocks-sdk] ${message}`)
 		return {
 			manifest: null,
 			error: { code: "manifest_unavailable", message },
@@ -52,7 +52,7 @@ export async function loadManifest(): Promise<ManifestLoadResult> {
 		response = await fetch(MANIFEST_URL, { credentials: "omit" })
 	} catch (error) {
 		const message = `Could not fetch ${MANIFEST_URL}.`
-		console.warn(`[notion-custom-sdk] ${message}`, error)
+		console.warn(`[custom-blocks-sdk] ${message}`, error)
 		return {
 			manifest: null,
 			error: { code: "manifest_unavailable", message },
@@ -60,12 +60,12 @@ export async function loadManifest(): Promise<ManifestLoadResult> {
 	}
 	if (response.status === 404) {
 		const message = `No manifest found at ${MANIFEST_URL} (status ${response.status}).`
-		console.warn(`[notion-custom-sdk] ${message}`)
+		console.warn(`[custom-blocks-sdk] ${message}`)
 		return { manifest: null }
 	}
 	if (!response.ok) {
 		const message = `Could not fetch ${MANIFEST_URL} (status ${response.status}).`
-		console.warn(`[notion-custom-sdk] ${message}`)
+		console.warn(`[custom-blocks-sdk] ${message}`)
 		return {
 			manifest: null,
 			error: { code: "manifest_unavailable", message },
@@ -76,13 +76,13 @@ export async function loadManifest(): Promise<ManifestLoadResult> {
 		json = await response.json()
 	} catch (error) {
 		const message = `Manifest at ${MANIFEST_URL} was not valid JSON.`
-		console.warn(`[notion-custom-sdk] ${message}`, error)
+		console.warn(`[custom-blocks-sdk] ${message}`, error)
 		return { manifest: null, error: { code: "manifest_invalid", message } }
 	}
 	const parsed = v.safeParse(manifestSchema, json)
 	if (!parsed.success) {
 		const message = `Manifest at ${MANIFEST_URL} did not match schema.`
-		console.warn(`[notion-custom-sdk] ${message}`, parsed.issues)
+		console.warn(`[custom-blocks-sdk] ${message}`, parsed.issues)
 		return { manifest: null, error: { code: "manifest_invalid", message } }
 	}
 	return { manifest: parsed.output }

package/src/bridge/pages/page.ts

@@ -11,8 +11,17 @@ import { notionParentSchema } from "../parent.js"
 
 export type { NotionPageId } from "../ids.js"
 
+/**
+ * The custom block's nearest enclosing page ancestor, carried in `init.page` and `pageChanged`.
+ */
 export const customBlockPageSchema = v.object({
 	id: notionPageIdSchema,
+	/**
+	 * The containing page's own parent. It lets a block distinguish a freestanding page from a
+	 * database row without a round trip. Not to be confused with the top-level `parent` runtime
+	 * value, which is the custom block's own parent.
+	 */
+	parent: notionParentSchema,
 })
 
 export type CustomBlockPage = v.InferOutput<typeof customBlockPageSchema>

package/src/index.ts

@@ -108,7 +108,7 @@ export { pages, users } from "./bridge/sandboxClient.js"
 export type { NotionTheme } from "./bridge/theme.js"
 export { type CustomBlockState, customBlock } from "./customBlock.js"
 export {
-	type CustomBlockInitial,
+	type CustomBlockInitPayload,
 	type InitCustomBlockOptions,
 	initCustomBlock,
 	NotInIframeError,

package/src/init.ts

@@ -15,7 +15,7 @@ import type { NotionUser } from "./bridge/users/user.js"
 /**
  * The payload sent by the host in the `init` message in response to the sandbox's `ready` message.
  */
-export type CustomBlockInitial = {
+export type CustomBlockInitPayload = {
 	theme: NotionTheme
 	blockId: NotionBlockId
 	parent: NotionParent
@@ -60,7 +60,7 @@ const DEFAULT_INIT_TIMEOUT_MS = 15_000
 const NOT_IN_IFRAME_MESSAGE =
 	"<NotionCustomBlock> only works inside an iframe — use the dev shell or deploy to Notion."
 
-let initPromise: Promise<CustomBlockInitial> | undefined
+let initPromise: Promise<CustomBlockInitPayload> | undefined
 
 /**
  * Performs the SDK <-> host handshake: loads `custom_blocks.json`, posts
@@ -74,7 +74,7 @@ let initPromise: Promise<CustomBlockInitial> | undefined
  */
 export function initCustomBlock(
 	opts: InitCustomBlockOptions = {},
-): Promise<CustomBlockInitial> {
+): Promise<CustomBlockInitPayload> {
 	if (initPromise === undefined) {
 		initPromise = (async () => {
 			// Fail fast with a typed error when rendered as a standalone tab and not in a parent frame.
@@ -106,7 +106,7 @@ export function initCustomBlock(
 			}
 			if (message.status === "error") {
 				console.error(
-					`[notion-custom-sdk] host reported init error (${message.error.code}): ${message.error.message}`,
+					`[custom-blocks-sdk] host reported init error (${message.error.code}): ${message.error.message}`,
 				)
 				throw new CustomBlockInitError(message.error)
 			}