@notionhq/apps 0.0.47 → 0.0.49

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.49",
 	"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/skills/workflow/SKILL.md

@@ -156,7 +156,10 @@ configuration, and do not log secrets or private payloads.
 
 ## Manual workflow inputs
 
-Provide up to one `events.manual` to allow triggering the workflow manually from the UI or CLI for testing purposes.
+Provide up to one `events.manual()` to allow triggering the workflow from the UI
+or CLI on demand. For scheduled workflows, include it alongside
+`events.scheduled()` so users can run the workflow without waiting for the next
+scheduled time.
 
 Specify the inputs accepted using `@notionhq/apps/schema-builder`.
 
@@ -247,7 +250,7 @@ import { guide } from "./sayHello/lib/notion.js";
 export default workflow({
 	name: "Read guide",
 	description: "Reads the App's guide on a recurring schedule.",
-	triggers: [events.scheduled()],
+	triggers: [events.scheduled(), events.manual()],
 	access: { guide: access.view(guide) },
 	handler: async (_event, context) => {
 		await context.step("Read guide", () =>
@@ -262,11 +265,6 @@ declarations in `access` work too. Importing a declaration alone provisions the
 resource but does not create a `context.access` alias. An `access` entry declares
 the needed permission level and a named binding for that NaC resource.
 
-For a workflow that uses `events.scheduled()`, also declare a "triggers"
-database with a page-added trigger bound to it. This lets the user manually
-trigger a run at any time by adding a page to that database, without waiting
-for the schedule.
-
 `access.view()`, `access.comment()`, `access.edit()`, and `access.fullAccess()`
 accept page, database, and data-source handles. `access.call()` accepts custom-agent
 handles. Keys are workflow-local aliases. The handler's

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");