@mints-cloud/cxf-codegen 1.0.2 → 1.0.4

package/dist/components/MetadataOverrides.d.ts

@@ -0,0 +1,84 @@
+type MaybeString = string | null | undefined;
+type MaybeStringList = string[] | string | null | undefined;
+interface MediaAsset {
+    public_path?: MaybeString;
+    alt_text?: MaybeString;
+    mime_type?: MaybeString;
+}
+export interface SiteSettings {
+    identity_and_branding?: {
+        site_name?: MaybeString;
+        primary_color?: MaybeString;
+        secondary_color?: MaybeString;
+        logo?: MediaAsset;
+        favicon?: MediaAsset;
+        apple_touch_icon?: MediaAsset;
+        manifest_icon_192?: MediaAsset;
+        manifest_icon_512?: MediaAsset;
+    };
+    domains_and_locales?: {
+        primary_domain?: MaybeString;
+        additional_domains?: MaybeString[] | string | null;
+        default_locale?: MaybeString;
+    };
+    seo_defaults?: {
+        seo_title_template?: MaybeString;
+        canonical_base?: MaybeString;
+        og_image_default?: MediaAsset;
+        robots_indexing?: MaybeString;
+        robots_follow?: MaybeString;
+        default_seo_title?: MaybeString;
+        default_meta_description?: MaybeString;
+    };
+}
+export interface PageMeta {
+    default?: {
+        page_title?: MaybeString;
+        permalink?: MaybeString;
+    };
+    seo_per_page?: {
+        page_meta_title?: MaybeString;
+        page_meta_description?: MaybeString;
+        page_robots_follow?: MaybeString;
+        page_robots_indexing?: MaybeString;
+        page_canonical_url?: MaybeString;
+        keywords?: MaybeStringList;
+    };
+    social_and_sharing?: {
+        page_open_graph_title?: MaybeString;
+        page_open_graph_description?: MaybeString;
+        page_open_graph_image?: MediaAsset;
+    };
+}
+export interface MetadataOverridesProps {
+    siteSettings?: SiteSettings | string | null;
+    pageMeta?: PageMeta | string | null;
+}
+export interface AppMetadataOverrides {
+    title?: MaybeString;
+    description?: MaybeString;
+    keywords?: MaybeStringList;
+    robots?: MaybeString;
+    canonicalUrl?: MaybeString;
+    themeColor?: MaybeString;
+    siteName?: MaybeString;
+    openGraphUrl?: MaybeString;
+    openGraphTitle?: MaybeString;
+    openGraphDescription?: MaybeString;
+    openGraphImage?: MaybeString;
+    openGraphImageAlt?: MaybeString;
+    openGraphType?: MaybeString;
+    twitterCard?: MaybeString;
+    twitterTitle?: MaybeString;
+    twitterDescription?: MaybeString;
+    twitterImage?: MaybeString;
+    faviconHref?: MaybeString;
+    faviconMimeType?: MaybeString;
+    appleTouchIconHref?: MaybeString;
+}
+export declare function AppMetadataOverridesHead(props: {
+    overrides?: AppMetadataOverrides | null;
+}): import("react/jsx-runtime").JSX.Element | null;
+export declare function MetadataOverrides(props: MetadataOverridesProps): import("react/jsx-runtime").JSX.Element | null;
+export default MetadataOverrides;
+//# sourceMappingURL=MetadataOverrides.d.ts.map

package/dist/components/MetadataOverrides.d.ts.map

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

package/dist/components/MetadataOverrides.js

