@notionhq/custom-blocks-host 0.4.1 → 0.4.3

package/dist/protocol/index.d.ts

@@ -1,54 +1,150 @@
-/**
- * Shared wire contract for custom block sandboxes and hosts.
- *
- * This package contains only protocol data: message schemas, wire types, IDs,
- * errors, manifests, and protocol-version constants. Runtime behavior belongs
- * in either the author SDK or the host package.
- */
-export * from "./contrast.js";
-export * from "./dataSources/dataSource.js";
-export * from "./dataSources/dataSourcePage.js";
-export * from "./dataSources/dataSourceValue.js";
-export * from "./dataSources/dateValue.js";
-export * from "./dataSources/errors.js";
-export * from "./dataSources/propertySchema.js";
-export * from "./dataSources/recordPointer.js";
-export * from "./dataSources/sortDirection.js";
-export * from "./errors.js";
-export * from "./ids.js";
-export { isLocalBlockServerUrl } from "./isLocalBlockServerUrl.js";
-export * from "./manifest.js";
-export * from "./messages/connect.js";
-export * from "./messages/contrastModeChanged.js";
-export * from "./messages/createPage.js";
-export * from "./messages/createPageResult.js";
-export * from "./messages/currentUserChanged.js";
-export * from "./messages/dataSourcesChanged.js";
-export * from "./messages/getPage.js";
-export * from "./messages/getUser.js";
-export * from "./messages/hostToSandbox.js";
-export * from "./messages/incomingType.js";
-export * from "./messages/init.js";
-export * from "./messages/initResult.js";
-export * from "./messages/invalidHostMessage.js";
-export * from "./messages/invalidSandboxMessage.js";
-export * from "./messages/isInitHandshakeMessage.js";
-export * from "./messages/listUsers.js";
-export * from "./messages/messagePayload.js";
-export * from "./messages/openExternalUrl.js";
-export * from "./messages/openPage.js";
-export * from "./messages/pageChanged.js";
-export * from "./messages/parentChanged.js";
-export * from "./messages/queryDataSource.js";
-export * from "./messages/queryDataSourceResult.js";
-export * from "./messages/resize.js";
-export * from "./messages/sandboxToHost.js";
-export * from "./messages/themeChanged.js";
-export * from "./messages/unsubscribeDataSourceQuery.js";
-export * from "./messages/updatePage.js";
-export * from "./messages/updatePageResult.js";
-export * from "./pages/page.js";
-export * from "./parent.js";
-export * from "./protocolVersion.js";
-export * from "./theme.js";
-export * from "./users/user.js";
+/** Shared wire definitions and constructors. Runtime behavior belongs to the SDK or host. */
+export type { BridgePageForProtocol3To5 } from "./compatibility/protocol3To5/bridgePage.js";
+export { bridgePageForProtocol3To5Schema } from "./compatibility/protocol3To5/bridgePage.js";
+export type { NotionDataSourcePageForProtocol3To5 } from "./compatibility/protocol3To5/dataSourcePage.js";
+export { notionDataSourcePageForProtocol3To5Schema } from "./compatibility/protocol3To5/dataSourcePage.js";
+export type { NotionDataSourceValue } from "./compatibility/protocol3To5/dataSourceValue.js";
+export { notionDataSourceValueSchema } from "./compatibility/protocol3To5/dataSourceValue.js";
+export type { CustomBlockPage } from "./context/containingPage.js";
+export { customBlockPageSchema } from "./context/containingPage.js";
+export type { NotionContrastMode } from "./context/contrast.js";
+export { DEFAULT_CONTRAST_MODE, notionContrastModeSchema, } from "./context/contrast.js";
+export type { ContrastModeChangedMessage } from "./context/messages/contrastModeChanged.js";
+export { contrastModeChangedMessageSchema } from "./context/messages/contrastModeChanged.js";
+export type { PageChangedMessage } from "./context/messages/pageChanged.js";
+export { pageChangedMessageSchema } from "./context/messages/pageChanged.js";
+export type { ParentChangedMessage } from "./context/messages/parentChanged.js";
+export { parentChangedMessageSchema } from "./context/messages/parentChanged.js";
+export type { ResizeMessage } from "./context/messages/resize.js";
+export { resizeMessageSchema } from "./context/messages/resize.js";
+export type { ThemeChangedMessage } from "./context/messages/themeChanged.js";
+export { themeChangedMessageSchema } from "./context/messages/themeChanged.js";
+export type { DataSourceParent, NotionParent, PageParent, } from "./context/parent.js";
+export { dataSourceParentSchema, notionParentSchema, pageParentSchema, } from "./context/parent.js";
+export type { NotionTheme } from "./context/theme.js";
+export { notionThemeSchema } from "./context/theme.js";
+export type { BridgeDataSourceBinding } from "./dataSources/bridgeDataSourceBinding.js";
+export { bridgeDataSourceBindingSchema } from "./dataSources/bridgeDataSourceBinding.js";
+export type { BridgeDataSourceBindings } from "./dataSources/bridgeDataSourceBindings.js";
+export { bridgeDataSourceBindingsSchema } from "./dataSources/bridgeDataSourceBindings.js";
+export type { NotionCollectionPointer } from "./dataSources/collectionPointer.js";
+export type { NotionCollectionSchema } from "./dataSources/collectionSchema.js";
+export { notionCollectionSchemaValidator } from "./dataSources/collectionSchema.js";
+export type { CustomBlockDataSourceResolutionErrorCode, CustomBlockDataSourceResolutionErrorInfo, CustomBlockPropertyErrorCode, CustomBlockPropertyErrorInfo, } from "./dataSources/errors.js";
+export { customBlockDataSourceResolutionErrorCodeSchema, customBlockPropertyErrorCodeSchema, } from "./dataSources/errors.js";
+export type { BridgeDataSourceFilter } from "./dataSources/filters/bridgeDataSourceFilter.js";
+export { bridgeDataSourceFilterSchema } from "./dataSources/filters/bridgeDataSourceFilter.js";
+export type { BridgeDataSourceFilterCondition } from "./dataSources/filters/bridgeDataSourceFilterCondition.js";
+export { bridgeDataSourceFilterConditionSchema } from "./dataSources/filters/bridgeDataSourceFilterCondition.js";
+export type { BridgeDataSourceSort } from "./dataSources/filters/bridgeDataSourceSort.js";
+export { bridgeDataSourceSortSchema, CUSTOM_BLOCK_DATA_SOURCE_QUERY_MAX_SORTS, } from "./dataSources/filters/bridgeDataSourceSort.js";
+export type { CustomBlockCheckboxFilterOperator } from "./dataSources/filters/checkboxFilterOperator.js";
+export { customBlockCheckboxFilterOperatorSchema } from "./dataSources/filters/checkboxFilterOperator.js";
+export type { CustomBlockContainsFilterOperator } from "./dataSources/filters/containsFilterOperator.js";
+export { customBlockContainsFilterOperatorSchema } from "./dataSources/filters/containsFilterOperator.js";
+export type { CustomBlockCreatedByFilterOperator } from "./dataSources/filters/createdByFilterOperator.js";
+export { customBlockCreatedByFilterOperatorSchema } from "./dataSources/filters/createdByFilterOperator.js";
+export type { CustomBlockDateFilterOperator, CustomBlockRelativeDateValue, } from "./dataSources/filters/dateFilterOperator.js";
+export { customBlockDateFilterOperatorSchema, customBlockRelativeDateValueSchema, } from "./dataSources/filters/dateFilterOperator.js";
+export type { CustomBlockNumberFilterOperator } from "./dataSources/filters/numberFilterOperator.js";
+export { customBlockNumberFilterOperatorSchema } from "./dataSources/filters/numberFilterOperator.js";
+export type { CustomBlockOptionFilterOperator } from "./dataSources/filters/optionFilterOperator.js";
+export { customBlockOptionFilterOperatorSchema } from "./dataSources/filters/optionFilterOperator.js";
+export type { CustomBlockPeopleFilterOperator, CustomBlockPersonFilterValue, } from "./dataSources/filters/peopleFilterOperator.js";
+export { customBlockPeopleFilterOperatorSchema } from "./dataSources/filters/peopleFilterOperator.js";
+export type { CustomBlockRelationFilterOperator } from "./dataSources/filters/relationFilterOperator.js";
+export { customBlockRelationFilterOperatorSchema } from "./dataSources/filters/relationFilterOperator.js";
+export type { CustomBlockStatusFilterOperator } from "./dataSources/filters/statusFilterOperator.js";
+export { customBlockStatusFilterOperatorSchema } from "./dataSources/filters/statusFilterOperator.js";
+export type { CustomBlockStatusGroupFilterOperator, CustomBlockStatusGroupName, } from "./dataSources/filters/statusGroupFilterOperator.js";
+export { customBlockStatusGroupFilterOperatorSchema, customBlockStatusGroupNameSchema, } from "./dataSources/filters/statusGroupFilterOperator.js";
+export type { CustomBlockTextFilterOperator } from "./dataSources/filters/textFilterOperator.js";
+export { customBlockTextFilterOperatorSchema } from "./dataSources/filters/textFilterOperator.js";
+export type { MakeBridgeDataSourceBindingArgs } from "./dataSources/makeBridgeDataSourceBinding.js";
+export { makeBridgeDataSourceBinding } from "./dataSources/makeBridgeDataSourceBinding.js";
+export type { DataSourcesChangedMessage } from "./dataSources/messages/dataSourcesChanged.js";
+export { dataSourcesChangedMessageSchema } from "./dataSources/messages/dataSourcesChanged.js";
+export type { CustomBlockQueryDataSourceErrorCode, CustomBlockQueryDataSourceErrorInfo, QueryDataSourceMessage, QueryDataSourceResultMessage, QueryDataSourceResultMessageWithProtocol3To5Compatibility, } from "./dataSources/messages/queryDataSource.js";
+export { customBlockQueryDataSourceErrorCodeSchema, customBlockQueryDataSourceErrorInfoSchema, queryDataSourceMessageSchema, queryDataSourceResultMessageSchema, queryDataSourceResultMessageWithProtocol3To5CompatibilitySchema, } from "./dataSources/messages/queryDataSource.js";
+export type { UnsubscribeDataSourceQueryMessage } from "./dataSources/messages/unsubscribeDataSourceQuery.js";
+export { unsubscribeDataSourceQueryMessageSchema } from "./dataSources/messages/unsubscribeDataSourceQuery.js";
+export type { NotionDataSource } from "./dataSources/notionDataSource.js";
+export { notionDataSourceSchema } from "./dataSources/notionDataSource.js";
+export type { NotionDate, NotionDateRange, NotionDateReminder, NotionDateTime, NotionDateTimeRange, NotionDateTimeReminder, NotionDateValue, NotionDisabledReminder, NotionTimeReminder, } from "./dataSources/properties/dateValue.js";
+export { notionDateRangeSchema, notionDateReminderSchema, notionDateSchema, notionDateTimeRangeSchema, notionDateTimeReminderSchema, notionDateTimeSchema, notionDateValueSchema, notionDisabledReminderSchema, notionTimeReminderSchema, } from "./dataSources/properties/dateValue.js";
+export type { CustomBlockDataSourceSortablePropertyType, NotionBuiltinPropertyId, NotionDualProperty, NotionPropertyColor, NotionPropertyOption, NotionPropertySchema, NotionPropertySchemasById, NotionPropertyType, NotionStatusGroup, } from "./dataSources/properties/propertySchema.js";
+export { CUSTOM_BLOCK_DATA_SOURCE_SORTABLE_PROPERTY_TYPES, NOTION_BUILTIN_PROPERTY_IDS, NOTION_BUILTIN_PROPERTY_SCHEMAS, NOTION_PROPERTY_TYPES, notionDualPropertySchema, notionPropertyColorSchema, notionPropertyOptionSchema, notionPropertySchemaSchema, notionPropertyTypeSchema, notionStatusGroupSchema, } from "./dataSources/properties/propertySchema.js";
+export type { MappedPropertyBinding, ResolvedDataSourceBinding, ResolvedPropertyBinding, } from "./dataSources/resolveDataSourceBinding.js";
+export { resolveDataSourceBinding } from "./dataSources/resolveDataSourceBinding.js";
+export type { NotionSortDirection } from "./dataSources/sortDirection.js";
+export { notionSortDirectionSchema } from "./dataSources/sortDirection.js";
+export type { ConnectMessage } from "./handshake/connect.js";
+export { connectMessageSchema } from "./handshake/connect.js";
+export type { CustomBlockInitErrorCode, CustomBlockInitErrorInfo, CustomBlockInitializationErrorCode, CustomBlockInitializationErrorInfo, InitMessage, } from "./handshake/init.js";
+export { CustomBlockInitializationError, customBlockInitErrorCodeSchema, customBlockInitErrorInfoSchema, initMessageSchema, } from "./handshake/init.js";
+export type { CustomBlockInitResultErrorCode, CustomBlockInitResultErrorInfo, InitResultMessage, } from "./handshake/initResult.js";
+export { customBlockInitResultErrorCodeSchema, customBlockInitResultErrorInfoSchema, initResultMessageSchema, } from "./handshake/initResult.js";
+export { isInitHandshakeMessage } from "./handshake/isInitHandshakeMessage.js";
+export type { CustomBlockCapabilityDeclaration, CustomBlockCapabilityName, CustomBlockCapabilityResourceName, CustomBlockOriginResourceName, } from "./manifest/capabilities.js";
+export { customBlockCapabilityDeclarationSchema } from "./manifest/capabilities.js";
+export type { BridgeCustomBlockManifest, ManifestDataSource, ManifestIcon, ManifestProperty, } from "./manifest/manifest.js";
+export { manifestDataSourceSchema, manifestIconSchema, manifestPropertySchema, manifestSchema, } from "./manifest/manifest.js";
+export type { HostToSandboxMessage, HostToSandboxMessageWithProtocol3To5Compatibility, } from "./messages/hostToSandbox.js";
+export { hostToSandboxMessageSchema, hostToSandboxMessageWithProtocol3To5CompatibilitySchema, } from "./messages/hostToSandbox.js";
+export { readIncomingType } from "./messages/incomingType.js";
+export type { InvalidHostMessage } from "./messages/invalidHostMessage.js";
+export { invalidHostMessageSchema } from "./messages/invalidHostMessage.js";
+export type { InvalidSandboxMessage } from "./messages/invalidSandboxMessage.js";
+export { invalidSandboxMessageSchema } from "./messages/invalidSandboxMessage.js";
+export type { BridgeMessagePayload } from "./messages/messagePayload.js";
+export type { SandboxToHostMessage } from "./messages/sandboxToHost.js";
+export { sandboxToHostMessageSchema } from "./messages/sandboxToHost.js";
+export type { CustomBlockOpenExternalUrlErrorCode, CustomBlockOpenExternalUrlErrorInfo, OpenExternalUrlMessage, OpenExternalUrlResultMessage, } from "./navigation/openExternalUrl.js";
+export { customBlockOpenExternalUrlErrorCodeSchema, customBlockOpenExternalUrlErrorInfoSchema, openExternalUrlMessageSchema, openExternalUrlResultMessageSchema, } from "./navigation/openExternalUrl.js";
+export type { BridgePage } from "./pages/bridgePage.js";
+export { bridgePageSchema } from "./pages/bridgePage.js";
+export type { MakeBridgePageArgs } from "./pages/makeBridgePage.js";
+export { makeBridgePage } from "./pages/makeBridgePage.js";
+export type { CreatePageMessage, CreatePageMessageParent, CreatePageResultMessage, CreatePageResultMessageWithProtocol3To5Compatibility, CustomBlockCreatePageErrorCode, CustomBlockCreatePageErrorInfo, NotionCreatePagePosition, } from "./pages/messages/createPage.js";
+export { createPageMessageSchema, createPageParentSchema, createPageResultMessageSchema, createPageResultMessageWithProtocol3To5CompatibilitySchema, customBlockCreatePageErrorCodeSchema, customBlockCreatePageErrorInfoSchema, notionCreatePagePositionSchema, } from "./pages/messages/createPage.js";
+export type { CustomBlockGetPageErrorCode, CustomBlockGetPageErrorInfo, GetPageMessage, GetPageResultMessage, GetPageResultMessageWithProtocol3To5Compatibility, } from "./pages/messages/getPage.js";
+export { customBlockGetPageErrorCodeSchema, customBlockGetPageErrorInfoSchema, getPageMessageSchema, getPageResultMessageSchema, getPageResultMessageWithProtocol3To5CompatibilitySchema, } from "./pages/messages/getPage.js";
+export type { CustomBlockOpenPageErrorCode, CustomBlockOpenPageErrorInfo, OpenPageMessage, OpenPageMode, OpenPageResultMessage, } from "./pages/messages/openPage.js";
+export { customBlockOpenPageErrorCodeSchema, customBlockOpenPageErrorInfoSchema, openPageMessageSchema, openPageModeSchema, openPageResultMessageSchema, } from "./pages/messages/openPage.js";
+export type { CustomBlockUpdatePageErrorCode, CustomBlockUpdatePageErrorInfo, UpdatePageMessage, UpdatePageResultMessage, UpdatePageResultMessageWithProtocol3To5Compatibility, } from "./pages/messages/updatePage.js";
+export { customBlockUpdatePageErrorCodeSchema, customBlockUpdatePageErrorInfoSchema, updatePageMessageSchema, updatePageResultMessageSchema, updatePageResultMessageWithProtocol3To5CompatibilitySchema, } from "./pages/messages/updatePage.js";
+export type { NotionPageCover, NotionPageIcon } from "./pages/pageAppearance.js";
+export { notionCustomEmojiIconSchema, notionEmojiIconSchema, notionExternalFileSchema, notionHostedFileSchema, notionPageCoverSchema, notionPageIconSchema, } from "./pages/pageAppearance.js";
+export type { BridgePagePropertyReadMap, BridgePagePropertyWriteMap, } from "./pages/properties/bridgePagePropertyMaps.js";
+export { bridgePagePropertyReadMapSchema, bridgePagePropertyWriteMapSchema, } from "./pages/properties/bridgePagePropertyMaps.js";
+export type { BridgePagePropertyValue } from "./pages/properties/bridgePagePropertyValue.js";
+export { bridgePagePropertyValueSchema } from "./pages/properties/bridgePagePropertyValue.js";
+export type { NotionDateInput } from "./pages/properties/dateInput.js";
+export type { NotionFileInput } from "./pages/properties/fileInput.js";
+export type { NotionPlaceInput } from "./pages/properties/placeInput.js";
+export type { NotionRelationInput } from "./pages/properties/relationInput.js";
+export type { NotionRichTextItem } from "./pages/properties/richText.js";
+export type { NotionSelectOptionInput } from "./pages/properties/selectOption.js";
+export type { NotionUserInput } from "./pages/properties/userInput.js";
+export type { BridgeUser } from "./users/bridgeUser.js";
+export { bridgeUserSchema } from "./users/bridgeUser.js";
+export type { BridgeUserList } from "./users/bridgeUserList.js";
+export { bridgeUserListSchema } from "./users/bridgeUserList.js";
+export type { MakeBridgeUserArgs } from "./users/makeBridgeUser.js";
+export { makeBridgeUser } from "./users/makeBridgeUser.js";
+export type { CurrentUserChangedMessage } from "./users/messages/currentUserChanged.js";
+export { currentUserChangedMessageSchema } from "./users/messages/currentUserChanged.js";
+export type { CustomBlockGetUserErrorCode, CustomBlockGetUserErrorInfo, GetUserMessage, GetUserResultMessage, } from "./users/messages/getUser.js";
+export { customBlockGetUserErrorCodeSchema, customBlockGetUserErrorInfoSchema, getUserMessageSchema, getUserResultMessageSchema, } from "./users/messages/getUser.js";
+export type { CustomBlockListUsersErrorCode, CustomBlockListUsersErrorInfo, ListUsersMessage, ListUsersResultMessage, } from "./users/messages/listUsers.js";
+export { customBlockListUsersErrorCodeSchema, customBlockListUsersErrorInfoSchema, listUsersMessageSchema, listUsersResultMessageSchema, } from "./users/messages/listUsers.js";
+export type { NotionUserId } from "./users/userId.js";
+export { notionUserIdSchema } from "./users/userId.js";
+export type { CustomBlockCapabilityErrorCode, CustomBlockErrorCode, CustomBlockErrorInfo, } from "./utils/errors.js";
+export { CAPABILITY_NOT_GRANTED_ERROR_CODE, customBlockErrorInfoSchema, } from "./utils/errors.js";
+export type { NotionAgentId, NotionBlockId, NotionDataSourceId, NotionPageId, NotionSpaceId, } from "./utils/ids.js";
+export { notionAgentIdSchema, notionBlockIdSchema, notionDataSourceIdSchema, notionPageIdSchema, notionSpaceIdSchema, } from "./utils/ids.js";
+export { isLocalBlockServerUrl } from "./utils/isLocalBlockServerUrl.js";
+export { LATEST_BRIDGE_PROTOCOL_VERSION, TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION, UNIFIED_PAGE_PROTOCOL_VERSION, } from "./utils/protocolVersion.js";
+export type { NotionRecordPointer } from "./utils/recordPointer.js";
+export { notionRecordPointerSchema } from "./utils/recordPointer.js";

