@uptrademedia/site-kit 1.0.4 → 1.0.7

package/dist/{chunk-QP5NCO2E.js → chunk-VDI7KYME.js}

@@ -3,6 +3,11 @@
 var react = require('react');
 
 // src/seo/api.ts
+if (process.env.NODE_ENV === "development") {
+  console.warn(
+    "@uptrade/seo: WARNING - You are using the deprecated api.ts which exposes API keys. Please migrate to server-api.ts for better security. See: packages/site-kit/src/seo/README.md#migration"
+  );
+}
 function getApiConfig() {
   const apiUrl = process.env.NEXT_PUBLIC_UPTRADE_API_URL || "https://api.uptrademedia.com";
   const apiKey = process.env.NEXT_PUBLIC_UPTRADE_API_KEY || "";
@@ -116,18 +121,78 @@ async function registerSitemap(entries) {
     return { success: false, created: 0, updated: 0 };
   }
 }
+function getSignalApiConfig() {
+  const apiUrl = process.env.NEXT_PUBLIC_SIGNAL_API_URL || "https://signal.uptrademedia.com";
+  const apiKey = process.env.NEXT_PUBLIC_UPTRADE_API_KEY || "";
+  return { apiUrl, apiKey };
+}
+async function signalApiGet(endpoint) {
+  const { apiUrl, apiKey } = getSignalApiConfig();
+  if (!apiKey) {
+    return null;
+  }
+  try {
+    const response = await fetch(`${apiUrl}${endpoint}`, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": apiKey
+      },
+      next: { revalidate: 300 }
+      // Cache for 5 minutes
+    });
+    if (!response.ok) {
+      return null;
+    }
+    const result = await response.json();
+    return result?.data || result;
+  } catch (error) {
+    console.error("@uptrade/seo: Signal API error:", error);
+    return null;
+  }
+}
+var getEntities = react.cache(async (projectId, options) => {
+  let endpoint = `/skills/seo/entities/${projectId}`;
+  if (options?.type) {
+    endpoint += `?type=${options.type}`;
+  }
+  const result = await signalApiGet(endpoint);
+  return result || [];
+});
+var getPrimaryEntity = react.cache(async (projectId) => {
+  return signalApiGet(`/skills/seo/entities/${projectId}/primary`);
+});
+var getEntityEnhancedSchema = react.cache(async (projectId, pagePath) => {
+  const result = await signalApiGet(
+    `/skills/seo/schema/${projectId}/entity-enhanced?pagePath=${encodeURIComponent(pagePath)}`
+  );
+  return result?.schemas || [];
+});
+var getVisibilityScore = react.cache(async (projectId, pagePath) => {
+  const result = await signalApiGet(`/skills/seo/visibility/${projectId}`);
+  if (!result) return null;
+  return result.find((s) => s.page_path === pagePath) || null;
+});
+var getVisibilitySummary = react.cache(async (projectId) => {
+  return signalApiGet(`/skills/seo/visibility/${projectId}/summary`);
+});
 
 exports.getABTest = getABTest;
 exports.getContentBlock = getContentBlock;
+exports.getEntities = getEntities;
+exports.getEntityEnhancedSchema = getEntityEnhancedSchema;
 exports.getFAQData = getFAQData;
 exports.getInternalLinks = getInternalLinks;
 exports.getManagedScripts = getManagedScripts;
+exports.getPrimaryEntity = getPrimaryEntity;
 exports.getRedirectData = getRedirectData;
 exports.getRobotsData = getRobotsData;
 exports.getSEOPageData = getSEOPageData;
 exports.getSchemaMarkups = getSchemaMarkups;
 exports.getSitemapEntries = getSitemapEntries;
+exports.getVisibilityScore = getVisibilityScore;
+exports.getVisibilitySummary = getVisibilitySummary;
 exports.recordABImpression = recordABImpression;
 exports.registerSitemap = registerSitemap;
