@notionhq/workers 0.4.0 → 0.6.0

package/dist/alpha/schema.d.ts

@@ -0,0 +1,185 @@
+import type { Database } from "./database.js";
+import type { DateFormat, Icon, NumberFormat, SelectOption, StatusGroup } from "./types.js";
+/**
+ * A schema defining the structure of a single property in a data source.
+ */
+export type PropertyConfiguration = {
+    type: "title";
+} | {
+    type: "text";
+} | {
+    type: "url";
+} | {
+    type: "email";
+} | {
+    type: "phone_number";
+} | {
+    type: "checkbox";
+} | {
+    type: "file";
+} | {
+    type: "number";
+    format?: NumberFormat;
+} | {
+    type: "date";
+    date_format?: DateFormat;
+} | {
+    type: "select";
+    options: SelectOption[];
+} | {
+    type: "multi_select";
+    options: SelectOption[];
+} | {
+    type: "status";
+    groups: StatusGroup[];
+} | {
+    type: "people";
+} | {
+    type: "place";
+} | {
+    type: "relation";
+    /**
+     * The related database, referenced by identity. It must be declared
+     * under `src/databases/`; the build resolves the reference to the
+     * database's key when emitting the manifest.
+     */
+    database: Database;
+    config: {
+        twoWay: false;
+    } | {
+        twoWay: true;
+        relatedPropertyName: string;
+    };
+};
+/**
+ * The property definitions for a database, keyed by property name.
+ */
+export type PropertySchema = Record<string, PropertyConfiguration>;
+/**
+ * A database schema.
+ */
+export type Schema<S extends PropertySchema = PropertySchema> = {
+    /**
+     * Optional icon to use as the icon for the database page.
+     * If not provided, defaults to 📋.
+     */
+    databaseIcon?: Icon;
+    properties: S;
+    /**
+     * Optional configuration for sub-item relations.
+     * If provided, the parent and child properties must be part of a two-way self-relation.
+     */
+    subItems?: {
+        parentPropertyName: string;
+        childPropertyName: string;
+    };
+};
+/**
+ * Builders for property definitions in a database schema.
+ *
+ * @example
+ * ```ts
+ * import { Schema } from "@notionhq/workers/alpha/schema";
+ *
+ * const schema = {
+ *   properties: {
+ *     "Task Name": Schema.title(),
+ *     "Task ID": Schema.richText(),
+ *     Status: Schema.select([
+ *       { name: "Open", color: "default" },
+ *       { name: "Done", color: "green" },
+ *     ]),
+ *   },
+ * };
+ * ```
+ */
+export declare const Schema: {
+    /**
+     * Creates a title property definition.
+     */
+    title(): PropertyConfiguration;
+    /**
+     * Creates a rich text property definition.
+     */
+    richText(): PropertyConfiguration;
+    /**
+     * Creates a URL property definition.
+     */
+    url(): PropertyConfiguration;
+    /**
+     * Creates an email property definition.
+     */
+    email(): PropertyConfiguration;
+    /**
+     * Creates a phone number property definition.
+     */
+    phoneNumber(): PropertyConfiguration;
+    /**
+     * Creates a checkbox property definition.
+     */
+    checkbox(): PropertyConfiguration;
+    /**
+     * Creates a file property definition.
+     */
+    file(): PropertyConfiguration;
+    /**
+     * Creates a number property definition with optional formatting.
+     */
+    number(format?: NumberFormat): PropertyConfiguration;
+    /**
+     * Creates a date property definition with optional formatting.
+     */
+    date(date_format?: DateFormat): PropertyConfiguration;
+    /**
+     * Creates a select property definition with predefined options.
+     */
+    select(options: SelectOption[]): PropertyConfiguration;
+    /**
+     * Creates a multi-select property definition with predefined options.
+     */
+    multiSelect(options: SelectOption[]): PropertyConfiguration;
+    /**
+     * Creates a status property definition with groups.
+     */
+    status(config: {
+        groups: StatusGroup[];
+    }): PropertyConfiguration;
+    /**
+     * Creates a people property definition.
+     */
+    people(): PropertyConfiguration;
+    /**
+     * Creates a place property definition for storing geographic locations.
+     */
+    place(): PropertyConfiguration;
+    /**
+     * Creates a relation property definition that references another database.
+     * The related database must be declared under `src/databases/` and is
+     * referenced by importing it:
+     *
+     * @example
+     * ```ts
+     * // src/databases/tasks.ts
+     * import projects from "./projects.js";
+     *
+     * export default createDatabase({
+     *   type: "managed",
+     *   primaryKey: "Task ID",
+     *   schema: {
+     *     properties: {
+     *       Title: Schema.title(),
+     *       "Task ID": Schema.richText(),
+     *       Project: Schema.relation(projects),
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    relation(database: Database<any>, config?: {
+        twoWay: false;
+    } | {
+        twoWay: true;
+        relatedPropertyName: string;
+    }): PropertyConfiguration;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/alpha/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/alpha/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;CACrB,GACD;IACA,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,UAAU,CAAC;CACxB,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;CACvB,GACD;IACA,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;CACvB,GACD;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IACA,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE,CAAC;AAEL;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI;IAC/D;;;OAGG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE;QACV,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM;IAClB;;OAEG;aACM,qBAAqB;IAI9B;;OAEG;gBACS,qBAAqB;IAIjC;;OAEG;WACI,qBAAqB;IAI5B;;OAEG;aACM,qBAAqB;IAI9B;;OAEG;mBACY,qBAAqB;IAIpC;;OAEG;gBACS,qBAAqB;IAIjC;;OAEG;YACK,qBAAqB;IAI7B;;OAEG;oBACa,YAAY,GAAG,qBAAqB;IAIpD;;OAEG;uBACgB,UAAU,GAAG,qBAAqB;IAIrD;;OAEG;oBACa,YAAY,EAAE,GAAG,qBAAqB;IAItD;;OAEG;yBACkB,YAAY,EAAE,GAAG,qBAAqB;IAI3D;;OAEG;mBACY;QAAE,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,GAAG,qBAAqB;IAIhE;;OAEG;cACO,qBAAqB;IAI/B;;OAEG;aACM,qBAAqB;IAI9B;;;;;;;;;;;;;;;;;;;;;;OAsBG;uBAIQ,QAAQ,CAAC,GAAG,CAAC,WACd;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,GACxE,qBAAqB;CAGxB,CAAC"}

package/dist/alpha/schema.js

@@ -0,0 +1,115 @@
+const Schema = {
+  /**
+   * Creates a title property definition.
+   */
+  title() {
+    return { type: "title" };
+  },
+  /**
+   * Creates a rich text property definition.
+   */
+  richText() {
+    return { type: "text" };
+  },
+  /**
+   * Creates a URL property definition.
+   */
+  url() {
+    return { type: "url" };
+  },
+  /**
+   * Creates an email property definition.
+   */
+  email() {
+    return { type: "email" };
+  },
+  /**
+   * Creates a phone number property definition.
+   */
+  phoneNumber() {
+    return { type: "phone_number" };
+  },
+  /**
+   * Creates a checkbox property definition.
+   */
+  checkbox() {
+    return { type: "checkbox" };
+  },
+  /**
+   * Creates a file property definition.
+   */
+  file() {
+    return { type: "file" };
+  },
+  /**
+   * Creates a number property definition with optional formatting.
+   */
+  number(format) {
+    return format ? { type: "number", format } : { type: "number" };
+  },
+  /**
+   * Creates a date property definition with optional formatting.
+   */
+  date(date_format) {
+    return date_format ? { type: "date", date_format } : { type: "date" };
+  },
+  /**
+   * Creates a select property definition with predefined options.
+   */
+  select(options) {
+    return { type: "select", options };
+  },
+  /**
+   * Creates a multi-select property definition with predefined options.
+   */
+  multiSelect(options) {
+    return { type: "multi_select", options };
+  },
+  /**
+   * Creates a status property definition with groups.
+   */
+  status(config) {
+    return { type: "status", groups: config.groups };
+  },
+  /**
+   * Creates a people property definition.
+   */
+  people() {
+    return { type: "people" };
+  },
+  /**
+   * Creates a place property definition for storing geographic locations.
+   */
+  place() {
+    return { type: "place" };
+  },
+  /**
+   * Creates a relation property definition that references another database.
+   * The related database must be declared under `src/databases/` and is
+   * referenced by importing it:
+   *
+   * @example
+   * ```ts
+   * // src/databases/tasks.ts
+   * import projects from "./projects.js";
+   *
+   * export default createDatabase({
+   *   type: "managed",
+   *   primaryKey: "Task ID",
+   *   schema: {
+   *     properties: {
+   *       Title: Schema.title(),
+   *       "Task ID": Schema.richText(),
+   *       Project: Schema.relation(projects),
+   *     },
+   *   },
+   * });
+   * ```
+   */
+  relation(database, config) {
+    return { type: "relation", database, config: config ?? { twoWay: false } };
+  }
+};
+export {
+  Schema
+};

