@notionhq/apps 0.0.14 → 0.0.15

package/README.md

@@ -3,6 +3,66 @@
 [![CI](https://github.com/makenotion/apps-sdk/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/makenotion/apps-sdk/actions/workflows/ci.yml?query=branch%3Amain)
 [![Publish](https://github.com/makenotion/apps-sdk/actions/workflows/publish.yml/badge.svg?branch=main)](https://github.com/makenotion/apps-sdk/actions/workflows/publish.yml?query=branch%3Amain)
 
+## Imports
+
+The package root exports only resource and capability creation helpers:
+
+```ts
+import {
+	page,
+	database,
+	teamspace,
+	customAgent,
+	sync,
+	workflow,
+	customBlock,
+} from "@notionhq/apps";
+```
+
+Import the helpers your app uses:
+
+```ts
+import { page, workflow } from "@notionhq/apps";
+
+const home = page({ resourceId: "home" });
+
+export default workflow({
+	name: "Follow up",
+	description: "Runs when a page is created",
+	triggers: ({ triggers }) => [triggers.notionPageCreated()],
+	handler: async () => {},
+});
+```
+
+Namespace imports (`import * as Notion from "@notionhq/apps"`) are also supported
+for autocomplete and API exploration.
+
+`sync` accepts a Notion-as-Code data-source handle. `customBlock` creates a custom-block
+capability; it is not the browser runtime object. The capability factories use these
+short names on both the root and their subpaths. Their behavior is unchanged.
+
+The old capability factory names are no longer exported. Update existing imports and calls:
+
+| Removed name           | Use instead   | Subpath                       |
+| ---------------------- | ------------- | ----------------------------- |
+| `createWorkflow`       | `workflow`    | `@notionhq/apps/workflow`     |
+| `createDataSourceSync` | `sync`        | `@notionhq/apps/sync`         |
+| `createCustomBlock`    | `customBlock` | `@notionhq/apps/custom-block` |
+
+Everything else keeps its subpath import, including builders, value helpers, types,
+connections, triggers, pacers, and the custom-block browser runtime:
+
+```ts
+import { Builder } from "@notionhq/apps/builder";
+import { notion } from "@notionhq/apps/notion-as-code";
+import type { DataSourceSyncConfiguration } from "@notionhq/apps/sync";
+```
+
+Existing subpaths remain available, with the capability factory renames above. The root
+uses explicit exports and does not re-export utility types or the custom-block browser runtime. Browser code should
+keep using `@notionhq/apps/custom-blocks` and `@notionhq/apps/react`; the root includes
+Node-only workflow code. Styles stay in `@notionhq/apps/nds.css`.
+
 ## Development
 
 1. Install [mise](https://mise.jdx.dev/getting-started.html)
@@ -14,13 +74,14 @@ The SDK requires Node 26 or newer. It supports workflows and database syncs.
 
 ```ts
 import { triggers } from "@notionhq/apps/triggers";
-import { connections, createWorkflow } from "@notionhq/apps/workflow";
+import { workflow } from "@notionhq/apps";
+import { connections } from "@notionhq/apps/workflow";
 ```
 
 Add a connection requirement to a workflow when it needs Calendar:
 
 ```ts
-export default createWorkflow({
+export default workflow({
 	name: "Schedule follow-up",
 	description: "Schedules a follow-up after a page is created",
 	triggers: [triggers.notionPageCreated()],
@@ -37,26 +98,30 @@ Use `context.notion` for Notion API calls. Deployed apps receive Notion API
 credentials automatically, so do not configure or push `NOTION_API_TOKEN`.
 Local execution needs the token in `.env` before making a Notion API request.
 
-## Database syncs
+## Data-source syncs
 
-Apps declare a database schema, and users attach a real Notion database to it. Apps SDK
-databases are always attached; there is no managed-database option.
+Declare a database with Notion as Code, then pass one of its data-source handles to `sync`:
 
 ```ts
+import { database, sync } from "@notionhq/apps";
 import { Builder } from "@notionhq/apps/builder";
-import { createDatabase } from "@notionhq/apps/database";
-import { Schema } from "@notionhq/apps/schema";
-import { createSync } from "@notionhq/apps/sync";
-
-const issues = createDatabase("issues", {
-	schema: {
-		Name: Schema.title(),
-		"GitHub ID": Schema.richText(),
-	},
+
+const issues = database({
+	resourceId: "issues-db",
+	dataSources: [
+		{
+			resourceId: "issues-source",
+			name: "GitHub Issues",
+			properties: [
+				{ resourceId: "name", name: "Name", type: "title" },
+				{ resourceId: "github-id", name: "GitHub ID", type: "text" },
+			],
+		},
+	],
 });
 
-export default createSync({
-	database: issues,
+export default sync({
+	dataSource: issues.dataSources["issues-source"],
 	primaryKey: "GitHub ID",
 	handler: async () => ({
 		changes: [
@@ -71,7 +136,7 @@ export default createSync({
 ```
 
 Put each default-exported sync directly in `src/syncs/`. A primary key must be a title
-or rich-text property. Do not include that property in an upsert: the SDK fills it from
+or text property. Do not include that property in an upsert: the SDK fills it from
 the change's `key`.
 
 ## Custom blocks
@@ -79,9 +144,9 @@ the change's `key`.
 Declare browser blocks in `src/customBlocks/<key>.ts`:
 
 ```ts
-import { createCustomBlock } from "@notionhq/apps/custom-block";
+import { customBlock } from "@notionhq/apps";
 
-export default createCustomBlock({
+export default customBlock({
 	path: "./blocks/hello",
 	slashCommand: "hello",
 	dataSources: {},
@@ -94,14 +159,6 @@ export default createCustomBlock({
 See [the build and deployment guide](docs/BUILD.md) for provisioning artifacts,
 cloud builds with server coordination, and local builds with CLI coordination.
 
-### Moving from the Workers alpha SDK
-
-- Remove `type` and `primaryKey` from `createDatabase`.
-- Move the property map from `schema.properties` directly into `schema`.
-- Add `primaryKey` to each `createSync`.
-- Remove the primary-key property from each upsert's `properties` object.
-- Change imports from `@notionhq/workers/alpha/*` to `@notionhq/apps/*`.
-
 ## Local / Boxy end to end testing
 
 To build and deploy the app template against a running local Notion server:

package/dist/cli/emit-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emit-manifest.d.ts","sourceRoot":"","sources":["../../src/cli/emit-manifest.ts"],"names":[],"mappings":"AAMA,OAAO,EAEN,KAAK,oBAAoB,EACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAA6C,MAAM,gBAAgB,CAAC;AAE7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AA0M1D,oDAAoD;AACpD,wBAAsB,eAAe,CACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,oBAAoB,EAAE,EAC7C,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACxC,OAAO,CAAC,WAAW,CAAC,CAiFtB;AAED,uFAAuF;AACvF,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAW3F;AAkCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAoCjE;AAED,yFAAyF;AACzF,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE9F"}
+{"version":3,"file":"emit-manifest.d.ts","sourceRoot":"","sources":["../../src/cli/emit-manifest.ts"],"names":[],"mappings":"AAMA,OAAO,EAEN,KAAK,oBAAoB,EACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAA6C,MAAM,gBAAgB,CAAC;AAE7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AA0M1D,oDAAoD;AACpD,wBAAsB,eAAe,CACpC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,SAAS,oBAAoB,EAAE,EAC7C,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACxC,OAAO,CAAC,WAAW,CAAC,CAiFtB;AAED,uFAAuF;AACvF,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAW3F;AA8BD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAoCjE;AAED,yFAAyF;AACzF,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE9F"}

package/dist/cli/emit-manifest.js

@@ -174,7 +174,7 @@ async function extractManifest(bundlePath, capabilities, blockConfigs = {}) {
     );
     if (!tagged || tagged._tag !== capability.tag) {
       throw new Error(
-        `${capability.sourcePath}: default export is not a ${capability.type} \u2014 files under this directory must default-export create${capability.type === "custom_block" ? "CustomBlock" : capitalize(capability.type)}(...)`
+        `${capability.sourcePath}: default export is not a ${capability.type} \u2014 files under this directory must default-export ${capability.type === "custom_block" ? "customBlock" : capability.type}(...)`
       );
     }
     let config = { ...tagged.config };
@@ -249,9 +249,6 @@ function getCapabilityRegistry(bundle) {
   }
   return bundle.capabilities;
 }
-function capitalize(value) {
-  return `${value.slice(0, 1).toUpperCase()}${value.slice(1)}`;
-}
 function assertJsonSafe(value, path) {
   const reject = (reason) => {
     throw new Error(`${path}: not JSON-serializable (${reason})`);

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AA2BF,wBAAgB,uBAAuB,IAAI,iBAAiB,CAe3D"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;CACf,CAAC;AAmCF,wBAAgB,uBAAuB,IAAI,iBAAiB,CAe3D"}

package/dist/context.js

@@ -1,6 +1,9 @@
 import { Client } from "@notionhq/client";
 const LOCAL_FIX_STEPS = "\n\nFor local execution:\n1. Create a personal access token at https://app.notion.com/developers/tokens\n2. Add NOTION_API_TOKEN=<your-token> to your .env file\n\nDeployed apps receive Notion API credentials automatically. Do not push NOTION_API_TOKEN.";
 function missingTokenMessage() {
+  if (process.env.NOTION_WORKFLOW_STEP_DIRECTORY) {
+    return "Notion API access is not configured for this deployed workflow. In Notion, open Developer Tools \u2192 Workers, select this workflow, and grant access to the pages or databases it uses. The runtime provides NOTION_API_TOKEN automatically after access is configured; do not set or push it yourself.";
+  }
   return "NOTION_API_TOKEN is not set. context.notion requires an API token when an app capability runs locally." + LOCAL_FIX_STEPS;
 }
 function createUnauthenticatedNotionProxy() {

package/dist/context.test.d.ts

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

package/dist/context.test.d.ts.map

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

package/dist/custom-block.d.ts

@@ -13,7 +13,7 @@ export type CustomBlockOptions = {
     output?: string;
 });
 /** Declare a browser project. Its filename under src/customBlocks supplies its key. */
-export declare function createCustomBlock(options: CustomBlockOptions): {
+export declare function customBlock(options: CustomBlockOptions): {
     _tag: "custom_block";
     config: {
         source: {

package/dist/custom-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-block.d.ts","sourceRoot":"","sources":["../src/custom-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACjD,GAAG,CACD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CACvD,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4B5D"}
+{"version":3,"file":"custom-block.d.ts","sourceRoot":"","sources":["../src/custom-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACjD,GAAG,CACD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CACvD,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BtD"}

package/dist/custom-block.js

@@ -1,6 +1,6 @@
-function createCustomBlock(options) {
+function customBlock(options) {
   if (typeof options.path !== "string" || options.path.trim() === "") {
-    throw new Error("createCustomBlock requires a non-empty path relative to the app root");
+    throw new Error("customBlock requires a non-empty path relative to the app root");
   }
   const slashCommand = options.slashCommand?.replace(/^\//, "");
   if (slashCommand !== void 0 && !/^[a-z0-9][a-z0-9_-]{0,63}$/.test(slashCommand)) {
@@ -26,5 +26,5 @@ function createCustomBlock(options) {
   };
 }
 export {
-  createCustomBlock
+  customBlock
 };

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { customBlock } from "./custom-block.js";
+export { customAgent } from "./notion-as-code/custom-agent.js";
+export { database } from "./notion-as-code/database.js";
+export { page } from "./notion-as-code/page.js";
+export { teamspace } from "./notion-as-code/teamspace.js";
+export { sync } from "./sync.js";
+export { workflow } from "./workflow.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+import { customBlock } from "./custom-block.js";
+import { customAgent } from "./notion-as-code/custom-agent.js";
+import { database } from "./notion-as-code/database.js";
+import { page } from "./notion-as-code/page.js";
+import { teamspace } from "./notion-as-code/teamspace.js";
+import { sync } from "./sync.js";
+import { workflow } from "./workflow.js";
+export {
+  customAgent,
+  customBlock,
+  database,
+  page,
+  sync,
+  teamspace,
+  workflow
+};

package/dist/sync.d.ts

@@ -48,7 +48,7 @@ export type SyncConfiguration<S extends DatabaseSchema, PrimaryKey extends KeyPr
     handler: (state: State | undefined, context: CapabilityContext) => Promise<SyncHandlerResult<NoInfer<S>, NoInfer<PrimaryKey>, State>>;
 };
 /** Configuration for a sync backed by a Notion-as-Code data source. */
-type DataSourceSyncConfiguration<Properties extends readonly NotionAsCodeProperty[], PrimaryKey extends KeyPropertyName<AppsSchemaForProperties<Properties>>, State> = {
+export type DataSourceSyncConfiguration<Properties extends readonly NotionAsCodeProperty[], PrimaryKey extends KeyPropertyName<AppsSchemaForProperties<Properties>>, State> = {
     dataSource: DataSourceHandle<Properties>;
     primaryKey: PrimaryKey;
     mode?: SyncMode;
@@ -80,6 +80,6 @@ export type Sync = {
 /** Create a database sync. Default-export it from a sync file. */
 export declare function createSync<const S extends DatabaseSchema, const PrimaryKey extends KeyPropertyName<S>, State = unknown>(configuration: SyncConfiguration<S, PrimaryKey, State>): Sync;
 /** Create a sync backed by a Notion-as-Code data source. */
-export declare function createDataSourceSync<const Properties extends readonly NotionAsCodeProperty[], const PrimaryKey extends KeyPropertyName<AppsSchemaForProperties<Properties>>, State = unknown>(configuration: DataSourceSyncConfiguration<Properties, PrimaryKey, State>): Sync;
+export declare function sync<const Properties extends readonly NotionAsCodeProperty[], const PrimaryKey extends KeyPropertyName<AppsSchemaForProperties<Properties>>, State = unknown>(configuration: DataSourceSyncConfiguration<Properties, PrimaryKey, State>): Sync;
 export {};
 //# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,KAAK,EACX,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACX,KAAK,EACL,cAAc,EACd,IAAI,EACJ,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,aAAa,EACb,QAAQ,EACR,SAAS,EACT,MAAM,YAAY,CAAC;AAEpB,KAAK,WAAW,GAAG,aAAa,GAAG,YAAY,CAAC;AAEhD,mEAAmE;AACnE,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,cAAc,IAAI,OAAO,CAC9D;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,KAAK;CACpD,CAAC,MAAM,CAAC,CAAC,EACV,MAAM,CACN,CAAC;AAEF,KAAK,aAAa,CAAC,CAAC,SAAS,qBAAqB,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC/E,WAAW,GACX,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B,UAAU,GACV,CAAC,SAAS;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B,aAAa,GACb,SAAS,CAAC;AAEf,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;AAEjD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,EAAE,UAAU,SAAS,eAAe,CAAC,CAAC,CAAC,IAAI;IAC/F,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,IAAI,CAAC;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,EAAE,UAAU,CAAC,CAAC;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,cAAc,EAAE,UAAU,SAAS,eAAe,CAAC,CAAC,CAAC,IACnF,gBAAgB,CAAC,CAAC,EAAE,UAAU,CAAC,GAC/B,gBAAgB,CAAC;AAEpB,MAAM,MAAM,iBAAiB,CAC5B,CAAC,SAAS,cAAc,EACxB,UAAU,SAAS,eAAe,CAAC,CAAC,CAAC,EACrC,KAAK,IACF;IACH,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC5B,CAAC,SAAS,cAAc,EACxB,UAAU,SAAS,eAAe,CAAC,CAAC,CAAC,EACrC,KAAK,IACF;IACH,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,CACR,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,OAAO,EAAE,iBAAiB,KACtB,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;CACxE,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,2BAA2B,CACtC,UAAU,SAAS,SAAS,oBAAoB,EAAE,EAClD,UAAU,SAAS,eAAe,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,EACvE,KAAK,IACF;IACH,UAAU,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACzC,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,CACR,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,OAAO,EAAE,iBAAiB,KACtB,OAAO,CACX,iBAAiB,CAAC,OAAO,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAC3F,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAyBF,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5F,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,UAAU,CACzB,KAAK,CAAC,CAAC,SAAS,cAAc,EAC9B,KAAK,CAAC,UAAU,SAAS,eAAe,CAAC,CAAC,CAAC,EAC3C,KAAK,GAAG,OAAO,EACd,aAAa,EAAE,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI,CAE9D;AAED,4DAA4D;AAC5D,wBAAgB,IAAI,CACnB,KAAK,CAAC,UAAU,SAAS,SAAS,oBAAoB,EAAE,EACxD,KAAK,CAAC,UAAU,SAAS,eAAe,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,EAC7E,KAAK,GAAG,OAAO,EACd,aAAa,EAAE,2BAA2B,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI,CAEjF"}

package/dist/sync.js

@@ -10,7 +10,7 @@ function resolveSyncDatabase(configuration) {
 function createSync(configuration) {
   return createSyncDefinition(configuration);
 }
-function createDataSourceSync(configuration) {
+function sync(configuration) {
   return createSyncDefinition(configuration);
 }
 function createSyncDefinition(configuration) {
@@ -81,6 +81,6 @@ function createSyncDefinition(configuration) {
   };
 }
 export {
-  createDataSourceSync,
-  createSync
+  createSync,
+  sync
 };

package/dist/workflow.d.ts

@@ -11,7 +11,7 @@ export type WorkflowEventForTrigger<T extends WorkflowTrigger> = WorkflowEventMa
 export type WorkflowEventForTriggers<T extends readonly WorkflowTrigger[]> = WorkflowEventForTrigger<T[number]>;
 export { connections, type WorkflowConnection, type WorkflowConnections } from "./connections.js";
 /**
- * Configuration passed to {@link createWorkflow}.
+ * Configuration passed to {@link workflow}.
  */
 export type WorkflowConfiguration<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], TConnections extends readonly WorkflowConnection[] = readonly WorkflowConnection[]> = {
     /**
@@ -41,7 +41,7 @@ export type WorkflowTriggerConfiguration<TTriggers extends readonly [WorkflowTri
     }) => TTriggers;
 };
 /**
- * A workflow capability as returned by {@link createWorkflow}.
+ * A workflow capability as returned by {@link workflow}.
  *
  * Note that a workflow carries no key of its own — the build tool derives
  * the capability key from the file the workflow is default-exported from.
@@ -71,9 +71,9 @@ export type Workflow<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTri
  * ```ts
  * // src/workflows/onPageCreated.ts
  * import { triggers } from "@notionhq/apps/triggers";
- * import { createWorkflow } from "@notionhq/apps/workflow";
+ * import { workflow } from "@notionhq/apps/workflow";
  *
- * export default createWorkflow({
+ * export default workflow({
  *   name: "Send Welcome Email",
  *   description: "Sends a welcome email when a new page is added",
  *   triggers: [triggers.notionPageCreated()],
@@ -87,11 +87,11 @@ export type Workflow<TTriggers extends readonly [WorkflowTrigger, ...WorkflowTri
  * });
  * ```
  */
-export declare function createWorkflow<const TTriggers extends readonly [
+export declare function workflow<const TTriggers extends readonly [
     WorkflowTriggerForConnections<NoInfer<TConnections>>,
     ...WorkflowTriggerForConnections<NoInfer<TConnections>>[]
 ], const TConnections extends readonly WorkflowConnection[] = readonly []>(configuration: WorkflowTriggerConfiguration<TTriggers, TConnections>): Workflow<TTriggers>;
-export declare function createWorkflow<const TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], const TConnections extends readonly WorkflowConnection[] = readonly []>(configuration: WorkflowConfiguration<TTriggers, TConnections>): Workflow<TTriggers>;
+export declare function workflow<const TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]], const TConnections extends readonly WorkflowConnection[] = readonly []>(configuration: WorkflowConfiguration<TTriggers, TConnections>): Workflow<TTriggers>;
 /** Context passed to a workflow step. */
 export type StepContext = {
     /**

package/dist/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAKtD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,KAAK,EACX,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,6BAA6B,EAC7B,MAAM,yBAAyB,CAAC;AAEjC,KAAK,cAAc,GAAG;IACrB,yEAAyE;IACzE,cAAc,CAAC,EAAE,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,gBAAgB,CAAC,CAAC;AAErE,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,eAAe,IAAI,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAE7F,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,SAAS,eAAe,EAAE,IACxE,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAChC,SAAS,SAAS,SAAS,CAAC,eAAe,EAAE,GAAG,eAAe,EAAE,CAAC,EAClE,YAAY,SAAS,SAAS,kBAAkB,EAAE,GAAG,SAAS,kBAAkB,EAAE,IAC/E;IACH;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC;IAE3B,OAAO,EAAE,CACR,KAAK,EAAE,wBAAwB,CAAC,SAAS,CAAC,EAC1C,OAAO,EAAE,eAAe,CAAC,YAAY,CAAC,KAClC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,4BAA4B,CACvC,SAAS,SAAS,SAAS,CAAC,eAAe,EAAE,GAAG,eAAe,EAAE,CAAC,EAClE,YAAY,SAAS,SAAS,kBAAkB,EAAE,IAC/C,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,UAAU,CAAC,GAAG;IACtE,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,uBAAuB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAA;KAAE,KAAK,SAAS,CAAC;CAC/F,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CACnB,SAAS,SAAS,SAAS,CAAC,eAAe,EAAE,GAAG,eAAe,EAAE,CAAC,GAAG,SAAS;IAC7E,eAAe;IACf,GAAG,eAAe,EAAE;CACpB,IACE;IACH,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,SAAS,CAAC;QACpB,WAAW,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;KAC5C,CAAC;IACF,OAAO,EAAE,CACR,KAAK,EAAE,wBAAwB,CAAC,SAAS,CAAC,EAC1C,OAAO,CAAC,EAAE,cAAc,KACpB,OAAO,CAAC;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC7B,KAAK,CAAC,SAAS,SAAS,SAAS;IAChC,6BAA6B,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,GAAG,6BAA6B,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE;CACzD,EACD,KAAK,CAAC,YAAY,SAAS,SAAS,kBAAkB,EAAE,GAAG,SAAS,EAAE,EACrE,aAAa,EAAE,4BAA4B,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC7F,wBAAgB,cAAc,CAC7B,KAAK,CAAC,SAAS,SAAS,SAAS,CAAC,eAAe,EAAE,GAAG,eAAe,EAAE,CAAC,EACxE,KAAK,CAAC,YAAY,SAAS,SAAS,kBAAkB,EAAE,GAAG,SAAS,EAAE,EACrE,aAAa,EAAE,qBAAqB,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAmEtF,yCAAyC;AACzC,MAAM,MAAM,WAAW,GAAG;IACzB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,KAAK,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;AAEvD,mCAAmC;AACnC,MAAM,MAAM,mBAAmB,GAAG;IACjC;;;;OAIG;IACH,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,KAAK,YAAY,GAAG;IACnB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC,EACD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,EAC5B,EAAE,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,eAAe,CAC1B,YAAY,SAAS,SAAS,kBAAkB,EAAE,GAAG,SAAS,kBAAkB,EAAE,IAC/E,iBAAiB,GAAG;IACvB,WAAW,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;CAC/C,GAAG,WAAW,GAAG;IAChB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"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"}

package/dist/workflow.js

@@ -13,7 +13,7 @@ import { resolveRuntimeInput } from "./runtime-input.js";
 import { readRunMetadata } from "./runtime-metadata.js";
 import { createWorkflowTriggers } from "./triggers.generated.js";
 import { connections } from "./connections.js";
-function createWorkflow(configuration) {
+function workflow(configuration) {
   const triggers = typeof configuration.triggers === "function" ? configuration.triggers({ triggers: createWorkflowTriggers() }) : configuration.triggers;
   validateConnectionRequirements(configuration.connections ?? []);
   validateTriggerConnections(triggers, configuration.connections ?? []);
@@ -222,5 +222,5 @@ function isNodeError(error) {
 }
 export {
   connections,
-  createWorkflow
+  workflow
 };

package/docs/BUILD.md

@@ -11,11 +11,11 @@
 Each top-level TypeScript file under a capability directory must default-export the
 corresponding capability. The filename becomes its key:
 
-| Directory           | Default export           |
-| ------------------- | ------------------------ |
-| `src/workflows/`    | `createWorkflow(...)`    |
-| `src/syncs/`        | `createSync(...)`        |
-| `src/customBlocks/` | `createCustomBlock(...)` |
+| Directory           | Default export     |
+| ------------------- | ------------------ |
+| `src/workflows/`    | `workflow(...)`    |
+| `src/syncs/`        | `sync(...)`        |
+| `src/customBlocks/` | `customBlock(...)` |
 
 ```text
 my-app/

package/docs/CONNECTIONS.md

@@ -3,10 +3,11 @@
 Workflow connections declare services that a workflow needs to work properly. Connections require explicit authentication during setup before the workflow can use them. Each connection has a stable binding that links it to its configured credentials and permissions.
 
 ```ts
-import { connections, createWorkflow } from "@notionhq/apps/workflow";
+import { workflow } from "@notionhq/apps";
+import { connections } from "@notionhq/apps/workflow";
 import { triggers } from "@notionhq/apps/triggers";
 
-export default createWorkflow({
+export default workflow({
 	name: "List work calendars",
 	description: "List calendars available through the work connection",
 	triggers: [triggers.notionPageCreated()],
@@ -25,7 +26,7 @@ An omitted key defaults to the provider type, so `connections.calendar()` is acc
 Use a trigger callback to check connection keys against the workflow’s declared providers:
 
 ```ts
-export default createWorkflow({
+export default workflow({
 	name: "Support messages",
 	description: "Run when a message arrives in the configured support channel",
 	connections: [connections.slack({ key: "support" })],
@@ -42,7 +43,7 @@ export default createWorkflow({
 
 The callback’s `triggers.slackMessage` accepts only Slack keys declared in `connections`. In this example, `"typo"` is a type error, and a Calendar connection named `"support"` would not satisfy a Slack trigger. Keys remain literal when you save a declaration in a variable, so the same check works with `const support = connections.slack({ key: "support" })`. Omitting the declaration key defaults to the provider name.
 
-The callback runs once when `createWorkflow` is called. Its result is serialized as the ordinary trigger array, and the handler’s event type is inferred from those triggers. Returning a keyed trigger from an imported helper is checked too. Existing static trigger arrays remain supported and validate connection keys at runtime; use the callback for compile-time checking. Unbound triggers, including existing calls without `connectionKey`, keep their existing behavior.
+The callback runs once when `workflow` is called. Its result is serialized as the ordinary trigger array, and the handler’s event type is inferred from those triggers. Returning a keyed trigger from an imported helper is checked too. Existing static trigger arrays remain supported and validate connection keys at runtime; use the callback for compile-time checking. Unbound triggers, including existing calls without `connectionKey`, keep their existing behavior.
 
 Deployment creates a disabled trigger attached to that connection. Configure the account, channel or calendar, and enable the trigger through workflow setup before publishing. Redeploying preserves its configuration. The server checks the binding at publication and execution, so a trigger on another connection cannot invoke this declaration.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@notionhq/apps",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"description": "An SDK for building workflow apps for Notion",
 	"license": "MIT",
 	"bin": {
@@ -15,6 +15,10 @@
 	],
 	"type": "module",
 	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
 		"./context": {
 			"types": "./dist/context.d.ts",
 			"default": "./dist/context.js"

package/src/cli/build.test.ts

@@ -54,9 +54,7 @@ describe("buildApp", () => {
 			},
 		]);
 		const worker = await fs.promises.readFile(bundlePath, "utf8");
-		expect(worker).not.toMatch(
-			/custom_block|createCustomBlock|react|createRoot|NotionCustomBlock/,
-		);
+		expect(worker).not.toMatch(/custom_block|customBlock|react|createRoot|NotionCustomBlock/);
 		expect(fs.existsSync(path.join(root, ".notion/blocks.js"))).toBe(false);
 	});
 	it("names the block file when path is missing", async () => {
@@ -66,7 +64,7 @@ describe("buildApp", () => {
 	});
 	it("rejects a block file that exports a different capability", async () => {
 		await expect(buildApp(fixture("custom-block-wrong-tag"))).rejects.toThrow(
-			/hello.ts.*createCustomBlock/,
+			/hello.ts.*customBlock/,
 		);
 	});
 

package/src/cli/emit-manifest.ts

@@ -233,7 +233,7 @@ export async function extractManifest(
 		if (!tagged || tagged._tag !== capability.tag) {
 			throw new Error(
 				`${capability.sourcePath}: default export is not a ${capability.type} — ` +
-					`files under this directory must default-export create${capability.type === "custom_block" ? "CustomBlock" : capitalize(capability.type)}(...)`,
+					`files under this directory must default-export ${capability.type === "custom_block" ? "customBlock" : capability.type}(...)`,
 			);
 		}
 
@@ -342,10 +342,6 @@ function getCapabilityRegistry(
 	return bundle.capabilities as Record<string, Record<string, unknown> | undefined>;
 }
 
-function capitalize(value: string): string {
-	return `${value.slice(0, 1).toUpperCase()}${value.slice(1)}`;
-}
-
 /**
  * Throw if `value` contains anything `JSON.stringify` would silently drop or
  * rewrite, so invalid manifest configuration fails during the build.

package/src/context.test.ts

@@ -0,0 +1,26 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { createCapabilityContext } from "./context.js";
+
+afterEach(() => {
+	delete process.env.NOTION_API_TOKEN;
+	delete process.env.NOTION_WORKFLOW_STEP_DIRECTORY;
+});
+
+describe("createCapabilityContext", () => {
+	it("explains how to configure local Notion API access", () => {
+		const context = createCapabilityContext();
+
+		expect(() => context.notion.pages).toThrow(
+			"NOTION_API_TOKEN is not set. context.notion requires an API token when an app capability runs locally.",
+		);
+	});
+
+	it("explains how to grant deployed workflow access", () => {
+		process.env.NOTION_WORKFLOW_STEP_DIRECTORY = "/tmp/notion-run/steps";
+		const context = createCapabilityContext();
+
+		expect(() => context.notion.pages).toThrow(
+			"Notion API access is not configured for this deployed workflow. In Notion, open Developer Tools → Workers",
+		);
+	});
+});

package/src/context.ts

@@ -13,6 +13,14 @@ const LOCAL_FIX_STEPS =
 	"Deployed apps receive Notion API credentials automatically. Do not push NOTION_API_TOKEN.";
 
 function missingTokenMessage(): string {
+	if (process.env.NOTION_WORKFLOW_STEP_DIRECTORY) {
+		return (
+			"Notion API access is not configured for this deployed workflow. " +
+			"In Notion, open Developer Tools → Workers, select this workflow, and grant access to the pages or databases it uses. " +
+			"The runtime provides NOTION_API_TOKEN automatically after access is configured; do not set or push it yourself."
+		);
+	}
+
 	return (
 		"NOTION_API_TOKEN is not set. " +
 		"context.notion requires an API token when an app capability runs locally." +

package/src/custom-block.test.ts

@@ -1,9 +1,9 @@
 import { describe, expect, it } from "vitest";
-import { createCustomBlock } from "./custom-block.js";
+import { customBlock } from "./custom-block.js";
 
-describe("createCustomBlock", () => {
+describe("customBlock", () => {
 	it("supports static assets without a build command", () => {
-		expect(createCustomBlock({ path: "assets", static: true }).config.source).toEqual({
+		expect(customBlock({ path: "assets", static: true }).config.source).toEqual({
 			type: "static",
 			path: "assets",
 		});
@@ -11,7 +11,7 @@ describe("createCustomBlock", () => {
 	it.each(["//hello", "Hello", "-hello", "", "a".repeat(65)])(
 		"rejects invalid slash command %s",
 		(slashCommand) => {
-			expect(() => createCustomBlock({ path: "blocks/hello", slashCommand })).toThrow(
+			expect(() => customBlock({ path: "blocks/hello", slashCommand })).toThrow(
 				/slashCommand/,
 			);
 		},

package/src/custom-block.ts

@@ -10,9 +10,9 @@ export type CustomBlockOptions = {
 );
 
 /** Declare a browser project. Its filename under src/customBlocks supplies its key. */
-export function createCustomBlock(options: CustomBlockOptions) {
+export function customBlock(options: CustomBlockOptions) {
 	if (typeof options.path !== "string" || options.path.trim() === "") {
-		throw new Error("createCustomBlock requires a non-empty path relative to the app root");
+		throw new Error("customBlock requires a non-empty path relative to the app root");
 	}
 	const slashCommand = options.slashCommand?.replace(/^\//, "");
 	if (slashCommand !== undefined && !/^[a-z0-9][a-z0-9_-]{0,63}$/.test(slashCommand)) {

package/src/index.ts

@@ -0,0 +1,7 @@
+export { customBlock } from "./custom-block.js";
+export { customAgent } from "./notion-as-code/custom-agent.js";
+export { database } from "./notion-as-code/database.js";
+export { page } from "./notion-as-code/page.js";
+export { teamspace } from "./notion-as-code/teamspace.js";
+export { sync } from "./sync.js";
+export { workflow } from "./workflow.js";

package/src/sync.ts

@@ -89,7 +89,7 @@ export type SyncConfiguration<
 };
 
 /** Configuration for a sync backed by a Notion-as-Code data source. */
-type DataSourceSyncConfiguration<
+export type DataSourceSyncConfiguration<
 	Properties extends readonly NotionAsCodeProperty[],
 	PrimaryKey extends KeyPropertyName<AppsSchemaForProperties<Properties>>,
 	State,
@@ -165,7 +165,7 @@ export function createSync<
 }
 
 /** Create a sync backed by a Notion-as-Code data source. */
-export function createDataSourceSync<
+export function sync<
 	const Properties extends readonly NotionAsCodeProperty[],
 	const PrimaryKey extends KeyPropertyName<AppsSchemaForProperties<Properties>>,
 	State = unknown,

package/src/workflow-connections-types.test.ts

@@ -1,9 +1,9 @@
 import { expectTypeOf, it } from "vitest";
 import { triggers } from "./triggers.generated.js";
-import { connections, createWorkflow, type WorkflowConnection } from "./workflow.js";
+import { connections, workflow, type WorkflowConnection } from "./workflow.js";
 
 it("infers only the declared provider clients", () => {
-	createWorkflow({
+	workflow({
 		name: "Calendar",
 		description: "Calendar only",
 		triggers: [triggers.notionPageCreated()],
@@ -14,7 +14,7 @@ it("infers only the declared provider clients", () => {
 		},
 	});
 	const requirements = [connections.calendar(), connections.slack({ key: "support" })];
-	createWorkflow({
+	workflow({
 		name: "Multiple providers",
 		description: "Preserves providers in a separately declared array",
 		triggers: [triggers.notionPageCreated()],
@@ -26,7 +26,7 @@ it("infers only the declared provider clients", () => {
 });
 
 it("exposes no providers for omitted or empty connections", () => {
-	createWorkflow({
+	workflow({
 		name: "No connections",
 		description: "Omitted",
 		triggers: [triggers.notionPageCreated()],
@@ -34,7 +34,7 @@ it("exposes no providers for omitted or empty connections", () => {
 			expectTypeOf<keyof typeof context.connections>().toEqualTypeOf<never>();
 		},
 	});
-	createWorkflow({
+	workflow({
 		name: "No connections",
 		description: "Empty",
 		triggers: [triggers.notionPageCreated()],
@@ -47,7 +47,7 @@ it("exposes no providers for omitted or empty connections", () => {
 
 it("preserves literal declarations checked with satisfies", () => {
 	const requirements = [connections.slack()] satisfies readonly WorkflowConnection[];
-	createWorkflow({
+	workflow({
 		name: "Slack",
 		description: "Slack only",
 		triggers: [triggers.notionPageCreated()],

package/src/workflow-types.test.ts

@@ -93,10 +93,10 @@ it("checks provider keys on callback arguments and returned triggers", () => {
 	const fixtures = new Map(
 		cases.map((testCase) => [
 			resolve("src", `__workflow_types_${testCase.name}.ts`),
-			`import { connections, createWorkflow } from "./workflow.js";
+			`import { connections, workflow } from "./workflow.js";
 		import { triggers as globalTriggers } from "./triggers.generated.js";
 		const support = connections.slack({ key: "support" });
-		createWorkflow({
+		workflow({
 			name: "Type check", description: "Type check",
 			${testCase.connections === undefined ? "" : `connections: ${testCase.connections},`}
 			triggers: ({ triggers }) => [${testCase.trigger}],

package/src/workflow.test.ts

@@ -8,7 +8,7 @@ import { afterEach, beforeEach, describe, expect, expectTypeOf, it, vi, type Moc
 import { ExecutionError } from "./error.js";
 import type { RunMetadata } from "./runtime-metadata.js";
 import { triggers, type NotionPageCreatedEvent } from "./triggers.generated.js";
-import { connections, createWorkflow, type StepContext, type WorkflowContext } from "./workflow.js";
+import { connections, workflow, type StepContext, type WorkflowContext } from "./workflow.js";
 
 let stdoutSpy: Mock<typeof process.stdout.write>;
 let checkpointDirectory: string | undefined;
@@ -39,7 +39,7 @@ const event = { type: "notion.page.created" } as NotionPageCreatedEvent;
 
 async function createWorkflowContext(): Promise<WorkflowContext<readonly []>> {
 	let context: WorkflowContext<readonly []> | undefined;
-	const workflow = createWorkflow({
+	const definition = workflow({
 		name: "Test workflow",
 		description: "Captures its workflow context",
 		triggers: [triggers.notionPageCreated()],
@@ -48,7 +48,7 @@ async function createWorkflowContext(): Promise<WorkflowContext<readonly []>> {
 		},
 	});
 
-	await workflow.handler(event, { concreteOutput: true });
+	await definition.handler(event, { concreteOutput: true });
 
 	if (!context) {
 		throw new Error("Workflow context was not created");
@@ -638,7 +638,7 @@ describe("step", () => {
 
 	it("resets duplicate key tracking for each workflow call", async () => {
 		const keys: string[] = [];
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Reuse step key",
 			description: "Checks that a key can be reused in a new invocation",
 			triggers: [triggers.notionPageCreated()],
@@ -654,14 +654,14 @@ describe("step", () => {
 			},
 		});
 
-		await workflow.handler(event, { concreteOutput: true });
-		await workflow.handler(event, { concreteOutput: true });
+		await definition.handler(event, { concreteOutput: true });
+		await definition.handler(event, { concreteOutput: true });
 
 		expect(keys).toEqual([workflowStepKey(["First"]), workflowStepKey(["First"])]);
 	});
 
 	it("writes step events under concreteOutput", async () => {
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Log Pages",
 			description: "Logs created pages",
 			triggers: [triggers.notionPageCreated()],
@@ -670,7 +670,7 @@ describe("step", () => {
 			},
 		});
 
-		await workflow.handler(event, { concreteOutput: true });
+		await definition.handler(event, { concreteOutput: true });
 
 		expect(stdoutSpy).toHaveBeenCalledTimes(3);
 		expect(stdoutSpy.mock.calls[0]?.[0]).toEqual(
@@ -721,17 +721,17 @@ async function writeRunMetadata(overrides: Partial<RunMetadata> = {}): Promise<v
 	process.env.NOTION_RUN_METADATA_PATH = metadataPath;
 }
 
-describe("createWorkflow", () => {
+describe("workflow", () => {
 	it("is tagged and exposes triggers in config", () => {
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Log Pages",
 			description: "Logs created pages",
 			triggers: [triggers.notionPageCreated()],
 			handler: () => {},
 		});
 
-		expect(workflow._tag).toBe("workflow");
-		expect(workflow.config).toEqual({
+		expect(definition._tag).toBe("workflow");
+		expect(definition.config).toEqual({
 			name: "Log Pages",
 			description: "Logs created pages",
 			triggers: [{ type: "notion.page.created" }],
@@ -739,7 +739,7 @@ describe("createWorkflow", () => {
 	});
 
 	it("declares a Calendar connection requirement", () => {
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Schedule Follow-up",
 			description: "Schedules a follow-up after a page is created",
 			triggers: [triggers.notionPageCreated()],
@@ -747,12 +747,12 @@ describe("createWorkflow", () => {
 			handler: () => {},
 		});
 
-		expect(workflow.config.connections).toEqual([{ type: "calendar" }]);
+		expect(definition.config.connections).toEqual([{ type: "calendar" }]);
 	});
 
 	it("rejects duplicate connection requirements", () => {
 		expect(() =>
-			createWorkflow({
+			workflow({
 				name: "Schedule Follow-up",
 				description: "Schedules a follow-up after a page is created",
 				triggers: [triggers.notionPageCreated()],
@@ -764,14 +764,14 @@ describe("createWorkflow", () => {
 
 	it("writes a success envelope after the handler runs", async () => {
 		const handler = vi.fn();
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Log Pages",
 			description: "Logs created pages",
 			triggers: [triggers.notionPageCreated()],
 			handler,
 		});
 
-		await workflow.handler(event);
+		await definition.handler(event);
 
 		expect(handler).toHaveBeenCalledWith(event, expect.anything());
 		expect(stdoutSpy).toHaveBeenCalledWith(
@@ -784,7 +784,7 @@ describe("createWorkflow", () => {
 			throw new Error("Metadata directory was not created");
 		}
 		const handler = vi.fn();
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Log Pages",
 			description: "Logs created pages",
 			triggers: [triggers.notionPageCreated()],
@@ -795,27 +795,27 @@ describe("createWorkflow", () => {
 		await writeFile(inputPath, JSON.stringify(fileEvent));
 		process.env.NOTION_INPUT_PAYLOAD_PATH = inputPath;
 
-		await workflow.handler(event, { concreteOutput: true });
+		await definition.handler(event, { concreteOutput: true });
 
 		expect(handler).toHaveBeenCalledWith(fileEvent, expect.anything());
 	});
 
 	it("returns the status without an envelope under concreteOutput", async () => {
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Log Pages",
 			description: "Logs created pages",
 			triggers: [triggers.notionPageCreated()],
 			handler: () => {},
 		});
 
-		await expect(workflow.handler(event, { concreteOutput: true })).resolves.toEqual({
+		await expect(definition.handler(event, { concreteOutput: true })).resolves.toEqual({
 			status: "success",
 		});
 		expect(stdoutSpy).not.toHaveBeenCalled();
 	});
 
 	it("writes an error envelope and throws ExecutionError on failure", async () => {
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Log Pages",
 			description: "Logs created pages",
 			triggers: [triggers.notionPageCreated()],
@@ -824,7 +824,7 @@ describe("createWorkflow", () => {
 			},
 		});
 
-		await expect(workflow.handler(event)).rejects.toBeInstanceOf(ExecutionError);
+		await expect(definition.handler(event)).rejects.toBeInstanceOf(ExecutionError);
 		expect(stdoutSpy).toHaveBeenCalledWith(
 			expect.stringContaining(
 				`<__notion_output__>{"_tag":"error","error":{"name":"ExecutionError","message":"Error during app execution: Error: boom"`,
@@ -836,7 +836,7 @@ describe("createWorkflow", () => {
 describe("connection-bound triggers", () => {
 	it("resolves typed trigger callbacks once and preserves event inference", () => {
 		let calls = 0;
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Typed triggers",
 			description: "Uses only declared provider keys",
 			connections: [connections.slack({ key: "support" }), connections.calendar()],
@@ -866,14 +866,14 @@ describe("connection-bound triggers", () => {
 			},
 		});
 		expect(calls).toBe(1);
-		expect(workflow.config.triggers).toEqual([
+		expect(definition.config.triggers).toEqual([
 			{ type: "slack.message", connectionKey: "support" },
 			{ type: "calendar.event.created", connectionKey: "calendar" },
 		]);
 	});
 
 	it("preserves the binding in the manifest and infers the event", () => {
-		const workflow = createWorkflow({
+		const definition = workflow({
 			name: "Support",
 			description: "Watch support messages",
 			connections: [connections.slack({ key: "support" })],
@@ -882,7 +882,7 @@ describe("connection-bound triggers", () => {
 				expectTypeOf(event.type).toEqualTypeOf<"slack.message">();
 			},
 		});
-		expect(workflow.config.triggers).toEqual([
+		expect(definition.config.triggers).toEqual([
 			{ type: "slack.message", connectionKey: "support" },
 		]);
 	});
@@ -892,7 +892,7 @@ describe("connection-bound triggers", () => {
 		{ requirements: [connections.slack({ key: "other" })] },
 	])("rejects missing or incompatible declarations: %j", ({ requirements }) => {
 		expect(() =>
-			createWorkflow({
+			workflow({
 				name: "Support",
 				description: "",
 				connections: requirements,
@@ -912,7 +912,7 @@ describe("connection-bound triggers", () => {
 			handler() {},
 		};
 		expect(() =>
-			createWorkflow({
+			workflow({
 				...configuration,
 				triggers: [
 					triggers.slackMessage({ connectionKey: "support" }),
@@ -921,7 +921,7 @@ describe("connection-bound triggers", () => {
 			}),
 		).toThrow("Duplicate");
 		expect(() =>
-			createWorkflow({
+			workflow({
 				...configuration,
 				triggers: [
 					triggers.slackMessage({ connectionKey: "support" }),
@@ -933,7 +933,7 @@ describe("connection-bound triggers", () => {
 	it("preserves existing unkeyed helpers", () => {
 		expect(triggers.slackMessage()).toEqual({ type: "slack.message" });
 		expect(() =>
-			createWorkflow({
+			workflow({
 				name: "Existing",
 				description: "",
 				triggers: [triggers.slackMessage()],

package/src/workflow.ts

@@ -38,7 +38,7 @@ export type WorkflowEventForTriggers<T extends readonly WorkflowTrigger[]> =
 export { connections, type WorkflowConnection, type WorkflowConnections } from "./connections.js";
 
 /**
- * Configuration passed to {@link createWorkflow}.
+ * Configuration passed to {@link workflow}.
  */
 export type WorkflowConfiguration<
 	TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]],
@@ -81,7 +81,7 @@ export type WorkflowTriggerConfiguration<
 };
 
 /**
- * A workflow capability as returned by {@link createWorkflow}.
+ * A workflow capability as returned by {@link workflow}.
  *
  * Note that a workflow carries no key of its own — the build tool derives
  * the capability key from the file the workflow is default-exported from.
@@ -115,9 +115,9 @@ export type Workflow<
  * ```ts
  * // src/workflows/onPageCreated.ts
  * import { triggers } from "@notionhq/apps/triggers";
- * import { createWorkflow } from "@notionhq/apps/workflow";
+ * import { workflow } from "@notionhq/apps/workflow";
  *
- * export default createWorkflow({
+ * export default workflow({
  *   name: "Send Welcome Email",
  *   description: "Sends a welcome email when a new page is added",
  *   triggers: [triggers.notionPageCreated()],
@@ -131,18 +131,18 @@ export type Workflow<
  * });
  * ```
  */
-export function createWorkflow<
+export function workflow<
 	const TTriggers extends readonly [
 		WorkflowTriggerForConnections<NoInfer<TConnections>>,
 		...WorkflowTriggerForConnections<NoInfer<TConnections>>[],
 	],
 	const TConnections extends readonly WorkflowConnection[] = readonly [],
 >(configuration: WorkflowTriggerConfiguration<TTriggers, TConnections>): Workflow<TTriggers>;
-export function createWorkflow<
+export function workflow<
 	const TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]],
 	const TConnections extends readonly WorkflowConnection[] = readonly [],
 >(configuration: WorkflowConfiguration<TTriggers, TConnections>): Workflow<TTriggers>;
-export function createWorkflow<
+export function workflow<
 	const TTriggers extends readonly [WorkflowTrigger, ...WorkflowTrigger[]],
 	const TConnections extends readonly WorkflowConnection[] = readonly [],
 >(