-//# sourceMappingURL=chunk-QP5NCO2E.js.map
-//# sourceMappingURL=chunk-QP5NCO2E.js.map
+//# sourceMappingURL=chunk-VDI7KYME.js.map
+//# sourceMappingURL=chunk-VDI7KYME.js.map

package/dist/chunk-VDI7KYME.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/seo/api.ts"],"names":["cache"],"mappings":"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","file":"chunk-VDI7KYME.js","sourcesContent":["/**\n * @uptrade/site-kit/seo - API Functions\n * \n * ⚠️ DEPRECATED: This file exposes API keys in client bundles.\n * Use `server-api.ts` instead for server-side operations.\n * \n * This file is kept for backward compatibility but will be removed in a future version.\n * \n * Migration guide:\n * - Replace: import { getSEOPageData } from '@uptrade/seo/api'\n * - With: import { getSEOPageData } from '@uptrade/seo/server'\n * - Use private env vars: UPTRADE_API_KEY instead of NEXT_PUBLIC_UPTRADE_API_KEY\n */\n\nimport { cache } from 'react'\n\n// Show deprecation warning in development\nif (process.env.NODE_ENV === 'development') {\n  console.warn(\n    '@uptrade/seo: WARNING - You are using the deprecated api.ts which exposes API keys. ' +\n    'Please migrate to server-api.ts for better security. ' +\n    'See: packages/site-kit/src/seo/README.md#migration'\n  )\n}\n\n// ============================================\n// API Config (DEPRECATED)\n// ============================================\n\nfunction getApiConfig() {\n  const apiUrl = process.env.NEXT_PUBLIC_UPTRADE_API_URL || 'https://api.uptrademedia.com'\n  const apiKey = process.env.NEXT_PUBLIC_UPTRADE_API_KEY || ''\n  return { apiUrl, apiKey }\n}\n\nasync function apiPost<T>(endpoint: string, body: Record<string, any> = {}): Promise<T | null> {\n  const { apiUrl, apiKey } = getApiConfig()\n  \n  if (!apiKey) {\n    console.error('@uptrade/seo: No API key configured. Set NEXT_PUBLIC_UPTRADE_API_KEY.')\n    return null\n  }\n  \n  try {\n    const response = await fetch(`${apiUrl}${endpoint}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': apiKey,\n      },\n      body: JSON.stringify(body),\n      next: { revalidate: 60 }, // Cache for 60 seconds\n    })\n    \n    if (!response.ok) {\n      console.error(`@uptrade/seo: API error: ${response.statusText}`)\n      return null\n    }\n    \n    return await response.json()\n  } catch (error) {\n    console.error('@uptrade/seo: Network error:', error)\n    return null\n  }\n}\n\n// ============================================\n// Cached Data Fetchers\n// ============================================\n\n/**\n * Fetch SEO page data - cached per request\n */\nexport const getSEOPageData = cache(async (\n  projectId: string,\n  path: string\n) => {\n  const result = await apiPost<{ page: any }>('/api/public/seo/page', { path })\n  return result?.page || null\n})\n\n/**\n * Fetch schema markups for a page - cached per request\n */\nexport const getSchemaMarkups = cache(async (\n  projectId: string,\n  path: string,\n  options?: { includeTypes?: string[]; excludeTypes?: string[] }\n) => {\n  const result = await apiPost<{ schemas: any[] }>('/api/public/seo/schemas', {\n    path,\n    includeTypes: options?.includeTypes,\n    excludeTypes: options?.excludeTypes,\n  })\n  return result?.schemas || []\n})\n\n/**\n * Fetch FAQ data for a page - cached per request\n */\nexport const getFAQData = cache(async (\n  projectId: string,\n  path: string\n) => {\n  const result = await apiPost<{ faq: any }>('/api/public/seo/faq', { path })\n  return result?.faq || null\n})\n\n/**\n * Fetch internal links for a page - cached per request\n */\nexport const getInternalLinks = cache(async (\n  projectId: string,\n  sourcePath: string,\n  options?: { position?: string; limit?: number }\n) => {\n  const result = await apiPost<{ links: any[] }>('/api/public/seo/internal-links', {\n    sourcePath,\n    position: options?.position,\n    limit: options?.limit,\n  })\n  return result?.links || []\n})\n\n/**\n * Fetch content block - cached per request\n */\nexport const getContentBlock = cache(async (\n  projectId: string,\n  path: string,\n  section: string\n) => {\n  const result = await apiPost<{ content: any }>('/api/public/seo/content', { path, section })\n  return result?.content || null\n})\n\n/**\n * Fetch A/B test and determine variant - cached per request\n */\nexport const getABTest = cache(async (\n  projectId: string,\n  path: string,\n  field: string\n) => {\n  const result = await apiPost<{ test: any }>('/api/public/seo/ab-test', { path, field })\n  return result?.test || null\n})\n\n/**\n * Record A/B test impression\n */\nexport async function recordABImpression(\n  testId: string,\n  variant: 'a' | 'b',\n  sessionId?: string\n): Promise<void> {\n  await apiPost('/api/public/seo/ab-impression', { testId, variant, sessionId })\n}\n\n/**\n * Fetch redirect for a path - cached per request\n */\nexport const getRedirectData = cache(async (\n  projectId: string,\n  path: string\n) => {\n  const result = await apiPost<{ redirect: any }>('/api/public/seo/redirect', { path })\n  return result?.redirect || null\n})\n\n/**\n * Fetch managed scripts - cached per request\n */\nexport const getManagedScripts = cache(async (\n  projectId: string,\n  position: string,\n  currentPath?: string\n) => {\n  const result = await apiPost<{ scripts: any[] }>('/api/public/seo/scripts', {\n    position,\n    currentPath,\n  })\n  return result?.scripts || []\n})\n\n/**\n * Fetch robots directive for a page - cached per request\n */\nexport const getRobotsData = cache(async (\n  projectId: string,\n  path: string\n) => {\n  const result = await apiPost<{ page: any }>('/api/public/seo/page', { path })\n  return result?.page?.managed_robots || null\n})\n\n/**\n * Fetch sitemap entries - cached per request\n */\nexport const getSitemapEntries = cache(async (\n  projectId: string,\n  options?: { publishedOnly?: boolean }\n) => {\n  const result = await apiPost<{ entries: any[] }>('/api/public/seo/sitemap', {\n    publishedOnly: options?.publishedOnly,\n  })\n  return result?.entries || []\n})\n\n/**\n * Register/sync sitemap entries from the client site\n * Call this at build time to populate seo_pages from your sitemap.xml\n * \n * @example\n * ```ts\n * // scripts/register-sitemap.ts (run at build time)\n * import { registerSitemap } from '@uptrade/seo/server'\n * \n * await registerSitemap([\n *   { path: '/', priority: 1.0, changefreq: 'daily' },\n *   { path: '/about', priority: 0.8, changefreq: 'weekly' },\n * ])\n * ```\n */\nexport async function registerSitemap(\n  entries: Array<{\n    path: string\n    title?: string\n    priority?: number\n    changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never'\n  }>\n): Promise<{ success: boolean; created: number; updated: number }> {\n  const { apiUrl, apiKey } = getApiConfig()\n  \n  if (!apiKey) {\n    console.error('@uptrade/seo: No API key configured. Set NEXT_PUBLIC_UPTRADE_API_KEY.')\n    return { success: false, created: 0, updated: 0 }\n  }\n  \n  try {\n    const response = await fetch(`${apiUrl}/api/public/seo/register-sitemap`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': apiKey,\n      },\n      body: JSON.stringify({ entries }),\n    })\n    \n    if (!response.ok) {\n      console.error(`@uptrade/seo: Sitemap registration failed: ${response.statusText}`)\n      return { success: false, created: 0, updated: 0 }\n    }\n    \n    return await response.json()\n  } catch (error) {\n    console.error('@uptrade/seo: Sitemap registration error:', error)\n    return { success: false, created: 0, updated: 0 }\n  }\n}\n\n// ============================================\n// AI Visibility & Entity Graph API\n// ============================================\n\n/**\n * Get Signal API config for AI visibility features\n */\nfunction getSignalApiConfig() {\n  const apiUrl = process.env.NEXT_PUBLIC_SIGNAL_API_URL || 'https://signal.uptrademedia.com'\n  const apiKey = process.env.NEXT_PUBLIC_UPTRADE_API_KEY || ''\n  return { apiUrl, apiKey }\n}\n\nasync function signalApiGet<T>(endpoint: string): Promise<T | null> {\n  const { apiUrl, apiKey } = getSignalApiConfig()\n  \n  if (!apiKey) {\n    return null\n  }\n  \n  try {\n    const response = await fetch(`${apiUrl}${endpoint}`, {\n      method: 'GET',\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': apiKey,\n      },\n      next: { revalidate: 300 }, // Cache for 5 minutes\n    })\n    \n    if (!response.ok) {\n      return null\n    }\n    \n    const result = await response.json()\n    return result?.data || result\n  } catch (error) {\n    console.error('@uptrade/seo: Signal API error:', error)\n    return null\n  }\n}\n\n/**\n * Entity types for the knowledge graph\n */\nexport type EntityType = \n  | 'organization'\n  | 'person'\n  | 'service'\n  | 'product'\n  | 'location'\n  | 'concept'\n  | 'credential'\n\n/**\n * Entity from the knowledge graph\n */\nexport interface SEOEntity {\n  id: string\n  project_id: string\n  entity_type: EntityType\n  name: string\n  slug: string\n  properties: Record<string, unknown>\n  knows_about: string[]\n  same_as: string[]\n  schema_type?: string\n  is_primary: boolean\n}\n\n/**\n * Fetch entities for a project - cached per request\n * Returns the entity graph for enhanced schema markup\n */\nexport const getEntities = cache(async (\n  projectId: string,\n  options?: { type?: EntityType }\n): Promise<SEOEntity[]> => {\n  let endpoint = `/skills/seo/entities/${projectId}`\n  if (options?.type) {\n    endpoint += `?type=${options.type}`\n  }\n  const result = await signalApiGet<SEOEntity[]>(endpoint)\n  return result || []\n})\n\n/**\n * Fetch primary entity (the business) - cached per request\n */\nexport const getPrimaryEntity = cache(async (\n  projectId: string\n): Promise<SEOEntity | null> => {\n  return signalApiGet<SEOEntity>(`/skills/seo/entities/${projectId}/primary`)\n})\n\n/**\n * Fetch entity-enhanced schema for a page\n * Returns Organization schema with knowsAbout, areaServed, employee, etc.\n */\nexport const getEntityEnhancedSchema = cache(async (\n  projectId: string,\n  pagePath: string\n): Promise<object[]> => {\n  const result = await signalApiGet<{ schemas: object[] }>(\n    `/skills/seo/schema/${projectId}/entity-enhanced?pagePath=${encodeURIComponent(pagePath)}`\n  )\n  return result?.schemas || []\n})\n\n/**\n * Get AI visibility score for a page\n */\nexport const getVisibilityScore = cache(async (\n  projectId: string,\n  pagePath: string\n): Promise<{\n  overall_score: number\n  entity_coverage: number\n  answer_density: number\n  chunk_readability: number\n  authority_signals: number\n  schema_completeness: number\n} | null> => {\n  const result = await signalApiGet<any[]>(`/skills/seo/visibility/${projectId}`)\n  if (!result) return null\n  return result.find(s => s.page_path === pagePath) || null\n})\n\n/**\n * Get AI visibility summary for project\n */\nexport const getVisibilitySummary = cache(async (\n  projectId: string\n): Promise<{\n  overall_score: number\n  total_entities: number\n  pages_analyzed: number\n  top_recommendations: Array<{ priority: string; type: string; message: string }>\n} | null> => {\n  return signalApiGet(`/skills/seo/visibility/${projectId}/summary`)\n})\n"]}