@project-ajax/sdk 0.0.57 → 0.0.60

package/dist/builder.d.ts

@@ -1,5 +1,5 @@
 import type { NoticonName } from "./icon-names.js";
-import type { Icon, NoticonColor, TextValue } from "./types.js";
+import type { Icon, NoticonColor, PeopleValue, TextValue } from "./types.js";
 /**
  * Creates a rich text value.
  */
@@ -73,6 +73,11 @@ export declare function multiSelect(...values: string[]): TextValue;
  * Creates a status value from a status option name.
  */
 export declare function status(value: string): TextValue;
+/**
+ * Creates a people value from email addresses.
+ * @param emails - Array of email addresses for people to include
+ */
+export declare function people(...emails: string[]): PeopleValue;
 /**
  * Creates an emoji icon.
  * @param emoji - An emoji string (e.g., "🎯", "✨", "🚀")

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAa,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3E;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAK/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CASlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAYjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAWvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,QAAQ,CAAC,EAAE,MAAM,GACf,SAAS,CAcX;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAK1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AA4CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,YAAqB,GAC1B,IAAI,CAMN"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAEX,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,SAAS,EACT,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAK/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CASlD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAYjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAWvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,EACb,QAAQ,CAAC,EAAE,MAAM,GACf,SAAS,CAcX;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAK1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAEvD;AA4CD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,YAAqB,GAC1B,IAAI,CAMN"}

package/dist/builder.js

@@ -85,6 +85,9 @@ function multiSelect(...values) {
 function status(value) {
   return [[value]];
 }
+function people(...emails) {
+  return emails.map((email2) => ({ email: email2 }));
+}
 function validateDateString(dateString) {
   if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
     throw new Error(
@@ -136,6 +139,7 @@ export {
   multiSelect,
   notionIcon,
   number,
+  people,
   phoneNumber,
   richText,
   select,

package/dist/capabilities/sync.d.ts

@@ -1,12 +1,18 @@
-import type { PropertySchema, Schema } from "../schema.js";
-import type { Icon, TextValue } from "../types.js";
+import type { PropertyConfiguration, PropertySchema, Schema } from "../schema.js";
+import type { Icon, PeopleValue, TextValue } from "../types.js";
+/**
+ * Maps a property configuration to its corresponding value type.
+ */
+type PropertyValueType<T extends PropertyConfiguration> = T extends {
+    type: "people";
+} ? PeopleValue : TextValue;
 /**
  * An object representing a third-party record to be synced.
  */
 export type SyncedObject<PK extends string, S extends PropertySchema<PK>> = {
     key: string;
     properties: {
-        [Property in keyof S]: TextValue;
+        [Property in keyof S]: PropertyValueType<S[Property]>;
     };
     /**
      * Optional icon to use as the icon for this row's page.
@@ -19,11 +25,33 @@ export type SyncedObject<PK extends string, S extends PropertySchema<PK>> = {
      */
     pageContentMarkdown?: string;
 };
+/**
+ * Result returned from the sync execute function.
+ */
+export type SyncExecutionResult<PK extends string, Context = unknown> = {
+    /**
+     * The batch of objects fetched in this execution.
+     */
+    objects: SyncedObject<PK, PropertySchema<PK>>[];
+    /**
+     * Indicates whether the sync is complete.
+     * - `true`: No more data to fetch, sync is complete
+     * - `false`: More data available, will trigger another execution with nextContext
+     */
+    done: boolean;
+    /**
+     * Optional context data to pass to the next execution.
+     * Required if `done` is `false`, ignored if `done` is `true`.
+     * This can be any type of data (cursor, page number, timestamp, etc.).
+     * The same data will be provided in the context parameter of the next execution.
+     */
+    nextContext?: Context;
+};
 /**
  * A configuration object that enables synchronization between a data
  * source and a third-party source.
  */
