@notionhq/custom-blocks 0.0.73 → 0.0.75

package/HOST.md

@@ -119,6 +119,8 @@ Types:
 - `NotionDataSourceBindings` — keyed-by-semantic-key map of bindings, the shape carried in `init.dataSources` and `dataSourcesChanged`.
 - `NotionDataSourcePageBridge` — wire shape for a single page (raw property IDs in `propertiesById`). The SDK derives the consumer-facing `NotionDataSourcePage` from it.
 
+The host is authoritative for property bindings. The SDK validates each supplied property ID against the manifest and collection schema, but leaves omitted mappings unbound rather than inferring them from property IDs or names.
+
 Schemas:
 
 - `notionBlockIdSchema`
@@ -138,7 +140,7 @@ Messages sent from the sandbox to the host. Parse `window` `message` events with
 | -------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `ready`              | `ReadyMessage` / `readyMessageSchema`                     | One-shot handshake; carries `bridgeProtocolVersion`, `sdkVersion`, and the manifest.                                                                                                                                                    |
 | `queryDataSource`    | `QueryDataSourceMessage` / `queryDataSourceMessageSchema` | `requestId`-keyed request for the current rows in a raw `dataSourceId`. `snapshotId` names the SDK result slot to update, so later refreshes for the same `useDataSource` call replace the same snapshot instead of creating a new one. |
-| `createPage`         | `CreatePageMessage` / `createPageMessageSchema`           | `requestId`-keyed page creation; parent is `page_id` or `data_source_id`.                                                                                                                                                               |
+| `createPage`         | `CreatePageMessage` / `createPageMessageSchema`           | `requestId`-keyed page creation with properties and optional position; parent is `page_id` or `data_source_id`. Create-time icon and cover are not supported.                                                                            |
 | `getPage`            | `GetPageMessage` / `getPageMessageSchema`                 | `requestId`-keyed page fetch by page id.                                                                                                                                                                                                |
 | `updatePage`         | `UpdatePageMessage` / `updatePageMessageSchema`           | `requestId`-keyed patch (properties, icon, cover, or `archived`).                                                                                                                                                                       |
 | `getUser`            | `GetUserMessage` / `getUserMessageSchema`                 | `requestId`-keyed user fetch by user id.                                                                                                                                                                                                |

package/dist/bridge/SandboxBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SandboxBridge.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/SandboxBridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SandboxBridge.d.ts","sourceRoot":"","sources":["../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/SandboxBridge.ts"],"names":[],"mappings":"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"}

package/dist/bridge/SandboxBridge.js

@@ -506,12 +506,6 @@ export class SandboxBridge {
                 parent: resolvedParent.parent,
                 properties: resolvedProperties.properties,
             };
-            if (input.icon !== undefined) {
-                outbound.icon = input.icon;
-            }
-            if (input.cover !== undefined) {
-                outbound.cover = input.cover;
-            }
             if (input.position !== undefined) {
                 outbound.position = input.position;
             }

package/dist/bridge/dataSources/resolve.d.ts

@@ -1,6 +1,5 @@
 import type { CustomBlockManifest } from "../manifest.js";
 import type { NotionDataSource, NotionDataSourceBindings } from "./dataSource.js";
