@tuturuuu/utils 0.21.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.23.0](https://github.com/tutur3u/platform/compare/utils-v0.22.0...utils-v0.23.0) (2026-08-07)
+
+
+### Features
+
+* **platform:** expose the running build over HTTP for every app ([7b90d42](https://github.com/tutur3u/platform/commit/7b90d425a38048a1bf317b46f0da78225474f0e5))
+
+## [0.22.0](https://github.com/tutur3u/platform/compare/utils-v0.21.0...utils-v0.22.0) (2026-08-04)
+
+
+### Features
+
+* **chat:** add connected site sync bridge ([#5078](https://github.com/tutur3u/platform/issues/5078)) ([3de1a07](https://github.com/tutur3u/platform/commit/3de1a07dfa2fec96982aa0d116e003d0aa3fe47c))
+* **onboarding:** connect product guidance across apps ([68cf626](https://github.com/tutur3u/platform/commit/68cf626c9650e5044b6c123f9423a6cebf1bba9a))
+
+
+### Bug Fixes
+
+* **ai:** accept rich embedding payloads ([a65b13f](https://github.com/tutur3u/platform/commit/a65b13fa80034959e5f18ee4515b3081002558e2))
+* **tooling:** support webpack verification builds ([5275e10](https://github.com/tutur3u/platform/commit/5275e10c4007ae92e84be6c057a79f223980700c))
+
 ## [0.21.0](https://github.com/tutur3u/platform/compare/utils-v0.20.0...utils-v0.21.0) (2026-07-28)
 
 

package/biome.json

@@ -1,5 +1,5 @@
 {
   "root": false,
-  "$schema": "https://biomejs.dev/schemas/2.5.5/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.7/schema.json",
   "extends": "//"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tuturuuu/utils",
   "license": "MIT",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/tutur3u/platform",
@@ -20,39 +20,39 @@
     "@noble/ciphers": "^2.2.0",
     "@noble/hashes": "^2.2.0",
     "@tanstack/react-query": "^5.101.4",
-    "@tiptap/core": "3.28.0",
-    "@tiptap/react": "3.28.0",
+    "@tiptap/core": "3.29.2",
+    "@tiptap/react": "3.29.2",
     "@tuturuuu/google": "0.1.0",
     "@tuturuuu/icons": "0.1.0",
-    "@tuturuuu/internal-api": "0.25.0",
+    "@tuturuuu/internal-api": "0.29.0",
     "@tuturuuu/supabase": "0.5.0",
     "@upstash/ratelimit": "^2.0.8",
-    "@upstash/redis": "^1.38.0",
+    "@upstash/redis": "^1.38.2",
     "clsx": "^2.1.1",
     "date-fns": "^4.4.0",
     "dayjs": "^1.11.21",
     "diff": "^9.0.0",
-    "effect": "^3.22.0",
+    "effect": "^3.22.1",
     "moment": "^2.30.1",
-    "next": "^16.3.0-preview.9",
+    "next": "^16.3.0",
     "prosemirror-model": "^1.25.11",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "tailwind-merge": "^3.6.0",
     "uuid": "^14.0.1",
     "y-prosemirror": "^1.3.7",
-    "yjs": "^13.6.31",
+    "yjs": "^13.6.32",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@tuturuuu/types": "0.24.0",
+    "@tuturuuu/types": "0.27.0",
     "@tuturuuu/typescript-config": "0.1.1",
     "@types/diff": "^8.0.0",
-    "@types/node": "^26.1.1",
-    "@types/react": "^19.2.17",
-    "@vitejs/plugin-react": "^6.0.4",
+    "@types/node": "^26.1.2",
+    "@types/react": "^19.2.18",
+    "@vitejs/plugin-react": "^6.0.5",
     "typescript": "7.0.2",
-    "vite": "^8.1.5",
+    "vite": "^8.2.0",
     "vitest": "^4.1.10"
   },
   "exports": {

package/src/__tests__/api-proxy-guard.test.ts

@@ -159,6 +159,35 @@ describe('guardApiProxyRequest', () => {
     expect(mocks.validateEmoji).not.toHaveBeenCalled();
   });
 
+  it('can skip form-content validation without skipping payload limits', async () => {
+    mocks.validateEmoji.mockResolvedValue(
+      new Response(JSON.stringify({ error: 'Bad Request' }), { status: 400 })
+    );
+
+    const { guardApiProxyRequest } = await import('../api-proxy-guard.js');
+    const response = await guardApiProxyRequest(
+      makeRequest('/v1/embeddings', 'POST'),
+      {
+        prefixBase: 'proxy:test:ai',
+        skipContentValidation: true,
+      }
+    );
+
+    expect(response).toBeNull();
+    expect(mocks.validateEmoji).not.toHaveBeenCalled();
+
+    const oversized = await guardApiProxyRequest(
+      makeRequest('/v1/embeddings', 'POST', {
+        'content-length': `${1024 * 1024 + 1}`,
+      }),
+      {
+        prefixBase: 'proxy:test:ai',
+        skipContentValidation: true,
+      }
+    );
+    expect(oversized?.status).toBe(413);
+  });
+
   it('returns an IP-block response when the client is blocked', async () => {
     vi.stubEnv('NODE_ENV', 'production');
     mocks.extractIp.mockReturnValue('1.2.3.4');

package/src/api-proxy-guard.ts

@@ -88,6 +88,7 @@ export type GuardOptions = {
   additionalRoutePolicies?: ProxyRoutePolicy[];
   prefixBase: string;
   routePolicies?: ProxyRoutePolicy[];
+  skipContentValidation?: boolean;
   trustedBypassRules?: TrustedProxyBypassRule[];
 };
 
@@ -1385,6 +1386,10 @@ export async function guardApiProxyRequest(
       ? ['snapshot']
       : undefined;
 
+  if (options.skipContentValidation) {
+    return null;
+  }
+
   return (
     (await validateRequestEmojiLimit(req, {
       allowDescriptionYjsState,

package/src/build-info-route.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { createBuildInfoHandler } from './build-info-route';
+
+describe('createBuildInfoHandler', () => {
+  it('reports the app name and the build the bundle was made from', async () => {
+    const response = createBuildInfoHandler('tasks')();
+    const body = await response.json();
+
+    expect(response.status).toBe(200);
+    expect(body.appName).toBe('tasks');
+    expect(typeof body.commitHash).toBe('string');
+    expect(body.commitHash.length).toBeGreaterThan(0);
+    expect(typeof body.version).toBe('string');
+  });
+
+  it('is never cached', () => {
+    // A cached build stamp would defeat the point: it could report a commit
+    // the edge served earlier rather than the one running now.
+    const response = createBuildInfoHandler('web')();
+
+    expect(response.headers.get('cache-control')).toContain('no-store');
+  });
+});

package/src/build-info-route.ts

@@ -0,0 +1,29 @@
+import { getPlatformReleaseInfo } from './platform-release';
+
+/**
+ * Answer "which commit is actually serving this app right now?" over HTTP.
+ *
+ * The build metadata has always been generated into the bundle, but nothing
+ * exposed it at runtime, so the only way to check what a deployment contained
+ * was to infer it. That inference is unreliable: a deployment cancelled by a
+ * later push can leave an app serving code from before a merge while every
+ * workflow reports success, and `vercel inspect` returns no git metadata for
+ * these projects. Without this endpoint, "is my fix live?" is unanswerable.
+ *
+ * Returns a plain `Response` so route handlers in every app can re-export it
+ * without this module depending on a framework.
+ */
+export function createBuildInfoHandler(appName: string) {
+  return function GET(): Response {
+    const info = getPlatformReleaseInfo(appName);
+
+    return new Response(JSON.stringify(info, null, 2), {
+      headers: {
+        'content-type': 'application/json; charset=utf-8',
+        // Never let a CDN answer this: a cached build stamp is worse than none.
+        'cache-control': 'no-store, max-age=0',
+      },
+      status: 200,
+    });
+  };
+}

package/src/launchable-apps.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, it } from 'vitest';
 import {
   getLaunchableApp,
+  getLaunchableAppByHostname,
   getLaunchableAppByTitle,
   getLaunchableAppOrigin,
   LAUNCHABLE_APP_CATEGORIES,
@@ -36,6 +37,16 @@ describe('launchable apps', () => {
     expect(getLaunchableAppByTitle('apps gateway')?.slug).toBe('apps');
   });
 
+  it('resolves production and Portless hostnames', () => {
+    expect(getLaunchableAppByHostname('calendar.tuturuuu.com')?.slug).toBe(
+      'calendar'
+    );
+    expect(getLaunchableAppByHostname('finance.tuturuuu.localhost')?.slug).toBe(
+      'finance'
+    );
+    expect(getLaunchableAppByHostname('localhost:7808')?.slug).toBe('finance');
+  });
+
   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');

package/src/launchable-apps.ts

@@ -416,6 +416,29 @@ export function getLaunchableAppByTitle(value?: string | null) {
   );
 }
 
+export function getLaunchableAppByHostname(hostname: string) {
+  const normalized = hostname.trim().toLowerCase();
+  if (!normalized) return null;
+  const normalizedHostname = normalized.split(':')[0];
+
+  return (
+    LAUNCHABLE_APPS.find((app) => {
+      if (normalizedHostname === new URL(app.productionUrl).hostname)
+        return true;
+      if (
+        normalizedHostname === `${app.portlessApp}.tuturuuu.localhost` ||
+        normalizedHostname === `${app.slug}.tuturuuu.localhost`
+      ) {
+        return true;
+      }
+
+      return 'localhostOrigin' in app && app.localhostOrigin
+        ? normalized === new URL(app.localhostOrigin).host
+        : false;
+    }) ?? null
+  );
+}
+
 function getAutoEnvironment(currentOrigin?: string): LaunchableAppEnvironment {
   if (currentOrigin?.includes('tuturuuu.localhost')) return 'portless';
   if (currentOrigin?.includes('localhost')) return 'localhost';

package/src/next-config.test.ts

@@ -4,6 +4,7 @@ import {
   createTuturuuuNextConfig,
   isTuturuuuNextCacheComponentsEnabled,
   isTuturuuuNextReactCompilerEnabled,
+  isTuturuuuTurbopackRustReactCompilerEnabled,
   resolveTuturuuuInfrastructureAppUrl,
   resolveTuturuuuWebAppUrl,
   TUTURUUU_NEXT_IMAGE_REMOTE_PATTERNS,
@@ -267,6 +268,20 @@ describe('isTuturuuuNextCacheComponentsEnabled', () => {
   });
 });
 
+describe('isTuturuuuTurbopackRustReactCompilerEnabled', () => {
+  it('keeps the native compiler enabled for normal builds', () => {
+    expect(isTuturuuuTurbopackRustReactCompilerEnabled({})).toBe(true);
+  });
+
+  it('disables the Turbopack-only compiler for webpack fallback builds', () => {
+    expect(
+      isTuturuuuTurbopackRustReactCompilerEnabled({
+        NEXT_WEBPACK_BUILD: '1',
+      })
+    ).toBe(false);
+  });
+});
+
 describe('isTuturuuuNextReactCompilerEnabled', () => {
   it('keeps React Compiler enabled for next dev', () => {
     expect(

package/src/next-config.ts

@@ -83,6 +83,12 @@ export function isTuturuuuNextCacheComponentsEnabled(
   return true;
 }
 
+export function isTuturuuuTurbopackRustReactCompilerEnabled(
+  env: Environment = process.env
+) {
+  return env.NEXT_WEBPACK_BUILD !== '1';
+}
+
 export function createTuturuuuNextConfig(config: NextConfig = {}): NextConfig {
   const experimentalConfig = config.experimental ?? {};
   const imageConfig = config.images ?? {};
@@ -116,7 +122,8 @@ export function createTuturuuuNextConfig(config: NextConfig = {}): NextConfig {
       turbopackFileSystemCacheForBuild:
         experimentalConfig.turbopackFileSystemCacheForBuild ?? true,
       turbopackRustReactCompiler:
-        experimentalConfig.turbopackRustReactCompiler ?? true,
+        experimentalConfig.turbopackRustReactCompiler ??
+        isTuturuuuTurbopackRustReactCompilerEnabled(),
       optimizePackageImports: mergeStringArrays(
         TUTURUUU_NEXT_OPTIMIZE_PACKAGE_IMPORTS,
         experimentalConfig.optimizePackageImports

package/src/onboarding.test.ts

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'vitest';
+import { LAUNCHABLE_APPS } from './launchable-apps';
+import {
+  ONBOARDING_MISSIONS,
+  ONBOARDING_PERSONAS,
+  recommendOnboardingApps,
+} from './onboarding';
+
+describe('connected onboarding manifest', () => {
+  it('has one dedicated mission for every launchable app', () => {
+    expect(ONBOARDING_MISSIONS.map(({ appSlug }) => appSlug).sort()).toEqual(
+      LAUNCHABLE_APPS.map(({ slug }) => slug).sort()
+    );
+  });
+
+  it('keeps every mission short and action-oriented', () => {
+    expect(
+      ONBOARDING_MISSIONS.every(({ capabilities }) => capabilities.length === 3)
+    ).toBe(true);
+  });
+
+  it.each(ONBOARDING_PERSONAS)(
+    'returns launchable recommendations for %s',
+    (persona) => {
+      const recommendations = recommendOnboardingApps({
+        goals: [],
+        persona,
+      });
+      const launchable = new Set(LAUNCHABLE_APPS.map(({ slug }) => slug));
+
+      expect(recommendations.length).toBeGreaterThan(0);
+      expect(recommendations.every((slug) => launchable.has(slug))).toBe(true);
+    }
+  );
+});

package/src/onboarding.ts

@@ -0,0 +1,199 @@
+import { LAUNCHABLE_APPS } from './launchable-apps';
+
+export const ONBOARDING_PERSONAS = [
+  'professional',
+  'student',
+  'founder',
+  'executive',
+  'team_leader',
+  'educator',
+  'creator',
+  'developer',
+  'operations',
+] as const;
+
+export const ONBOARDING_GOALS = [
+  'focus',
+  'collaborate',
+  'operate',
+  'learn',
+  'build',
+] as const;
+
+export type OnboardingPersona = (typeof ONBOARDING_PERSONAS)[number];
+export type OnboardingGoal = (typeof ONBOARDING_GOALS)[number];
+export type OnboardingAppSlug = (typeof LAUNCHABLE_APPS)[number]['slug'];
+export type OnboardingActionSafety =
+  | 'preview'
+  | 'reversible'
+  | 'confirmation_required';
+
+export type OnboardingMission = {
+  appSlug: OnboardingAppSlug;
+  capabilities: readonly [string, string, string];
+  goal: OnboardingGoal;
+  safety: OnboardingActionSafety;
+};
+
+export type OnboardingJourneyPreferences = {
+  goals: OnboardingGoal[];
+  persona: OnboardingPersona | null;
+};
+
+export type OnboardingJourneyProgress = OnboardingJourneyPreferences & {
+  completedMissionIds: string[];
+  dismissedAt: string | null;
+  mode: 'standard' | 'employee_test';
+  replayApp: OnboardingAppSlug | null;
+  revision: number;
+};
+
+export const ONBOARDING_JOURNEY_REVISION = 2;
+
+export const PERSONA_RECOMMENDATIONS = {
+  professional: ['tasks', 'calendar', 'mail', 'drive', 'assistant'],
+  student: ['learn', 'rewise', 'calendar', 'tasks', 'mind'],
+  founder: ['tasks', 'finance', 'contacts', 'forms', 'assistant'],
+  executive: ['platform', 'finance', 'calendar', 'meet', 'assistant'],
+  team_leader: ['tasks', 'chat', 'calendar', 'meet', 'contacts'],
+  educator: ['teach', 'learn', 'forms', 'meet', 'drive'],
+  creator: ['cms', 'drive', 'shortener', 'forms', 'assistant'],
+  developer: ['git', 'ai', 'docs', 'tasks', 'tools'],
+  operations: ['inventory', 'finance', 'contacts', 'forms', 'tasks'],
+} as const satisfies Record<OnboardingPersona, readonly string[]>;
+
+export const GOAL_RECOMMENDATIONS = {
+  focus: ['tasks', 'calendar', 'mail', 'track', 'assistant'],
+  collaborate: ['chat', 'meet', 'drive', 'tasks', 'forms'],
+  operate: ['finance', 'inventory', 'contacts', 'pay', 'storefront'],
+  learn: ['learn', 'teach', 'rewise', 'mind', 'docs'],
+  build: ['ai', 'git', 'cms', 'nova', 'tools'],
+} as const satisfies Record<OnboardingGoal, readonly string[]>;
+
+const MISSIONS = [
+  ['platform', 'focus', 'reversible', ['overview', 'apps', 'next_move']],
+  ['calendar', 'focus', 'reversible', ['schedule', 'timebox', 'review']],
+  [
+    'chat',
+    'collaborate',
+    'confirmation_required',
+    ['spaces', 'message', 'follow_up'],
+  ],
+  ['cms', 'build', 'confirmation_required', ['content', 'preview', 'publish']],
+  [
+    'drive',
+    'collaborate',
+    'confirmation_required',
+    ['organize', 'share', 'find'],
+  ],
+  ['git', 'build', 'preview', ['repositories', 'browse', 'search']],
+  ['apps', 'focus', 'reversible', ['discover', 'filter', 'launch']],
+  ['docs', 'learn', 'preview', ['browse', 'search', 'reference']],
+  [
+    'finance',
+    'operate',
+    'confirmation_required',
+    ['wallets', 'transactions', 'reports'],
+  ],
+  ['hive', 'build', 'preview', ['world', 'simulate', 'observe']],
+  [
+    'inventory',
+    'operate',
+    'confirmation_required',
+    ['catalog', 'stock', 'movement'],
+  ],
+  [
+    'storefront',
+    'operate',
+    'confirmation_required',
+    ['store', 'preview', 'checkout'],
+  ],
+  ['learn', 'learn', 'reversible', ['courses', 'study', 'progress']],
+  ['mail', 'focus', 'confirmation_required', ['inbox', 'compose', 'follow_up']],
+  ['meet', 'collaborate', 'confirmation_required', ['room', 'invite', 'meet']],
+  ['mind', 'learn', 'reversible', ['canvas', 'connect', 'organize']],
+  [
+    'ai',
+    'build',
+    'confirmation_required',
+    ['playground', 'models', 'evaluate'],
+  ],
+  ['nova', 'build', 'confirmation_required', ['challenge', 'prompt', 'submit']],
+  ['tools', 'build', 'reversible', ['choose', 'configure', 'generate']],
+  ['rewise', 'learn', 'reversible', ['material', 'practice', 'review']],
+  ['shortener', 'build', 'reversible', ['link', 'customize', 'measure']],
+  ['tasks', 'focus', 'reversible', ['capture', 'plan', 'complete']],
+  ['teach', 'learn', 'confirmation_required', ['course', 'lesson', 'share']],
+  ['pay', 'operate', 'confirmation_required', ['request', 'review', 'pay']],
+  [
+    'contacts',
+    'operate',
+    'confirmation_required',
+    ['people', 'fields', 'follow_up'],
+  ],
+  [
+    'forms',
+    'collaborate',
+    'confirmation_required',
+    ['build', 'preview', 'share'],
+  ],
+  ['track', 'focus', 'reversible', ['timer', 'session', 'insights']],
+] as const satisfies readonly (readonly [
+  OnboardingAppSlug,
+  OnboardingGoal,
+  OnboardingActionSafety,
+  readonly [string, string, string],
+])[];
+
+export const ONBOARDING_MISSIONS: readonly OnboardingMission[] = MISSIONS.map(
+  ([appSlug, goal, safety, capabilities]) => ({
+    appSlug,
+    capabilities,
+    goal,
+    safety,
+  })
+);
+
+export function getOnboardingMission(appSlug: string) {
+  return ONBOARDING_MISSIONS.find((mission) => mission.appSlug === appSlug);
+}
+
+export function recommendOnboardingApps(
+  preferences: OnboardingJourneyPreferences,
+  limit = 8
+): OnboardingAppSlug[] {
+  const ranked = new Map<string, number>();
+  const add = (slug: string, score: number) =>
+    ranked.set(slug, (ranked.get(slug) ?? 0) + score);
+
+  if (preferences.persona) {
+    PERSONA_RECOMMENDATIONS[preferences.persona].forEach((slug, index) => {
+      add(slug, 20 - index);
+    });
+  }
+
+  preferences.goals.forEach((goal) => {
+    GOAL_RECOMMENDATIONS[goal].forEach((slug, index) => {
+      add(slug, 12 - index);
+    });
+  });
+
+  const launchable = new Set(LAUNCHABLE_APPS.map((app) => app.slug));
+  return [...ranked.entries()]
+    .filter(([slug]) => launchable.has(slug as OnboardingAppSlug))
+    .sort((left, right) => right[1] - left[1])
+    .slice(0, limit)
+    .map(([slug]) => slug as OnboardingAppSlug);
+}
+
+export function createDefaultOnboardingProgress(): OnboardingJourneyProgress {
+  return {
+    completedMissionIds: [],
+    dismissedAt: null,
+    goals: [],
+    mode: 'standard',
+    persona: null,
+    replayApp: null,
+    revision: ONBOARDING_JOURNEY_REVISION,
+  };
+}

package/src/platform-release.test.ts

@@ -7,7 +7,7 @@ import {
 
 describe('platform release metadata', () => {
   it('uses the centralized shared browser app version', () => {
-    expect(TUTURUUU_PLATFORM_VERSION).toBe('0.30.0'); // x-release-please-version
+    expect(TUTURUUU_PLATFORM_VERSION).toBe('0.35.0'); // x-release-please-version
   });
 
   it('preserves the source timestamp in builtAt and derives a short hash', () => {

package/src/platform-release.ts

@@ -1,6 +1,6 @@
 import { PLATFORM_BUILD_METADATA } from './generated/platform-build-metadata';
 
-export const TUTURUUU_PLATFORM_VERSION = '0.30.0'; // x-release-please-version
+export const TUTURUUU_PLATFORM_VERSION = '0.35.0'; // x-release-please-version
 
 export type PlatformBuildMetadataInput = {
   /** ISO timestamp of the source commit used for the build, not deployment time. */