meno-core 1.0.31 → 1.0.34

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx tsc:*)"
+    ]
+  }
+}

package/build-static.test.ts

@@ -0,0 +1,424 @@
+/**
+ * Tests for build-static.ts - Static Site Generation Build Script
+ *
+ * Tests pure/exported functions directly. Integration tests for buildStaticPages()
+ * require extensive mocking of the project context and are out of scope here.
+ */
+
+import { describe, test, expect, beforeEach, afterEach } from 'bun:test';
+import { existsSync, mkdirSync, rmSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import {
+  hashContent,
+  formatBunLog,
+  getLocalizedOutputPath,
+  getDisplayPath,
+  isCMSPage,
+  buildCMSItemPath,
+  injectTrackingScript,
+  generateRobotsTxt,
+  generateSitemap,
+} from './build-static';
+import type { JSONPage, CMSItem, I18nConfig } from './lib/shared/types';
+
+// ============================================================================
+// Test Helpers
+// ============================================================================
+
+const TEST_DIR = join(tmpdir(), `build-static-test-${Date.now()}`);
+
+function createTestDir(): string {
+  const dir = join(TEST_DIR, `sub-${Math.random().toString(36).slice(2, 8)}`);
+  mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+// ============================================================================
+// hashContent
+// ============================================================================
+
+describe('hashContent', () => {
+  test('returns an 8-character hex string', () => {
+    const result = hashContent('hello world');
+    expect(result).toMatch(/^[0-9a-f]{8}$/);
+  });
+
+  test('is deterministic', () => {
+    expect(hashContent('test')).toBe(hashContent('test'));
+  });
+
+  test('different inputs produce different hashes', () => {
+    expect(hashContent('input-a')).not.toBe(hashContent('input-b'));
+  });
+
+  test('handles empty string', () => {
+    const result = hashContent('');
+    expect(result).toMatch(/^[0-9a-f]{8}$/);
+  });
+
+  test('handles unicode content', () => {
+    const result = hashContent('こんにちは世界');
+    expect(result).toMatch(/^[0-9a-f]{8}$/);
+  });
+});
+
+// ============================================================================
+// formatBunLog
+// ============================================================================
+
+describe('formatBunLog', () => {
+  test('formats log with position info', () => {
+    const log = {
+      position: { file: 'src/app.ts', line: 42, column: 10, lineText: 'const x = y;' },
+      message: 'Variable not found'
+    };
+    const result = formatBunLog(log);
+    expect(result).toContain('File: src/app.ts');
+    expect(result).toContain('Line 42:10');
+    expect(result).toContain('const x = y;');
+    expect(result).toContain('Variable not found');
+  });
+
+  test('formats log with message only', () => {
+    const log = { message: 'Something went wrong' };
+    const result = formatBunLog(log);
+    expect(result).toBe('Something went wrong');
+  });
+
+  test('formats log with text property', () => {
+    const log = { text: 'Warning: deprecated function' };
+    const result = formatBunLog(log);
+    expect(result).toBe('Warning: deprecated function');
+  });
+
+  test('falls back to JSON.stringify when no extractable fields', () => {
+    const log = { custom: 'data', nested: { value: 1 } };
+    const result = formatBunLog(log);
+    expect(result).toContain('"custom"');
+    expect(result).toContain('"data"');
+  });
+
+  test('falls back to String() for non-serializable', () => {
+    const circular: any = {};
+    circular.self = circular;
+    // Should not throw
+    const result = formatBunLog(circular);
+    expect(typeof result).toBe('string');
+  });
+
+  test('handles position without lineText', () => {
+    const log = {
+      position: { file: 'index.ts', line: 1 },
+      message: 'Error'
+    };
+    const result = formatBunLog(log);
+    expect(result).toContain('File: index.ts');
+    expect(result).toContain('Line 1:0');
+    expect(result).toContain('Error');
+  });
+});
+
+// ============================================================================
+// getLocalizedOutputPath
+// ============================================================================
+
+describe('getLocalizedOutputPath', () => {
+  const dist = '/project/dist';
+
+  test('root path with default locale', () => {
+    expect(getLocalizedOutputPath('/', 'en', 'en', dist)).toBe('/project/dist/index.html');
+  });
+
+  test('nested path with default locale', () => {
+    expect(getLocalizedOutputPath('/about', 'en', 'en', dist)).toBe('/project/dist/about.html');
+  });
+
+  test('root path with non-default locale', () => {
+    expect(getLocalizedOutputPath('/', 'fr', 'en', dist)).toBe('/project/dist/fr/index.html');
+  });
+
+  test('nested path with non-default locale', () => {
+    expect(getLocalizedOutputPath('/about', 'fr', 'en', dist)).toBe('/project/dist/fr/about.html');
+  });
+
+  test('uses translated slug when available', () => {
+    const slugs = { en: 'about', fr: 'a-propos' };
+    expect(getLocalizedOutputPath('/about', 'fr', 'en', dist, slugs)).toBe('/project/dist/fr/a-propos.html');
+  });
+
+  test('translated slug for default locale', () => {
+    const slugs = { en: 'about-us', fr: 'a-propos' };
+    expect(getLocalizedOutputPath('/about', 'en', 'en', dist, slugs)).toBe('/project/dist/about-us.html');
+  });
+
+  test('falls back to base path when locale has no slug', () => {
+    const slugs = { en: 'about' };
+    expect(getLocalizedOutputPath('/about', 'de', 'en', dist, slugs)).toBe('/project/dist/de/about.html');
+  });
+
+  test('deep nested path with default locale', () => {
+    expect(getLocalizedOutputPath('/blog/post', 'en', 'en', dist)).toBe('/project/dist/blog/post.html');
+  });
+});
+
+// ============================================================================
+// getDisplayPath
+// ============================================================================
+
+describe('getDisplayPath', () => {
+  test('root path with default locale returns /', () => {
+    expect(getDisplayPath('/', 'en', 'en')).toBe('/');
+  });
+
+  test('nested path with default locale', () => {
+    expect(getDisplayPath('/about', 'en', 'en')).toBe('/about');
+  });
+
+  test('root path with non-default locale', () => {
+    expect(getDisplayPath('/', 'fr', 'en')).toBe('/fr');
+  });
+
+  test('nested path with non-default locale', () => {
+    expect(getDisplayPath('/about', 'fr', 'en')).toBe('/fr/about');
+  });
+
+  test('uses translated slug', () => {
+    const slugs = { en: 'about', fr: 'a-propos' };
+    expect(getDisplayPath('/about', 'fr', 'en', slugs)).toBe('/fr/a-propos');
+  });
+
+  test('translated slug for default locale', () => {
+    const slugs = { en: 'about-us', fr: 'a-propos' };
+    expect(getDisplayPath('/about', 'en', 'en', slugs)).toBe('/about-us');
+  });
+
+  test('falls back to base path when slug missing for locale', () => {
+    const slugs = { en: 'about' };
+    expect(getDisplayPath('/about', 'de', 'en', slugs)).toBe('/de/about');
+  });
+});
+
+// ============================================================================
+// isCMSPage
+// ============================================================================
+
+describe('isCMSPage', () => {
+  test('returns true when source is cms and cms config exists', () => {
+    const page = {
+      meta: {
+        source: 'cms',
+        cms: { id: 'blog', urlPattern: '/blog/{{slug}}', slugField: 'slug' }
+      },
+      nodes: []
+    } as unknown as JSONPage;
+    expect(isCMSPage(page)).toBe(true);
+  });
+
+  test('returns false when source is not cms', () => {
+    const page = {
+      meta: { title: 'About' },
+      nodes: []
+    } as unknown as JSONPage;
+    expect(isCMSPage(page)).toBe(false);
+  });
+
+  test('returns false when source is cms but cms config is missing', () => {
+    const page = {
+      meta: { source: 'cms' },
+      nodes: []
+    } as unknown as JSONPage;
+    expect(isCMSPage(page)).toBe(false);
+  });
+
+  test('returns false when meta is missing', () => {
+    const page = { nodes: [] } as unknown as JSONPage;
+    expect(isCMSPage(page)).toBe(false);
+  });
+
+  test('returns false when meta is undefined', () => {
+    const page = { meta: undefined, nodes: [] } as unknown as JSONPage;
+    expect(isCMSPage(page)).toBe(false);
+  });
+});
+
+// ============================================================================
+// buildCMSItemPath
+// ============================================================================
+
+describe('buildCMSItemPath', () => {
+  const defaultI18nConfig: I18nConfig = {
+    defaultLocale: 'en',
+    locales: [{ code: 'en', name: 'English' }, { code: 'fr', name: 'French' }]
+  };
+
+  test('replaces {{slug}} with item slug field', () => {
+    const item: CMSItem = { _id: '1', _slug: 'my-post', title: 'My Post' };
+    const result = buildCMSItemPath('/blog/{{slug}}', item, '_slug', 'en', defaultI18nConfig);
+    expect(result).toBe('/blog/my-post');
+  });
+
+  test('uses specified slugField', () => {
+    const item: CMSItem = { _id: '1', _slug: 'fallback', customSlug: 'custom-value', title: 'Test' };
+    const result = buildCMSItemPath('/posts/{{slug}}', item, 'customSlug', 'en', defaultI18nConfig);
+    expect(result).toBe('/posts/custom-value');
+  });
+
+  test('falls back to _slug when slugField is missing', () => {
+    const item: CMSItem = { _id: '1', _slug: 'fallback-slug', title: 'Test' };
+    const result = buildCMSItemPath('/posts/{{slug}}', item, 'nonexistent', 'en', defaultI18nConfig);
+    expect(result).toBe('/posts/fallback-slug');
+  });
+
+  test('falls back to _id when both slugField and _slug are missing', () => {
+    const item: CMSItem = { _id: 'abc123', title: 'Test' };
+    const result = buildCMSItemPath('/items/{{slug}}', item, 'missing', 'en', defaultI18nConfig);
+    expect(result).toBe('/items/abc123');
+  });
+
+  test('handles i18n slug values', () => {
+    const item: CMSItem = {
+      _id: '1',
+      _slug: { _i18n: true, en: 'hello', fr: 'bonjour' },
+      title: 'Test'
+    };
+    const result = buildCMSItemPath('/page/{{slug}}', item, '_slug', 'fr', defaultI18nConfig);
+    expect(result).toBe('/page/bonjour');
+  });
+
+  test('resolves i18n slug for default locale', () => {
+    const item: CMSItem = {
+      _id: '1',
+      _slug: { _i18n: true, en: 'hello', fr: 'bonjour' },
+      title: 'Test'
+    };
+    const result = buildCMSItemPath('/page/{{slug}}', item, '_slug', 'en', defaultI18nConfig);
+    expect(result).toBe('/page/hello');
+  });
+
+  test('handles numeric slug values', () => {
+    const item: CMSItem = { _id: '42', title: 'Test' };
+    const result = buildCMSItemPath('/item/{{slug}}', item, '_id', 'en', defaultI18nConfig);
+    expect(result).toBe('/item/42');
+  });
+});
+
+// ============================================================================
+// injectTrackingScript
+// ============================================================================
+
+describe('injectTrackingScript', () => {
+  test('injects script before </head>', () => {
+    const html = '<html><head><title>Test</title></head><body></body></html>';
+    const script = 'console.log("tracking")';
+    const result = injectTrackingScript(html, script);
+    expect(result).toContain('<script>console.log("tracking")</script>\n</head>');
+  });
+
+  test('preserves existing head content', () => {
+    const html = '<html><head><meta charset="utf-8"><link rel="stylesheet" href="style.css"></head><body></body></html>';
+    const script = 'track()';
+    const result = injectTrackingScript(html, script);
+    expect(result).toContain('<meta charset="utf-8">');
+    expect(result).toContain('<link rel="stylesheet" href="style.css">');
+    expect(result).toContain('<script>track()</script>');
+  });
+
+  test('returns original html if no </head> tag', () => {
+    const html = '<html><body>no head</body></html>';
+    const script = 'track()';
+    const result = injectTrackingScript(html, script);
+    expect(result).toBe(html);
+  });
+});
+
+// ============================================================================
+// generateRobotsTxt
+// ============================================================================
+
+describe('generateRobotsTxt', () => {
+  test('generates robots.txt with correct content', async () => {
+    const dir = createTestDir();
+    await generateRobotsTxt('https://example.com', dir);
+
+    const content = readFileSync(join(dir, 'robots.txt'), 'utf-8');
+    expect(content).toContain('User-agent: *');
+    expect(content).toContain('Allow: /');
+    expect(content).toContain('Sitemap: https://example.com/sitemap.xml');
+  });
+
+  test('uses provided siteUrl in sitemap reference', async () => {
+    const dir = createTestDir();
+    await generateRobotsTxt('https://mysite.dev', dir);
+
+    const content = readFileSync(join(dir, 'robots.txt'), 'utf-8');
+    expect(content).toContain('Sitemap: https://mysite.dev/sitemap.xml');
+  });
+});
+
+// ============================================================================
+// generateSitemap
+// ============================================================================
+
+describe('generateSitemap', () => {
+  test('generates valid XML sitemap', async () => {
+    const dir = createTestDir();
+    const urls = ['/', '/about', '/contact'];
+    await generateSitemap(urls, 'https://example.com', dir);
+
+    const content = readFileSync(join(dir, 'sitemap.xml'), 'utf-8');
+    expect(content).toContain('<?xml version="1.0" encoding="UTF-8"?>');
+    expect(content).toContain('<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">');
+    expect(content).toContain('<url><loc>https://example.com/</loc></url>');
+    expect(content).toContain('<url><loc>https://example.com/about</loc></url>');
+    expect(content).toContain('<url><loc>https://example.com/contact</loc></url>');
+  });
+
+  test('sorts URLs for deterministic output', async () => {
+    const dir = createTestDir();
+    const urls = ['/z-page', '/a-page', '/m-page'];
+    await generateSitemap(urls, 'https://example.com', dir);
+
+    const content = readFileSync(join(dir, 'sitemap.xml'), 'utf-8');
+    const aIdx = content.indexOf('/a-page');
+    const mIdx = content.indexOf('/m-page');
+    const zIdx = content.indexOf('/z-page');
+    expect(aIdx).toBeLessThan(mIdx);
+    expect(mIdx).toBeLessThan(zIdx);
+  });
+
+  test('handles empty URL list', async () => {
+    const dir = createTestDir();
+    await generateSitemap([], 'https://example.com', dir);
+
+    const content = readFileSync(join(dir, 'sitemap.xml'), 'utf-8');
+    expect(content).toContain('<urlset');
+    expect(content).toContain('</urlset>');
+    // No <url> entries
+    expect(content).not.toContain('<url>');
+  });
+
+  test('handles single URL', async () => {
+    const dir = createTestDir();
+    await generateSitemap(['/'], 'https://example.com', dir);
+
+    const content = readFileSync(join(dir, 'sitemap.xml'), 'utf-8');
+    expect(content).toContain('<url><loc>https://example.com/</loc></url>');
+  });
+
+  test('does not mutate input array', async () => {
+    const dir = createTestDir();
+    const urls = ['/c', '/a', '/b'];
+    const original = [...urls];
+    await generateSitemap(urls, 'https://example.com', dir);
+    expect(urls).toEqual(original);
+  });
+});
+
+// ============================================================================
+// Cleanup
+// ============================================================================
+
+afterEach(() => {
+  // Cleanup is done per-test via createTestDir
+});