@tuturuuu/utils 0.12.1 → 0.15.0

package/src/calendar-settings-resolver.ts

@@ -0,0 +1,200 @@
+/**
+ * Calendar Settings Resolver
+ *
+ * Implements priority system for calendar preferences:
+ * User settings > Workspace settings > Auto-detection
+ */
+
+type FirstDayOfWeek = 'auto' | 'sunday' | 'monday' | 'saturday';
+
+interface CalendarSettings {
+  timezone: string;
+  firstDayOfWeek: FirstDayOfWeek;
+  timeFormat: '12h' | '24h';
+}
+
+export interface CalendarUserSettings {
+  timezone?: string | null;
+  first_day_of_week?: string | null;
+  time_format?: string | null;
+}
+
+export interface CalendarWorkspaceSettings {
+  timezone?: string | null;
+  first_day_of_week?: string | null;
+}
+
+/**
+ * Detects the system timezone using Intl API
+ */
+export function detectSystemTimezone(): string {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+    // Fallback to UTC if detection fails
+    return 'UTC';
+  }
+}
+
+/**
+ * Detects the first day of week based on locale
+ * Vietnamese: Monday
+ * US/Canada: Sunday
+ * Middle East: Saturday
+ */
+export function detectLocaleFirstDay(locale?: string): FirstDayOfWeek {
+  const userLocale =
+    locale || (typeof navigator !== 'undefined' ? navigator.language : 'en-US');
+
+  // Vietnamese locale uses Monday as first day
+  if (userLocale.startsWith('vi')) {
+    return 'monday';
+  }
+
+  // US, Canada, and some other countries use Sunday
+  if (userLocale.startsWith('en-US') || userLocale.startsWith('en-CA')) {
+    return 'sunday';
+  }
+
+  // Middle Eastern countries typically use Saturday
+  if (userLocale.startsWith('ar') || userLocale.startsWith('he')) {
+    return 'saturday';
+  }
+
+  // Most European and other countries use Monday
+  return 'monday';
+}
+
+/**
+ * Detects the preferred time format based on locale
+ * Uses Intl.DateTimeFormat to determine if the locale uses 12h or 24h format
+ */
+export function detectLocaleTimeFormat(locale?: string): '12h' | '24h' {
+  const userLocale =
+    locale || (typeof navigator !== 'undefined' ? navigator.language : 'en-US');
+
+  try {
+    // Use Intl.DateTimeFormat to detect the locale's preferred format
+    const formatter = new Intl.DateTimeFormat(userLocale, { hour: 'numeric' });
+    const parts = formatter.formatToParts(new Date(2000, 0, 1, 13, 0));
+    const hourPart = parts.find((p) => p.type === 'hour');
+
+    // If hour is "1" instead of "13", it's 12-hour format
+    return hourPart?.value === '1' ? '12h' : '24h';
+  } catch {
+    // Fallback to 12h for English locales, 24h for others
+    return userLocale.startsWith('en') ? '12h' : '24h';
+  }
+}
+
+/**
+ * Resolves the effective time format based on user setting
+ */
+export function resolveTimeFormat(
+  user?: Pick<CalendarUserSettings, 'time_format'> | null,
+  locale?: string
+): '12h' | '24h' {
+  // User setting takes priority
+  if (user?.time_format && user.time_format !== 'auto') {
+    return user.time_format as '12h' | '24h';
+  }
+
+  // Auto-detection based on locale
+  return detectLocaleTimeFormat(locale);
+}
+
+/**
+ * Resolves the effective timezone based on priority system
+ */
+export function resolveTimezone(
+  user?: Pick<CalendarUserSettings, 'timezone'> | null,
+  workspace?: Pick<CalendarWorkspaceSettings, 'timezone'> | null
+): string {
+  // Priority 1: User setting
+  if (user?.timezone && user.timezone !== 'auto') {
+    return user.timezone;
+  }
+
+  // Priority 2: Workspace setting
+  if (workspace?.timezone && workspace.timezone !== 'auto') {
+    return workspace.timezone;
+  }
+
+  // Priority 3: Auto-detection
+  return detectSystemTimezone();
+}
+
+/**
+ * Resolves the effective first day of week based on priority system
+ */
+export function resolveFirstDayOfWeek(
+  user?: Pick<CalendarUserSettings, 'first_day_of_week'> | null,
+  workspace?: Pick<CalendarWorkspaceSettings, 'first_day_of_week'> | null,
+  locale?: string
+): FirstDayOfWeek {
+  // Priority 1: User setting
+  if (user?.first_day_of_week && user.first_day_of_week !== 'auto') {
+    return user.first_day_of_week as FirstDayOfWeek;
+  }
+
+  // Priority 2: Workspace setting
+  if (workspace?.first_day_of_week && workspace.first_day_of_week !== 'auto') {
+    return workspace.first_day_of_week as FirstDayOfWeek;
+  }
+
+  // Priority 3: Auto-detection based on locale
+  return detectLocaleFirstDay(locale);
+}
+
+/**
+ * Resolves all calendar settings at once
+ */
+export function resolveCalendarSettings(
+  user?: CalendarUserSettings | null,
+  workspace?: CalendarWorkspaceSettings | null,
+  locale?: string
+): CalendarSettings {
+  return {
+    timezone: resolveTimezone(user, workspace),
+    firstDayOfWeek: resolveFirstDayOfWeek(user, workspace, locale),
+    timeFormat: resolveTimeFormat(user, locale),
+  };
+}
+
+/**
+ * Converts first day of week string to number (for Date compatibility)
+ * 0 = Sunday, 1 = Monday, 6 = Saturday
+ */
+export function firstDayToNumber(day: FirstDayOfWeek, locale?: string): number {
+  if (day === 'auto') {
+    day = detectLocaleFirstDay(locale);
+  }
+
+  switch (day) {
+    case 'sunday':
+      return 0;
+    case 'monday':
+      return 1;
+    case 'saturday':
+      return 6;
+    default:
+      return 1; // Default to Monday
+  }
+}
+
+/**
+ * Converts number to first day of week string
+ * 0 = Sunday, 1 = Monday, 6 = Saturday
+ */
+export function numberToFirstDay(num: number): FirstDayOfWeek {
+  switch (num) {
+    case 0:
+      return 'sunday';
+    case 1:
+      return 'monday';
+    case 6:
+      return 'saturday';
+    default:
+      return 'monday'; // Default to Monday
+  }
+}

