@yourbright/emdash-analytics-plugin 0.1.1 → 0.1.3

package/src/config-validation.ts

@@ -1,153 +0,0 @@
-import { z } from "astro/zod";
-
-import type { GoogleServiceAccount, SavedPluginConfig } from "./types.js";
-
-export interface ConfigDraftInput {
-  siteOrigin?: string;
-  ga4PropertyId?: string;
-  gscSiteUrl?: string;
-  serviceAccountJson?: string;
-}
-
-type ValidationResult<T> =
-  | { success: true; data: T }
-  | { success: false; message: string };
-
-const serviceAccountSchema = z.object({
-  client_email: z.string().email("Service Account JSON must include a valid client_email"),
-  private_key: z.string().min(1, "Service Account JSON must include a private_key"),
-  token_uri: z.string().url().optional()
-});
-
-const savedConfigSchema = z.object({
-  siteOrigin: z
-    .string()
-    .min(1, "Canonical Site Origin is required")
-    .refine(isHttpUrl, "Canonical Site Origin must be a valid http(s) URL"),
-  ga4PropertyId: z
-    .string()
-    .min(1, "GA4 Property ID is required")
-    .regex(/^[0-9]+$/, "GA4 Property ID must be numeric"),
-  gscSiteUrl: z
-    .string()
-    .min(1, "Search Console Property is required")
-    .refine(isValidSearchConsoleProperty, "Search Console Property must be a valid URL or sc-domain property"),
-  serviceAccountJson: z
-    .string()
-    .min(1, "Service Account JSON is required")
-    .superRefine((value, ctx) => {
-      const parsed = parseServiceAccountSafe(value);
-      if (!parsed.success) {
-        ctx.addIssue({
-          code: z.ZodIssueCode.custom,
-          message: parsed.message
-        });
-      }
-    })
-});
-
-export function resolveConfigInput(
-  input: ConfigDraftInput | null | undefined,
-  current: SavedPluginConfig | null = null
-): ValidationResult<SavedPluginConfig> {
-  const candidate = {
-    siteOrigin: resolveField(input?.siteOrigin, current?.siteOrigin),
-    ga4PropertyId: resolveField(input?.ga4PropertyId, current?.ga4PropertyId),
-    gscSiteUrl: resolveField(input?.gscSiteUrl, current?.gscSiteUrl),
-    serviceAccountJson: resolveServiceAccountField(input?.serviceAccountJson, current?.serviceAccountJson)
-  };
-
-  const parsed = savedConfigSchema.safeParse(candidate);
-  if (!parsed.success) {
-    return {
-      success: false,
-      message: formatValidationError(parsed.error)
-    };
-  }
-
-  return {
-    success: true,
-    data: {
-      ...parsed.data,
-      siteOrigin: normalizeOrigin(parsed.data.siteOrigin)
-    }
-  };
-}
-
-export function parseServiceAccount(json: string): GoogleServiceAccount {
-  const result = parseServiceAccountSafe(json);
-  if (!result.success) {
-    throw new Error(result.message);
-  }
-  return result.data;
-}
-
-export function normalizeOrigin(origin: string): string {
-  const url = new URL(origin);
-  url.pathname = "/";
-  url.search = "";
-  url.hash = "";
-  return url.origin;
-}
-
-function parseServiceAccountSafe(json: string): ValidationResult<GoogleServiceAccount> {
-  let parsedJson: unknown;
-  try {
-    parsedJson = JSON.parse(json);
-  } catch {
-    return {
-      success: false,
-      message: "Service Account JSON must be valid JSON"
-    };
-  }
-
-  const parsed = serviceAccountSchema.safeParse(parsedJson);
-  if (!parsed.success) {
-    return {
-      success: false,
-      message: formatValidationError(parsed.error)
-    };
-  }
-
-  return {
-    success: true,
-    data: parsed.data
-  };
-}
-
-function resolveField(value: string | undefined, fallback: string | undefined): string {
-  if (value === undefined) {
-    return fallback ?? "";
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : fallback ?? "";
-}
-
-function resolveServiceAccountField(value: string | undefined, fallback: string | undefined): string {
-  if (value === undefined) {
-    return fallback ?? "";
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : fallback ?? "";
-}
-
-function isHttpUrl(value: string): boolean {
-  try {
-    const url = new URL(value);
-    return url.protocol === "http:" || url.protocol === "https:";
-  } catch {
-    return false;
-  }
-}
-
-function isValidSearchConsoleProperty(value: string): boolean {
-  if (value.startsWith("sc-domain:")) {
-    return value.slice("sc-domain:".length).trim().length > 0;
-  }
-  return isHttpUrl(value);
-}
-
-function formatValidationError(error: z.ZodError): string {
-  const messages = Array.from(new Set(error.issues.map((issue) => issue.message).filter(Boolean)));
-  return messages[0] || "Invalid settings";
-}

package/src/config.ts

@@ -1,90 +0,0 @@
-import { decrypt, encrypt } from "@emdash-cms/auth";
-import type { PluginContext } from "emdash";
-
-import {
-  CONFIG_GA4_PROPERTY_ID_KEY,
-  CONFIG_GSC_SITE_URL_KEY,
-  CONFIG_SERVICE_ACCOUNT_KEY,
-  CONFIG_SITE_ORIGIN_KEY
-} from "./constants.js";
-import { normalizeOrigin, parseServiceAccount, resolveConfigInput } from "./config-validation.js";
-import type { PluginConfigSummary, SavedPluginConfig } from "./types.js";
-
-type PluginCtx = PluginContext;
-
-export async function loadConfig(ctx: PluginCtx): Promise<SavedPluginConfig | null> {
-  const [siteOrigin, ga4PropertyId, gscSiteUrl, serviceAccountCiphertext] = await Promise.all([
-    ctx.kv.get<string>(CONFIG_SITE_ORIGIN_KEY),
-    ctx.kv.get<string>(CONFIG_GA4_PROPERTY_ID_KEY),
-    ctx.kv.get<string>(CONFIG_GSC_SITE_URL_KEY),
-    ctx.kv.get<string>(CONFIG_SERVICE_ACCOUNT_KEY)
-  ]);
-
-  if (!siteOrigin || !ga4PropertyId || !gscSiteUrl || !serviceAccountCiphertext) {
-    return null;
-  }
-
-  const authSecret = getAuthSecret();
-  const serviceAccountJson = await decrypt(serviceAccountCiphertext, authSecret);
-  const resolved = resolveConfigInput({
-    siteOrigin,
-    ga4PropertyId,
-    gscSiteUrl,
-    serviceAccountJson
-  });
-  if (!resolved.success) {
-    throw new Error(resolved.message);
-  }
-  return resolved.data;
-}
-
-export async function saveConfig(ctx: PluginCtx, input: SavedPluginConfig): Promise<PluginConfigSummary> {
-  const resolved = resolveConfigInput(input);
-  if (!resolved.success) {
-    throw new Error(resolved.message);
-  }
-  const parsed = resolved.data;
-  const authSecret = getAuthSecret();
-  const serviceAccountCiphertext = await encrypt(parsed.serviceAccountJson, authSecret);
-
-  await Promise.all([
-    ctx.kv.set(CONFIG_SITE_ORIGIN_KEY, normalizeOrigin(parsed.siteOrigin)),
-    ctx.kv.set(CONFIG_GA4_PROPERTY_ID_KEY, parsed.ga4PropertyId),
-    ctx.kv.set(CONFIG_GSC_SITE_URL_KEY, parsed.gscSiteUrl),
-    ctx.kv.set(CONFIG_SERVICE_ACCOUNT_KEY, serviceAccountCiphertext)
-  ]);
-
-  return summarizeConfig(parsed);
-}
-
-export async function getConfigSummary(ctx: PluginCtx): Promise<PluginConfigSummary> {
-  const config = await loadConfig(ctx);
-  if (!config) {
-    return {
-      siteOrigin: "",
-      ga4PropertyId: "",
-      gscSiteUrl: "",
-      hasServiceAccount: false
-    };
-  }
-  return summarizeConfig(config);
-}
-
-export function getAuthSecret(): string {
-  const value = process.env.EMDASH_AUTH_SECRET || process.env.AUTH_SECRET || "";
-  if (!value) {
-    throw new Error("EMDASH_AUTH_SECRET is required to store analytics credentials");
-  }
-  return value;
-}
-
-function summarizeConfig(config: SavedPluginConfig): PluginConfigSummary {
-  const serviceAccount = parseServiceAccount(config.serviceAccountJson);
-  return {
-    siteOrigin: normalizeOrigin(config.siteOrigin),
-    ga4PropertyId: config.ga4PropertyId,
-    gscSiteUrl: config.gscSiteUrl,
-    hasServiceAccount: true,
-    serviceAccountEmail: serviceAccount.client_email
-  };
-}

package/src/constants.ts

@@ -1,55 +0,0 @@
-export const PLUGIN_ID = "emdash-google-analytics-dashboard";
-export const PLUGIN_VERSION = "0.1.0";
-export const AGENT_KEY_PREFIX = "yb_ins_";
-
-export const GOOGLE_TOKEN_URL = "https://oauth2.googleapis.com/token";
-export const GOOGLE_GA_BASE_URL = "https://analyticsdata.googleapis.com/v1beta";
-export const GOOGLE_GSC_BASE_URL = "https://www.googleapis.com/webmasters/v3";
-
-export const GSC_SCOPE = "https://www.googleapis.com/auth/webmasters.readonly";
-export const GA_SCOPE = "https://www.googleapis.com/auth/analytics.readonly";
-
-export const DEFAULT_PAGE_WINDOW_DAYS = 28;
-export const GSC_DATA_DELAY_DAYS = 3;
-export const QUERY_REFRESH_STALE_HOURS = 48;
-export const GSC_QUERY_PAGE_LIMIT = 50;
-export const GSC_QUERY_ROW_LIMIT = 25;
-
-export const SITE_SUMMARY_KEY = "state:site-summary";
-export const FRESHNESS_KEY = "state:freshness";
-export const CONFIG_SITE_ORIGIN_KEY = "settings:siteOrigin";
-export const CONFIG_GA4_PROPERTY_ID_KEY = "settings:ga4PropertyId";
-export const CONFIG_GSC_SITE_URL_KEY = "settings:gscSiteUrl";
-export const CONFIG_SERVICE_ACCOUNT_KEY = "settings:serviceAccountCiphertext";
-
-export const CRON_SYNC_BASE = "sync-base";
-export const CRON_ENRICH_MANAGED = "enrich-managed-queries";
-
-export const PUBLIC_AGENT_ROUTES = {
-  SITE_SUMMARY: "agent/v1/site-summary",
-  OPPORTUNITIES: "agent/v1/opportunities",
-  CONTENT_CONTEXT: "agent/v1/content-context"
-} as const;
-
-export const ADMIN_ROUTES = {
-  STATUS: "admin/status",
-  OVERVIEW: "admin/overview",
-  LIST_PAGES: "admin/pages/list",
-  CONTENT_CONTEXT: "admin/content/get",
-  CONFIG_GET: "admin/config/get",
-  CONFIG_SAVE: "admin/config/save",
-  CONNECTION_TEST: "admin/connection/test",
-  SYNC_NOW: "admin/sync-now",
-  AGENT_KEYS_LIST: "admin/agent-keys/list",
-  AGENT_KEYS_CREATE: "admin/agent-keys/create",
-  AGENT_KEYS_REVOKE: "admin/agent-keys/revoke"
-} as const;
-
-export const PAGE_KIND_ORDER = [
-  "blog_post",
-  "blog_archive",
-  "tag",
-  "author",
-  "landing",
-  "other"
-] as const;

package/src/content.ts

@@ -1,133 +0,0 @@
-import { getEmDashCollection, getEmDashEntry } from "emdash";
-
-import type { ManagedContentRef, PageKind } from "./types.js";
-
-interface EntryLike {
-  id?: string;
-  slug?: string | null;
-  data?: Record<string, unknown>;
-}
-
-export function classifyPageKind(urlPath: string): PageKind {
-  if (/^\/blog\/[^/]+\/$/.test(urlPath)) return "blog_post";
-  if (urlPath === "/blog/" || /^\/blog\/[^/]+\/$/.test(urlPath)) return "blog_archive";
-  if (urlPath.startsWith("/tag/")) return "tag";
-  if (urlPath.startsWith("/author/")) return "author";
-  if (
-    urlPath === "/" ||
-    urlPath.startsWith("/company/") ||
-    urlPath.startsWith("/contact/") ||
-    urlPath.startsWith("/download/") ||
-    urlPath.startsWith("/foreignworkers/") ||
-    urlPath.startsWith("/jirei/") ||
-    urlPath.startsWith("/kaigo/") ||
-    urlPath.startsWith("/pr/") ||
-    urlPath.startsWith("/seminar/")
-  ) {
-    return "landing";
-  }
-  return "other";
-}
-
-export function normalizePath(pathOrUrl: string, expectedHost?: string): string | null {
-  try {
-    const parsed = pathOrUrl.startsWith("http://") || pathOrUrl.startsWith("https://")
-      ? new URL(pathOrUrl)
-      : new URL(pathOrUrl, "https://placeholder.invalid");
-    if (expectedHost && parsed.hostname !== "placeholder.invalid" && parsed.hostname !== expectedHost) {
-      return null;
-    }
-    let pathname = parsed.pathname || "/";
-    if (!pathname.startsWith("/")) pathname = `/${pathname}`;
-    pathname = pathname.replace(/\/{2,}/g, "/");
-    if (pathname !== "/" && !pathname.endsWith("/")) pathname = `${pathname}/`;
-    return pathname;
-  } catch {
-    return null;
-  }
-}
-
-export function buildContentUrl(siteOrigin: string, urlPath: string): string {
-  return new URL(urlPath, `${siteOrigin}/`).toString();
-}
-
-export async function getManagedContentMap(siteOrigin: string): Promise<Map<string, ManagedContentRef>> {
-  const result = await getEmDashCollection("posts", {
-    status: "published",
-    limit: 1000,
-    orderBy: { updatedAt: "desc" }
-  });
-
-  const managed = new Map<string, ManagedContentRef>();
-  for (const entry of result.entries as Array<EntryLike>) {
-    const id = typeof entry.id === "string" ? entry.id : "";
-    if (!id) continue;
-    const slug = typeof entry.slug === "string" ? entry.slug : null;
-    const data = entry.data ?? {};
-    const title = typeof data.title === "string" ? data.title : slug || id;
-    const excerpt = typeof data.excerpt === "string" ? data.excerpt : undefined;
-    const seoDescription =
-      typeof data.seo_description === "string" ? data.seo_description : undefined;
-    const urlPath = `/blog/${slug || id}/`;
-    managed.set(urlPath, {
-      collection: "posts",
-      id,
-      slug,
-      urlPath,
-      title,
-      excerpt,
-      seoDescription
-    });
-  }
-
-  void siteOrigin;
-  return managed;
-}
-
-export async function resolveManagedContent(
-  collection: string,
-  id?: string,
-  slug?: string,
-  siteOrigin?: string
-): Promise<ManagedContentRef | null> {
-  if (collection !== "posts") return null;
-  const ref = id || slug;
-  if (!ref) return null;
-
-  const result = await getEmDashEntry("posts", ref);
-  const entry = result.entry as EntryLike | null;
-  if (!entry) return null;
-  const entryId = typeof entry.id === "string" ? entry.id : ref;
-  const entrySlug = typeof entry.slug === "string" ? entry.slug : null;
-  const data = entry.data ?? {};
-  const urlPath = `/blog/${entrySlug || entryId}/`;
-  return {
-    collection: "posts",
-    id: entryId,
-    slug: entrySlug,
-    urlPath,
-    title: typeof data.title === "string" ? data.title : entrySlug || entryId,
-    excerpt: typeof data.excerpt === "string" ? data.excerpt : undefined,
-    seoDescription: typeof data.seo_description === "string" ? data.seo_description : undefined
-  };
-}
-
-export function pageStorageId(urlPath: string): string {
-  return stableStorageId(urlPath);
-}
-
-export function pageQueryStorageId(urlPath: string, query: string): string {
-  return stableStorageId(`${urlPath}::${query}`);
-}
-
-export function dailyMetricStorageId(source: "gsc" | "ga", scope: "all_public", date: string): string {
-  return stableStorageId(`${source}::${scope}::${date}`);
-}
-
-function stableStorageId(input: string): string {
-  let hash = 5381;
-  for (let index = 0; index < input.length; index += 1) {
-    hash = (hash * 33) ^ input.charCodeAt(index);
-  }
-  return `ybci_${(hash >>> 0).toString(16)}`;
-}