package/dist/protocol/index.js

@@ -1,54 +1,73 @@
-/**
- * Shared wire contract for custom block sandboxes and hosts.
- *
- * This package contains only protocol data: message schemas, wire types, IDs,
- * errors, manifests, and protocol-version constants. Runtime behavior belongs
- * in either the author SDK or the host package.
- */
-export * from "./contrast.js";
-export * from "./dataSources/dataSource.js";
-export * from "./dataSources/dataSourcePage.js";
-export * from "./dataSources/dataSourceValue.js";
-export * from "./dataSources/dateValue.js";
-export * from "./dataSources/errors.js";
-export * from "./dataSources/propertySchema.js";
-export * from "./dataSources/recordPointer.js";
-export * from "./dataSources/sortDirection.js";
-export * from "./errors.js";
-export * from "./ids.js";
-export { isLocalBlockServerUrl } from "./isLocalBlockServerUrl.js";
-export * from "./manifest.js";
-export * from "./messages/connect.js";
-export * from "./messages/contrastModeChanged.js";
-export * from "./messages/createPage.js";
-export * from "./messages/createPageResult.js";
-export * from "./messages/currentUserChanged.js";
-export * from "./messages/dataSourcesChanged.js";
-export * from "./messages/getPage.js";
-export * from "./messages/getUser.js";
-export * from "./messages/hostToSandbox.js";
-export * from "./messages/incomingType.js";
-export * from "./messages/init.js";
-export * from "./messages/initResult.js";
-export * from "./messages/invalidHostMessage.js";
-export * from "./messages/invalidSandboxMessage.js";
-export * from "./messages/isInitHandshakeMessage.js";
-export * from "./messages/listUsers.js";
-export * from "./messages/messagePayload.js";
-export * from "./messages/openExternalUrl.js";
-export * from "./messages/openPage.js";
-export * from "./messages/pageChanged.js";
-export * from "./messages/parentChanged.js";
-export * from "./messages/queryDataSource.js";
-export * from "./messages/queryDataSourceResult.js";
-export * from "./messages/resize.js";
-export * from "./messages/sandboxToHost.js";
-export * from "./messages/themeChanged.js";
-export * from "./messages/unsubscribeDataSourceQuery.js";
-export * from "./messages/updatePage.js";
-export * from "./messages/updatePageResult.js";
-export * from "./pages/page.js";
-export * from "./parent.js";
-export * from "./protocolVersion.js";
-export * from "./theme.js";
-export * from "./users/user.js";
+/** Shared wire definitions and constructors. Runtime behavior belongs to the SDK or host. */
+export { bridgePageForProtocol3To5Schema } from "./compatibility/protocol3To5/bridgePage.js";
+export { notionDataSourcePageForProtocol3To5Schema } from "./compatibility/protocol3To5/dataSourcePage.js";
+export { notionDataSourceValueSchema } from "./compatibility/protocol3To5/dataSourceValue.js";
+export { customBlockPageSchema } from "./context/containingPage.js";
+export { DEFAULT_CONTRAST_MODE, notionContrastModeSchema, } from "./context/contrast.js";
+export { contrastModeChangedMessageSchema } from "./context/messages/contrastModeChanged.js";
+export { pageChangedMessageSchema } from "./context/messages/pageChanged.js";
+export { parentChangedMessageSchema } from "./context/messages/parentChanged.js";
+export { resizeMessageSchema } from "./context/messages/resize.js";
+export { themeChangedMessageSchema } from "./context/messages/themeChanged.js";
+export { dataSourceParentSchema, notionParentSchema, pageParentSchema, } from "./context/parent.js";
+export { notionThemeSchema } from "./context/theme.js";
+export { bridgeDataSourceBindingSchema } from "./dataSources/bridgeDataSourceBinding.js";
+export { bridgeDataSourceBindingsSchema } from "./dataSources/bridgeDataSourceBindings.js";
+export { notionCollectionSchemaValidator } from "./dataSources/collectionSchema.js";
+export { customBlockDataSourceResolutionErrorCodeSchema, customBlockPropertyErrorCodeSchema, } from "./dataSources/errors.js";
+export { bridgeDataSourceFilterSchema } from "./dataSources/filters/bridgeDataSourceFilter.js";
+export { bridgeDataSourceFilterConditionSchema } from "./dataSources/filters/bridgeDataSourceFilterCondition.js";
+export { bridgeDataSourceSortSchema, CUSTOM_BLOCK_DATA_SOURCE_QUERY_MAX_SORTS, } from "./dataSources/filters/bridgeDataSourceSort.js";
+export { customBlockCheckboxFilterOperatorSchema } from "./dataSources/filters/checkboxFilterOperator.js";
+export { customBlockContainsFilterOperatorSchema } from "./dataSources/filters/containsFilterOperator.js";
+export { customBlockCreatedByFilterOperatorSchema } from "./dataSources/filters/createdByFilterOperator.js";
+export { customBlockDateFilterOperatorSchema, customBlockRelativeDateValueSchema, } from "./dataSources/filters/dateFilterOperator.js";
+export { customBlockNumberFilterOperatorSchema } from "./dataSources/filters/numberFilterOperator.js";
+export { customBlockOptionFilterOperatorSchema } from "./dataSources/filters/optionFilterOperator.js";
+export { customBlockPeopleFilterOperatorSchema } from "./dataSources/filters/peopleFilterOperator.js";
+export { customBlockRelationFilterOperatorSchema } from "./dataSources/filters/relationFilterOperator.js";
+export { customBlockStatusFilterOperatorSchema } from "./dataSources/filters/statusFilterOperator.js";
+export { customBlockStatusGroupFilterOperatorSchema, customBlockStatusGroupNameSchema, } from "./dataSources/filters/statusGroupFilterOperator.js";
+export { customBlockTextFilterOperatorSchema } from "./dataSources/filters/textFilterOperator.js";
+export { makeBridgeDataSourceBinding } from "./dataSources/makeBridgeDataSourceBinding.js";
+export { dataSourcesChangedMessageSchema } from "./dataSources/messages/dataSourcesChanged.js";
+export { customBlockQueryDataSourceErrorCodeSchema, customBlockQueryDataSourceErrorInfoSchema, queryDataSourceMessageSchema, queryDataSourceResultMessageSchema, queryDataSourceResultMessageWithProtocol3To5CompatibilitySchema, } from "./dataSources/messages/queryDataSource.js";
+export { unsubscribeDataSourceQueryMessageSchema } from "./dataSources/messages/unsubscribeDataSourceQuery.js";
+export { notionDataSourceSchema } from "./dataSources/notionDataSource.js";
+export { notionDateRangeSchema, notionDateReminderSchema, notionDateSchema, notionDateTimeRangeSchema, notionDateTimeReminderSchema, notionDateTimeSchema, notionDateValueSchema, notionDisabledReminderSchema, notionTimeReminderSchema, } from "./dataSources/properties/dateValue.js";
+export { CUSTOM_BLOCK_DATA_SOURCE_SORTABLE_PROPERTY_TYPES, NOTION_BUILTIN_PROPERTY_IDS, NOTION_BUILTIN_PROPERTY_SCHEMAS, NOTION_PROPERTY_TYPES, notionDualPropertySchema, notionPropertyColorSchema, notionPropertyOptionSchema, notionPropertySchemaSchema, notionPropertyTypeSchema, notionStatusGroupSchema, } from "./dataSources/properties/propertySchema.js";
+export { resolveDataSourceBinding } from "./dataSources/resolveDataSourceBinding.js";
+export { notionSortDirectionSchema } from "./dataSources/sortDirection.js";
+export { connectMessageSchema } from "./handshake/connect.js";
+export { CustomBlockInitializationError, customBlockInitErrorCodeSchema, customBlockInitErrorInfoSchema, initMessageSchema, } from "./handshake/init.js";
+export { customBlockInitResultErrorCodeSchema, customBlockInitResultErrorInfoSchema, initResultMessageSchema, } from "./handshake/initResult.js";
+export { isInitHandshakeMessage } from "./handshake/isInitHandshakeMessage.js";
+export { customBlockCapabilityDeclarationSchema } from "./manifest/capabilities.js";
+export { manifestDataSourceSchema, manifestIconSchema, manifestPropertySchema, manifestSchema, } from "./manifest/manifest.js";
+export { hostToSandboxMessageSchema, hostToSandboxMessageWithProtocol3To5CompatibilitySchema, } from "./messages/hostToSandbox.js";
+export { readIncomingType } from "./messages/incomingType.js";
+export { invalidHostMessageSchema } from "./messages/invalidHostMessage.js";
+export { invalidSandboxMessageSchema } from "./messages/invalidSandboxMessage.js";
+export { sandboxToHostMessageSchema } from "./messages/sandboxToHost.js";
+export { customBlockOpenExternalUrlErrorCodeSchema, customBlockOpenExternalUrlErrorInfoSchema, openExternalUrlMessageSchema, openExternalUrlResultMessageSchema, } from "./navigation/openExternalUrl.js";
+export { bridgePageSchema } from "./pages/bridgePage.js";
+export { makeBridgePage } from "./pages/makeBridgePage.js";
+export { createPageMessageSchema, createPageParentSchema, createPageResultMessageSchema, createPageResultMessageWithProtocol3To5CompatibilitySchema, customBlockCreatePageErrorCodeSchema, customBlockCreatePageErrorInfoSchema, notionCreatePagePositionSchema, } from "./pages/messages/createPage.js";
+export { customBlockGetPageErrorCodeSchema, customBlockGetPageErrorInfoSchema, getPageMessageSchema, getPageResultMessageSchema, getPageResultMessageWithProtocol3To5CompatibilitySchema, } from "./pages/messages/getPage.js";
+export { customBlockOpenPageErrorCodeSchema, customBlockOpenPageErrorInfoSchema, openPageMessageSchema, openPageModeSchema, openPageResultMessageSchema, } from "./pages/messages/openPage.js";
+export { customBlockUpdatePageErrorCodeSchema, customBlockUpdatePageErrorInfoSchema, updatePageMessageSchema, updatePageResultMessageSchema, updatePageResultMessageWithProtocol3To5CompatibilitySchema, } from "./pages/messages/updatePage.js";
+export { notionCustomEmojiIconSchema, notionEmojiIconSchema, notionExternalFileSchema, notionHostedFileSchema, notionPageCoverSchema, notionPageIconSchema, } from "./pages/pageAppearance.js";
+export { bridgePagePropertyReadMapSchema, bridgePagePropertyWriteMapSchema, } from "./pages/properties/bridgePagePropertyMaps.js";
+export { bridgePagePropertyValueSchema } from "./pages/properties/bridgePagePropertyValue.js";
+export { bridgeUserSchema } from "./users/bridgeUser.js";
+export { bridgeUserListSchema } from "./users/bridgeUserList.js";
+export { makeBridgeUser } from "./users/makeBridgeUser.js";
+export { currentUserChangedMessageSchema } from "./users/messages/currentUserChanged.js";
+export { customBlockGetUserErrorCodeSchema, customBlockGetUserErrorInfoSchema, getUserMessageSchema, getUserResultMessageSchema, } from "./users/messages/getUser.js";
+export { customBlockListUsersErrorCodeSchema, customBlockListUsersErrorInfoSchema, listUsersMessageSchema, listUsersResultMessageSchema, } from "./users/messages/listUsers.js";
+export { notionUserIdSchema } from "./users/userId.js";
+export { CAPABILITY_NOT_GRANTED_ERROR_CODE, customBlockErrorInfoSchema, } from "./utils/errors.js";
+export { notionAgentIdSchema, notionBlockIdSchema, notionDataSourceIdSchema, notionPageIdSchema, notionSpaceIdSchema, } from "./utils/ids.js";
+export { isLocalBlockServerUrl } from "./utils/isLocalBlockServerUrl.js";
+export { LATEST_BRIDGE_PROTOCOL_VERSION, TEXT_FALLBACK_PROPERTY_PROTOCOL_VERSION, UNIFIED_PAGE_PROTOCOL_VERSION, } from "./utils/protocolVersion.js";
+export { notionRecordPointerSchema } from "./utils/recordPointer.js";