package/dist/alpha/sync.d.ts

@@ -0,0 +1,233 @@
+import type { CapabilityContext } from "./context.js";
+import type { Database } from "./database.js";
+import { type PacerEntry } from "./pacer.js";
+import type { PropertyConfiguration, PropertySchema, Schema } from "./schema.js";
+import type { Cover, HandlerOptions, Icon, NormalizedSchedule, PeopleValue, PlaceValue, RelationValue, Schedule, TextValue } from "./types.js";
+/**
+ * Maps a property configuration to its corresponding value type.
+ */
+type PropertyValueType<T extends PropertyConfiguration> = T extends {
+    type: "people";
+} ? PeopleValue : T extends {
+    type: "place";
+} ? PlaceValue : T extends {
+    type: "relation";
+} ? RelationValue : TextValue;
+/**
+ * Sync mode determines how the sync handles data lifecycle.
+ */
+export type SyncMode = "replace" | "incremental";
+/**
+ * A change representing a record to be created or updated.
+ */
+export type SyncChangeUpsert<S extends PropertySchema = PropertySchema> = {
+    /** The type of change. Use `"upsert"` to create or update a record. */
+    type: "upsert";
+    /** A unique identifier for this record, used to match against existing pages. */
+    key: string;
+    /**
+     * The property values for this record.
+     * Keys must match the property names defined in the schema.
+     * Use the Builder helpers (e.g. `Builder.title()`, `Builder.richText()`)
+     * to create values.
+     */
+    properties: {
+        [Property in keyof S]: PropertyValueType<S[Property]>;
+    };
+    /**
+     * When this record was last updated in the upstream system.
+     * ISO 8601 string (e.g. `"2026-03-19T12:00:00Z"`).
+     * Used for conflict resolution when multiple syncs write to the same
+     * database. Recommended, but optional.
+     */
+    upstreamUpdatedAt?: string;
+    /**
+     * Optional icon to use as the icon for this row's page.
+     * Use the `Builder.emojiIcon()`, `Builder.notionIcon()`, or
+     * `Builder.imageIcon()` helpers.
+     */
+    icon?: Icon;
+    /**
+     * Optional cover to use as the cover for this row's page.
+     * Use the `Builder.imageCover()` helper.
+     */
+    cover?: Cover;
+    /**
+     * Optional markdown content to add to the page body.
+     * This will be converted to Notion blocks and added as page content.
+     */
+    pageContentMarkdown?: string;
+};
+/**
+ * A change representing a record to be deleted.
+ * Only applicable when using `mode: "incremental"`.
+ */
+export type SyncChangeDelete = {
+    /** The type of change. Use `"delete"` to remove a record. */
+    type: "delete";
+    /** The unique identifier of the record to delete. */
+    key: string;
+};
+/**
+ * A change to be applied to the synced database.
+ */
+export type SyncChange<S extends PropertySchema = PropertySchema> = SyncChangeUpsert<S> | SyncChangeDelete;
+/**
+ * Result returned from a sync handler.
+ */
+export type SyncHandlerResult<S extends PropertySchema = PropertySchema, State = unknown> = {
+    /** The batch of changes to apply in this execution. */
+    changes: SyncChange<S>[];
+    /**
+     * Indicates whether there is more data to fetch. When `true`, the
+     * handler is called again with `nextState`.
+     *
+     * @default false
+     */
+    hasMore?: boolean;
+    /**
+     * Optional state data to pass to the next execution.
+     * Required if `hasMore` is `true`, ignored otherwise.
+     * This can be any type of data (cursor, page number, timestamp, etc.);
+     * the same data is provided as `state` in the next execution.
+     */
+    nextState?: State;
+};
+/**
+ * Configuration passed to {@link createSync}.
+ */
+export type SyncConfiguration<S extends PropertySchema = PropertySchema, State = unknown> = {
+    /**
+     * The database to sync data into, declared with `createDatabase(...)`.
+     * Declare it inline for a database private to this sync, or import a
+     * shared instance that other syncs (and `Schema.relation(...)`) also
+     * reference.
+     */
+    database: Database<S>;
+    /**
+     * How the sync handles data lifecycle:
+     * - "replace": Each run returns the complete dataset; unseen pages are deleted.
+     * - "incremental": Each run returns changes only; use delete markers to remove pages.
+     *
+     * @default "replace"
+     */
+    mode?: SyncMode;
+    /**
+     * How often the sync should run.
+     * - "continuous": Run as frequently as the system allows
+     * - "manual": Only run when explicitly triggered
+     * - Interval string: Run at specified intervals, e.g. "1h", "30m", "1d"
+     *
+     * @default "30m"
+     */
+    schedule?: Schedule;
+    /**
+     * Fetches the data to sync from the third-party service.
+     *
+     * This function can return all data at once, or implement pagination by
+     * returning a batch of changes with `hasMore: true` and a `nextState`;
+     * the runtime calls it again with that state until `hasMore` is `false`.
+     *
+     * @param state - User-defined state from the previous execution (undefined on first call)
+     * @param context - Runtime context, including the Notion client
+     */
+    handler: (state: State | undefined, context: CapabilityContext) => Promise<SyncHandlerResult<S, State>>;
+};
+/**
+ * The pre-manifest configuration of a sync: everything from
+ * {@link SyncConfiguration} except the handler, with the schedule
+ * normalized for the backend and the database's schema type erased.
+ *
+ * The `database` here is still an object reference; the build resolves it
+ * to the database's *name* when emitting the manifest.
+ */
+export type SyncManifestConfig = {
+    database: {
+        _tag: "database";
+        name: string;
+        config: {
+            type: "managed";
+            initialTitle?: string;
+            primaryKey: string;
+            schema: Schema;
+        };
+    };
+    mode: SyncMode | undefined;
+    schedule: NormalizedSchedule | undefined;
+};
+/**
+ * The runtime context the platform passes when invoking a sync.
+ */
+export type SyncRuntimeContext = {
+    /** The user-defined state (cursor, pagination state, etc.). */
+    state?: unknown;
+    /** Legacy field for user-defined state. */
+    userContext?: unknown;
+    /** Pacer state from the server for rate limiting. */
+    pacers?: Record<string, PacerEntry>;
+};
+/**
+ * The result a sync run reports to the platform, via the notion_output
+ * envelope on stdout (or directly, under `concreteOutput`). This is the
+ * same wire shape v1 syncs produce.
+ */
+export type SyncRunResult = {
+    changes: (SyncChange & {
+        targetDatabaseKey: string;
+    })[];
+    hasMore: boolean;
+    nextUserContext?: unknown;
+    nextPacerStates: Record<string, PacerEntry>;
+};
+/**
+ * A sync capability as returned by {@link createSync}.
+ *
+ * Note that a sync carries no key of its own — the build tool derives the
+ * capability key from the file the sync is default-exported from.
+ */
+export type Sync = {
+    _tag: "sync";
+    config: SyncManifestConfig;
+    handler: (runtimeContext?: SyncRuntimeContext, options?: HandlerOptions) => Promise<SyncRunResult>;
+};
+/**
+ * Create a sync capability.
+ *
+ * Default-export the result from a file directly under `src/syncs/` —
+ * the file's basename becomes the sync's key.
+ *
+ * @example
+ * ```ts
+ * // src/syncs/tasks.ts
+ * import { createDatabase } from "@notionhq/workers/alpha/database";
+ * import { Schema } from "@notionhq/workers/alpha/schema";
+ * import { createSync } from "@notionhq/workers/alpha/sync";
+ *
+ * export default createSync({
+ *   database: createDatabase("tasks", {
+ *     type: "managed",
+ *     primaryKey: "Task ID",
+ *     schema: {
+ *       properties: {
+ *         Title: Schema.title(),
+ *         "Task ID": Schema.richText(),
+ *       },
+ *     },
+ *   }),
+ *   mode: "replace",
+ *   schedule: "24h",
+ *   handler: async () => ({
+ *     changes: [
+ *       {
+ *         type: "upsert",
+ *         key: "1",
+ *         properties: { Title: [["Item 1"]], "Task ID": [["1"]] },
+ *       },
+ *     ],
+ *   }),
+ * });
+ * ```
+ */
+export declare function createSync<S extends PropertySchema, State = unknown>(configuration: SyncConfiguration<S, State>): Sync;
+export {};
+//# sourceMappingURL=sync.d.ts.map

