@tuturuuu/utils 0.0.3 → 0.6.1

package/src/__tests__/app-url.test.ts

@@ -0,0 +1,270 @@
+import { describe, expect, it } from 'vitest';
+import { resolveAppUrl, resolveInternalAppUrl } from '../app-url';
+import {
+  getAppDomainByUrl,
+  getLocalInternalAppUrl,
+  getPortlessInternalAppUrl,
+} from '../internal-domains';
+import {
+  getTuturuuuPortlessAppOrigin,
+  TUTURUUU_PORTLESS_ALLOWED_DEV_ORIGINS,
+  TUTURUUU_PORTLESS_APP_ORIGINS,
+} from '../portless';
+
+describe('resolveAppUrl', () => {
+  it('uses the first valid configured URL', () => {
+    expect(
+      resolveAppUrl({
+        candidates: ['development', 'https://learn.tuturuuu.com/'],
+        fallback: 'http://localhost:7812',
+      })
+    ).toBe('https://learn.tuturuuu.com');
+  });
+
+  it('falls back when configured values are not absolute HTTP URLs', () => {
+    expect(
+      resolveAppUrl({
+        candidates: ['development', '', 'ftp://learn.tuturuuu.com'],
+        fallback: 'http://localhost:7812',
+      })
+    ).toBe('http://localhost:7812');
+  });
+
+  it('ignores wildcard listener URLs that are not browser destinations', () => {
+    expect(
+      resolveAppUrl({
+        candidates: ['http://0.0.0.0:7814', 'http://[::]:7814'],
+        fallback: 'https://hive.tuturuuu.com',
+      })
+    ).toBe('https://hive.tuturuuu.com');
+  });
+});
+
+describe('resolveInternalAppUrl', () => {
+  it('skips configured URLs that belong to another registered internal app', () => {
+    expect(
+      resolveInternalAppUrl({
+        appName: 'learn',
+        candidates: ['https://tuturuuu.com', 'https://learn.tuturuuu.com'],
+        fallback: 'http://localhost:7812',
+      })
+    ).toBe('https://learn.tuturuuu.com');
+  });
+
+  it('recognizes Portless local origins as registered internal app URLs', () => {
+    expect(
+      resolveInternalAppUrl({
+        appName: 'learn',
+        candidates: [
+          'https://tuturuuu.localhost',
+          'https://learn.tuturuuu.localhost',
+        ],
+        fallback: 'http://localhost:7812',
+      })
+    ).toBe('https://learn.tuturuuu.localhost');
+  });
+
+  it('recognizes worktree-prefixed Portless origins as registered app URLs', () => {
+    expect(
+      resolveInternalAppUrl({
+        appName: 'chat',
+        candidates: ['https://zalo-qr-chat-setup.chat.tuturuuu.localhost'],
+        fallback: 'http://localhost:7821',
+      })
+    ).toBe('https://zalo-qr-chat-setup.chat.tuturuuu.localhost');
+    expect(
+      resolveInternalAppUrl({
+        appName: 'platform',
+        candidates: [
+          'https://zalo-qr-chat-setup.chat.tuturuuu.localhost',
+          'https://zalo-qr-chat-setup.tuturuuu.localhost',
+        ],
+        fallback: 'http://localhost:7803',
+      })
+    ).toBe('https://zalo-qr-chat-setup.tuturuuu.localhost');
+    expect(
+      getAppDomainByUrl(
+        'https://zalo-qr-chat-setup.chat.tuturuuu.localhost/verify-token'
+      )?.name
+    ).toBe('chat');
+  });
+
+  it('recognizes local Portless proxy ports for registered app URLs', () => {
+    expect(
+      getAppDomainByUrl(
+        'https://tuturuuu.localhost:1355/verify-token?nextUrl=%2Fen%2Fpersonal%2Ftasks'
+      )
+    ).toMatchObject({
+      canonicalUrl:
+        'https://tuturuuu.localhost/verify-token?nextUrl=%2Fen%2Fpersonal%2Ftasks',
+      kind: 'internal',
+      name: 'platform',
+    });
+    expect(
+      getAppDomainByUrl(
+        'https://tasks.tuturuuu.localhost:1355/verify-token?nextUrl=%2Fpersonal'
+      )
+    ).toMatchObject({
+      canonicalUrl:
+        'https://tasks.tuturuuu.localhost/verify-token?nextUrl=%2Fpersonal',
+      kind: 'internal',
+      name: 'tasks',
+    });
+    expect(
+      getAppDomainByUrl(
+        'https://tuturuuu.localhost.evil.test:1355/verify-token?nextUrl=%2F'
+      )
+    ).toBeNull();
+  });
+
+  it('canonicalizes production internal app URLs to their registered HTTPS origins', () => {
+    expect(
+      resolveInternalAppUrl({
+        appName: 'platform',
+        candidates: ['http://tuturuuu.com/'],
+        fallback: 'http://localhost:7803',
+      })
+    ).toBe('https://tuturuuu.com');
+    expect(
+      resolveInternalAppUrl({
+        appName: 'meet',
+        candidates: ['http://meet.tuturuuu.com/'],
+        fallback: 'http://localhost:7807',
+      })
+    ).toBe('https://meet.tuturuuu.com');
+  });
+
+  it('falls back when every configured URL points at another internal app', () => {
+    expect(
+      resolveInternalAppUrl({
+        appName: 'nova',
+        candidates: ['https://tuturuuu.com', 'https://learn.tuturuuu.com'],
+        fallback: 'https://nova.ai.vn',
+      })
+    ).toBe('https://nova.ai.vn');
+  });
+
+  it('keeps custom app origins that are not registered to another app', () => {
+    expect(
+      resolveInternalAppUrl({
+        appName: 'cms',
+        candidates: ['https://cms-preview.example.com/'],
+        fallback: 'https://cms.tuturuuu.com',
+      })
+    ).toBe('https://cms-preview.example.com');
+  });
+
+  it('skips wildcard listener origins before resolving an internal app URL', () => {
+    expect(
+      resolveInternalAppUrl({
+        appName: 'hive',
+        candidates: ['http://0.0.0.0:7814', 'https://hive.tuturuuu.com'],
+        fallback: 'http://localhost:7814',
+      })
+    ).toBe('https://hive.tuturuuu.com');
+  });
+});
+
+describe('getLocalInternalAppUrl', () => {
+  it('prefers the Portless Tuturuuu domain for local internal app defaults', () => {
+    expect(getLocalInternalAppUrl('platform', 'http://localhost:7803')).toBe(
+      'https://tuturuuu.localhost'
+    );
+    expect(getLocalInternalAppUrl('tasks', 'http://localhost:7809')).toBe(
+      'https://tasks.tuturuuu.localhost'
+    );
+  });
+
+  it.each([
+    ['apps', 'https://apps.tuturuuu.localhost'],
+    ['platform', 'https://tuturuuu.localhost'],
+    ['cms', 'https://cms.tuturuuu.localhost'],
+    ['calendar', 'https://calendar.tuturuuu.localhost'],
+    ['chat', 'https://chat.tuturuuu.localhost'],
+    ['drive', 'https://drive.tuturuuu.localhost'],
+    ['qr', 'https://qr.tuturuuu.localhost'],
+    ['nova', 'https://nova.tuturuuu.localhost'],
+    ['rewise', 'https://rewise.tuturuuu.localhost'],
+    ['tasks', 'https://tasks.tuturuuu.localhost'],
+    ['finance', 'https://finance.tuturuuu.localhost'],
+    ['inventory', 'https://inventory.tuturuuu.localhost'],
+    ['track', 'https://track.tuturuuu.localhost'],
+    ['learn', 'https://learn.tuturuuu.localhost'],
+    ['mail', 'https://mail.tuturuuu.localhost'],
+    ['meet', 'https://meet.tuturuuu.localhost'],
+    ['teach', 'https://teach.tuturuuu.localhost'],
+    ['hive', 'https://hive.tuturuuu.localhost'],
+    ['mind', 'https://mind.tuturuuu.localhost'],
+  ] as const)('returns the %s Portless URL', (appName, expectedUrl) => {
+    expect(getPortlessInternalAppUrl(appName)).toBe(expectedUrl);
+    expect(getLocalInternalAppUrl(appName, 'http://localhost:9999')).toBe(
+      expectedUrl
+    );
+  });
+
+  it('uses the current Portless worktree prefix for local peer app defaults', () => {
+    const originalPortlessUrl = process.env.PORTLESS_URL;
+
+    try {
+      process.env.PORTLESS_URL =
+        'https://zalo-qr-chat-setup.chat.tuturuuu.localhost';
+
+      expect(getTuturuuuPortlessAppOrigin('platform')).toBe(
+        'https://zalo-qr-chat-setup.tuturuuu.localhost'
+      );
+      expect(getPortlessInternalAppUrl('chat')).toBe(
+        'https://zalo-qr-chat-setup.chat.tuturuuu.localhost'
+      );
+      expect(getLocalInternalAppUrl('tasks', 'http://localhost:7809')).toBe(
+        'https://zalo-qr-chat-setup.tasks.tuturuuu.localhost'
+      );
+    } finally {
+      if (originalPortlessUrl === undefined) {
+        delete process.env.PORTLESS_URL;
+      } else {
+        process.env.PORTLESS_URL = originalPortlessUrl;
+      }
+    }
+  });
+});
+
+describe('Portless app origin registry', () => {
+  it('keeps all app origins under the Tuturuuu localhost namespace', () => {
+    expect(TUTURUUU_PORTLESS_ALLOWED_DEV_ORIGINS).toEqual([
+      'tuturuuu.localhost',
+      '*.tuturuuu.localhost',
+    ]);
+    expect(Object.values(TUTURUUU_PORTLESS_APP_ORIGINS)).toEqual([
+      'https://apps.tuturuuu.localhost',
+      'https://calendar.tuturuuu.localhost',
+      'https://chat.tuturuuu.localhost',
+      'https://cms.tuturuuu.localhost',
+      'https://drive.tuturuuu.localhost',
+      'https://external.tuturuuu.localhost',
+      'https://finance.tuturuuu.localhost',
+      'https://hive.tuturuuu.localhost',
+      'https://realtime.hive.tuturuuu.localhost',
+      'https://inventory.tuturuuu.localhost',
+      'https://learn.tuturuuu.localhost',
+      'https://mail.tuturuuu.localhost',
+      'https://meet.tuturuuu.localhost',
+      'https://mind.tuturuuu.localhost',
+      'https://nova.tuturuuu.localhost',
+      'https://tuturuuu.localhost',
+      'https://playground.tuturuuu.localhost',
+      'https://qr.tuturuuu.localhost',
+      'https://rewise.tuturuuu.localhost',
+      'https://shortener.tuturuuu.localhost',
+      'https://storefront.tuturuuu.localhost',
+      'https://tasks.tuturuuu.localhost',
+      'https://teach.tuturuuu.localhost',
+      'https://track.tuturuuu.localhost',
+    ]);
+  });
+
+  it('does not reuse the same Portless origin for multiple apps', () => {
+    const origins = Object.values(TUTURUUU_PORTLESS_APP_ORIGINS);
+
+    expect(new Set(origins).size).toBe(origins.length);
+  });
+});