package/dist/protocol/manifest/capabilities.d.ts

@@ -0,0 +1,37 @@
+import * as v from "valibot";
+/**
+ * One entry in the block manifest's `capabilities`: what the block needs to do
+ * (`capability`) and what it acts on (`resource`). Viewers approve declared
+ * entries before the block loads.
+ *
+ * Both fields accept any string so a newer vocabulary never makes an older host
+ * or SDK reject a manifest.
+ */
+export declare const customBlockCapabilityDeclarationSchema: v.ObjectSchema<{
+    readonly capability: v.StringSchema<undefined>;
+    readonly resource: v.StringSchema<undefined>;
+}, undefined>;
+export type CustomBlockCapabilityDeclaration = v.InferOutput<typeof customBlockCapabilityDeclarationSchema>;
+/**
+ * Capability names that hosts recognize. `user` is shorthand for `user.read`
+ * and `user.read_email` on the same resource. `page` is shorthand for
+ * `page.read`, `page.insert`, `page.update`, and `page.archive` on the same
+ * resource. `page.trash` is reserved for a future Trash call and is not
+ * accepted yet.
+ */
+export type CustomBlockCapabilityName = "user" | "user.read" | "user.read_email" | "page" | "page.read" | "page.insert" | "page.update" | "page.archive" | "network.fetch";
+/**
+ * Resource names that hosts recognize. User capabilities take `current_user`
+ * or `workspace` (every member of the workspace). Page capabilities take
+ * `workspace` (every page the viewer can access), `containing_page`, or
+ * `data_source`. `private` is reserved for a future
+ * `page.insert` into the viewer's Private section and is not accepted yet.
+ * `network.fetch` takes a bare HTTPS origin.
+ */
+export type CustomBlockCapabilityResourceName = "current_user" | "workspace" | "containing_page" | "data_source" | CustomBlockOriginResourceName;
+/**
+ * An HTTPS origin the block loads content from and connects to, such as
+ * `https://api.example.com`. `https://*.example.com` covers subdomains. Hosts
+ * allow only origins that are also on the workspace's network allowlist.
+ */
+export type CustomBlockOriginResourceName = `https://${string}`;

