@notionhq/apps 0.0.47 → 0.0.48

package/dist/notion-as-code/resource.d.ts

@@ -1,6 +1,6 @@
 import { type Parent } from "./intents.js";
-/** Validate parent references accepted by Apps declarations. */
+/** Validate parent references. Reserved Apps IDs are allowed as parents. */
 export declare function assertParent(parent: Parent): void;
-/** Reject empty or runtime-reserved resource IDs in user declarations. */
+/** Reject empty or runtime-reserved IDs for created resources. */
 export declare function assertUserResourceId(resourceId: string): void;
 //# sourceMappingURL=resource.d.ts.map

package/dist/notion-as-code/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7E,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO7D"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7E,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOjD;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO7D"}

package/dist/notion-as-code/resource.js

@@ -3,7 +3,9 @@ function assertParent(parent) {
   if (parent.type !== "resourceId") {
     throw new Error("Notion-as-Code parents must reference a resourceId");
   }
-  assertUserResourceId(parent.resourceId);
+  if (parent.resourceId.length === 0) {
+    throw new Error("Notion-as-Code resourceId must be a non-empty string");
+  }
 }
 function assertUserResourceId(resourceId) {
   if (resourceId.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@notionhq/apps",
-	"version": "0.0.47",
+	"version": "0.0.48",
 	"description": "An SDK for building workflow apps for Notion",
 	"license": "MIT",
 	"bin": {

package/skills/notion-as-code/SKILL.md

@@ -155,8 +155,10 @@ Custom views do not accept standard view properties, sorts, or filters. Keep
 the view resource ID and the custom-block filename stable across builds.
 
 Keep resource IDs stable across builds. They identify declarations, not live
-Notion UUIDs. Avoid the reserved `__notion_apps_` prefix. Explicit parents
-use `{ type: "resourceId", resourceId: parent.resourceId }`; child helpers set
+Notion UUIDs. Do not create resources whose IDs use the reserved
+`__notion_apps_` prefix. Parenting to reserved IDs such as
+`__notion_apps_app_md__` is allowed. Explicit parents use
+`{ type: "resourceId", resourceId: parent.resourceId }`; child helpers set
 this reference for you. Pages and databases without a parent default to private
 top-level resources in the Apps workspace.
 

package/src/notion-as-code/database.test.ts

@@ -791,6 +791,32 @@ describe("Notion-as-Code database declarations", () => {
 		expect(serialized.description).toBe("Metadata source");
 	});
 
+	it("allows parenting a database to a reserved Apps resource ID", () => {
+		const recorder = startMetadataRecording();
+		notion.database("meetings-db", {
+			parent: { type: "resourceId", resourceId: "__notion_apps_app_md__" },
+			dataSourceResourceId: "meetings-source",
+			name: "Meetings",
+			schema: { Name: { resourceId: "meeting-name", type: "title" } },
+		});
+		expect(finishMetadataRecording(recorder).intents[0]).toEqual(
+			expect.objectContaining({
+				resourceId: "meetings-db",
+				parent: { type: "resourceId", resourceId: "__notion_apps_app_md__" },
+			}),
+		);
+	});
+
+	it("rejects creating a database whose resource ID uses the reserved Apps prefix", () => {
+		expect(() =>
+			notion.database("__notion_apps_meetings__", {
+				dataSourceResourceId: "meetings-source",
+				name: "Meetings",
+				schema: { Name: { resourceId: "meeting-name", type: "title" } },
+			}),
+		).toThrow('Resource ID "__notion_apps_meetings__" uses the reserved Apps prefix');
+	});
+
 	it("requires the status property configuration in authoring types", () => {
 		const invalidStatusDeclaration = () =>
 			notion.database("missing-status-options-database", {

package/src/notion-as-code/page.test.ts

@@ -28,6 +28,30 @@ describe("Notion-as-Code page declarations", () => {
 		]);
 	});
 
+	it("allows parenting a page to a reserved Apps resource ID", () => {
+		const recorder = startMetadataRecording();
+		notion.page({
+			resourceId: "guide",
+			parent: { type: "resourceId", resourceId: "__notion_apps_app_md__" },
+			properties: { title: notion.text("Guide") },
+		});
+		expect(finishMetadataRecording(recorder).intents[0]).toEqual(
+			expect.objectContaining({
+				resourceId: "guide",
+				parent: { type: "resourceId", resourceId: "__notion_apps_app_md__" },
+			}),
+		);
+	});
+
+	it("rejects creating a page whose resource ID uses the reserved Apps prefix", () => {
+		expect(() =>
+			notion.page({
+				resourceId: "__notion_apps_guide__",
+				properties: { title: notion.text("Guide") },
+			}),
+		).toThrow('Resource ID "__notion_apps_guide__" uses the reserved Apps prefix');
+	});
+
 	it("records a regular page title separately from Markdown content", () => {
 		const properties = {
 			title: notion.text("Workflow guide"),

package/src/notion-as-code/resource.ts

@@ -1,14 +1,16 @@
 import { APPS_RESERVED_RESOURCE_ID_PREFIX, type Parent } from "./intents.js";
 
-/** Validate parent references accepted by Apps declarations. */
+/** Validate parent references. Reserved Apps IDs are allowed as parents. */
 export function assertParent(parent: Parent): void {
 	if (parent.type !== "resourceId") {
 		throw new Error("Notion-as-Code parents must reference a resourceId");
 	}
-	assertUserResourceId(parent.resourceId);
+	if (parent.resourceId.length === 0) {
+		throw new Error("Notion-as-Code resourceId must be a non-empty string");
+	}
 }
 
-/** Reject empty or runtime-reserved resource IDs in user declarations. */
+/** Reject empty or runtime-reserved IDs for created resources. */
 export function assertUserResourceId(resourceId: string): void {
 	if (resourceId.length === 0) {
 		throw new Error("Notion-as-Code resourceId must be a non-empty string");