@mints-cloud/cxf-codegen 1.0.3 → 1.0.4

package/dist/lib/seo-utils.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanString = cleanString;
+exports.pickFirstString = pickFirstString;
+exports.parseObject = parseObject;
+exports.parseObjectArray = parseObjectArray;
+exports.parseStringList = parseStringList;
+exports.toOriginUrl = toOriginUrl;
+exports.resolveUrlBase = resolveUrlBase;
+exports.getCurrentOrigin = getCurrentOrigin;
+exports.buildOrganizationId = buildOrganizationId;
+exports.toAbsoluteUrl = toAbsoluteUrl;
+exports.safeJsonForInlineScript = safeJsonForInlineScript;
+exports.toDomId = toDomId;
+exports.removeDuplicateJsonLdScripts = removeDuplicateJsonLdScripts;
+exports.tryParseLooseJson = tryParseLooseJson;
+function cleanString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function pickFirstString(...values) {
+    for (const value of values) {
+        const cleaned = cleanString(value);
+        if (cleaned)
+            return cleaned;
+    }
+    return undefined;
+}
+function parseObject(value, options) {
+    if (value == null)
+        return undefined;
+    if (typeof value === "object" && !Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value !== "string")
+        return undefined;
+    const maybeJson = value.trim();
+    if (!maybeJson)
+        return undefined;
+    const parseJson = options?.parseJson ?? JSON.parse;
+    try {
+        const parsed = parseJson(maybeJson);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function parseObjectArray(value, options) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value !== "string")
+        return [];
+    const maybeJson = value.trim();
+    if (!maybeJson)
+        return [];
+    const parseJson = options?.parseJson ?? JSON.parse;
+    try {
+        const parsed = parseJson(maybeJson);
+        if (Array.isArray(parsed)) {
+            return parsed.filter((item) => item && typeof item === "object");
+        }
+    }
+    catch {
+        return [];
+    }
+    return [];
+}
+function parseStringList(value) {
+    if (Array.isArray(value)) {
+        return value
+            .map((item) => cleanString(item))
+            .filter((item) => Boolean(item));
+    }
+    const raw = cleanString(value);
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            return parsed
+                .map((item) => cleanString(item))
+                .filter((item) => Boolean(item));
+        }
+    }
+    catch {
+        // Fall back to comma-separated values.
+    }
+    return raw
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function toOriginUrl(url) {
+    const cleaned = cleanString(url);
+    if (!cleaned)
+        return undefined;
+    const withProtocol = cleaned.startsWith("//") ? `https:${cleaned}` : cleaned;
+    try {
+        return new URL(withProtocol).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveUrlBase(...candidates) {
+    for (const candidate of candidates) {
+        const origin = toOriginUrl(candidate);
+        if (origin)
+            return origin;
+    }
+    return undefined;
+}
+function getCurrentOrigin() {
+    if (typeof window === "undefined")
+        return undefined;
+    return toOriginUrl(window.location.origin);
+}
+function buildOrganizationId(baseUrl) {
+    const origin = toOriginUrl(baseUrl);
+    if (!origin)
+        return undefined;
+    return `${origin}/#organization`;
+}
+function toAbsoluteUrl(pathOrUrl, baseUrl) {
+    const value = cleanString(pathOrUrl);
+    if (!value)
+        return undefined;
+    if (/^https?:\/\//i.test(value))
+        return value;
+    if (value.startsWith("//"))
+        return `https:${value}`;
+    const normalizedBase = resolveUrlBase(baseUrl);
+    const relativePath = value.startsWith("/") ? value : `/${value}`;
+    if (!normalizedBase)
+        return relativePath;
+    try {
+        return new URL(relativePath, `${normalizedBase}/`).href;
+    }
+    catch {
+        return relativePath;
+    }
+}
+function safeJsonForInlineScript(value) {
+    return JSON.stringify(value).replace(/</g, "\\u003c");
+}
+function toDomId(value) {
+    return value.replace(/[^a-zA-Z0-9\-_:.]/g, "-");
+}
+function removeDuplicateJsonLdScripts(scriptId, scriptKey, json) {
+    if (typeof document === "undefined")
+        return;
+    const canonical = document.getElementById(scriptId);
+    const allJsonLdScripts = Array.from(document.querySelectorAll("script[type='application/ld+json']"));
+    allJsonLdScripts.forEach((script) => {
+        if (script === canonical)
+            return;
+        const sameId = script.id === scriptId;
+        const sameKey = script.getAttribute("data-jsonld-key") === scriptKey;
+        const samePayloadOutsideHead = script.parentElement !== document.head && (script.textContent ?? "") === json;
+        if (sameId || sameKey || samePayloadOutsideHead) {
+            script.remove();
+        }
+    });
+}
+function isEscaped(input, index) {
+    let slashCount = 0;
+    for (let i = index - 1; i >= 0 && input[i] === "\\"; i -= 1) {
+        slashCount += 1;
+    }
+    return slashCount % 2 === 1;
+}
+function repairJsonInnerQuotes(input) {
+    let repaired = "";
+    let inString = false;
+    for (let i = 0; i < input.length; i += 1) {
+        const ch = input[i];
+        if (ch !== "\"") {
+            repaired += ch;
+            continue;
+        }
+        if (isEscaped(input, i)) {
+            repaired += ch;
+            continue;
+        }
+        if (!inString) {
+            inString = true;
+            repaired += ch;
+            continue;
+        }
+        let nextNonSpace = i + 1;
+        while (nextNonSpace < input.length && /\s/.test(input[nextNonSpace])) {
+            nextNonSpace += 1;
+        }
+        const next = input[nextNonSpace];
+        const closesString = nextNonSpace >= input.length ||
+            next === "," ||
+            next === "}" ||
+            next === "]" ||
+            next === ":";
+        if (closesString) {
+            inString = false;
+            repaired += ch;
+        }
+        else {
+            // Heuristic: treat inner raw quotes (commonly from HTML attributes) as escaped.
+            repaired += "\\\"";
+        }
+    }
+    return repaired;
+}
+function tryParseLooseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        const repaired = repairJsonInnerQuotes(value);
+        if (repaired !== value) {
+            return JSON.parse(repaired);
+        }
+        throw new Error("Invalid JSON");
+    }
+}

package/dist/pages/api/assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/pages/api/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAI5D,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,iBA0B/E;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/pages/api/assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAoB5D,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,iBAwC/E;AAED,eAAe,gBAAgB,CAAC"}

package/dist/pages/api/assets.js

@@ -3,6 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.assetsApiHandler = assetsApiHandler;
 const cxf_auth_1 = require("../../lib/cxf-auth");
 const api_route_helpers_1 = require("../../lib/api-route-helpers");
+const assets_query_params_1 = require("../../lib/assets-query-params");
+const CONDITIONAL_REQUEST_HEADERS = ["if-none-match", "if-modified-since"];
+const CACHE_RESPONSE_HEADERS = ["cache-control", "etag", "last-modified", "expires", "vary"];
+function getHeaderValue(header) {
+    if (Array.isArray(header))
+        return header.join(", ");
+    return header;
+}
+function forwardResponseHeaders(res, response) {
+    for (const headerName of CACHE_RESPONSE_HEADERS) {
+        const value = response.headers.get(headerName);
+        if (value)
+            res.setHeader(headerName, value);
+    }
+}
 async function assetsApiHandler(req, res) {
     if (req.method !== "GET") {
         res.setHeader("Allow", "GET");
@@ -11,15 +26,26 @@ async function assetsApiHandler(req, res) {
     try {
         const baseUrl = (0, cxf_auth_1.getCxfBaseUrl)();
         const normalizedPath = (0, api_route_helpers_1.normalizePath)(req.query.path);
-        const targetUrl = `${baseUrl}/assets/${normalizedPath}${(0, api_route_helpers_1.buildQueryString)(req.query)}`;
+        const paramsFromCookie = (0, assets_query_params_1.extractAssetQueryParamsFromCookie)(req.headers.cookie || null);
+        const mergedQuery = {
+            ...paramsFromCookie,
+            ...req.query,
+        };
+        const targetUrl = `${baseUrl}/assets/${normalizedPath}${(0, api_route_helpers_1.buildQueryString)(mergedQuery)}`;
+        const extraHeaders = CONDITIONAL_REQUEST_HEADERS.reduce((acc, headerName) => {
+            acc[headerName] = getHeaderValue(req.headers[headerName]);
+            return acc;
+        }, {});
         const { response, newTokens } = await (0, cxf_auth_1.makeAuthenticatedRequest)(targetUrl, {
             method: "GET",
             cookieHeader: req.headers.cookie || null,
             retryOnAuthError: false,
+            extraHeaders,
         });
         const setCookieHeaders = (0, cxf_auth_1.extractSetCookieHeaders)(response);
         const tokens = (0, cxf_auth_1.extractTokensFromSetCookie)(setCookieHeaders);
         const finalTokens = tokens.accessToken || tokens.refreshToken ? tokens : newTokens;
+        forwardResponseHeaders(res, response);
         (0, api_route_helpers_1.setAuthCookies)(res, finalTokens);
         return (0, api_route_helpers_1.sendResponse)(res, response);
     }

package/dist/pages/app.d.ts

@@ -1,9 +1,11 @@
 import type { AppProps } from "next/app";
 import * as React from "react";
+import { type AssetQueryParams } from "../lib/assets-query-params";
 type CxfAppProps = AppProps & {
     tokenClass?: string;
     appRootId?: string;
+    assetsQueryParams?: AssetQueryParams;
 };
-export declare function CxfApp({ Component, pageProps, tokenClass, appRootId }: CxfAppProps): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<React.AwaitedReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+export declare function CxfApp({ Component, pageProps, tokenClass, appRootId, assetsQueryParams, }: CxfAppProps): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<React.AwaitedReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
 export default CxfApp;
 //# sourceMappingURL=app.d.ts.map

package/dist/pages/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/pages/app.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,KAAK,WAAW,GAAG,QAAQ,GAAG;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAYF,wBAAgB,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAyB,EAAE,EAAE,WAAW,iKAkLlG;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/pages/app.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,KAAK,gBAAgB,EAA2B,MAAM,4BAA4B,CAAC;AAE5F,KAAK,WAAW,GAAG,QAAQ,GAAG;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC,CAAC;AAYF,wBAAgB,MAAM,CAAC,EACrB,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAyB,EACzB,iBAAiB,GAClB,EAAE,WAAW,iKAoLb;AAED,eAAe,MAAM,CAAC"}

package/dist/pages/app.js

@@ -43,15 +43,17 @@ const query_1 = require("@plasmicapp/react-web/lib/query");
 const head_1 = __importDefault(require("next/head"));
 const link_1 = __importDefault(require("next/link"));
 const React = __importStar(require("react"));
+const assets_query_params_1 = require("../lib/assets-query-params");
 function isNonEmptyObject(value) {
     return !!value && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length > 0;
 }
-function CxfApp({ Component, pageProps, tokenClass, appRootId = "plasmic-app" }) {
+function CxfApp({ Component, pageProps, tokenClass, appRootId = "plasmic-app", assetsQueryParams, }) {
     const storeRef = React.useRef({
         endpointData: {},
         queryCache: {},
         meta: {},
     });
+    (0, assets_query_params_1.useSyncAssetQueryParams)(assetsQueryParams);
     // Merge page props from hard loads / direct SSR navigation.
     const incoming = pageProps;
     if (isNonEmptyObject(incoming.endpointData)) {

package/dist/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAGA,wBAAgB,sBAAsB,SA4GrC"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAKA,wBAAgB,sBAAsB,SA6RrC"}

package/dist/register.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCodeComponents = registerCodeComponents;
 const host_1 = require("@plasmicapp/host");
 const ApiCall_1 = require("./components/ApiCall");
+const MetadataOverrides_1 = require("./components/MetadataOverrides");
+const JsonLdSchemas_1 = require("./components/JsonLdSchemas");
 function registerCodeComponents() {
     (0, host_1.registerComponent)(ApiCall_1.ApiCall, {
         name: "ApiCall",
@@ -17,14 +19,13 @@ function registerCodeComponents() {
                 type: "choice",
                 displayName: "API",
                 options: ["endpoint", "contact", "dev", "user"],
-                defaultValue: "contact",
+                defaultValue: "endpoint",
                 description: "Select which API to use. Path should exclude leading version segments.",
             },
             path: {
                 type: "string",
                 displayName: "Path",
                 description: "Short path. Example: 'me' or 'blog-posts'.",
-                defaultValue: "me",
             },
             method: {
                 type: "choice",
@@ -49,7 +50,7 @@ function registerCodeComponents() {
                 type: "boolean",
                 displayName: "Auto Fetch",
                 description: "Automatically fetch on mount (default: true for GET, false for others).",
-                advanced: true,
+                defaultValue: true,
             },
             canvasAutoFetchCooldownMs: {
                 type: "number",
@@ -111,6 +112,171 @@ function registerCodeComponents() {
             },
         ],
     });
+    (0, host_1.registerComponent)(MetadataOverrides_1.MetadataOverrides, {
+        name: "MetadataOverrides",
+        displayName: "Metadata Overrides",
+        importName: "MetadataOverrides",
+        importPath: "@mints-cloud/cxf-codegen/components/MetadataOverrides",
+        section: "SEO",
+        description: "Merges Site Settings defaults with Page Meta overrides, writes head metadata, and emits Organization JSON-LD.",
+        props: {
+            siteSettings: {
+                type: "object",
+                displayName: "Site Settings",
+                description: "Site-level defaults. Asset paths can be relative and are converted to absolute URLs.",
+                defaultValue: {
+                    identity_and_branding: {
+                        site_name: "Site Name",
+                        primary_color: "#FFFFFF",
+                    },
+                    domains_and_locales: {
+                        primary_domain: "https://www.example.com",
+                        additional_domains: [],
+                    },
+                    seo_defaults: {
+                        seo_title_template: "%pageTitle% | %siteName%",
+                        canonical_base: "https://www.example.com",
+                        robots_indexing: "noindex",
+                        robots_follow: "nofollow",
+                        default_seo_title: "Site Name",
+                        default_meta_description: "Default site description",
+                    },
+                },
+            },
+            pageMeta: {
+                type: "object",
+                displayName: "Page Meta",
+                description: "Page-specific overrides for title, description, keywords, robots, canonical and social metadata.",
+                defaultValue: {
+                    default: {
+                        page_title: "Home",
+                        permalink: "/",
+                    },
+                    seo_per_page: {
+                        keywords: ["example keyword", "another keyword"],
+                    },
+                    social_and_sharing: {},
+                },
+            },
+        },
+    });
+    (0, host_1.registerComponent)(JsonLdSchemas_1.FaqJsonLd, {
+        name: "FaqJsonLd",
+        displayName: "FAQ JSON-LD",
+        importName: "FaqJsonLd",
+        importPath: "@mints-cloud/cxf-codegen/components/JsonLdSchemas",
+        section: "SEO",
+        description: "Outputs schema.org FAQPage JSON-LD from question/answer entries.",
+        props: {
+            items: {
+                type: "object",
+                displayName: "FAQ Items",
+                description: "Array with shape: [{ question, answer }]. answer supports HTML; raw inner quotes are auto-handled.",
+                defaultValue: [
+                    {
+                        question: "What documents do I need for a loan?",
+                        answer: "A valid ID and your collateral item.",
+                    },
+                ],
+            },
+            metadataSource: {
+                type: "object",
+                displayName: "Metadata Source",
+                description: "Object with { siteSettings, pageMeta } from MetadataOverrides. Provides URL and language.",
+                defaultValue: { siteSettings: {}, pageMeta: {} },
+                advanced: true,
+            },
+            schemaId: {
+                type: "string",
+                displayName: "Schema ID",
+                advanced: true,
+            },
+            scriptKey: {
+                type: "string",
+                displayName: "Script Key",
+                description: "Use when rendering multiple FAQ schemas on the same page.",
+                advanced: true,
+            },
+        },
+    });
+    (0, host_1.registerComponent)(JsonLdSchemas_1.BlogPostingJsonLd, {
+        name: "BlogPostingJsonLd",
+        displayName: "Blog Posting JSON-LD",
+        importName: "BlogPostingJsonLd",
+        importPath: "@mints-cloud/cxf-codegen/components/JsonLdSchemas",
+        section: "SEO",
+        description: "Outputs schema.org BlogPosting JSON-LD from CMS blog payload. Uses seo_per_page.keywords and references publisher from MetadataOverrides Organization JSON-LD.",
+        props: {
+            metadataSource: {
+                type: "object",
+                displayName: "Metadata Source",
+                description: "Object with { siteSettings, pageMeta } from MetadataOverrides. Provides URL and language.",
+                defaultValue: { siteSettings: {}, pageMeta: {} },
+                advanced: true,
+            },
+            blog: {
+                type: "object",
+                displayName: "Blog",
+                description: "Supports CMS shape with version.default/page_meta/seo_per_page/social_and_sharing.",
+                defaultValue: {
+                    id: "blog-id",
+                    version: {
+                        created_at: "2026-02-15T10:00:00Z",
+                        updated_at: "2026-02-15T10:00:00Z",
+                        title: "Article title",
+                        slug: "article-slug",
+                        seo_per_page: {
+                            page_meta_title: "Article SEO title",
+                            page_meta_description: "Article SEO description",
+                            keywords: ["pawn loans", "finance", "tips"],
+                        },
+                        default: {
+                            cover_image: {
+                                public_path: "/assets/cover-image",
+                            },
+                            blurb: "<p>Article summary</p>",
+                            body: "<p>Article body</p>",
+                        },
+                    },
+                },
+            },
+            author: {
+                type: "object",
+                displayName: "Author",
+                description: "Primary author (name/url/type) and optional authors array [{ name, url, type }].",
+            },
+            scriptKey: {
+                type: "string",
+                displayName: "Script Key",
+                advanced: true,
+            },
+        },
+    });
+    (0, host_1.registerComponent)(JsonLdSchemas_1.CustomJsonLd, {
+        name: "CustomJsonLd",
+        displayName: "Custom JSON-LD",
+        importName: "CustomJsonLd",
+        importPath: "@mints-cloud/cxf-codegen/components/JsonLdSchemas",
+        section: "SEO",
+        description: "Outputs any custom JSON-LD payload when you need a schema type not covered by presets.",
+        props: {
+            schema: {
+                type: "object",
+                displayName: "Schema Object",
+                defaultValue: {
+                    "@context": "https://schema.org",
+                    "@type": "WebSite",
+                    name: "Site Name",
+                    url: "/",
+                },
+            },
+            scriptKey: {
+                type: "string",
+                displayName: "Script Key",
+                advanced: true,
+            },
+        },
+    });
 }
 // Auto-register when imported
 registerCodeComponents();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mints-cloud/cxf-codegen",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Plasmic CXF codegen library for Next.js applications",
   "author": "Ruben Gomez",
   "license": "MIT",
@@ -31,6 +31,14 @@
       "types": "./dist/components/ApiCall.d.ts",
       "default": "./dist/components/ApiCall.js"
     },
+    "./components/MetadataOverrides": {
+      "types": "./dist/components/MetadataOverrides.d.ts",
+      "default": "./dist/components/MetadataOverrides.js"
+    },
+    "./components/JsonLdSchemas": {
+      "types": "./dist/components/JsonLdSchemas.d.ts",
+      "default": "./dist/components/JsonLdSchemas.js"
+    },
     "./lib/api-call-hooks": {
       "types": "./dist/lib/api-call-hooks.d.ts",
       "default": "./dist/lib/api-call-hooks.js"
@@ -39,6 +47,10 @@
       "types": "./dist/lib/api-route-helpers.d.ts",
       "default": "./dist/lib/api-route-helpers.js"
     },
+    "./lib/assets-query-params": {
+      "types": "./dist/lib/assets-query-params.d.ts",
+      "default": "./dist/lib/assets-query-params.js"
+    },
     "./lib/cxf-auth": {
       "types": "./dist/lib/cxf-auth.d.ts",
       "default": "./dist/lib/cxf-auth.js"