@demind-inc/core 1.6.68 → 1.6.70

package/dist/constants.js

@@ -72,6 +72,7 @@ exports.ALL_TODO_INTEGRATIONS_TYPE = [
     "ticktick",
     "github",
     "notion",
+    "apple-reminders",
 ];
 exports.basicLifetimeOfferingId = "basic (lifetime)";
 exports.basicOfferingId = "basic (with free trial)";

package/dist/models/TodoIntegrations.d.ts

@@ -1,5 +1,5 @@
 import { DocumentReference } from "@google-cloud/firestore";
-export type TodoIntegrationType = "trello" | "todoist" | "ticktick" | "notion" | "github";
+export type TodoIntegrationType = "trello" | "todoist" | "ticktick" | "notion" | "github" | "apple-reminders";
 export interface TodoIntegration {
     todoIntegrationId: string;
     source: TodoIntegrationType;

package/dist/models/TodoTasks.d.ts

@@ -2,6 +2,7 @@ import { DocumentReference } from "@google-cloud/firestore";
 import { TodoIntegrationType } from "./TodoIntegrations";
 import { TaskLabel } from "./TaskLabels";
 import { CircadianPhase } from "../types";
+import { AppleRecurrenceRuleFrequency } from "./Calendar";
 export interface TodoTasksBoardAdditionalParamsGithub {
     projectId: string;
     owner: string;
@@ -126,3 +127,108 @@ export type SuggestedTaskItem = Pick<TaskItem, "taskId" | "name" | "duration" |
     suggestedEndTime: string;
     priority?: string;
 };
+export type NativeAppleRemindersSource = 'Local' | 'iCloud';
+export type NativeAppleRemindersList = {
+    id: string;
+    color: string;
+    title: string;
+    source: NativeAppleRemindersSource;
+    allowsModifications: boolean;
+    isDefault: boolean;
+};
+export type NativeAppleRemindersListArray = NativeAppleRemindersList[];
+/**
+ * Core reminder type definitions
+ * Covers non-recurring, recurring (daily, weekly, monthly, yearly), and note-style reminders.
+ */
+export type ISODateString = string;
+export type TimeZoneId = string;
+export type Weekday = "SU" | "MO" | "TU" | "WE" | "TH" | "FR" | "SA";
+export type Proximity = "enter" | "leave" | "none";
+export type Priority = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+/** Calendar container metadata for the reminder. */
+export interface ReminderCalendar {
+    title: string;
+    color?: string;
+    allowsModifications: boolean;
+    /** e.g., "Default" | "iCloud" | "Local" — leave as string to be future-proof */
+    source?: string;
+    id: string;
+}
+/** Geographic coordinates for location-based alarms. */
+export interface Coordinates {
+    latitude: number;
+    longitude: number;
+}
+/** Location details for geofenced alarms. */
+export interface StructuredLocation {
+    coords: Coordinates;
+    /** meters; optional because some providers omit it */
+    radius?: number;
+    title?: string;
+    proximity?: Proximity;
+}
+/** Alarm definition — can be time-based, location-based, or both. */
+export interface ReminderAlarm {
+    /** Fires at absolute timestamp (UTC ISO). */
+    date?: ISODateString;
+    /**
+     * Offset in seconds relative to dueDate (0 = at due time).
+     * May be negative/positive depending on provider.
+     */
+    relativeOffset?: number;
+    /** Location-triggered alarm. */
+    structuredLocation?: StructuredLocation;
+}
+/** Detailed date/time components (localized). */
+export interface DueDateComponents {
+    year?: number;
+    month?: number;
+    day?: number;
+    hour?: number;
+    minute?: number;
+    second?: number;
+    timeZone?: TimeZoneId;
+}
+/** Repetition rule for recurring reminders. */
+export interface RecurrenceRule {
+    frequency: AppleRecurrenceRuleFrequency;
+    interval?: number;
+    endDate?: ISODateString;
+    occurrenceCount?: number;
+    /** Used when frequency = "weekly" */
+    daysOfWeek?: Weekday[];
+}
+/** Core reminder fields shared by all reminders. */
+export interface BaseReminder {
+    id: string;
+    externalIdentifier?: string;
+    title: string;
+    notes?: string;
+    priority?: Priority;
+    creationDate: ISODateString;
+    lastModifiedDate?: ISODateString;
+    calendar: ReminderCalendar;
+    hasAlarms: boolean;
+    /** Always an array; use [] when none to avoid null checks. */
+    alarms: ReminderAlarm[];
+    completed: boolean;
+    completionDate?: ISODateString;
+    /** Optional due fields (note-style reminders may omit these). */
+    dueDateComponents?: DueDateComponents;
+    dueDate?: ISODateString;
+}
+/** Non-recurring reminders. */
+export interface NonRecurringReminder extends BaseReminder {
+    hasRecurrenceRules: false;
+    recurrenceRule?: undefined;
+    recurrence?: undefined;
+}
+/** Recurring reminders (daily, weekly, etc.). */
+export interface RecurringReminder extends BaseReminder {
+    hasRecurrenceRules: true;
+    recurrenceRule: RecurrenceRule;
+    recurrence?: AppleRecurrenceRuleFrequency;
+}
+/** Union type covering all reminders. */
+export type NativeAppleReminder = NonRecurringReminder | RecurringReminder;

package/lib/constants.ts

@@ -80,6 +80,7 @@ export const ALL_TODO_INTEGRATIONS_TYPE: TodoIntegrationType[] = [
   "ticktick",
   "github",
   "notion",
+  "apple-reminders",
 ];
 
 export const basicLifetimeOfferingId = "basic (lifetime)";

package/lib/models/TodoIntegrations.ts

@@ -5,7 +5,8 @@ export type TodoIntegrationType =
   | "todoist"
   | "ticktick"
   | "notion"
-  | "github";
+  | "github"
+  | "apple-reminders";
 
 export interface TodoIntegration {
   todoIntegrationId: string;

package/lib/models/TodoTasks.ts

@@ -2,6 +2,7 @@ import { DocumentReference } from "@google-cloud/firestore";
 import { TodoIntegrationType } from "./TodoIntegrations";
 import { TaskLabel } from "./TaskLabels";
 import { CircadianPhase } from "../types";
+import { AppleRecurrenceRuleFrequency } from "./Calendar";
 
 export interface TodoTasksBoardAdditionalParamsGithub {
   projectId: string;
@@ -142,3 +143,132 @@ export type SuggestedTaskItem = Pick<
   suggestedEndTime: string;
   priority?: string;
 };
+
+/////////////// Apple Reminders ///////////////
+
+export type NativeAppleRemindersSource = 'Local' | 'iCloud';
+
+export type NativeAppleRemindersList = {
+  id: string;
+  color: string;
+  title: string;
+  source: NativeAppleRemindersSource;
+  allowsModifications: boolean;
+  isDefault: boolean;
+};
+
+export type NativeAppleRemindersListArray = NativeAppleRemindersList[];
+
+
+
+/**
+ * Core reminder type definitions
+ * Covers non-recurring, recurring (daily, weekly, monthly, yearly), and note-style reminders.
+ */
+
+export type ISODateString = string;
+export type TimeZoneId = string;
+export type Weekday = "SU" | "MO" | "TU" | "WE" | "TH" | "FR" | "SA";
+export type Proximity = "enter" | "leave" | "none";
+export type Priority = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+
+/** Calendar container metadata for the reminder. */
+export interface ReminderCalendar {
+  title: string;
+  color?: string; // hex
+  allowsModifications: boolean;
+  /** e.g., "Default" | "iCloud" | "Local" — leave as string to be future-proof */
+  source?: string;
+  id: string;
+}
+
+/** Geographic coordinates for location-based alarms. */
+export interface Coordinates {
+  latitude: number;
+  longitude: number;
+}
+
+/** Location details for geofenced alarms. */
+export interface StructuredLocation {
+  coords: Coordinates;
+  /** meters; optional because some providers omit it */
+  radius?: number;
+  title?: string;
+  proximity?: Proximity;
+}
+
+/** Alarm definition — can be time-based, location-based, or both. */
+export interface ReminderAlarm {
+  /** Fires at absolute timestamp (UTC ISO). */
+  date?: ISODateString;
+  /**
+   * Offset in seconds relative to dueDate (0 = at due time).
+   * May be negative/positive depending on provider.
+   */
+  relativeOffset?: number;
+  /** Location-triggered alarm. */
+  structuredLocation?: StructuredLocation;
+}
+
+/** Detailed date/time components (localized). */
+export interface DueDateComponents {
+  year?: number;
+  month?: number;
+  day?: number;
+  hour?: number;
+  minute?: number;
+  second?: number;
+  timeZone?: TimeZoneId;
+}
+
+/** Repetition rule for recurring reminders. */
+export interface RecurrenceRule {
+  frequency: AppleRecurrenceRuleFrequency;
+  interval?: number;          // default 1
+  endDate?: ISODateString;    // mutually exclusive with occurrenceCount
+  occurrenceCount?: number;   // mutually exclusive with endDate
+  /** Used when frequency = "weekly" */
+  daysOfWeek?: Weekday[];
+}
+
+/** Core reminder fields shared by all reminders. */
+export interface BaseReminder {
+  id: string;
+  externalIdentifier?: string;
+  title: string;
+  notes?: string;
+  priority?: Priority;
+
+  creationDate: ISODateString;
+  lastModifiedDate?: ISODateString;
+
+  calendar: ReminderCalendar;
+
+  hasAlarms: boolean;
+  /** Always an array; use [] when none to avoid null checks. */
+  alarms: ReminderAlarm[];
+
+  completed: boolean;
+  completionDate?: ISODateString;
+
+  /** Optional due fields (note-style reminders may omit these). */
+  dueDateComponents?: DueDateComponents;
+  dueDate?: ISODateString;
+}
+
+/** Non-recurring reminders. */
+export interface NonRecurringReminder extends BaseReminder {
+  hasRecurrenceRules: false;
+  recurrenceRule?: undefined;
+  recurrence?: undefined;
+}
+
+/** Recurring reminders (daily, weekly, etc.). */
+export interface RecurringReminder extends BaseReminder {
+  hasRecurrenceRules: true;
+  recurrenceRule: RecurrenceRule;
+  recurrence?: AppleRecurrenceRuleFrequency;
+}
+
+/** Union type covering all reminders. */
+export type NativeAppleReminder = NonRecurringReminder | RecurringReminder;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@demind-inc/core",
-  "version": "1.6.68",
+  "version": "1.6.70",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {