web_huakui_web/tests/seo-images.test.ts

import assert from 'node:assert/strict';
import test from 'node:test';
import { createContext } from '../src/server/context';
import { enrichSEO, imageURL, toNextMetadata } from '../src/server/seo';

const site = 'https://canonical.drama.test';
const cdn = 'https://primary.images.test/assets/';
const bases = [cdn, 'https://backup.images.test/media/'];
const cover = 'v3/image/story.webp?ticket=a%2Bb%3D&path=%2Fcover';
const config = { foreverUrlAddr: site, seoInfo: { title: '花魁短剧', webSiteName: '花魁短剧' } };
const playlet = { id: 41, slug: 'story', title: '故事', cover, onlineAt: '2026-10-12 12:34:56', totalEpisode: 2 };
const chapter = { id: 401, currentEpisode: 1, videoUrl: 'https://video.drama.test/story.m3u8?sig=preserved' };
const context = (route: string) => createContext(new Request('http://internal:3000' + route));
const graph = (data: Record<string, any>) => JSON.parse(data.jsonLD)['@graph'] as Record<string, any>[];
const node = (data: Record<string, any>, type: string) => graph(data).find(item => item['@type'] === type);

test('detail, episode and series structured images resolve relative object keys on the configured CDN', () => {
  const detail = enrichSEO(context('/play/story/'), { appConfig: config, imageCDNs: bases, detail: playlet });
  assert.deepEqual(node(detail, 'TVSeries')?.image, [cdn + cover]);
  assert.deepEqual(node(detail, 'TVSeries')?.thumbnailUrl, [cdn + cover]);

  const episode = enrichSEO(context('/play/story/'), { appConfig: config, imageCDNs: bases, playlet, chapter });
  for (const type of ['TVSeries', 'VideoObject', 'TVEpisode']) {
    assert.deepEqual(node(episode, type)?.image, [cdn + cover], type);
  }
  assert.deepEqual(node(episode, 'VideoObject')?.thumbnailUrl, [cdn + cover]);
  assert.equal(node(episode, 'VideoObject')?.contentUrl, chapter.videoUrl);
  assert.equal(episode.canonicalURL, site + '/drama/story/');
  assert.equal(episode.robots, 'index,follow,max-image-preview:large,max-snippet:-1,max-video-preview:-1');

  for (const video of [
    { id: 42, slug: 'film', title: '剧集', coverImg: cover, addedTime: '2026-10-12 10:00:00', video: { url: '/film.m3u8' } },
    { id: 42, slug: 'film', title: '剧集', addedTime: '2026-10-12 10:00:00', video: { cover, url: '/film.m3u8' } },
  ]) {
    const series = enrichSEO(context('/series-play/film/'), { appConfig: config, imageCDNs: bases, video, canWatch: true });
    assert.deepEqual(node(series, 'VideoObject')?.image, [cdn + cover]);
    assert.deepEqual(node(series, 'VideoObject')?.thumbnailUrl, [cdn + cover]);
    assert.equal(series.canonicalURL, site + '/series/watch/film/');
  }
});

test('absolute signed media image URLs remain byte-for-byte unchanged in JSON-LD and metadata', () => {
  const signed = cdn + 'v3/image/signed.webp?Signature=a%2Bb%3D&Policy=c%2Fd&Key-Pair-Id=fixture#preserved';
  const data = enrichSEO(context('/play/story/'), { appConfig: config, imageCDNs: bases, playlet: { ...playlet, cover: signed }, chapter });
  assert.deepEqual(node(data, 'TVSeries')?.image, [signed]);
  assert.deepEqual(node(data, 'VideoObject')?.thumbnailUrl, [signed]);
  const home = enrichSEO(context('/'), { appConfig: config, imageCDNs: bases, cover: signed });
  assert.equal(home.ogImage, signed);
  assert.deepEqual(toNextMetadata(home).openGraph?.images, [signed]);
  assert.deepEqual(toNextMetadata(home).twitter?.images, [signed]);
});

test('non-static OG images share the CDN resolver while local/default playback OG images stay on the site', () => {
  const home = enrichSEO(context('/'), { appConfig: config, imageCDNs: bases, cover });
  assert.equal(home.ogImage, cdn + cover);
  for (const data of [
    enrichSEO(context('/'), { appConfig: config, imageCDNs: bases }),
    enrichSEO(context('/play/story/'), { appConfig: config, imageCDNs: bases, playlet, chapter }),
    enrichSEO(context('/series-play/film/'), { appConfig: config, imageCDNs: bases, cover, canWatch: true }),
  ]) {
    const url = site + '/static/og-default.png?v=huakui-20261013';
    assert.equal(data.ogImage, url);
    const metadata = toNextMetadata(data);
    const images = [{ url, width: 1200, height: 630, type: 'image/png', alt: '花魁短剧' }];
    assert.deepEqual(metadata.openGraph?.images, images);
    assert.deepEqual(metadata.twitter?.images, images);
    assert.equal(metadata.twitter && 'card' in metadata.twitter ? metadata.twitter.card : undefined, 'summary_large_image');
  }
  assert.equal(imageURL(site, '/static/custom-og.png?v=1', bases), site + '/static/custom-og.png?v=1');
});

test('missing CDN configuration preserves site-root image paths independently of the page URL', () => {
  const data = enrichSEO(context('/play/story/'), { appConfig: config, playlet, chapter });
  assert.deepEqual(node(data, 'TVSeries')?.image, [site + '/' + cover]);
  assert.deepEqual(node(data, 'VideoObject')?.thumbnailUrl, [site + '/' + cover]);
  assert.equal(imageURL(site, '/' + cover), site + '/' + cover);
  assert.equal(imageURL(site, cover, { imageCDNs: bases }), cdn + cover);
});

test('empty or unsafe image values never become a homepage or fabricated structured image', () => {
  for (const value of ['', '  ', undefined, null, 'javascript:alert(1)', 'data:image/png;base64,AA==', 'blob:https://images.test/transient', '//unconfigured.images.test/cover.webp', 'https://user:password@images.test/cover.webp']) {
    assert.equal(imageURL(site, value, bases), '', String(value));
    const data = enrichSEO(context('/play/story/'), { appConfig: config, imageCDNs: bases, playlet: { ...playlet, cover: value }, chapter });
    assert.equal(node(data, 'TVSeries')?.image, undefined, String(value));
    assert.equal(node(data, 'TVSeries')?.thumbnailUrl, undefined, String(value));
    assert.equal(node(data, 'VideoObject'), undefined, String(value));
  }
});