package/dist/alpha/sync.d.ts.map

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

package/dist/alpha/sync.js

@@ -0,0 +1,70 @@
+import { createCapabilityContext } from "./context.js";
+import { ExecutionError, RateLimitError } from "./error.js";
+import { writeOutput } from "./output.js";
+import { initPacerState, pacerStates } from "./pacer.js";
+import { parseSchedule } from "./schedule.js";
+function createSync(configuration) {
+  return {
+    _tag: "sync",
+    config: {
+      database: configuration.database,
+      mode: configuration.mode,
+      schedule: configuration.schedule ? parseSchedule(configuration.schedule) : void 0
+    },
+    async handler(runtimeContext, options) {
+      const state = runtimeContext?.state ?? runtimeContext?.userContext;
+      initPacerState(runtimeContext?.pacers);
+      let handlerResult;
+      try {
+        handlerResult = await configuration.handler(state, createCapabilityContext("sync"));
+      } catch (err) {
+        if (err instanceof RateLimitError) {
+          if (!options?.concreteOutput) {
+            const envelope = {
+              _tag: "error",
+              error: {
+                _tag: "rate_limit",
+                name: err.name,
+                message: err.message,
+                ...err.retryAfter !== void 0 ? { retryAfter: err.retryAfter } : {}
+              }
+            };
+            writeOutput(envelope);
+          }
+          throw err;
+        }
+        const error = new ExecutionError(err);
+        if (!options?.concreteOutput) {
+          const envelope = {
+            _tag: "error",
+            error: {
+              _tag: "generic",
+              name: error.name,
+              message: error.message
+            }
+          };
+          writeOutput(envelope);
+        }
+        throw error;
+      }
+      const changes = handlerResult.changes.map((change) => ({
+        ...change,
+        targetDatabaseKey: configuration.database.name
+      }));
+      const result = {
+        changes,
+        hasMore: handlerResult.hasMore ?? false,
+        nextUserContext: handlerResult.nextState,
+        nextPacerStates: pacerStates()
+      };
+      if (options?.concreteOutput) {
+        return result;
+      }
+      writeOutput({ _tag: "success", value: result });
+      return result;
+    }
+  };
+}
+export {
+  createSync
+};

package/dist/alpha/sync.test.d.ts

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

package/dist/alpha/sync.test.d.ts.map

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