@geenius/seo 0.1.0 → 0.3.0

package/packages/react-css/src/pages/SEOAdminPage.tsx

@@ -1,88 +0,0 @@
-import { useState } from 'react'
-import { useSEOAdmin } from '@geenius-seo/react'
-import { MetaEditor } from '../components/MetaEditor'
-import { SEOPreview } from '../components/SEOPreview'
-import { SEOScoreCard } from '../components/SEOScoreCard'
-import type { SEOMeta } from '@geenius-seo/shared'
-
-export function SEOAdminPage() {
-  const { pages, upsertMeta, deleteMeta, isLoading } = useSEOAdmin()
-  const [selectedPath, setSelectedPath] = useState<string | null>(null)
-  const [editingMeta, setEditingMeta] = useState<SEOMeta | null>(null)
-
-  const currentPage = pages.find((p) => p.path === selectedPath)
-
-  const handleSave = async () => {
-    if (selectedPath && editingMeta) {
-      await upsertMeta(selectedPath, editingMeta)
-      setEditingMeta(null)
-    }
-  }
-
-  const handleDelete = async () => {
-    if (selectedPath) {
-      await deleteMeta(selectedPath)
-      setSelectedPath(null)
-      setEditingMeta(null)
-    }
-  }
-
-  if (isLoading) return <div style={{ padding: '1rem' }}>Loading...</div>
-
-  return (
-    <div className="seo__admin-container">
-      <h1 className="seo__admin-title">SEO Admin</h1>
-
-      <div className="seo__admin-grid">
-        <div className="seo__admin-sidebar">
-          <div className="seo__admin-sidebar-title">Pages</div>
-          <div className="seo__admin-page-list">
-            {pages.map((page) => (
-              <button
-                key={page.path}
-                onClick={() => {
-                  setSelectedPath(page.path)
-                  setEditingMeta(page.meta)
-                }}
-                className={`seo__admin-page-button ${
-                  selectedPath === page.path ? 'seo__admin-page-button--active' : ''
-                }`}
-              >
-                {page.path || '/'}
-              </button>
-            ))}
-          </div>
-        </div>
-
-        {currentPage && editingMeta && (
-          <div className="seo__admin-editor">
-            <div>
-              <h2 style={{ fontWeight: 600, marginBottom: '1rem' }}>Edit Metadata</h2>
-              <MetaEditor meta={editingMeta} onChange={setEditingMeta} />
-            </div>
-
-            <div className="seo__space-y">
-              <div>
-                <h2 style={{ fontWeight: 600, marginBottom: '1rem' }}>Preview</h2>
-                <SEOPreview meta={editingMeta} />
-              </div>
-
-              <SEOScoreCard meta={editingMeta} />
-            </div>
-          </div>
-        )}
-      </div>
-
-      {currentPage && editingMeta && (
-        <div className="seo__admin-actions">
-          <button onClick={handleSave} className="seo__button seo__button--success">
-            Save
-          </button>
-          <button onClick={handleDelete} className="seo__button seo__button--danger">
-            Delete
-          </button>
-        </div>
-      )}
-    </div>
-  )
-}

package/packages/react-css/src/pages/SEOAnalyticsPage.tsx

