adaria-ai 0.1.0

package/dist/collectors/asomobile.d.ts

@@ -0,0 +1,37 @@
+import type { AsoCompetitorInfo, AsoKeywordRanking, AsoKeywordSuggestion } from "../types/collectors.js";
+/**
+ * ASOMobile API collector.
+ * Fetches keyword rankings, search volumes, and competition data.
+ *
+ * @see https://asomobile.net
+ */
+export interface AsoMobileCollectorOptions {
+    apiKey: string;
+}
+/**
+ * Test-only overrides. Kept off {@link AsoMobileCollectorOptions} so that
+ * production config loaders cannot feed a user-controlled base URL.
+ */
+export interface AsoMobileCollectorTestHooks {
+    baseUrl?: string;
+}
+export type AsoPlatform = "ios" | "android";
+export declare class AsoMobileCollector {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: AsoMobileCollectorOptions, testHooks?: AsoMobileCollectorTestHooks);
+    private request;
+    /**
+     * Get keyword rankings for an app.
+     */
+    getKeywordRankings(appId: string, platform: AsoPlatform, keywords: string[]): Promise<AsoKeywordRanking[]>;
+    /**
+     * Get keyword suggestions (high volume + low competition).
+     */
+    getKeywordSuggestions(appId: string, platform: AsoPlatform, locale?: string): Promise<AsoKeywordSuggestion[]>;
+    /**
+     * Get competitor metadata.
+     */
+    getCompetitorInfo(competitorId: string, platform: AsoPlatform): Promise<AsoCompetitorInfo>;
+}
+//# sourceMappingURL=asomobile.d.ts.map

package/dist/collectors/asomobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asomobile.d.ts","sourceRoot":"","sources":["../../src/collectors/asomobile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AAgC5C,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAG/B,OAAO,EAAE,yBAAyB,EAClC,SAAS,CAAC,EAAE,2BAA2B;YAS3B,OAAO;IAqCrB;;OAEG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAoB/B;;OAEG;IACG,qBAAqB,CACzB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EACrB,MAAM,SAAO,GACZ,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAiBlC;;OAEG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,iBAAiB,CAAC;CAa9B"}

package/dist/collectors/asomobile.js

@@ -0,0 +1,88 @@
+import { ExternalApiError, RateLimitError } from "../utils/errors.js";
+import { parseRetryAfter } from "../utils/retry.js";
+const DEFAULT_BASE_URL = "https://api.asomobile.net/v2";
+const ALLOWED_HOSTS = new Set(["api.asomobile.net"]);
+export class AsoMobileCollector {
+    apiKey;
+    baseUrl;
+    constructor(options, testHooks) {
+        if (!options.apiKey) {
+            throw new Error("AsoMobileCollector requires apiKey");
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = testHooks?.baseUrl ?? DEFAULT_BASE_URL;
+    }
+    async request(path, params = {}) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (!ALLOWED_HOSTS.has(url.hostname)) {
+            throw new Error(`Untrusted ASOMobile host: ${url.hostname}. Allowed: ${[...ALLOWED_HOSTS].join(", ")}`);
+        }
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === "")
+                continue;
+            url.searchParams.set(key, String(value));
+        }
+        const response = await fetch(url.toString(), {
+            headers: { "X-API-Key": this.apiKey },
+        });
+        if (response.status === 429) {
+            throw new RateLimitError("ASOMobile API rate limited", {
+                retryAfterSeconds: parseRetryAfter(response.headers.get("Retry-After")),
+            });
+        }
+        if (!response.ok) {
+            const body = await response.text();
+            throw new ExternalApiError(`ASOMobile API ${String(response.status)}: ${body}`, { statusCode: response.status });
+        }
+        return (await response.json());
+    }
+    /**
+     * Get keyword rankings for an app.
+     */
+    async getKeywordRankings(appId, platform, keywords) {
+        if (keywords.length === 0)
+            return [];
+        const data = await this.request("/keywords/rankings", {
+            app_id: appId,
+            platform,
+            keywords: keywords.join(","),
+        });
+        return (data.results ?? []).map((r) => ({
+            keyword: r.keyword,
+            rank: r.rank ?? null,
+            searchVolume: r.search_volume ?? 0,
+            competition: r.competition ?? null,
+        }));
+    }
+    /**
+     * Get keyword suggestions (high volume + low competition).
+     */
+    async getKeywordSuggestions(appId, platform, locale = "ko") {
+        const data = await this.request("/keywords/suggestions", {
+            app_id: appId,
+            platform,
+            locale,
+        });
+        return (data.suggestions ?? []).map((s) => ({
+            keyword: s.keyword,
+            searchVolume: s.search_volume ?? 0,
+            competition: s.competition ?? null,
+        }));
+    }
+    /**
+     * Get competitor metadata.
+     */
+    async getCompetitorInfo(competitorId, platform) {
+        const data = await this.request("/app/info", {
+            app_id: competitorId,
+            platform,
+        });
+        return {
+            title: data.title ?? "",
+            subtitle: data.subtitle ?? "",
+            description: data.description ?? "",
+            keywords: data.keywords ?? [],
+        };
+    }
+}
+//# sourceMappingURL=asomobile.js.map

