@geenius/seo 0.1.0 → 0.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@geenius/seo",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Geenius Seo — SEO utilities for SaaS apps (React + SolidJS)",
   "author": "Antigravity HQ",
   "license": "MIT",
@@ -19,19 +19,32 @@
     "solidjs",
     "geenius"
   ],
+  "files": [
+    "packages/shared/dist",
+    "packages/react/dist",
+    "packages/solidjs/dist",
+    "packages/convex/dist",
+    "packages/react-css/dist",
+    "packages/solidjs-css/dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "dev": "pnpm -r --parallel type-check",
     "build": "pnpm -r build",
     "clean": "pnpm -r clean",
     "lint": "pnpm -r --parallel type-check",
-    "test": "echo \"No tests configured yet\" && exit 0",
+    "test": "pnpm -r --parallel test",
     "type-check": "pnpm -r type-check",
     "format": "prettier --write \"packages/*/src/**/*.{ts,tsx}\"",
     "version:patch": "pnpm -r exec -- npm version patch --no-git-tag-version && npm version patch -m 'v%s'",
     "version:minor": "pnpm -r exec -- npm version minor --no-git-tag-version && npm version minor -m 'v%s'",
     "version:major": "pnpm -r exec -- npm version major --no-git-tag-version && npm version major -m 'v%s'",
     "release": "git push && git push --tags",
-    "publish:all": "pnpm -r publish --access public"
+    "publish:all": "pnpm -r publish --access public",
+    "publish:root": "npm publish --access public",
+    "prepublishOnly": "pnpm build"
   },
   "devDependencies": {
     "prettier": "^3.8.1",

package/packages/convex/dist/index.d.ts

@@ -0,0 +1,56 @@
+import * as convex_server from 'convex/server';
+import * as convex_values from 'convex/values';
+
+declare const seoTables: {
+    seo_pages: convex_server.TableDefinition<convex_values.VObject<{
+        path: string;
+        meta: any;
+        lastModified: string;
+        createdAt: string;
+    }, {
+        path: convex_values.VString<string, "required">;
+        meta: convex_values.VAny<any, "required", string>;
+        lastModified: convex_values.VString<string, "required">;
+        createdAt: convex_values.VString<string, "required">;
+    }, "required", "path" | "meta" | "lastModified" | "createdAt" | `meta.${string}`>, {
+        by_path: ["path", "_creationTime"];
+        by_modified: ["lastModified", "_creationTime"];
+    }, {}, {}>;
+    seo_analytics: convex_server.TableDefinition<convex_values.VObject<{
+        path: string;
+        views: number;
+        avgTimeOnPage: number;
+        bounceRate: number;
+        date: string;
+    }, {
+        path: convex_values.VString<string, "required">;
+        views: convex_values.VFloat64<number, "required">;
+        avgTimeOnPage: convex_values.VFloat64<number, "required">;
+        bounceRate: convex_values.VFloat64<number, "required">;
+        date: convex_values.VString<string, "required">;
+    }, "required", "path" | "views" | "avgTimeOnPage" | "bounceRate" | "date">, {
+        by_path: ["path", "_creationTime"];
+        by_date: ["date", "_creationTime"];
+    }, {}, {}>;
+};
+
+/** Get SEO metadata for a specific page path. */
+declare const getSEOMeta: convex_server.RegisteredQuery<"public", any, Promise<any>>;
+/** List all pages with SEO metadata. */
+declare const listPages: convex_server.RegisteredQuery<"public", any, Promise<any>>;
+/** Get analytics for a specific page within a date range. */
+declare const getPageAnalytics: convex_server.RegisteredQuery<"public", any, Promise<any>>;
+/** Get top pages by total views. */
+declare const getTopPages: convex_server.RegisteredQuery<"public", any, Promise<{
+    path: string;
+    views: number;
+}[]>>;
+
+/** Create or update SEO metadata for a page. */
+declare const upsertSEOMeta: convex_server.RegisteredMutation<"public", any, Promise<any>>;
+/** Create or update analytics for a page on a specific date. */
+declare const updateAnalytics: convex_server.RegisteredMutation<"public", any, Promise<any>>;
+/** Delete SEO metadata for a page. */
+declare const deleteSEOMeta: convex_server.RegisteredMutation<"public", any, Promise<boolean>>;
+
+export { deleteSEOMeta, getPageAnalytics, getSEOMeta, getTopPages, listPages, seoTables, updateAnalytics, upsertSEOMeta };

package/packages/convex/dist/index.js

@@ -0,0 +1,133 @@
+// src/schema.ts
+import { defineTable } from "convex/server";
+import { v } from "convex/values";
+var seoTables = {
+  // ─── SEO Pages ──────────────────────────────────────────────────────────
+  seo_pages: defineTable({
+    path: v.string(),
+    meta: v.any(),
+    lastModified: v.string(),
+    createdAt: v.string()
+  }).index("by_path", ["path"]).index("by_modified", ["lastModified"]),
+  // ─── SEO Analytics ──────────────────────────────────────────────────────
+  seo_analytics: defineTable({
+    path: v.string(),
+    views: v.number(),
+    avgTimeOnPage: v.number(),
+    bounceRate: v.number(),
+    date: v.string()
+  }).index("by_path", ["path"]).index("by_date", ["date"])
+};
+
+// src/queries.ts
+import { queryGeneric } from "convex/server";
+import { v as v2 } from "convex/values";
+var getSEOMeta = queryGeneric({
+  args: { path: v2.string() },
+  handler: async (ctx, args) => {
+    return await ctx.db.query("seo_pages").withIndex("by_path", (q) => q.eq("path", args.path)).first();
+  }
+});
+var listPages = queryGeneric({
+  args: { limit: v2.optional(v2.number()) },
+  handler: async (ctx, args) => {
+    return await ctx.db.query("seo_pages").order("desc").take(args.limit ?? 100);
+  }
+});
+var getPageAnalytics = queryGeneric({
+  args: { path: v2.string(), days: v2.optional(v2.number()) },
+  handler: async (ctx, args) => {
+    const daysAgo = args.days ?? 30;
+    const cutoffDate = /* @__PURE__ */ new Date();
+    cutoffDate.setDate(cutoffDate.getDate() - daysAgo);
+    const cutoffIso = cutoffDate.toISOString().split("T")[0];
+    return await ctx.db.query("seo_analytics").withIndex("by_path", (q) => q.eq("path", args.path)).filter((q) => q.gte(q.field("date"), cutoffIso)).collect();
+  }
+});
+var getTopPages = queryGeneric({
+  args: { limit: v2.optional(v2.number()) },
+  handler: async (ctx, args) => {
+    const allAnalytics = await ctx.db.query("seo_analytics").collect();
+    const grouped = {};
+    for (const entry of allAnalytics) {
+      grouped[entry.path] = (grouped[entry.path] ?? 0) + entry.views;
+    }
+    return Object.entries(grouped).sort((a, b) => b[1] - a[1]).slice(0, args.limit ?? 10).map(([path, views]) => ({ path, views }));
+  }
+});
+
+// src/mutations.ts
+import { mutationGeneric } from "convex/server";
+import { v as v3 } from "convex/values";
+var upsertSEOMeta = mutationGeneric({
+  args: {
+    path: v3.string(),
+    meta: v3.any()
+  },
+  handler: async (ctx, args) => {
+    const existing = await ctx.db.query("seo_pages").withIndex("by_path", (q) => q.eq("path", args.path)).first();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    if (existing) {
+      await ctx.db.patch(existing._id, {
+        meta: args.meta,
+        lastModified: now
+      });
+      return existing._id;
+    }
+    return await ctx.db.insert("seo_pages", {
+      path: args.path,
+      meta: args.meta,
+      lastModified: now,
+      createdAt: now
+    });
+  }
+});
+var updateAnalytics = mutationGeneric({
+  args: {
+    path: v3.string(),
+    views: v3.number(),
+    avgTime: v3.number(),
+    bounceRate: v3.number(),
+    date: v3.string()
+  },
+  handler: async (ctx, args) => {
+    const existing = await ctx.db.query("seo_analytics").withIndex("by_path", (q) => q.eq("path", args.path)).filter((q) => q.eq(q.field("date"), args.date)).first();
+    if (existing) {
+      await ctx.db.patch(existing._id, {
+        views: args.views,
+        avgTimeOnPage: args.avgTime,
+        bounceRate: args.bounceRate
+      });
+      return existing._id;
+    }
+    return await ctx.db.insert("seo_analytics", {
+      path: args.path,
+      views: args.views,
+      avgTimeOnPage: args.avgTime,
+      bounceRate: args.bounceRate,
+      date: args.date
+    });
+  }
+});
+var deleteSEOMeta = mutationGeneric({
+  args: { path: v3.string() },
+  handler: async (ctx, args) => {
+    const entry = await ctx.db.query("seo_pages").withIndex("by_path", (q) => q.eq("path", args.path)).first();
+    if (entry) {
+      await ctx.db.delete(entry._id);
+      return true;
+    }
+    return false;
+  }
+});
+export {
+  deleteSEOMeta,
+  getPageAnalytics,
+  getSEOMeta,
+  getTopPages,
+  listPages,
+  seoTables,
+  updateAnalytics,
+  upsertSEOMeta
+};
+//# sourceMappingURL=index.js.map

package/packages/convex/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/queries.ts","../src/mutations.ts"],"sourcesContent":["// @geenius/seo-convex — src/schema.ts\n\n/**\n * Convex schema definitions for the SEO system.\n * Provides tables for page metadata and analytics tracking.\n *\n * @example\n * ```ts\n * // In your app's convex/schema.ts:\n * import { seoTables } from '@geenius/seo/convex'\n *\n * export default defineSchema({\n *   ...seoTables,\n *   // your other tables...\n * })\n * ```\n */\n\nimport { defineTable } from 'convex/server'\nimport { v } from 'convex/values'\n\nexport const seoTables = {\n  // ─── SEO Pages ──────────────────────────────────────────────────────────\n  seo_pages: defineTable({\n    path: v.string(),\n    meta: v.any(),\n    lastModified: v.string(),\n    createdAt: v.string(),\n  })\n    .index('by_path', ['path'])\n    .index('by_modified', ['lastModified']),\n\n  // ─── SEO Analytics ──────────────────────────────────────────────────────\n  seo_analytics: defineTable({\n    path: v.string(),\n    views: v.number(),\n    avgTimeOnPage: v.number(),\n    bounceRate: v.number(),\n    date: v.string(),\n  })\n    .index('by_path', ['path'])\n    .index('by_date', ['date']),\n}\n","// @geenius/seo-convex — src/queries.ts\n\n/**\n * Convex queries for the SEO system.\n * Read operations for page metadata and analytics.\n */\n\nimport { queryGeneric } from 'convex/server'\nimport { v } from 'convex/values'\n\n// ─── Page Metadata Queries ────────────────────────────────────────────────────\n\n/** Get SEO metadata for a specific page path. */\nexport const getSEOMeta = queryGeneric({\n  args: { path: v.string() },\n  handler: async (ctx: any, args: any) => {\n    return await ctx.db\n      .query('seo_pages')\n      .withIndex('by_path', (q: any) => q.eq('path', args.path))\n      .first()\n  },\n})\n\n/** List all pages with SEO metadata. */\nexport const listPages = queryGeneric({\n  args: { limit: v.optional(v.number()) },\n  handler: async (ctx: any, args: any) => {\n    return await ctx.db\n      .query('seo_pages')\n      .order('desc')\n      .take(args.limit ?? 100)\n  },\n})\n\n// ─── Analytics Queries ────────────────────────────────────────────────────────\n\n/** Get analytics for a specific page within a date range. */\nexport const getPageAnalytics = queryGeneric({\n  args: { path: v.string(), days: v.optional(v.number()) },\n  handler: async (ctx: any, args: any) => {\n    const daysAgo = args.days ?? 30\n    const cutoffDate = new Date()\n    cutoffDate.setDate(cutoffDate.getDate() - daysAgo)\n    const cutoffIso = cutoffDate.toISOString().split('T')[0]\n\n    return await ctx.db\n      .query('seo_analytics')\n      .withIndex('by_path', (q: any) => q.eq('path', args.path))\n      .filter((q: any) => q.gte(q.field('date'), cutoffIso))\n      .collect()\n  },\n})\n\n/** Get top pages by total views. */\nexport const getTopPages = queryGeneric({\n  args: { limit: v.optional(v.number()) },\n  handler: async (ctx: any, args: any) => {\n    const allAnalytics = await ctx.db.query('seo_analytics').collect()\n\n    const grouped: Record<string, number> = {}\n    for (const entry of allAnalytics) {\n      grouped[entry.path] = (grouped[entry.path] ?? 0) + entry.views\n    }\n\n    return Object.entries(grouped)\n      .sort((a, b) => b[1] - a[1])\n      .slice(0, args.limit ?? 10)\n      .map(([path, views]) => ({ path, views }))\n  },\n})\n","// @geenius/seo-convex — src/mutations.ts\n\n/**\n * Convex mutations for the SEO system.\n * Write operations for page metadata and analytics.\n */\n\nimport { mutationGeneric } from 'convex/server'\nimport { v } from 'convex/values'\n\n// ─── Page Metadata Mutations ──────────────────────────────────────────────────\n\n/** Create or update SEO metadata for a page. */\nexport const upsertSEOMeta = mutationGeneric({\n  args: {\n    path: v.string(),\n    meta: v.any(),\n  },\n  handler: async (ctx: any, args: any) => {\n    const existing = await ctx.db\n      .query('seo_pages')\n      .withIndex('by_path', (q: any) => q.eq('path', args.path))\n      .first()\n\n    const now = new Date().toISOString()\n\n    if (existing) {\n      await ctx.db.patch(existing._id, {\n        meta: args.meta,\n        lastModified: now,\n      })\n      return existing._id\n    }\n\n    return await ctx.db.insert('seo_pages', {\n      path: args.path,\n      meta: args.meta,\n      lastModified: now,\n      createdAt: now,\n    })\n  },\n})\n\n// ─── Analytics Mutations ──────────────────────────────────────────────────────\n\n/** Create or update analytics for a page on a specific date. */\nexport const updateAnalytics = mutationGeneric({\n  args: {\n    path: v.string(),\n    views: v.number(),\n    avgTime: v.number(),\n    bounceRate: v.number(),\n    date: v.string(),\n  },\n  handler: async (ctx: any, args: any) => {\n    const existing = await ctx.db\n      .query('seo_analytics')\n      .withIndex('by_path', (q: any) => q.eq('path', args.path))\n      .filter((q: any) => q.eq(q.field('date'), args.date))\n      .first()\n\n    if (existing) {\n      await ctx.db.patch(existing._id, {\n        views: args.views,\n        avgTimeOnPage: args.avgTime,\n        bounceRate: args.bounceRate,\n      })\n      return existing._id\n    }\n\n    return await ctx.db.insert('seo_analytics', {\n      path: args.path,\n      views: args.views,\n      avgTimeOnPage: args.avgTime,\n      bounceRate: args.bounceRate,\n      date: args.date,\n    })\n  },\n})\n\n/** Delete SEO metadata for a page. */\nexport const deleteSEOMeta = mutationGeneric({\n  args: { path: v.string() },\n  handler: async (ctx: any, args: any) => {\n    const entry = await ctx.db\n      .query('seo_pages')\n      .withIndex('by_path', (q: any) => q.eq('path', args.path))\n      .first()\n\n    if (entry) {\n      await ctx.db.delete(entry._id)\n      return true\n    }\n    return false\n  },\n})\n"],"mappings":"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","names":["v","v"]}

package/packages/react/README.md

@@ -1 +1 @@
-# ✦ @geenius-seo/react\n\n> Geenius Seo — React components & hooks\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-seo/react\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-seo/react';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# ✦ @geenius/seo-react\n\n> Geenius Seo — React components & hooks\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius/seo-react\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius/seo-react';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/react/dist/index.d.ts

@@ -0,0 +1,156 @@
+import { SEOConfig, SEOMeta, SitemapEntry } from '@geenius/seo-shared';
+export * from '@geenius/seo-shared';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+interface SeoContextValue {
+    config: SEOConfig;
+}
+interface SeoProviderProps {
+    config: SEOConfig;
+    children: ReactNode;
+}
+declare function SeoProvider({ config, children }: SeoProviderProps): react_jsx_runtime.JSX.Element;
+declare function useSEOContext(): SeoContextValue;
+
+interface UseSEOOptions {
+    /** Page path to load SEO metadata for */
+    path?: string;
+    /** Initial metadata (used when no backend is available) */
+    initialMeta?: SEOMeta;
+}
+/**
+ * Hook to manage page SEO metadata.
+ * Supports both local state and optional Convex backend integration.
+ */
+declare function useSEO(options?: UseSEOOptions): {
+    meta: SEOMeta | null;
+    updateMeta: (newMeta: SEOMeta) => void;
+    isLoading: boolean;
+};
+
+interface PageEntry {
+    path: string;
+    meta: SEOMeta;
+}
+interface UseSEOAdminOptions {
+    /** Pre-loaded pages (e.g. from Convex useQuery) */
+    initialPages?: PageEntry[];
+    /** Callback when a page is upserted (e.g. Convex useMutation) */
+    onUpsert?: (path: string, meta: SEOMeta) => Promise<void>;
+    /** Callback when a page is deleted (e.g. Convex useMutation) */
+    onDelete?: (path: string) => Promise<void>;
+}
+/**
+ * Hook to manage multiple page SEO metadata entries.
+ * Supports optional Convex backend via callback props.
+ *
+ * @example
+ * ```tsx
+ * // With Convex:
+ * const pages = useQuery(api.seo.queries.listPages, {})
+ * const upsertMutation = useMutation(api.seo.mutations.upsertSEOMeta)
+ * const deleteMutation = useMutation(api.seo.mutations.deleteSEOMeta)
+ *
+ * const admin = useSEOAdmin({
+ *   initialPages: pages,
+ *   onUpsert: (path, meta) => upsertMutation({ path, meta }),
+ *   onDelete: (path) => deleteMutation({ path }),
+ * })
+ * ```
+ */
+declare function useSEOAdmin(options?: UseSEOAdminOptions): {
+    pages: PageEntry[];
+    upsertMeta: (path: string, meta: SEOMeta) => Promise<void>;
+    deleteMeta: (path: string) => Promise<void>;
+    isLoading: boolean;
+};
+
+declare function useSEOScore(meta: SEOMeta): {
+    score: number;
+    issues: string[];
+};
+
+declare function useSitemap(entries: SitemapEntry[]): {
+    xml: string;
+};
+
+/**
+ * Returns a canonical URL for the given path using the site URL from SeoProvider.
+ * If no path is provided, defaults to the current window location pathname.
+ */
+declare function useCanonical(path?: string): string;
+
+/**
+ * Injects JSON-LD structured data into the document head.
+ * Cleans up the script tag on unmount or when data changes.
+ */
+declare function useStructuredData(data: Record<string, unknown> | Record<string, unknown>[] | undefined): void;
+
+interface SEOHeadProps {
+    meta: SEOMeta;
+}
+declare function SEOHead({ meta }: SEOHeadProps): null;
+
+interface SEOPreviewProps {
+    meta: SEOMeta;
+}
+declare function SEOPreview({ meta }: SEOPreviewProps): react_jsx_runtime.JSX.Element;
+
+interface SEOScoreCardProps {
+    meta: SEOMeta;
+}
+declare function SEOScoreCard({ meta }: SEOScoreCardProps): react_jsx_runtime.JSX.Element;
+
+interface MetaEditorProps {
+    meta: SEOMeta;
+    onChange: (meta: SEOMeta) => void;
+}
+declare function MetaEditor({ meta, onChange }: MetaEditorProps): react_jsx_runtime.JSX.Element;
+
+interface SitemapViewerProps {
+    entries: SitemapEntry[];
+}
+declare function SitemapViewer({ entries }: SitemapViewerProps): react_jsx_runtime.JSX.Element;
+
+interface BreadcrumbsJsonLdProps {
+    items: {
+        name: string;
+        url: string;
+    }[];
+}
+declare function BreadcrumbsJsonLd({ items }: BreadcrumbsJsonLdProps): null;
+
+interface ArticleJsonLdProps {
+    title: string;
+    description: string;
+    author: string;
+    datePublished: string;
+    url: string;
+    image?: string;
+}
+declare function ArticleJsonLd({ title, description, author, datePublished, url, image, }: ArticleJsonLdProps): null;
+
+interface JsonLdProps {
+    type: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Renders a JSON-LD structured data script in the document head.
+ *
+ * @example
+ * ```tsx
+ * <JsonLd type="Article" data={{
+ *   headline: 'My Article',
+ *   author: { '@type': 'Person', name: 'Alice' },
+ *   datePublished: '2026-03-15',
+ * }} />
+ * ```
+ */
+declare function JsonLd({ type, data }: JsonLdProps): null;
+
+declare function SEOAdminPage(): react_jsx_runtime.JSX.Element;
+
+declare function SEOAnalyticsPage(): react_jsx_runtime.JSX.Element;
+
+export { ArticleJsonLd, BreadcrumbsJsonLd, JsonLd, type JsonLdProps, MetaEditor, SEOAdminPage, SEOAnalyticsPage, SEOHead, SEOPreview, SEOScoreCard, SeoProvider, type SeoProviderProps, SitemapViewer, type UseSEOAdminOptions, useCanonical, useSEO, useSEOAdmin, useSEOContext, useSEOScore, useSitemap, useStructuredData };