@manta-eu/react 0.1.0

package/dist/lib/ontology-terms.d.ts

@@ -0,0 +1,16 @@
+import type { RDF } from "ldkit/rdf";
+export type OntologyTerm = {
+    iri: string;
+    label?: string;
+    comment?: string;
+    unitCode?: string;
+    valueScale?: number;
+    domainIncludes: string[];
+    rangeIncludes: string[];
+    subClassOf: string[];
+    personalDataCategories: string[];
+};
+export declare function buildOntologyTermsQuery(iris: string[], graphIri: string): string;
+export declare function cleanOntologyComment(raw?: string): string | undefined;
+export declare function bindingsToOntologyTerms(bindings: RDF.Bindings[]): Map<string, OntologyTerm>;
+//# sourceMappingURL=ontology-terms.d.ts.map

package/dist/lib/ontology-terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ontology-terms.d.ts","sourceRoot":"","sources":["../../src/lib/ontology-terms.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGrC,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC,CAAC;AAiBF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA+BhF;AAED,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrE;AA6BD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CA0C3F"}

package/dist/lib/ontology-terms.js

@@ -0,0 +1,100 @@
+import { isQueryableTermIri } from "@manta-eu/datalog-parser";
+import { namespaces } from "@manta-eu/rdf-lib/namespaces";
+import { bindingValue } from "./rdf-helpers.js";
+const multiValuedPredicates = [
+    { variable: "domain", predicate: "schema:domainIncludes", field: "domainIncludes" },
+    { variable: "range", predicate: "schema:rangeIncludes", field: "rangeIncludes" },
+    { variable: "superClass", predicate: "rdfs:subClassOf", field: "subClassOf" },
+    { variable: "personalDataCategory", predicate: "dpv:hasPersonalData", field: "personalDataCategories" },
+];
+export function buildOntologyTermsQuery(iris, graphIri) {
+    if (!isQueryableTermIri(graphIri)) {
+        throw new Error(`Ontology graph IRI is not an absolute IRI: ${graphIri}`);
+    }
+    const values = iris
+        .filter(isQueryableTermIri)
+        .map((iri) => `<${iri}>`)
+        .join(" ");
+    const variables = multiValuedPredicates.map(({ variable }) => `?${variable}`).join(" ");
+    const optionalPatterns = multiValuedPredicates
+        .map(({ variable, predicate }) => `    OPTIONAL { ?term ${predicate} ?${variable} }`)
+        .join("\n");
+    return `
+PREFIX rdfs: <${namespaces.rdfs}>
+PREFIX schema: <${namespaces.schema}>
+PREFIX dpv: <${namespaces.dpv}>
+PREFIX : <${namespaces[""]}>
+
+SELECT ?term ?label ?comment ?unitCode ?valueScale ${variables} WHERE {
+  GRAPH <${graphIri}> {
+    VALUES ?term { ${values} }
+    OPTIONAL { ?term rdfs:label ?label }
+    OPTIONAL { ?term rdfs:comment ?comment }
+    OPTIONAL { ?term schema:unitCode ?unitCode }
+    OPTIONAL { ?term :valueScale ?valueScale }
+${optionalPatterns}
+  }
+}`;
+}
+export function cleanOntologyComment(raw) {
+    if (!raw)
+        return undefined;
+    return raw
+        .replace(/\\n/g, " ")
+        .replace(/\[\[([^\]]+)\]\]/g, "$1")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function parseValueScale(raw) {
+    if (!raw)
+        return undefined;
+    const value = Number(raw);
+    return Number.isFinite(value) && value > 0 ? value : undefined;
+}
+function emptyAccumulator() {
+    return {
+        fields: {
+            domainIncludes: new Set(),
+            rangeIncludes: new Set(),
+            subClassOf: new Set(),
+            personalDataCategories: new Set(),
+        },
+    };
+}
+export function bindingsToOntologyTerms(bindings) {
+    const accumulators = new Map();
+    for (const binding of bindings) {
+        const iri = bindingValue(binding, "term");
+        if (!iri)
+            continue;
+        let accumulator = accumulators.get(iri);
+        if (!accumulator) {
+            accumulator = emptyAccumulator();
+            accumulators.set(iri, accumulator);
+        }
+        accumulator.label ??= bindingValue(binding, "label");
+        accumulator.comment ??= cleanOntologyComment(bindingValue(binding, "comment"));
+        accumulator.unitCode ??= bindingValue(binding, "unitCode");
+        accumulator.valueScale ??= parseValueScale(bindingValue(binding, "valueScale"));
+        for (const { variable, field } of multiValuedPredicates) {
+            const value = bindingValue(binding, variable);
+            if (value)
+                accumulator.fields[field].add(value);
+        }
+    }
+    const terms = new Map();
+    for (const [iri, accumulator] of accumulators) {
+        terms.set(iri, {
+            iri,
+            label: accumulator.label,
+            comment: accumulator.comment,
+            unitCode: accumulator.unitCode,
+            valueScale: accumulator.valueScale,
+            domainIncludes: [...accumulator.fields.domainIncludes],
+            rangeIncludes: [...accumulator.fields.rangeIncludes],
+            subClassOf: [...accumulator.fields.subClassOf],
+            personalDataCategories: [...accumulator.fields.personalDataCategories],
+        });
+    }
+    return terms;
+}

