@project-ajax/sdk 0.0.33 → 0.0.34

package/dist/builder.d.ts

@@ -1,12 +1,75 @@
 import type { TextValue } from "./types.js";
+/**
+ * Creates a rich text value.
+ */
 export declare function richText(content: string): TextValue;
+/**
+ * Creates a URL value.
+ */
 export declare function url(url: string): TextValue;
+/**
+ * Creates a title value.
+ */
 export declare function title(content: string): TextValue;
+/**
+ * Creates a text value.
+ */
 export declare function text(content: string): TextValue;
 /**
- * Creates a link with custom display text
+ * Creates an email value.
+ */
+export declare function email(email: string): TextValue;
+/**
+ * Creates a phone number value.
+ */
+export declare function phoneNumber(phone: string): TextValue;
+/**
+ * Creates a checkbox value.
+ */
+export declare function checkbox(checked: boolean): TextValue;
+/**
+ * Creates a file URL value.
+ * @param fileUrl - The URL of the file
+ * @param fileName - Optional display name for the file (defaults to URL)
+ */
+export declare function file(fileUrl: string, fileName?: string): TextValue;
+/**
+ * Creates a number value.
+ */
+export declare function number(value: number): TextValue;
+/**
+ * Creates a date value from a date string (YYYY-MM-DD).
+ */
+export declare function date(dateString: string): TextValue;
+/**
+ * Creates a datetime value from a Date object.
+ */
+export declare function dateTime(date: Date, timeZone?: string): TextValue;
+/**
+ * Creates a date range value from date strings.
+ */
+export declare function dateRange(startDate: string, endDate: string): TextValue;
+/**
+ * Creates a datetime range value from Date objects.
+ */
+export declare function dateTimeRange(startDate: Date, endDate: Date, timeZone?: string): TextValue;
+/**
+ * Creates a link with custom display text.
  * @param displayText - The text to display
  * @param url - The URL to link to
  */
 export declare function link(displayText: string, url: string): TextValue;
+/**
+ * Creates a select value from a single option.
+ */
+export declare function select(value: string): TextValue;
+/**
+ * Creates a multi-select value from multiple options.
+ * @param values - Array of option names to select
+ */
+export declare function multiSelect(...values: string[]): TextValue;
+/**
+ * Creates a status value from a status option name.
+ */
+export declare function status(value: string): TextValue;
 //# sourceMappingURL=builder.d.ts.map

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,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE1C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAEhD;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAEhE"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD;;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"}

package/dist/builder.js

