@mantra-ai/core 0.1.0

package/dist/works/text/acquire-fulltext.js

@@ -0,0 +1,62 @@
+import { strategiesInOrder, fetchTextWithRetries, } from "../strategies/index";
+const context = { fetchText: fetchTextWithRetries };
+async function acquireFullText(ids, logger) {
+    const trace = [];
+    // Track best URL-only result as fallback when no strategy yields content
+    let bestUrlOnly = null;
+    for (const s of strategiesInOrder) {
+        if (!s.matches(ids)) {
+            trace.push({ strategy: s.name, matched: false, attempted: false, succeeded: false });
+            continue;
+        }
+        logger?.debug?.({ strategy: s.name }, "fulltext.strategy.try");
+        try {
+            const hit = await s.getFullText(ids, context);
+            if (hit) {
+                // Only treat as terminal success if there is actual content
+                if (hit.content) {
+                    logger?.info?.({ strategy: s.name, source: hit.source }, "fulltext.strategy.success");
+                    trace.push({ strategy: s.name, matched: true, attempted: true, succeeded: true });
+                    return { result: hit, trace };
+                }
+                // URL-only or empty-content result — record and continue
+                logger?.debug?.({ strategy: s.name, source: hit.source, url: hit.url }, "fulltext.strategy.url_only");
+                trace.push({
+                    strategy: s.name,
+                    matched: true,
+                    attempted: true,
+                    succeeded: false,
+                    skipReason: "no_content",
+                });
+                if (!bestUrlOnly)
+                    bestUrlOnly = hit;
+                continue;
+            }
+            trace.push({ strategy: s.name, matched: true, attempted: true, succeeded: false });
+            logger?.debug?.({ strategy: s.name }, "fulltext.strategy.miss: matched but no result");
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            logger?.warn?.({ strategy: s.name, err }, "fulltext.strategy.error");
+            trace.push({ strategy: s.name, matched: true, attempted: true, succeeded: false, error: errorMsg });
+        }
+    }
+    // Return best URL-only result if we have one (still no content, but
+    // preserves URL/version metadata for downstream consumers).
+    if (bestUrlOnly) {
+        logger?.info?.({ source: bestUrlOnly.source, url: bestUrlOnly.url }, "fulltext.url_only_fallback");
+        return { result: bestUrlOnly, trace };
+    }
+    const idsPresent = Object.keys(ids).filter((k) => ids[k]);
+    logger?.warn?.({ idsPresent }, "fulltext.none: all strategies exhausted");
+    return { result: null, trace };
+}
+// ---- public API (unchanged name & results) ----
+export async function getBestFullText(ids, logger) {
+    const { result } = await acquireFullText(ids, logger);
+    return result;
+}
+export async function getBestFullTextWithTrace(ids, logger) {
+    return acquireFullText(ids, logger);
+}
+//# sourceMappingURL=acquire-fulltext.js.map

package/dist/works/text/acquire-fulltext.js.map

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

package/dist/works/text/normalize.d.ts

@@ -0,0 +1,40 @@
+import type { CompleteIds, LoggerLike } from "../types";
+import type { NormalizedDoc } from "../../normalization/normalized-doc-schema";
+export type FullTextRawJats = {
+    type: "jats-xml";
+    content: string;
+    source: string;
+    url?: string | null;
+    license?: string | null;
+    versionLabel?: string | null;
+};
+export type NormalizeJatsInput = {
+    raw: FullTextRawJats;
+    completeIds: CompleteIds;
+    logger?: LoggerLike;
+    cid?: string;
+};
+export type NormalizedJats = {
+    isJats: true;
+    versionLabel?: string;
+    normalizedJson: NormalizedDoc;
+    metadata: NormalizedDoc["metadata"] | null;
+    schemaVersion: string | null;
+    title: string | undefined;
+    abstractText?: string;
+    licenseFromMeta?: string | null;
+    license?: string | null;
+    source: string;
+    sourceUrl?: string | null;
+    rawXml: string;
+    blocks?: NormalizedDoc["blocks"];
+    sections?: NormalizedDoc["sections"];
+    citations?: NormalizedDoc["citations"];
+    assets?: NormalizedDoc["assets"];
+};
+/**
+ * Normalize JATS into our canonical JSON structure, merge meta IDs into completeIds (non-destructive),
+ * and resolve a version label. No persistence here.
+ */
+export declare function normalizeJats(input: NormalizeJatsInput): Promise<NormalizedJats>;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/works/text/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/works/text/normalize.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAG/E,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,eAAe,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,aAAa,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAC3C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,cAAc,CAAC,CAqNzB"}

