olova 2.0.61 → 2.0.63

package/src/hydration/flight.ts

@@ -1,320 +0,0 @@
-/**
- * Olova Flight Format Hydration System
- * Implements "Flight" format for efficient client hydration (Next.js style)
- */
-
-import type {
-    AssetsChunkData,
-    HintsChunkData,
-    MetadataChunkData,
-    OlovaGlobal,
-    OlovaHydrationData,
-    ParsedFlightData,
-    RouteChunkData,
-    StateChunkData,
-    TreeChunkData,
-} from './types.js';
-
-/**
- * Safely stringify JSON for embedding in script tags
- * Escapes <, >, /, \u2028, and \u2029 to prevent XSS and syntax errors
- */
-function safeStringify(data: unknown): string {
-  return JSON.stringify(data).replace(/[<>\/\u2028\u2029]/g, (char) => {
-    switch (char) {
-      case '<': return '\\u003c';
-      case '>': return '\\u003e';
-      case '/': return '\\u002f';
-      case '\u2028': return '\\u2028';
-      case '\u2029': return '\\u2029';
-      default: return char;
-    }
-  });
-}
-
-/**
- * Generate a page name from route path
- */
-function generatePageName(route: string): string {
-  if (route === '/') return 'HomePage';
-  return route
-    .slice(1)
-    .split('/')
-    .filter(Boolean)
-    .map(s => s.charAt(0).toUpperCase() + s.slice(1).replace(/[^a-zA-Z0-9]/g, ''))
-    .join('') + 'Page';
-}
-
-/**
- * Generate route pattern from path
- */
-function generatePattern(route: string): string {
-  if (route === '/') return '/';
-  return route
-    .replace(/\[\.\.\.([^\]]+)\]/g, '*')
-    .replace(/\[([^\]]+)\]/g, ':$1');
-}
-
-/**
- * Generate the Flight runtime script (Next.js style)
- * This script processes the flight data array and hydrates the app
- */
-function generateFlightRuntime(): string {
-  return `<script>
-(function(){
-  var f=self.__olova_f||[];
-  var p={R:'$route',M:'$meta',T:'$tree',D:'$schema',A:'$assets',H:'$hints',S:'$state',L:'$loader',Q:'$query'};
-  var g=self.$OLOVA={};
-  function h(c){var t=c[1],d=c[2];if(t==='E')return;var k=p[t];if(k){if(t==='L'||t==='Q'){g[k]={data:d,timestamp:c[3]||Date.now()}}else{g[k]=d}}}
-  for(var i=0;i<f.length;i++)h(f[i]);
-  self.__olova_f={push:h,length:0};
-})();
-</script>`;
-}
-
-/**
- * Generate Olova hydration scripts using the Flight format
- * Creates chunked data that streams into the __olova_f array (Next.js style)
- */
-export function generateOlovaHydration(data: OlovaHydrationData, buildId: string): string {
-  const meta = (data.metadata || {}) as Record<string, unknown>;
-  const chunks: string[] = [];
-
-  // ==========================================================================
-  // CHUNK 0: Route Information
-  // ==========================================================================
-  const routeData: RouteChunkData = {
-    path: data.route,
-    params: data.params || {},
-    pattern: generatePattern(data.route),
-    isStatic: data.isStatic ?? true,
-    buildId: buildId
-  };
-  chunks.push(`<script>(self.__olova_f=self.__olova_f||[]).push([0,"R",${safeStringify(routeData)}])</script>`);
-
-  // ==========================================================================
-  // CHUNK 1: Metadata
-  // ==========================================================================
-  const metadataData: MetadataChunkData = {
-    title: (meta.title as string) || 'Olova App',
-    description: (meta.description as string) || '',
-    keywords: Array.isArray(meta.keywords) ? meta.keywords : [],
-    robots: (meta.robots as string) || 'index, follow',
-    canonical: (meta.canonical as string) || null,
-    og: {
-      type: 'website',
-      locale: 'en_US',
-      ...((meta.openGraph as object) || {})
-    },
-    twitter: {
-      card: 'summary_large_image',
-      ...((meta.twitter as object) || {})
-    }
-  };
-  chunks.push(`<script>(self.__olova_f).push([1,"M",${safeStringify(metadataData)}])</script>`);
-
-  // ==========================================================================
-  // CHUNK 2: Component Tree
-  // ==========================================================================
-  const treeData: TreeChunkData = {
-    layout: 'RootLayout',
-    page: generatePageName(data.route),
-    template: null,
-    loading: null,
-    error: null,
-    notFound: null
-  };
-  chunks.push(`<script>(self.__olova_f).push([2,"T",${safeStringify(treeData)}])</script>`);
-
-  // ==========================================================================
-  // CHUNK 3: Assets
-  // ==========================================================================
-  const assetsData: AssetsChunkData = {
-    chunks: data.chunks || [],
-    styles: [],
-    prefetch: (data.chunks || []).slice(0, 5)
-  };
-  chunks.push(`<script>(self.__olova_f).push([3,"A",${safeStringify(assetsData)}])</script>`);
-
-  // ==========================================================================
-  // CHUNK 4: Resource Hints
-  // ==========================================================================
-  const hintsData: HintsChunkData = {
-    dnsPrefetch: ['fonts.googleapis.com', 'fonts.gstatic.com'],
-    preconnect: ['https://fonts.googleapis.com', 'https://fonts.gstatic.com'],
-    modulePreload: (data.chunks || []).slice(0, 3)
-  };
-  chunks.push(`<script>(self.__olova_f).push([4,"H",${safeStringify(hintsData)}])</script>`);
-
-  // ==========================================================================
-  // CHUNK 5: Hydration State
-  // ==========================================================================
-  const stateData: StateChunkData = {
-    hydrated: false,
-    streaming: false,
-    ready: true,
-    timestamp: Date.now(),
-    version: '1.0.0',
-    buildId: buildId
-  };
-  chunks.push(`<script>(self.__olova_f).push([5,"S",${safeStringify(stateData)}])</script>`);
-
-  // ==========================================================================
-  // CHUNK 6: Loader Data (if present)
-  // ==========================================================================
-  if (data.loaderData) {
-    chunks.push(`<script>(self.__olova_f).push([6,"L",${safeStringify(data.loaderData)},${Date.now()}])</script>`);
-  }
-
-  // ==========================================================================
-  // CHUNK 7: Query State (if present)
-  // ==========================================================================
-  if (data.queryState) {
-    chunks.push(`<script>(self.__olova_f).push([7,"Q",${safeStringify(data.queryState)},${Date.now()}])</script>`);
-  }
-
-  // ==========================================================================
-  // CHUNK 8: END MARKER
-  // ==========================================================================
-  chunks.push(`<script>(self.__olova_f).push([8,"E",null])</script>`);
-
-  // ==========================================================================
-  // FLIGHT RUNTIME: Process all chunks into $OLOVA global (Next.js style)
-  // ==========================================================================
-  chunks.push(generateFlightRuntime());
-
-  return chunks.join('');
-}
-
-/**
- * Generate JSON-LD structured data script for SEO
- * This is injected into <head> for search engine crawlers
- */
-export function generateJsonLd(data: OlovaHydrationData): string {
-  const meta = (data.metadata || {}) as Record<string, unknown>;
-
-  const jsonLd = {
-    '@context': 'https://schema.org',
-    '@graph': [
-      {
-        '@type': 'WebPage',
-        '@id': data.route,
-        name: (meta.title as string) || 'Olova App',
-        description: (meta.description as string) || '',
-        url: data.route,
-        isPartOf: {
-          '@type': 'WebSite',
-          name: 'Olova App'
-        }
-      },
-      {
-        '@type': 'BreadcrumbList',
-        itemListElement: data.route.split('/').filter(Boolean).map((segment, index, arr) => ({
-          '@type': 'ListItem',
-          position: index + 1,
-          name: segment.charAt(0).toUpperCase() + segment.slice(1),
-          item: '/' + arr.slice(0, index + 1).join('/')
-        }))
-      }
-    ]
-  };
-
-  // Add custom schemas from page metadata
-  if (meta.schema) {
-    const graph = jsonLd['@graph'] as unknown[];
-    if (Array.isArray(meta.schema)) {
-      graph.push(...meta.schema);
-    } else {
-      graph.push(meta.schema);
-    }
-  }
-
-  return `<script type="application/ld+json">${JSON.stringify(jsonLd)}</script>`;
-}
-
-/**
- * Generate resource hint link tags for the head
- */
-export function generateResourceHints(data: OlovaHydrationData): string {
-  const hints: string[] = [];
-  
-  // DNS Prefetch for common external resources
-  hints.push(`<link rel="dns-prefetch" href="//fonts.googleapis.com">`);
-  hints.push(`<link rel="dns-prefetch" href="//fonts.gstatic.com">`);
-  
-  // Preconnect to critical origins
-  hints.push(`<link rel="preconnect" href="https://fonts.googleapis.com" crossorigin>`);
-  hints.push(`<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>`);
-  
-  // Module preload for chunks
-  if (data.chunks) {
-    for (const chunk of data.chunks.slice(0, 3)) {
-      hints.push(`<link rel="modulepreload" href="/${chunk}">`);
-    }
-  }
-  
-  return hints.join('');
-}
-
-/**
- * Parse flight data from the page (client-side utility)
- * Use this to access hydration data in your components
- */
-export function parseFlightData(): ParsedFlightData | null {
-  // Check if we're in a browser environment
-  if (typeof globalThis === 'undefined' || typeof (globalThis as Record<string, unknown>).document === 'undefined') {
-    return null;
-  }
-
-  const flightArray = ((globalThis as Record<string, unknown>).__olova_f) as unknown[] | undefined;
-  if (!flightArray) return null;
-
-  const result: ParsedFlightData = {};
-  const typeMap: Record<string, keyof ParsedFlightData | '$end'> = {
-    'M': '$meta',
-    'T': '$tree',
-    'R': '$route',
-    'A': '$assets',
-    'S': '$state',
-    'D': '$schema',
-    'H': '$hints',
-    'L': '$loader',
-    'Q': '$query',
-    'E': '$end'
-  };
-
-  for (const chunk of flightArray) {
-    if (Array.isArray(chunk) && chunk.length >= 3) {
-      const [_index, type, data] = chunk;
-      const key = typeMap[String(type)];
-      if (key && key !== '$end') {
-        (result as Record<string, unknown>)[key] = data;
-      }
-    }
-  }
-
-  return result;
-}
-
-/**
- * Get the global $OLOVA object (client-side)
- */
-export function getOlovaGlobal(): OlovaGlobal | null {
-  if (typeof globalThis === 'undefined') return null;
-  return ((globalThis as Record<string, unknown>).$OLOVA as OlovaGlobal) || null;
-}
-
-/**
- * Generate a unique build ID
- */
-export function generateBuildId(): string {
-  const timestamp = Date.now().toString(36);
-  const random = Math.random().toString(36).substring(2, 8);
-  return `${timestamp}-${random}`;
-}
-
-// Re-export types for convenience
-export type {
-    FlightChunk, FlightDataType, OlovaGlobal, OlovaHydrationData, PageMetadata, ParsedFlightData
-} from './types.js';
-