package/dist/collectors/asomobile.js.map

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

package/dist/collectors/eodin-blog.d.ts

@@ -0,0 +1,90 @@
+import type { BlogListOptions, BlogListResponse, BlogPostDraft, BlogPostUpdate } from "../types/collectors.js";
+/**
+ * Eodin Blog + SEO + Analytics API clients — target `api.eodin.app`.
+ *
+ * Replaces the legacy GitHub Contents API approach with direct M2M API
+ * calls against the eodin.app growth endpoints. Three thin clients share
+ * the same auth header (`Authorization: Bearer <GROWTH_AGENT_TOKEN>`) and
+ * the same SSRF allowlist, so they inherit from a common base.
+ *
+ * Write operations on {@link EodinBlogPublisher} (create / update /
+ * publish / delete) are allowed through approval-gated skill paths only;
+ * the collector itself is agnostic and will happily POST if called.
+ *
+ * @see src/agent/safety.ts — `blog_publish` ApprovalManager gate wraps
+ *      every `publish` call site in M5+ skills.
+ */
+export interface EodinBlogConfig {
+    token: string;
+}
+/**
+ * Test-only overrides — intentionally kept off {@link EodinBlogConfig} so
+ * config loaders (M3) cannot inject a user-controlled base URL. SSRF
+ * allowlist still applies to the override value.
+ */
+export interface EodinBlogTestHooks {
+    baseUrl?: string;
+}
+type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
+declare abstract class EodinGrowthClient {
+    protected readonly token: string;
+    protected readonly baseUrl: string;
+    constructor(config: EodinBlogConfig, testHooks?: EodinBlogTestHooks);
+    protected request<T>(method: HttpMethod, path: string, body?: unknown): Promise<T>;
+}
+export declare class EodinBlogPublisher extends EodinGrowthClient {
+    /**
+     * Create a blog post as DRAFT. The skill layer is responsible for
+     * obtaining human approval before calling {@link publish}.
+     */
+    create(post: BlogPostDraft): Promise<unknown>;
+    /**
+     * Partial update of an existing blog post by slug.
+     */
+    update(slug: string, updates: BlogPostUpdate): Promise<unknown>;
+    /**
+     * Publish a blog post (DRAFT → PUBLISHED). Triggers FAQ auto-generation
+     * and ISR revalidation on eodin.app. Always approval-gated from M5.
+     */
+    publish(slug: string): Promise<unknown>;
+    get(slug: string): Promise<unknown>;
+    list(options?: BlogListOptions): Promise<BlogListResponse>;
+    /**
+     * Convenience wrapper: returns the slugs of every listed post, or an
+     * empty array on any failure. Used for duplicate-slug prevention where
+     * "API unavailable" should degrade gracefully to "assume no conflict".
+     */
+    listSlugs(): Promise<string[]>;
+    delete(slug: string): Promise<unknown>;
+}
+export declare class EodinSeoMetrics extends EodinGrowthClient {
+    getOverview(startDate: string, endDate: string): Promise<unknown>;
+    getKeywords(startDate: string, endDate: string, limit?: number): Promise<unknown>;
+    getPages(startDate: string, endDate: string, limit?: number): Promise<unknown>;
+}
+export declare class EodinAnalytics extends EodinGrowthClient {
+    getTraffic(startDate: string, endDate: string): Promise<unknown>;
+    getPages(startDate: string, endDate: string): Promise<unknown>;
+    getSources(startDate: string, endDate: string): Promise<unknown>;
+    getRealtime(): Promise<unknown>;
+}
+/**
+ * Convert markdown to basic HTML.
+ *
+ * Handles: h1-h3, paragraphs, bold, italic, links, unordered lists. The
+ * conversion is intentionally minimal — the Eodin blog backend accepts
+ * arbitrary HTML, but we keep the surface small so {@link EodinBlogPublisher}
+ * callers can predict the exact markup that will land in a draft post.
+ *
+ * Security: all block-level text flows through {@link inlineReplacements},
+ * which HTML-escapes and scheme-whitelists links. See SeoBlogSkill path in
+ * M4+ — competitor descriptions and upstream-generated copy reach this
+ * function without further sanitization.
+ */
+export declare function markdownToHtml(md: string): string;
+/**
+ * Estimate read time from content (200 wpm). Always at least "1 min read".
+ */
+export declare function estimateReadTime(text: string): string;
+export {};
+//# sourceMappingURL=eodin-blog.d.ts.map

