@symbiote-native/calendar 0.1.0

package/src/legacy/types.ts

@@ -0,0 +1,183 @@
+import type { PermissionResponse } from 'expo-modules-core';
+import type {
+  AlarmMethod,
+  AttendeeRole,
+  AttendeeStatus,
+  AttendeeType,
+  CalendarAccessLevel,
+  CalendarDialogResultActions,
+  CalendarType,
+  DayOfTheWeek,
+  EntityTypes,
+  EventAccessLevel,
+  EventStatus,
+  Frequency,
+  MonthOfTheYear,
+  SourceType,
+  Availability,
+} from './enums';
+
+export type { PermissionResponse };
+
+export type IRecurringEventOptions = {
+  futureEvents?: boolean;
+  instanceStartDate?: string | Date;
+};
+
+export type IOrganizer = {
+  isCurrentUser: boolean;
+  name?: string;
+  role: string;
+  status: string;
+  type: string;
+  url?: string;
+};
+
+export type ISource = {
+  id?: string;
+  type: string | SourceType;
+  name: string;
+  isLocalAccount?: boolean;
+};
+
+export type ICalendar = {
+  id: string;
+  title: string;
+  sourceId?: string;
+  source: ISource;
+  type?: CalendarType;
+  color: string;
+  entityType?: EntityTypes;
+  allowsModifications: boolean;
+  allowedAvailabilities: Availability[];
+  isPrimary?: boolean;
+  name?: string | null;
+  ownerAccount?: string;
+  timeZone?: string;
+  allowedReminders?: AlarmMethod[];
+  allowedAttendeeTypes?: AttendeeType[];
+  isVisible?: boolean;
+  isSynced?: boolean;
+  accessLevel?: CalendarAccessLevel;
+};
+
+export type IEvent = {
+  id: string;
+  calendarId: string;
+  title: string;
+  location: string | null;
+  creationDate?: string | Date;
+  lastModifiedDate?: string | Date;
+  timeZone: string;
+  endTimeZone?: string;
+  url?: string;
+  notes: string;
+  alarms: IAlarm[];
+  recurrenceRule: IRecurrenceRule | null;
+  startDate: string | Date;
+  endDate: string | Date;
+  originalStartDate?: string | Date;
+  isDetached?: boolean;
+  allDay: boolean;
+  availability: Availability;
+  status: EventStatus;
+  organizer?: IOrganizer;
+  organizerEmail?: string;
+  accessLevel?: EventAccessLevel;
+  guestsCanModify?: boolean;
+  guestsCanInviteOthers?: boolean;
+  guestsCanSeeGuests?: boolean;
+  originalId?: string;
+  instanceId?: string;
+};
+
+export type IReminder = {
+  id?: string;
+  calendarId?: string;
+  title?: string;
+  location?: string;
+  creationDate?: string | Date;
+  lastModifiedDate?: string | Date;
+  timeZone?: string;
+  url?: string;
+  notes?: string;
+  alarms?: IAlarm[];
+  recurrenceRule?: IRecurrenceRule | null;
+  startDate?: string | Date;
+  dueDate?: string | Date;
+  allDay?: boolean;
+  completed?: boolean;
+  completionDate?: string | Date;
+};
+
+export type IAttendee = {
+  id?: string;
+  isCurrentUser?: boolean;
+  name: string;
+  role: AttendeeRole;
+  status: AttendeeStatus;
+  type: AttendeeType;
+  url?: string;
+  email?: string;
+};
+
+export type IAlarmLocation = {
+  title?: string;
+  proximity?: string;
+  radius?: number;
+  coords?: { latitude?: number; longitude?: number };
+};
+
+export type IAlarm = {
+  absoluteDate?: string;
+  relativeOffset?: number;
+  structuredLocation?: IAlarmLocation;
+  method?: AlarmMethod;
+};
+
+export type IDaysOfTheWeek = {
+  dayOfTheWeek: DayOfTheWeek;
+  weekNumber?: number;
+};
+
+export type IRecurrenceRule = {
+  frequency: Frequency;
+  interval?: number;
+  endDate?: string | Date;
+  occurrence?: number;
+  daysOfTheWeek?: IDaysOfTheWeek[];
+  daysOfTheMonth?: number[];
+  monthsOfTheYear?: MonthOfTheYear[];
+  weeksOfTheYear?: number[];
+  daysOfTheYear?: number[];
+  setPositions?: number[];
+};
+
+export type IOpenEventDialogResult = {
+  action: Extract<
+    CalendarDialogResultActions,
+    'done' | 'canceled' | 'deleted' | 'responded'
+  >;
+};
+
+export type IDialogEventResult = {
+  action: Extract<
+    CalendarDialogResultActions,
+    'done' | 'saved' | 'canceled' | 'deleted'
+  >;
+  id: string | null;
+};
+
+export type IPresentationOptions = {
+  startNewActivityTask?: boolean;
+};
+
+export type IOpenEventPresentationOptions = IPresentationOptions & {
+  allowsEditing?: boolean;
+  allowsCalendarPreview?: boolean;
+};
+
+export type ICalendarDialogParams = {
+  id: string;
+  instanceStartDate?: string | Date;
+};