@@ -0,0 +1,270 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppMetadataOverridesHead = AppMetadataOverridesHead;
+exports.MetadataOverrides = MetadataOverrides;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = __importStar(require("react"));
+const head_1 = __importDefault(require("next/head"));
+const seo_utils_1 = require("../lib/seo-utils");
+const pickFirst = (...values) => (0, seo_utils_1.pickFirstString)(...values);
+function normalizeSameAsUrl(value, baseUrl) {
+    const cleaned = (0, seo_utils_1.cleanString)(value);
+    if (!cleaned) {
+        return undefined;
+    }
+    if (cleaned.startsWith("//")) {
+        return `https:${cleaned}`;
+    }
+    if (/^https?:\/\//i.test(cleaned)) {
+        return cleaned;
+    }
+    if (cleaned.startsWith("/")) {
+        return (0, seo_utils_1.toAbsoluteUrl)(cleaned, baseUrl);
+    }
+    if (/^[\w.-]+\.[a-z]{2,}(\/.*)?$/i.test(cleaned)) {
+        return `https://${cleaned}`;
+    }
+    return cleaned;
+}
+function resolveTitle(pageMetaTitle, pageTitle, defaultSeoTitle, siteName, template) {
+    const explicitTitle = (0, seo_utils_1.cleanString)(pageMetaTitle);
+    if (explicitTitle) {
+        return explicitTitle;
+    }
+    const fallbackPageTitle = pickFirst(pageTitle, defaultSeoTitle, siteName);
+    const cleanTemplate = (0, seo_utils_1.cleanString)(template);
+    const cleanSiteName = (0, seo_utils_1.cleanString)(siteName);
+    if (!fallbackPageTitle) {
+        return undefined;
+    }
+    if (!cleanTemplate) {
+        if (fallbackPageTitle && cleanSiteName && fallbackPageTitle !== cleanSiteName) {
+            return `${fallbackPageTitle} | ${cleanSiteName}`;
+        }
+        return fallbackPageTitle;
+    }
+    const rendered = cleanTemplate
+        .replace(/%pageTitle%/g, fallbackPageTitle)
+        .replace(/%siteName%/g, cleanSiteName ?? "")
+        .replace(/\s{2,}/g, " ")
+        .trim()
+        .replace(/^\|\s*/g, "")
+        .replace(/\s*\|$/g, "");
+    return (0, seo_utils_1.cleanString)(rendered);
+}
+function buildRobots(indexing, follow) {
+    const parts = [(0, seo_utils_1.cleanString)(indexing), (0, seo_utils_1.cleanString)(follow)].filter((part) => Boolean(part));
+    return parts.length > 0 ? parts.join(", ") : undefined;
+}
+function hasAnyHeadMetadata(metadata) {
+    return Object.values(metadata).some(Boolean);
+}
+function renderHeadTags(metadata) {
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [metadata.title ? (0, jsx_runtime_1.jsx)("title", { children: metadata.title }, "metadata-title") : null, metadata.description ? ((0, jsx_runtime_1.jsx)("meta", { name: "description", content: metadata.description }, "metadata-description")) : null, metadata.keywords ? ((0, jsx_runtime_1.jsx)("meta", { name: "keywords", content: metadata.keywords }, "metadata-keywords")) : null, metadata.robots ? (0, jsx_runtime_1.jsx)("meta", { name: "robots", content: metadata.robots }, "metadata-robots") : null, metadata.canonicalUrl ? ((0, jsx_runtime_1.jsx)("link", { rel: "canonical", href: metadata.canonicalUrl }, "metadata-canonical")) : null, metadata.themeColor ? ((0, jsx_runtime_1.jsx)("meta", { name: "theme-color", content: metadata.themeColor }, "metadata-theme-color")) : null, metadata.siteName ? ((0, jsx_runtime_1.jsx)("meta", { property: "og:site_name", content: metadata.siteName }, "metadata-og-site-name")) : null, metadata.openGraphUrl ? ((0, jsx_runtime_1.jsx)("meta", { property: "og:url", content: metadata.openGraphUrl }, "metadata-og-url")) : null, metadata.openGraphTitle ? ((0, jsx_runtime_1.jsx)("meta", { property: "og:title", content: metadata.openGraphTitle }, "metadata-og-title")) : null, metadata.openGraphDescription ? ((0, jsx_runtime_1.jsx)("meta", { property: "og:description", content: metadata.openGraphDescription }, "metadata-og-description")) : null, metadata.openGraphImage ? ((0, jsx_runtime_1.jsx)("meta", { property: "og:image", content: metadata.openGraphImage }, "metadata-og-image")) : null, metadata.openGraphImageAlt ? ((0, jsx_runtime_1.jsx)("meta", { property: "og:image:alt", content: metadata.openGraphImageAlt }, "metadata-og-image-alt")) : null, metadata.openGraphType ? ((0, jsx_runtime_1.jsx)("meta", { property: "og:type", content: metadata.openGraphType }, "metadata-og-type")) : null, metadata.twitterCard ? ((0, jsx_runtime_1.jsx)("meta", { name: "twitter:card", content: metadata.twitterCard }, "metadata-twitter-card")) : null, metadata.twitterTitle ? ((0, jsx_runtime_1.jsx)("meta", { name: "twitter:title", content: metadata.twitterTitle }, "metadata-twitter-title")) : null, metadata.twitterDescription ? ((0, jsx_runtime_1.jsx)("meta", { name: "twitter:description", content: metadata.twitterDescription }, "metadata-twitter-description")) : null, metadata.twitterImage ? ((0, jsx_runtime_1.jsx)("meta", { name: "twitter:image", content: metadata.twitterImage }, "metadata-twitter-image")) : null, metadata.faviconHref ? ((0, jsx_runtime_1.jsx)("link", { rel: "icon", href: metadata.faviconHref, type: metadata.faviconMimeType }, "metadata-favicon")) : null, metadata.appleTouchIconHref ? ((0, jsx_runtime_1.jsx)("link", { rel: "apple-touch-icon", href: metadata.appleTouchIconHref }, "metadata-apple-touch-icon")) : null, metadata.organizationJsonLd ? ((0, jsx_runtime_1.jsx)("script", { id: "metadata-jsonld-organization", type: "application/ld+json", "data-jsonld-key": "metadata-jsonld-organization", dangerouslySetInnerHTML: {
+                    __html: (0, seo_utils_1.safeJsonForInlineScript)(metadata.organizationJsonLd)
+                } }, "metadata-jsonld-organization")) : null] }));
+}
+function AppMetadataOverridesHead(props) {
+    const { overrides } = props;
+    if (!overrides) {
+        return null;
+    }
+    const title = (0, seo_utils_1.cleanString)(overrides.title);
+    const description = (0, seo_utils_1.cleanString)(overrides.description);
+    const keywordsList = (0, seo_utils_1.parseStringList)(overrides.keywords);
+    const keywords = keywordsList.length > 0 ? keywordsList.join(", ") : undefined;
+    const robots = (0, seo_utils_1.cleanString)(overrides.robots);
+    const canonicalUrl = (0, seo_utils_1.cleanString)(overrides.canonicalUrl);
+    const themeColor = (0, seo_utils_1.cleanString)(overrides.themeColor);
+    const siteName = (0, seo_utils_1.cleanString)(overrides.siteName);
+    const openGraphUrl = (0, seo_utils_1.cleanString)(overrides.openGraphUrl);
+    const openGraphTitle = pickFirst(overrides.openGraphTitle, title);
+    const openGraphDescription = pickFirst(overrides.openGraphDescription, description);
+    const openGraphImage = (0, seo_utils_1.cleanString)(overrides.openGraphImage);
+    const openGraphImageAlt = (0, seo_utils_1.cleanString)(overrides.openGraphImageAlt);
+    const openGraphType = (0, seo_utils_1.cleanString)(overrides.openGraphType);
+    const twitterTitle = pickFirst(overrides.twitterTitle, openGraphTitle);
+    const twitterDescription = pickFirst(overrides.twitterDescription, openGraphDescription);
+    const twitterImage = pickFirst(overrides.twitterImage, openGraphImage);
+    const twitterCard = pickFirst(overrides.twitterCard, twitterImage ? "summary_large_image" : "summary");
+    const faviconHref = (0, seo_utils_1.cleanString)(overrides.faviconHref);
+    const faviconMimeType = (0, seo_utils_1.cleanString)(overrides.faviconMimeType);
+    const appleTouchIconHref = (0, seo_utils_1.cleanString)(overrides.appleTouchIconHref);
+    const metadata = {
+        title,
+        description,
+        keywords,
+        robots,
+        canonicalUrl,
+        themeColor,
+        siteName,
+        openGraphUrl,
+        openGraphTitle,
+        openGraphDescription,
+        openGraphImage,
+        openGraphImageAlt,
+        openGraphType,
+        twitterCard,
+        twitterTitle,
+        twitterDescription,
+        twitterImage,
+        faviconHref,
+        faviconMimeType,
+        appleTouchIconHref
+    };
+    if (!hasAnyHeadMetadata(metadata)) {
+        return null;
+    }
+    return (0, jsx_runtime_1.jsx)(head_1.default, { children: renderHeadTags(metadata) });
+}
+function MetadataOverrides(props) {
+    const { siteSettings, pageMeta } = props;
+    const site = React.useMemo(() => (0, seo_utils_1.parseObject)(siteSettings), [siteSettings]);
+    const page = React.useMemo(() => (0, seo_utils_1.parseObject)(pageMeta), [pageMeta]);
+    const siteName = pickFirst(site?.identity_and_branding?.site_name);
+    const canonicalBase = pickFirst(site?.seo_defaults?.canonical_base, site?.domains_and_locales?.primary_domain);
+    const siteBaseUrl = pickFirst(site?.domains_and_locales?.primary_domain, site?.seo_defaults?.canonical_base);
+    const title = resolveTitle(page?.seo_per_page?.page_meta_title, page?.default?.page_title, site?.seo_defaults?.default_seo_title, siteName, site?.seo_defaults?.seo_title_template);
+    const description = pickFirst(page?.seo_per_page?.page_meta_description, site?.seo_defaults?.default_meta_description);
+    const keywordsList = (0, seo_utils_1.parseStringList)(page?.seo_per_page?.keywords);
+    const keywords = keywordsList.length > 0 ? keywordsList.join(", ") : undefined;
+    const canonicalUrl = pickFirst(page?.seo_per_page?.page_canonical_url, (0, seo_utils_1.toAbsoluteUrl)(page?.default?.permalink, canonicalBase), canonicalBase);
+    const canonicalAssetBaseUrl = pickFirst((0, seo_utils_1.resolveUrlBase)(canonicalBase, canonicalUrl), canonicalBase, canonicalUrl);
+    const currentOrigin = (0, seo_utils_1.getCurrentOrigin)();
+    const assetBaseUrl = pickFirst((0, seo_utils_1.resolveUrlBase)(currentOrigin, siteBaseUrl, canonicalAssetBaseUrl), currentOrigin, siteBaseUrl, canonicalAssetBaseUrl);
+    const robots = buildRobots(pickFirst(page?.seo_per_page?.page_robots_indexing, site?.seo_defaults?.robots_indexing), pickFirst(page?.seo_per_page?.page_robots_follow, site?.seo_defaults?.robots_follow));
+    const openGraphTitle = pickFirst(page?.social_and_sharing?.page_open_graph_title, title);
+    const openGraphDescription = pickFirst(page?.social_and_sharing?.page_open_graph_description, description);
+    const openGraphImage = (0, seo_utils_1.toAbsoluteUrl)(pickFirst(page?.social_and_sharing?.page_open_graph_image?.public_path, site?.seo_defaults?.og_image_default?.public_path), assetBaseUrl);
+    const openGraphImageAlt = pickFirst(page?.social_and_sharing?.page_open_graph_image?.alt_text, site?.seo_defaults?.og_image_default?.alt_text, siteName);
+    const faviconHref = (0, seo_utils_1.toAbsoluteUrl)(site?.identity_and_branding?.favicon?.public_path, assetBaseUrl);
+    const faviconMimeType = pickFirst(site?.identity_and_branding?.favicon?.mime_type);
+    const appleTouchIconHref = (0, seo_utils_1.toAbsoluteUrl)(site?.identity_and_branding?.apple_touch_icon?.public_path, assetBaseUrl);
+    const logoUrl = (0, seo_utils_1.toAbsoluteUrl)(site?.identity_and_branding?.logo?.public_path, assetBaseUrl);
+    const additionalDomains = (0, seo_utils_1.parseStringList)(site?.domains_and_locales?.additional_domains);
+    const sameAs = Array.from(new Set(additionalDomains
+        .map((domain) => normalizeSameAsUrl(domain, assetBaseUrl))
+        .filter((url) => Boolean(url))));
+    const organizationName = pickFirst(site?.seo_defaults?.default_seo_title, siteName, title);
+    const organizationUrl = canonicalAssetBaseUrl;
+    const organizationId = (0, seo_utils_1.buildOrganizationId)(organizationUrl);
+    const organizationDescription = pickFirst(site?.seo_defaults?.default_meta_description, description);
+    const organizationJsonLd = organizationName ||
+        organizationUrl ||
+        organizationId ||
+        logoUrl ||
+        organizationDescription ||
+        sameAs.length > 0
+        ? {
+            "@context": "https://schema.org",
+            "@type": "Organization",
+            ...(organizationId ? { "@id": organizationId } : {}),
+            ...(organizationName ? { name: organizationName } : {}),
+            ...(organizationUrl ? { url: organizationUrl } : {}),
+            ...(logoUrl ? { logo: logoUrl } : {}),
+            ...(organizationDescription ? { description: organizationDescription } : {}),
+            ...(sameAs.length > 0 ? { sameAs } : {})
+        }
+        : undefined;
+    const themeColor = pickFirst(site?.identity_and_branding?.primary_color);
+    const twitterCard = openGraphImage ? "summary_large_image" : "summary";
+    const metadata = {
+        title,
+        description,
+        keywords,
+        robots,
+        canonicalUrl,
+        themeColor,
+        siteName,
+        openGraphUrl: canonicalUrl,
+        openGraphTitle,
+        openGraphDescription,
+        openGraphImage,
+        openGraphImageAlt,
+        openGraphType: "website",
+        twitterCard,
+        twitterTitle: openGraphTitle,
+        twitterDescription: openGraphDescription,
+        twitterImage: openGraphImage,
+        faviconHref,
+        faviconMimeType,
+        appleTouchIconHref,
+        organizationJsonLd
+    };
+    const organizationJson = organizationJsonLd
+        ? (0, seo_utils_1.safeJsonForInlineScript)(organizationJsonLd)
+        : undefined;
+    React.useEffect(() => {
+        if (!organizationJson) {
+            return;
+        }
+        const cleanup = () => {
+            (0, seo_utils_1.removeDuplicateJsonLdScripts)("metadata-jsonld-organization", "metadata-jsonld-organization", organizationJson);
+        };
+        cleanup();
+        if (typeof document === "undefined" || typeof MutationObserver === "undefined") {
+            return undefined;
+        }
+        let rafId = null;
+        const observer = new MutationObserver(() => {
+            if (rafId != null) {
+                return;
+            }
+            rafId = window.requestAnimationFrame(() => {
+                rafId = null;
+                cleanup();
+            });
+        });
+        observer.observe(document.documentElement, {
+            childList: true,
+            subtree: true
+        });
+        return () => {
+            observer.disconnect();
+            if (rafId != null) {
+                window.cancelAnimationFrame(rafId);
+            }
+        };
+    }, [organizationJson]);
+    if (!hasAnyHeadMetadata(metadata)) {
+        return null;
+    }
+    return (0, jsx_runtime_1.jsx)(head_1.default, { children: renderHeadTags(metadata) });
+}
+exports.default = MetadataOverrides;