@@ -1,82 +0,0 @@
-import { useState, useEffect } from 'react'
-
-interface AnalyticsSummary {
-  path: string
-  views: number
-  avgTimeOnPage: number
-  bounceRate: number
-}
-
-export function SEOAnalyticsPage() {
-  const [topPages, setTopPages] = useState<AnalyticsSummary[]>([])
-  const [isLoading, setIsLoading] = useState(false)
-
-  useEffect(() => {
-    setIsLoading(true)
-    setIsLoading(false)
-  }, [])
-
-  const totalViews = topPages.reduce((sum, p) => sum + p.views, 0)
-  const avgTimeOnPage =
-    topPages.length > 0
-      ? topPages.reduce((sum, p) => sum + p.avgTimeOnPage, 0) / topPages.length
-      : 0
-  const avgBounceRate =
-    topPages.length > 0
-      ? (topPages.reduce((sum, p) => sum + p.bounceRate, 0) / topPages.length) * 100
-      : 0
-
-  if (isLoading) return <div style={{ padding: '1rem' }}>Loading...</div>
-
-  return (
-    <div className="seo__analytics-container">
-      <h1 className="seo__analytics-title">SEO Analytics</h1>
-
-      <div className="seo__analytics-table-wrapper">
-        <table className="seo__sitemap-table">
-          <thead className="seo__sitemap-table-head">
-            <tr>
-              <th className="seo__sitemap-table-header">Page</th>
-              <th className="seo__sitemap-table-header">Views</th>
-              <th className="seo__sitemap-table-header">Avg Time (s)</th>
-              <th className="seo__sitemap-table-header">Bounce Rate</th>
-            </tr>
-          </thead>
-          <tbody>
-            {topPages.map((page, i) => (
-              <tr key={i} className="seo__sitemap-row">
-                <td className="seo__sitemap-cell">{page.path}</td>
-                <td className="seo__sitemap-cell">{page.views.toLocaleString()}</td>
-                <td className="seo__sitemap-cell">{page.avgTimeOnPage.toFixed(1)}</td>
-                <td className="seo__sitemap-cell">{(page.bounceRate * 100).toFixed(1)}%</td>
-              </tr>
-            ))}
-          </tbody>
-        </table>
-      </div>
-
-      {topPages.length === 0 && (
-        <p style={{ textAlign: 'center', color: 'var(--seo-text-muted)', padding: '2rem' }}>
-          No analytics data available
-        </p>
-      )}
-
-      <div className="seo__analytics-summary">
-        <div className="seo__analytics-card">
-          <div className="seo__analytics-card-label">Total Views</div>
-          <div className="seo__analytics-card-value">{totalViews.toLocaleString()}</div>
-        </div>
-
-        <div className="seo__analytics-card">
-          <div className="seo__analytics-card-label">Average Time on Page</div>
-          <div className="seo__analytics-card-value">{avgTimeOnPage.toFixed(1)}s</div>
-        </div>
-
-        <div className="seo__analytics-card">
-          <div className="seo__analytics-card-label">Average Bounce Rate</div>
-          <div className="seo__analytics-card-value">{avgBounceRate.toFixed(1)}%</div>
-        </div>
-      </div>
-    </div>
-  )
-}

package/packages/react-css/src/pages/index.ts

@@ -1,2 +0,0 @@
-export * from './SEOAdminPage'
-export * from './SEOAnalyticsPage'

package/packages/react-css/tsup.config.ts

@@ -1,2 +0,0 @@
-import { defineConfig } from 'tsup'
-export default defineConfig({ entry: ['src/index.ts'], format: ['cjs', 'esm'], dts: true, clean: true, sourcemap: true, external: ['react'] })

package/packages/shared/package.json

