@timber-js/app 0.1.23 → 0.1.25

package/src/server/metadata-platform.ts

@@ -0,0 +1,229 @@
+/**
+ * Platform-specific metadata rendering — icons, Apple Web App, App Links, iTunes.
+ *
+ * Extracted from metadata-render.ts to keep files under 500 lines.
+ *
+ * See design/16-metadata.md
+ */
+
+import type { Metadata } from './types.js';
+import type { HeadElement } from './metadata.js';
+
+/**
+ * Render icon link elements (favicon, shortcut, apple-touch-icon, custom).
+ */
+export function renderIcons(icons: NonNullable<Metadata['icons']>, elements: HeadElement[]): void {
+  // Icon
+  if (icons.icon) {
+    if (typeof icons.icon === 'string') {
+      elements.push({ tag: 'link', attrs: { rel: 'icon', href: icons.icon } });
+    } else if (Array.isArray(icons.icon)) {
+      for (const icon of icons.icon) {
+        const attrs: Record<string, string> = { rel: 'icon', href: icon.url };
+        if (icon.sizes) attrs.sizes = icon.sizes;
+        if (icon.type) attrs.type = icon.type;
+        elements.push({ tag: 'link', attrs });
+      }
+    }
+  }
+
+  // Shortcut
+  if (icons.shortcut) {
+    const urls = Array.isArray(icons.shortcut) ? icons.shortcut : [icons.shortcut];
+    for (const url of urls) {
+      elements.push({ tag: 'link', attrs: { rel: 'shortcut icon', href: url } });
+    }
+  }
+
+  // Apple
+  if (icons.apple) {
+    if (typeof icons.apple === 'string') {
+      elements.push({ tag: 'link', attrs: { rel: 'apple-touch-icon', href: icons.apple } });
+    } else if (Array.isArray(icons.apple)) {
+      for (const icon of icons.apple) {
+        const attrs: Record<string, string> = { rel: 'apple-touch-icon', href: icon.url };
+        if (icon.sizes) attrs.sizes = icon.sizes;
+        elements.push({ tag: 'link', attrs });
+      }
+    }
+  }
+
+  // Other
+  if (icons.other) {
+    for (const icon of icons.other) {
+      const attrs: Record<string, string> = { rel: icon.rel, href: icon.url };
+      if (icon.sizes) attrs.sizes = icon.sizes;
+      if (icon.type) attrs.type = icon.type;
+      elements.push({ tag: 'link', attrs });
+    }
+  }
+}
+
+/**
+ * Render alternate link elements (canonical, hreflang, media, types).
+ */
+export function renderAlternates(
+  alternates: NonNullable<Metadata['alternates']>,
+  elements: HeadElement[]
+): void {
+  if (alternates.canonical) {
+    elements.push({ tag: 'link', attrs: { rel: 'canonical', href: alternates.canonical } });
+  }
+
+  if (alternates.languages) {
+    for (const [lang, href] of Object.entries(alternates.languages)) {
+      elements.push({
+        tag: 'link',
+        attrs: { rel: 'alternate', hreflang: lang, href },
+      });
+    }
+  }
+
+  if (alternates.media) {
+    for (const [media, href] of Object.entries(alternates.media)) {
+      elements.push({
+        tag: 'link',
+        attrs: { rel: 'alternate', media, href },
+      });
+    }
+  }
+
+  if (alternates.types) {
+    for (const [type, href] of Object.entries(alternates.types)) {
+      elements.push({
+        tag: 'link',
+        attrs: { rel: 'alternate', type, href },
+      });
+    }
+  }
+}
+
+/**
+ * Render site verification meta tags (Google, Yahoo, Yandex, custom).
+ */
+export function renderVerification(
+  verification: NonNullable<Metadata['verification']>,
+  elements: HeadElement[]
+): void {
+  const verificationProps: Array<[string, string | undefined]> = [
+    ['google-site-verification', verification.google],
+    ['y_key', verification.yahoo],
+    ['yandex-verification', verification.yandex],
+  ];
+
+  for (const [name, content] of verificationProps) {
+    if (content) {
+      elements.push({ tag: 'meta', attrs: { name, content } });
+    }
+  }
+  if (verification.other) {
+    for (const [name, value] of Object.entries(verification.other)) {
+      const content = Array.isArray(value) ? value.join(', ') : value;
+      elements.push({ tag: 'meta', attrs: { name, content } });
+    }
+  }
+}
+
+/**
+ * Render Apple Web App meta tags and startup image links.
+ */
+export function renderAppleWebApp(
+  appleWebApp: NonNullable<Metadata['appleWebApp']>,
+  elements: HeadElement[]
+): void {
+  if (appleWebApp.capable) {
+    elements.push({
+      tag: 'meta',
+      attrs: { name: 'apple-mobile-web-app-capable', content: 'yes' },
+    });
+  }
+  if (appleWebApp.title) {
+    elements.push({
+      tag: 'meta',
+      attrs: { name: 'apple-mobile-web-app-title', content: appleWebApp.title },
+    });
+  }
+  if (appleWebApp.statusBarStyle) {
+    elements.push({
+      tag: 'meta',
+      attrs: {
+        name: 'apple-mobile-web-app-status-bar-style',
+        content: appleWebApp.statusBarStyle,
+      },
+    });
+  }
+  if (appleWebApp.startupImage) {
+    const images = Array.isArray(appleWebApp.startupImage)
+      ? appleWebApp.startupImage
+      : [{ url: appleWebApp.startupImage }];
+    for (const img of images) {
+      const url = typeof img === 'string' ? img : img.url;
+      const attrs: Record<string, string> = { rel: 'apple-touch-startup-image', href: url };
+      if (typeof img === 'object' && img.media) {
+        attrs.media = img.media;
+      }
+      elements.push({ tag: 'link', attrs });
+    }
+  }
+}
+
+/**
+ * Render App Links (al:*) meta tags for deep linking across platforms.
+ */
+export function renderAppLinks(
+  appLinks: NonNullable<Metadata['appLinks']>,
+  elements: HeadElement[]
+): void {
+  const platformEntries: Array<[string, Array<Record<string, unknown>> | undefined]> = [
+    ['ios', appLinks.ios],
+    ['android', appLinks.android],
+    ['windows', appLinks.windows],
+    ['windows_phone', appLinks.windowsPhone],
+    ['windows_universal', appLinks.windowsUniversal],
+  ];
+
+  for (const [platform, entries] of platformEntries) {
+    if (!entries) continue;
+    for (const entry of entries) {
+      for (const [key, value] of Object.entries(entry)) {
+        if (value !== undefined && value !== null) {
+          elements.push({
+            tag: 'meta',
+            attrs: { property: `al:${platform}:${key}`, content: String(value) },
+          });
+        }
+      }
+    }
+  }
+
+  if (appLinks.web) {
+    if (appLinks.web.url) {
+      elements.push({
+        tag: 'meta',
+        attrs: { property: 'al:web:url', content: appLinks.web.url },
+      });
+    }
+    if (appLinks.web.shouldFallback !== undefined) {
+      elements.push({
+        tag: 'meta',
+        attrs: {
+          property: 'al:web:should_fallback',
+          content: appLinks.web.shouldFallback ? 'true' : 'false',
+        },
+      });
+    }
+  }
+}
+
+/**
+ * Render Apple iTunes smart banner meta tag.
+ */
+export function renderItunes(itunes: NonNullable<Metadata['itunes']>, elements: HeadElement[]): void {
+  const parts = [`app-id=${itunes.appId}`];
+  if (itunes.affiliateData) parts.push(`affiliate-data=${itunes.affiliateData}`);
+  if (itunes.appArgument) parts.push(`app-argument=${itunes.appArgument}`);
+  elements.push({
+    tag: 'meta',
+    attrs: { name: 'apple-itunes-app', content: parts.join(', ') },
+  });
+}