package/dist/index.d.ts

@@ -1,8 +1,11 @@
 export { ApiCall, type ApiCallProps, type ApiType } from "./components/ApiCall";
+export { MetadataOverrides, AppMetadataOverridesHead, type MetadataOverridesProps, type AppMetadataOverrides, type PageMeta, type SiteSettings } from "./components/MetadataOverrides";
+export { FaqJsonLd, BlogPostingJsonLd, CustomJsonLd, type FaqJsonLdProps, type BlogPostingJsonLdProps, type CustomJsonLdProps } from "./components/JsonLdSchemas";
 export { registerCodeComponents } from "./register";
 export { CXF_COOKIE_NAMES, CXF_HEADER_NAMES, type CxfTokens, getTokensFromCookies, buildAuthHeaders, makeAuthenticatedRequest, extractSetCookieHeaders, extractTokensFromSetCookie, buildCookieHeader, getCxfBaseUrl, getCxfApiKey, buildCookieString, setTokensAsCookies, clearAuthCookies, } from "./lib/cxf-auth";
 export { buildQueryString as buildApiQueryString, normalizePath, setAuthCookies, handleError, sendResponse, } from "./lib/api-route-helpers";
 export { useIsrPrefetch, useApiFetch, type PreloadedDataResult, type UseApiFetchOptions, } from "./lib/api-call-hooks";