package/dist/lib/plan-status-label.d.ts

@@ -0,0 +1,3 @@
+import type { ActionPlanStatus } from "@manta-eu/client/shared/tools";
+export declare function planStatusLabel(state: ActionPlanStatus): string;
+//# sourceMappingURL=plan-status-label.d.ts.map

package/dist/lib/plan-status-label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-status-label.d.ts","sourceRoot":"","sources":["../../src/lib/plan-status-label.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAQ/D"}

package/dist/lib/plan-status-label.js

@@ -0,0 +1,10 @@
+import { match } from "ts-pattern";
+export function planStatusLabel(state) {
+    return match(state)
+        .with("DRAFT", () => "Draft plan")
+        .with("RUNNING", () => "Plan is running")
+        .with("COMPLETED", () => "Plan completed")
+        .with("FAILED", () => "Plan failed")
+        .with("TIMED_OUT", () => "Plan timed out")
+        .exhaustive();
+}

package/dist/lib/provenance-state.d.ts

@@ -0,0 +1,8 @@
+import type { RDF } from "ldkit/rdf";
+export type ActionPlanState = "DRAFT" | "RUNNING" | "COMPLETED" | "FAILED" | "TIMED_OUT";
+export declare function coerceActionPlanState(raw: string | null | undefined): ActionPlanState;
+export declare function buildSinglePlanStateQuery(planGraphIri: string): string;
+export declare function buildExplicitStateQuery(planGraphIri: string): string;
+export declare function readStateBinding(binding: RDF.Bindings | undefined): ActionPlanState;
+export declare function mergeStates(provenanceState: ActionPlanState, explicitState: ActionPlanState | null): ActionPlanState;
+//# sourceMappingURL=provenance-state.d.ts.map

package/dist/lib/provenance-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance-state.d.ts","sourceRoot":"","sources":["../../src/lib/provenance-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAKrC,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAIzF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,CAKrF;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,GAAG,eAAe,CAEnF;AAED,wBAAgB,WAAW,CAAC,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,GAAG,IAAI,GAAG,eAAe,CAGpH"}

package/dist/lib/provenance-state.js

@@ -0,0 +1,34 @@
+import { DataFactory } from "ldkit/rdf";
+import { SELECT } from "ldkit/sparql";
+const df = new DataFactory();
+const VALID_STATES = ["DRAFT", "RUNNING", "COMPLETED", "FAILED", "TIMED_OUT"];
+export function coerceActionPlanState(raw) {
+    if (raw && VALID_STATES.includes(raw)) {
+        return raw;
+    }
+    return "DRAFT";
+}
+export function buildSinglePlanStateQuery(planGraphIri) {
+    const planNode = df.namedNode(planGraphIri);
+    return SELECT `?graph ?stateValue ?latestStarted ?hasCurrentFacts`.WHERE `
+    VALUES ?graph { ${planNode} }
+    OPTIONAL { ?graph :planState ?rawStateValue . }
+    OPTIONAL { ?graph :latestStarted ?latestStarted . }
+    BIND(COALESCE(?rawStateValue, "DRAFT") AS ?stateValue)
+    BIND(EXISTS { GRAPH ?graph { ?subject ?predicate ?object EXPLICIT FALSE } } AS ?hasCurrentFacts)
+  `.build();
+}
+export function buildExplicitStateQuery(planGraphIri) {
+    const planNode = df.namedNode(planGraphIri);
+    return SELECT `?explicitState`.WHERE `
+    GRAPH ${planNode} { ${planNode} :state ?explicitState }
+  `.build();
+}
+export function readStateBinding(binding) {
+    return coerceActionPlanState(binding?.get("stateValue")?.value);
+}
+export function mergeStates(provenanceState, explicitState) {
+    if (provenanceState !== "DRAFT")
+        return provenanceState;
+    return explicitState ?? "DRAFT";
+}