package/src/server/metadata-render.ts

@@ -8,6 +8,15 @@
 
 import type { Metadata } from './types.js';
 import type { HeadElement } from './metadata.js';
+import { renderOpenGraph, renderTwitter } from './metadata-social.js';
+import {
+  renderIcons,
+  renderAlternates,
+  renderVerification,
+  renderAppleWebApp,
+  renderAppLinks,
+  renderItunes,
+} from './metadata-platform.js';
 
 // ─── Render to Elements ──────────────────────────────────────────────────────
 
@@ -162,366 +171,3 @@ function renderRobotsObject(robots: Record<string, unknown>): string {
   if (robots.follow === false) parts.push('nofollow');
   return parts.join(', ');
 }
-
-function renderOpenGraph(og: NonNullable<Metadata['openGraph']>, elements: HeadElement[]): void {
-  const simpleProps: Array<[string, string | undefined]> = [
-    ['og:title', og.title],
-    ['og:description', og.description],
-    ['og:url', og.url],
-    ['og:site_name', og.siteName],
-    ['og:locale', og.locale],
-    ['og:type', og.type],
-    ['og:article:published_time', og.publishedTime],
-    ['og:article:modified_time', og.modifiedTime],
-  ];
-
-  for (const [property, content] of simpleProps) {
-    if (content) {
-      elements.push({ tag: 'meta', attrs: { property, content } });
-    }
-  }
-
-  // Images — normalize single object to array for uniform handling
-  if (og.images) {
-    if (typeof og.images === 'string') {
-      elements.push({ tag: 'meta', attrs: { property: 'og:image', content: og.images } });
-    } else {
-      const imgList = Array.isArray(og.images) ? og.images : [og.images];
-      for (const img of imgList) {
-        elements.push({ tag: 'meta', attrs: { property: 'og:image', content: img.url } });
-        if (img.width) {
-          elements.push({
-            tag: 'meta',
-            attrs: { property: 'og:image:width', content: String(img.width) },
-          });
-        }
-        if (img.height) {
-          elements.push({
-            tag: 'meta',
-            attrs: { property: 'og:image:height', content: String(img.height) },
-          });
-        }
-        if (img.alt) {
-          elements.push({ tag: 'meta', attrs: { property: 'og:image:alt', content: img.alt } });
-        }
-      }
-    }
-  }
-
-  // Videos
-  if (og.videos) {
-    for (const video of og.videos) {
-      elements.push({ tag: 'meta', attrs: { property: 'og:video', content: video.url } });
-    }
-  }
-
-  // Audio
-  if (og.audio) {
-    for (const audio of og.audio) {
-      elements.push({ tag: 'meta', attrs: { property: 'og:audio', content: audio.url } });
-    }
-  }
-
-  // Authors
-  if (og.authors) {
-    for (const author of og.authors) {
-      elements.push({
-        tag: 'meta',
-        attrs: { property: 'og:article:author', content: author },
-      });
-    }
-  }
-}
-
-function renderTwitter(tw: NonNullable<Metadata['twitter']>, elements: HeadElement[]): void {
-  const simpleProps: Array<[string, string | undefined]> = [
-    ['twitter:card', tw.card],
-    ['twitter:site', tw.site],
-    ['twitter:site:id', tw.siteId],
-    ['twitter:title', tw.title],
-    ['twitter:description', tw.description],
-    ['twitter:creator', tw.creator],
-    ['twitter:creator:id', tw.creatorId],
-  ];
-
-  for (const [name, content] of simpleProps) {
-    if (content) {
-      elements.push({ tag: 'meta', attrs: { name, content } });
-    }
-  }
-
-  // Images — normalize single object to array for uniform handling
-  if (tw.images) {
-    if (typeof tw.images === 'string') {
-      elements.push({ tag: 'meta', attrs: { name: 'twitter:image', content: tw.images } });
-    } else {
-      const imgList = Array.isArray(tw.images) ? tw.images : [tw.images];
-      for (const img of imgList) {
-        const url = typeof img === 'string' ? img : img.url;
-        elements.push({ tag: 'meta', attrs: { name: 'twitter:image', content: url } });
-      }
-    }
-  }
-
-  // Player card fields
-  if (tw.players) {
-    for (const player of tw.players) {
-      elements.push({ tag: 'meta', attrs: { name: 'twitter:player', content: player.playerUrl } });
-      if (player.width) {
-        elements.push({
-          tag: 'meta',
-          attrs: { name: 'twitter:player:width', content: String(player.width) },
-        });
-      }
-      if (player.height) {
-        elements.push({
-          tag: 'meta',
-          attrs: { name: 'twitter:player:height', content: String(player.height) },
-        });
-      }
-      if (player.streamUrl) {
-        elements.push({
-          tag: 'meta',
-          attrs: { name: 'twitter:player:stream', content: player.streamUrl },
-        });
-      }
-    }
-  }
-
-  // App card fields — 3 platforms × 3 attributes (name, id, url)
-  if (tw.app) {
-    const platforms: Array<[keyof NonNullable<typeof tw.app.id>, string]> = [
-      ['iPhone', 'iphone'],
-      ['iPad', 'ipad'],
-      ['googlePlay', 'googleplay'],
-    ];
-
-    // App name is shared across platforms but the spec uses per-platform names.
-    // Emit for each platform that has an ID.
-    if (tw.app.name) {
-      for (const [key, tag] of platforms) {
-        if (tw.app.id?.[key]) {
-          elements.push({
-            tag: 'meta',
-            attrs: { name: `twitter:app:name:${tag}`, content: tw.app.name },
-          });
-        }
-      }
-    }
-
-    for (const [key, tag] of platforms) {
-      const id = tw.app.id?.[key];
-      if (id) {
-        elements.push({ tag: 'meta', attrs: { name: `twitter:app:id:${tag}`, content: id } });
-      }
-    }
-
-    for (const [key, tag] of platforms) {
-      const url = tw.app.url?.[key];
-      if (url) {
-        elements.push({ tag: 'meta', attrs: { name: `twitter:app:url:${tag}`, content: url } });
-      }
-    }
-  }
-}
-
-function renderIcons(icons: NonNullable<Metadata['icons']>, elements: HeadElement[]): void {
-  // Icon
-  if (icons.icon) {
-    if (typeof icons.icon === 'string') {
-      elements.push({ tag: 'link', attrs: { rel: 'icon', href: icons.icon } });
-    } else if (Array.isArray(icons.icon)) {
-      for (const icon of icons.icon) {
-        const attrs: Record<string, string> = { rel: 'icon', href: icon.url };
-        if (icon.sizes) attrs.sizes = icon.sizes;
-        if (icon.type) attrs.type = icon.type;
-        elements.push({ tag: 'link', attrs });
-      }
-    }
-  }
-
-  // Shortcut
-  if (icons.shortcut) {
-    const urls = Array.isArray(icons.shortcut) ? icons.shortcut : [icons.shortcut];
-    for (const url of urls) {
-      elements.push({ tag: 'link', attrs: { rel: 'shortcut icon', href: url } });
-    }
-  }
-
-  // Apple
-  if (icons.apple) {
-    if (typeof icons.apple === 'string') {
-      elements.push({ tag: 'link', attrs: { rel: 'apple-touch-icon', href: icons.apple } });
-    } else if (Array.isArray(icons.apple)) {
-      for (const icon of icons.apple) {
-        const attrs: Record<string, string> = { rel: 'apple-touch-icon', href: icon.url };
-        if (icon.sizes) attrs.sizes = icon.sizes;
-        elements.push({ tag: 'link', attrs });
-      }
-    }
-  }
-
-  // Other
-  if (icons.other) {
-    for (const icon of icons.other) {
-      const attrs: Record<string, string> = { rel: icon.rel, href: icon.url };
-      if (icon.sizes) attrs.sizes = icon.sizes;
-      if (icon.type) attrs.type = icon.type;
-      elements.push({ tag: 'link', attrs });
-    }
-  }
-}
-
-function renderAlternates(
-  alternates: NonNullable<Metadata['alternates']>,
-  elements: HeadElement[]
-): void {
-  if (alternates.canonical) {
-    elements.push({ tag: 'link', attrs: { rel: 'canonical', href: alternates.canonical } });
-  }
-
-  if (alternates.languages) {
-    for (const [lang, href] of Object.entries(alternates.languages)) {
-      elements.push({
-        tag: 'link',
-        attrs: { rel: 'alternate', hreflang: lang, href },
-      });
-    }
-  }
-
-  if (alternates.media) {
-    for (const [media, href] of Object.entries(alternates.media)) {
-      elements.push({
-        tag: 'link',
-        attrs: { rel: 'alternate', media, href },
-      });
-    }
-  }
-
-  if (alternates.types) {
-    for (const [type, href] of Object.entries(alternates.types)) {
-      elements.push({
-        tag: 'link',
-        attrs: { rel: 'alternate', type, href },
-      });
-    }
-  }
-}
-
-function renderVerification(
-  verification: NonNullable<Metadata['verification']>,
-  elements: HeadElement[]
-): void {
-  const verificationProps: Array<[string, string | undefined]> = [
-    ['google-site-verification', verification.google],
-    ['y_key', verification.yahoo],
-    ['yandex-verification', verification.yandex],
-  ];
-
-  for (const [name, content] of verificationProps) {
-    if (content) {
-      elements.push({ tag: 'meta', attrs: { name, content } });
-    }
-  }
-  if (verification.other) {
-    for (const [name, value] of Object.entries(verification.other)) {
-      const content = Array.isArray(value) ? value.join(', ') : value;
-      elements.push({ tag: 'meta', attrs: { name, content } });
-    }
-  }
-}
-
-function renderAppleWebApp(
-  appleWebApp: NonNullable<Metadata['appleWebApp']>,
-  elements: HeadElement[]
-): void {
-  if (appleWebApp.capable) {
-    elements.push({
-      tag: 'meta',
-      attrs: { name: 'apple-mobile-web-app-capable', content: 'yes' },
-    });
-  }
-  if (appleWebApp.title) {
-    elements.push({
-      tag: 'meta',
-      attrs: { name: 'apple-mobile-web-app-title', content: appleWebApp.title },
-    });
-  }
-  if (appleWebApp.statusBarStyle) {
-    elements.push({
-      tag: 'meta',
-      attrs: {
-        name: 'apple-mobile-web-app-status-bar-style',
-        content: appleWebApp.statusBarStyle,
-      },
-    });
-  }
-  if (appleWebApp.startupImage) {
-    const images = Array.isArray(appleWebApp.startupImage)
-      ? appleWebApp.startupImage
-      : [{ url: appleWebApp.startupImage }];
-    for (const img of images) {
-      const url = typeof img === 'string' ? img : img.url;
-      const attrs: Record<string, string> = { rel: 'apple-touch-startup-image', href: url };
-      if (typeof img === 'object' && img.media) {
-        attrs.media = img.media;
-      }
-      elements.push({ tag: 'link', attrs });
-    }
-  }
-}
-
-function renderAppLinks(
-  appLinks: NonNullable<Metadata['appLinks']>,
-  elements: HeadElement[]
-): void {
-  const platformEntries: Array<[string, Array<Record<string, unknown>> | undefined]> = [
-    ['ios', appLinks.ios],
-    ['android', appLinks.android],
-    ['windows', appLinks.windows],
-    ['windows_phone', appLinks.windowsPhone],
-    ['windows_universal', appLinks.windowsUniversal],
-  ];
-
-  for (const [platform, entries] of platformEntries) {
-    if (!entries) continue;
-    for (const entry of entries) {
-      for (const [key, value] of Object.entries(entry)) {
-        if (value !== undefined && value !== null) {
-          elements.push({
-            tag: 'meta',
-            attrs: { property: `al:${platform}:${key}`, content: String(value) },
-          });
-        }
-      }
-    }
-  }
-
-  if (appLinks.web) {
-    if (appLinks.web.url) {
-      elements.push({
-        tag: 'meta',
-        attrs: { property: 'al:web:url', content: appLinks.web.url },
-      });
-    }
-    if (appLinks.web.shouldFallback !== undefined) {
-      elements.push({
-        tag: 'meta',
-        attrs: {
-          property: 'al:web:should_fallback',
-          content: appLinks.web.shouldFallback ? 'true' : 'false',
-        },
-      });
-    }
-  }
-}
-
-function renderItunes(itunes: NonNullable<Metadata['itunes']>, elements: HeadElement[]): void {
-  const parts = [`app-id=${itunes.appId}`];
-  if (itunes.affiliateData) parts.push(`affiliate-data=${itunes.affiliateData}`);
-  if (itunes.appArgument) parts.push(`app-argument=${itunes.appArgument}`);
-  elements.push({
-    tag: 'meta',
-    attrs: { name: 'apple-itunes-app', content: parts.join(', ') },
-  });
-}