+export { ASSET_QUERY_PARAMS_COOKIE_NAME, normalizeAssetQueryParams, serializeAssetQueryParamsCookie, extractAssetQueryParamsFromCookie, useSyncAssetQueryParams, type AssetQueryParamValue, type AssetQueryParams, type NormalizedAssetQueryParams, } from "./lib/assets-query-params";
 export { EndpointDataContext, PrefetchCollectorContext, PrefetchCollectorProvider, ServerPageWrapper, createServerProps, normalizeEndpointPath, buildQueryString, buildEndpointKey, type EndpointConfig, type ServerPageProps, type ServerPageWrapperProps, type PrefetchRequest, } from "./lib/server-props";
 export { CxfApp } from "./pages/app";
 export { PlasmicHost } from "./pages/plasmic-host";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,SAAS,EACd,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,IAAI,mBAAmB,EACvC,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,SAAS,EACd,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,IAAI,mBAAmB,EACvC,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,GAChC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,9 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cxfNextConfig = exports.assetsApiHandler = exports.cxfApiHandler = exports.PlasmicHost = exports.CxfApp = exports.buildEndpointKey = exports.buildQueryString = exports.normalizeEndpointPath = exports.createServerProps = exports.ServerPageWrapper = exports.PrefetchCollectorProvider = exports.PrefetchCollectorContext = exports.EndpointDataContext = exports.useApiFetch = exports.useIsrPrefetch = exports.sendResponse = exports.handleError = exports.setAuthCookies = exports.normalizePath = exports.buildApiQueryString = exports.clearAuthCookies = exports.setTokensAsCookies = exports.buildCookieString = exports.getCxfApiKey = exports.getCxfBaseUrl = exports.buildCookieHeader = exports.extractTokensFromSetCookie = exports.extractSetCookieHeaders = exports.makeAuthenticatedRequest = exports.buildAuthHeaders = exports.getTokensFromCookies = exports.CXF_HEADER_NAMES = exports.CXF_COOKIE_NAMES = exports.registerCodeComponents = exports.ApiCall = void 0;
