@notionhq/custom-blocks 0.1.38 → 0.1.40

package/docs/pages.md

@@ -132,7 +132,7 @@ Do **not** send `{ type: "file_upload", file_upload: { id } }`; the host will re
 - `NotionPage` — the page record returned by every successful call.
 - `NotionPageId` — branded string ID for a page.
 - `NotionPageIcon` / `NotionPageCover` — icon and cover variants Notion supports.
-- `NotionParent` — a block's parent reference (`page_id` / `block_id` / `data_source_id` / `workspace`), as returned on `NotionPage.parent` and by `useParent()`.
+- `NotionParent` — a block's parent reference (`page_id` / `block_id` / `data_source_id` / `workspace` / `agent_id` / `unavailable`), as returned on `NotionPage.parent` and by `useParent()`.
 - `NotionPagePropertyValue` — a single property value as returned on a `NotionPage`.
 - `NotionPagePropertyInputValue` — a single property value as accepted by `pages.create` / `pages.update` (may omit `id` for `create`).
 - `NotionPagePropertyInputMap` — input map for `pages.create` (keys can be raw property IDs, or semantic keys when creating into a mapped data source).

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@notionhq/custom-blocks",
-	"version": "0.1.38",
+	"version": "0.1.40",
 	"license": "MIT",
 	"type": "module",
 	"publishConfig": {
@@ -47,7 +47,7 @@
 		"dist"
 	],
 	"peerDependencies": {
-		"react": "^19.2.5"
+		"react": "^19.2.8"
 	},
 	"peerDependenciesMeta": {
 		"react": {
@@ -55,17 +55,17 @@
 		}
 	},
 	"devDependencies": {
-		"@testing-library/react": "^16.3.2",
-		"@types/node": "^25.6.0",
-		"@types/react": "^19.2.14",
-		"@types/react-dom": "^19.2.3",
-		"@vitest/coverage-v8": "^4.1.11",
-		"jsdom": "^29.1.0",
-		"react": "^19.2.5",
-		"react-dom": "^19.2.5",
-		"vitest": "^4.1.11"
+		"@testing-library/react": "^16.3.3",
+		"@types/node": "^26.5.0",
+		"@types/react": "^19.2.18",
+		"@types/react-dom": "^19.2.7",
+		"@vitest/coverage-v8": "^5.0.0",
+		"jsdom": "^30.0.1",
+		"react": "^19.2.8",
+		"react-dom": "^19.2.8",
+		"vitest": "^5.0.0"
 	},
 	"dependencies": {
-		"valibot": "^1.3.1"
+		"valibot": "^1.4.2"
 	}
 }

package/src/bridge/SandboxBridge.ts