package/dist/lib/rdf/index.d.ts

@@ -0,0 +1,17 @@
+import type { JsonLdGraphDocument, JsonLdNode } from "@manta-eu/client/types/jsonld";
+import type { CampaignChannelMixData, CampaignGridData, CampaignPerformanceSummaryData, CompanyKpis, DailyPerformanceData, MetaDailyInsightsData, Product, ProductProfitabilityData, ProductSalesRankingData, ProductVariant, ProductVariantsData, RoasBenchmarkData } from "./types.js";
+export * from "@manta-eu/client/shared/rdf-namespaces";
+export declare function getString(node: JsonLdNode, predicate: string): string | null;
+export declare function extractProduct(jsonLd: JsonLdGraphDocument): Product | null;
+export declare function extractProductVariant(jsonLd: JsonLdGraphDocument, productUri: string): ProductVariant | null;
+export declare function extractCompanyKpis(jsonLd: JsonLdGraphDocument): CompanyKpis | null;
+export declare function extractDailyPerformance(jsonLd: JsonLdGraphDocument): DailyPerformanceData | null;
+export declare function extractProductProfitability(jsonLd: JsonLdGraphDocument): ProductProfitabilityData | null;
+export declare function extractCampaignPerformanceSummary(jsonLd: JsonLdGraphDocument): CampaignPerformanceSummaryData | null;
+export declare function extractProductSalesRanking(jsonLd: JsonLdGraphDocument): ProductSalesRankingData | null;
+export declare function extractRoasBenchmark(jsonLd: JsonLdGraphDocument): RoasBenchmarkData | null;
+export declare function extractMetaDailyInsights(jsonLd: JsonLdGraphDocument): MetaDailyInsightsData | null;
+export declare function extractCampaignChannelMix(jsonLd: JsonLdGraphDocument): CampaignChannelMixData | null;
+export declare function extractProductVariants(jsonLd: JsonLdGraphDocument): ProductVariantsData | null;
+export declare function extractCampaignGrid(jsonLd: JsonLdGraphDocument): CampaignGridData | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/rdf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/rdf/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAIrF,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,8BAA8B,EAC9B,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,OAAO,EACP,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,cAAc,wCAAwC,CAAC;AAEvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5E;AAsDD,wBAAgB,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,GAAG,IAAI,CA+B1E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAoB5G;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAiBlF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,IAAI,CA8BhG;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,wBAAwB,GAAG,IAAI,CAuCxG;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,mBAAmB,GAAG,8BAA8B,GAAG,IAAI,CAqCpH;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,uBAAuB,GAAG,IAAI,CAsDtG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,IAAI,CA6B1F;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,qBAAqB,GAAG,IAAI,CA0ClG;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,sBAAsB,GAAG,IAAI,CAkCpG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,IAAI,CAgD9F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,IAAI,CAwCxF"}

package/dist/lib/rdf/index.js

