@hagicode/hagilight 0.3.1 → 0.3.2-dev.57.1.ee1f17e

package/integration.mjs

@@ -1,191 +0,0 @@
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, extname, isAbsolute, resolve, win32 } from 'node:path';
-import { resolveRssLocales } from './rss-locales.mjs';
-
-export const HAGILIGHT_RSS_OWNER = Symbol.for('@hagicode/hagilight/rss-owner');
-const VIRTUAL_RSS_CONFIG = 'virtual:hagilight/rss-config';
-const VIRTUAL_RSS_CONFIG_RESOLVED = `\0${VIRTUAL_RSS_CONFIG}`;
-const RSS_OWNER_REGISTRY = Symbol.for('@hagicode/hagilight/rss-owner-registry');
-const PAGE_SOURCE_EXTENSIONS = new Set(['.astro', '.html', '.js', '.jsx', '.md', '.mdx', '.ts', '.tsx']);
-const registeredRssOwners = globalThis[RSS_OWNER_REGISTRY] ?? new Map();
-globalThis[RSS_OWNER_REGISTRY] = registeredRssOwners;
-
-export function registerStarlightRssOwner(enabled) {
-  const token = Symbol('starlight-rss-owner');
-  registeredRssOwners.set(token, { package: 'starlight', enabled });
-  return () => registeredRssOwners.delete(token);
-}
-
-function resolveOptions(options) {
-  if (!options || typeof options !== 'object' || Array.isArray(options)) {
-    throw new TypeError('Hagilight RSS integration options must be an object.');
-  }
-  const locales = resolveRssLocales(options.locales, { requireNonEmpty: true });
-  if (typeof options.getFeed !== 'string' || !options.getFeed.trim()) {
-    throw new TypeError('Hagilight RSS getFeed must be a non-empty module path such as "./src/rss-feed.mjs".');
-  }
-  return { locales, getFeed: options.getFeed.trim() };
-}
-
-function resolveSite(site) {
-  let parsed;
-  try {
-    parsed = new URL(site);
-  } catch {
-    throw new Error('Hagilight RSS requires an absolute Astro site URL. Set `site` in astro.config.mjs.');
-  }
-  if (!['http:', 'https:'].includes(parsed.protocol) || parsed.username || parsed.password) {
-    throw new Error('Hagilight RSS requires an absolute HTTP(S) Astro site URL.');
-  }
-  return parsed.href;
-}
-
-function resolveFeedModule(root, reference) {
-  if (reference.startsWith('file:') || isAbsolute(reference) || win32.isAbsolute(reference)) {
-    throw new TypeError('Hagilight RSS getFeed must be a path relative to the Astro project root.');
-  }
-  const rootPath = fileURLToPath(root);
-  const modulePath = resolve(rootPath, reference);
-  if (!existsSync(modulePath) || !statSync(modulePath).isFile()) {
-    throw new Error(`Hagilight RSS getFeed module "${reference}" was not found relative to the Astro project root.`);
-  }
-  return modulePath;
-}
-
-function routeCollisions(config, locales) {
-  const expectedFiles = new Set(['rss.xml', 'rss.en.xml', ...locales.map(({ filename }) => `rss.${filename}.xml`)]);
-  const pageRoot = resolve(fileURLToPath(config.srcDir), 'pages');
-  const publicRoot = fileURLToPath(config.publicDir);
-  const collisions = [];
-
-  function findPageCollisions(directory) {
-    if (!existsSync(directory)) return;
-    for (const entry of readdirSync(directory, { withFileTypes: true })) {
-      const entryPath = resolve(directory, entry.name);
-      if (entry.isDirectory()) {
-        if (entry.name === 'rss.xml' || /^rss\..+\.xml$/u.test(entry.name)) {
-          for (const child of readdirSync(entryPath, { withFileTypes: true })) {
-            if (child.isFile()
-              && child.name.startsWith('index.')
-              && PAGE_SOURCE_EXTENSIONS.has(extname(child.name))) {
-              collisions.push(resolve(entryPath, child.name));
-            }
-          }
-        }
-        findPageCollisions(entryPath);
-      } else if (entry.isFile()) {
-        const extension = extname(entry.name);
-        if (!PAGE_SOURCE_EXTENSIONS.has(extension)) continue;
-        const sourceName = entry.name.slice(0, -extension.length);
-        if (expectedFiles.has(sourceName) || /^rss\..+\.xml$/u.test(sourceName)) {
-          collisions.push(entryPath);
-        }
-      }
-    }
-  }
-  findPageCollisions(pageRoot);
-
-  for (const filename of expectedFiles) {
-    const publicFile = resolve(publicRoot, filename);
-    if (existsSync(publicFile) && statSync(publicFile).isFile()) collisions.push(publicFile);
-  }
-
-  if (collisions.length > 0) {
-    throw new Error(`Hagilight RSS route conflicts with consumer-owned file(s): ${collisions.join(', ')}. Remove the conflicting route or do not enable hagilightRss().`);
-  }
-}
-
-function findStarlightRss(config) {
-  const registeredOwners = [...registeredRssOwners.values()];
-  const owners = registeredOwners.length > 0
-    ? registeredOwners
-    : (config.integrations ?? [])
-    .map((integration) => integration?.[HAGILIGHT_RSS_OWNER])
-    .filter((owner) => owner?.package === 'starlight');
-  registeredRssOwners.clear();
-  return owners;
-}
-
-function createVirtualPlugin({ modulePath, site, baseUrl, locales, defaultFeedUrl, localeFeedUrls }) {
-  return {
-    name: '@hagicode/hagilight:rss',
-    resolveId(id) {
-      return id === VIRTUAL_RSS_CONFIG ? VIRTUAL_RSS_CONFIG_RESOLVED : null;
-    },
-    load(id) {
-      if (id !== VIRTUAL_RSS_CONFIG_RESOLVED) return null;
-      return [
-        `import * as siteFeedModule from ${JSON.stringify(modulePath)};`,
-        'const config = {',
-        `  site: ${JSON.stringify(site)},`,
-        `  baseUrl: ${JSON.stringify(baseUrl)},`,
-        `  locales: ${JSON.stringify(locales)},`,
-        '  getFeed: siteFeedModule.default,',
-        `  footer: ${JSON.stringify({ defaultFeedUrl, localeFeedUrls, locales })},`,
-        '};',
-        'export default config;',
-      ].join('\n');
-    },
-  };
-}
-
-export function hagilightRss(input) {
-  const options = resolveOptions(input);
-
-  return {
-    name: '@hagicode/hagilight:rss',
-    [HAGILIGHT_RSS_OWNER]: { package: 'core', enabled: true },
-    hooks: {
-      'astro:config:setup'({ config, injectRoute, addMiddleware, updateConfig }) {
-        const starlightOwners = findStarlightRss(config);
-        const activeStarlightOwners = starlightOwners.filter((owner) => owner.enabled);
-        if (activeStarlightOwners.length > 1) {
-          throw new Error('Hagilight RSS cannot determine a sole route owner because multiple Starlight RSS integrations are enabled.');
-        }
-        if (activeStarlightOwners.length > 0) return;
-        if (starlightOwners.length > 0) {
-          throw new Error('Hagilight RSS cannot establish route ownership: Starlight RSS is explicitly disabled while hagilightRss() requests feed generation. Enable Starlight RSS or remove hagilightRss().');
-        }
-
-        const site = resolveSite(config.site);
-        const modulePath = resolveFeedModule(config.root, options.getFeed);
-        routeCollisions(config, options.locales);
-        const baseSegments = `${config.base || '/'}`
-          .split('/')
-          .filter(Boolean);
-        const baseUrl = baseSegments.length > 0 ? `/${baseSegments.join('/')}/` : '/';
-        const baseLocation = new URL(baseUrl, site);
-        const defaultFeedUrl = new URL('rss.xml', baseLocation).href;
-        const localeFeedUrls = Object.fromEntries(options.locales
-          .filter(({ filename }) => filename !== 'en')
-          .map(({ lang, filename }) => [lang, new URL(`rss.${filename}.xml`, baseLocation).href]));
-        const rssIntegrationPath = dirname(fileURLToPath(import.meta.url));
-        const plugin = createVirtualPlugin({
-          modulePath,
-          site,
-          baseUrl,
-          locales: options.locales,
-          defaultFeedUrl,
-          localeFeedUrls,
-        });
-
-        injectRoute({
-          pattern: '/rss.xml',
-          entrypoint: resolve(rssIntegrationPath, './rss.xml.ts'),
-          prerender: true,
-        });
-        injectRoute({
-          pattern: '/rss.[language].xml',
-          entrypoint: resolve(rssIntegrationPath, './rss.[language].xml.ts'),
-          prerender: true,
-        });
-        addMiddleware({
-          entrypoint: resolve(rssIntegrationPath, './rss-middleware.mjs'),
-          order: 'pre',
-        });
-        updateConfig({ vite: { plugins: [plugin] } });
-      },
-    },
-  };
-}

