@notionhq/apps 0.0.19 → 0.0.21

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

@@ -1,11 +1,59 @@
-import { type Parent, type ResourceId } from "./intents.js";
+import { type PageCoverReference, type Parent, type ResourceId } from "./intents.js";
 import { type ChildDatabaseFactory } from "./database.js";
+/**
+ * A single text token: plain text as `[string]`, or text with annotations as
+ * `[string, ...annotations]`.
+ */
+export type SimpleTextToken = [string] | [string, ...unknown[]];
+/**
+ * The JSON-serializable text format returned by Notion-as-Code text helpers.
+ */
+export type TextValue = SimpleTextToken[];
+export type VerificationInput = {
+    state: "verified";
+    /** Set an expiration with `notion.datetime(...)`; omit it for indefinite verification. */
+    datetime?: TextValue;
+} | {
+    state: "unverified";
+};
+export type VerificationPropertyValue = VerificationInput & {
+    type: "verification";
+};
+/**
+ * A page property value accepted by Notion as Code.
+ *
+ * Use helpers from `@notionhq/apps/notion-as-code` to construct rich values
+ * such as text, dates, checkboxes, and URLs.
+ */
+export type PropertyValue = string | number | TextValue | string[] | VerificationPropertyValue | undefined;
+/**
+ * Arguments for declaring a page.
+ *
+ * For a regular page, set its title through
+ * `properties.title: notion.text("My Page Title")`. For a database page, use
+ * the title property's schema name instead of `title`.
+ */
 export type PageArgs = {
     resourceId: ResourceId;
     /** Omit to create a private top-level page in the Apps workspace. */
     parent?: Parent;
-    cover?: unknown;
-    properties?: Record<string, unknown>;
+    cover?: PageCoverReference;
+    /**
+     * Page properties, including the page title.
+     *
+     * @example Regular page
+     * properties: { title: notion.text("My Page Title") }
+     *
+     * @example Database page
+     * properties: { Name: notion.text("Task Name"), Status: "In Progress" }
+     */
+    properties?: Record<string, PropertyValue | undefined>;
+    /**
+     * Page body in Notion-flavored Markdown.
+     *
+     * Markdown headings create child blocks. They do not set the page title;
+     * set a regular page's title with `properties.title`.
+     */
     content?: string;
     fullWidth?: boolean;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,MAAM,EACX,KAAK,UAAU,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAI/E,MAAM,MAAM,QAAQ,GAAG;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,UAAU,CAAC;CAC7C,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAS/C;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAgBrF"}
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,kBAAkB,EACvB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAI/E;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;AAE1C,MAAM,MAAM,iBAAiB,GAC1B;IACA,KAAK,EAAE,UAAU,CAAC;IAClB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,SAAS,CAAC;CACpB,GACD;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAE3B,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,GAAG;IAC3D,IAAI,EAAE,cAAc,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACtB,MAAM,GACN,MAAM,GACN,SAAS,GACT,MAAM,EAAE,GACR,yBAAyB,GACzB,SAAS,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC;IACvD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,UAAU,CAAC;CAC7C,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAS/C;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAgBrF"}

package/dist/notion-as-code/page.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=page.test.d.ts.map

package/dist/notion-as-code/page.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.test.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/page.test.ts"],"names":[],"mappings":""}

package/package.json

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

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

@@ -75,7 +75,8 @@ root exports support:
 
 - `teamspace({ resourceId, name, accessLevel })`, with `addPage` and
   `teamspace.addDatabase(id, args)` on the returned handle.
-- `page({ resourceId, parent?, properties?, content? })`, with
+- `page({ resourceId, parent?, properties?, content? })`; regular page titles use
+  `properties: { title: notion.text("My Page Title") }`. It also has
   `addPage` and `page.addDatabase(id, args)` for children.
 - `database(resourceId, { dataSourceResourceId, name, schema, parent?, views? })`,
   returning a single source as `handle.dataSource`, or
@@ -90,6 +91,11 @@ root exports support:
   Use property resource IDs in view filters, sorts, and layout options; calendar
   views require `calendarBy`, and timeline views require `timelineBy`.
 
+For a regular page, set the title with
+`properties: { title: notion.text("My Page Title") }`. A Markdown heading in
+`content` creates a child heading block; it does not set the page title. For a
+database page, use the title property's schema name instead of `title`.
+
 A database declaration must include at least one data source or at least one
 view. A linked-only database may omit `datasources`, or use `datasources: {}`,
 only when `views` is nonempty. `{}`, `{ datasources: {} }`, and
@@ -118,12 +124,17 @@ 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.
 
-Several fields, including database covers and custom-agent triggers,
-still have incomplete types. A field typed as `unknown` is not proof
-that any payload is supported. Check implementation and examples before using
-it; do not assume parity with other Notion as Code packages. Database views are
-typed with `ViewSchema`; standalone declarations accept `ViewArgs`, which adds
-the owning `databaseResourceId`.
+Page and database covers accept `{ type: "url", url, position? }`. Custom-agent
+triggers are discriminated unions for recurrence, page-added, and
+property-updated triggers. Weekly recurrences require at least one weekday, and
+property-updated triggers require property conditions or
+`triggerWhenPageContentEdited: true`.
+
+Database page layouts are typed against their keyed data-source schema. Reference
+property resource IDs, not schema keys. The SDK restricts relation groups to
+relation properties and narrows standalone property styles by property type.
+Database views are typed with `ViewSchema`; standalone declarations accept
+`ViewArgs`, which adds the owning `databaseResourceId`.
 
 The Apps SDK exposes a subset of Notion as Code. Data sources are nested inside
 `database(resourceId, { datasources: { ... } })`, not declared by a separate
@@ -131,8 +142,7 @@ The Apps SDK exposes a subset of Notion as Code. Data sources are nested inside
 Apps deployment rejects workspace creation or changes and supplies the App's
 workspace binding itself. Value helpers and types stay on their existing
 subpaths. For example, import `{ notion }` from `@notionhq/apps/notion-as-code`
-for `notion.text(...)` or `notion.file(resourceId)`. The latter creates a file
-reference, not an upload or file declaration. These helpers are not root exports.
+for `notion.text(...)`. These helpers are not root exports.
 CLI acceptance of a serialized intent envelope alone does not establish server
 support for its contents.
 

package/skills/workflow/SKILL.md

@@ -120,10 +120,12 @@ guide page in `src/workflows/sayHello/lib/notion.ts`:
 
 ```ts
 import { page } from "@notionhq/apps";
+import { notion } from "@notionhq/apps/notion-as-code";
 
 export const guide = page({
 	resourceId: "workflow-guide",
-	content: "# Workflow guide\nThis App runs a scheduled workflow.",
+	properties: { title: notion.text("Workflow guide") },
+	content: "This App runs a scheduled workflow.",
 });
 ```
 

package/src/notion-as-code/custom-agent.test.ts

@@ -0,0 +1,79 @@
+import { describe, expect, it } from "vitest";
+
+import { notion } from "./index.js";
+import { finishMetadataRecording, startMetadataRecording } from "./recorder.js";
+
+describe("Notion-as-Code custom agent declarations", () => {
+	it("records typed recurrence and database triggers", () => {
+		const recorder = startMetadataRecording();
+
+		notion.customAgent({
+			resourceId: "triage-agent",
+			name: "Triage agent",
+			triggers: [
+				{
+					type: "recurrence",
+					resourceId: "weekday-trigger",
+					frequency: "week",
+					interval: 1,
+					start: "2026-09-21T09:00:00",
+					timeZone: "America/Los_Angeles",
+					weekdays: { MO: true, FR: true },
+				},
+				{
+					type: "property_updated",
+					resourceId: "task-update-trigger",
+					dataSourceResourceId: "tasks",
+					propertyConditions: {
+						status: { type: "property_edited" },
+					},
+					triggerWhenPageContentEdited: true,
+				},
+			],
+		});
+
+		expect(finishMetadataRecording(recorder).intents).toEqual([
+			{
+				type: "custom_agent",
+				resourceId: "triage-agent",
+				name: "Triage agent",
+				triggers: [
+					{
+						type: "recurrence",
+						resourceId: "weekday-trigger",
+						frequency: "week",
+						interval: 1,
+						start: "2026-09-21T09:00:00",
+						timeZone: "America/Los_Angeles",
+						weekdays: { MO: true, FR: true },
+					},
+					{
+						type: "property_updated",
+						resourceId: "task-update-trigger",
+						dataSourceResourceId: "tasks",
+						propertyConditions: {
+							status: { type: "property_edited" },
+						},
+						triggerWhenPageContentEdited: true,
+					},
+				],
+			},
+		]);
+	});
+
+	it("rejects reserved resource IDs inside triggers", () => {
+		expect(() =>
+			notion.customAgent({
+				resourceId: "triage-agent",
+				name: "Triage agent",
+				triggers: [
+					{
+						type: "page_added",
+						resourceId: "__notion_apps_trigger",
+						dataSourceResourceId: "tasks",
+					},
+				],
+			}),
+		).toThrow("reserved");
+	});
+});

package/src/notion-as-code/custom-agent.ts

@@ -2,6 +2,105 @@ import type { CustomAgentIntent, NotionAsCodeIcon, ResourceId } from "./intents.
 import { recordIntent } from "./recorder.js";
 import { assertUserResourceId } from "./resource.js";
 
+type RecurrenceWeekday = "MO" | "TU" | "WE" | "TH" | "FR" | "SA" | "SU";
+
+/** A nonempty selection of weekdays for a weekly recurrence. */
+export type RecurrenceWeekdays = {
+	[Day in RecurrenceWeekday]?: true;
+} & {
+	[Day in RecurrenceWeekday]: Required<Pick<Record<RecurrenceWeekday, true>, Day>>;
+}[RecurrenceWeekday];
+
+export type MonthlyWeekdayOccurrence = "1st" | "2nd" | "3rd" | "4th" | "last";
+
+export type MonthlyRecurrenceRestriction =
+	| { type: "day_of_month"; day: number }
+	| {
+			type: "weekday_of_month";
+			weekday: RecurrenceWeekday;
+			occurrence: MonthlyWeekdayOccurrence;
+	  };
+
+export type RecurrenceScheduleEnd =
+	| { type: "date"; endsAt: string }
+	| { type: "occurrences"; count: number };
+
+type RecurrenceScheduleBase = {
+	interval: number;
+	start: string;
+	timeZone: string;
+	end?: RecurrenceScheduleEnd;
+};
+
+export type HourlyRecurrenceSchedule = RecurrenceScheduleBase & {
+	frequency: "hour";
+};
+
+export type DailyRecurrenceSchedule = RecurrenceScheduleBase & {
+	frequency: "day";
+};
+
+export type WeeklyRecurrenceSchedule = RecurrenceScheduleBase & {
+	frequency: "week";
+	weekdays: RecurrenceWeekdays;
+};
+
+export type MonthlyRecurrenceSchedule = RecurrenceScheduleBase & {
+	frequency: "month";
+	monthlyRestriction: MonthlyRecurrenceRestriction;
+};
+
+export type YearlyRecurrenceSchedule = RecurrenceScheduleBase & {
+	frequency: "year";
+};
+
+export type CustomAgentRecurrenceSchedule = (
+	| HourlyRecurrenceSchedule
+	| DailyRecurrenceSchedule
+	| WeeklyRecurrenceSchedule
+	| MonthlyRecurrenceSchedule
+	| YearlyRecurrenceSchedule
+) & {
+	type: "recurrence";
+};
+
+export type CustomAgentTriggerBase = {
+	resourceId: ResourceId;
+	enabled?: boolean;
+};
+
+export type CustomAgentRecurrenceTrigger = CustomAgentTriggerBase & CustomAgentRecurrenceSchedule;
+
+export type PropertyTriggerCondition = {
+	type: "property_edited";
+};
+
+export type CustomAgentPageAddedTrigger = CustomAgentTriggerBase & {
+	type: "page_added";
+	dataSourceResourceId: ResourceId;
+};
+
+type PropertyUpdatedTriggerTarget =
+	| {
+			propertyConditions: Readonly<Record<ResourceId, PropertyTriggerCondition>>;
+			triggerWhenPageContentEdited?: boolean;
+	  }
+	| {
+			propertyConditions?: never;
+			triggerWhenPageContentEdited: true;
+	  };
+
+export type CustomAgentPropertyUpdatedTrigger = CustomAgentTriggerBase &
+	PropertyUpdatedTriggerTarget & {
+		type: "property_updated";
+		dataSourceResourceId: ResourceId;
+	};
+
+export type CustomAgentTrigger =
+	| CustomAgentRecurrenceTrigger
+	| CustomAgentPageAddedTrigger
+	| CustomAgentPropertyUpdatedTrigger;
+
 export type CustomAgentArgs = {
 	resourceId: ResourceId;
 	name: string;
@@ -9,8 +108,7 @@ export type CustomAgentArgs = {
 	instructions?: string;
 	model?: "ambrosia-tart-high" | "opal-quince-medium" | "almond-croissant-low";
 	sharedResources?: readonly ResourceId[];
-	// TODO: Port custom agent trigger types.
-	triggers?: readonly unknown[];
+	triggers?: readonly CustomAgentTrigger[];
 };
 
 export type CustomAgentHandle = {
@@ -24,6 +122,17 @@ export function customAgent(args: CustomAgentArgs): CustomAgentHandle {
 	for (const resourceId of args.sharedResources ?? []) {
 		assertUserResourceId(resourceId);
 	}
+	for (const trigger of args.triggers ?? []) {
+		assertUserResourceId(trigger.resourceId);
+		if (trigger.type === "page_added" || trigger.type === "property_updated") {
+			assertUserResourceId(trigger.dataSourceResourceId);
+		}
+		if (trigger.type === "property_updated") {
+			for (const propertyResourceId of Object.keys(trigger.propertyConditions ?? {})) {
+				assertUserResourceId(propertyResourceId);
+			}
+		}
+	}
 	recordIntent({ type: "custom_agent", ...args } satisfies {
 		type: "custom_agent";
 	} & CustomAgentIntent);

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

@@ -8,6 +8,44 @@ import { APPS_WORKSPACE_RESOURCE_ID } from "./intents.js";
 import { finishMetadataRecording, startMetadataRecording } from "./recorder.js";
 
 describe("Notion-as-Code database declarations", () => {
+	it("records a single-source page layout on the data source", () => {
+		const recorder = startMetadataRecording();
+
+		notion.database("layout-database", {
+			dataSourceResourceId: "layout-source",
+			name: "Tasks",
+			schema: {
+				Name: { type: "title", resourceId: "name" },
+				Estimate: { type: "number", resourceId: "estimate" },
+			},
+			pageLayout: {
+				main: [
+					{ type: "properties", properties: [{ property: "name" }] },
+					{ type: "property", property: "estimate", style: "large" },
+				],
+				pinnedProperties: ["estimate"],
+			},
+		});
+
+		expect(finishMetadataRecording(recorder).intents).toEqual([
+			expect.objectContaining({
+				resourceId: "layout-database",
+				dataSources: [
+					expect.objectContaining({
+						resourceId: "layout-source",
+						pageLayout: {
+							main: [
+								{ type: "properties", properties: [{ property: "name" }] },
+								{ type: "property", property: "estimate", style: "large" },
+							],
+							pinnedProperties: ["estimate"],
+						},
+					}),
+				],
+			}),
+		]);
+	});
+
 	it("converts the single-source form with keyed schemas and resolved property names", () => {
 		const recorder = startMetadataRecording();
 		const schema = {

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

@@ -2,6 +2,7 @@ import type { Database } from "../database.js";
 import {
 	APPS_WORKSPACE_RESOURCE_ID,
 	type DatabaseIntent,
+	type DatabasePageLayout,
 	type DataSourceDefinition,
 	type NotionAsCodeIcon,
 	type NotionAsCodeProperty,
@@ -26,6 +27,7 @@ export type DataSourceArgs<Schema extends NotionAsCodeSchema = NotionAsCodeSchem
 	name?: never;
 	schema: Schema;
 	icon?: NotionAsCodeIcon;
+	pageLayout?: DatabasePageLayout<Schema>;
 };
 
 /** Data sources keyed by the names used to access their handles. */
@@ -42,6 +44,7 @@ type SingleSourceDatabaseOptions<Schema extends NotionAsCodeSchema = NotionAsCod
 	dataSourceResourceId: ResourceId;
 	name: string;
 	schema: Schema;
+	pageLayout?: DatabasePageLayout<Schema>;
 	datasources?: never;
 };
 
@@ -61,6 +64,7 @@ type MultiSourceDatabaseOptions<DataSources extends DataSourceMap = DataSourceMa
 		datasources: DataSources;
 		dataSourceResourceId?: never;
 		schema?: never;
+		pageLayout?: never;
 	} & (keyof NoInfer<DataSources> extends never
 			? { views: NonEmptyViewSchemas }
 			: { views?: readonly ViewSchema[] });
@@ -76,6 +80,7 @@ type ViewOnlyDatabaseOptions = DatabaseMetadata & {
 	datasources?: never;
 	dataSourceResourceId?: never;
 	schema?: never;
+	pageLayout?: never;
 	views: NonEmptyViewSchemas;
 };
 
@@ -255,6 +260,7 @@ function buildDatabaseHandle(
 			resourceId: args.dataSourceResourceId,
 			name: args.name,
 			properties: normalizeProperties(args.schema),
+			...(args.pageLayout === undefined ? {} : { pageLayout: args.pageLayout }),
 		};
 		const handle = recordDatabase(databaseResourceId, args, parent, [
 			{ key: "dataSource", schema: args.schema, definition: source },
@@ -295,6 +301,7 @@ function normalizeDatabaseMetadata(args: DatabaseArgs): DatabaseMetadata {
 		schema: _schema,
 		datasources: _datasources,
 		dataSourceResourceId: _dataSourceResourceId,
+		pageLayout: _pageLayout,
 		...metadata
 	} = args;
 	return metadata;

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

@@ -1,5 +1,7 @@
+import type { TextValue } from "./page.js";
+
 /** Serialize Notion-as-Code date values for Apps property payloads. */
-export function date(startDate: string, endDate?: string): unknown[][] {
+export function date(startDate: string, endDate?: string): TextValue {
 	const start_date = parseIsoDate(startDate);
 	const end_date = endDate === undefined ? undefined : parseIsoDate(endDate);
 	if (end_date !== undefined && end_date < start_date) {
@@ -13,7 +15,7 @@ export function date(startDate: string, endDate?: string): unknown[][] {
 }
 
 /** Serialize Notion-as-Code datetime values for Apps property payloads. */
-export function datetime(value: { start: string; end?: string; timeZone?: string }): unknown[][] {
+export function datetime(value: { start: string; end?: string; timeZone?: string }): TextValue {
 	const timeZone = value.timeZone ?? "UTC";
 	try {
 		new Intl.DateTimeFormat("en-US", { timeZone }).format();

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

@@ -1,8 +1,12 @@
 import { customAgent } from "./custom-agent.js";
 import { database } from "./database.js";
 import { date, datetime } from "./date.js";
-import { page } from "./page.js";
-import { assertUserResourceId } from "./resource.js";
+import {
+	page,
+	type TextValue,
+	type VerificationInput,
+	type VerificationPropertyValue,
+} from "./page.js";
 import { teamspace } from "./teamspace.js";
 import { view } from "./view.js";
 
@@ -12,22 +16,22 @@ const notionAsCodeFacade = {
 	page,
 	customAgent,
 	view,
-	text: (value: string) => [[value]],
-	number: (value: number) => [[String(value)]],
+	text: (value: string): TextValue => [[value]],
+	number: (value: number): TextValue => [[String(value)]],
 	date,
 	datetime,
+	verification: (value: VerificationInput): VerificationPropertyValue => ({
+		...value,
+		type: "verification",
+	}),
 	select: (value: string) => value,
 	status: (value: string) => value,
 	multiSelect: (values: readonly string[]) => values.join(","),
-	checkbox: (value: boolean) => [[value ? "Yes" : "No"]],
-	url: (value: string) => [[value, [["a", value]]]],
-	email: (value: string) => [[value, [["a", `mailto:${value}`]]]],
-	phone: (value: string) => [[value]],
+	checkbox: (value: boolean): TextValue => [[value ? "Yes" : "No"]],
+	url: (value: string): TextValue => [[value, [["a", value]]]],
+	email: (value: string): TextValue => [[value, [["a", `mailto:${value}`]]]],
+	phone: (value: string): TextValue => [[value]],
 	relation: (value: string | readonly string[]) => (Array.isArray(value) ? [...value] : value),
-	file: (resourceId: string) => {
-		assertUserResourceId(resourceId);
-		return { type: "file" as const, resourceId };
-	},
 };
 
 export type NotionAsCodeFacade = typeof notionAsCodeFacade;

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

@@ -2,6 +2,9 @@ import { createNotion } from "./handles.js";
 
 export { APPS_RESERVED_RESOURCE_ID_PREFIX, APPS_WORKSPACE_RESOURCE_ID } from "./intents.js";
 export type {
+	ContentPageLayoutTab,
+	DatabasePageLayout,
+	DatabasePageLayoutTab,
 	DatabaseIntent,
 	DataSourceDefinition,
 	NotionAsCodeIcon,
@@ -10,10 +13,45 @@ export type {
 	NotionAsCodeSchema,
 	NotionAsCodeSelectOption,
 	NotionAsCodeStatusOption,
+	PageCoverReference,
+	PageLayoutMainModule,
+	PageLayoutNumberAndFormulaStyle,
+	PageLayoutPersonStyle,
+	PageLayoutPropertiesModule,
+	PageLayoutPropertyConfig,
+	PageLayoutPropertyModule,
+	PageLayoutPropertySection,
+	PageLayoutRelationConfig,
+	PageLayoutRelationsGroupModule,
+	PageLayoutSidebarModule,
 	Parent,
 	ResourceId,
+	RollupBaseAggregationType,
+	RollupDateAggregationType,
+	RollupNumberAggregationType,
+	RollupTargetPropertyType,
+	ViewPageLayoutTab,
 } from "./intents.js";
-export type { CustomAgentArgs, CustomAgentHandle } from "./custom-agent.js";
+export type {
+	CustomAgentArgs,
+	CustomAgentHandle,
+	CustomAgentPageAddedTrigger,
+	CustomAgentPropertyUpdatedTrigger,
+	CustomAgentRecurrenceSchedule,
+	CustomAgentRecurrenceTrigger,
+	CustomAgentTrigger,
+	CustomAgentTriggerBase,
+	DailyRecurrenceSchedule,
+	HourlyRecurrenceSchedule,
+	MonthlyRecurrenceRestriction,
+	MonthlyRecurrenceSchedule,
+	MonthlyWeekdayOccurrence,
+	PropertyTriggerCondition,
+	RecurrenceScheduleEnd,
+	RecurrenceWeekdays,
+	WeeklyRecurrenceSchedule,
+	YearlyRecurrenceSchedule,
+} from "./custom-agent.js";
 export type {
 	ChildDatabaseArgs,
 	ChildDatabaseFactory,
@@ -28,7 +66,16 @@ export type {
 	SingleSourceDatabaseArgs,
 	SingleSourceDatabaseHandle,
 } from "./database.js";
-export type { ChildPageArgs, PageArgs, PageHandle } from "./page.js";
+export type {
+	ChildPageArgs,
+	PageArgs,
+	PageHandle,
+	PropertyValue,
+	SimpleTextToken,
+	TextValue,
+	VerificationInput,
+	VerificationPropertyValue,
+} from "./page.js";
 export type { TeamspaceArgs, TeamspaceHandle } from "./teamspace.js";
 export type { ViewArgs, ViewHandle } from "./view.js";
 export type {