@notionhq/custom-blocks-host 0.4.1 → 0.4.3

package/dist/protocol/dataSources/notionDataSource.d.ts

@@ -0,0 +1,309 @@
+import * as v from "valibot";
+export declare const notionDataSourceSchema: v.ObjectSchema<{
+    readonly key: v.StringSchema<undefined>;
+    readonly collectionPointer: v.OptionalSchema<v.ObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionDataSourceId">]>;
+        readonly table: v.StringSchema<undefined>;
+        readonly spaceId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionSpaceId">]>, undefined>;
+    }, undefined>, undefined>;
+    /**
+     * Describes database properties. Use this schema to resolve property bindings. Use this
+     * schema to validate filter and sort references. Undefined when the host does not provide a
+     * database schema.
+     */
+    readonly collectionSchema: v.OptionalSchema<v.ObjectSchema<{
+        readonly id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.BrandAction<string, "NotionDataSourceId">]>, undefined>;
+        readonly propertiesById: v.RecordSchema<v.StringSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"title", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"rich_text", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"number", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"checkbox", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"url", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"email", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"phone_number", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"select", undefined>;
+            readonly options: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly name: v.StringSchema<undefined>;
+                readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+                readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"multi_select", undefined>;
+            readonly options: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly name: v.StringSchema<undefined>;
+                readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+                readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"status", undefined>;
+            readonly options: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly name: v.StringSchema<undefined>;
+                readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+                readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly groups: v.ArraySchema<v.ObjectSchema<{
+                readonly id: v.StringSchema<undefined>;
+                readonly name: v.StringSchema<undefined>;
+                readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+                readonly option_ids: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"date", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"people", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"files", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"unique_id", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"relation", undefined>;
+            readonly data_source_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly dual_property: v.OptionalSchema<v.ObjectSchema<{
+                readonly synced_property_id: v.StringSchema<undefined>;
+                readonly synced_property_name: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"place", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"formula", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"rollup", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"button", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"verification", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"last_visited_time", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"location", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"created_time", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"last_edited_time", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"created_by", undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"last_edited_by", undefined>;
+        }, undefined>], undefined>, undefined>;
+    }, undefined>, undefined>;
+    /**
+     * Maps user-defined property keys to database property IDs. Use this map to resolve a key
+     * such as `name` to its database property ID. A value of `undefined` marks a declared
+     * property without a valid binding. Synthetic metadata does not add entries to this map.
+     */
+    readonly propertyIdsByKey: v.RecordSchema<v.StringSchema<undefined>, v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /**
+     * Describes property values in query snapshots. Keys use the same property IDs as a snapshot's
+     * `propertiesById` map.
+     *
+     * Includes four synthetic metadata fields, even when the database schema is unavailable:
+     * `created_time`, `last_edited_time`, `created_by`, and `last_edited_by`. Also includes
+     * database properties when the host provides their schema.
+     *
+     * Use `propertiesById` to read a value. Use this map to read the value's schema. Use
+     * `collectionSchema` to validate filter and sort references.
+     */
+    readonly propertySchemasById: v.RecordSchema<v.StringSchema<undefined>, v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"title", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"rich_text", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"number", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"checkbox", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"url", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"email", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"phone_number", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"select", undefined>;
+        readonly options: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"multi_select", undefined>;
+        readonly options: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"status", undefined>;
+        readonly options: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly groups: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly name: v.StringSchema<undefined>;
+            readonly color: v.OptionalSchema<v.PicklistSchema<["default", "gray", "brown", "orange", "yellow", "green", "blue", "purple", "pink", "red", "gray_background", "brown_background", "orange_background", "yellow_background", "green_background", "blue_background", "purple_background", "pink_background", "red_background", "default_background"], undefined>, undefined>;
+            readonly option_ids: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"date", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"people", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"files", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"unique_id", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"relation", undefined>;
+        readonly data_source_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly dual_property: v.OptionalSchema<v.ObjectSchema<{
+            readonly synced_property_id: v.StringSchema<undefined>;
+            readonly synced_property_name: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"place", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"formula", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"rollup", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"button", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"verification", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"last_visited_time", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"location", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"created_time", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"last_edited_time", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"created_by", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"last_edited_by", undefined>;
+    }, undefined>], undefined>, undefined>;
+    /**
+     * `true` when the data source is bound but the viewer can't read it. The block still
+     * initializes. Queries and writes that use this data source fail with
+     * `data_source_inaccessible`.
+     */
+    readonly inaccessible: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+}, undefined>;
+export type NotionDataSource = v.InferOutput<typeof notionDataSourceSchema>;