@@ -0,0 +1,416 @@
+import { expandPrefix } from "@manta-eu/client/shared/rdf-namespaces";
+import { getStringValue, getNumberValue, getRefId, getNodeTypes } from "@manta-eu/client/types/jsonld";
+import { isPresent } from "@manta-eu/lib/present";
+import { isNotNil } from "ramda";
+export * from "@manta-eu/client/shared/rdf-namespaces";
+export function getString(node, predicate) {
+    const expandedPredicate = expandPrefix(predicate);
+    return getStringValue(node, expandedPredicate) || getStringValue(node, predicate);
+}
+function getNumber(node, predicate) {
+    const expandedPredicate = expandPrefix(predicate);
+    return getNumberValue(node, expandedPredicate) ?? getNumberValue(node, predicate);
+}
+function getRef(node, predicate) {
+    const expandedPredicate = expandPrefix(predicate);
+    return getRefId(node, expandedPredicate) || getRefId(node, predicate);
+}
+function findNodesByType(nodes, rdfType) {
+    const typeUri = expandPrefix(rdfType);
+    return nodes.filter((node) => {
+        const nodeTypes = getNodeTypes(node).map(expandPrefix);
+        return nodeTypes.includes(typeUri);
+    });
+}
+function findNodeById(nodes, id) {
+    return nodes.find((node) => node["@id"] === id);
+}
+function parseTags(tagString) {
+    if (!tagString)
+        return null;
+    try {
+        const parsed = JSON.parse(tagString);
+        return Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function getProductName(productNode) {
+    if (!productNode)
+        return null;
+    return (getString(productNode, "rdfs:label") || getString(productNode, ":title") || getString(productNode, "schema:name"));
+}
+function getVariantName(variantNode) {
+    if (!variantNode)
+        return null;
+    return getString(variantNode, "schema:name") || getString(variantNode, ":title");
+}
+function getCampaignName(campaignNode) {
+    if (!campaignNode)
+        return null;
+    return (getString(campaignNode, "schema:name") || getString(campaignNode, "rdfs:label") || getString(campaignNode, ":name"));
+}
+export function extractProduct(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const productNodes = findNodesByType(nodes, ":Product");
+    const productNode = productNodes[0];
+    if (!productNode) {
+        return null;
+    }
+    const uri = productNode["@id"];
+    if (!uri)
+        return null;
+    const name = getProductName(productNode);
+    if (!name) {
+        return null;
+    }
+    const tagsRaw = getString(productNode, "shopify:tags");
+    return {
+        uri,
+        name,
+        vendor: getString(productNode, ":vendor"),
+        url: getString(productNode, "schema:url"),
+        tags: parseTags(tagsRaw),
+        availability: getString(productNode, ":availability"),
+        quantity: getNumber(productNode, ":quantity"),
+    };
+}
+export function extractProductVariant(jsonLd, productUri) {
+    const nodes = jsonLd["@graph"];
+    const variantNodes = findNodesByType(nodes, ":ProductVariant");
+    for (const variantNode of variantNodes) {
+        const linkedProductUri = getRef(variantNode, ":product");
+        if (linkedProductUri === productUri) {
+            const uri = variantNode["@id"];
+            if (!uri)
+                continue;
+            return {
+                uri,
+                price: getNumber(variantNode, ":price"),
+                cost: getNumber(variantNode, ":cost"),
+                title: getVariantName(variantNode),
+            };
+        }
+    }
+    return null;
+}
+export function extractCompanyKpis(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const kpiNodes = findNodesByType(nodes, ":CompanyKPISnapshot");
+    const kpiNode = kpiNodes[0];
+    if (!kpiNode)
+        return null;
+    return {
+        mer30d: getNumber(kpiNode, ":mer30d"),
+        blendedRoas30d: getNumber(kpiNode, ":blendedRoas30d"),
+        blendedCac30dUsd: getNumber(kpiNode, ":blendedCac30dUsd"),
+        last30dSpendUsd: getNumber(kpiNode, ":last30dSpendUsd"),
+        last30dRevenueUsd: getNumber(kpiNode, ":last30dRevenueUsd"),
+        avgAov30d: getNumber(kpiNode, ":avgAov30d"),
+        grossMargin30d: getNumber(kpiNode, ":grossMargin30d"),
+    };
+}
+export function extractDailyPerformance(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const snapshotNodes = findNodesByType(nodes, ":BlendedPerformanceDaily");
+    if (!isPresent(snapshotNodes)) {
+        return null;
+    }
+    const days = snapshotNodes
+        .map((node) => {
+        const date = getString(node, ":date");
+        const revenue = getNumber(node, ":shopifyRevenueUsd");
+        const spend = getNumber(node, ":metaSpendUsd");
+        const orders = getNumber(node, ":shopifyOrders");
+        if (!date || revenue === null || spend === null || orders === null) {
+            return null;
+        }
+        return { date, revenue, spend, orders };
+    })
+        .filter(isNotNil)
+        .sort((a, b) => a.date.localeCompare(b.date));
+    if (!isPresent(days)) {
+        return null;
+    }
+    return { days };
+}
+export function extractProductProfitability(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const profitabilityNodes = findNodesByType(nodes, ":ProductProfitability");
+    if (!isPresent(profitabilityNodes)) {
+        return null;
+    }
+    const products = profitabilityNodes
+        .map((node) => {
+        const uri = node["@id"];
+        if (!uri)
+            return null;
+        // Try to get the inlined product name first (from the new inlining rule)
+        let productName = getString(node, ":productName");
+        // Fallback to looking up the product entity if inlined name not available
+        if (!productName) {
+            const productUri = getRef(node, ":product");
+            const productNode = productUri ? findNodeById(nodes, productUri) : undefined;
+            productName = getProductName(productNode);
+        }
+        return {
+            uri,
+            productName,
+            revenueUsd: getNumber(node, ":revenueUsd") || 0,
+            cogsUsd: getNumber(node, ":cogsUsd") || 0,
+            grossProfitUsd: getNumber(node, ":grossProfitUsd") || 0,
+            grossMarginPct: getNumber(node, ":grossMarginPct") || 0,
+            profitPerUnitUsd: getNumber(node, ":profitPerUnitUsd"),
+            marginEfficiencyScore: getNumber(node, ":marginEfficiencyScore"),
+        };
+    })
+        .filter(isNotNil)
+        .filter((p) => p.revenueUsd > 0);
+    return isPresent(products) ? { products } : null;
+}
+export function extractCampaignPerformanceSummary(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const summaryNodes = findNodesByType(nodes, ":CampaignPerformanceSummary");
+    if (!isPresent(summaryNodes)) {
+        return null;
+    }
+    const campaigns = summaryNodes
+        .map((node) => {
+        const uri = node["@id"];
+        if (!uri)
+            return null;
+        const campaignUri = getRef(node, ":campaign");
+        const campaignNode = campaignUri ? findNodeById(nodes, campaignUri) : undefined;
+        const campaignName = getCampaignName(campaignNode);
+        const status = campaignNode ? getString(campaignNode, ":status") : null;
+        return {
+            uri,
+            campaignName,
+            status,
+            spendUsd: getNumber(node, ":spendUsd") || 0,
+            revenueUsd: getNumber(node, ":revenueUsd") || 0,
+            roas: getNumber(node, ":roas") || 0,
+            impressions: getNumber(node, ":impressions"),
+            clicks: getNumber(node, ":clicks"),
+            ctr: getNumber(node, ":ctr"),
+            conversions: getNumber(node, ":conversions"),
+            costPerConversion: getNumber(node, ":costPerConversion"),
+        };
+    })
+        .filter(isNotNil)
+        .filter((c) => c.spendUsd > 0 || c.revenueUsd > 0);
+    return isPresent(campaigns) ? { campaigns } : null;
+}
+export function extractProductSalesRanking(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const rankingNodes = findNodesByType(nodes, ":ProductSalesRanking");
+    if (!isPresent(rankingNodes)) {
+        return null;
+    }
+    const products = rankingNodes
+        .map((node) => {
+        const uri = node["@id"];
+        const rank = getNumber(node, ":rank");
+        if (!uri || rank === null) {
+            return null;
+        }
+        // Try to get the inlined product name first (from the new inlining rule)
+        let productName = getString(node, ":productName");
+        // Fallback to looking up the product entity if inlined name not available
+        if (!productName) {
+            const productUri = getRef(node, ":product");
+            const productNode = productUri ? findNodeById(nodes, productUri) : undefined;
+            productName = getProductName(productNode);
+        }
+        return {
+            uri,
+            rank,
+            productName,
+            totalRevenueUsd: getNumber(node, ":totalRevenueUsd") || 0,
+            orderCount: getNumber(node, ":orderCount") || 0,
+            avgOrderValueUsd: getNumber(node, ":avgOrderValueUsd"),
+            revenueSharePct: getNumber(node, ":revenueSharePct"),
+        };
+    })
+        .filter(isNotNil)
+        .filter((p) => p.totalRevenueUsd > 0)
+        .sort((a, b) => {
+        // Primary sort: by rank
+        if (a.rank !== b.rank) {
+            return a.rank - b.rank;
+        }
+        // Secondary sort: by revenue descending (in case ranks are the same)
+        return b.totalRevenueUsd - a.totalRevenueUsd;
+    })
+        .map((product, index) => ({
+        ...product,
+        rank: index + 1, // Re-assign ranks to ensure sequential numbering
+    }));
+    return isPresent(products) ? { products } : null;
+}
+export function extractRoasBenchmark(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const benchmarkNodes = findNodesByType(nodes, ":CampaignChannelBenchmark");
+    if (!isPresent(benchmarkNodes)) {
+        return null;
+    }
+    const benchmarks = benchmarkNodes
+        .map((node) => {
+        const uri = node["@id"];
+        if (!uri)
+            return null;
+        return {
+            uri,
+            campaignChannel: getString(node, ":campaignChannel"),
+            avgRoas: getNumber(node, ":avgRoas"),
+            medianRoas: getNumber(node, ":medianRoas"),
+            stddevRoas: getNumber(node, ":stddevRoas"),
+            percentile25Roas: getNumber(node, ":percentile25Roas"),
+            percentile75Roas: getNumber(node, ":percentile75Roas"),
+            avgBlendedRoas: getNumber(node, ":avgBlendedRoas"),
+            medianBlendedRoas: getNumber(node, ":medianBlendedRoas"),
+        };
+    })
+        .filter(isNotNil);
+    return isPresent(benchmarks) ? { benchmarks } : null;
+}
+export function extractMetaDailyInsights(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const insightNodes = findNodesByType(nodes, "meta:CampaignDailyCumulativeInsights");
+    if (!isPresent(insightNodes)) {
+        return null;
+    }
+    const firstInsight = insightNodes[0];
+    if (!firstInsight) {
+        return null;
+    }
+    const campaignUri = getRef(firstInsight, "meta:belongsToCampaign") || "";
+    const campaignNode = campaignUri ? findNodeById(nodes, campaignUri) : undefined;
+    const campaignName = getCampaignName(campaignNode);
+    const days = insightNodes
+        .map((node) => {
+        const date = getString(node, "schema:dateCreated");
+        const spend = getNumber(node, "meta:spend");
+        const revenue = getNumber(node, "meta:grossRevenue");
+        const roas = getNumber(node, "meta:reportedRoas");
+        const impressions = getNumber(node, "meta:impressions");
+        const clicks = getNumber(node, "meta:clicks");
+        const ctr = getNumber(node, "meta:ctr");
+        const purchases = getNumber(node, "meta:reportedPurchases");
+        if (!date || spend === null || revenue === null || roas === null) {
+            return null;
+        }
+        return { date, spend, revenue, roas, impressions, clicks, ctr, purchases };
+    })
+        .filter(isNotNil)
+        .sort((a, b) => a.date.localeCompare(b.date));
+    if (!isPresent(days)) {
+        return null;
+    }
+    return { campaignUri, campaignName, days };
+}
+export function extractCampaignChannelMix(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const campaignNodes = findNodesByType(nodes, "meta:Campaign");
+    if (!isPresent(campaignNodes)) {
+        return null;
+    }
+    const channelMap = new Map();
+    campaignNodes.forEach((node) => {
+        const channel = getString(node, "meta:campaignChannel") || "Meta";
+        const spend = getNumber(node, "meta:totalSpend") || 0;
+        const revenue = getNumber(node, "meta:totalRevenue") || 0;
+        const existing = channelMap.get(channel) || { count: 0, spend: 0, revenue: 0 };
+        channelMap.set(channel, {
+            count: existing.count + 1,
+            spend: existing.spend + spend,
+            revenue: existing.revenue + revenue,
+        });
+    });
+    const totalCampaigns = campaignNodes.length;
+    const channels = Array.from(channelMap.entries()).map(([channel, data]) => ({
+        channel,
+        campaignCount: data.count,
+        totalSpend: data.spend,
+        totalRevenue: data.revenue,
+        percentage: (data.count / totalCampaigns) * 100,
+    }));
+    return isPresent(channels) ? { channels } : null;
+}
+export function extractProductVariants(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const variantNodes = findNodesByType(nodes, ":ProductVariant");
+    if (!isPresent(variantNodes)) {
+        return null;
+    }
+    const variants = variantNodes
+        .map((node) => {
+        const uri = node["@id"];
+        if (!uri)
+            return null;
+        // Try to get the inlined product name first (from the new inlining rule)
+        let productName = getString(node, ":productName");
+        // Fallback to looking up the product entity if inlined name not available
+        if (!productName) {
+            const productUri = getRef(node, ":product");
+            const productNode = productUri ? findNodeById(nodes, productUri) : undefined;
+            productName = getProductName(productNode);
+        }
+        const variantName = getVariantName(node);
+        const sku = getString(node, ":sku");
+        const price = getNumber(node, ":price");
+        const cost = getNumber(node, ":cost");
+        const inventory = getNumber(node, ":inventoryQuantity");
+        const compareAtPrice = getNumber(node, ":compareAtPrice");
+        const marginPct = price !== null && cost !== null && price > 0 ? ((price - cost) / price) * 100 : null;
+        return {
+            uri,
+            productName,
+            variantName,
+            sku,
+            price,
+            cost,
+            marginPct,
+            inventory,
+            compareAtPrice,
+        };
+    })
+        .filter(isNotNil);
+    return isPresent(variants) ? { variants } : null;
+}
+export function extractCampaignGrid(jsonLd) {
+    const nodes = jsonLd["@graph"];
+    const campaignNodes = findNodesByType(nodes, "meta:Campaign");
+    if (!isPresent(campaignNodes)) {
+        return null;
+    }
+    const campaigns = campaignNodes
+        .map((node) => {
+        const uri = node["@id"];
+        if (!uri)
+            return null;
+        const name = getCampaignName(node);
+        const status = getString(node, "meta:campaignStatus");
+        const channel = getString(node, "meta:campaignChannel");
+        const spend = getNumber(node, "meta:totalSpend") || 0;
+        const revenue = getNumber(node, "meta:totalRevenue") || 0;
+        const roas = spend > 0 ? revenue / spend : 0;
+        const sparklineData = [];
+        for (let i = 0; i < 7; i++) {
+            sparklineData.push(Math.random() * revenue * 0.2 + revenue * 0.1);
+        }
+        return {
+            uri,
+            name,
+            status,
+            channel,
+            spend,
+            revenue,
+            roas,
+            sparklineData,
+        };
+    })
+        .filter(isNotNil);
+    return isPresent(campaigns) ? { campaigns } : null;
+}

package/dist/lib/rdf/insights.d.ts

@@ -0,0 +1,4 @@
+export declare function formatMetric(value: number, type: "currency" | "multiplier" | "percentage"): string;
+export declare function determineAvailabilityStatus(quantity?: number): "available" | "low-stock" | "made-to-order" | "out-of-stock";
+export declare function calculateExpectedRevenue(dailyBudget: number, roas: number, days?: number): number;
+//# sourceMappingURL=insights.d.ts.map

package/dist/lib/rdf/insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../../src/lib/rdf/insights.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAmBlG;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,CAAC,EAAE,MAAM,GAChB,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,CAgB9D;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,CAErG"}

package/dist/lib/rdf/insights.js

@@ -0,0 +1,34 @@
+import { isNotNil } from "ramda";
+export function formatMetric(value, type) {
+    if (type === "currency") {
+        return new Intl.NumberFormat("en-US", {
+            style: "currency",
+            currency: "USD",
+            minimumFractionDigits: 2,
+            maximumFractionDigits: 2,
+        }).format(value);
+    }
+    if (type === "percentage") {
+        return `${value.toFixed(1)}%`;
+    }
+    if (type === "multiplier") {
+        return `${value.toFixed(2)}x`;
+    }
+    return value.toString();
+}
+export function determineAvailabilityStatus(quantity) {
+    const quantityExists = isNotNil(quantity);
+    if (quantityExists && quantity < 0) {
+        return "made-to-order";
+    }
+    if (quantityExists && quantity === 0) {
+        return "out-of-stock";
+    }
+    if (quantityExists && quantity > 0 && quantity < 10) {
+        return "low-stock";
+    }
+    return "available";
+}
+export function calculateExpectedRevenue(dailyBudget, roas, days = 30) {
+    return dailyBudget * days * roas;
+}