package/src/internal-domains.ts

@@ -16,6 +16,10 @@ export const PRODUCTION_INTERNAL_APP_DOMAINS = [
     name: 'cms',
     url: 'https://cms.tuturuuu.com',
   },
+  {
+    name: 'docs',
+    url: 'https://docs.tuturuuu.com',
+  },
   {
     name: 'calendar',
     url: 'https://calendar.tuturuuu.com',
@@ -40,6 +44,10 @@ export const PRODUCTION_INTERNAL_APP_DOMAINS = [
     name: 'qr',
     url: 'https://qr.tuturuuu.com',
   },
+  {
+    name: 'tools',
+    url: 'https://tools.tuturuuu.com',
+  },
   {
     name: 'nova',
     url: 'https://nova.ai.vn',
@@ -92,6 +100,14 @@ export const PRODUCTION_INTERNAL_APP_DOMAINS = [
     name: 'teach',
     url: 'https://teach.tuturuuu.com',
   },
+  {
+    name: 'pay',
+    url: 'https://pay.tuturuuu.com',
+  },
+  {
+    name: 'contacts',
+    url: 'https://contacts.tuturuuu.com',
+  },
   {
     name: 'hive',
     url: 'https://hive.tuturuuu.com',
@@ -115,6 +131,10 @@ export const PORTLESS_INTERNAL_APP_DOMAINS = [
     name: 'cms',
     url: getTuturuuuPortlessAppOrigin('cms'),
   },
+  {
+    name: 'docs',
+    url: getTuturuuuPortlessAppOrigin('docs'),
+  },
   {
     name: 'calendar',
     url: getTuturuuuPortlessAppOrigin('calendar'),
@@ -139,6 +159,10 @@ export const PORTLESS_INTERNAL_APP_DOMAINS = [
     name: 'qr',
     url: getTuturuuuPortlessAppOrigin('qr'),
   },
+  {
+    name: 'tools',
+    url: getTuturuuuPortlessAppOrigin('tools'),
+  },
   {
     name: 'nova',
     url: getTuturuuuPortlessAppOrigin('nova'),
@@ -183,6 +207,14 @@ export const PORTLESS_INTERNAL_APP_DOMAINS = [
     name: 'teach',
     url: getTuturuuuPortlessAppOrigin('teach'),
   },
+  {
+    name: 'pay',
+    url: getTuturuuuPortlessAppOrigin('pay'),
+  },
+  {
+    name: 'contacts',
+    url: getTuturuuuPortlessAppOrigin('contacts'),
+  },
   {
     name: 'hive',
     url: getTuturuuuPortlessAppOrigin('hive'),
@@ -226,6 +258,10 @@ export const LOCALHOST_INTERNAL_APP_DOMAINS = [
     name: 'qr',
     url: 'http://localhost:7819',
   },
+  {
+    name: 'tools',
+    url: 'http://localhost:7825',
+  },
   {
     name: 'platform',
     url: 'http://localhost:7803',
@@ -274,6 +310,14 @@ export const LOCALHOST_INTERNAL_APP_DOMAINS = [
     name: 'teach',
     url: 'http://localhost:7813',
   },
+  {
+    name: 'pay',
+    url: 'http://localhost:7826',
+  },
+  {
+    name: 'contacts',
+    url: 'http://localhost:7827',
+  },
   {
     name: 'hive',
     url: 'http://localhost:7814',

package/src/launchable-apps.test.ts

@@ -3,6 +3,8 @@ import {
   getLaunchableApp,
   getLaunchableAppByTitle,
   getLaunchableAppOrigin,
+  LAUNCHABLE_APP_CATEGORIES,
+  LAUNCHABLE_APPS,
   type LaunchableWorkspace,
   resolveLaunchableAppPath,
   resolveLaunchableAppUrl,
@@ -27,6 +29,39 @@ describe('launchable apps', () => {
     expect(getLaunchableAppByTitle('apps gateway')?.slug).toBe('apps');
   });
 
+  it('keeps retired apps out of the catalog and pins category overrides', () => {
+    expect(LAUNCHABLE_APPS.map((app) => app.slug)).not.toContain('external');
+    expect(LAUNCHABLE_APPS.map((app) => app.slug)).not.toContain('playground');
+    expect(LAUNCHABLE_APP_CATEGORIES).not.toContain('core');
+    expect(LAUNCHABLE_APP_CATEGORIES).not.toContain('content');
+    expect(LAUNCHABLE_APP_CATEGORIES).not.toContain('developer');
+    expect(LAUNCHABLE_APP_CATEGORIES).toContain('miscellaneous');
+    expect(getLaunchableApp('external')).toBeNull();
+    expect(getLaunchableApp('playground')).toBeNull();
+    expect(getLaunchableApp('platform')?.category).toBe('productivity');
+    expect(getLaunchableApp('apps')?.category).toBe('miscellaneous');
+    expect(getLaunchableApp('cms')?.category).toBe('operations');
+    expect(getLaunchableApp('rewise')?.category).toBe('ai');
+    expect(getLaunchableApp('docs')?.category).toBe('miscellaneous');
+    expect(getLaunchableApp('tools')?.category).toBe('miscellaneous');
+    expect(getLaunchableApp('shortener')?.category).toBe('miscellaneous');
+    expect(
+      LAUNCHABLE_APPS.filter((app) => app.category === 'productivity').map(
+        (app) => app.slug
+      )[0]
+    ).toBe('platform');
+    expect(
+      LAUNCHABLE_APPS.filter((app) => app.category === 'operations').map(
+        (app) => app.slug
+      )
+    ).not.toContain('apps');
+    expect(
+      LAUNCHABLE_APPS.filter((app) => app.category === 'miscellaneous').map(
+        (app) => app.slug
+      )[0]
+    ).toBe('apps');
+  });
+
   it('resolves production, Portless, and local origins', () => {
     const app = getLaunchableApp('calendar');
 
@@ -46,6 +81,15 @@ describe('launchable apps', () => {
     expect(getLaunchableAppOrigin(meet!, { environment: 'production' })).toBe(
       'https://meet.tuturuuu.com'
     );
+
+    const docs = getLaunchableApp('docs');
+    expect(docs).not.toBeNull();
+    expect(getLaunchableAppOrigin(docs!, { environment: 'production' })).toBe(
+      'https://docs.tuturuuu.com'
+    );
+    expect(getLaunchableAppOrigin(docs!, { environment: 'portless' })).toBe(
+      'https://docs.tuturuuu.localhost'
+    );
   });
 
   it('detects Portless dev from the current origin', () => {

package/src/launchable-apps.ts

@@ -2,13 +2,11 @@ import { toWorkspaceSlug } from './constants';
 import { getTuturuuuPortlessAppOrigin } from './portless';
 
 export const LAUNCHABLE_APP_CATEGORIES = [
-  'core',
   'productivity',
-  'content',
   'operations',
   'learning',
-  'developer',
   'ai',
+  'miscellaneous',
 ] as const;
 
 export type LaunchableAppCategory = (typeof LAUNCHABLE_APP_CATEGORIES)[number];
@@ -53,7 +51,7 @@ export const LAUNCHABLE_APPS = [
   {
     aliases: ['Tuturuuu', 'Dashboard', 'Workspace'],
     appRoot: 'apps/web',
-    category: 'core',
+    category: 'productivity',
     defaultPath: '/',
     localhostOrigin: 'http://localhost:7803',
     packageName: '@tuturuuu/web',
@@ -63,18 +61,6 @@ export const LAUNCHABLE_APPS = [
     title: 'Platform',
     workspacePathResolver: workspaceRootPath,
   },
-  {
-    aliases: ['App Launcher', 'Gateway', 'Apps Gateway'],
-    appRoot: 'apps/apps',
-    category: 'core',
-    defaultPath: '/',
-    localhostOrigin: 'http://localhost:7818',
-    packageName: '@tuturuuu/apps',
-    portlessApp: 'apps',
-    productionUrl: 'https://apps.tuturuuu.com',
-    slug: 'apps',
-    title: 'Apps',
-  },
   {
     aliases: ['Schedule', 'Events'],
     appRoot: 'apps/calendar',
@@ -104,7 +90,7 @@ export const LAUNCHABLE_APPS = [
   {
     aliases: ['Content', 'CMS'],
     appRoot: 'apps/cms',
-    category: 'content',
+    category: 'operations',
     defaultPath: '/personal',
     localhostOrigin: 'http://localhost:7811',
     packageName: '@tuturuuu/cms',
@@ -128,15 +114,27 @@ export const LAUNCHABLE_APPS = [
     workspacePathResolver: workspaceRootPath,
   },
   {
-    aliases: ['External Projects', 'WebGL'],
-    appRoot: 'apps/external',
-    category: 'developer',
+    aliases: ['App Launcher', 'Gateway', 'Apps Gateway'],
+    appRoot: 'apps/apps',
+    category: 'miscellaneous',
     defaultPath: '/',
-    packageName: '@tuturuuu/external',
-    portlessApp: 'external',
-    productionUrl: 'https://external.tuturuuu.com',
-    slug: 'external',
-    title: 'External',
+    localhostOrigin: 'http://localhost:7818',
+    packageName: '@tuturuuu/apps',
+    portlessApp: 'apps',
+    productionUrl: 'https://apps.tuturuuu.com',
+    slug: 'apps',
+    title: 'Apps',
+  },
+  {
+    aliases: ['Documentation', 'Guides', 'Reference'],
+    appRoot: 'apps/docs',
+    category: 'miscellaneous',
+    defaultPath: '/',
+    packageName: 'apps/docs',
+    portlessApp: 'docs',
+    productionUrl: 'https://docs.tuturuuu.com',
+    slug: 'docs',
+    title: 'Docs',
   },
   {
     aliases: ['Money', 'Wallets', 'Invoices'],
@@ -252,32 +250,21 @@ export const LAUNCHABLE_APPS = [
     title: 'Nova',
   },
   {
-    aliases: ['Labs', 'Sandbox'],
-    appRoot: 'apps/playground',
-    category: 'developer',
-    defaultPath: '/',
-    packageName: '@tuturuuu/playground',
-    portlessApp: 'playground',
-    productionUrl: 'https://playground.tuturuuu.com',
-    slug: 'playground',
-    title: 'Playground',
-  },
-  {
-    aliases: ['QR Code', 'Generator'],
-    appRoot: 'apps/qr',
-    category: 'developer',
+    aliases: ['QR Code', 'Generator', 'Password', 'Random', 'UUID', 'Token'],
+    appRoot: 'apps/tools',
+    category: 'miscellaneous',
     defaultPath: '/',
-    localhostOrigin: 'http://localhost:7819',
-    packageName: '@tuturuuu/qr',
-    portlessApp: 'qr',
-    productionUrl: 'https://qr.tuturuuu.com',
-    slug: 'qr',
-    title: 'QR',
+    localhostOrigin: 'http://localhost:7825',
+    packageName: '@tuturuuu/tools',
+    portlessApp: 'tools',
+    productionUrl: 'https://tools.tuturuuu.com',
+    slug: 'tools',
+    title: 'Tools',
   },
   {
     aliases: ['Review', 'Flashcards'],
     appRoot: 'apps/rewise',
-    category: 'learning',
+    category: 'ai',
     defaultPath: '/',
     localhostOrigin: 'http://localhost:7804',
     packageName: '@tuturuuu/rewise',
@@ -289,7 +276,7 @@ export const LAUNCHABLE_APPS = [
   {
     aliases: ['Links', 'URL Shortener'],
     appRoot: 'apps/shortener',
-    category: 'developer',
+    category: 'miscellaneous',
     defaultPath: '/',
     packageName: '@tuturuuu/shortener',
     portlessApp: 'shortener',
@@ -323,6 +310,32 @@ export const LAUNCHABLE_APPS = [
     title: 'Teach',
     workspacePathResolver: workspaceRootPath,
   },
+  {
+    aliases: ['Billing', 'Subscriptions', 'Payments'],
+    appRoot: 'apps/pay',
+    category: 'operations',
+    defaultPath: '/personal',
+    localhostOrigin: 'http://localhost:7826',
+    packageName: '@tuturuuu/pay',
+    portlessApp: 'pay',
+    productionUrl: 'https://pay.tuturuuu.com',
+    slug: 'pay',
+    title: 'Pay',
+    workspacePathResolver: workspaceRootPath,
+  },
+  {
+    aliases: ['CRM', 'Users', 'Members', 'Customers', 'Leads'],
+    appRoot: 'apps/contacts',
+    category: 'operations',
+    defaultPath: '/personal',
+    localhostOrigin: 'http://localhost:7827',
+    packageName: '@tuturuuu/contacts',
+    portlessApp: 'contacts',
+    productionUrl: 'https://contacts.tuturuuu.com',
+    slug: 'contacts',
+    title: 'Contacts',
+    workspacePathResolver: workspaceRootPath,
+  },
   {
     aliases: ['Time Tracking', 'Timer'],
     appRoot: 'apps/track',

package/src/platform-release.test.ts

@@ -7,10 +7,10 @@ import {
 
 describe('platform release metadata', () => {
   it('uses the centralized shared browser app version', () => {
-    expect(TUTURUUU_PLATFORM_VERSION).toBe('0.17.0'); // x-release-please-version
+    expect(TUTURUUU_PLATFORM_VERSION).toBe('0.21.0'); // x-release-please-version
   });
 
-  it('normalizes generated metadata and derives a short hash', () => {
+  it('preserves the source timestamp in builtAt and derives a short hash', () => {
     expect(
       normalizePlatformBuildMetadata({
         builtAt: '2026-05-27T10:00:00.000Z',

package/src/platform-release.ts

@@ -1,8 +1,9 @@
 import { PLATFORM_BUILD_METADATA } from './generated/platform-build-metadata';
 
-export const TUTURUUU_PLATFORM_VERSION = '0.17.0'; // x-release-please-version
+export const TUTURUUU_PLATFORM_VERSION = '0.21.0'; // x-release-please-version
 
 export type PlatformBuildMetadataInput = {
+  /** ISO timestamp of the source commit used for the build, not deployment time. */
   builtAt?: string | null;
   commitHash?: string | null;
   commitMessage?: string | null;
@@ -14,6 +15,7 @@ export type PlatformBuildMetadataInput = {
 };
 
 export type PlatformBuildMetadata = {
+  /** ISO timestamp of the source commit used for the build, not deployment time. */
   builtAt: string;
   commitHash: string;
   commitMessage: string;

package/src/portless.ts

@@ -10,6 +10,8 @@ export const TUTURUUU_PORTLESS_APP_ORIGINS = {
   calendar: `https://calendar.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   chat: `https://chat.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   cms: `https://cms.${TUTURUUU_PORTLESS_ROOT_HOST}`,
+  contacts: `https://contacts.${TUTURUUU_PORTLESS_ROOT_HOST}`,
+  docs: `https://docs.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   drive: `https://drive.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   external: `https://external.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   finance: `https://finance.${TUTURUUU_PORTLESS_ROOT_HOST}`,
@@ -22,10 +24,12 @@ export const TUTURUUU_PORTLESS_APP_ORIGINS = {
   meet: `https://meet.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   mind: `https://mind.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   nova: `https://nova.${TUTURUUU_PORTLESS_ROOT_HOST}`,
+  pay: `https://pay.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   platform: TUTURUUU_PORTLESS_ROOT_ORIGIN,
   playground: `https://playground.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   qr: `https://qr.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   rewise: `https://rewise.${TUTURUUU_PORTLESS_ROOT_HOST}`,
+  tools: `https://tools.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   shortener: `https://shortener.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   storefront: `https://storefront.${TUTURUUU_PORTLESS_ROOT_HOST}`,
   'tanstack-web': `https://tanstack.${TUTURUUU_PORTLESS_ROOT_HOST}`,