package/dist/works/text/normalize.js

@@ -0,0 +1,188 @@
+import { normalizeJatsToDoc } from "../../normalization/jats";
+import { normalizeDOI, normalizePMID, normalizePMCID, normalizeArXivId, } from "../id/normalize-ids";
+import { applyNormalizedCompleteIds } from "../id/resolveIds/assign";
+/**
+ * Normalize JATS into our canonical JSON structure, merge meta IDs into completeIds (non-destructive),
+ * and resolve a version label. No persistence here.
+ */
+export async function normalizeJats(input) {
+    const { raw, completeIds, logger, cid } = input;
+    if (!raw.content || typeof raw.content !== "string") {
+        throw new Error(`normalizeJats: expected raw.content to be a non-empty string, got ${typeof raw.content}`);
+    }
+    // --- 1) Parse & normalize JATS to our env/data shape
+    const env = normalizeJatsToDoc(raw.content, {
+        contentType: "application/jats+xml",
+        encoding: "utf-8",
+        source: {
+            name: raw.source,
+            url: raw.url ?? undefined,
+            license: raw.license ?? undefined,
+        },
+    });
+    const normalizedDoc = env.data;
+    const meta = normalizedDoc?.metadata ?? {};
+    // --- helpers
+    const collapseWs = (s) => s.replace(/\s+/g, " ").trim();
+    const stripTags = (s) => s.replace(/<[^>]*>/g, ""); // simple, fast
+    const isMeaningful = (s) => typeof s === "string" &&
+        collapseWs(s).length > 0 &&
+        collapseWs(s).toLowerCase() !== "untitled";
+    // --- 2) Extract convenient fields from metadata
+    // --- 2) Extract convenient fields from metadata
+    // Title helpers that handle many shapes + a robust JATS fallback
+    const pickFirstString = (v) => {
+        if (!v)
+            return undefined;
+        if (typeof v === "string")
+            return collapseWs(v);
+        if (typeof v?.text === "string")
+            return collapseWs(v.text);
+        if (Array.isArray(v)) {
+            for (const it of v) {
+                const s = pickFirstString(it);
+                if (s)
+                    return s;
+            }
+        }
+        return undefined;
+    };
+    const extractTitleFromJats = (xml) => {
+        // naive but effective: <article-title>…</article-title>
+        const m = xml.match(/<article-title\b[^>]*>([\s\S]*?)<\/article-title>/i);
+        if (!m)
+            return undefined;
+        const cleaned = collapseWs(stripTags(m[1]));
+        return cleaned.length ? cleaned : undefined;
+    };
+    // Try multiple likely locations
+    let title = 
+    // 1) metadata.title (string, {text}, or array)
+    pickFirstString(meta?.title) ??
+        // 2) some normalizers expose `titles` as an array
+        pickFirstString(meta?.titles) ??
+        // 3) common JATS-shaped nests
+        pickFirstString(meta?.["title-group"]?.["article-title"]) ??
+        pickFirstString(meta?.titleGroup?.articleTitle) ??
+        // 4) top-level doc fields some pipelines expose
+        pickFirstString(normalizedDoc?.title) ??
+        pickFirstString(normalizedDoc?.titles) ??
+        // 5) last-resort: parse <article-title> from raw XML
+        extractTitleFromJats(raw.content);
+    if (title && !isMeaningful(title))
+        title = undefined;
+    // Abstract: paragraphs → text; otherwise fall back to xml_minimal/xml or plain string
+    let abstractText;
+    const paraList = Array.isArray(meta?.abstract?.paragraphs)
+        ? meta.abstract.paragraphs
+        : undefined;
+    if (paraList && paraList.length) {
+        const asText = paraList
+            .map((p) => typeof p === "string"
+            ? p
+            : typeof p?.text === "string"
+                ? p.text
+                : String(p ?? ""))
+            .map((s) => collapseWs(s))
+            .filter((s) => s.length > 0)
+            .join(" ");
+        abstractText = asText.length ? asText : undefined;
+    }
+    if (!abstractText) {
+        const xmlMin = Array.isArray(meta?.abstract?.xml_minimal)
+            ? meta.abstract.xml_minimal.join(" ")
+            : typeof meta?.abstract?.xml_minimal === "string"
+                ? meta.abstract.xml_minimal
+                : undefined;
+        const xmlFull = Array.isArray(meta?.abstract?.xml)
+            ? meta.abstract.xml.join(" ")
+            : typeof meta?.abstract?.xml === "string"
+                ? meta.abstract.xml
+                : undefined;
+        const raw = typeof meta?.abstract === "string" ? meta.abstract : undefined;
+        const candidate = (xmlMin && stripTags(xmlMin)) || (xmlFull && stripTags(xmlFull)) || raw;
+        if (candidate) {
+            const cleaned = collapseWs(candidate);
+            abstractText = cleaned.length ? cleaned : undefined;
+        }
+    }
+    // License: prefer href; fallback to type (e.g., "CC-BY-4.0")
+    const metaLicenseHrefRaw = meta?.license?.href;
+    const licenseTypeRaw = meta?.license?.type;
+    const licenseFromMeta = typeof metaLicenseHrefRaw === "string" && collapseWs(metaLicenseHrefRaw)
+        ? collapseWs(metaLicenseHrefRaw)
+        : typeof licenseTypeRaw === "string" && collapseWs(licenseTypeRaw)
+            ? collapseWs(licenseTypeRaw)
+            : null;
+    // --- 3) Merge meta IDs (only if missing in completeIds)
+    const metaIds = meta?.ids ?? {};
+    const mergeIfEmpty = (key, value) => {
+        if (!value)
+            return;
+        if (completeIds[key])
+            return; // do not overwrite existing IDs
+        completeIds[key] = value;
+    };
+    const normalizedMetaDoi = metaIds.doi
+        ? normalizeDOI(String(metaIds.doi))
+        : null;
+    const normalizedMetaPmid = metaIds.pmid
+        ? normalizePMID(String(metaIds.pmid))
+        : null;
+    const normalizedMetaPmcid = metaIds.pmcid
+        ? normalizePMCID(String(metaIds.pmcid))
+        : null;
+    // Be liberal in what we accept for arXiv keys coming from various normalizers
+    const candidateArxiv = metaIds.arxiv ?? metaIds.arXiv ?? metaIds.arXivId ?? metaIds.arxivId;
+    const normalizedMetaArxiv = candidateArxiv
+        ? normalizeArXivId(String(candidateArxiv))
+        : null;
+    mergeIfEmpty("doi", normalizedMetaDoi ?? undefined);
+    mergeIfEmpty("pmid", normalizedMetaPmid ?? undefined);
+    mergeIfEmpty("pmcid", normalizedMetaPmcid ?? undefined);
+    mergeIfEmpty("arxivId", normalizedMetaArxiv ?? undefined);
+    // Re-apply normalization after we potentially augmented completeIds
+    applyNormalizedCompleteIds(completeIds);
+    // --- 4) Version label: use the pre-computed value from resolveIds (single source of truth)
+    const resolvedVersionLabel = completeIds.version ?? raw.versionLabel ?? undefined;
+    // --- 5) Pull structured slices for downstream persistence
+    const blocks = Array.isArray(normalizedDoc?.blocks)
+        ? normalizedDoc.blocks
+        : undefined;
+    const sections = Array.isArray(normalizedDoc?.sections)
+        ? normalizedDoc.sections
+        : undefined;
+    const citations = Array.isArray(normalizedDoc?.citations)
+        ? normalizedDoc.citations
+        : undefined;
+    const assets = normalizedDoc?.assets ?? undefined;
+    // Optional debug logs
+    logger?.warn?.({
+        correlationId: cid,
+        source: raw.source,
+        haveTitle: Boolean(title),
+        haveAbstract: Boolean(abstractText),
+        resolvedVersionLabel,
+        ids: completeIds,
+    }, "jats.normalize.summary");
+    // --- 6) Return normalized package (no side effects beyond completeIds merge)
+    return {
+        isJats: true,
+        versionLabel: resolvedVersionLabel,
+        normalizedJson: normalizedDoc,
+        metadata: meta || null,
+        schemaVersion: normalizedDoc?.schemaVersion ?? null,
+        title,
+        abstractText,
+        licenseFromMeta,
+        license: raw.license ?? null,
+        source: raw.source,
+        sourceUrl: raw.url ?? null,
+        rawXml: raw.content,
+        blocks,
+        sections,
+        citations,
+        assets,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/works/text/normalize.js.map

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

package/dist/works/types.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Pure types for the works domain.
+ * No Prisma, no S3, no Fastify dependencies.
+ */
+export type VersionSource = "biorxiv" | "medrxiv" | "arxiv" | "publisher" | "plos" | "elife" | "osf" | "pmc" | "other";
+export type ActionsExternalType = "doi" | "pmid" | "pmcid" | "arxivId" | "biorxivId" | "medrxivId" | "openalexId";
+export type ActionsIdBody = {
+    externalIdType: ActionsExternalType;
+    id: string;
+};
+export type Coordinator = {
+    workExists: boolean;
+    versionExists: boolean;
+    isOpenAccess: boolean;
+    sourceKind: VersionSource;
+    sourceName?: string | null;
+    actions: {
+        ensureWork: boolean;
+        ensureVersion: boolean;
+        fetchFullText: boolean;
+    };
+    chosenVersionLabel: string;
+    matched: {
+        work_id?: string;
+        versionId?: string | null;
+    };
+    reasons: string[];
+    conflict?: boolean;
+};
+export type VersionStage = "journal" | "preprint" | "unknown";
+export type WorkRollup = {
+    title: string;
+    abstract?: string;
+    landingUrl?: string;
+    isOpenAccess: boolean;
+    bestLicense?: string;
+    firstPublishedAt?: string;
+};
+export type UpstreamSource = "crossref" | "openalex" | "europepmc";
+export type AdapterResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    status?: number;
+    reason: "not_found" | "rate_limited" | "upstream_error" | "network_error";
+};
+export type UpstreamError = {
+    source: UpstreamSource;
+    status?: number;
+    reason: string;
+};
+export type ResolutionMeta = {
+    sourceKind?: VersionSource;
+    sourceName?: string | null;
+    versionStage?: VersionStage;
+    versionConfidence?: number;
+    versionEvidence?: string[];
+    confirmedBy?: UpstreamSource[];
+    upstreamErrors?: UpstreamError[];
+};
+export type ResolvedIds = Partial<{
+    doi: string;
+    pmid: string;
+    pmcid: string;
+    arxivId: string;
+    biorxivId: string;
+    medrxivId: string;
+    openalexId: string;
+}>;
+export type ResolvedMetadata = Partial<{
+    landingUrl: string;
+    license: string;
+    bestLicense: string;
+    publisher: string;
+    title: string;
+    abstract: string;
+    journal: string;
+    year: number;
+    version: string;
+    isPreprint: boolean;
+    isOpenAccess: boolean;
+    bestPdfUrl: string;
+    firstPublishedAt: string;
+}> & ResolutionMeta & {
+    workRollup?: WorkRollup;
+};
+export type CompleteIds = ResolvedIds & ResolvedMetadata;
+export type FullTextType = "jats-xml" | "html" | "pdf";
+export type FullTextResult = {
+    type: FullTextType;
+    source: string;
+    url?: string;
+    content?: string;
+    license?: string;
+    versionLabel?: string;
+    json?: unknown;
+    licenseHref?: string;
+    licenseBucket?: string;
+};
+export type IngestWorkResult = {
+    work_id: string;
+    completeIds: CompleteIds;
+    fullText?: FullTextResult | null;
+    warnings?: string[];
+};
+export type OpenAlexIds = {
+    openalex?: string;
+    doi?: string | null;
+    pmid?: string | null;
+    pmcid?: string | null;
+};
+export type OpenAlexLocation = {
+    source?: {
+        id?: string | null;
+        display_name?: string | null;
+    } | null;
+    landing_page_url?: string | null;
+    pdf_url?: string | null;
+    is_oa?: boolean;
+    license?: string | null;
+};
+export type OpenAlexWork = {
+    id?: string;
+    ids?: OpenAlexIds;
+    title?: string | null;
+    display_name?: string | null;
+    primary_location?: OpenAlexLocation | null;
+    best_oa_location?: OpenAlexLocation | null;
+    locations?: OpenAlexLocation[] | null;
+    host_venue?: {
+        display_name?: string | null;
+        publisher?: string | null;
+    } | null;
+    publication_year?: number | null;
+    publication_date?: string | null;
+    abstract_inverted_index?: Record<string, number[]> | null;
+};
+export type LoggerLike = {
+    warn?: (obj: any, msg?: string) => void;
+    info?: (obj: any, msg?: string) => void;
+    error?: (obj: any, msg?: string) => void;
+    debug?: (obj: any, msg?: string) => void;
+};
+export type IngestWorkOptions = {
+    logger?: LoggerLike;
+    debug?: boolean;
+};
+export type IngestLogger = LoggerLike | undefined;
+export type S3RawSaved = {
+    key: string;
+    sha256?: string | null;
+    sizeBytes?: number | null;
+    etag?: string | null;
+};
+export type Step = {
+    kind: "ReturnExisting";
+    work_id: string;
+    versionId: string | null;
+} | {
+    kind: "LoadMatchedWork";
+    work_id: string;
+} | {
+    kind: "FetchFullText";
+} | {
+    kind: "NormalizeFullText";
+    versionLabel: string;
+} | {
+    kind: "NormalizePdf";
+    versionLabel: string;
+} | {
+    kind: "EnsureWork";
+} | {
+    kind: "PersistRawBundle";
+    versionLabel: string;
+} | {
+    kind: "EnsureVersion";
+    versionLabel: string;
+} | {
+    kind: "FinalizeFullText";
+    versionLabel: string;
+};
+export type StrategyAttempt = {
+    strategy: string;
+    matched: boolean;
+    attempted: boolean;
+    succeeded: boolean;
+    error?: string;
+    skipReason?: string;
+};
+export type IngestResult = {
+    work_id: string;
+    completeIds: CompleteIds;
+    fullText: FullTextResult | null;
+    warnings?: string[];
+};
+export type FetchTextResult = {
+    text: string | null;
+    finalUrl?: string;
+    failureReason?: "not_found" | "rate_limited" | "server_error" | "network_error" | "empty_response";
+    lastStatus?: number;
+};
+export type FetchTextFn = (url: string, accept?: string, tries?: number) => Promise<FetchTextResult>;
+export type StrategyContext = {
+    fetchText: FetchTextFn;
+};
+export type FullTextStrategy = {
+    name: string;
+    matches: (ids: CompleteIds) => boolean;
+    getFullText: (ids: CompleteIds, ctx: StrategyContext) => Promise<FullTextResult | null>;
+};
+export type PlanOptions = {
+    hasPdf?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/works/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/works/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,OAAO,GACP,WAAW,GACX,MAAM,GACN,OAAO,GACP,KAAK,GACL,KAAK,GACL,OAAO,CAAC;AAGZ,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,MAAM,GACN,OAAO,GACP,SAAS,GACT,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,EAAE,mBAAmB,CAAC;IACpC,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAGF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,OAAO,EAAE;QACP,UAAU,EAAE,OAAO,CAAC;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IAEF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAGF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnE,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,gBAAgB,GAAG,eAAe,CAAC;CAC3E,CAAC;AAEN,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,GACA,cAAc,GAAG;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEJ,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACrE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AACF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GAAG,IAAI,CAAC;IACT,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,IAAI,GACZ;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EACV,WAAW,GACX,cAAc,GACd,cAAc,GACd,eAAe,GACf,gBAAgB,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,KACX,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B,MAAM,MAAM,eAAe,GAAG;IAAE,SAAS,EAAE,WAAW,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;IACvC,WAAW,EAAE,CACX,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,eAAe,KACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/dist/works/types.js

@@ -0,0 +1,6 @@
+/**
+ * Pure types for the works domain.
+ * No Prisma, no S3, no Fastify dependencies.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/works/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/works/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/works/util/debug.d.ts

@@ -0,0 +1,7 @@
+export declare function parseDebugFlag(v: unknown): boolean;
+export type LoggerLike = {
+    warn?: (obj: any, msg?: string) => void;
+    info?: (obj: any, msg?: string) => void;
+    error?: (obj: any, msg?: string) => void;
+};
+//# sourceMappingURL=debug.d.ts.map

package/dist/works/util/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/works/util/debug.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAKlD;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C,CAAC"}

package/dist/works/util/debug.js

@@ -0,0 +1,9 @@
+export function parseDebugFlag(v) {
+    if (typeof v === "boolean")
+        return v;
+    if (v === undefined || v === null)
+        return false;
+    const s = String(v).trim().toLowerCase();
+    return s === "1" || s === "true" || s === "yes" || s === "on";
+}
+//# sourceMappingURL=debug.js.map

package/dist/works/util/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../src/works/util/debug.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,CAAU;IACvC,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC;AAChE,CAAC"}

package/dist/works/util/license.d.ts

@@ -0,0 +1,9 @@
+type Lic = string | {
+    href?: string | null;
+    type?: string | null;
+    text?: string | null;
+} | null | undefined;
+export declare function normalizeLicenseHref(x: Lic): string | null;
+export declare function licenseBucket(x: Lic): string;
+export {};
+//# sourceMappingURL=license.d.ts.map

package/dist/works/util/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../../src/works/util/license.ts"],"names":[],"mappings":"AAAA,KAAK,GAAG,GACJ,MAAM,GACN;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACpE,IAAI,GACJ,SAAS,CAAC;AAEd,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAa1D;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAwB5C"}

package/dist/works/util/license.js

@@ -0,0 +1,39 @@
+export function normalizeLicenseHref(x) {
+    const href = typeof x === "string" ? (x.startsWith("http") ? x : null) : x?.href ?? null;
+    if (!href)
+        return null;
+    try {
+        const u = new URL(href);
+        // enforce https, drop www, strip query/fragment, collapse trailing slashes
+        const host = u.host.replace(/^www\./, "").toLowerCase();
+        const path = u.pathname.replace(/\/+$/, "/").toLowerCase();
+        return `https://${host}${path}`;
+    }
+    catch {
+        return null;
+    }
+}
+export function licenseBucket(x) {
+    const href = normalizeLicenseHref(x);
+    const text = (typeof x === "string" ? x : [x?.type, x?.text].filter(Boolean).join(" ")).toLowerCase();
+    if (/\ball[-\s]?rights[-\s]?reserved\b/.test(text))
+        return "arr";
+    if (/\bpublic\s*domain\b/.test(text))
+        return "pd";
+    if (href) {
+        const m = href.match(/creativecommons\.org\/licenses\/([a-z-]+)\/([0-9.]+)\//i);
+        if (m)
+            return `cc-${m[1]}-${m[2]}`.toLowerCase();
+        return `custom-${new URL(href).host}`;
+    }
+    // quick textual CC fallback like "CC BY 4.0"
+    if (/\bcc\b/.test(text) && /\bby\b/.test(text)) {
+        const flags = ["by", "nc", "nd", "sa"]
+            .filter((f) => text.includes(f))
+            .join("-");
+        const ver = (text.match(/\b\d+\.\d+\b/) || [])[0];
+        return `cc-${flags}${ver ? `-${ver}` : ""}`;
+    }
+    return "unknown";
+}
+//# sourceMappingURL=license.js.map

package/dist/works/util/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../../../src/works/util/license.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,oBAAoB,CAAC,CAAM;IACzC,MAAM,IAAI,GACR,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IAC9E,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,2EAA2E;QAC3E,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3D,OAAO,WAAW,IAAI,GAAG,IAAI,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAM;IAClC,MAAM,IAAI,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,CACX,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACzE,CAAC,WAAW,EAAE,CAAC;IAEhB,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjE,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAClB,yDAAyD,CAC1D,CAAC;QACF,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,UAAU,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IACD,6CAA6C;IAC7C,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;aACnC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;aAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/works/util/normalize.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeIds<T extends Record<string, any>>(ids: T): T;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/works/util/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/works/util/normalize.ts"],"names":[],"mappings":"AASA,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CA0ErE"}