package/promotions.ts

@@ -1,263 +0,0 @@
-const INDEX_ORIGIN = 'https://index.hagicode.com';
-const CATALOG_URL = `${INDEX_ORIGIN}/index-catalog.json`;
-const FLAGS_URL = `${INDEX_ORIGIN}/promote.json`;
-const CONTENT_URL = `${INDEX_ORIGIN}/promote_content.json`;
-
-type JsonRecord = Record<string, unknown>;
-type FetchLike = typeof fetch;
-
-export interface PromotionImage {
-  src: string;
-  alt: string;
-  variant?: string;
-  width?: number;
-  height?: number;
-}
-
-export interface PromotionCard {
-  id: string;
-  title: string;
-  description: string;
-  ctaLabel: string;
-  link: string;
-  image?: PromotionImage;
-}
-
-interface PromotionFlag {
-  id: string;
-  on: boolean;
-  startTime?: string;
-  endTime?: string;
-}
-
-interface PromotionContent {
-  id: string;
-  title: Record<string, string>;
-  description: Record<string, string>;
-  cta?: Record<string, string>;
-  link: string;
-  image?: PromotionImage;
-}
-
-function isRecord(value: unknown): value is JsonRecord {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function nonEmptyString(value: unknown): value is string {
-  return typeof value === 'string' && value.trim().length > 0;
-}
-
-function parseLocalizedMap(value: unknown): Record<string, string> | null {
-  if (!isRecord(value)) return null;
-  const entries = Object.entries(value).filter(
-    (entry): entry is [string, string] => nonEmptyString(entry[0]) && nonEmptyString(entry[1]),
-  );
-  return entries.length ? Object.fromEntries(entries.map(([key, text]) => [key.trim(), text.trim()])) : null;
-}
-
-function parseImage(value: unknown, record: JsonRecord): PromotionImage | undefined {
-  const image = isRecord(value) ? value : {};
-  const src = nonEmptyString(value)
-    ? value.trim()
-    : nonEmptyString(image.src)
-      ? image.src.trim()
-      : nonEmptyString(image.url)
-        ? image.url.trim()
-        : nonEmptyString(record.imageUrl)
-          ? record.imageUrl.trim()
-          : nonEmptyString(record.imageURL)
-            ? record.imageURL.trim()
-            : '';
-  if (!src) return undefined;
-
-  const width = typeof image.width === 'number' && Number.isFinite(image.width) && image.width > 0
-    ? Math.round(image.width)
-    : undefined;
-  const height = typeof image.height === 'number' && Number.isFinite(image.height) && image.height > 0
-    ? Math.round(image.height)
-    : undefined;
-
-  let normalizedSrc: string;
-  try {
-    const url = new URL(src, INDEX_ORIGIN);
-    if (!['http:', 'https:'].includes(url.protocol)) return undefined;
-    normalizedSrc = url.toString();
-  } catch {
-    return undefined;
-  }
-
-  return {
-    src: normalizedSrc,
-    alt: nonEmptyString(image.alt)
-      ? image.alt.trim()
-      : nonEmptyString(record.imageAlt)
-        ? record.imageAlt.trim()
-        : '',
-    variant: nonEmptyString(image.variant) ? image.variant.trim() : undefined,
-    width,
-    height,
-  };
-}
-
-function isSafeLink(value: string): boolean {
-  try {
-    return ['http:', 'https:'].includes(new URL(value, INDEX_ORIGIN).protocol);
-  } catch {
-    return false;
-  }
-}
-
-export function parsePromotionFlags(payload: unknown): PromotionFlag[] {
-  if (!isRecord(payload) || !Array.isArray(payload.promotes)) return [];
-  return payload.promotes.flatMap((item): PromotionFlag[] => {
-    if (!isRecord(item) || !nonEmptyString(item.id) || typeof item.on !== 'boolean') return [];
-    return [{
-      id: item.id.trim(),
-      on: item.on,
-      startTime: nonEmptyString(item.startTime) ? item.startTime.trim() : undefined,
-      endTime: nonEmptyString(item.endTime) ? item.endTime.trim() : undefined,
-    }];
-  });
-}
-
-export function parsePromotionContent(payload: unknown): PromotionContent[] {
-  if (!isRecord(payload) || !Array.isArray(payload.contents)) return [];
-  return payload.contents.flatMap((item): PromotionContent[] => {
-    if (!isRecord(item) || !nonEmptyString(item.id) || !nonEmptyString(item.link) || !isSafeLink(item.link)) {
-      return [];
-    }
-    const title = parseLocalizedMap(item.title);
-    const description = parseLocalizedMap(item.description);
-    if (!title || !description) return [];
-    const cta = parseLocalizedMap(item.cta);
-    const image = parseImage(item.image, item);
-    return [{
-      id: item.id.trim(),
-      title,
-      description,
-      cta: cta ?? undefined,
-      link: item.link.trim(),
-      image,
-    }];
-  });
-}
-
-function localeCandidates(locale: string | null | undefined): string[] {
-  let canonical = 'en-US';
-  if (locale?.trim()) {
-    try {
-      canonical = Intl.getCanonicalLocales(locale.trim().replace(/_/g, '-'))[0] ?? 'en-US';
-    } catch {
-      canonical = 'en-US';
-    }
-  }
-  const normalized = canonical.toLowerCase();
-  const candidates = [normalized, normalized.split('-')[0] ?? normalized];
-  if (normalized.startsWith('zh-hant') || ['zh-tw', 'zh-hk', 'zh-mo'].includes(normalized)) {
-    candidates.push('zh-hant', 'zh-cn', 'zh');
-  } else if (normalized.startsWith('zh')) {
-    candidates.push('zh-cn', 'zh-hant', 'zh');
-  }
-  candidates.push('en-us', 'en');
-  return [...new Set(candidates)];
-}
-
-function localized(value: Record<string, string>, locale: string | null | undefined): string | null {
-  const values = new Map(Object.entries(value).map(([key, text]) => [key.toLowerCase(), text]));
-  for (const candidate of localeCandidates(locale)) {
-    const result = values.get(candidate);
-    if (result) return result;
-  }
-  return Object.values(value)[0] ?? null;
-}
-
-function isActive(flag: PromotionFlag, now: number): boolean {
-  if (!flag.on) return false;
-  const start = flag.startTime ? Date.parse(flag.startTime) : null;
-  const end = flag.endTime ? Date.parse(flag.endTime) : null;
-  if ((start !== null && !Number.isFinite(start)) || (end !== null && !Number.isFinite(end))) return false;
-  if (start !== null && end !== null && start >= end) return false;
-  return (start === null || now >= start) && (end === null || now < end);
-}
-
-export function normalizeActivePromotions(
-  flags: PromotionFlag[],
-  content: PromotionContent[],
-  locale?: string | null,
-  now = Date.now(),
-): PromotionCard[] {
-  const contentById = new Map(content.map((item) => [item.id, item]));
-  return flags.flatMap((flag): PromotionCard[] => {
-    const item = contentById.get(flag.id);
-    if (!isActive(flag, now) || !item) return [];
-    const title = localized(item.title, locale);
-    const description = localized(item.description, locale);
-    if (!title || !description) return [];
-    return [{
-      id: item.id,
-      title,
-      description,
-      ctaLabel: (item.cta && localized(item.cta, locale)) || 'Learn more',
-      link: item.link,
-      image: item.image ? { ...item.image, alt: item.image.alt || title } : undefined,
-    }];
-  });
-}
-
-async function readJson(fetchImpl: FetchLike, url: string): Promise<unknown> {
-  const response = await fetchImpl(url, { headers: { accept: 'application/json' }, cache: 'no-store' });
-  if (!response.ok) throw new Error(`Failed to load promotion data (${response.status})`);
-  const contentType = response.headers.get('content-type')?.toLowerCase() ?? '';
-  if (!contentType.includes('json')) throw new Error(`Expected JSON promotion data, received ${contentType || 'no content type'}`);
-  return response.json();
-}
-
-export async function resolvePromotionDocumentUrls(fetchImpl: FetchLike = fetch): Promise<{
-  flagsUrl: string;
-  contentUrl: string;
-  source: 'catalog' | 'fallback';
-}> {
-  try {
-    const catalog = await readJson(fetchImpl, CATALOG_URL);
-    if (isRecord(catalog) && Array.isArray(catalog.entries)) {
-      const entries = catalog.entries.filter(isRecord);
-      const flags = entries.find((entry) => entry.id === 'promotion-flags' && nonEmptyString(entry.path));
-      const content = entries.find((entry) => entry.id === 'promotion-content' && nonEmptyString(entry.path));
-      const flagsPath = flags?.path;
-      const contentPath = content?.path;
-      if (nonEmptyString(flagsPath) && nonEmptyString(contentPath)) {
-        const flagsUrl = new URL(flagsPath, INDEX_ORIGIN);
-        const contentUrl = new URL(contentPath, INDEX_ORIGIN);
-        if (flagsUrl.origin !== INDEX_ORIGIN || contentUrl.origin !== INDEX_ORIGIN) {
-          return { flagsUrl: FLAGS_URL, contentUrl: CONTENT_URL, source: 'fallback' };
-        }
-        return {
-          flagsUrl: flagsUrl.toString(),
-          contentUrl: contentUrl.toString(),
-          source: 'catalog',
-        };
-      }
-    }
-  } catch {
-    // The stable canonical endpoints remain available when catalog discovery fails.
-  }
-  return { flagsUrl: FLAGS_URL, contentUrl: CONTENT_URL, source: 'fallback' };
-}
-
-export async function loadActivePromotions(options: {
-  locale?: string | null;
-  fetchImpl?: FetchLike;
-  now?: number;
-} = {}): Promise<PromotionCard[]> {
-  const { locale, fetchImpl = fetch, now = Date.now() } = options;
-  try {
-    const urls = await resolvePromotionDocumentUrls(fetchImpl);
-    const [flags, content] = await Promise.all([
-      readJson(fetchImpl, urls.flagsUrl),
-      readJson(fetchImpl, urls.contentUrl),
-    ]);
-    return normalizeActivePromotions(parsePromotionFlags(flags), parsePromotionContent(content), locale, now);
-  } catch {
-    return [];
-  }
-}