package/src/hydration/index.ts

@@ -1,12 +0,0 @@
-/**
- * Olova Flight Hydration - Public API
- */
-
-export {
-    generateBuildId, generateJsonLd, generateOlovaHydration, generateResourceHints, getOlovaGlobal, parseFlightData
-} from './flight.js';
-
-export type {
-    AssetsChunkData, BuildInfo, DehydratedState, FlightChunk, FlightDataType, HintsChunkData, LoaderChunkData, LoaderData, MetadataChunkData, OlovaGlobal, OlovaHydrationData, PageMetadata, ParsedFlightData, QueryChunkData, RouteChunkData, StateChunkData, TreeChunkData
-} from './types.js';
-

package/src/hydration/types.ts

@@ -1,225 +0,0 @@
-/**
- * Olova Flight Format Hydration Types
- * Type definitions for the Flight hydration system
- */
-
-/**
- * Flight data type identifiers
- * Each chunk type has a specific purpose in the hydration flow
- */
-export type FlightDataType =
-  | 'R'  // Route - navigation and routing info
-  | 'M'  // Metadata - SEO and page metadata
-  | 'T'  // Tree - component tree structure
-  | 'D'  // Data - JSON-LD structured data
-  | 'A'  // Assets - chunks for prefetching
-  | 'H'  // Hints - resource hints (dns-prefetch, preconnect)
-  | 'S'  // State - hydration state
-  | 'L'  // Loader - server-side data (TanStack Query compatible)
-  | 'Q'  // Query - TanStack Query dehydrated state
-  | 'E'; // End - marks completion
-
-/**
- * Loader data type - can be any JSON-serializable data
- */
-export type LoaderData = Record<string, unknown>;
-
-/**
- * TanStack Query dehydrated state
- */
-export interface DehydratedState {
-  queries?: Array<{
-    queryKey: unknown[];
-    queryData: unknown;
-    state?: {
-      status: string;
-      dataUpdatedAt?: number;
-    };
-  }>;
-  mutations?: unknown[];
-}
-
-/**
- * Input data for hydration generation
- */
-export interface OlovaHydrationData {
-  route: string;
-  params?: Record<string, string>;
-  metadata?: PageMetadata;
-  chunks?: string[];
-  isStatic?: boolean;
-  /** Data from route loaders (TanStack Query compatible) */
-  loaderData?: LoaderData;
-  /** TanStack Query dehydrated state */
-  queryState?: DehydratedState;
-}
-
-/**
- * Page metadata structure (SEO)
- */
-export interface PageMetadata {
-  title?: string;
-  description?: string;
-  keywords?: string[];
-  robots?: string;
-  canonical?: string;
-  openGraph?: OpenGraphData;
-  twitter?: TwitterCardData;
-  schema?: unknown | unknown[];
-}
-
-/**
- * OpenGraph metadata
- */
-export interface OpenGraphData {
-  type?: string;
-  locale?: string;
-  title?: string;
-  description?: string;
-  image?: string;
-  url?: string;
-  siteName?: string;
-}
-
-/**
- * Twitter Card metadata
- */
-export interface TwitterCardData {
-  card?: 'summary' | 'summary_large_image' | 'app' | 'player';
-  site?: string;
-  creator?: string;
-  title?: string;
-  description?: string;
-  image?: string;
-}
-
-/**
- * Individual Flight chunk structure
- */
-export interface FlightChunk {
-  type: FlightDataType;
-  data: unknown;
-}
-
-/**
- * Route chunk data (Chunk 0)
- */
-export interface RouteChunkData {
-  path: string;
-  params: Record<string, string>;
-  pattern: string;
-  isStatic: boolean;
-  buildId: string;
-}
-
-/**
- * Metadata chunk data (Chunk 1)
- */
-export interface MetadataChunkData {
-  title: string;
-  description: string;
-  keywords: string[];
-  robots: string;
-  canonical: string | null;
-  og: OpenGraphData;
-  twitter: TwitterCardData;
-}
-
-/**
- * Component tree chunk data (Chunk 2)
- */
-export interface TreeChunkData {
-  layout: string;
-  page: string;
-  template: string | null;
-  loading: string | null;
-  error: string | null;
-  notFound: string | null;
-}
-
-/**
- * Assets chunk data (Chunk 4)
- */
-export interface AssetsChunkData {
-  chunks: string[];
-  styles: string[];
-  prefetch: string[];
-}
-
-/**
- * Resource hints chunk data (Chunk 5)
- */
-export interface HintsChunkData {
-  dnsPrefetch: string[];
-  preconnect: string[];
-  modulePreload: string[];
-}
-
-/**
- * Hydration state chunk data (Chunk 6)
- */
-export interface StateChunkData {
-  hydrated: boolean;
-  streaming: boolean;
-  ready: boolean;
-  timestamp: number;
-  version: string;
-  buildId: string;
-}
-
-/**
- * Loader data chunk (Chunk 7) - for data-only SSR
- */
-export interface LoaderChunkData {
-  data: LoaderData;
-  timestamp: number;
-}
-
-/**
- * Query state chunk (Chunk 8) - TanStack Query hydration
- */
-export interface QueryChunkData {
-  state: DehydratedState;
-  timestamp: number;
-}
-
-/**
- * Build info structure
- */
-export interface BuildInfo {
-  id: string;
-  version: string;
-  timestamp: number;
-  env: 'development' | 'production';
-}
-
-/**
- * Global $OLOVA object structure
- */
-export interface OlovaGlobal {
-  $route: RouteChunkData;
-  $meta: MetadataChunkData;
-  $tree: TreeChunkData;
-  $schema: unknown[];
-  $assets: AssetsChunkData;
-  $hints: HintsChunkData;
-  $state: StateChunkData;
-  $loader?: LoaderChunkData;
-  $query?: QueryChunkData;
-  $build: BuildInfo;
-}
-
-/**
- * Parsed flight data result
- */
-export interface ParsedFlightData {
-  $route?: RouteChunkData;
-  $meta?: MetadataChunkData;
-  $tree?: TreeChunkData;
-  $schema?: unknown[];
-  $assets?: AssetsChunkData;
-  $hints?: HintsChunkData;
-  $state?: StateChunkData;
-  $loader?: LoaderChunkData;
-  $query?: QueryChunkData;
-}