@@ -1,42 +0,0 @@
-{
-  "name": "@geenius-seo/shared",
-  "version": "0.1.0",
-  "private": false,
-  "type": "module",
-  "description": "Geenius Seo \u2014 Shared types & Convex schema",
-  "author": "Antigravity HQ",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "clean": "rm -rf dist",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "pnpm clean && pnpm build",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
-  },
-  "devDependencies": {
-    "tsup": "^8.5.1",
-    "typescript": "~6.0.2",
-    "vitest": "^4.0.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}

package/packages/shared/src/__tests__/seo.test.ts

@@ -1,70 +0,0 @@
-import { describe, it, expect } from 'vitest'
-import { buildTitle, truncateDescription, articleSchema } from '../index'
-
-describe('buildTitle', () => {
-  it('joins page title and site name with separator', () => {
-    expect(buildTitle('Home', 'Geenius')).toBe('Home | Geenius')
-  })
-
-  it('allows custom separator', () => {
-    expect(buildTitle('Blog', 'Geenius', ' — ')).toBe('Blog — Geenius')
-  })
-
-  it('handles empty page title', () => {
-    expect(buildTitle('', 'Geenius')).toBe(' | Geenius')
-  })
-})
-
-describe('truncateDescription', () => {
-  it('returns short descriptions unchanged', () => {
-    const short = 'A brief description.'
-    expect(truncateDescription(short)).toBe(short)
-  })
-
-  it('truncates to 160 chars by default', () => {
-    const long = 'x'.repeat(200)
-    const result = truncateDescription(long)
-    expect(result.length).toBe(160)
-    expect(result.endsWith('...')).toBe(true)
-  })
-
-  it('respects custom max length', () => {
-    const text = 'x'.repeat(100)
-    const result = truncateDescription(text, 50)
-    expect(result.length).toBe(50)
-    expect(result.endsWith('...')).toBe(true)
-  })
-
-  it('returns exact-length descriptions unchanged', () => {
-    const exact = 'x'.repeat(160)
-    expect(truncateDescription(exact)).toBe(exact)
-  })
-})
-
-describe('articleSchema', () => {
-  it('generates valid JSON-LD structure', () => {
-    const schema = articleSchema({
-      title: 'Test Article',
-      description: 'A test article',
-      author: 'Author',
-      datePublished: '2024-01-01',
-      url: 'https://example.com/test',
-    })
-    expect(schema['@context']).toBe('https://schema.org')
-    expect(schema['@type']).toBe('Article')
-    expect(schema.title).toBe('Test Article')
-    expect(schema.author).toBe('Author')
-  })
-
-  it('includes optional image when provided', () => {
-    const schema = articleSchema({
-      title: 'Test',
-      description: 'Desc',
-      author: 'Author',
-      datePublished: '2024-01-01',
-      url: 'https://example.com',
-      image: 'https://example.com/img.jpg',
-    })
-    expect(schema.image).toBe('https://example.com/img.jpg')
-  })
-})

package/packages/shared/src/config.ts

@@ -1,297 +0,0 @@
-/**
- * SEO configuration and utilities
- */
-
-import type { SEOConfig, SEOMeta, OGMeta, TwitterMeta } from './index'
-
-/**
- * SEO configuration builder for type-safe setup
- *
- * @example
- * ```ts
- * const seoConfig = createSEOConfig()
- *   .withSiteName('My Site')
- *   .withSiteUrl('https://example.com')
- *   .withDefaultImage('https://example.com/og-image.jpg')
- *   .withTwitterHandle('@mysite')
- * ```
- */
-export class SEOConfigBuilder {
-  private config: SEOConfig = {
-    siteName: '',
-    siteUrl: '',
-  }
-
-  /**
-   * Sets the site name
-   */
-  withSiteName(name: string): this {
-    this.config.siteName = name
-    return this
-  }
-
-  /**
-   * Sets the site URL
-   */
-  withSiteUrl(url: string): this {
-    this.config.siteUrl = url
-    return this
-  }
-
-  /**
-   * Sets default OG image
-   */
-  withDefaultImage(url: string): this {
-    this.config.defaultImage = url
-    return this
-  }
-
-  /**
-   * Sets Twitter handle
-   */
-  withTwitterHandle(handle: string): this {
-    this.config.twitterHandle = handle
-    return this
-  }
-
-  /**
-   * Sets default locale
-   */
-  withLocale(locale: string): this {
-    this.config.locale = locale
-    return this
-  }
-
-  /**
-   * Sets Google Analytics ID
-   */
-  withGoogleAnalyticsId(id: string): this {
-    this.config.googleAnalyticsId = id
-    return this
-  }
-
-  /**
-   * Sets Google Tag Manager ID
-   */
-  withGoogleTagManagerId(id: string): this {
-    this.config.googleTagManagerId = id
-    return this
-  }
-
-  /**
-   * Builds the configuration
-   */
-  build(): SEOConfig {
-    if (!this.config.siteName || !this.config.siteUrl) {
-      throw new Error('SEO config requires siteName and siteUrl')
-    }
-    return this.config
-  }
-}
-
-/**
- * Creates a new SEO configuration builder
- */
-export function createSEOConfig(): SEOConfigBuilder {
-  return new SEOConfigBuilder()
-}
-
-/**
- * Meta tags builder for individual pages
- *
- * @example
- * ```ts
- * const meta = createPageMeta({
- *   title: 'Home',
- *   description: 'Welcome to my site'
- * })
- *   .withKeywords(['web', 'development'])
- *   .withImage('https://example.com/image.jpg')
- * ```
- */
-export class PageMetaBuilder {
-  private meta: Partial<SEOMeta> = {
-    og: {} as OGMeta,
-    twitter: {} as TwitterMeta,
-  }
-
-  constructor(private config: SEOConfig, title: string, description: string) {
-    this.meta.title = title
-    this.meta.description = description
-    this.meta.og = {
-      title,
-      description,
-      type: 'website',
-      url: config.siteUrl,
-      siteName: config.siteName,
-      image: config.defaultImage,
-    }
-    this.meta.twitter = {
-      card: 'summary_large_image',
-      title,
-      description,
-      image: config.defaultImage,
-      creator: config.twitterHandle,
-    }
-  }
-
-  /**
-   * Adds keywords
-   */
-  withKeywords(keywords: string[]): this {
-    this.meta.keywords = keywords
-    return this
-  }
-
-  /**
-   * Sets canonical URL
-   */
-  withCanonical(url: string): this {
-    this.meta.canonical = url
-    return this
-  }
-
-  /**
-   * Sets OG image
-   */
-  withImage(url: string, alt?: string): this {
-    if (this.meta.og) {
-      this.meta.og.image = url
-      if (alt) this.meta.og.imageAlt = alt
-    }
-    if (this.meta.twitter) {
-      this.meta.twitter.image = url
-    }
-    return this
-  }
-
-  /**
-   * Sets OG type
-   */
-  withType(type: 'website' | 'article' | 'product'): this {
-    if (this.meta.og) {
-      this.meta.og.type = type
-    }
-    return this
-  }
-
-  /**
-   * Adds JSON-LD schema
-   */
-  withJsonLd(schema: Record<string, unknown>): this {
-    if (!this.meta.jsonLd) {
-      this.meta.jsonLd = []
-    }
-    this.meta.jsonLd.push(schema)
-    return this
-  }
-
-  /**
-   * Sets robots meta
-   */
-  withRobots(robots: string): this {
-    this.meta.robots = robots
-    return this
-  }
-
-  /**
-   * Adds alternate language links
-   */
-  withAlternates(alternates: Record<string, string>): this {
-    this.meta.alternates = alternates
-    return this
-  }
-
-  /**
-   * Builds the meta tags
-   */
-  build(): SEOMeta {
-    return {
-      title: this.meta.title || '',
-      description: this.meta.description || '',
-      keywords: this.meta.keywords || [],
-      canonical: this.meta.canonical,
-      og: this.meta.og || ({ type: 'website', title: '', description: '', url: '' } as OGMeta),
-      twitter: this.meta.twitter || ({ card: 'summary', title: '', description: '' } as TwitterMeta),
-      robots: this.meta.robots,
-      alternates: this.meta.alternates,
-      jsonLd: this.meta.jsonLd,
-    }
-  }
-}
-
-/**
- * Creates page-specific meta tags
- */
-export function createPageMeta(config: SEOConfig, title: string, description: string): PageMetaBuilder {
-  return new PageMetaBuilder(config, title, description)
-}
-
-/**
- * Validates SEO meta configuration
- */
-export function validateSEOMeta(meta: SEOMeta): { valid: boolean; errors: string[] } {
-  const errors: string[] = []
-
-  if (!meta.title || meta.title.length === 0) {
-    errors.push('Title is required')
-  }
-  if (meta.title && meta.title.length > 60) {
-    errors.push('Title should be under 60 characters')
-  }
-
-  if (!meta.description || meta.description.length === 0) {
-    errors.push('Description is required')
-  }
-  if (meta.description && meta.description.length > 160) {
-    errors.push('Description should be under 160 characters')
-  }
-
-  if (!meta.og?.image && !meta.twitter?.image) {
-    errors.push('At least one image (OG or Twitter) is recommended')
-  }
-
-  if (!meta.keywords || meta.keywords.length === 0) {
-    errors.push('At least one keyword is recommended')
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors,
-  }
-}
-
-/**
- * Presets for common SEO configurations
- */
-export const seoPresets = {
-  /**
-   * Blog article preset
-   */
-  article: (config: SEOConfig): Partial<SEOMeta> => ({
-    og: { type: 'article', ...config },
-    robots: 'index, follow',
-  }),
-
-  /**
-   * E-commerce product preset
-   */
-  product: (config: SEOConfig): Partial<SEOMeta> => ({
-    og: { type: 'product', ...config },
-    robots: 'index, follow',
-  }),
-
-  /**
-   * Service/company page preset
-   */
-  business: (config: SEOConfig): Partial<SEOMeta> => ({
-    robots: 'index, follow',
-  }),
-
-  /**
-   * Private/unlisted page preset
-   */
-  private: (): Partial<SEOMeta> => ({
-    robots: 'noindex, nofollow',
-  }),
-}