package/dist/protocol/dataSources/notionDataSource.js

@@ -0,0 +1,38 @@
+import * as v from "valibot";
+import { collectionPointerValidator } from "./collectionPointer.js";
+import { notionCollectionSchemaValidator } from "./collectionSchema.js";
+import { notionPropertySchemaSchema } from "./properties/propertySchema.js";
+export const notionDataSourceSchema = v.object({
+    key: v.string(),
+    collectionPointer: v.optional(collectionPointerValidator),
+    /**
+     * Describes database properties. Use this schema to resolve property bindings. Use this
+     * schema to validate filter and sort references. Undefined when the host does not provide a
+     * database schema.
+     */
+    collectionSchema: v.optional(notionCollectionSchemaValidator),
+    /**
+     * Maps user-defined property keys to database property IDs. Use this map to resolve a key
+     * such as `name` to its database property ID. A value of `undefined` marks a declared
+     * property without a valid binding. Synthetic metadata does not add entries to this map.
+     */
+    propertyIdsByKey: v.record(v.string(), v.optional(v.string())),
+    /**
+     * Describes property values in query snapshots. Keys use the same property IDs as a snapshot's
+     * `propertiesById` map.
+     *
+     * Includes four synthetic metadata fields, even when the database schema is unavailable:
+     * `created_time`, `last_edited_time`, `created_by`, and `last_edited_by`. Also includes
+     * database properties when the host provides their schema.
+     *
+     * Use `propertiesById` to read a value. Use this map to read the value's schema. Use
+     * `collectionSchema` to validate filter and sort references.
+     */
+    propertySchemasById: v.record(v.string(), notionPropertySchemaSchema),
+    /**
+     * `true` when the data source is bound but the viewer can't read it. The block still
+     * initializes. Queries and writes that use this data source fail with
+     * `data_source_inaccessible`.
+     */
+    inaccessible: v.optional(v.literal(true)),
+});

package/dist/protocol/dataSources/resolveDataSourceBinding.d.ts

@@ -0,0 +1,32 @@
+import type { ManifestDataSource } from "../manifest/manifest.js";
+import type { NotionCollectionSchema } from "./collectionSchema.js";
+export type MappedPropertyBinding = {
+    status: "mapped";
+    propertyKey: string;
+    propertyId: string;
+};
+export type ResolvedPropertyBinding = MappedPropertyBinding | {
+    status: "missing";
+    propertyKey: string;
+    propertyId: undefined;
+} | {
+    status: "invalid" | "incompatible";
+    propertyKey: string;
+    propertyId: string;
+};
+export type ResolvedDataSourceBinding = {
+    status: "complete";
+    properties: MappedPropertyBinding[];
+} | {
+    status: "incomplete" | "missing_schema";
+    properties: ResolvedPropertyBinding[];
+};
+/**
+ * Resolves explicit property mappings against the manifest and source schema.
+ * Each boundary calls this independently and chooses its own errors or UI behavior.
+ */
+export declare function resolveDataSourceBinding(args: {
+    manifestDataSource: ManifestDataSource;
+    collectionSchema: Pick<NotionCollectionSchema, "propertiesById"> | undefined;
+    propertyIdsByKey: Record<string, string | undefined> | undefined;
+}): ResolvedDataSourceBinding;

package/dist/protocol/dataSources/resolveDataSourceBinding.js

@@ -0,0 +1,33 @@
+/**
+ * Resolves explicit property mappings against the manifest and source schema.
+ * Each boundary calls this independently and chooses its own errors or UI behavior.
+ */
+export function resolveDataSourceBinding(args) {
+    const properties = Object.entries(args.manifestDataSource.properties ?? {}).map(([propertyKey, property]) => {
+        const propertyId = args.propertyIdsByKey?.[propertyKey];
+        const mappedSchema = propertyId === undefined
+            ? undefined
+            : args.collectionSchema?.propertiesById[propertyId];
+        return resolvePropertyBinding(propertyKey, propertyId, mappedSchema?.type, property.type);
+    });
+    if (args.collectionSchema === undefined) {
+        return { status: "missing_schema", properties };
+    }
+    if (properties.every(property => property.status === "mapped")) {
+        return { status: "complete", properties };
+    }
+    return { status: "incomplete", properties };
+}
+function resolvePropertyBinding(propertyKey, propertyId, actualType, expectedType) {
+    if (propertyId === undefined) {
+        return { status: "missing", propertyKey, propertyId };
+    }
+    if (actualType === undefined) {
+        return { status: "invalid", propertyKey, propertyId };
+    }
+    return {
+        status: actualType === expectedType ? "mapped" : "incompatible",
+        propertyKey,
+        propertyId,
+    };
+}