package/src/__tests__/avatar-url.test.ts

@@ -0,0 +1,97 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { normalizeAvatarImageSrc } from '../avatar-url';
+
+const SUPABASE_PUBLIC_BARE_UUID_AVATAR_URL =
+  'https://yjbjpmwbfimjcdsjxfst.supabase.co/storage/v1/object/public/avatars/bbaf2747-4452-4b56-910d-0b313f49843e';
+const CURRENT_SUPABASE_URL = 'https://hvgmshmjolwfcbsxmyku.supabase.co';
+const ORIGINAL_SUPABASE_URL = process.env.NEXT_PUBLIC_SUPABASE_URL;
+
+beforeEach(() => {
+  delete process.env.NEXT_PUBLIC_SUPABASE_URL;
+});
+
+afterEach(() => {
+  if (ORIGINAL_SUPABASE_URL === undefined) {
+    delete process.env.NEXT_PUBLIC_SUPABASE_URL;
+  } else {
+    process.env.NEXT_PUBLIC_SUPABASE_URL = ORIGINAL_SUPABASE_URL;
+  }
+});
+
+describe('normalizeAvatarImageSrc', () => {
+  it('drops blank and unsafe avatar values', () => {
+    expect(normalizeAvatarImageSrc(undefined)).toBeUndefined();
+    expect(normalizeAvatarImageSrc(null)).toBeUndefined();
+    expect(normalizeAvatarImageSrc('')).toBeUndefined();
+    expect(normalizeAvatarImageSrc('   ')).toBeUndefined();
+    expect(normalizeAvatarImageSrc('//example.com/avatar.png')).toBeUndefined();
+  });
+
+  it('drops bare UUID avatar object identifiers', () => {
+    expect(
+      normalizeAvatarImageSrc('bbaf2747-4452-4b56-910d-0b313f49843e')
+    ).toBeUndefined();
+  });
+
+  it('keeps Supabase public avatar URLs even when the object key is a UUID', () => {
+    expect(normalizeAvatarImageSrc(SUPABASE_PUBLIC_BARE_UUID_AVATAR_URL)).toBe(
+      SUPABASE_PUBLIC_BARE_UUID_AVATAR_URL
+    );
+  });
+
+  it('keeps Supabase public avatar URLs on their original project', () => {
+    process.env.NEXT_PUBLIC_SUPABASE_URL = CURRENT_SUPABASE_URL;
+
+    expect(normalizeAvatarImageSrc(SUPABASE_PUBLIC_BARE_UUID_AVATAR_URL)).toBe(
+      SUPABASE_PUBLIC_BARE_UUID_AVATAR_URL
+    );
+  });
+
+  it('repairs malformed Supabase public avatar object URLs', () => {
+    process.env.NEXT_PUBLIC_SUPABASE_URL = CURRENT_SUPABASE_URL;
+
+    expect(
+      normalizeAvatarImageSrc(
+        'https://fnzamlzqfdwaaxdefwraj.supabase.co/storage/v1/object/v1/public/avatars/bbaf2747-4452-4b56-910d-0b313f49843e'
+      )
+    ).toBe(
+      'https://fnzamlzqfdwaaxdefwraj.supabase.co/storage/v1/object/public/avatars/bbaf2747-4452-4b56-910d-0b313f49843e'
+    );
+  });
+
+  it('repairs malformed Supabase avatar paths without project env config', () => {
+    expect(
+      normalizeAvatarImageSrc(
+        'https://fnzamlzqfdwaaxdefwraj.supabase.co/storage/v1/object/v1/public/avatars/bbaf2747-4452-4b56-910d-0b313f49843e'
+      )
+    ).toBe(
+      'https://fnzamlzqfdwaaxdefwraj.supabase.co/storage/v1/object/public/avatars/bbaf2747-4452-4b56-910d-0b313f49843e'
+    );
+  });
+
+  it('keeps supported image source schemes and paths', () => {
+    expect(normalizeAvatarImageSrc('https://example.com/avatar.png')).toBe(
+      'https://example.com/avatar.png'
+    );
+    expect(normalizeAvatarImageSrc('/avatars/local.png')).toBe(
+      '/avatars/local.png'
+    );
+    expect(normalizeAvatarImageSrc('blob:avatar.png')).toBe('blob:avatar.png');
+    expect(normalizeAvatarImageSrc('data:image/png;base64,abc')).toBe(
+      'data:image/png;base64,abc'
+    );
+  });
+
+  it('keeps real Supabase avatar object paths', () => {
+    expect(
+      normalizeAvatarImageSrc('avatars/user-1/avatar-1700000000000.png')
+    ).toBe('avatars/user-1/avatar-1700000000000.png');
+    expect(
+      normalizeAvatarImageSrc(
+        'https://hvgmshmjolwfcbsxmyku.supabase.co/storage/v1/object/public/avatars/00000000-0000-4000-8000-000000000001/1770694181366.jpg'
+      )
+    ).toBe(
+      'https://hvgmshmjolwfcbsxmyku.supabase.co/storage/v1/object/public/avatars/00000000-0000-4000-8000-000000000001/1770694181366.jpg'
+    );
+  });
+});

