@notionhq/apps 0.0.21 → 0.0.23

package/src/workflow-access.ts

@@ -14,6 +14,8 @@ export type WorkflowAccessResource =
 	| DataSourceHandle
 	| CustomAgentHandle;
 
+type WorkflowAccessContentResource = Exclude<WorkflowAccessResource, CustomAgentHandle>;
+
 /** Resource kinds accepted by workflow access declarations. */
 export type WorkflowAccessResourceType = WorkflowAccessResource["resourceType"];
 
@@ -82,6 +84,45 @@ export type WorkflowAccess<
 /** Resolved NaC bindings keyed by public aliases, without declaration metadata. */
 export type WorkflowAccessBindings = Readonly<Record<string, WorkflowAccessValue>>;
 
+/** Create type-safe access declarations for Notion-as-Code resource handles. */
+export const access = {
+	view,
+	comment,
+	edit,
+	fullAccess,
+	call,
+};
+
+function view<TResource extends WorkflowAccessContentResource>(
+	resource: TResource,
+): Readonly<{ resource: TResource; level: "view" }> {
+	return { resource, level: "view" };
+}
+
+function comment<TResource extends WorkflowAccessContentResource>(
+	resource: TResource,
+): Readonly<{ resource: TResource; level: "comment" }> {
+	return { resource, level: "comment" };
+}
+
+function edit<TResource extends WorkflowAccessContentResource>(
+	resource: TResource,
+): Readonly<{ resource: TResource; level: "edit" }> {
+	return { resource, level: "edit" };
+}
+
+function fullAccess<TResource extends WorkflowAccessContentResource>(
+	resource: TResource,
+): Readonly<{ resource: TResource; level: "fullAccess" }> {
+	return { resource, level: "fullAccess" };
+}
+
+function call(
+	resource: CustomAgentHandle,
+): Readonly<{ resource: CustomAgentHandle; level: "call" }> {
+	return { resource, level: "call" };
+}
+
 const ACCESS_ALIAS_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,127}$/;
 const RESERVED_ACCESS_ALIASES = new Set<string>(["__proto__", "prototype", "constructor"]);
 const RESOURCE_TYPES: Record<WorkflowAccessResourceType, true> = {

package/src/workflow.test.ts

@@ -12,6 +12,7 @@ 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 {
+	access,
 	connections,
 	workflow,
 	type StepContext,
@@ -1216,10 +1217,10 @@ describe("workflow", () => {
 			description: "Hydrates access",
 			triggers: [triggers.notionPageCreated()],
 			access: {
-				home: { resource: home, level: "view" },
-				table: { resource: table, level: "edit" },
-				source: { resource: table.dataSource, level: "comment" },
-				agent: { resource: agent, level: "call" },
+				home: access.view(home),
+				table: access.edit(table),
+				source: access.comment(table.dataSource),
+				agent: access.call(agent),
 			},
 			handler: (_event, context) => {
 				expectTypeOf(context.access.home.type).toEqualTypeOf<"page">();

package/src/workflow.ts

@@ -91,6 +91,7 @@ export type {
 	WorkflowAccessRequirements,
 	WorkflowAccessValue,
 } from "./workflow-access.js";
+export { access } from "./workflow-access.js";
 export type WorkflowEvent = WorkflowEventMap[keyof WorkflowEventMap];
 
 export type WorkflowEventForTrigger<T extends WorkflowTrigger> = WorkflowEventMap[T["type"]];