+exports.cxfNextConfig = exports.assetsApiHandler = exports.cxfApiHandler = exports.PlasmicHost = exports.CxfApp = exports.buildEndpointKey = exports.buildQueryString = exports.normalizeEndpointPath = exports.createServerProps = exports.ServerPageWrapper = exports.PrefetchCollectorProvider = exports.PrefetchCollectorContext = exports.EndpointDataContext = exports.useSyncAssetQueryParams = exports.extractAssetQueryParamsFromCookie = exports.serializeAssetQueryParamsCookie = exports.normalizeAssetQueryParams = exports.ASSET_QUERY_PARAMS_COOKIE_NAME = exports.useApiFetch = exports.useIsrPrefetch = exports.sendResponse = exports.handleError = exports.setAuthCookies = exports.normalizePath = exports.buildApiQueryString = exports.clearAuthCookies = exports.setTokensAsCookies = exports.buildCookieString = exports.getCxfApiKey = exports.getCxfBaseUrl = exports.buildCookieHeader = exports.extractTokensFromSetCookie = exports.extractSetCookieHeaders = exports.makeAuthenticatedRequest = exports.buildAuthHeaders = exports.getTokensFromCookies = exports.CXF_HEADER_NAMES = exports.CXF_COOKIE_NAMES = exports.registerCodeComponents = exports.CustomJsonLd = exports.BlogPostingJsonLd = exports.FaqJsonLd = exports.AppMetadataOverridesHead = exports.MetadataOverrides = exports.ApiCall = void 0;
 // Main exports
 var ApiCall_1 = require("./components/ApiCall");
 Object.defineProperty(exports, "ApiCall", { enumerable: true, get: function () { return ApiCall_1.ApiCall; } });
