@notionhq/custom-blocks 0.0.74 → 0.0.76

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`

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/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.74"
+export const CUSTOM_BLOCKS_SDK_VERSION = "0.0.76"

package/package.json

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

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(