package/dist/protocol/manifest/capabilities.js

@@ -0,0 +1,13 @@
+import * as v from "valibot";
+/**
+ * One entry in the block manifest's `capabilities`: what the block needs to do
+ * (`capability`) and what it acts on (`resource`). Viewers approve declared
+ * entries before the block loads.
+ *
+ * Both fields accept any string so a newer vocabulary never makes an older host
+ * or SDK reject a manifest.
+ */
+export const customBlockCapabilityDeclarationSchema = v.object({
+    capability: v.string(),
+    resource: v.string(),
+});

package/dist/protocol/{manifest.d.ts → manifest/manifest.d.ts}

@@ -60,8 +60,18 @@ export declare const manifestSchema: v.ObjectSchema<{
             readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
         }, undefined>, undefined>, {}>;
     }, undefined>, undefined>, {}>;
+    /**
+     * Capabilities the block needs. Omitted means the block predates capability
+     * approval, so hosts do not ask the viewer. An empty array declares no
+     * capabilities.
+     */
+    readonly capabilities: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly capability: v.StringSchema<undefined>;
+        readonly resource: v.StringSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
 }, undefined>;
 /**
- * Manifest describing a custom block and its required data sources.
+ * Manifest describing a custom block, its required data sources, and its
+ * capabilities.
  */