@@ -10,12 +10,121 @@ function title(content) {
 function text(content) {
   return [[content]];
 }
+function email(email2) {
+  return [[email2]];
+}
+function phoneNumber(phone) {
+  return [[phone]];
+}
+function checkbox(checked) {
+  return checked ? [["Yes"]] : [["No"]];
+}
+function file(fileUrl, fileName) {
+  return [[fileName ?? fileUrl, [["a", fileUrl]]]];
+}
+function number(value) {
+  if (Number.isNaN(value)) {
+    return [];
+  }
+  return [[value.toString()]];
+}
+function date(dateString) {
+  validateDateString(dateString);
+  const dateValue = {
+    type: "date",
+    start_date: dateString
+  };
+  return createDateToken(dateValue);
+}
+function dateTime(date2, timeZone) {
+  const dateValue = {
+    type: "datetime",
+    start_date: formatDate(date2),
+    start_time: formatTime(date2)
+  };
+  if (timeZone) {
+    dateValue.time_zone = timeZone;
+  }
+  return createDateToken(dateValue);
+}
+function dateRange(startDate, endDate) {
+  validateDateString(startDate);
+  validateDateString(endDate);
+  const dateValue = {
+    type: "daterange",
+    start_date: startDate,
+    end_date: endDate
+  };
+  return createDateToken(dateValue);
+}
+function dateTimeRange(startDate, endDate, timeZone) {
+  const dateValue = {
+    type: "datetimerange",
+    start_date: formatDate(startDate),
+    start_time: formatTime(startDate),
+    end_date: formatDate(endDate),
+    end_time: formatTime(endDate)
+  };
+  if (timeZone) {
+    dateValue.time_zone = timeZone;
+  }
+  return createDateToken(dateValue);
+}
 function link(displayText, url2) {
   return [[displayText, [["a", url2]]]];
 }
+function select(value) {
+  return [[value]];
+}
+function multiSelect(...values) {
+  if (values.length === 0) {
+    return [];
+  }
+  return [[values.join(",")]];
+}
+function status(value) {
+  return [[value]];
+}
+function validateDateString(dateString) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
+    throw new Error(
+      `Invalid date format: ${dateString}. Expected YYYY-MM-DD format.`
+    );
+  }
+  const date2 = new Date(dateString);
+  if (Number.isNaN(date2.getTime())) {
+    throw new Error(`Invalid date: ${dateString}`);
+  }
+}
+function createDateToken(dateValue) {
+  return [["\u2023", [["d", dateValue]]]];
+}
+function formatDate(date2) {
+  const year = date2.getFullYear();
+  const month = String(date2.getMonth() + 1).padStart(2, "0");
+  const day = String(date2.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function formatTime(date2) {
+  const hours = String(date2.getHours()).padStart(2, "0");
+  const minutes = String(date2.getMinutes()).padStart(2, "0");
+  return `${hours}:${minutes}`;
+}
 export {
+  checkbox,
+  date,
+  dateRange,
+  dateTime,
+  dateTimeRange,
+  email,
+  file,
   link,
+  multiSelect,
+  number,
+  phoneNumber,
   richText,
+  select,
+  status,
   text,
   title,
   url

package/dist/schema.d.ts

@@ -1,7 +1,8 @@
+import type { DateFormat, NumberFormat, SelectOption, StatusGroup } from "./types.js";
 /**
  * Supported property types for sync schemas.
  */
-export type PropertyType = "title" | "rich_text" | "url";
+export type PropertyType = "title" | "rich_text" | "url" | "email" | "phone_number" | "checkbox" | "file" | "number" | "date" | "select" | "multi_select" | "status";
 /**
  * Definition of a single property in a sync schema.
  */
@@ -17,6 +18,29 @@ export type PropertyConfiguration = {
     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[];
 };
 export type Schema<PK extends string> = {
     dataSourceTitle: string;
@@ -42,4 +66,42 @@ export declare function richText(): PropertyConfiguration;
  * Creates a URL property definition.
  */
 export declare function url(): PropertyConfiguration;
+/**
+ * Creates an email property definition.
+ */
+export declare function email(): PropertyConfiguration;
+/**
+ * Creates a phone number property definition.
+ */
+export declare function phoneNumber(): PropertyConfiguration;
+/**
+ * Creates a checkbox property definition.
+ */
+export declare function checkbox(): PropertyConfiguration;
+/**
+ * Creates a file property definition.
+ */
+export declare function file(): PropertyConfiguration;
+/**
+ * Creates a number property definition with optional formatting.
+ */
+export declare function number(format?: NumberFormat): PropertyConfiguration;
+/**
+ * Creates a date property definition with optional formatting.
+ */
+export declare function date(date_format?: DateFormat): PropertyConfiguration;
+/**
+ * Creates a select property definition with predefined options.
+ */
+export declare function select(options: SelectOption[]): PropertyConfiguration;
+/**
+ * Creates a multi-select property definition with predefined options.
+ */
+export declare function multiSelect(options: SelectOption[]): PropertyConfiguration;
+/**
+ * Creates a status property definition with groups.
+ */
+export declare function status(config: {
+    groups: StatusGroup[];
+}): 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;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,KAAK,CAAC;AAEzD;;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,CAAC;AAEnB,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,MAAM,IAAI;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,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,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"}

package/dist/schema.js

@@ -7,8 +7,44 @@ function richText() {
 function url() {
   return { type: "url" };
 }
+function email() {
+  return { type: "email" };
+}
+function phoneNumber() {
+  return { type: "phone_number" };
+}
+function checkbox() {
+  return { type: "checkbox" };
+}
+function file() {
+  return { type: "file" };
+}
+function number(format) {
+  return format ? { type: "number", format } : { type: "number" };
+}
+function date(date_format) {
+  return date_format ? { type: "date", date_format } : { type: "date" };
+}
+function select(options) {
+  return { type: "select", options };
+}
+function multiSelect(options) {
+  return { type: "multi_select", options };
+}
+function status(config) {
+  return { type: "status", groups: config.groups };
+}
 export {
+  checkbox,
+  date,
+  email,
+  file,
+  multiSelect,
+  number,
+  phoneNumber,
   richText,
+  select,
+  status,
   title,
   url
 };

package/dist/types.d.ts

@@ -7,5 +7,74 @@ type TextToken = [string, ...unknown[]];
  * A TextValue is an array of text tokens, representing rich text content.
  */
 export type TextValue = Array<TextToken>;
+/**
+ * Select option color types supported by Notion
+ */
+export type SelectColor = "default" | "gray" | "brown" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "red";
+/**
+ * A select option with an optional color
+ */
+export interface SelectOption {
+    name: string;
+    color?: SelectColor;
+}
+/**
+ * Status group types in Notion
+ */
+export type StatusGroupType = "To-do" | "In progress" | "Complete";
+/**
+ * Status group configuration
+ */
+export interface StatusGroup {
+    name: StatusGroupType;
+    options: SelectOption[];
+}
+/**
+ * Date object representing a single date without time
+ */
+export interface NotionDate {
+    type: "date";
+    start_date: string;
+}
+/**
+ * Date object representing a date with time
+ */
+export interface NotionDateTime {
+    type: "datetime";
+    start_date: string;
+    start_time: string;
+    time_zone?: string;
+}
+/**
+ * Date object representing a date range
+ */
+export interface DateRange {
+    type: "daterange";
+    start_date: string;
+    end_date: string;
+}
+/**
+ * Date object representing a date-time range
+ */
+export interface DateTimeRange {
+    type: "datetimerange";
+    start_date: string;
+    start_time: string;
+    end_date: string;
+    end_time: string;
+    time_zone?: string;
+}
+/**
+ * All possible date value types
+ */
+export type DateValue = NotionDate | NotionDateTime | DateRange | DateTimeRange;
+/**
+ * Number format types
+ */
+export type NumberFormat = "number" | "number_with_commas" | "percent" | "dollar" | "euro" | "pound" | "yen" | "rupee" | "won" | "yuan";
+/**
+ * Date format types
+ */
+export type DateFormat = "relative" | "MM/DD/YYYY" | "DD/MM/YYYY" | "YYYY/MM/DD" | "ll" | "MMM d";
 export {};
 //# 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"}
+{"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"}

package/package.json

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

package/src/builder.ts

@@ -1,26 +1,215 @@
-import type { TextValue } from "./types.js";
+import type { DateValue, TextValue } from "./types.js";
 
+/**
+ * Creates a rich text value.
+ */
 export function richText(content: string): TextValue {
 	return [[content]];
 }
 
+/**
+ * Creates a URL value.
+ */
 export function url(url: string): TextValue {
 	return [[url]];
 }
 
+/**
+ * Creates a title value.
+ */
 export function title(content: string): TextValue {
 	return [[content]];
 }
 
+/**
+ * Creates a text value.
+ */
 export function text(content: string): TextValue {
 	return [[content]];
 }
 
 /**
- * Creates a link with custom display text
+ * Creates an email value.
+ */
+export function email(email: string): TextValue {
+	return [[email]];
+}
+
+/**
+ * Creates a phone number value.
+ */
+export function phoneNumber(phone: string): TextValue {
+	return [[phone]];
+}
+
+/**
+ * Creates a checkbox value.
+ */
+export function checkbox(checked: boolean): TextValue {
+	return checked ? [["Yes"]] : [["No"]];
+}
+
+/**
+ * Creates a file URL value.
+ * @param fileUrl - The URL of the file
+ * @param fileName - Optional display name for the file (defaults to URL)
+ */
+export function file(fileUrl: string, fileName?: string): TextValue {
+	return [[fileName ?? fileUrl, [["a", fileUrl]]]];
+}
+
+/**
+ * Creates a number value.
+ */
+export function number(value: number): TextValue {
+	if (Number.isNaN(value)) {
+		return [];
+	}
+	return [[value.toString()]];
+}
+
+/**
+ * Creates a date value from a date string (YYYY-MM-DD).
+ */
+export function date(dateString: string): TextValue {
+	validateDateString(dateString);
+
+	const dateValue: DateValue = {
+		type: "date",
+		start_date: dateString,
+	};
+
+	return createDateToken(dateValue);
+}
+
+/**
+ * Creates a datetime value from a Date object.
+ */
+export function dateTime(date: Date, timeZone?: string): TextValue {
+	const dateValue: DateValue = {
+		type: "datetime",
+		start_date: formatDate(date),
+		start_time: formatTime(date),
+	};
+
+	if (timeZone) {
+		dateValue.time_zone = timeZone;
+	}
+
+	return createDateToken(dateValue);
+}
+
+/**
+ * Creates a date range value from date strings.
+ */
+export function dateRange(startDate: string, endDate: string): TextValue {
+	validateDateString(startDate);
+	validateDateString(endDate);
+
+	const dateValue: DateValue = {
+		type: "daterange",
+		start_date: startDate,
+		end_date: endDate,
+	};
+
+	return createDateToken(dateValue);
+}
+
+/**
+ * Creates a datetime range value from Date objects.
+ */
+export function dateTimeRange(
+	startDate: Date,
+	endDate: Date,
+	timeZone?: string,
+): TextValue {
+	const dateValue: DateValue = {
+		type: "datetimerange",
+		start_date: formatDate(startDate),
+		start_time: formatTime(startDate),
+		end_date: formatDate(endDate),
+		end_time: formatTime(endDate),
+	};
+
+	if (timeZone) {
+		dateValue.time_zone = timeZone;
+	}
+
+	return createDateToken(dateValue);
+}
+
+/**
+ * Creates a link with custom display text.
  * @param displayText - The text to display
  * @param url - The URL to link to
  */
 export function link(displayText: string, url: string): TextValue {
 	return [[displayText, [["a", url]]]];
 }
+
+/**
+ * Creates a select value from a single option.
+ */
+export function select(value: string): TextValue {
+	return [[value]];
+}
+
+/**
+ * Creates a multi-select value from multiple options.
+ * @param values - Array of option names to select
+ */
+export function multiSelect(...values: string[]): TextValue {
+	if (values.length === 0) {
+		return [];
+	}
+	return [[values.join(",")]];
+}
+
+/**
+ * Creates a status value from a status option name.
+ */
+export function status(value: string): TextValue {
+	return [[value]];
+}
+
+/**
+ * Validates a date string is in YYYY-MM-DD format and represents a valid date.
+ */
+function validateDateString(dateString: string): void {
+	if (!/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
+		throw new Error(
+			`Invalid date format: ${dateString}. Expected YYYY-MM-DD format.`,
+		);
+	}
+
+	const date = new Date(dateString);
+	if (Number.isNaN(date.getTime())) {
+		throw new Error(`Invalid date: ${dateString}`);
+	}
+}
+
+/**
+ * Internal helper to create a date mention token from a DateValue object.
+ */
+function createDateToken(dateValue: DateValue): TextValue {
+	return [["\u2023", [["d", dateValue]]]];
+}
+
+/**
+ * Formats a Date object to YYYY-MM-DD string.
+ */
+function formatDate(date: Date): string {
+	const year = date.getFullYear();
+	const month = String(date.getMonth() + 1).padStart(2, "0");
+	const day = String(date.getDate()).padStart(2, "0");
+	return `${year}-${month}-${day}`;
+}
+
+/**
+ * Formats a Date object to HH:mm string.
+ */
+function formatTime(date: Date): string {
+	const hours = String(date.getHours()).padStart(2, "0");
+	const minutes = String(date.getMinutes()).padStart(2, "0");
+	return `${hours}:${minutes}`;
+}

package/src/schema.ts

@@ -1,7 +1,26 @@
+import type {
+	DateFormat,
+	NumberFormat,
+	SelectOption,
+	StatusGroup,
+} from "./types.js";
+
 /**
  * Supported property types for sync schemas.
  */
-export type PropertyType = "title" | "rich_text" | "url";
+export type PropertyType =
+	| "title"
+	| "rich_text"
+	| "url"
+	| "email"
+	| "phone_number"
+	| "checkbox"
+	| "file"
+	| "number"
+	| "date"
+	| "select"
+	| "multi_select"
+	| "status";
 
 /**
  * Definition of a single property in a sync schema.
@@ -16,7 +35,31 @@ export type PropertyDefinition = {
 export type PropertyConfiguration =
 	| { type: "title" }
 	| { type: "text" }
-	| { type: "url" };
+	| { 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[];
+	  };
 
 export type Schema<PK extends string> = {
 	dataSourceTitle: string;
@@ -52,3 +95,68 @@ export function richText(): PropertyConfiguration {
 export function url(): PropertyConfiguration {
 	return { type: "url" };
 }
+
+/**
+ * Creates an email property definition.
+ */
+export function email(): PropertyConfiguration {
+	return { type: "email" };
+}
+
+/**
+ * Creates a phone number property definition.
+ */
+export function phoneNumber(): PropertyConfiguration {
+	return { type: "phone_number" };
+}
+
+/**
+ * Creates a checkbox property definition.
+ */
+export function checkbox(): PropertyConfiguration {
+	return { type: "checkbox" };
+}
+
+/**
+ * Creates a file property definition.
+ */
+export function file(): PropertyConfiguration {
+	return { type: "file" };
+}
+
+/**
+ * Creates a number property definition with optional formatting.
+ */
+export function number(format?: NumberFormat): PropertyConfiguration {
+	return format ? { type: "number", format } : { type: "number" };
+}
+
+/**
+ * Creates a date property definition with optional formatting.
+ */
+export function date(date_format?: DateFormat): PropertyConfiguration {
+	return date_format ? { type: "date", date_format } : { type: "date" };
+}
+
+/**
+ * Creates a select property definition with predefined options.
+ */
+export function select(options: SelectOption[]): PropertyConfiguration {
+	return { type: "select", options };
+}
+
+/**
+ * Creates a multi-select property definition with predefined options.
+ */
+export function multiSelect(options: SelectOption[]): PropertyConfiguration {
+	return { type: "multi_select", options };
+}
+
+/**
+ * Creates a status property definition with groups.
+ */
+export function status(config: {
+	groups: StatusGroup[];
+}): PropertyConfiguration {
+	return { type: "status", groups: config.groups };
+}

package/src/types.ts

@@ -8,3 +8,109 @@ type TextToken = [string, ...unknown[]];
  * A TextValue is an array of text tokens, representing rich text content.
  */
 export type TextValue = Array<TextToken>;
+
+/**
+ * Select option color types supported by Notion
+ */
+export type SelectColor =
+	| "default"
+	| "gray"
+	| "brown"
+	| "orange"
+	| "yellow"
+	| "green"
+	| "blue"
+	| "purple"
+	| "pink"
+	| "red";
+
+/**
+ * A select option with an optional color
+ */
+export interface SelectOption {
+	name: string;
+	color?: SelectColor;
+}
+
+/**
+ * Status group types in Notion
+ */
+export type StatusGroupType = "To-do" | "In progress" | "Complete";
+
+/**
+ * Status group configuration
+ */
+export interface StatusGroup {
+	name: StatusGroupType;
+	options: SelectOption[];
+}
+
+/**
+ * Date object representing a single date without time
+ */
+export interface NotionDate {
+	type: "date";
+	start_date: string; // Format: "YYYY-MM-DD"
+}
+
+/**
+ * Date object representing a date with time
+ */
+export interface NotionDateTime {
+	type: "datetime";
+	start_date: string; // Format: "YYYY-MM-DD"
+	start_time: string; // Format: "HH:mm"
+	time_zone?: string; // e.g., "America/Los_Angeles"
+}
+
+/**
+ * Date object representing a date range
+ */
+export interface DateRange {
+	type: "daterange";
+	start_date: string; // Format: "YYYY-MM-DD"
+	end_date: string; // Format: "YYYY-MM-DD"
+}
+
+/**
+ * Date object representing a date-time range
+ */
+export interface DateTimeRange {
+	type: "datetimerange";
+	start_date: string; // Format: "YYYY-MM-DD"
+	start_time: string; // Format: "HH:mm"
+	end_date: string; // Format: "YYYY-MM-DD"
+	end_time: string; // Format: "HH:mm"
+	time_zone?: string;
+}
+
+/**
+ * All possible date value types
+ */
+export type DateValue = NotionDate | NotionDateTime | DateRange | DateTimeRange;
+
+/**
+ * Number format types
+ */
+export type NumberFormat =
+	| "number"
+	| "number_with_commas"
+	| "percent"
+	| "dollar"
+	| "euro"
+	| "pound"
+	| "yen"
+	| "rupee"
+	| "won"
+	| "yuan";
+
+/**
+ * Date format types
+ */
+export type DateFormat =
+	| "relative"
+	| "MM/DD/YYYY"
+	| "DD/MM/YYYY"
+	| "YYYY/MM/DD"
+	| "ll"
+	| "MMM d";