package/src/react/index.ts

@@ -0,0 +1,3 @@
+export * from '../core';
+export { useCalendarPermissions } from './use-calendar-permissions';
+export { useRemindersPermissions } from './use-reminders-permissions';

package/src/react/use-calendar-permissions.ts

@@ -0,0 +1,25 @@
+import { createPermissionHook } from '@symbiote-native/react';
+import {
+  calendarPermissionMethods,
+  splitCalendarPermissionOptions,
+  type ICalendarPermissionMethodOptions,
+} from '../core/calendar-permission-api';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IPermissionHookOptions } from '@symbiote-native/engine';
+
+export type IUseCalendarPermissionsOptions = ICalendarPermissionMethodOptions;
+
+export type IUseCalendarPermissionsResult = [
+  PermissionResponse | null,
+  () => Promise<PermissionResponse>,
+  () => Promise<PermissionResponse>,
+];
+
+const usePermission = createPermissionHook(calendarPermissionMethods);
+
+// React twin of `expo-calendar`'s `useCalendarPermissions`
+export function useCalendarPermissions(
+  options?: IPermissionHookOptions<IUseCalendarPermissionsOptions>,
+): IUseCalendarPermissionsResult {
+  return usePermission(...splitCalendarPermissionOptions(options));
+}

package/src/react/use-reminders-permissions.ts

@@ -0,0 +1,25 @@
+import { createPermissionHook } from '@symbiote-native/react';
+import {
+  getRemindersPermissions,
+  requestRemindersPermissions,
+} from '../core/calendar';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IPermissionHookBehavior } from '@symbiote-native/engine';
+
+export type IUseRemindersPermissionsResult = [
+  PermissionResponse | null,
+  () => Promise<PermissionResponse>,
+  () => Promise<PermissionResponse>,
+];
+
+const usePermission = createPermissionHook({
+  getMethod: getRemindersPermissions,
+  requestMethod: requestRemindersPermissions,
+});
+
+// React twin of `expo-calendar`'s `useRemindersPermissions`
+export function useRemindersPermissions(
+  options?: IPermissionHookBehavior,
+): IUseRemindersPermissionsResult {
+  return usePermission(options);
+}

package/src/solid/index.ts

@@ -0,0 +1,3 @@
+export * from '../core';
+export { useCalendarPermissions } from './use-calendar-permissions';
+export { useRemindersPermissions } from './use-reminders-permissions';

package/src/solid/use-calendar-permissions.ts

@@ -0,0 +1,26 @@
+import { createPermissionHook } from '@symbiote-native/solid';
+import {
+  calendarPermissionMethods,
+  splitCalendarPermissionOptions,
+  type ICalendarPermissionMethodOptions,
+} from '../core/calendar-permission-api';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IPermissionHookOptions } from '@symbiote-native/engine';
+import type { Accessor } from 'solid-js';
+
+export type IUseCalendarPermissionsOptions = ICalendarPermissionMethodOptions;
+
+export type IUseCalendarPermissionsResult = [
+  Accessor<PermissionResponse | null>,
+  () => Promise<PermissionResponse>,
+  () => Promise<PermissionResponse>,
+];
+
+const usePermission = createPermissionHook(calendarPermissionMethods);
+
+// Solid twin of `../react`'s `useCalendarPermissions`
+export function useCalendarPermissions(
+  options?: IPermissionHookOptions<IUseCalendarPermissionsOptions>,
+): IUseCalendarPermissionsResult {
+  return usePermission(...splitCalendarPermissionOptions(options));
+}

package/src/solid/use-reminders-permissions.ts

@@ -0,0 +1,26 @@
+import { createPermissionHook } from '@symbiote-native/solid';
+import {
+  getRemindersPermissions,
+  requestRemindersPermissions,
+} from '../core/calendar';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IPermissionHookBehavior } from '@symbiote-native/engine';
+import type { Accessor } from 'solid-js';
+
+export type IUseRemindersPermissionsResult = [
+  Accessor<PermissionResponse | null>,
+  () => Promise<PermissionResponse>,
+  () => Promise<PermissionResponse>,
+];
+
+const usePermission = createPermissionHook({
+  getMethod: getRemindersPermissions,
+  requestMethod: requestRemindersPermissions,
+});
+
+// Solid twin of `../react`'s `useRemindersPermissions`
+export function useRemindersPermissions(
+  options?: IPermissionHookBehavior,
+): IUseRemindersPermissionsResult {
+  return usePermission(options);
+}

package/src/svelte/index.ts

@@ -0,0 +1,3 @@
+export * from '../core';
+export { useCalendarPermissions } from './use-calendar-permissions.svelte';
+export { useRemindersPermissions } from './use-reminders-permissions.svelte';

package/src/svelte/svelte-ambient.d.ts