-import type { NotionPropertySchema } from "./propertySchema.js";
 type ResolveDataSourcesArgs = {
     manifest: CustomBlockManifest | null;
     dataSourceBindings: NotionDataSourceBindings;
@@ -9,14 +8,10 @@ type ResolveDataSourcesArgs = {
  * Builds the public {@link NotionDataSource} list the SDK exposes to consumers.
  *
  * Combines the host-supplied bindings (collection pointers + schemas) with the
- * manifest's declared data-source keys. When the manifest names a property
- * that isn't in `propertyIdsByKey`, falls back to {@link findPropertyIdByManifestProperty}
- * so renames in Notion still resolve as long as the schema name matches.
+ * manifest's declared data-source keys. Property mappings are host-owned: the
+ * SDK validates the supplied property id against the manifest and live schema,
+ * but does not infer a missing mapping.
  */
 export declare function resolveDataSources(args: ResolveDataSourcesArgs): NotionDataSource[];
-export declare function findPropertyIdByManifestProperty(propertySchemasById: Record<string, NotionPropertySchema>, manifestProperty: {
-    key: string;
-    type: NotionPropertySchema["type"];
-}): string | undefined;
 export {};
 //# sourceMappingURL=resolve.d.ts.map

package/dist/bridge/dataSources/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/dataSources/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,KAAK,EACX,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,KAAK,sBAAsB,GAAG;IAC7B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACpC,kBAAkB,EAAE,wBAAwB,CAAA;CAC5C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,sBAAsB,GAC1B,gBAAgB,EAAE,CA+CpB;AAED,wBAAgB,gCAAgC,CAC/C,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,EACzD,gBAAgB,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAA;CAAE,GACnE,MAAM,GAAG,SAAS,CAoBpB"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/dataSources/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,KAAK,EACX,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,iBAAiB,CAAA;AAExB,KAAK,sBAAsB,GAAG;IAC7B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACpC,kBAAkB,EAAE,wBAAwB,CAAA;CAC5C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,sBAAsB,GAC1B,gBAAgB,EAAE,CAyCpB"}

package/dist/bridge/dataSources/resolve.js

@@ -2,9 +2,9 @@
  * Builds the public {@link NotionDataSource} list the SDK exposes to consumers.
  *
  * Combines the host-supplied bindings (collection pointers + schemas) with the
- * manifest's declared data-source keys. When the manifest names a property
- * that isn't in `propertyIdsByKey`, falls back to {@link findPropertyIdByManifestProperty}
- * so renames in Notion still resolve as long as the schema name matches.
+ * manifest's declared data-source keys. Property mappings are host-owned: the
+ * SDK validates the supplied property id against the manifest and live schema,
+ * but does not infer a missing mapping.
  */
 export function resolveDataSources(args) {
     if (args.manifest === null) {
@@ -23,12 +23,7 @@ export function resolveDataSources(args) {
         const propertyIdsByKey = {};
         const manifestProperties = Object.entries(manifestDataSource.properties ?? {});
         for (const [propertyKey, manifestProperty] of manifestProperties) {
-            const propertyId = propertyKey in bindingPropertyIdsByKey
-                ? bindingPropertyIdsByKey[propertyKey]
-                : findPropertyIdByManifestProperty(propertySchemasById, {
-                    key: propertyKey,
-                    type: manifestProperty.type,
-                });
+            const propertyId = bindingPropertyIdsByKey[propertyKey];
             const propertySchema = propertyId === undefined ? undefined : propertySchemasById[propertyId];
             propertyIdsByKey[propertyKey] =
                 propertySchema?.type === manifestProperty.type
@@ -44,22 +39,3 @@ export function resolveDataSources(args) {
         };
     });
 }
-export function findPropertyIdByManifestProperty(propertySchemasById, manifestProperty) {
-    // `ManifestProperty.name` is display copy for setup UI. Binding fallback is based
-    // on the stable semantic key so copy changes don't affect property resolution.
-    const propertySchemaForKey = propertySchemasById[manifestProperty.key];
-    if (propertySchemaForKey?.type === manifestProperty.type) {
-        return manifestProperty.key;
-    }
-    const normalizedKey = normalizePropertyName(manifestProperty.key);
-    for (const [propertyId, propertySchema] of Object.entries(propertySchemasById)) {
-        if (propertySchema.type === manifestProperty.type &&
-            normalizePropertyName(propertySchema.name) === normalizedKey) {
-            return propertyId;
-        }
-    }
-    return undefined;
-}
-function normalizePropertyName(value) {
-    return value.trim().toLowerCase();
-}

package/dist/bridge/dataSources/resolveProperty.d.ts

@@ -25,7 +25,8 @@ export declare function resolvePropertyWriteMapForDataSource(args: {
     operationName: string;
 }): PropertyWriteMapResolutionResult;
 /**
- * Treats matching data-source keys as aliases for property IDs; all other identifiers are raw IDs.
+ * Treats bound data-source keys as aliases for property IDs. An unbound key may still be used as
+ * a raw ID when it exactly matches a property in the data source schema.
  */
 export declare function resolvePropertyIdentifierForDataSource(args: {
     dataSource: NotionDataSource | undefined;

package/dist/bridge/dataSources/resolveProperty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveProperty.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/dataSources/resolveProperty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EACX,0BAA0B,EAC1B,0BAA0B,EAC1B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIvD,eAAO,MAAM,kCAAkC,2BAAa,CAAA;AAE5D,MAAM,MAAM,4BAA4B,GACrC,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,wBAAwB,GACxB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEhB,MAAM,MAAM,4BAA4B,GACvC,oBAAoB,CAAC,4BAA4B,CAAC,CAAA;AAEnD,MAAM,MAAM,gCAAgC,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,0BAA0B,CAAA;CAAE,GAC7D;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,4BAA4B,CAAA;CAAE,CAAA;AAS3D;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IAC1D,UAAU,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACxC,UAAU,EAAE,0BAA0B,CAAA;IACtC,aAAa,EAAE,MAAM,CAAA;CACrB,GAAG,gCAAgC,CAwDnC;AAED;;GAEG;AACH,wBAAgB,sCAAsC,CAAC,IAAI,EAAE;IAC5D,UAAU,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;CACrB,GACE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,4BAA4B,CAAA;CAAE,CAiB1D"}
+{"version":3,"file":"resolveProperty.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/dataSources/resolveProperty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,KAAK,EACX,0BAA0B,EAC1B,0BAA0B,EAC1B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIvD,eAAO,MAAM,kCAAkC,2BAAa,CAAA;AAE5D,MAAM,MAAM,4BAA4B,GACrC,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,wBAAwB,GACxB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEhB,MAAM,MAAM,4BAA4B,GACvC,oBAAoB,CAAC,4BAA4B,CAAC,CAAA;AAEnD,MAAM,MAAM,gCAAgC,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,0BAA0B,CAAA;CAAE,GAC7D;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,4BAA4B,CAAA;CAAE,CAAA;AAS3D;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAAC,IAAI,EAAE;IAC1D,UAAU,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACxC,UAAU,EAAE,0BAA0B,CAAA;IACtC,aAAa,EAAE,MAAM,CAAA;CACrB,GAAG,gCAAgC,CAwDnC;AAED;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,IAAI,EAAE;IAC5D,UAAU,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;CACrB,GACE;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,4BAA4B,CAAA;CAAE,CAsB1D"}

package/dist/bridge/dataSources/resolveProperty.js

@@ -55,13 +55,19 @@ export function resolvePropertyWriteMapForDataSource(args) {
     return { status: "success", properties: resolvedProperties };
 }
 /**
- * Treats matching data-source keys as aliases for property IDs; all other identifiers are raw IDs.
+ * Treats bound data-source keys as aliases for property IDs. An unbound key may still be used as
+ * a raw ID when it exactly matches a property in the data source schema.
  */
 export function resolvePropertyIdentifierForDataSource(args) {
     const { dataSource, identifier, operationName } = args;
     if (dataSource !== undefined && identifier in dataSource.propertyIdsByKey) {
         const propertyId = dataSource.propertyIdsByKey[identifier];
         if (propertyId === undefined) {
+            // If the property is not bound to a key, check if it is a valid property ID. If so, we
+            // can use it directly.
+            if (identifier in dataSource.propertySchemasById) {
+                return { status: "success", propertyId: identifier };
+            }
             return {
                 status: "error",
                 error: makePropertyError("unmapped_property", `${operationName} cannot resolve property key "${identifier}" because it is not bound to a Notion property.`),

package/dist/bridge/messages/createPage.d.ts

@@ -175,40 +175,6 @@ export declare const createPageMessageSchema: v.ObjectSchema<{
         }, undefined>, undefined>;
         readonly id: v.StringSchema<undefined>;
     }, undefined>], undefined>, undefined>;
-    readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"emoji", undefined>;
-        readonly emoji: v.StringSchema<undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"custom_emoji", undefined>;
-        readonly custom_emoji: v.ObjectSchema<{
-            readonly id: v.StringSchema<undefined>;
-            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        }, undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"external", undefined>;
-        readonly external: v.ObjectSchema<{
-            readonly url: v.StringSchema<undefined>;
-        }, undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"file", undefined>;
-        readonly file: v.ObjectSchema<{
-            readonly url: v.StringSchema<undefined>;
-            readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        }, undefined>;
-    }, undefined>], undefined>, undefined>;
-    readonly cover: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"external", undefined>;
-        readonly external: v.ObjectSchema<{
-            readonly url: v.StringSchema<undefined>;
-        }, undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"file", undefined>;
-        readonly file: v.ObjectSchema<{
-            readonly url: v.StringSchema<undefined>;
-            readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        }, undefined>;
-    }, undefined>], undefined>, undefined>;
     readonly position: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
         readonly type: v.LiteralSchema<"start", undefined>;
     }, undefined>, v.ObjectSchema<{

package/dist/bridge/messages/createPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createPage.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/createPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAY5B;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;0BAKzC,CAAA;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CACnD,OAAO,8BAA8B,CACrC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;0BAMjC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAClD,OAAO,sBAAsB,CAC7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAQlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA"}
+{"version":3,"file":"createPage.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/createPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAQ5B;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;0BAKzC,CAAA;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CACnD,OAAO,8BAA8B,CACrC,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;0BAMjC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAClD,OAAO,sBAAsB,CAC7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAOlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA"}

package/dist/bridge/messages/createPage.js

@@ -1,6 +1,6 @@
 import * as v from "valibot";
 import { notionBlockIdSchema, notionDataSourceIdSchema, notionPageIdSchema, } from "../ids.js";
-import { notionPageCoverSchema, notionPageIconSchema, notionPagePropertyWriteMapSchema, } from "../pages/page.js";
+import { notionPagePropertyWriteMapSchema } from "../pages/page.js";
 /**
  * Describes where the newly created page should be inserted.
  * - `start` / `end` (default): prepend / append to the request's `parent`
@@ -40,7 +40,6 @@ export const createPageMessageSchema = v.object({
     requestId: v.string(),
     parent: createPageParentSchema,
     properties: notionPagePropertyWriteMapSchema,
-    icon: v.optional(notionPageIconSchema),
-    cover: v.optional(notionPageCoverSchema),
+    // TODO(custom-blocks): Add icon and cover once the Notion host supports them for page creation.
     position: v.optional(notionCreatePagePositionSchema),
 });

package/dist/bridge/messages/sandboxToHost.d.ts

@@ -178,40 +178,6 @@ export declare const sandboxToHostMessageSchema: v.UnionSchema<[v.UnionSchema<[v
         }, undefined>, undefined>;
         readonly id: v.StringSchema<undefined>;
     }, undefined>], undefined>, undefined>;
-    readonly icon: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"emoji", undefined>;
-        readonly emoji: v.StringSchema<undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"custom_emoji", undefined>;
-        readonly custom_emoji: v.ObjectSchema<{
-            readonly id: v.StringSchema<undefined>;
-            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        }, undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"external", undefined>;
-        readonly external: v.ObjectSchema<{
-            readonly url: v.StringSchema<undefined>;
-        }, undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"file", undefined>;
-        readonly file: v.ObjectSchema<{
-            readonly url: v.StringSchema<undefined>;
-            readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        }, undefined>;
-    }, undefined>], undefined>, undefined>;
-    readonly cover: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"external", undefined>;
-        readonly external: v.ObjectSchema<{
-            readonly url: v.StringSchema<undefined>;
-        }, undefined>;
-    }, undefined>, v.ObjectSchema<{
-        readonly type: v.LiteralSchema<"file", undefined>;
-        readonly file: v.ObjectSchema<{
-            readonly url: v.StringSchema<undefined>;
-            readonly expiry_time: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        }, undefined>;
-    }, undefined>], undefined>, undefined>;
     readonly position: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
         readonly type: v.LiteralSchema<"start", undefined>;
     }, undefined>, v.ObjectSchema<{

package/dist/bridge/messages/sandboxToHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxToHost.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/sandboxToHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAW5B;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAUrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAC/C,OAAO,0BAA0B,CACjC,CAAA"}
+{"version":3,"file":"sandboxToHost.d.ts","sourceRoot":"","sources":["../../../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/bridge/messages/sandboxToHost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAW5B;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAUrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAC/C,OAAO,0BAA0B,CACjC,CAAA"}

package/dist/types.d.ts

@@ -91,8 +91,6 @@ export type CreatePageParent = {
 export type CreatePageInput = {
     parent: CreatePageParent;
     properties: NotionPagePropertyInputMap;
-    icon?: NotionPageIcon;
-    cover?: NotionPageCover;
     position?: NotionCreatePagePosition;
 };
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../home/runner/work/custom-blocks/custom-blocks/sdk/src/types.ts"],"names":[],"mappings":"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"}

package/dist/version.js

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

package/docs/pages.md

@@ -10,7 +10,7 @@ Every helper follows the SDK's [error-handling contract](./errors.md). Check `re
 
 ## Creating pages
 
-`pages.create` mirrors Notion's [`POST /v1/pages`](https://developers.notion.com/reference/post-page). Pass a parent, a property map, and optionally an `icon` or `cover`:
+`pages.create` accepts a parent, a property map, and an optional position. Setting an icon or cover at creation time is not supported yet; create the page first, then use `pages.update`.
 
 ```ts
 const result = await pages.create({
@@ -22,7 +22,6 @@ const result = await pages.create({
     },
     dueDate: { type: "date", date: { start: "2026-06-01" } },
   },
-  icon: { type: "emoji", emoji: "📝" },
 });
 
 if (result.status === "success") {
@@ -118,7 +117,9 @@ To restore a page, call `pages.update({ pageId, archived: false })`.
 
 ## Icons, covers, and file uploads
 
-File-upload references aren't enabled for custom blocks yet. For icons, covers, and file properties, use one of:
+`pages.update` can set icons and covers, and returned `NotionPage` objects can contain both fields. `pages.create` cannot set them yet.
+
+File-upload references aren't enabled for custom blocks yet. When updating icons or covers, use one of:
 
 - An emoji icon — `{ type: "emoji", emoji: "🟢" }`
 - An external URL — `{ type: "external", external: { url: "https://example.com/cover.png" } }`

package/package.json

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

package/src/bridge/SandboxBridge.ts

@@ -660,12 +660,6 @@ export class SandboxBridge {
 				parent: resolvedParent.parent,
 				properties: resolvedProperties.properties,
 			}
-			if (input.icon !== undefined) {
-				outbound.icon = input.icon
-			}
-			if (input.cover !== undefined) {
-				outbound.cover = input.cover
-			}
 			if (input.position !== undefined) {
 				outbound.position = input.position
 			}

package/src/bridge/dataSources/resolve.ts

@@ -3,7 +3,6 @@ import type {
 	NotionDataSource,
 	NotionDataSourceBindings,
 } from "./dataSource.js"
-import type { NotionPropertySchema } from "./propertySchema.js"
 
 type ResolveDataSourcesArgs = {
 	manifest: CustomBlockManifest | null
@@ -14,9 +13,9 @@ type ResolveDataSourcesArgs = {
  * Builds the public {@link NotionDataSource} list the SDK exposes to consumers.
  *
  * Combines the host-supplied bindings (collection pointers + schemas) with the
- * manifest's declared data-source keys. When the manifest names a property
- * that isn't in `propertyIdsByKey`, falls back to {@link findPropertyIdByManifestProperty}
- * so renames in Notion still resolve as long as the schema name matches.
+ * manifest's declared data-source keys. Property mappings are host-owned: the
+ * SDK validates the supplied property id against the manifest and live schema,
+ * but does not infer a missing mapping.
  */
 export function resolveDataSources(
 	args: ResolveDataSourcesArgs,
@@ -43,13 +42,7 @@ export function resolveDataSources(
 				manifestDataSource.properties ?? {},
 			)
 			for (const [propertyKey, manifestProperty] of manifestProperties) {
-				const propertyId =
-					propertyKey in bindingPropertyIdsByKey
-						? bindingPropertyIdsByKey[propertyKey]
-						: findPropertyIdByManifestProperty(propertySchemasById, {
-								key: propertyKey,
-								type: manifestProperty.type,
-							})
+				const propertyId = bindingPropertyIdsByKey[propertyKey]
 				const propertySchema =
 					propertyId === undefined ? undefined : propertySchemasById[propertyId]
 				propertyIdsByKey[propertyKey] =
@@ -68,32 +61,3 @@ export function resolveDataSources(
 		},
 	)
 }
-
-export function findPropertyIdByManifestProperty(
-	propertySchemasById: Record<string, NotionPropertySchema>,
-	manifestProperty: { key: string; type: NotionPropertySchema["type"] },
-): string | undefined {
-	// `ManifestProperty.name` is display copy for setup UI. Binding fallback is based
-	// on the stable semantic key so copy changes don't affect property resolution.
-	const propertySchemaForKey = propertySchemasById[manifestProperty.key]
-	if (propertySchemaForKey?.type === manifestProperty.type) {
-		return manifestProperty.key
-	}
-
-	const normalizedKey = normalizePropertyName(manifestProperty.key)
-	for (const [propertyId, propertySchema] of Object.entries(
-		propertySchemasById,
-	)) {
-		if (
-			propertySchema.type === manifestProperty.type &&
-			normalizePropertyName(propertySchema.name) === normalizedKey
-		) {
-			return propertyId
-		}
-	}
-	return undefined
-}
-
-function normalizePropertyName(value: string): string {
-	return value.trim().toLowerCase()
-}

package/src/bridge/dataSources/resolveProperty.ts

@@ -102,7 +102,8 @@ export function resolvePropertyWriteMapForDataSource(args: {
 }
 
 /**
- * Treats matching data-source keys as aliases for property IDs; all other identifiers are raw IDs.
+ * Treats bound data-source keys as aliases for property IDs. An unbound key may still be used as
+ * a raw ID when it exactly matches a property in the data source schema.
  */
 export function resolvePropertyIdentifierForDataSource(args: {
 	dataSource: NotionDataSource | undefined
@@ -115,6 +116,11 @@ export function resolvePropertyIdentifierForDataSource(args: {
 	if (dataSource !== undefined && identifier in dataSource.propertyIdsByKey) {
 		const propertyId = dataSource.propertyIdsByKey[identifier]
 		if (propertyId === undefined) {
+			// If the property is not bound to a key, check if it is a valid property ID. If so, we
+			// can use it directly.
+			if (identifier in dataSource.propertySchemasById) {
+				return { status: "success", propertyId: identifier }
+			}
 			return {
 				status: "error",
 				error: makePropertyError(

package/src/bridge/messages/createPage.ts

@@ -4,11 +4,7 @@ import {
 	notionDataSourceIdSchema,
 	notionPageIdSchema,
 } from "../ids.js"
-import {
-	notionPageCoverSchema,
-	notionPageIconSchema,
-	notionPagePropertyWriteMapSchema,
-} from "../pages/page.js"
+import { notionPagePropertyWriteMapSchema } from "../pages/page.js"
 
 /**
  * Describes where the newly created page should be inserted.
@@ -59,8 +55,7 @@ export const createPageMessageSchema = v.object({
 	requestId: v.string(),
 	parent: createPageParentSchema,
 	properties: notionPagePropertyWriteMapSchema,
-	icon: v.optional(notionPageIconSchema),
-	cover: v.optional(notionPageCoverSchema),
+	// TODO(custom-blocks): Add icon and cover once the Notion host supports them for page creation.
 	position: v.optional(notionCreatePagePositionSchema),
 })
 

package/src/types.ts

@@ -109,8 +109,7 @@ export type CreatePageParent =
 export type CreatePageInput = {
 	parent: CreatePageParent
 	properties: NotionPagePropertyInputMap
-	icon?: NotionPageIcon
-	cover?: NotionPageCover
+	// TODO(custom-blocks): Add icon and cover once the Notion host supports them for page creation.
 	position?: NotionCreatePagePosition
 }