-export type CustomBlockManifest = v.InferOutput<typeof manifestSchema>;
+export type BridgeCustomBlockManifest = v.InferOutput<typeof manifestSchema>;

package/dist/protocol/{manifest.js → manifest/manifest.js}

@@ -1,5 +1,6 @@
 import * as v from "valibot";
-import { notionPropertyTypeSchema } from "./dataSources/propertySchema.js";
+import { notionPropertyTypeSchema } from "../dataSources/properties/propertySchema.js";
+import { customBlockCapabilityDeclarationSchema } from "./capabilities.js";
 /**
  * Decorative icon attached to a manifest data source. Mirrors the
  * `emoji` / `external` icon variants the public Notion API uses, so the host
@@ -33,4 +34,10 @@ export const manifestSchema = v.object({
     slashCommand: v.optional(v.string()),
     icon: v.optional(v.object({ type: v.literal("emoji"), emoji: v.string() })),
     dataSources: v.optional(v.record(v.string(), manifestDataSourceSchema), {}),
+    /**
+     * Capabilities the block needs. Omitted means the block predates capability
+     * approval, so hosts do not ask the viewer. An empty array declares no
+     * capabilities.
+     */
+    capabilities: v.optional(v.array(customBlockCapabilityDeclarationSchema)),
 });

