@multisystemsuite/timezone-engine-calendar-sync 4.0.0 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +65 -1
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -1,7 +1,71 @@
1
1
  # @multisystemsuite/timezone-engine-calendar-sync
2
2
 
3
- Enterprise calendar synchronization.
3
+ **Enterprise calendar synchronization** — merge sources, detect conflicts, normalize events to UTC.
4
+
5
+ ## What it is used for
6
+
7
+ - Sync calendars from multiple systems (Google, Outlook, internal ERP)
8
+ - Detect overlapping events across regions
9
+ - Normalize external events to UTC for storage
10
+ - Global meeting and holiday calendar orchestration
11
+
12
+ ## Install
13
+
14
+ ```bash
15
+ npm install @multisystemsuite/timezone-engine-calendar-sync
16
+ ```
17
+
18
+ ## Usage
19
+
20
+ ```typescript
21
+ import {
22
+ mergeCalendarSources,
23
+ detectCalendarConflicts,
24
+ syncCalendarEvents,
25
+ } from "@multisystemsuite/timezone-engine-calendar-sync";
26
+
27
+ const google = [
28
+ {
29
+ id: "g1",
30
+ title: "Standup",
31
+ start: new Date("2026-05-27T09:00:00"),
32
+ end: new Date("2026-05-27T09:30:00"),
33
+ timezone: "America/New_York",
34
+ },
35
+ ];
36
+
37
+ const internal = [
38
+ {
39
+ id: "i1",
40
+ title: "Review",
41
+ start: new Date("2026-05-27T09:15:00"),
42
+ end: new Date("2026-05-27T10:00:00"),
43
+ timezone: "America/New_York",
44
+ },
45
+ ];
46
+
47
+ const merged = mergeCalendarSources([google, internal]);
48
+ const normalized = syncCalendarEvents(merged);
49
+ const conflicts = detectCalendarConflicts(normalized);
50
+ ```
51
+
52
+ ## Key exports
53
+
54
+ | Export | Purpose |
55
+ | --------------------------- | --------------------------------- |
56
+ | `mergeCalendarSources()` | Flatten and sort multiple sources |
57
+ | `syncCalendarEvents()` | Normalize timezones → UTC storage |
58
+ | `detectCalendarConflicts()` | Find overlapping event pairs |
59
+
60
+ ## Related packages
61
+
62
+ - `@multisystemsuite/timezone-engine-calendar` — month grid UI utilities
63
+ - `@multisystemsuite/timezone-engine-scheduler` — meeting slot finder
4
64
 
5
65
  ## Keywords
6
66
 
7
67
  `timezone`, `calendar`, `sync`, `conflicts`, `enterprise`, `scheduling`
68
+
69
+ ## License
70
+
71
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@multisystemsuite/timezone-engine-calendar-sync",
3
- "version": "4.0.0",
3
+ "version": "5.0.0",
4
4
  "description": "Enterprise calendar synchronization for @multisystemsuite/timezone-engine",
5
5
  "license": "MIT",
6
6
  "author": "MultiSystemSuite",
@@ -35,8 +35,8 @@
35
35
  ],
36
36
  "dependencies": {
37
37
  "date-fns": "^4.1.0",
38
- "@multisystemsuite/timezone-engine-shared-types": "4.0.0",
39
- "@multisystemsuite/timezone-engine-core": "4.0.0"
38
+ "@multisystemsuite/timezone-engine-core": "5.0.0",
39
+ "@multisystemsuite/timezone-engine-shared-types": "5.0.0"
40
40
  },
41
41
  "devDependencies": {
42
42
  "rimraf": "^6.0.1",