package/dist/protocol/{messages → handshake}/connect.d.ts

@@ -38,6 +38,10 @@ export declare const connectMessageSchema: v.VariantSchema<"status", [v.ObjectSc
                 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>, undefined>;
 }, undefined>, v.ObjectSchema<{
     readonly type: v.LiteralSchema<"connect", undefined>;

package/dist/protocol/{messages → handshake}/connect.js

@@ -1,6 +1,6 @@
 import * as v from "valibot";
-import { customBlockErrorInfoSchema } from "../errors.js";
-import { manifestSchema } from "../manifest.js";
+import { manifestSchema } from "../manifest/manifest.js";
+import { customBlockErrorInfoSchema } from "../utils/errors.js";
 const connectMessageCommonEntries = {
     type: v.literal("connect"),
     initializationId: v.string(),

package/dist/protocol/{messages → handshake}/init.d.ts

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
+import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../utils/errors.js";
 import type { CustomBlockInitResultErrorCode } from "./initResult.js";
 export declare const customBlockInitErrorCodeSchema: v.StringSchema<undefined>;
 export type CustomBlockInitErrorCode = CustomBlockErrorCode<"manifest_unavailable" | "manifest_invalid" | "invalid_local_preview_url" | "invalid_connect_payload" | "invalid_protocol_version" | "unsupported_protocol_version" | "init_timeout" | "context_unavailable" | "current_user_unavailable" | "initial_state_timeout" | "missing_data_source_binding" | "data_source_unavailable" | "missing_property_binding" | "invalid_property_binding">;
@@ -102,6 +102,10 @@ export declare const initMessageSchema: v.VariantSchema<"status", [v.ObjectSchem
                 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<{
@@ -248,6 +252,7 @@ export declare const initMessageSchema: v.VariantSchema<"status", [v.ObjectSchem
                 }, 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<{

package/dist/protocol/{messages → handshake}/init.js

@@ -1,12 +1,12 @@
 import * as v from "valibot";
-import { notionContrastModeSchema } from "../contrast.js";
-import { notionDataSourceBindingsSchema } from "../dataSources/dataSource.js";
-import { notionBlockIdSchema } from "../ids.js";
-import { manifestSchema } from "../manifest.js";
-import { customBlockPageSchema } from "../pages/page.js";
-import { notionParentSchema } from "../parent.js";
-import { notionThemeSchema } from "../theme.js";
-import { notionUserSchema } from "../users/user.js";
+import { customBlockPageSchema } from "../context/containingPage.js";
+import { notionContrastModeSchema } from "../context/contrast.js";
+import { notionParentSchema } from "../context/parent.js";
+import { notionThemeSchema } from "../context/theme.js";
+import { bridgeDataSourceBindingsSchema } from "../dataSources/bridgeDataSourceBindings.js";
+import { manifestSchema } from "../manifest/manifest.js";
+import { bridgeUserSchema } from "../users/bridgeUser.js";
+import { notionBlockIdSchema } from "../utils/ids.js";
 // The schema accepts any string code. The type lists known codes for
 // autocomplete, with an open string fallback for newer senders.
 export const customBlockInitErrorCodeSchema = v.string();
@@ -44,9 +44,9 @@ export const initMessageSchema = v.variant("status", [
         page: customBlockPageSchema,
         manifest: manifestSchema,
         dataSources: v.object({
-            bindings: notionDataSourceBindingsSchema,
+            bindings: bridgeDataSourceBindingsSchema,
         }),
-        currentUser: notionUserSchema,
+        currentUser: bridgeUserSchema,
     }),
     v.object({
         type: v.literal("init"),

package/dist/protocol/{messages → handshake}/initResult.d.ts

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../errors.js";
+import type { CustomBlockErrorCode, CustomBlockErrorInfo } from "../utils/errors.js";
 export declare const customBlockInitResultErrorCodeSchema: v.StringSchema<undefined>;
 export type CustomBlockInitResultErrorCode = CustomBlockErrorCode<
 /**

package/dist/protocol/{messages → handshake}/isInitHandshakeMessage.d.ts

@@ -1,4 +1,4 @@
-import type { HostToSandboxMessage } from "./hostToSandbox.js";
-import type { SandboxToHostMessage } from "./sandboxToHost.js";
+import type { HostToSandboxMessage } from "../messages/hostToSandbox.js";
+import type { SandboxToHostMessage } from "../messages/sandboxToHost.js";
 /** Returns whether a message belongs to the initialization handshake. */
 export declare function isInitHandshakeMessage(message: SandboxToHostMessage | HostToSandboxMessage): boolean;