@@ -0,0 +1,3 @@
+// Pulls svelte's ambient globals ($state/$effect/...) into this package's tsc program,
+// same fix as `packages/navigation/src/svelte/svelte-ambient.d.ts`
+/// <reference types="svelte" />

package/src/svelte/svelte-compile.test-helper.ts

@@ -0,0 +1,7 @@
+// Re-exports the existing harness instead of a third copy (packages/sqlite and
+// packages/navigation already carry one, not part of either package's public exports)
+export {
+  createSvelteHarness,
+  loadComponent,
+  type ISvelteHarness,
+} from '../../../sqlite/src/svelte/svelte-compile.test-helper';

package/src/svelte/use-calendar-permissions.svelte.ts

@@ -0,0 +1,25 @@
+import { createPermissionHook } from '@symbiote-native/svelte/runes/create-permission-hook';
+import {
+  calendarPermissionMethods,
+  splitCalendarPermissionOptions,
+  type ICalendarPermissionMethodOptions,
+} from '../core/calendar-permission-api';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IPermissionHookOptions } from '@symbiote-native/engine';
+
+export type IUseCalendarPermissionsOptions = ICalendarPermissionMethodOptions;
+
+export type IUseCalendarPermissionsResult = {
+  readonly status: PermissionResponse | null;
+  requestPermission: () => Promise<PermissionResponse>;
+  getPermission: () => Promise<PermissionResponse>;
+};
+
+const usePermission = createPermissionHook(calendarPermissionMethods);
+
+// Svelte twin of `../react`'s `useCalendarPermissions`
+export function useCalendarPermissions(
+  options?: IPermissionHookOptions<IUseCalendarPermissionsOptions>,
+): IUseCalendarPermissionsResult {
+  return usePermission(...splitCalendarPermissionOptions(options));
+}

package/src/svelte/use-reminders-permissions.svelte.ts

@@ -0,0 +1,25 @@
+import { createPermissionHook } from '@symbiote-native/svelte/runes/create-permission-hook';
+import {
+  getRemindersPermissions,
+  requestRemindersPermissions,
+} from '../core/calendar';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IPermissionHookBehavior } from '@symbiote-native/engine';
+
+export type IUseRemindersPermissionsResult = {
+  readonly status: PermissionResponse | null;
+  requestPermission: () => Promise<PermissionResponse>;
+  getPermission: () => Promise<PermissionResponse>;
+};
+
+const usePermission = createPermissionHook({
+  getMethod: getRemindersPermissions,
+  requestMethod: requestRemindersPermissions,
+});
+
+// Svelte twin of `../react`'s `useRemindersPermissions`
+export function useRemindersPermissions(
+  behavior?: IPermissionHookBehavior,
+): IUseRemindersPermissionsResult {
+  return usePermission(behavior);
+}

package/src/vue/index.ts

@@ -0,0 +1,3 @@
+export * from '../core';
+export { useCalendarPermissions } from './use-calendar-permissions';
+export { useRemindersPermissions } from './use-reminders-permissions';

package/src/vue/use-calendar-permissions.ts

@@ -0,0 +1,26 @@
+import { createPermissionHook } from '@symbiote-native/vue';
+import {
+  calendarPermissionMethods,
+  splitCalendarPermissionOptions,
+  type ICalendarPermissionMethodOptions,
+} from '../core/calendar-permission-api';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IPermissionHookOptions } from '@symbiote-native/engine';
+import type { Ref } from '@vue/runtime-core';
+
+export type IUseCalendarPermissionsOptions = ICalendarPermissionMethodOptions;
+
+export type IUseCalendarPermissionsResult = [
+  Ref<PermissionResponse | null>,
+  () => Promise<PermissionResponse>,
+  () => Promise<PermissionResponse>,
+];
+
+const usePermission = createPermissionHook(calendarPermissionMethods);
+
+// Vue twin of `../react`'s `useCalendarPermissions`
+export function useCalendarPermissions(
+  options?: IPermissionHookOptions<IUseCalendarPermissionsOptions>,
+): IUseCalendarPermissionsResult {
+  return usePermission(...splitCalendarPermissionOptions(options));
+}

package/src/vue/use-reminders-permissions.ts

@@ -0,0 +1,26 @@
+import { createPermissionHook } from '@symbiote-native/vue';
+import {
+  getRemindersPermissions,
+  requestRemindersPermissions,
+} from '../core/calendar';
+import type { PermissionResponse } from 'expo-modules-core';
+import type { IPermissionHookBehavior } from '@symbiote-native/engine';
+import type { Ref } from '@vue/runtime-core';
+
+export type IUseRemindersPermissionsResult = [
+  Ref<PermissionResponse | null>,
+  () => Promise<PermissionResponse>,
+  () => Promise<PermissionResponse>,
+];
+
+const usePermission = createPermissionHook({
+  getMethod: getRemindersPermissions,
+  requestMethod: requestRemindersPermissions,
+});
+
+// Vue twin of `../react`'s `useRemindersPermissions`
+export function useRemindersPermissions(
+  options?: IPermissionHookBehavior,
+): IUseRemindersPermissionsResult {
+  return usePermission(options);
+}