package/dist/collectors/eodin-blog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eodin-blog.d.ts","sourceRoot":"","sources":["../../src/collectors/eodin-blog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACf,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEpD,uBAAe,iBAAiB;IAC9B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEvB,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,kBAAkB;cAUnD,OAAO,CAAC,CAAC,EACvB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC;CAsCd;AAMD,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAarE;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnC,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAepE;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAkB9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAM7C;AAMD,qBAAa,eAAgB,SAAQ,iBAAiB;IAC9C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOjE,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,SAAK,GACT,OAAO,CAAC,OAAO,CAAC;IAOb,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,SAAK,GACT,OAAO,CAAC,OAAO,CAAC;CAMpB;AAMD,qBAAa,cAAe,SAAQ,iBAAiB;IAC7C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOhE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO9D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOhE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC;AAkDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CA6BjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/collectors/eodin-blog.js

@@ -0,0 +1,238 @@
+import { ExternalApiError } from "../utils/errors.js";
+import { warn as logWarn } from "../utils/logger.js";
+const DEFAULT_BASE_URL = "https://api.eodin.app/api/v1/growth";
+const ALLOWED_HOSTS = new Set(["api.eodin.app"]);
+const ERROR_BODY_MAX_CHARS = 512;
+class EodinGrowthClient {
+    token;
+    baseUrl;
+    constructor(config, testHooks) {
+        if (!config.token) {
+            throw new Error("Eodin growth clients require a GROWTH_AGENT_TOKEN config.token");
+        }
+        this.token = config.token;
+        this.baseUrl = testHooks?.baseUrl ?? DEFAULT_BASE_URL;
+    }
+    async request(method, path, body) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (!ALLOWED_HOSTS.has(url.hostname)) {
+            throw new Error(`Untrusted Eodin host: ${url.hostname}. Allowed: ${[...ALLOWED_HOSTS].join(", ")}`);
+        }
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            Accept: "application/json",
+        };
+        const init = { method, headers };
+        if (body !== undefined && body !== null && method !== "GET") {
+            headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(body);
+        }
+        const response = await fetch(url.toString(), init);
+        if (!response.ok) {
+            const rawBody = await response.text();
+            // Redact the bearer token in case the server echoes it back in an
+            // error envelope. 4xx from Eodin's auth middleware has historically
+            // included the raw token in dev.
+            const redacted = rawBody
+                .replaceAll(this.token, "[REDACTED]")
+                .slice(0, ERROR_BODY_MAX_CHARS);
+            throw new ExternalApiError(`Eodin Growth API ${String(response.status)}: ${redacted}`, { statusCode: response.status });
+        }
+        return (await response.json());
+    }
+}
+// ---------------------------------------------------------------------------
+// Blog publisher (write paths — approval-gated in M5)
+// ---------------------------------------------------------------------------
+export class EodinBlogPublisher extends EodinGrowthClient {
+    /**
+     * Create a blog post as DRAFT. The skill layer is responsible for
+     * obtaining human approval before calling {@link publish}.
+     */
+    async create(post) {
+        return this.request("POST", "/blogs", {
+            slug: post.slug,
+            title: post.title,
+            description: post.description,
+            category: post.category,
+            content: post.content,
+            thumbnail: post.thumbnail,
+            readTime: post.readTime,
+        });
+    }
+    /**
+     * Partial update of an existing blog post by slug.
+     */
+    async update(slug, updates) {
+        if (Object.keys(updates).length === 0) {
+            throw new Error("EodinBlogPublisher.update: updates object must not be empty");
+        }
+        return this.request("PUT", `/blogs/${encodeURIComponent(slug)}`, updates);
+    }
+    /**
+     * Publish a blog post (DRAFT → PUBLISHED). Triggers FAQ auto-generation
+     * and ISR revalidation on eodin.app. Always approval-gated from M5.
+     */
+    async publish(slug) {
+        return this.request("PUT", `/blogs/${encodeURIComponent(slug)}/publish`, { status: "PUBLISHED" });
+    }
+    async get(slug) {
+        return this.request("GET", `/blogs/${encodeURIComponent(slug)}`);
+    }
+    async list(options = {}) {
+        const params = new URLSearchParams();
+        if (options.status !== undefined)
+            params.set("status", options.status);
+        if (options.category !== undefined)
+            params.set("category", options.category);
+        if (options.page !== undefined)
+            params.set("page", String(options.page));
+        if (options.limit !== undefined)
+            params.set("limit", String(options.limit));
+        const query = params.toString();
+        return this.request("GET", query ? `/blogs?${query}` : "/blogs");
+    }
+    /**
+     * Convenience wrapper: returns the slugs of every listed post, or an
+     * empty array on any failure. Used for duplicate-slug prevention where
+     * "API unavailable" should degrade gracefully to "assume no conflict".
+     */
+    async listSlugs() {
+        try {
+            const result = await this.list({ limit: 100 });
+            const total = result.pagination?.total;
+            if (typeof total === "number" && total > 100) {
+                logWarn(`[eodin-blog] listSlugs truncated — ${String(total)} total posts, only first 100 slugs fetched`);
+            }
+            return result.data.map((post) => post.slug);
+        }
+        catch (err) {
+            logWarn("[eodin-blog] listSlugs failed — assuming no slug conflict", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return [];
+        }
+    }
+    async delete(slug) {
+        return this.request("DELETE", `/blogs/${encodeURIComponent(slug)}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// SEO (Search Console) metrics client — read-only
+// ---------------------------------------------------------------------------
+export class EodinSeoMetrics extends EodinGrowthClient {
+    async getOverview(startDate, endDate) {
+        return this.request("GET", `/metrics/seo/overview?startDate=${encodeURIComponent(startDate)}&endDate=${encodeURIComponent(endDate)}`);
+    }
+    async getKeywords(startDate, endDate, limit = 25) {
+        return this.request("GET", `/metrics/seo/keywords?startDate=${encodeURIComponent(startDate)}&endDate=${encodeURIComponent(endDate)}&limit=${String(limit)}`);
+    }
+    async getPages(startDate, endDate, limit = 25) {
+        return this.request("GET", `/metrics/seo/pages?startDate=${encodeURIComponent(startDate)}&endDate=${encodeURIComponent(endDate)}&limit=${String(limit)}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Analytics (GA4) client — read-only
+// ---------------------------------------------------------------------------
+export class EodinAnalytics extends EodinGrowthClient {
+    async getTraffic(startDate, endDate) {
+        return this.request("GET", `/metrics/analytics/traffic?startDate=${encodeURIComponent(startDate)}&endDate=${encodeURIComponent(endDate)}`);
+    }
+    async getPages(startDate, endDate) {
+        return this.request("GET", `/metrics/analytics/pages?startDate=${encodeURIComponent(startDate)}&endDate=${encodeURIComponent(endDate)}`);
+    }
+    async getSources(startDate, endDate) {
+        return this.request("GET", `/metrics/analytics/sources?startDate=${encodeURIComponent(startDate)}&endDate=${encodeURIComponent(endDate)}`);
+    }
+    async getRealtime() {
+        return this.request("GET", "/metrics/analytics/realtime");
+    }
+}
+// ---------------------------------------------------------------------------
+// Markdown → HTML helpers (used by SeoBlogSkill when preparing drafts)
+// ---------------------------------------------------------------------------
+const HTML_ESCAPE_MAP = {
+    "&": "&",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;",
+};
+function escapeHtml(text) {
+    return text.replace(/[&<>"']/g, (ch) => HTML_ESCAPE_MAP[ch] ?? ch);
+}
+const SAFE_URL_SCHEME = /^(?:https?:|mailto:|\/|#)/i;
+/**
+ * Normalize a link URL so Markdown cannot smuggle `javascript:` or other
+ * dangerous schemes into the rendered `<a href>`. Allowed: http, https,
+ * mailto, absolute (`/…`), and fragments (`#…`). Everything else becomes
+ * `#`. The result is HTML-escaped for attribute safety.
+ */
+function safeHref(url) {
+    const trimmed = url.trim();
+    if (SAFE_URL_SCHEME.test(trimmed)) {
+        return escapeHtml(trimmed);
+    }
+    return "#";
+}
+function inlineReplacements(text) {
+    // HTML escape first so the markdown tokens we reintroduce below are the
+    // only raw HTML in the final output. `inlineReplacements` is called with
+    // attacker-controllable text (competitor descriptions, Claude-generated
+    // body copy), and the Eodin blog backend does not re-sanitize on POST.
+    const escaped = escapeHtml(text);
+    return escaped
+        .replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>")
+        .replace(/\*(.+?)\*/g, "<em>$1</em>")
+        .replace(/\[(.+?)\]\((.+?)\)/g, (_match, label, url) => `<a href="${safeHref(url)}">${label}</a>`);
+}
+/**
+ * Convert markdown to basic HTML.
+ *
+ * Handles: h1-h3, paragraphs, bold, italic, links, unordered lists. The
+ * conversion is intentionally minimal — the Eodin blog backend accepts
+ * arbitrary HTML, but we keep the surface small so {@link EodinBlogPublisher}
+ * callers can predict the exact markup that will land in a draft post.
+ *
+ * Security: all block-level text flows through {@link inlineReplacements},
+ * which HTML-escapes and scheme-whitelists links. See SeoBlogSkill path in
+ * M4+ — competitor descriptions and upstream-generated copy reach this
+ * function without further sanitization.
+ */
+export function markdownToHtml(md) {
+    return md
+        .split("\n\n")
+        .map((rawBlock) => {
+        const block = rawBlock.trim();
+        if (!block)
+            return "";
+        if (block.startsWith("### ")) {
+            return `<h3>${inlineReplacements(block.slice(4))}</h3>`;
+        }
+        if (block.startsWith("## ")) {
+            return `<h2>${inlineReplacements(block.slice(3))}</h2>`;
+        }
+        if (block.startsWith("# ")) {
+            return `<h1>${inlineReplacements(block.slice(2))}</h1>`;
+        }
+        if (/^[-*] /m.test(block)) {
+            const items = block
+                .split("\n")
+                .filter((l) => /^[-*] /.test(l))
+                .map((l) => `<li>${inlineReplacements(l.replace(/^[-*] /, ""))}</li>`);
+            return `<ul>${items.join("")}</ul>`;
+        }
+        return `<p>${inlineReplacements(block.replace(/\n/g, " "))}</p>`;
+    })
+        .filter(Boolean)
+        .join("\n");
+}
+/**
+ * Estimate read time from content (200 wpm). Always at least "1 min read".
+ */
+export function estimateReadTime(text) {
+    const words = text.split(/\s+/).filter(Boolean).length;
+    const minutes = Math.max(1, Math.ceil(words / 200));
+    return `${String(minutes)} min read`;
+}
+//# sourceMappingURL=eodin-blog.js.map

package/dist/collectors/eodin-blog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eodin-blog.js","sourceRoot":"","sources":["../../src/collectors/eodin-blog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAoCrD,MAAM,gBAAgB,GAAG,qCAAqC,CAAC;AAC/D,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;AACtE,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAIjC,MAAe,iBAAiB;IACX,KAAK,CAAS;IACd,OAAO,CAAS;IAEnC,YAAY,MAAuB,EAAE,SAA8B;QACjE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,SAAS,EAAE,OAAO,IAAI,gBAAgB,CAAC;IACxD,CAAC;IAES,KAAK,CAAC,OAAO,CACrB,MAAkB,EAClB,IAAY,EACZ,IAAc;QAEd,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC;QAE9C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,CAAC,QAAQ,cAAc,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;YACrC,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QAEF,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5D,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;QAEnD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,kEAAkE;YAClE,oEAAoE;YACpE,iCAAiC;YACjC,MAAM,QAAQ,GAAG,OAAO;iBACrB,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC;iBACpC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;YAClC,MAAM,IAAI,gBAAgB,CACxB,oBAAoB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,EAC1D,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAChC,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IACtC,CAAC;CACF;AAED,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAmB;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAU,MAAM,EAAE,QAAQ,EAAE;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAAuB;QAChD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,UAAU,kBAAkB,CAAC,IAAI,CAAC,EAAE,EACpC,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,UAAU,kBAAkB,CAAC,IAAI,CAAC,UAAU,EAC5C,EAAE,MAAM,EAAE,WAAW,EAAE,CACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,UAAU,kBAAkB,CAAC,IAAI,CAAC,EAAE,CACrC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAA2B,EAAE;QACtC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAChC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAC7B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CACrC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC;YACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;gBAC7C,OAAO,CACL,sCAAsC,MAAM,CAAC,KAAK,CAAC,4CAA4C,CAChG,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,2DAA2D,EAAE;gBACnE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,OAAO,CACjB,QAAQ,EACR,UAAU,kBAAkB,CAAC,IAAI,CAAC,EAAE,CACrC,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,OAAO,eAAgB,SAAQ,iBAAiB;IACpD,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,OAAe;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,mCAAmC,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAC1G,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,SAAiB,EACjB,OAAe,EACf,KAAK,GAAG,EAAE;QAEV,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,mCAAmC,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,EAAE,CACjI,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,SAAiB,EACjB,OAAe,EACf,KAAK,GAAG,EAAE;QAEV,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,gCAAgC,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9H,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,MAAM,OAAO,cAAe,SAAQ,iBAAiB;IACnD,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,OAAe;QACjD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,wCAAwC,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAC/G,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,OAAe;QAC/C,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,sCAAsC,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAC7G,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,OAAe;QACjD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,wCAAwC,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAC/G,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,OAAO,CAAU,KAAK,EAAE,6BAA6B,CAAC,CAAC;IACrE,CAAC;CACF;AAED,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAE9E,MAAM,eAAe,GAA2B;IAC9C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAErD;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,wEAAwE;IACxE,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,OAAO;SACX,OAAO,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SAChD,OAAO,CAAC,YAAY,EAAE,aAAa,CAAC;SACpC,OAAO,CACN,qBAAqB,EACrB,CAAC,MAAM,EAAE,KAAa,EAAE,GAAW,EAAE,EAAE,CACrC,YAAY,QAAQ,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,CAC5C,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,EAAE;SACN,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1D,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,KAAK;iBAChB,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACzE,OAAO,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;QACtC,CAAC;QAED,OAAO,MAAM,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC;IACnE,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;AACvC,CAAC"}

package/dist/collectors/eodin-sdk.d.ts

@@ -0,0 +1,60 @@
+import type { EodinCohort, EodinFunnelData, EodinSummaryRow } from "../types/collectors.js";
+/**
+ * Eodin Analytics API collector.
+ *
+ * Wraps `https://api.eodin.app/api/v1/events` — read-only endpoints exposing
+ * daily summaries, funnels, and cohort retention for each registered app.
+ *
+ * Auth: X-API-Key header (not `Authorization: Bearer`).
+ */
+export interface EodinSdkCollectorOptions {
+    apiKey: string;
+}
+/**
+ * Test-only overrides. Kept off {@link EodinSdkCollectorOptions} so that
+ * production config loaders (M3) cannot feed a user-controlled base URL into
+ * the SSRF surface. The SSRF allowlist check still applies to the override —
+ * defense in depth.
+ */
+export interface EodinSdkCollectorTestHooks {
+    baseUrl?: string;
+}
+export interface EodinSummaryOptions {
+    /** Aggregation window. Defaults to `daily`. */
+    granularity?: "daily" | "weekly" | "monthly";
+    /** Platform filter. Defaults to `all`. */
+    os?: "ios" | "android" | "all";
+}
+export interface EodinFunnelOptions {
+    source?: string;
+    os?: "ios" | "android" | "all";
+}
+export interface EodinCohortOptions {
+    granularity?: "daily" | "weekly" | "monthly";
+    os?: "ios" | "android" | "all";
+}
+export declare class EodinSdkCollector {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private loggedPercentCohort;
+    constructor(options: EodinSdkCollectorOptions, testHooks?: EodinSdkCollectorTestHooks);
+    private request;
+    /**
+     * Daily/weekly/monthly aggregate rows.
+     */
+    getSummary(appId: string, startDate: string, endDate: string, options?: EodinSummaryOptions): Promise<EodinSummaryRow[]>;
+    /**
+     * Aggregate funnel for the period. Step order is fixed by the Eodin API:
+     * `app_install → app_open → core_action → paywall_view → subscribe_start`.
+     */
+    getFunnel(appId: string, startDate: string, endDate: string, options?: EodinFunnelOptions): Promise<EodinFunnelData>;
+    /**
+     * Cohort retention. `retention[0]` is always the cohort anchor (100% of
+     * the cohort by definition), so any value above 1.5 signals the server
+     * returned percents instead of fractions; we detect and normalize so
+     * every downstream consumer sees fractions in [0, 1].
+     */
+    getCohort(appId: string, startDate: string, endDate: string, options?: EodinCohortOptions): Promise<EodinCohort[]>;
+    private normalizeRetention;
+}
+//# sourceMappingURL=eodin-sdk.d.ts.map

package/dist/collectors/eodin-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eodin-sdk.d.ts","sourceRoot":"","sources":["../../src/collectors/eodin-sdk.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7C,0CAA0C;IAC1C,EAAE,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7C,EAAE,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;CAChC;AAmBD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,mBAAmB,CAAS;gBAGlC,OAAO,EAAE,wBAAwB,EACjC,SAAS,CAAC,EAAE,0BAA0B;YAS1B,OAAO;IAwCrB;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,eAAe,EAAE,CAAC;IAW7B;;;OAGG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAW3B;;;;;OAKG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,EAAE,CAAC;IAezB,OAAO,CAAC,kBAAkB;CAqB3B"}