+var MetadataOverrides_1 = require("./components/MetadataOverrides");
+Object.defineProperty(exports, "MetadataOverrides", { enumerable: true, get: function () { return MetadataOverrides_1.MetadataOverrides; } });
+Object.defineProperty(exports, "AppMetadataOverridesHead", { enumerable: true, get: function () { return MetadataOverrides_1.AppMetadataOverridesHead; } });
+var JsonLdSchemas_1 = require("./components/JsonLdSchemas");
+Object.defineProperty(exports, "FaqJsonLd", { enumerable: true, get: function () { return JsonLdSchemas_1.FaqJsonLd; } });
+Object.defineProperty(exports, "BlogPostingJsonLd", { enumerable: true, get: function () { return JsonLdSchemas_1.BlogPostingJsonLd; } });
+Object.defineProperty(exports, "CustomJsonLd", { enumerable: true, get: function () { return JsonLdSchemas_1.CustomJsonLd; } });
 var register_1 = require("./register");
 Object.defineProperty(exports, "registerCodeComponents", { enumerable: true, get: function () { return register_1.registerCodeComponents; } });
 // Library exports
@@ -30,6 +37,12 @@ Object.defineProperty(exports, "sendResponse", { enumerable: true, get: function
 var api_call_hooks_1 = require("./lib/api-call-hooks");
 Object.defineProperty(exports, "useIsrPrefetch", { enumerable: true, get: function () { return api_call_hooks_1.useIsrPrefetch; } });
 Object.defineProperty(exports, "useApiFetch", { enumerable: true, get: function () { return api_call_hooks_1.useApiFetch; } });
+var assets_query_params_1 = require("./lib/assets-query-params");
+Object.defineProperty(exports, "ASSET_QUERY_PARAMS_COOKIE_NAME", { enumerable: true, get: function () { return assets_query_params_1.ASSET_QUERY_PARAMS_COOKIE_NAME; } });
+Object.defineProperty(exports, "normalizeAssetQueryParams", { enumerable: true, get: function () { return assets_query_params_1.normalizeAssetQueryParams; } });
+Object.defineProperty(exports, "serializeAssetQueryParamsCookie", { enumerable: true, get: function () { return assets_query_params_1.serializeAssetQueryParamsCookie; } });
+Object.defineProperty(exports, "extractAssetQueryParamsFromCookie", { enumerable: true, get: function () { return assets_query_params_1.extractAssetQueryParamsFromCookie; } });
+Object.defineProperty(exports, "useSyncAssetQueryParams", { enumerable: true, get: function () { return assets_query_params_1.useSyncAssetQueryParams; } });
 var server_props_1 = require("./lib/server-props");
 Object.defineProperty(exports, "EndpointDataContext", { enumerable: true, get: function () { return server_props_1.EndpointDataContext; } });
 Object.defineProperty(exports, "PrefetchCollectorContext", { enumerable: true, get: function () { return server_props_1.PrefetchCollectorContext; } });

package/dist/lib/api-call-hooks.d.ts

@@ -15,11 +15,12 @@ export interface UseApiFetchOptions {
     onSuccess?: (data: any) => void;
     onError?: (error: string) => void;
     unwrapData?: boolean;
+    canvasAutoFetchCooldownMs?: number;
 }
 export declare function useApiFetch(options: UseApiFetchOptions): {
     data: any;
     error: string | null;
     loading: boolean;
-    fetchData: () => (() => void) | undefined;
+    fetchData: (reason?: "auto" | "trigger" | "manual") => (() => void) | undefined;
 };
 //# sourceMappingURL=api-call-hooks.d.ts.map

package/dist/lib/api-call-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-call-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/api-call-hooks.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,GAAG,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACvC,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,GAAG,GAChB,mBAAmB,CA+CrB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAkCD,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB;;;;;EAyLtD"}
+{"version":3,"file":"api-call-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/api-call-hooks.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,GAAG,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACvC,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,GAAG,GAChB,mBAAmB,CA+CrB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAmED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB;;;;yBA0ER,MAAM,GAAG,SAAS,GAAG,QAAQ;EAuI3E"}

package/dist/lib/api-call-hooks.js

@@ -77,6 +77,21 @@ function useIsrPrefetch(endpointPath, params, method, initialData) {
             : { preloaded: undefined, hasExactPreload: false };
     }, [initialData, endpointPath, params, endpointDataMap, isGet]);
 }