package/dist/protocol/messages/hostToSandbox.d.ts

@@ -73,6 +73,10 @@ export declare const hostToSandboxMessageSchema: v.VariantSchema<"type", [v.Vari
                 readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
             }, undefined>, undefined>, {}>;
         }, undefined>, undefined>, {}>;
+        readonly capabilities: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly capability: v.StringSchema<undefined>;
+            readonly resource: v.StringSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
     }, undefined>;
     readonly dataSources: v.ObjectSchema<{
         readonly bindings: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
@@ -219,6 +223,7 @@ export declare const hostToSandboxMessageSchema: v.VariantSchema<"type", [v.Vari
                 }, undefined>], undefined>, undefined>;
             }, undefined>, undefined>;
             readonly propertyIdsByKey: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>, undefined>;
+            readonly inaccessible: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>;
     readonly currentUser: v.ObjectSchema<{
@@ -451,6 +456,7 @@ export declare const hostToSandboxMessageSchema: v.VariantSchema<"type", [v.Vari
                 }, undefined>], undefined>, undefined>;
             }, undefined>, undefined>;
             readonly propertyIdsByKey: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>, undefined>;
+            readonly inaccessible: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>;
 }, undefined>, v.VariantSchema<"status", [v.ObjectSchema<{
@@ -1819,6 +1825,10 @@ export declare const hostToSandboxMessageWithProtocol3To5CompatibilitySchema: v.
                 readonly type: v.PicklistSchema<readonly ["title", "rich_text", "number", "checkbox", "url", "email", "phone_number", "select", "multi_select", "status", "date", "people", "files", "unique_id", "relation", "place", "formula", "rollup", "button", "verification", "last_visited_time", "location", "created_time", "last_edited_time", "created_by", "last_edited_by"], undefined>;
             }, undefined>, undefined>, {}>;
         }, undefined>, undefined>, {}>;
