@tuturuuu/utils 0.34.0 → 0.35.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.35.0](https://github.com/tutur3u/platform/compare/utils-v0.34.0...utils-v0.35.0) (2026-10-09)
+
+
+### Features
+
+* **docs:** expand platform guides and enforce app SEO and runtime pause ([e79cb7e](https://github.com/tutur3u/platform/commit/e79cb7e96c7db4d1baedb09b7420ca41b75e367f))
+* **docs:** expand platform guides, enforce SEO, and pause inactive runtimes ([#6085](https://github.com/tutur3u/platform/issues/6085)) ([df7a159](https://github.com/tutur3u/platform/commit/df7a159e9c657fee4f6e0b593c776d6887b2ae11))
+* **tutoring:** define teacher hours domain contract ([b6fa164](https://github.com/tutur3u/platform/commit/b6fa1647d0c6afd9788778de7648d34b037dde61)) ([#6001](https://github.com/tutur3u/platform/issues/6001)) ([c23e08a](https://github.com/tutur3u/platform/commit/c23e08a403fbf59b3b74cc1650f3abc1505ad1aa))
+
+
+### Bug Fixes
+
+* **calendar:** stabilize civil dates and today rendering ([c1abdf0](https://github.com/tutur3u/platform/commit/c1abdf0df75c0a02cc00c37b7a0a5e55c862bf89)) ([#5950](https://github.com/tutur3u/platform/issues/5950)) ([5a00326](https://github.com/tutur3u/platform/commit/5a00326171bec65ec7210de161dd5272bfda22b2))
+* **finance:** reconcile attendance summary with current main ([fb00e6e](https://github.com/tutur3u/platform/commit/fb00e6ef4373adc1b6b9107f9bba883c101c3438))
+* **utils:** keep teacher-hours tests within package boundary ([bf55e46](https://github.com/tutur3u/platform/commit/bf55e46d5a842d70ea87c03b9b0e40c65c14f60d)) ([#6006](https://github.com/tutur3u/platform/issues/6006)) ([1039959](https://github.com/tutur3u/platform/commit/1039959d7258ed9fc612c0871ae575a71f3e4fe8))
+
+
+### Performance Improvements
+
+* **calendar:** reject oversized recurrence scans before expansion ([ac3441b](https://github.com/tutur3u/platform/commit/ac3441b4881b9ef0f8f380fdcf22c46e8794e145)) ([#5908](https://github.com/tutur3u/platform/issues/5908)) ([f662fef](https://github.com/tutur3u/platform/commit/f662fef3995435caa84153b06e7bb8e4c74aaf45))
+
 ## [0.34.0](https://github.com/tutur3u/platform/compare/utils-v0.33.3...utils-v0.34.0) (2026-10-04)
 
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tuturuuu/utils",
   "license": "MIT",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/tutur3u/platform",
@@ -17,6 +17,7 @@
   },
   "dependencies": {
     "@dnd-kit/core": "^6.3.1",
+    "@js-temporal/polyfill": "^0.5.1",
     "@noble/ciphers": "^2.4.0",
     "@noble/hashes": "^2.4.0",
     "@tanstack/react-query": "^5.102.8",
@@ -24,7 +25,7 @@
     "@tiptap/react": "3.31.3",
     "@tuturuuu/google": "0.1.1",
     "@tuturuuu/icons": "0.1.1",
-    "@tuturuuu/internal-api": "0.49.0",
+    "@tuturuuu/internal-api": "0.50.0",
     "@tuturuuu/supabase": "0.5.2",
     "@tuturuuu/turnstile": "0.1.3",
     "@upstash/ratelimit": "^2.0.8",
@@ -35,7 +36,7 @@
     "diff": "^9.0.0",
     "effect": "^3.22.2",
     "moment": "^2.30.1",
-    "next": "^16.3.5",
+    "next": "^16.4.0",
     "prosemirror-model": "^1.25.11",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",

package/src/__tests__/calendar-provider-readonly.test.ts

@@ -0,0 +1,45 @@
+import { describe, expect, it } from 'vitest';
+import {
+  isProviderRecurrenceReadonly,
+  markProviderRecurrenceReadonly,
+  providerReadonlyProjection,
+} from '../calendar-provider-readonly';
+
+describe('readonly provider projection', () => {
+  it.each(['google', 'microsoft'] as const)(
+    'projects %s internal marker without leaking raw provider snapshot',
+    (provider) => {
+      const original = { id: 'instance', summary: 'Private title' };
+      const projected = providerReadonlyProjection(
+        markProviderRecurrenceReadonly(original, provider, 'master')
+      );
+      expect(projected).toEqual({
+        locked: true,
+        scheduling_metadata: {
+          provider_recurrence: {
+            state: 'unsupported',
+            provider,
+            master_id: 'master',
+          },
+        },
+      });
+      expect(isProviderRecurrenceReadonly(projected)).toBe(true);
+      expect(original).toEqual({ id: 'instance', summary: 'Private title' });
+    }
+  );
+  it.each([
+    null,
+    {},
+    {
+      __tuturuuuProviderReadonlyRecurrence: {
+        state: 'unsupported',
+        provider: 'foreign',
+        master_id: 'master',
+      },
+    },
+  ])('ignores malformed markers', (value) =>
+    expect(providerReadonlyProjection(value)).toEqual({})
+  );
+  it('does not classify an ordinary locked event as provider readonly', () =>
+    expect(isProviderRecurrenceReadonly({ locked: true })).toBe(false));
+});

package/src/__tests__/calendar-recurrence-edit.test.ts

@@ -0,0 +1,140 @@
+import type { CalendarRecurrenceRule } from '@tuturuuu/types/primitives/calendar-recurrence';
+import { describe, expect, it } from 'vitest';
+import {
+  calendarAnchorAtSlot,
+  calendarProviderDateTimeLocal,
+  calendarRecurrenceSlotBounds,
+  calendarRecurrenceSlotInstant,
+  inspectCalendarRecurrenceSlot,
+} from '../calendar-recurrence-edit';
+
+const anchor = {
+  startLocal: '2026-03-07T02:30:00',
+  endLocal: '2026-03-07T03:30:00',
+  allDay: false,
+};
+const rule: CalendarRecurrenceRule = {
+  version: 1,
+  frequency: 'daily',
+  interval: 1,
+  timeZone: 'America/New_York',
+  end: { type: 'count', count: 4 },
+};
+describe('recurrence edit identity and future split', () => {
+  it('does not consume nonexistent DST slots when splitting count', () => {
+    const result = inspectCalendarRecurrenceSlot({
+      rule,
+      anchor,
+      originalStartLocal: '2026-03-10T02:30:00',
+    });
+    expect(result.precedingCount).toBe(2);
+    expect(result.remainingRule.end).toEqual({ type: 'count', count: 2 });
+    expect(result.previousRule?.end).toEqual({
+      type: 'until',
+      date: '2026-03-09',
+    });
+  });
+  it.each([
+    '2026-03-08T02:30:00',
+    '2026-03-07T03:30:00',
+    '2026-03-06T02:30:00',
+    '2026-03-12T02:30:00',
+  ])('rejects nonexistent or exhausted slot %s', (originalStartLocal) => {
+    expect(() =>
+      inspectCalendarRecurrenceSlot({ rule, anchor, originalStartLocal })
+    ).toThrow('Not a series occurrence');
+  });
+  it('maps first-slot future edit to whole-series edit', () => {
+    expect(
+      inspectCalendarRecurrenceSlot({
+        rule,
+        anchor,
+        originalStartLocal: anchor.startLocal,
+      }).previousRule
+    ).toBeNull();
+  });
+  it('rejects calendar-day boundaries after inclusive until', () => {
+    expect(() =>
+      inspectCalendarRecurrenceSlot({
+        rule: { ...rule, end: { type: 'until', date: '2026-03-09' } },
+        anchor,
+        originalStartLocal: '2026-03-10T02:30:00',
+      })
+    ).toThrow();
+  });
+  it('preserves multi-day local duration at future boundary', () => {
+    expect(
+      calendarAnchorAtSlot(
+        { ...anchor, endLocal: '2026-03-09T03:30:00' },
+        '2026-03-15T02:30:00'
+      ).endLocal
+    ).toBe('2026-03-17T03:30:00');
+  });
+  it('does not admit intervening dates on weekly interval', () => {
+    expect(() =>
+      inspectCalendarRecurrenceSlot({
+        rule: { ...rule, frequency: 'weekly', interval: 2, weekdays: ['SA'] },
+        anchor,
+        originalStartLocal: '2026-03-14T02:30:00',
+      })
+    ).toThrow();
+  });
+});
+
+describe('provider occurrence timezone identity', () => {
+  it('keeps the immutable slot instant after daylight saving changes', () => {
+    expect(
+      calendarRecurrenceSlotInstant({
+        rule,
+        anchor,
+        originalStartLocal: '2026-03-09T02:30:00',
+      })
+    ).toBe('2026-03-09T06:30:00Z');
+  });
+  it('rejects a nonexistent original slot instead of shifting its identity', () => {
+    expect(() =>
+      calendarRecurrenceSlotInstant({
+        rule,
+        anchor,
+        originalStartLocal: '2026-03-08T02:30:00',
+      })
+    ).toThrow();
+  });
+  it.each([
+    { dateTime: '2026-03-09T06:30:00Z' },
+    { dateTime: '2026-03-09T02:30:00-04:00' },
+    { dateTime: '2026-03-09T06:30:00.0000000', timeZone: 'UTC' },
+  ])('normalizes provider time without machine timezone: %j', (input) => {
+    expect(calendarProviderDateTimeLocal(input, 'America/New_York')).toBe(
+      '2026-03-09T02:30:00'
+    );
+  });
+  it('rejects unsupported timezone names', () => {
+    expect(() =>
+      calendarProviderDateTimeLocal(
+        { dateTime: '2026-03-09T09:00:00', timeZone: 'not-a-zone' },
+        'UTC'
+      )
+    ).toThrow();
+  });
+});
+
+describe('provider original interval coverage', () => {
+  it('keeps wall-clock end boundaries across DST for multi-day slots', () => {
+    expect(
+      calendarRecurrenceSlotBounds({
+        rule,
+        anchor: { ...anchor, endLocal: '2026-03-09T03:30:00' },
+        originalStartLocal: '2026-03-07T02:30:00',
+      })
+    ).toEqual({ start: '2026-03-07T07:30:00Z', end: '2026-03-09T07:30:00Z' });
+  });
+  it('refuses to truncate nonzero provider fractional seconds into another immutable identity', () => {
+    expect(() =>
+      calendarProviderDateTimeLocal(
+        { dateTime: '2026-03-09T06:30:00.0000001Z' },
+        'America/New_York'
+      )
+    ).toThrow('fractional');
+  });
+});