@notionhq/apps 0.0.10 → 0.0.11

package/dist/cli/build.d.ts

@@ -6,8 +6,8 @@ export type BuildResult = {
 };
 /**
  * Build an app project: discover capability files by convention, generate
- * the entry module, bundle it into a single `dist/worker.js`, and emit
- * `dist/manifest.json` describing every capability.
+ * the Worker and build-only metadata entries, bundle the Worker, and emit
+ * the Worker manifest plus any recorded Notion-as-Code provisioning artifact.
  */
 export declare function buildApp(projectRoot: string): Promise<BuildResult>;
 //# sourceMappingURL=build.d.ts.map

package/dist/cli/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKlD,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmCxE"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAUlD,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoCxE"}

package/dist/cli/build.js

@@ -1,9 +1,13 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { rolldown } from "rolldown";
-import { generateEntry } from "./codegen.js";
+import {
+  createProvisioningArtifact
+} from "../notion-as-code/provisioning.js";
+import { clearRegisteredPacers } from "../pacer.js";
+import { generateEntry, generateMetadataEntry } from "./codegen.js";
 import { discoverCapabilities } from "./discover.js";
-import { extractManifest } from "./emit-manifest.js";
+import { extractManifest, extractProvisioning } from "./emit-manifest.js";
 async function buildApp(projectRoot) {
   const capabilities = await discoverCapabilities(projectRoot);
   if (capabilities.length === 0) {
@@ -29,8 +33,46 @@ async function buildApp(projectRoot) {
   const manifestPath = path.join(projectRoot, "dist", "manifest.json");
   await fs.promises.writeFile(manifestPath, `${JSON.stringify(manifest, null, "	")}
 `);
+  await emitProvisioningArtifact(projectRoot, capabilities);
   return { manifest, bundlePath, manifestPath };
 }
+async function emitProvisioningArtifact(projectRoot, capabilities) {
+  const entityProvisioning = await buildMetadata(projectRoot, capabilities);
+  if (entityProvisioning.intents.length === 0) return;
+  const artifact = createProvisioningArtifact(entityProvisioning.intents);
+  await fs.promises.writeFile(
+    path.join(projectRoot, "dist", "provisioning.json"),
+    `${JSON.stringify(artifact, null, "	")}
+`
+  );
+}
+async function buildMetadata(projectRoot, capabilities) {
+  const metadataEntryPath = path.join(projectRoot, ".notion", "metadata-entry.ts");
+  const metadataBundlePath = path.join(projectRoot, ".notion", "metadata.js");
+  await fs.promises.writeFile(metadataEntryPath, generateMetadataEntry(capabilities));
+  clearRegisteredPacers();
+  try {
+    const metadataBundle = await rolldown({
+      input: metadataEntryPath,
+      platform: "node",
+      // Keep SDK packages external so the metadata bundle resolves the app's installed SDK.
+      external: (id) => !id.startsWith(".") && !path.isAbsolute(id)
+    });
+    try {
+      await metadataBundle.write({
+        format: "esm",
+        file: metadataBundlePath,
+        codeSplitting: false
+      });
+    } finally {
+      await metadataBundle.close();
+    }
+    return await extractProvisioning(metadataBundlePath);
+  } finally {
+    clearRegisteredPacers();
+    await fs.promises.rm(metadataBundlePath, { force: true });
+  }
+}
 export {
   buildApp
 };

package/dist/cli/codegen.d.ts

@@ -7,4 +7,9 @@ import type { DiscoveredCapability } from "./discover.js";
  * the app project, so imports are relative to that location.
  */
 export declare function generateEntry(capabilities: readonly DiscoveredCapability[]): string;
+/**
+ * Generate the build-only metadata entry. Dynamic imports run after the
+ * recorder starts and remain isolated from the deployed Worker entry.
+ */
+export declare function generateMetadataEntry(capabilities: readonly DiscoveredCapability[]): string;
 //# sourceMappingURL=codegen.d.ts.map

package/dist/cli/codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/cli/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,SAAS,oBAAoB,EAAE,GAAG,MAAM,CAyCnF"}
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/cli/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,SAAS,oBAAoB,EAAE,GAAG,MAAM,CAyCnF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,SAAS,oBAAoB,EAAE,GAAG,MAAM,CAe3F"}

package/dist/cli/codegen.js

@@ -36,6 +36,20 @@ export async function run(
 }
 `;
 }
+function generateMetadataEntry(capabilities) {
+  const imports = capabilities.map((capability) => `await import(${JSON.stringify(`../${capability.sourcePath}`)});`).join("\n");
+  return `// Generated by \`notion-apps build\`. Do not edit.
+import {
+	finishMetadataRecording,
+	startMetadataRecording,
+} from "@notionhq/apps/notion-as-code/recorder";
+
+const recorder = startMetadataRecording();
+${imports}
+export default finishMetadataRecording(recorder);
+`;
+}
 export {
-  generateEntry
+  generateEntry,
+  generateMetadataEntry
 };

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

@@ -1,7 +1,10 @@
+import { type RecordedProvisioning } from "../notion-as-code/provisioning.js";
 import type { AppManifest } from "../manifest.js";
 import type { DiscoveredCapability } from "./discover.js";
 /** Extract the app manifest from a built bundle. */
 export declare function extractManifest(bundlePath: string, capabilities: readonly DiscoveredCapability[]): Promise<AppManifest>;
+/** Import the metadata bundle and return the provisioning declarations it recorded. */
+export declare function extractProvisioning(bundlePath: string): Promise<RecordedProvisioning>;
 /**
  * Throw if `value` contains anything `JSON.stringify` would silently drop or
  * rewrite, so invalid manifest configuration fails during the build.

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,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,GAC3C,OAAO,CAAC,WAAW,CAAC,CA6EtB;AAkCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAoCjE"}
+{"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,GAC3C,OAAO,CAAC,WAAW,CAAC,CA6EtB;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"}

package/dist/cli/emit-manifest.js

@@ -2,6 +2,9 @@ import { createRequire } from "node:module";
 import { pathToFileURL } from "node:url";
 import { Ajv } from "ajv";
 import { APPS_MANIFEST_SCHEMA } from "../manifest.js";
+import {
+  isRecordedProvisioning
+} from "../notion-as-code/provisioning.js";
 import { clearRegisteredPacers, registeredPacers } from "../pacer.js";
 const SDK_VERSION = (() => {
   const require2 = createRequire(import.meta.url);
@@ -221,6 +224,13 @@ async function extractManifest(bundlePath, capabilities) {
   }
   return manifest;
 }
+async function extractProvisioning(bundlePath) {
+  const bundle = await importBundle(bundlePath);
+  if (typeof bundle !== "object" || bundle === null || !("default" in bundle) || !isRecordedProvisioning(bundle.default)) {
+    throw new Error("Metadata bundle did not export a Notion-as-Code provisioning record");
+  }
+  return bundle.default;
+}
 let importNonce = 0;
 async function importBundle(bundlePath) {
   try {
@@ -277,5 +287,6 @@ function assertJsonSafe(value, path) {
 }
 export {
   assertJsonSafe,
-  extractManifest
+  extractManifest,
+  extractProvisioning
 };

package/dist/notion-as-code/custom-agent.d.ts

@@ -0,0 +1,18 @@
+import type { NotionAsCodeIcon, ResourceId } from "./intents.js";
+export type CustomAgentArgs = {
+    resourceId: ResourceId;
+    name: string;
+    icon?: Exclude<NotionAsCodeIcon, {
+        type: "file";
+    }>;
+    instructions?: string;
+    model?: "ambrosia-tart-high" | "opal-quince-medium" | "almond-croissant-low";
+    sharedResources?: readonly ResourceId[];
+    triggers?: readonly unknown[];
+};
+export type CustomAgentHandle = {
+    readonly resourceId: string;
+};
+/** Declare a custom agent and validate every shared resource reference. */
+export declare function customAgent(args: CustomAgentArgs): CustomAgentHandle;
+//# sourceMappingURL=custom-agent.d.ts.map

package/dist/notion-as-code/custom-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-agent.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/custom-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAIpF,MAAM,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,GAAG,sBAAsB,CAAC;IAC7E,eAAe,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAExC,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CASpE"}

package/dist/notion-as-code/custom-agent.js

@@ -0,0 +1,13 @@
+import { recordIntent } from "./recorder.js";
+import { assertUserResourceId } from "./resource.js";
+function customAgent(args) {
+  assertUserResourceId(args.resourceId);
+  for (const resourceId of args.sharedResources ?? []) {
+    assertUserResourceId(resourceId);
+  }
+  recordIntent({ type: "custom_agent", ...args });
+  return { resourceId: args.resourceId };
+}
+export {
+  customAgent
+};

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

@@ -0,0 +1,44 @@
+import type { Database } from "../database.js";
+import type { DataSourceDefinition, NotionAsCodeIcon, NotionAsCodeProperty, Parent, ResourceId } from "./intents.js";
+import { type ChildPageArgs, type PageHandle } from "./page.js";
+import { type AppsSchemaForProperties } from "./schema.js";
+/** Input for declaring a database and its optional data sources. */
+export type DatabaseArgs<DataSources extends readonly DataSourceDefinition[] = readonly DataSourceDefinition[]> = {
+    resourceId: ResourceId;
+    parent: Parent;
+    dataSources?: DataSources;
+    views?: readonly unknown[];
+    icon?: NotionAsCodeIcon;
+    cover?: unknown;
+    hideDataSourceTitle?: boolean;
+    hideDatabaseTitleIfEmpty?: boolean;
+    name?: string;
+    description?: string;
+};
+/** Input for adding a database beneath an existing resource. */
+export type ChildDatabaseArgs<DataSources extends readonly DataSourceDefinition[] = readonly DataSourceDefinition[]> = Omit<DatabaseArgs<DataSources>, "parent">;
+/** Resolves one data source ID to the properties declared for it. */
+type DataSourcePropertiesForResourceId<DataSources extends readonly DataSourceDefinition[], ResourceId extends DataSources[number]["resourceId"]> = Extract<DataSources[number], {
+    resourceId: ResourceId;
+}> extends DataSourceDefinition<infer Properties> ? Properties : never;
+/** Handle for a data source and the Apps database it backs. */
+export type DataSourceHandle<Properties extends readonly NotionAsCodeProperty[] = readonly NotionAsCodeProperty[]> = {
+    readonly resourceId: string;
+    readonly schema: Properties;
+    readonly database: Database<AppsSchemaForProperties<Properties>>;
+    addPage: (args: ChildPageArgs) => PageHandle;
+};
+/** Handle for a database with data sources indexed by resource ID. */
+export type DatabaseHandle<DataSources extends readonly DataSourceDefinition[] = readonly DataSourceDefinition[]> = {
+    readonly resourceId: string;
+    readonly dataSources: {
+        readonly [ResourceId in DataSources[number]["resourceId"]]: DataSourceHandle<DataSourcePropertiesForResourceId<DataSources, ResourceId>>;
+    };
+    addView: (view: unknown) => void;
+};
+/** Declare a top-level database and its data sources. */
+export declare function database<const DataSources extends readonly DataSourceDefinition[]>(args: DatabaseArgs<DataSources>): DatabaseHandle<DataSources>;
+/** Record a database declaration and create handles for each of its data sources. */
+export declare function createDatabase(args: DatabaseArgs, parent: Parent): DatabaseHandle;
+export {};
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACX,oBAAoB,EAEpB,gBAAgB,EAChB,oBAAoB,EACpB,MAAM,EACN,UAAU,EACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5E,OAAO,EAAsB,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE/E,oEAAoE;AACpE,MAAM,MAAM,YAAY,CACvB,WAAW,SAAS,SAAS,oBAAoB,EAAE,GAAG,SAAS,oBAAoB,EAAE,IAClF;IACH,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAExB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,CAC5B,WAAW,SAAS,SAAS,oBAAoB,EAAE,GAAG,SAAS,oBAAoB,EAAE,IAClF,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AAE9C,qEAAqE;AACrE,KAAK,iCAAiC,CACrC,WAAW,SAAS,SAAS,oBAAoB,EAAE,EACnD,UAAU,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,IAEpD,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC,SAAS,oBAAoB,CACpF,MAAM,UAAU,CAChB,GACE,UAAU,GACV,KAAK,CAAC;AAEV,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,CAC3B,UAAU,SAAS,SAAS,oBAAoB,EAAE,GAAG,SAAS,oBAAoB,EAAE,IACjF;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,CAAC;IACjE,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,UAAU,CAAC;CAC7C,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,cAAc,CACzB,WAAW,SAAS,SAAS,oBAAoB,EAAE,GAAG,SAAS,oBAAoB,EAAE,IAClF;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE;QACrB,QAAQ,EAAE,UAAU,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GAAG,gBAAgB,CAC3E,iCAAiC,CAAC,WAAW,EAAE,UAAU,CAAC,CAC1D;KACD,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACjC,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,WAAW,SAAS,SAAS,oBAAoB,EAAE,EACjF,IAAI,EAAE,YAAY,CAAC,WAAW,CAAC,GAC7B,cAAc,CAAC,WAAW,CAAC,CAAC;AAM/B,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CA+BjF"}

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

@@ -0,0 +1,68 @@
+import { createPage } from "./page.js";
+import { recordIntent } from "./recorder.js";
+import { assertParent, assertUserResourceId } from "./resource.js";
+import { createAppsDatabase } from "./schema.js";
+function database(args) {
+  assertParent(args.parent);
+  return createDatabase(args, args.parent);
+}
+function createDatabase(args, parent) {
+  assertUserResourceId(args.resourceId);
+  const dataSources = args.dataSources ?? [];
+  const dataSourceIds = /* @__PURE__ */ new Set();
+  const handles = {};
+  for (const dataSource of dataSources) {
+    assertUserResourceId(dataSource.resourceId);
+    if (dataSourceIds.has(dataSource.resourceId)) {
+      throw new Error(
+        `Database "${args.resourceId}" has duplicate data source "${dataSource.resourceId}"`
+      );
+    }
+    dataSourceIds.add(dataSource.resourceId);
+    handles[dataSource.resourceId] = createDataSourceHandle(dataSource);
+  }
+  recordIntent({
+    type: "database",
+    ...args,
+    parent,
+    dataSources: [...dataSources]
+  });
+  return {
+    resourceId: args.resourceId,
+    dataSources: handles,
+    addView(view) {
+      recordIntent({ type: "view", databaseResourceId: args.resourceId, view });
+    }
+  };
+}
+function createDataSourceHandle(dataSource) {
+  const propertyResourceIds = /* @__PURE__ */ new Set();
+  const propertyNames = /* @__PURE__ */ new Set();
+  for (const property of dataSource.properties) {
+    assertUserResourceId(property.resourceId);
+    if (propertyResourceIds.has(property.resourceId)) {
+      throw new Error(
+        `Data source "${dataSource.resourceId}" has duplicate property resourceId "${property.resourceId}"`
+      );
+    }
+    if (propertyNames.has(property.name)) {
+      throw new Error(
+        `Data source "${dataSource.resourceId}" has duplicate property name "${property.name}"`
+      );
+    }
+    propertyResourceIds.add(property.resourceId);
+    propertyNames.add(property.name);
+  }
+  return {
+    resourceId: dataSource.resourceId,
+    schema: dataSource.properties,
+    database: createAppsDatabase(dataSource.resourceId, dataSource),
+    addPage(pageArgs) {
+      return createPage(pageArgs, { type: "resourceId", resourceId: dataSource.resourceId });
+    }
+  };
+}
+export {
+  createDatabase,
+  database
+};

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

@@ -0,0 +1,9 @@
+/** Serialize Notion-as-Code date values for Apps property payloads. */
+export declare function date(startDate: string, endDate?: string): unknown[][];
+/** Serialize Notion-as-Code datetime values for Apps property payloads. */
+export declare function datetime(value: {
+    start: string;
+    end?: string;
+    timeZone?: string;
+}): unknown[][];
+//# sourceMappingURL=date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/date.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,EAAE,CAWrE;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,EAAE,EAAE,CA6B/F"}

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

@@ -0,0 +1,69 @@
+function date(startDate, endDate) {
+  const start_date = parseIsoDate(startDate);
+  const end_date = endDate === void 0 ? void 0 : parseIsoDate(endDate);
+  if (end_date !== void 0 && end_date < start_date) {
+    throw new Error("Date range end must be on or after start.");
+  }
+  const value = end_date === void 0 ? { type: "date", start_date } : { type: "daterange", start_date, end_date };
+  return [["\u2023", [["d", value]]]];
+}
+function datetime(value) {
+  const timeZone = value.timeZone ?? "UTC";
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone }).format();
+  } catch {
+    throw new Error("Invalid time zone: " + timeZone);
+  }
+  const start = parseIsoDatetime(value.start);
+  const end = value.end === void 0 ? void 0 : parseIsoDatetime(value.end);
+  if (end !== void 0 && end.date + "T" + end.time < start.date + "T" + start.time) {
+    throw new Error("Datetime range end must be on or after start.");
+  }
+  const dateValue = end === void 0 ? {
+    type: "datetime",
+    start_date: start.date,
+    start_time: start.time,
+    time_zone: timeZone
+  } : {
+    type: "datetimerange",
+    start_date: start.date,
+    start_time: start.time,
+    end_date: end.date,
+    end_time: end.time,
+    time_zone: timeZone
+  };
+  return [["\u2023", [["d", dateValue]]]];
+}
+function parseIsoDate(value) {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+  if (match === null) {
+    throw new Error("Invalid ISO 8601 date: " + value + ". Expected format like 2024-01-15");
+  }
+  if (!isValidCalendarDate(match) || Number.isNaN(new Date(value).getTime())) {
+    throw new Error("Invalid date: " + value);
+  }
+  return value;
+}
+function parseIsoDatetime(value) {
+  const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})/.exec(value);
+  if (match === null) {
+    throw new Error(
+      "Invalid ISO 8601 datetime: " + value + ". Expected format like 2024-01-15T10:30 or 2024-01-15T10:30:00Z"
+    );
+  }
+  if (!isValidCalendarDate(match) || Number(match[4]) > 23 || Number(match[5]) > 59 || Number.isNaN(new Date(value).getTime())) {
+    throw new Error("Invalid datetime: " + value);
+  }
+  return { date: value.slice(0, 10), time: value.slice(11, 16) };
+}
+function isValidCalendarDate(match) {
+  const year = Number(match[1] ?? "");
+  const month = Number(match[2] ?? "");
+  const day = Number(match[3] ?? "");
+  const date2 = new Date(Date.UTC(year, month - 1, day));
+  return date2.getUTCFullYear() === year && date2.getUTCMonth() === month - 1 && date2.getUTCDate() === day;
+}
+export {
+  date,
+  datetime
+};

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

@@ -0,0 +1,32 @@
+import { customAgent } from "./custom-agent.js";
+import { database } from "./database.js";
+import { date, datetime } from "./date.js";
+import { page } from "./page.js";
+import { teamspace } from "./teamspace.js";
+declare const notionAsCodeFacade: {
+    teamspace: typeof teamspace;
+    database: typeof database;
+    page: typeof page;
+    customAgent: typeof customAgent;
+    text: (value: string) => string[][];
+    number: (value: number) => string[][];
+    date: typeof date;
+    datetime: typeof datetime;
+    select: (value: string) => string;
+    status: (value: string) => string;
+    multiSelect: (values: readonly string[]) => string;
+    checkbox: (value: boolean) => string[][];
+    url: (value: string) => (string | string[][])[][];
+    email: (value: string) => (string | string[][])[][];
+    phone: (value: string) => string[][];
+    relation: (value: string | readonly string[]) => string | any[] | readonly string[];
+    file: (resourceId: string) => {
+        type: "file";
+        resourceId: string;
+    };
+};
+export type NotionAsCodeFacade = typeof notionAsCodeFacade;
+/** Create the runtime facade used to declare Notion-as-Code project metadata. */
+export declare function createNotion(): NotionAsCodeFacade;
+export {};
+//# sourceMappingURL=handles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handles.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/handles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,QAAA,MAAM,kBAAkB;;;;;kBAKT,MAAM;oBACJ,MAAM;;;oBAGN,MAAM;oBACN,MAAM;0BACA,SAAS,MAAM,EAAE;sBACrB,OAAO;iBACZ,MAAM;mBACJ,MAAM;mBACN,MAAM;sBACH,MAAM,GAAG,SAAS,MAAM,EAAE;uBACzB,MAAM;;;;CAIzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,iFAAiF;AACjF,wBAAgB,YAAY,IAAI,kBAAkB,CAEjD"}

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

@@ -0,0 +1,34 @@
+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 { teamspace } from "./teamspace.js";
+const notionAsCodeFacade = {
+  teamspace,
+  database,
+  page,
+  customAgent,
+  text: (value) => [[value]],
+  number: (value) => [[String(value)]],
+  date,
+  datetime,
+  select: (value) => value,
+  status: (value) => value,
+  multiSelect: (values) => values.join(","),
+  checkbox: (value) => [[value ? "Yes" : "No"]],
+  url: (value) => [[value, [["a", value]]]],
+  email: (value) => [[value, [["a", `mailto:${value}`]]]],
+  phone: (value) => [[value]],
+  relation: (value) => Array.isArray(value) ? [...value] : value,
+  file: (resourceId) => {
+    assertUserResourceId(resourceId);
+    return { type: "file", resourceId };
+  }
+};
+function createNotion() {
+  return notionAsCodeFacade;
+}
+export {
+  createNotion
+};

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

@@ -0,0 +1,30 @@
+export { APPS_RESERVED_RESOURCE_ID_PREFIX, APPS_WORKSPACE_RESOURCE_ID } from "./intents.js";
+export type { DataSourceDefinition, NotionAsCodeProperty, Parent } from "./intents.js";
+export type { CustomAgentArgs, CustomAgentHandle } from "./custom-agent.js";
+export type { ChildDatabaseArgs, DataSourceHandle, DatabaseArgs, DatabaseHandle, } from "./database.js";
+export type { ChildPageArgs, PageArgs, PageHandle } from "./page.js";
+export type { TeamspaceArgs, TeamspaceHandle } from "./teamspace.js";
+/** Experimental Notion-as-Code facade for Apps SDK project metadata. */
+export declare const notion: {
+    teamspace: typeof import("./teamspace.js").teamspace;
+    database: typeof import("./database.js").database;
+    page: typeof import("./page.js").page;
+    customAgent: typeof import("./custom-agent.js").customAgent;
+    text: (value: string) => string[][];
+    number: (value: number) => string[][];
+    date: typeof import("./date.js").date;
+    datetime: typeof import("./date.js").datetime;
+    select: (value: string) => string;
+    status: (value: string) => string;
+    multiSelect: (values: readonly string[]) => string;
+    checkbox: (value: boolean) => string[][];
+    url: (value: string) => (string | string[][])[][];
+    email: (value: string) => (string | string[][])[][];
+    phone: (value: string) => string[][];
+    relation: (value: string | readonly string[]) => string | any[] | readonly string[];
+    file: (resourceId: string) => {
+        type: "file";
+        resourceId: string;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACvF,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EACX,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErE,wEAAwE;AACxE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;CAAiB,CAAC"}

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

@@ -0,0 +1,8 @@
+import { createNotion } from "./handles.js";
+import { APPS_RESERVED_RESOURCE_ID_PREFIX, APPS_WORKSPACE_RESOURCE_ID } from "./intents.js";
+const notion = createNotion();
+export {
+  APPS_RESERVED_RESOURCE_ID_PREFIX,
+  APPS_WORKSPACE_RESOURCE_ID,
+  notion
+};

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

@@ -0,0 +1,115 @@
+import type { CustomAgentArgs } from "./custom-agent.js";
+import type { DatabaseArgs } from "./database.js";
+import type { PageArgs } from "./page.js";
+import type { TeamspaceArgs } from "./teamspace.js";
+/** Apps-specific resource IDs used while declaring Notion-as-Code metadata. */
+/** Synthetic workspace parent for teamspaces declared by an Apps project. */
+export declare const APPS_WORKSPACE_RESOURCE_ID = "__notion_apps_workspace__";
+/** Reserved prefix for resource IDs owned by the Apps runtime. */
+export declare const APPS_RESERVED_RESOURCE_ID_PREFIX = "__notion_apps_";
+export type ResourceId = string;
+export type Parent = {
+    type: "resourceId";
+    resourceId: ResourceId;
+};
+export type NotionAsCodeIcon = {
+    type: "emoji";
+    emoji: string;
+} | {
+    type: "notion_icon";
+    description: string;
+    color?: string;
+} | {
+    type: "file";
+    resourceId: ResourceId;
+};
+export type NotionAsCodeSelectColor = "default" | "gray" | "brown" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "red";
+export type NotionAsCodeSelectOption = {
+    name: string;
+    color?: NotionAsCodeSelectColor;
+};
+export type NotionAsCodeStatusOption = NotionAsCodeSelectOption & {
+    default?: boolean;
+};
+type PropertyBase = {
+    resourceId: ResourceId;
+    name: string;
+    icon?: Extract<NotionAsCodeIcon, {
+        type: "notion_icon";
+    }>;
+    description?: string;
+};
+type UnsupportedProperty = PropertyBase & {
+    type: "relation" | "formula" | "rollup" | "created_time" | "last_edited_time" | "created_by" | "last_edited_by" | "auto_increment_id" | "person" | "verification";
+    [key: string]: unknown;
+};
+export type NotionAsCodeProperty = (PropertyBase & {
+    type: "title";
+}) | (PropertyBase & {
+    type: "text";
+}) | (PropertyBase & {
+    type: "number";
+}) | (PropertyBase & {
+    type: "select";
+    options?: readonly NotionAsCodeSelectOption[];
+}) | (PropertyBase & {
+    type: "multi_select";
+    options?: readonly NotionAsCodeSelectOption[];
+}) | {
+    resourceId: ResourceId;
+    name: string;
+    type: "status";
+    icon?: Extract<NotionAsCodeIcon, {
+        type: "notion_icon";
+    }>;
+    description?: string;
+    options: {
+        todo: readonly NotionAsCodeStatusOption[];
+        inProgress: readonly NotionAsCodeStatusOption[];
+        complete: readonly NotionAsCodeStatusOption[];
+    };
+} | (PropertyBase & {
+    type: "date";
+}) | (PropertyBase & {
+    type: "checkbox";
+}) | (PropertyBase & {
+    type: "url";
+}) | (PropertyBase & {
+    type: "email";
+}) | (PropertyBase & {
+    type: "phone_number";
+}) | (PropertyBase & {
+    type: "file";
+}) | UnsupportedProperty;
+export type DataSourceDefinition<Properties extends readonly NotionAsCodeProperty[] = readonly NotionAsCodeProperty[]> = {
+    resourceId: ResourceId;
+    name: string;
+    properties: Properties;
+    icon?: NotionAsCodeIcon;
+    pageLayout?: unknown;
+};
+export type TeamspaceIntent = TeamspaceArgs & {
+    parent: Parent;
+};
+export type DatabaseIntent = DatabaseArgs & {
+    dataSources: readonly DataSourceDefinition[];
+};
+export type PageIntent = PageArgs;
+export type CustomAgentIntent = CustomAgentArgs;
+export type ViewIntent = {
+    databaseResourceId: ResourceId;
+    view: unknown;
+};
+export type InfraAsCodeIntent = ({
+    type: "teamspace";
+} & TeamspaceIntent) | ({
+    type: "database";
+} & DatabaseIntent) | ({
+    type: "page";
+} & PageIntent) | ({
+    type: "custom_agent";
+} & CustomAgentIntent) | ({
+    type: "view";
+} & ViewIntent);
+export {};
+//# sourceMappingURL=intents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intents.d.ts","sourceRoot":"","sources":["../../src/notion-as-code/intents.ts"],"names":[],"mappings":"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"}