-export type SyncConfiguration<PK extends string, S extends Schema<PK>> = {
+export type SyncConfiguration<PK extends string, S extends Schema<PK>, Context = unknown> = {
     /**
      * The property of the data source that maps to a "primary key" in the
      * third-party data. This is used to match existing pages to
@@ -34,18 +62,38 @@ export type SyncConfiguration<PK extends string, S extends Schema<PK>> = {
      * The schema defining the structure of properties in the collection.
      */
     schema: S;
+    /**
+     * Whether to delete pages from the collection that are not returned
+     * from any of the sync executions (mark-and-sweep deletion).
+     *
+     * - `true`: Pages not seen in any execution batch will be deleted
+     * - `false` (default): Only upsert pages, never delete
+     *
+     * @default false
+     */
+    deleteUnreturnedPages?: boolean;
     /**
      * A function that fetches the data to sync from the third-party service.
      *
-     * For now, this function must return all of the data to be synced each time
-     * it's called. The runtime will handle diffing this against the data source
-     * and creating, updating, and deleting pages as necessary.
+     * This function can return all data at once, or implement pagination by:
+     * 1. Returning a batch of objects with `done: false` and a `nextContext`
+     * 2. The runtime will call execute again with that context data
+     * 3. Continue until `done: true` is returned
+     *
+     * The runtime will handle diffing against the data source and creating,
+     * updating, and deleting pages as necessary.
+     *
+     * @param context - Optional context data from previous execution (undefined on first call)
+     * @returns A result containing objects, done status, and optional nextContext
      */
-    execute: () => Promise<SyncedObject<PK, PropertySchema<PK>>[]>;
+    execute: (context?: Context) => Promise<SyncExecutionResult<PK, Context>>;
 };
-export type SyncHandlerResult<PK extends string> = {
+export type SyncHandlerResult<PK extends string, Context = unknown> = {
     primaryKeyProperty: PK;
     objects: SyncedObject<PK, PropertySchema<PK>>[];
+    done: boolean;
+    nextContext?: Context;
+    deleteUnreturnedPages?: boolean;
 };
 /**
  * Creates a special handler for syncing third-party data to a collection.
@@ -54,15 +102,18 @@ export type SyncHandlerResult<PK extends string> = {
  * @returns A handler function that executes the sync function, and passes data
  * needed to complete the sync back to the platform.
  */
-export declare function sync<PK extends string, S extends Schema<PK>>(syncConfiguration: SyncConfiguration<PK, S>): {
+export declare function sync<PK extends string, S extends Schema<PK>, Context = unknown>(syncConfiguration: SyncConfiguration<PK, S, Context>): {
     _tag: string;
     config: {
+        primaryKeyProperty: PK;
         schema: S;
+        deleteUnreturnedPages: boolean | undefined;
     };
-    handler(): Promise<{
-        schema: S;
-        primaryKeyProperty: PK;
+    handler(context?: Context): Promise<{
         objects: SyncedObject<PK, PropertySchema<PK>>[];
+        done: boolean;
+        nextContext: Context | undefined;
     }>;
 };
+export {};
 //# sourceMappingURL=sync.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/capabilities/sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,EAAE,CAAC,IAAI;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE;SAAG,QAAQ,IAAI,MAAM,CAAC,GAAG,SAAS;KAAE,CAAC;IACjD;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,IAAI;IACxE;;;;OAIG;IACH,kBAAkB,EAAE,EAAE,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,MAAM,IAAI;IAClD,kBAAkB,EAAE,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;CAChD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAC3D,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,CAAC;;;;;;;;;;EAuB3C"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/capabilities/sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,qBAAqB,EACrB,cAAc,EACd,MAAM,EACN,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEhE;;GAEG;AACH,KAAK,iBAAiB,CAAC,CAAC,SAAS,qBAAqB,IAAI,CAAC,SAAS;IACnE,IAAI,EAAE,QAAQ,CAAC;CACf,GACE,WAAW,GACX,SAAS,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,CAAC,EAAE,CAAC,IAAI;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE;SACV,QAAQ,IAAI,MAAM,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;KACrD,CAAC;IACF;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,OAAO,GAAG,OAAO,IAAI;IACvE;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAEhD;;;;OAIG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAC5B,EAAE,SAAS,MAAM,EACjB,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EACpB,OAAO,GAAG,OAAO,IACd;IACH;;;;OAIG;IACH,kBAAkB,EAAE,EAAE,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;;;;;;;OAQG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;;;;;OAaG;IACH,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,OAAO,GAAG,OAAO,IAAI;IACrE,kBAAkB,EAAE,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,IAAI,CACnB,EAAE,SAAS,MAAM,EACjB,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EACpB,OAAO,GAAG,OAAO,EAChB,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC;;;;;;;sBAQ5B,OAAO;;;;;EAkBhC"}

package/dist/capabilities/sync.js

@@ -3,16 +3,18 @@ function sync(syncConfiguration) {
   return {
     _tag: "sync",
     config: {
-      schema: syncConfiguration.schema
+      primaryKeyProperty: syncConfiguration.primaryKeyProperty,
+      schema: syncConfiguration.schema,
+      deleteUnreturnedPages: syncConfiguration.deleteUnreturnedPages
     },
-    async handler() {
-      const objects = await syncConfiguration.execute().catch((err) => {
+    async handler(context) {
+      const executionResult = await syncConfiguration.execute(context).catch((err) => {
         throw new ExecutionError(err);
       });
       const result = {
-        schema: syncConfiguration.schema,
-        primaryKeyProperty: syncConfiguration.primaryKeyProperty,
-        objects
+        objects: executionResult.objects,
+        done: executionResult.done,
+        nextContext: executionResult.nextContext
       };
       process.stdout.write(`
 <output>${JSON.stringify(result)}</output>

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

@@ -1 +1 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/cli/io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAe,KAAK,SAAS,EAAkB,MAAM,mBAAmB,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC;IACrC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CACf;AAED,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,qBAAa,EAAE;;IACd,YAAY,EAAE,OAAO,CAAC;gBAEV,OAAO,EAAE,aAAa;IAIlC;;;;OAIG;IACH,KAAK,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC;IAW7C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAIzD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAIzD;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,YAAY;IAKvC;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,YAAY;IAKvC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IASjE,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CAkC7D"}
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/cli/io.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAe,KAAK,SAAS,EAAkB,MAAM,mBAAmB,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC7B,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC;IACrC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CACf;AAED,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,qBAAa,EAAE;;IACd,YAAY,EAAE,OAAO,CAAC;gBAEV,OAAO,EAAE,aAAa;IAIlC;;;;OAIG;IACH,KAAK,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC;IAW7C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAIzD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAIzD;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,YAAY;IAKvC;;;;OAIG;IACH,aAAa,CAAC,WAAW,EAAE,YAAY;IAKvC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAKjE,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CAuC7D"}

package/dist/cli/io.js

@@ -54,18 +54,19 @@ class IO {
     this.writeErr(content);
   }
   confirm(config) {
-    if (!process.stdin.isTTY) {
-      this.writeErr(config.noTTY);
-      process.exit(1);
-    }
+    this.#ensureTTY(config.noTTY);
     return prompts.confirm(config).catch(this.#handlePromptExit.bind(this));
   }
   input(config) {
+    this.#ensureTTY(config.noTTY);
+    return prompts.input(config).catch(this.#handlePromptExit.bind(this));
+  }
+  #ensureTTY(noTTY) {
     if (!process.stdin.isTTY) {
-      this.writeErr(config.noTTY);
+      this.writeErr(noTTY);
       process.exit(1);
     }
-    return prompts.input(config).catch(this.#handlePromptExit.bind(this));
+    return true;
   }
   #handlePromptExit(err) {
     if (err instanceof Error && err.name === "ExitPromptError") {

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { emojiIcon, notionIcon } from "./builder.js";
 export { slashCommand } from "./capabilities/slashCommand.js";
+export type { SyncConfiguration, SyncExecutionResult, SyncedObject, } from "./capabilities/sync.js";
 export { sync } from "./capabilities/sync.js";
 export { tool } from "./capabilities/tool.js";
 export type { Icon, NoticonColor, NoticonName } from "./types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,YAAY,EACX,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/schema.d.ts

@@ -2,7 +2,7 @@ import type { DateFormat, Icon, NumberFormat, SelectOption, StatusGroup } from "
 /**
  * Supported property types for sync schemas.
  */
-export type PropertyType = "title" | "rich_text" | "url" | "email" | "phone_number" | "checkbox" | "file" | "number" | "date" | "select" | "multi_select" | "status";
+export type PropertyType = "title" | "rich_text" | "url" | "email" | "phone_number" | "checkbox" | "file" | "number" | "date" | "select" | "multi_select" | "status" | "people";
 /**
  * Definition of a single property in a sync schema.
  */
@@ -41,6 +41,8 @@ export type PropertyConfiguration = {
 } | {
     type: "status";
     groups: StatusGroup[];
+} | {
+    type: "people";
 };
 export type Schema<PK extends string> = {
     dataSourceTitle: string;
@@ -110,4 +112,8 @@ export declare function multiSelect(options: SelectOption[]): PropertyConfigurat
 export declare function status(config: {
     groups: StatusGroup[];
 }): PropertyConfiguration;
+/**
+ * Creates a people property definition.
+ */
+export declare function people(): PropertyConfiguration;
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,OAAO,GACP,WAAW,GACX,KAAK,GACL,OAAO,GACP,cAAc,GACd,UAAU,GACV,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,cAAc,GACd,QAAQ,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,YAAY,CAAC;CACnB,CAAC;AAEF;;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,CAAC;AAEL,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,MAAM,IAAI;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,MAAM,IAAI;KAC9C,UAAU,IAAI,EAAE,GAAG,qBAAqB;CACzC,GAAG;IACH,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;GAEG;AACH,wBAAgB,GAAG,IAAI,qBAAqB,CAE3C;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,qBAAqB,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,qBAAqB,CAEnD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,qBAAqB,CAEhD;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,qBAAqB,CAE5C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,qBAAqB,CAEnE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,qBAAqB,CAEpE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAErE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAE1E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACtB,GAAG,qBAAqB,CAExB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema.js

@@ -34,6 +34,9 @@ function multiSelect(options) {
 function status(config) {
   return { type: "status", groups: config.groups };
 }
+function people() {
+  return { type: "people" };
+}
 export {
   checkbox,
   date,
@@ -41,6 +44,7 @@ export {
   file,
   multiSelect,
   number,
+  people,
   phoneNumber,
   richText,
   select,

package/dist/types.d.ts

@@ -106,5 +106,18 @@ export interface NoticonIcon {
  * All possible icon types
  */
 export type Icon = EmojiIcon | NoticonIcon;
+/**
+ * Person reference - represents a user in a people property
+ */
+export interface PersonReference {
+    /**
+     * The email address of the user
+     */
+    email: string;
+}
+/**
+ * A PeopleValue is an array of person references
+ */
+export type PeopleValue = PersonReference[];
 export type { NoticonName } from "./icon-names.js";
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,KAAK,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,WAAW,GACpB,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,MAAM,GACN,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,GAAG,aAAa,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,QAAQ,GACR,oBAAoB,GACpB,SAAS,GACT,QAAQ,GACR,MAAM,GACN,OAAO,GACP,KAAK,GACL,OAAO,GACP,KAAK,GACL,MAAM,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,IAAI,GACJ,OAAO,CAAC;AAEX,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,MAAM,GACN,WAAW,GACX,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,MAAM,GACN,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@project-ajax/sdk",
-	"version": "0.0.57",
+	"version": "0.0.60",
 	"description": "An SDK for building workers for the Project Ajax platform",
 	"license": "UNLICENSED",
 	"type": "module",

package/src/builder.ts

@@ -1,5 +1,11 @@
 import type { NoticonName } from "./icon-names.js";
-import type { DateValue, Icon, NoticonColor, TextValue } from "./types.js";
+import type {
+	DateValue,
+	Icon,
+	NoticonColor,
+	PeopleValue,
+	TextValue,
+} from "./types.js";
 
 /**
  * Creates a rich text value.
@@ -173,6 +179,14 @@ export function status(value: string): TextValue {
 	return [[value]];
 }
 
+/**
+ * Creates a people value from email addresses.
+ * @param emails - Array of email addresses for people to include
+ */
+export function people(...emails: string[]): PeopleValue {
+	return emails.map((email) => ({ email }));
+}
+
 /**
  * Validates a date string is in YYYY-MM-DD format and represents a valid date.
  */

package/src/capabilities/sync.ts

@@ -1,13 +1,28 @@
 import { ExecutionError } from "../error.js";
-import type { PropertySchema, Schema } from "../schema.js";
-import type { Icon, TextValue } from "../types.js";
+import type {
+	PropertyConfiguration,
+	PropertySchema,
+	Schema,
+} from "../schema.js";
+import type { Icon, PeopleValue, TextValue } from "../types.js";
+
+/**
+ * Maps a property configuration to its corresponding value type.
+ */
+type PropertyValueType<T extends PropertyConfiguration> = T extends {
+	type: "people";
+}
+	? PeopleValue
+	: TextValue;
 
 /**
  * An object representing a third-party record to be synced.
  */
 export type SyncedObject<PK extends string, S extends PropertySchema<PK>> = {
 	key: string;
-	properties: { [Property in keyof S]: TextValue };
+	properties: {
+		[Property in keyof S]: PropertyValueType<S[Property]>;
+	};
 	/**
 	 * Optional icon to use as the icon for this row's page.
 	 * Use the `icon()` builder to create an icon value.
@@ -20,11 +35,40 @@ export type SyncedObject<PK extends string, S extends PropertySchema<PK>> = {
 	pageContentMarkdown?: string;
 };
 
+/**
+ * Result returned from the sync execute function.
+ */
+export type SyncExecutionResult<PK extends string, Context = unknown> = {
+	/**
+	 * The batch of objects fetched in this execution.
+	 */
+	objects: SyncedObject<PK, PropertySchema<PK>>[];
+
+	/**
+	 * Indicates whether the sync is complete.
+	 * - `true`: No more data to fetch, sync is complete
+	 * - `false`: More data available, will trigger another execution with nextContext
+	 */
+	done: boolean;
+
+	/**
+	 * Optional context data to pass to the next execution.
+	 * Required if `done` is `false`, ignored if `done` is `true`.
+	 * This can be any type of data (cursor, page number, timestamp, etc.).
+	 * The same data will be provided in the context parameter of the next execution.
+	 */
+	nextContext?: Context;
+};
+
 /**
  * A configuration object that enables synchronization between a data
  * source and a third-party source.
  */
-export type SyncConfiguration<PK extends string, S extends Schema<PK>> = {
+export type SyncConfiguration<
+	PK extends string,
+	S extends Schema<PK>,
+	Context = unknown,
+> = {
 	/**
 	 * The property of the data source that maps to a "primary key" in the
 	 * third-party data. This is used to match existing pages to
@@ -37,19 +81,40 @@ export type SyncConfiguration<PK extends string, S extends Schema<PK>> = {
 	 */
 	schema: S;
 
+	/**
+	 * Whether to delete pages from the collection that are not returned
+	 * from any of the sync executions (mark-and-sweep deletion).
+	 *
+	 * - `true`: Pages not seen in any execution batch will be deleted
+	 * - `false` (default): Only upsert pages, never delete
+	 *
+	 * @default false
+	 */
+	deleteUnreturnedPages?: boolean;
+
 	/**
 	 * A function that fetches the data to sync from the third-party service.
 	 *
-	 * For now, this function must return all of the data to be synced each time
-	 * it's called. The runtime will handle diffing this against the data source
-	 * and creating, updating, and deleting pages as necessary.
+	 * This function can return all data at once, or implement pagination by:
+	 * 1. Returning a batch of objects with `done: false` and a `nextContext`
+	 * 2. The runtime will call execute again with that context data
+	 * 3. Continue until `done: true` is returned
+	 *
+	 * The runtime will handle diffing against the data source and creating,
+	 * updating, and deleting pages as necessary.
+	 *
+	 * @param context - Optional context data from previous execution (undefined on first call)
+	 * @returns A result containing objects, done status, and optional nextContext
 	 */
-	execute: () => Promise<SyncedObject<PK, PropertySchema<PK>>[]>;
+	execute: (context?: Context) => Promise<SyncExecutionResult<PK, Context>>;
 };
 
-export type SyncHandlerResult<PK extends string> = {
+export type SyncHandlerResult<PK extends string, Context = unknown> = {
 	primaryKeyProperty: PK;
 	objects: SyncedObject<PK, PropertySchema<PK>>[];
+	done: boolean;
+	nextContext?: Context;
+	deleteUnreturnedPages?: boolean;
 };
 
 /**
@@ -59,23 +124,29 @@ export type SyncHandlerResult<PK extends string> = {
  * @returns A handler function that executes the sync function, and passes data
  * needed to complete the sync back to the platform.
  */
-export function sync<PK extends string, S extends Schema<PK>>(
-	syncConfiguration: SyncConfiguration<PK, S>,
-) {
+export function sync<
+	PK extends string,
+	S extends Schema<PK>,
+	Context = unknown,
+>(syncConfiguration: SyncConfiguration<PK, S, Context>) {
 	return {
 		_tag: "sync",
 		config: {
+			primaryKeyProperty: syncConfiguration.primaryKeyProperty,
 			schema: syncConfiguration.schema,
+			deleteUnreturnedPages: syncConfiguration.deleteUnreturnedPages,
 		},
-		async handler() {
-			const objects = await syncConfiguration.execute().catch((err) => {
-				throw new ExecutionError(err);
-			});
+		async handler(context?: Context) {
+			const executionResult = await syncConfiguration
+				.execute(context)
+				.catch((err) => {
+					throw new ExecutionError(err);
+				});
 
 			const result = {
-				schema: syncConfiguration.schema,
-				primaryKeyProperty: syncConfiguration.primaryKeyProperty,
-				objects,
+				objects: executionResult.objects,
+				done: executionResult.done,
+				nextContext: executionResult.nextContext,
 			};
 
 			process.stdout.write(`\n<output>${JSON.stringify(result)}</output>\n`);

package/src/cli/io.ts

@@ -1,4 +1,6 @@
+// biome-ignore lint/style/noRestrictedImports: This file contains safe wrappers for prompts.
 import * as prompts from "@inquirer/prompts";
+// biome-ignore lint/style/noRestrictedImports: This is the one allowed location for this import.
 import { createTable, type TableCell, type TableItem } from "@visulima/tabular";
 
 export interface WriterOptions {
@@ -80,21 +82,22 @@ export class IO {
 	}
 
 	confirm(config: WithSafety<Parameters<typeof prompts.confirm>[0]>) {
-		if (!process.stdin.isTTY) {
-			this.writeErr(config.noTTY);
-			process.exit(1);
-		}
-
+		this.#ensureTTY(config.noTTY);
 		return prompts.confirm(config).catch(this.#handlePromptExit.bind(this));
 	}
 
 	input(config: WithSafety<Parameters<typeof prompts.input>[0]>) {
+		this.#ensureTTY(config.noTTY);
+		return prompts.input(config).catch(this.#handlePromptExit.bind(this));
+	}
+
+	#ensureTTY(noTTY: string): true | never {
 		if (!process.stdin.isTTY) {
-			this.writeErr(config.noTTY);
+			this.writeErr(noTTY);
 			process.exit(1);
 		}
 
-		return prompts.input(config).catch(this.#handlePromptExit.bind(this));
+		return true;
 	}
 
 	#handlePromptExit(err: unknown) {

package/src/index.ts

@@ -1,5 +1,10 @@
 export { emojiIcon, notionIcon } from "./builder.js";
 export { slashCommand } from "./capabilities/slashCommand.js";
+export type {
+	SyncConfiguration,
+	SyncExecutionResult,
+	SyncedObject,
+} from "./capabilities/sync.js";
 export { sync } from "./capabilities/sync.js";
 export { tool } from "./capabilities/tool.js";
 export type { Icon, NoticonColor, NoticonName } from "./types.js";

package/src/schema.ts

@@ -21,7 +21,8 @@ export type PropertyType =
 	| "date"
 	| "select"
 	| "multi_select"
-	| "status";
+	| "status"
+	| "people";
 
 /**
  * Definition of a single property in a sync schema.
@@ -60,7 +61,8 @@ export type PropertyConfiguration =
 	| {
 			type: "status";
 			groups: StatusGroup[];
-	  };
+	  }
+	| { type: "people" };
 
 export type Schema<PK extends string> = {
 	dataSourceTitle: string;
@@ -167,3 +169,10 @@ export function status(config: {
 }): PropertyConfiguration {
 	return { type: "status", groups: config.groups };
 }
+
+/**
+ * Creates a people property definition.
+ */
+export function people(): PropertyConfiguration {
+	return { type: "people" };
+}

package/src/types.ts

@@ -160,4 +160,19 @@ export interface NoticonIcon {
  */
 export type Icon = EmojiIcon | NoticonIcon;
 
+/**
+ * Person reference - represents a user in a people property
+ */
+export interface PersonReference {
+	/**
+	 * The email address of the user
+	 */
+	email: string;
+}
+
+/**
+ * A PeopleValue is an array of person references
+ */
+export type PeopleValue = PersonReference[];
+
 export type { NoticonName } from "./icon-names.js";