@@ -16,7 +16,7 @@ import type { CustomBlockCreatePageErrorInfo } from "@notionhq/custom-blocks-pro
 import type { GetUserMessage } from "@notionhq/custom-blocks-protocol/messages/getUser.js"
 import {
 	hostToSandboxMessageSchema,
-	PrimeableHostToSandboxMessage,
+	type PrimeableHostToSandboxMessage,
 } from "@notionhq/custom-blocks-protocol/messages/hostToSandbox.js"
 import {
 	CustomBlockInitializationError,

package/src/bridge/dataSources/query.ts

@@ -147,13 +147,13 @@ function resolveDataSourceQueryOptions(
 	return {
 		status: "ok",
 		options: {
-			limit: Object.prototype.hasOwnProperty.call(optionsObject, "limit")
+			limit: Object.hasOwn(optionsObject, "limit")
 				? optionsObject.limit
 				: undefined,
-			filter: Object.prototype.hasOwnProperty.call(optionsObject, "filter")
+			filter: Object.hasOwn(optionsObject, "filter")
 				? optionsObject.filter
 				: undefined,
-			sorts: Object.prototype.hasOwnProperty.call(optionsObject, "sorts")
+			sorts: Object.hasOwn(optionsObject, "sorts")
 				? optionsObject.sorts
 				: undefined,
 		},
@@ -217,7 +217,7 @@ function resolveFilter(
 		}
 	}
 	const filterObject = filter as Record<string, unknown>
-	if (Object.prototype.hasOwnProperty.call(filterObject, "and")) {
+	if (Object.hasOwn(filterObject, "and")) {
 		if (
 			Object.keys(filterObject).length !== 1 ||
 			!Array.isArray(filterObject.and)
@@ -325,7 +325,7 @@ function resolveSort(
 	}
 	const direction = sortObject.direction
 	if (
-		!Object.prototype.hasOwnProperty.call(sortObject, "direction") ||
+		!Object.hasOwn(sortObject, "direction") ||
 		(direction !== "ascending" && direction !== "descending")
 	) {
 		return {
@@ -557,11 +557,8 @@ function resolvePropertyAddress(
 ):
 	| { status: "ok"; propertyId: string; propertyType: string }
 	| { status: "error"; error: string } {
-	const hasKey = Object.prototype.hasOwnProperty.call(value, "key")
-	const hasPropertyId = Object.prototype.hasOwnProperty.call(
-		value,
-		"propertyId",
-	)
+	const hasKey = Object.hasOwn(value, "key")
+	const hasPropertyId = Object.hasOwn(value, "propertyId")
 	if (hasKey === hasPropertyId) {
 		return {
 			status: "error",
@@ -577,12 +574,7 @@ function resolvePropertyAddress(
 				error: "Data source query property key must be a string.",
 			}
 		}
-		if (
-			!Object.prototype.hasOwnProperty.call(
-				dataSource.propertyIdsByKey,
-				value.key,
-			)
-		) {
+		if (!Object.hasOwn(dataSource.propertyIdsByKey, value.key)) {
 			return {
 				status: "error",
 				error: `Unknown property key "${value.key}" for data source "${dataSource.key}".`,
@@ -605,12 +597,7 @@ function resolvePropertyAddress(
 		}
 		propertyId = value.propertyId
 	}
-	if (
-		!Object.prototype.hasOwnProperty.call(
-			dataSource.propertySchemasById,
-			propertyId,
-		)
-	) {
+	if (!Object.hasOwn(dataSource.propertySchemasById, propertyId)) {
 		return {
 			status: "error",
 			error: `Unknown property ID "${propertyId}" for data source "${dataSource.key}".`,

package/src/react/useCustomBlockInit.ts

@@ -45,6 +45,7 @@ export function useCustomBlockInit(
 		isLoaded: false,
 		error: undefined,
 	})
+	// biome-ignore lint/correctness/useExhaustiveDependencies(opts): Initialization caches its first options and promise. Later options are ignored, so changes should not resubscribe to the same promise.
 	useEffect(() => {
 		let cancelled = false
 		initCustomBlock(opts).then(
@@ -62,9 +63,6 @@ export function useCustomBlockInit(
 		return () => {
 			cancelled = true
 		}
-		// `initCustomBlock` caches its result, so options after the first call
-		// are ignored — re-running on opts changes would be misleading.
-		// eslint-disable-next-line react-hooks/exhaustive-deps
 	}, [])
 	return state
 }

package/src/react/useDataSource.ts

@@ -29,6 +29,9 @@ export function useDataSource(
 			: undefined
 
 	const isInitialized = host.status === "initialized"
+	// biome-ignore lint/correctness/useExhaustiveDependencies(options): Compare options by value through optionsIdentity. Object identity alone must not trigger queries.
+	// biome-ignore lint/correctness/useExhaustiveDependencies(optionsIdentity): Changes to the serialized options must trigger a query even though the callback reads options.
+	// biome-ignore lint/correctness/useExhaustiveDependencies(matchingDataSource): Requery when the matching data source changes, even when the key and options are unchanged.
 	useEffect(() => {
 		if (!isInitialized) {
 			return