@aeptus/aexeo-emdash 0.1.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAWtB,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,UAAU,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,YAAY,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;CAGnC;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,0BAA0B,CA0B5B"}

package/dist/index.js

@@ -0,0 +1,82 @@
+// src/plugin.ts
+var baseCapabilities = [
+  "read:content",
+  "read:schema",
+  "write:artifacts:public/llms.txt",
+  "write:artifacts:public/llms-full.txt",
+  "write:artifacts:public/facts.json",
+  "write:artifacts:public/*.md.txt",
+  "kv:seogeo-baselines"
+];
+function buildCapabilities(evaluatorHost) {
+  if (evaluatorHost === null) {
+    return baseCapabilities;
+  }
+  return [...baseCapabilities, "network:fetch"];
+}
+function buildAllowedHosts(evaluatorHost) {
+  const hosts = ["api.indexnow.org"];
+  if (evaluatorHost !== null && evaluatorHost.length > 0) {
+    hosts.push(evaluatorHost);
+  }
+  return hosts;
+}
+
+// src/sandbox.ts
+function seogeoPluginSandboxed(options = {}) {
+  const evaluatorHost = options.evaluatorHost ?? process.env.SEOGEO_EVALUATOR_HOST ?? null;
+  return {
+    id: "aexeo-seogeo",
+    version: "0.0.1",
+    // Subpath export of this same package; must match package.json
+    // `exports["./sandbox"]`.
+    entrypoint: "@aeptus/aexeo-emdash/sandbox",
+    format: "standard",
+    capabilities: buildCapabilities(evaluatorHost),
+    allowedHosts: buildAllowedHosts(evaluatorHost),
+    // Pages mount at /admin/plugins/aexeo-seogeo/<path>. The page name
+    // (without leading slash) is what the sandbox entry receives in
+    // `body.page` when emdash POSTs the page_load interaction.
+    adminPages: [
+      { path: "/findings", label: "SEO findings" },
+      { path: "/document", label: "Document SEO" },
+      { path: "/setup", label: "Setup" }
+    ],
+    adminWidgets: [
+      { id: "seogeo-score", size: "third", title: "SEO score" }
+    ]
+  };
+}
+
+// src/index.ts
+function seogeoPlugin(options = {}) {
+  return {
+    id: "aexeo-seogeo",
+    version: "0.0.1",
+    // Subpath import resolved by the consumer's bundler at build
+    // time — must match the package.json `exports["./configured"]`
+    // entry.
+    entrypoint: "@aeptus/aexeo-emdash/configured",
+    options: { ...options },
+    capabilities: [
+      "read:content",
+      "read:schema",
+      "kv:seogeo-baselines"
+    ],
+    adminPages: [
+      // "/" alias is required so emdash's /admin/plugins/<id> root
+      // doesn't 404 — that page is where the meta /admin/plugins
+      // list links to when an operator clicks the plugin entry.
+      { path: "/", label: "SEO findings" },
+      { path: "/findings", label: "SEO findings" },
+      { path: "/document", label: "Document SEO" }
+    ],
+    adminWidgets: [
+      { id: "seogeo-score", size: "third", title: "SEO score" }
+    ]
+  };
+}
+export {
+  seogeoPlugin,
+  seogeoPluginSandboxed
+};

package/dist/indexnow.d.ts

@@ -0,0 +1,15 @@
+export interface IndexNowConfig {
+    siteUrl: string;
+    key: string;
+    keyLocation?: string;
+}
+export interface IndexNowSubmission {
+    ok: boolean;
+    status: number;
+    endpoint: string;
+    submitted: string[];
+    rejected: string[];
+    reason?: string;
+}
+export declare function submitIndexNow(config: IndexNowConfig, urls: readonly string[]): Promise<IndexNowSubmission>;
+//# sourceMappingURL=indexnow.d.ts.map

package/dist/indexnow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexnow.d.ts","sourceRoot":"","sources":["../src/indexnow.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAG7B,OAAO,EAAE,MAAM,CAAC;IAEhB,GAAG,EAAE,MAAM,CAAC;IAGZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}

package/dist/mcp.d.ts