+        readonly capabilities: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly capability: v.StringSchema<undefined>;
+            readonly resource: v.StringSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
     }, undefined>;
     readonly dataSources: v.ObjectSchema<{
         readonly bindings: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
@@ -1965,6 +1975,7 @@ export declare const hostToSandboxMessageWithProtocol3To5CompatibilitySchema: v.
                 }, undefined>], undefined>, undefined>;
             }, undefined>, undefined>;
             readonly propertyIdsByKey: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>, undefined>;
+            readonly inaccessible: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>;
     readonly currentUser: v.ObjectSchema<{
@@ -2197,6 +2208,7 @@ export declare const hostToSandboxMessageWithProtocol3To5CompatibilitySchema: v.
                 }, undefined>], undefined>, undefined>;
             }, undefined>, undefined>;
             readonly propertyIdsByKey: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>, undefined>;
+            readonly inaccessible: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>;
 }, undefined>, v.VariantSchema<"status", [v.ObjectSchema<{

package/dist/protocol/messages/hostToSandbox.js

@@ -1,20 +1,20 @@
 import * as v from "valibot";
-import { contrastModeChangedMessageSchema } from "./contrastModeChanged.js";
-import { createPageResultMessageSchema, createPageResultMessageWithProtocol3To5CompatibilitySchema, } from "./createPageResult.js";
-import { currentUserChangedMessageSchema } from "./currentUserChanged.js";
-import { dataSourcesChangedMessageSchema } from "./dataSourcesChanged.js";
-import { getPageResultMessageSchema, getPageResultMessageWithProtocol3To5CompatibilitySchema, } from "./getPage.js";
-import { getUserResultMessageSchema } from "./getUser.js";
-import { initMessageSchema } from "./init.js";
+import { contrastModeChangedMessageSchema } from "../context/messages/contrastModeChanged.js";
+import { pageChangedMessageSchema } from "../context/messages/pageChanged.js";
+import { parentChangedMessageSchema } from "../context/messages/parentChanged.js";
+import { themeChangedMessageSchema } from "../context/messages/themeChanged.js";
+import { dataSourcesChangedMessageSchema } from "../dataSources/messages/dataSourcesChanged.js";
+import { queryDataSourceResultMessageSchema, queryDataSourceResultMessageWithProtocol3To5CompatibilitySchema, } from "../dataSources/messages/queryDataSource.js";
+import { initMessageSchema } from "../handshake/init.js";
+import { openExternalUrlResultMessageSchema } from "../navigation/openExternalUrl.js";
+import { createPageResultMessageSchema, createPageResultMessageWithProtocol3To5CompatibilitySchema, } from "../pages/messages/createPage.js";
+import { getPageResultMessageSchema, getPageResultMessageWithProtocol3To5CompatibilitySchema, } from "../pages/messages/getPage.js";
+import { openPageResultMessageSchema } from "../pages/messages/openPage.js";
+import { updatePageResultMessageSchema, updatePageResultMessageWithProtocol3To5CompatibilitySchema, } from "../pages/messages/updatePage.js";
+import { currentUserChangedMessageSchema } from "../users/messages/currentUserChanged.js";
+import { getUserResultMessageSchema } from "../users/messages/getUser.js";
+import { listUsersResultMessageSchema } from "../users/messages/listUsers.js";
 import { invalidSandboxMessageSchema } from "./invalidSandboxMessage.js";
-import { listUsersResultMessageSchema } from "./listUsers.js";
-import { openExternalUrlResultMessageSchema } from "./openExternalUrl.js";
-import { openPageResultMessageSchema } from "./openPage.js";
-import { pageChangedMessageSchema } from "./pageChanged.js";
-import { parentChangedMessageSchema } from "./parentChanged.js";
-import { queryDataSourceResultMessageSchema, queryDataSourceResultMessageWithProtocol3To5CompatibilitySchema, } from "./queryDataSourceResult.js";
-import { themeChangedMessageSchema } from "./themeChanged.js";
-import { updatePageResultMessageSchema, updatePageResultMessageWithProtocol3To5CompatibilitySchema, } from "./updatePageResult.js";
 const baseHostToSandboxMessageSchema = v.variant("type", [
     initMessageSchema,
     themeChangedMessageSchema,

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

@@ -1,4 +1,4 @@
-import type { CustomBlockErrorInfo } from "../errors.js";
+import type { CustomBlockErrorInfo } from "../utils/errors.js";
 type WithTypedErrorInfo<T, TErrorInfo extends CustomBlockErrorInfo | undefined> = TErrorInfo extends CustomBlockErrorInfo ? T extends {
     error: CustomBlockErrorInfo;
 } ? Omit<T, "error"> & {