package/src/__tests__/color-helper.test.ts

@@ -0,0 +1,179 @@
+/**
+ * Tests for Color Helper Utilities
+ *
+ * Tests the getEventStyles function which returns Tailwind CSS classes
+ * for calendar event styling based on color input.
+ */
+
+import { describe, expect, it } from 'vitest';
+import { getEventStyles } from '../color-helper';
+
+describe('getEventStyles', () => {
+  describe('Known colors', () => {
+    it('should return correct styles for BLUE', () => {
+      const styles = getEventStyles('BLUE');
+      expect(styles.bg).toContain('bg-calendar-bg-blue');
+      expect(styles.border).toContain('border-dynamic-light-blue');
+      expect(styles.text).toContain('text-dynamic-light-blue');
+      expect(styles.dragBg).toBe('bg-calendar-bg-blue');
+      expect(styles.syncingBg).toBe('bg-calendar-bg-blue');
+      expect(styles.successBg).toBe('bg-calendar-bg-blue');
+      expect(styles.errorBg).toBe('bg-calendar-bg-red');
+    });
+
+    it('should return correct styles for RED', () => {
+      const styles = getEventStyles('RED');
+      expect(styles.bg).toContain('bg-calendar-bg-red');
+      expect(styles.border).toContain('border-dynamic-light-red');
+      expect(styles.text).toContain('text-dynamic-light-red');
+    });
+
+    it('should return correct styles for GREEN', () => {
+      const styles = getEventStyles('GREEN');
+      expect(styles.bg).toContain('bg-calendar-bg-green');
+      expect(styles.border).toContain('border-dynamic-light-green');
+      expect(styles.text).toContain('text-dynamic-light-green');
+    });
+
+    it('should return correct styles for YELLOW', () => {
+      const styles = getEventStyles('YELLOW');
+      expect(styles.bg).toContain('bg-calendar-bg-yellow');
+      expect(styles.border).toContain('border-dynamic-light-yellow');
+      expect(styles.text).toContain('text-dynamic-light-yellow');
+    });
+
+    it('should return correct styles for PURPLE', () => {
+      const styles = getEventStyles('PURPLE');
+      expect(styles.bg).toContain('bg-calendar-bg-purple');
+      expect(styles.border).toContain('border-dynamic-light-purple');
+      expect(styles.text).toContain('text-dynamic-light-purple');
+    });
+
+    it('should return correct styles for PINK', () => {
+      const styles = getEventStyles('PINK');
+      expect(styles.bg).toContain('bg-calendar-bg-pink');
+      expect(styles.border).toContain('border-dynamic-light-pink');
+      expect(styles.text).toContain('text-dynamic-light-pink');
+    });
+
+    it('should return correct styles for ORANGE', () => {
+      const styles = getEventStyles('ORANGE');
+      expect(styles.bg).toContain('bg-calendar-bg-orange');
+      expect(styles.border).toContain('border-dynamic-light-orange');
+      expect(styles.text).toContain('text-dynamic-light-orange');
+    });
+
+    it('should return correct styles for INDIGO', () => {
+      const styles = getEventStyles('INDIGO');
+      expect(styles.bg).toContain('bg-calendar-bg-indigo');
+      expect(styles.border).toContain('border-dynamic-light-indigo');
+      expect(styles.text).toContain('text-dynamic-light-indigo');
+    });
+
+    it('should return correct styles for CYAN', () => {
+      const styles = getEventStyles('CYAN');
+      expect(styles.bg).toContain('bg-calendar-bg-cyan');
+      expect(styles.border).toContain('border-dynamic-light-cyan');
+      expect(styles.text).toContain('text-dynamic-light-cyan');
+    });
+
+    it('should return correct styles for GRAY', () => {
+      const styles = getEventStyles('GRAY');
+      expect(styles.bg).toContain('bg-calendar-bg-gray');
+      expect(styles.border).toContain('border-dynamic-light-gray');
+      expect(styles.text).toContain('text-dynamic-light-gray');
+    });
+  });
+
+  describe('Case normalization', () => {
+    it('should handle lowercase color names', () => {
+      const styles = getEventStyles('blue');
+      expect(styles.bg).toContain('bg-calendar-bg-blue');
+    });
+
+    it('should handle mixed case color names', () => {
+      const styles = getEventStyles('Blue');
+      expect(styles.bg).toContain('bg-calendar-bg-blue');
+    });
+
+    it('should handle lowercase purple', () => {
+      const styles = getEventStyles('purple');
+      expect(styles.bg).toContain('bg-calendar-bg-purple');
+    });
+  });
+
+  describe('Invalid/unknown colors', () => {
+    it('should return BLUE styles for unknown color', () => {
+      const styles = getEventStyles('UNKNOWN');
+      expect(styles.bg).toContain('bg-calendar-bg-blue');
+      expect(styles.text).toContain('text-dynamic-light-blue');
+    });
+
+    it('should return BLUE styles for empty string', () => {
+      const styles = getEventStyles('');
+      expect(styles.bg).toContain('bg-calendar-bg-blue');
+    });
+
+    it('should return BLUE styles for null/undefined', () => {
+      const styles = getEventStyles(null as any);
+      expect(styles.bg).toContain('bg-calendar-bg-blue');
+
+      const styles2 = getEventStyles(undefined as any);
+      expect(styles2.bg).toContain('bg-calendar-bg-blue');
+    });
+  });
+
+  describe('Return structure', () => {
+    it('should return object with all required properties', () => {
+      const styles = getEventStyles('BLUE');
+      expect(styles).toHaveProperty('bg');
+      expect(styles).toHaveProperty('border');
+      expect(styles).toHaveProperty('text');
+      expect(styles).toHaveProperty('dragBg');
+      expect(styles).toHaveProperty('syncingBg');
+      expect(styles).toHaveProperty('successBg');
+      expect(styles).toHaveProperty('errorBg');
+    });
+
+    it('should return string values for all properties', () => {
+      const styles = getEventStyles('GREEN');
+      expect(typeof styles.bg).toBe('string');
+      expect(typeof styles.border).toBe('string');
+      expect(typeof styles.text).toBe('string');
+      expect(typeof styles.dragBg).toBe('string');
+      expect(typeof styles.syncingBg).toBe('string');
+      expect(typeof styles.successBg).toBe('string');
+      expect(typeof styles.errorBg).toBe('string');
+    });
+
+    it('should always have errorBg as red', () => {
+      const colors = [
+        'BLUE',
+        'GREEN',
+        'YELLOW',
+        'PURPLE',
+        'PINK',
+        'ORANGE',
+        'INDIGO',
+        'CYAN',
+        'GRAY',
+      ];
+      for (const color of colors) {
+        const styles = getEventStyles(color);
+        expect(styles.errorBg).toBe('bg-calendar-bg-red');
+      }
+    });
+  });
+
+  describe('Hover styles', () => {
+    it('should include hover ring styles in bg property', () => {
+      const styles = getEventStyles('BLUE');
+      expect(styles.bg).toContain('hover:ring-dynamic-light-blue');
+    });
+
+    it('should have opacity modifier in border', () => {
+      const styles = getEventStyles('RED');
+      expect(styles.border).toContain('/80');
+    });
+  });
+});