@@ -0,0 +1,28 @@
+import type { EmdashDocument, Finding } from "./types.js";
+import { type IndexNowConfig, type IndexNowSubmission } from "./indexnow.js";
+export interface McpToolDefinition<Input, Output> {
+    name: string;
+    description: string;
+    inputSchema: unknown;
+    handler: (input: Input) => Promise<Output>;
+}
+export interface CheckInput {
+    documents: EmdashDocument[];
+    configJson?: string;
+}
+export interface CheckOutput {
+    findings: Finding[];
+    errors: Finding[];
+    byRoute: Record<string, Finding[]>;
+    totals: {
+        findings: number;
+        errors: number;
+        warnings: number;
+    };
+}
+export interface IndexNowSubmitInput {
+    config: IndexNowConfig;
+    urls: string[];
+}
+export declare const tools: readonly [McpToolDefinition<CheckInput, CheckOutput>, McpToolDefinition<IndexNowSubmitInput, IndexNowSubmission>];
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAExB,MAAM,eAAe,CAAC;AAMvB,MAAM,WAAW,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AA4CD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAsCD,eAAO,MAAM,KAAK,mHAA2C,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,77 @@
+import type { EmdashDocument, Finding } from "./types.js";
+import { type EmdashContentItem } from "./adapter.js";
+import type { SidecarHttp } from "./sidecar.js";
+export declare function buildCapabilities(evaluatorHost: string | null): readonly string[];
+export declare function buildAllowedHosts(evaluatorHost: string | null): readonly string[];
+export declare const capabilities: readonly string[];
+export interface KvEntry<T = unknown> {
+    key: string;
+    value: T;
+}
+export interface KvNamespace {
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    list<T = unknown>(prefix?: string): Promise<KvEntry<T>[]>;
+}
+export declare const CONFIG_URL_KEY = "config:evaluator_url";
+export declare const CONFIG_TOKEN_KEY = "config:eval_token";
+export interface SidecarRuntimeConfig {
+    url: string;
+    token: string;
+}
+export declare function readSidecarConfig(kv: KvNamespace): Promise<SidecarRuntimeConfig | null>;
+export declare function writeSidecarConfig(kv: KvNamespace, config: SidecarRuntimeConfig): Promise<void>;
+export interface ContentList {
+    items: EmdashContentItem[];
+    cursor?: string;
+    hasMore: boolean;
+}
+export interface SandboxContentApi {
+    list(collection: string, opts?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<ContentList>;
+}
+export interface SandboxCtx {
+    kv: KvNamespace;
+    http: SidecarHttp;
+    content: SandboxContentApi;
+    log?: {
+        info(msg: string, data?: unknown): void;
+        warn(msg: string, data?: unknown): void;
+        error(msg: string, data?: unknown): void;
+    };
+}
+export interface ContentAfterSaveEvent {
+    content: EmdashContentItem;
+    collection: string;
+    isNew: boolean;
+}
+export declare function handleAfterSave(_event: ContentAfterSaveEvent, _ctx: SandboxCtx): Promise<void>;
+export declare function handleAfterSaveConfigured(event: ContentAfterSaveEvent, ctx: SandboxCtx, evaluator: EvaluatorFn): Promise<void>;
+export declare const DEFAULT_COLLECTIONS: readonly ["posts", "pages"];
+export interface RefreshSummary {
+    documentsScanned: number;
+    routesUpdated: number;
+    totalFindings: number;
+    errors: string[];
+}
+export type EvaluationOutcome = {
+    ok: true;
+    findings: Finding[];
+} | {
+    ok: false;
+    reason: string;
+    detail: string;
+};
+export type EvaluatorFn = (documents: readonly EmdashDocument[]) => Promise<EvaluationOutcome>;
+export declare function evaluateAndPersistAll(ctx: SandboxCtx, options: {
+    collections?: readonly string[];
+    evaluator: EvaluatorFn;
+}): Promise<RefreshSummary>;
+export declare function findingsKey(route: string): string;
+export declare function documentKey(route: string): string;
+export declare function readAllDocuments(kv: KvNamespace): Promise<EmdashDocument[]>;
+export declare function readFindings(kv: KvNamespace, route: string): Promise<Finding[]>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/sandbox-entry.d.ts

@@ -0,0 +1,47 @@
+import type { KvNamespace, SandboxCtx } from "./plugin.js";
+import { handleAfterSave } from "./plugin.js";
+export type BlockInteraction = {
+    type: "page_load";
+    page: string;
+} | {
+    type: "block_action";
+    action_id: string;
+    block_id?: string;
+    value?: unknown;
+} | {
+    type: "form_submit";
+    action_id: string;
+    block_id?: string;
+    values: Record<string, unknown>;
+};
+export interface RouteInput {
+    input: BlockInteraction;
+    request?: unknown;
+    requestMeta?: unknown;
+}
+export interface DispatchCtx {
+    body: BlockInteraction;
+    kv: KvNamespace;
+    ctx: SandboxCtx;
+}
+export interface BlockResponse {
+    blocks: unknown[];
+    toast?: {
+        message: string;
+        type: "success" | "error" | "info";
+    };
+}
+declare function handleAdminRoute(input: RouteInput, ctx: SandboxCtx): Promise<BlockResponse>;
+declare const _default: {
+    hooks: {
+        "content:afterSave": typeof handleAfterSave;
+    };
+    routes: {
+        admin: {
+            handler: typeof handleAdminRoute;
+        };
+    };
+    mcpTools: readonly [import("./mcp.js").McpToolDefinition<import("./mcp.js").CheckInput, import("./mcp.js").CheckOutput>, import("./mcp.js").McpToolDefinition<import("./mcp.js").IndexNowSubmitInput, import("./indexnow.js").IndexNowSubmission>];
+};
+export default _default;
+//# sourceMappingURL=sandbox-entry.d.ts.map

package/dist/sandbox-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-entry.d.ts","sourceRoot":"","sources":["../src/sandbox-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EAEX,UAAU,EAEX,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,eAAe,EAKhB,MAAM,aAAa,CAAC;AAiBrB,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAON,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,WAAW,CAAC;IAChB,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;KAAE,CAAC;CACjE;AAMD,iBAAe,gBAAgB,CAC7B,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,aAAa,CAAC,CAuBxB;;;;;;;;;;;;AAkhBD,wBAWG"}