+const EDITOR_AUTO_FETCH_COOLDOWN_MS = 5 * 60 * 1000;
+const editorAutoFetchTimestamps = new Map();
+const MAX_EDITOR_FETCH_KEYS = 20;
+function pruneOldestEditorFetchEntries() {
+    if (editorAutoFetchTimestamps.size <= MAX_EDITOR_FETCH_KEYS)
+        return;
+    const overflowCount = editorAutoFetchTimestamps.size - MAX_EDITOR_FETCH_KEYS;
+    let removed = 0;
+    for (const key of editorAutoFetchTimestamps.keys()) {
+        editorAutoFetchTimestamps.delete(key);
+        removed += 1;
+        if (removed >= overflowCount)
+            break;
+    }
+}
 function unwrapResponseData(data, shouldUnwrap) {
     if (!shouldUnwrap ||
         !data ||
@@ -88,6 +103,25 @@ function unwrapResponseData(data, shouldUnwrap) {
     }
     return data.data;
 }
+function stableSerialize(value) {
+    if (value === undefined)
+        return "";
+    if (value === null)
+        return "null";
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableSerialize(item)).join(",")}]`;
+    }
+    if (typeof value === "object") {
+        const keys = Object.keys(value).sort();
+        return `{${keys.map((k) => `${JSON.stringify(k)}:${stableSerialize(value[k])}`).join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+function isPlasmicHostRuntime() {
+    if (typeof window === "undefined")
+        return false;
+    return window.location.pathname.includes("/plasmic-host");
+}
 function getUtmParamsFromLocation() {
     if (typeof window === "undefined")
         return null;
@@ -109,7 +143,13 @@ function getUtmParamsFromLocation() {
     }
 }
 function useApiFetch(options) {
-    const { endpointPath, method = "GET", params, body, preloaded, hasExactPreload, shouldAutoFetch = true, trigger, onSuccess, onError, unwrapData = false, } = options;
+    const { endpointPath, method = "GET", params, body, preloaded, hasExactPreload, shouldAutoFetch = true, trigger, onSuccess, onError, unwrapData = false, canvasAutoFetchCooldownMs = EDITOR_AUTO_FETCH_COOLDOWN_MS, } = options;
+    const paramsSignature = stableSerialize(params);
+    const bodySignature = stableSerialize(body);
+    const paramsRef = React.useRef(params);
+    const bodyRef = React.useRef(body);
+    paramsRef.current = params;
+    bodyRef.current = body;
     // Also check context directly in case preloaded prop hasn't updated yet during hydration
     const endpointDataMap = React.useContext(server_props_1.EndpointDataContext);
     const contextData = React.useMemo(() => {
@@ -155,23 +195,36 @@ function useApiFetch(options) {
                 isHydratingRef.current = false;
         }
     }, [effectivePreloaded, data]);
-    const fetchData = React.useCallback(() => {
+    const fetchData = React.useCallback((reason = "manual") => {
         if (!endpointPath)
             return;
         const controller = new AbortController();
         (async () => {
             try {
+                const normalizedPath = (0, server_props_1.normalizeEndpointPath)(endpointPath);
+                const requestKey = `${method}:${normalizedPath}:${paramsSignature}:${bodySignature}`;
+                if (reason === "auto" &&
+                    method === "GET" &&
+                    isPlasmicHostRuntime()) {
+                    const now = Date.now();
+                    const lastFetchAt = editorAutoFetchTimestamps.get(requestKey) ?? 0;
+                    if (now - lastFetchAt < canvasAutoFetchCooldownMs) {
+                        setLoading(false);
+                        return;
+                    }
+                    editorAutoFetchTimestamps.set(requestKey, now);
+                    pruneOldestEditorFetchEntries();
+                }
                 setLoading(true);
                 setError(null);
                 hasTriggeredSuccessRef.current = false;
                 hasTriggeredErrorRef.current = false;
-                const normalizedPath = (0, server_props_1.normalizeEndpointPath)(endpointPath);
                 // Merge current page UTM params into request params for GET requests.
                 // Explicit params take precedence over UTM values if keys overlap.
                 const utmParams = method === "GET" ? getUtmParamsFromLocation() : null;
                 const mergedParams = method === "GET"
-                    ? { ...(utmParams || {}), ...(params || {}) }
-                    : params;
+                    ? { ...(utmParams || {}), ...(paramsRef.current || {}) }
+                    : paramsRef.current;
                 const queryString = method === "GET" ? (0, server_props_1.buildQueryString)(mergedParams) : "";
                 const url = `/api/${normalizedPath}${queryString}`;
                 const fetchOptions = {
@@ -183,8 +236,8 @@ function useApiFetch(options) {
                     credentials: "include",
                     signal: controller.signal,
                 };
-                if (method !== "GET" && body) {
-                    fetchOptions.body = JSON.stringify(body);
+                if (method !== "GET" && bodyRef.current) {
+                    fetchOptions.body = JSON.stringify(bodyRef.current);
                 }
                 const resp = await fetch(url, fetchOptions);
                 if (!resp.ok) {
@@ -213,13 +266,13 @@ function useApiFetch(options) {
             }
         })();
         return () => controller.abort();
-    }, [endpointPath, method, params, body, unwrapData]);
+    }, [endpointPath, method, paramsSignature, bodySignature, unwrapData, canvasAutoFetchCooldownMs]);
     const prevTriggerRef = React.useRef(trigger);
     React.useEffect(() => {
         if (trigger !== undefined && trigger !== prevTriggerRef.current) {
             prevTriggerRef.current = trigger;
             if (trigger > 0)
-                fetchData();
+                fetchData("trigger");
         }
     }, [trigger, fetchData]);
     // Only fetch if we should auto-fetch AND we don't have exact preloaded data
@@ -236,14 +289,14 @@ function useApiFetch(options) {
                 // Re-check context and preloaded after hydration delay
                 const stillNoData = effectivePreloaded === undefined || effectivePreloaded === null;
                 if (stillNoData && shouldAutoFetch && !hasExactPreload) {
-                    fetchData();
+                    fetchData("auto");
                 }
             }, 0);
             return () => clearTimeout(timeoutId);
         }
         // Fetch if we don't have preloaded data (non-hydration case)
         if (!hasPreloadedData) {
-            return fetchData();
+            return fetchData("auto");
         }
     }, [shouldAutoFetch, hasExactPreload, hasPreloadedData, effectivePreloaded, fetchData]);
     React.useEffect(() => {

package/dist/lib/api-route-helpers.d.ts

@@ -5,6 +5,7 @@ export declare function setAuthCookies(res: NextApiResponse, tokens: {
     accessToken: string | null;
     refreshToken: string | null;
 }): void;
+export declare function forwardExtraCookies(res: NextApiResponse, setCookieHeaders: string[]): void;
 export declare function handleError(res: NextApiResponse, err: any): void;
 export declare function sendResponse(res: NextApiResponse, response: Response): Promise<void>;
 //# sourceMappingURL=api-route-helpers.d.ts.map

package/dist/lib/api-route-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-route-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/api-route-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAG5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,MAAM,CAavE;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAOjF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,QAavH;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,QAMzD;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,iBAwB1E"}
+{"version":3,"file":"api-route-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/api-route-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAG5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,MAAM,CAavE;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAOjF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,QAavH;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAYnF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,QAMzD;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,iBAwB1E"}

package/dist/lib/api-route-helpers.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildQueryString = buildQueryString;
 exports.normalizePath = normalizePath;
 exports.setAuthCookies = setAuthCookies;
+exports.forwardExtraCookies = forwardExtraCookies;
 exports.handleError = handleError;
 exports.sendResponse = sendResponse;
 const cxf_auth_1 = require("./cxf-auth");
@@ -42,6 +43,18 @@ function setAuthCookies(res, tokens) {
         res.setHeader("Set-Cookie", cookies);
     }
 }
+function forwardExtraCookies(res, setCookieHeaders) {
+    const authCookieNames = new Set([cxf_auth_1.CXF_COOKIE_NAMES.ACCESS_TOKEN, cxf_auth_1.CXF_COOKIE_NAMES.REFRESH_TOKEN]);
+    const extraCookies = setCookieHeaders.filter((header) => {
+        const name = header.split("=")[0]?.trim();
+        return !authCookieNames.has(name);
+    });
+    if (extraCookies.length > 0) {
+        const existing = res.getHeader("Set-Cookie");
+        const current = Array.isArray(existing) ? existing : existing ? [String(existing)] : [];
+        res.setHeader("Set-Cookie", [...current, ...extraCookies]);
+    }
+}
 function handleError(res, err) {
     const dev = process.env.NODE_ENV !== "production";
     return res.status(500).json({

package/dist/lib/assets-query-params.d.ts

@@ -0,0 +1,11 @@
+export declare const ASSET_QUERY_PARAMS_COOKIE_NAME = "cxf_asset_query_params";
+type PrimitiveParam = string | number | boolean;
+export type AssetQueryParamValue = PrimitiveParam | PrimitiveParam[] | null | undefined;
+export type AssetQueryParams = Record<string, AssetQueryParamValue>;
+export type NormalizedAssetQueryParams = Record<string, string | string[]>;
+export declare function normalizeAssetQueryParams(params: AssetQueryParams | null | undefined): NormalizedAssetQueryParams;
+export declare function serializeAssetQueryParamsCookie(params: AssetQueryParams | null | undefined): string;
+export declare function extractAssetQueryParamsFromCookie(cookieHeader: string | null | undefined): NormalizedAssetQueryParams;
+export declare function useSyncAssetQueryParams(params: AssetQueryParams | null | undefined): void;
+export {};
+//# sourceMappingURL=assets-query-params.d.ts.map