ICS change detection & reconciliation

What you configure

diffICalendar

Compare previous and current ICS content using the intended time zone.

reconcile

Supply base, local, and remote event collections with stable IDs.

conflict policy

Choose local, remote, or manual reconciliation behavior.

Integration code example

1. Retain the previous feed or common event snapshot instead of comparing unrelated data sets.
2. Inspect added, updated, deleted, and unchanged records.
3. Resolve manual conflicts before writing or adopting the proposed result.

Copy this TypeScript into your application, not the browser console. Replace YOUR_WTS_LICENSE_KEY with an entitlement issued for your deployment origin. A WTS license is not a Google, Microsoft or CalDAV credential. These examples are documentation only and never execute on this page.

npm install @wts-calendar/core

import { verifyCalendarLicense } from '@wts-calendar/core';
import { PremiumCalendarInteroperability } from '@wts-calendar/core/premium-interoperability';
import type { CalendarEventInput } from '@wts-calendar/core';
const license = await verifyCalendarLicense('YOUR_WTS_LICENSE_KEY');
const interoperability = new PremiumCalendarInteroperability({ license });

// File contents and event snapshots come from your application, not a WTS service.
export function compareFeeds(previousIcs: string, currentIcs: string) {
  return interoperability.diffICalendar(previousIcs, currentIcs, 'UTC');
}
export function reconcileEvents(
  base: CalendarEventInput[],
  local: CalendarEventInput[],
  remote: CalendarEventInput[],
) {
  const result = interoperability.reconcile(base, local, remote, 'manual');
  // Keep local state until your conflict UI resolves every unresolved conflict.
  return { proposedEvents: result.events, conflicts: result.conflicts };
}

Application responsibilities

Keep stable event IDs across snapshots. Detecting a deleted event does not authorize deleting it from another system; apply your own reconciliation policy.

Behavior and lifecycle

• Three-way conflicts retain the base, local, and remote values.
• Manual mode preserves the local copy in the proposal while reporting the unresolved conflict.