@notionhq/custom-blocks 0.0.63 → 0.0.64

package/README.md

@@ -3,9 +3,9 @@
 > [!NOTE]
 > Nothing to see here. This is **extreme** alpha and currently only works for an unreleased product.
 
-SDK for building Notion custom view blocks.
+SDK for building Notion custom blocks.
 
-A custom view runs as a sandboxed `<iframe>` inside a Notion block on iOS, Android, and desktop. The only channel between your view and Notion is a `postMessage` bridge — this SDK wraps it in typed React hooks plus a small framework-neutral runtime API for non-React renderers.
+A custom block runs as a sandboxed `<iframe>` inside a Notion block on iOS, Android, and desktop. The only channel between your block and Notion is a `postMessage` bridge — this SDK wraps it in typed React hooks plus a small framework-neutral runtime API for non-React renderers.
 
 > **Pre-release.** Breaking changes may land at any time before 1.0.
 

package/bin/cli/create.js

@@ -69,7 +69,7 @@ function createCustomBlock(pageId) {
  *
  * - No `--parent`  → create a private page, then a block under it.
  * - Page `--parent` → create a block under that page.
- * - Database/data source `--parent` → a custom *view* under a collection. The
+ * - Database/data source `--parent` → a custom block as a collection view. The
  *   public API has no `custom` view type and the parent-nesting the backend
  *   uses isn't derivable from this repo, so we error rather than guess.
  */
@@ -82,8 +82,8 @@ export function create(options) {
         const parentUuid = formatUuid(extractId(options.parent));
         const kind = classifyParent(parentUuid);
         if (kind === "database" || kind === "data_source") {
-            console.error(`Error: --parent ${parentUuid} is a ${kind.replace("_", " ")}. Creating a custom view under a collection isn't supported yet.\n`);
-            console.error("  The public API has no `custom` view type; the backend does the parent nesting. Create the view in Notion, then run `ncblock attach <block-id-or-url>`.");
+            console.error(`Error: --parent ${parentUuid} is a ${kind.replace("_", " ")}. Creating a custom block as a collection view isn't supported yet.\n`);
+            console.error("  The public API has no `custom` view type; the backend does the parent nesting. Create the custom block in Notion, then run `ncblock attach <block-id-or-url>`.");
             process.exit(1);
         }
         pageId = parentUuid;

package/dist/bridge/SandboxBridge.js

@@ -1,6 +1,6 @@
 import * as v from "valibot";
 import { unreachable } from "../utils.js";
-import { NCBLOCK_SDK_VERSION } from "../version.js";
+import { CUSTOM_BLOCKS_SDK_VERSION } from "../version.js";
 import { resolveDataSources } from "./dataSources/resolve.js";
 import { resolvePropertyWriteMapForDataSource } from "./dataSources/resolveProperty.js";
 import { createEmptyDataSourceQueryState, } from "./hostState.js";
@@ -43,7 +43,7 @@ export class SandboxBridge {
             }
         };
         this.handleMessage = (event) => {
-            console.debug("[notion-custom-sdk] incoming postMessage", {
+            console.debug("[custom-blocks-sdk] incoming postMessage", {
                 data: event.data,
                 fromParent: event.source === window.parent,
             });
@@ -53,7 +53,7 @@ export class SandboxBridge {
             this.logMessage("received", event.data);
             const parsed = v.safeParse(hostToSandboxMessageSchema, event.data);
             if (!parsed.success) {
-                console.warn("[notion-custom-sdk] ignoring malformed host message", parsed.issues);
+                console.warn("[custom-blocks-sdk] ignoring malformed host message", parsed.issues);
                 const incomingType = readIncomingType(event.data);
                 // Loop guard: never NACK a NACK. Excludes both directions —
                 // `invalidSandboxMessage` is what the host normally sends, but
@@ -75,7 +75,7 @@ export class SandboxBridge {
             // visibility and stop. We don't retry as the sandbox can't recover from a host-side parse
             // failure on its own.
             if (message.type === "invalidSandboxMessage") {
-                console.warn("[notion-custom-sdk] host reported invalid sandbox message:", message.reason);
+                console.warn("[custom-blocks-sdk] host reported invalid sandbox message:", message.reason);
                 return;
             }
             // `init` is the only message valid before initialization. Handle it up
@@ -88,7 +88,7 @@ export class SandboxBridge {
             // below. Reading `this.hostState` repeatedly would re-widen it.
             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;
             }
             switch (message.type) {
@@ -157,7 +157,7 @@ export class SandboxBridge {
                         ? { status: "success", page: message.page }
                         : { status: "error", error: message.error };
                     if (!this.pendingCreatePage.resolve(message.requestId, result)) {
-                        console.warn(`[notion-custom-sdk] createPageResult for unknown requestId ${message.requestId}`);
+                        console.warn(`[custom-blocks-sdk] createPageResult for unknown requestId ${message.requestId}`);
                     }
                     return;
                 }
@@ -166,7 +166,7 @@ export class SandboxBridge {
                         ? { status: "success", page: message.page }
                         : { status: "error", error: message.error };
                     if (!this.pendingGetPage.resolve(message.requestId, result)) {
-                        console.warn(`[notion-custom-sdk] getPageResult for unknown requestId ${message.requestId}`);
+                        console.warn(`[custom-blocks-sdk] getPageResult for unknown requestId ${message.requestId}`);
                     }
                     return;
                 }
@@ -175,7 +175,7 @@ export class SandboxBridge {
                         ? { status: "success", user: message.user }
                         : { status: "error", error: message.error };
                     if (!this.pendingGetUser.resolve(message.requestId, result)) {
-                        console.warn(`[notion-custom-sdk] getUserResult for unknown requestId ${message.requestId}`);
+                        console.warn(`[custom-blocks-sdk] getUserResult for unknown requestId ${message.requestId}`);
                     }
                     return;
                 }
@@ -184,7 +184,7 @@ export class SandboxBridge {
                         ? { status: "success", list: message.list }
                         : { status: "error", error: message.error };
                     if (!this.pendingListUsers.resolve(message.requestId, result)) {
-                        console.warn(`[notion-custom-sdk] listUsersResult for unknown requestId ${message.requestId}`);
+                        console.warn(`[custom-blocks-sdk] listUsersResult for unknown requestId ${message.requestId}`);
                     }
                     return;
                 }
@@ -193,7 +193,7 @@ export class SandboxBridge {
                         ? { status: "success", page: message.page }
                         : { status: "error", error: message.error };
                     if (!this.pendingUpdatePage.resolve(message.requestId, result)) {
-                        console.warn(`[notion-custom-sdk] updatePageResult for unknown requestId ${message.requestId}`);
+                        console.warn(`[custom-blocks-sdk] updatePageResult for unknown requestId ${message.requestId}`);
                     }
                     return;
                 }
@@ -300,7 +300,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;
@@ -311,20 +311,20 @@ 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);
     }
     postToHost(message) {
-        console.debug("[notion-custom-sdk] outbound postMessage", message);
+        console.debug("[custom-blocks-sdk] outbound postMessage", message);
         this.logMessage("sent", message);
         window.parent.postMessage(message, "*");
     }
@@ -361,7 +361,7 @@ export class SandboxBridge {
             // because not every consumer renders the error UI, and we want the failure visible in
             // 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}`);
+            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.resolveInit = undefined;
@@ -705,11 +705,11 @@ function resolveDataSourceQueryLimit(limit) {
         return DEFAULT_DATA_SOURCE_QUERY_LIMIT;
     }
     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}.`);
+        console.warn(`[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}.`);
+        console.warn(`[custom-blocks-sdk] useDataSource limit is capped at ${MAX_DATA_SOURCE_QUERY_LIMIT}.`);
         return MAX_DATA_SOURCE_QUERY_LIMIT;
     }
     return limit;

package/dist/bridge/loadManifest.js

@@ -18,7 +18,7 @@ export const customBlockReadyErrorSchema = v.object({
 export async function loadManifest() {
     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 },
@@ -30,7 +30,7 @@ export async function loadManifest() {
     }
     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 },
@@ -38,12 +38,12 @@ export async function loadManifest() {
     }
     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 },
@@ -55,13 +55,13 @@ export async function loadManifest() {
     }
     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/dist/init.js

@@ -56,7 +56,7 @@ export function initCustomBlock(opts = {}) {
                 throw error;
             }
             if (message.status === "error") {
-                console.error(`[notion-custom-sdk] host reported init error (${message.error.code}): ${message.error.message}`);
+                console.error(`[custom-blocks-sdk] host reported init error (${message.error.code}): ${message.error.message}`);
                 throw new CustomBlockInitError(message.error);
             }
             const hostState = customBlockHost.getState();

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/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.63"
+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()

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.63",
+	"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/init.ts

@@ -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)
 			}

package/src/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/src/react/NotionCustomBlock.tsx

@@ -80,7 +80,7 @@ export function NotionCustomBlock({
 		if (!isStandalone) {
 			return
 		}
-		console.warn(`[notion-custom-sdk] ${init.error?.message}`)
+		console.warn(`[custom-blocks-sdk] ${init.error?.message}`)
 		seedStandalonePreviewState()
 	}, [isStandalone, init.error])
 
@@ -107,7 +107,7 @@ export function NotionCustomBlock({
 		}
 		return (
 			<>
-				<div role="status" className="ncblock-standalone-banner">
+				<div role="status" className="custom-blocks-standalone-banner">
 					Notion host not detected — running in standalone preview. SDK hooks
 					return placeholder values until embedded in Notion.
 				</div>
@@ -125,25 +125,29 @@ export function NotionCustomBlock({
 function DefaultInitErrorFallback({ error }: { error: Error }) {
 	useEffect(() => {
 		console.warn(
-			`[notion-custom-sdk] Custom block init failed: ${error.message}`,
+			`[custom-blocks-sdk] Custom block init failed: ${error.message}`,
 		)
 	}, [error])
 
 	return (
-		<div role="alert" className="ncblock-default-init-error">
-			<div className="ncblock-default-init-error__card">
-				<div className="ncblock-default-init-error__eyebrow">Custom block</div>
-				<h2 className="ncblock-default-init-error__title">
+		<div role="alert" className="custom-blocks-default-init-error">
+			<div className="custom-blocks-default-init-error__card">
+				<div className="custom-blocks-default-init-error__eyebrow">
+					Custom block
+				</div>
+				<h2 className="custom-blocks-default-init-error__title">
 					Couldn&apos;t connect to Notion
 				</h2>
-				<p className="ncblock-default-init-error__body">
+				<p className="custom-blocks-default-init-error__body">
 					This custom block loaded, but the setup handshake didn&apos;t finish.
 					Try again from Notion. If this keeps happening, check the browser
 					console for SDK details.
 				</p>
-				<details className="ncblock-default-init-error__details">
+				<details className="custom-blocks-default-init-error__details">
 					<summary>Developer details</summary>
-					<pre className="ncblock-default-init-error__pre">{error.message}</pre>
+					<pre className="custom-blocks-default-init-error__pre">
+						{error.message}
+					</pre>
 				</details>
 			</div>
 		</div>

package/src/utils.ts

@@ -8,6 +8,6 @@
  */
 export function unreachable(value: never): never {
 	throw new Error(
-		`[notion-custom-sdk] Unexpected value encountered: ${JSON.stringify(value)}`,
+		`[custom-blocks-sdk] Unexpected value encountered: ${JSON.stringify(value)}`,
 	)
 }

package/src/version.ts

@@ -5,4 +5,4 @@
  * 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 const NCBLOCK_SDK_VERSION: string = "0.0.0"
+export const CUSTOM_BLOCKS_SDK_VERSION: string = "0.0.0"