@yourbright/emdash-analytics-plugin 0.1.1 → 0.1.2

package/src/index.ts

@@ -1,270 +0,0 @@
-import type { PluginDescriptor } from "emdash";
-import {
-  PluginRouteError,
-  definePlugin
-} from "emdash";
-import { z } from "astro/zod";
-
-import {
-  ADMIN_ROUTES,
-  CRON_ENRICH_MANAGED,
-  CRON_SYNC_BASE,
-  PLUGIN_ID,
-  PLUGIN_VERSION,
-  PUBLIC_AGENT_ROUTES
-} from "./constants.js";
-import { resolveConfigInput } from "./config-validation.js";
-import { getConfigSummary, loadConfig, saveConfig } from "./config.js";
-import {
-  authenticateAgentRequest,
-  createAgentKey,
-  enrichManagedQueries,
-  getContentContext,
-  getOverview,
-  getStatus,
-  handleCron,
-  listAgentKeys,
-  listPages,
-  revokeAgentKey,
-  syncBase,
-  testConnection
-} from "./sync.js";
-
-const configSaveSchema = z.object({
-  siteOrigin: z.string().optional(),
-  ga4PropertyId: z.string().optional(),
-  gscSiteUrl: z.string().optional(),
-  serviceAccountJson: z.string().optional()
-});
-
-const pageListSchema = z.object({
-  managed: z.enum(["all", "managed", "unmanaged"]).optional(),
-  hasOpportunity: z.boolean().optional(),
-  pageKind: z.enum(["all", "blog_post", "blog_archive", "tag", "author", "landing", "other"]).optional(),
-  limit: z.number().int().min(1).max(100).optional(),
-  cursor: z.string().optional()
-});
-
-const contentContextSchema = z.object({
-  collection: z.string().default("posts"),
-  id: z.string().optional(),
-  slug: z.string().optional()
-});
-
-const agentKeyCreateSchema = z.object({
-  label: z.string().min(1).max(200)
-});
-
-const agentKeyRevokeSchema = z.object({
-  prefix: z.string().min(1)
-});
-
-type ConfigSaveInput = z.infer<typeof configSaveSchema>;
-type PageListInput = z.infer<typeof pageListSchema>;
-type ContentContextInput = z.infer<typeof contentContextSchema>;
-type AgentKeyCreateInput = z.infer<typeof agentKeyCreateSchema>;
-type AgentKeyRevokeInput = z.infer<typeof agentKeyRevokeSchema>;
-
-export function contentInsightsPlugin(): PluginDescriptor {
-  return {
-    id: PLUGIN_ID,
-    version: PLUGIN_VERSION,
-    entrypoint: "@yourbright/emdash-analytics-plugin",
-    adminEntry: "@yourbright/emdash-analytics-plugin/admin",
-    capabilities: ["network:fetch", "read:content"],
-    allowedHosts: [
-      "oauth2.googleapis.com",
-      "analyticsdata.googleapis.com",
-      "www.googleapis.com"
-    ],
-    adminPages: [
-      { path: "/", label: "Overview", icon: "chart-bar" },
-      { path: "/pages", label: "Pages", icon: "list" },
-      { path: "/settings", label: "Analytics", icon: "gear" }
-    ],
-    adminWidgets: [
-      { id: "content-opportunities", title: "Content Opportunities", size: "full" }
-    ],
-    options: {}
-  };
-}
-
-export function createPlugin() {
-  return definePlugin({
-    id: PLUGIN_ID,
-    version: PLUGIN_VERSION,
-    capabilities: ["network:fetch", "read:content"],
-    allowedHosts: [
-      "oauth2.googleapis.com",
-      "analyticsdata.googleapis.com",
-      "www.googleapis.com"
-    ],
-    storage: {
-      pages: {
-        indexes: [
-          "managed",
-          "pageKind",
-          "opportunityScore",
-          "gaViews28d",
-          "urlPath",
-          "contentCollection",
-          "contentId",
-          "contentSlug"
-        ],
-        uniqueIndexes: ["urlPath"]
-      },
-      page_queries: {
-        indexes: ["urlPath", "impressions28d", "updatedAt"],
-        uniqueIndexes: [["urlPath", "query"]]
-      },
-      daily_metrics: {
-        indexes: ["source", "scope", "date"],
-        uniqueIndexes: [["source", "scope", "date"]]
-      },
-      sync_runs: {
-        indexes: ["jobType", "status", "startedAt"]
-      },
-      agent_keys: {
-        indexes: ["prefix", "createdAt", "revokedAt"],
-        uniqueIndexes: ["hash", "prefix"]
-      }
-    },
-    hooks: {
-      "plugin:activate": {
-        handler: async (_event, ctx) => {
-          if (ctx.cron) {
-            await ctx.cron.schedule(CRON_SYNC_BASE, { schedule: "0 */6 * * *" });
-            await ctx.cron.schedule(CRON_ENRICH_MANAGED, { schedule: "0 2 * * *" });
-          }
-        }
-      },
-      cron: {
-        handler: async (event, ctx) => {
-          await handleCron(ctx, event.name);
-        }
-      }
-    },
-    routes: {
-      [ADMIN_ROUTES.STATUS]: {
-        handler: async (ctx) => getStatus(ctx)
-      },
-      [ADMIN_ROUTES.OVERVIEW]: {
-        handler: async (ctx) => getOverview(ctx)
-      },
-      [ADMIN_ROUTES.LIST_PAGES]: {
-        input: pageListSchema,
-        handler: async (ctx) => listPages(ctx, ctx.input as PageListInput)
-      },
-      [ADMIN_ROUTES.CONTENT_CONTEXT]: {
-        input: contentContextSchema,
-        handler: async (ctx) => {
-          const input = ctx.input as ContentContextInput;
-          return getContentContext(ctx, input.collection, input.id, input.slug);
-        }
-      },
-      [ADMIN_ROUTES.CONFIG_GET]: {
-        handler: async (ctx) => getConfigSummary(ctx)
-      },
-      [ADMIN_ROUTES.CONFIG_SAVE]: {
-        input: configSaveSchema,
-        handler: async (ctx) => {
-          const input = ctx.input as ConfigSaveInput;
-          const current = await loadConfig(ctx);
-          const resolved = resolveConfigInput(input, current);
-          if (!resolved.success) {
-            throw new PluginRouteError("BAD_REQUEST", resolved.message, 400);
-          }
-          return saveConfig(ctx, resolved.data);
-        }
-      },
-      [ADMIN_ROUTES.CONNECTION_TEST]: {
-        input: configSaveSchema,
-        handler: async (ctx) => {
-          const input = ctx.input as Partial<ConfigSaveInput>;
-          const current = await loadConfig(ctx);
-          const resolved = resolveConfigInput(input, current);
-          if (!resolved.success) {
-            throw new PluginRouteError("BAD_REQUEST", resolved.message, 400);
-          }
-          return testConnection(ctx, resolved.data);
-        }
-      },
-      [ADMIN_ROUTES.SYNC_NOW]: {
-        handler: async (ctx) => {
-          const base = await syncBase(ctx, "manual");
-          const enriched = await enrichManagedQueries(ctx);
-          return { ...base, ...enriched };
-        }
-      },
-      [ADMIN_ROUTES.AGENT_KEYS_LIST]: {
-        handler: async (ctx) => listAgentKeys(ctx)
-      },
-      [ADMIN_ROUTES.AGENT_KEYS_CREATE]: {
-        input: agentKeyCreateSchema,
-        handler: async (ctx) => createAgentKey(ctx, (ctx.input as AgentKeyCreateInput).label)
-      },
-      [ADMIN_ROUTES.AGENT_KEYS_REVOKE]: {
-        input: agentKeyRevokeSchema,
-        handler: async (ctx) => {
-          await revokeAgentKey(ctx, (ctx.input as AgentKeyRevokeInput).prefix);
-          return { success: true };
-        }
-      },
-      [PUBLIC_AGENT_ROUTES.SITE_SUMMARY]: {
-        public: true,
-        handler: async (ctx) => {
-          await authenticateAgentRequest(ctx, ctx.request);
-          const overview = await getOverview(ctx);
-          return {
-            summary: overview.summary,
-            freshness: overview.freshness
-          };
-        }
-      },
-      [PUBLIC_AGENT_ROUTES.OPPORTUNITIES]: {
-        public: true,
-        handler: async (ctx) => {
-          await authenticateAgentRequest(ctx, ctx.request);
-          return listPages(ctx, {
-            managed: "managed",
-            hasOpportunity: true,
-            limit: parsePositiveInt(new URL(ctx.request.url).searchParams.get("limit")) || 50,
-            cursor: new URL(ctx.request.url).searchParams.get("cursor") || undefined
-          });
-        }
-      },
-      [PUBLIC_AGENT_ROUTES.CONTENT_CONTEXT]: {
-        public: true,
-        handler: async (ctx) => {
-          await authenticateAgentRequest(ctx, ctx.request);
-          const params = new URL(ctx.request.url).searchParams;
-          const collection = params.get("collection") || "posts";
-          const id = params.get("id") || undefined;
-          const slug = params.get("slug") || undefined;
-          if (!id && !slug) {
-            throw new PluginRouteError("BAD_REQUEST", "id or slug is required", 400);
-          }
-          return getContentContext(ctx, collection, id, slug);
-        }
-      }
-    },
-    admin: {
-      pages: [
-        { path: "/", label: "Overview", icon: "chart-bar" },
-        { path: "/pages", label: "Pages", icon: "list" },
-        { path: "/settings", label: "Analytics", icon: "gear" }
-      ],
-      widgets: [
-        { id: "content-opportunities", title: "Content Opportunities", size: "full" }
-      ]
-    }
-  });
-}
-
-export default createPlugin;
-
-function parsePositiveInt(value: string | null): number | undefined {
-  if (!value) return undefined;
-  const parsed = Number.parseInt(value, 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
-}

package/src/scoring.ts

@@ -1,83 +0,0 @@
-import type { OpportunityEvidence, OpportunityTag, PageAggregateRecord, PageQueryRecord } from "./types.js";
-
-export function scorePage(
-  page: Pick<
-    PageAggregateRecord,
-    | "gscImpressions28d"
-    | "gscCtr28d"
-    | "gscPosition28d"
-    | "gscClicks28d"
-    | "gscClicksPrev28d"
-    | "gaViews28d"
-    | "gaViewsPrev28d"
-    | "gaEngagementRate28d"
-    | "gaBounceRate28d"
-  >,
-  queries: PageQueryRecord[] = []
-): { score: number; tags: OpportunityTag[]; evidence: OpportunityEvidence[] } {
-  let score = 0;
-  const tags: OpportunityTag[] = [];
-  const evidence: OpportunityEvidence[] = [];
-
-  if (page.gscImpressions28d >= 1000 && page.gscCtr28d < 0.03) {
-    score += 35;
-    tags.push("high-impression-low-ctr");
-    evidence.push({
-      tag: "high-impression-low-ctr",
-      reason: `CTR ${toPercent(page.gscCtr28d)} with ${page.gscImpressions28d} impressions`
-    });
-  }
-
-  if (
-    page.gscPosition28d >= 4 &&
-    page.gscPosition28d <= 15 &&
-    page.gscImpressions28d >= 300
-  ) {
-    score += 20;
-    tags.push("ranking-near-page-1");
-    evidence.push({
-      tag: "ranking-near-page-1",
-      reason: `Average position ${page.gscPosition28d.toFixed(1)} with meaningful impressions`
-    });
-  }
-
-  if (
-    (page.gscClicksPrev28d > 0 && page.gscClicks28d <= page.gscClicksPrev28d * 0.8) ||
-    (page.gaViewsPrev28d > 0 && page.gaViews28d <= page.gaViewsPrev28d * 0.8)
-  ) {
-    score += 20;
-    tags.push("traffic-decline");
-    evidence.push({
-      tag: "traffic-decline",
-      reason: `Traffic declined versus previous window`
-    });
-  }
-
-  if (
-    page.gaViews28d >= 200 &&
-    (page.gaEngagementRate28d < 0.5 || page.gaBounceRate28d > 0.6)
-  ) {
-    score += 15;
-    tags.push("weak-engagement");
-    evidence.push({
-      tag: "weak-engagement",
-      reason: `Engagement ${toPercent(page.gaEngagementRate28d)}, bounce ${toPercent(page.gaBounceRate28d)}`
-    });
-  }
-
-  const hasQueryGap = queries.some((query) => query.impressions28d >= 100 && query.ctr28d < 0.02);
-  if (hasQueryGap) {
-    score += 10;
-    tags.push("query-capture-gap");
-    evidence.push({
-      tag: "query-capture-gap",
-      reason: "One or more high-impression queries have weak CTR"
-    });
-  }
-
-  return { score, tags, evidence };
-}
-
-function toPercent(value: number): string {
-  return `${(value * 100).toFixed(1)}%`;
-}