@sarimarcus/content-sites-core 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All packages in the platform release in lockstep; entries are per release version.
 
+## 0.26.0 (2026-10-05)
+
+- `./url`: `publicImageUrl(image, basePath = '/')` — a `public/` asset path under the base path; absolute, protocol-relative and relative values pass through, no image stays undefined. It replaces the copies in the sites' affiliate utils (SLA-2921).
+
 ## 0.25.0 (2026-10-05)
 
 - No changes; lockstep release with ui and tourism (SLA-2961).

package/dist/url/index.d.ts

@@ -1,4 +1,4 @@
-export { url, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from './url.ts';
+export { url, publicImageUrl, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from './url.ts';
 export { getOgImagePath } from './ogImage.ts';
 export { normalizeHref, extractProseHrefs, dedupRelated } from './relatedDedup.ts';
 export { buildImageMap, keyBySlug } from './imageMap.ts';

package/dist/url/index.js

@@ -1,5 +1,5 @@
 // Public surface of @sarimarcus/content-sites-core/url.
-export { url, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from "./url.js";
+export { url, publicImageUrl, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from "./url.js";
 export { getOgImagePath } from "./ogImage.js";
 export { normalizeHref, extractProseHrefs, dedupRelated } from "./relatedDedup.js";
 export { buildImageMap, keyBySlug } from "./imageMap.js";

package/dist/url/url.d.ts

@@ -3,3 +3,10 @@ export declare function url(path: string, basePath?: string): string;
 export declare function normalizePagePath(pathname: string, basePath?: string): string;
 export declare function toAbsoluteSiteUrl(pathname: string, siteUrl: string, basePath?: string): string;
 export declare function normalizeSiteUrl(input: string, siteUrl: string, basePath?: string): string;
+/**
+ * A `public/` asset path under the site base path, for an image a data file names: a root-relative path gets the
+ * base; an absolute or protocol-relative URL and a relative path pass through; no image stays undefined. Unlike
+ * `url()`, it never rewrites a URL that is not root-relative.
+ */
+export declare function publicImageUrl(image: string, basePath?: string): string;
+export declare function publicImageUrl(image?: string, basePath?: string): string | undefined;

package/dist/url/url.js

@@ -57,3 +57,9 @@ export function normalizeSiteUrl(input, siteUrl, basePath = '/') {
         return input;
     }
 }
+export function publicImageUrl(image, basePath = '/') {
+    if (!image)
+        return undefined;
+    const cleanBase = basePath.replace(/\/$/, '');
+    return image.startsWith('/') && !image.startsWith('//') ? `${cleanBase}${image}` : image;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarimarcus/content-sites-core",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Non-visual utilities, Astro config builders and SEO schema assembly shared by the content sites.",
   "type": "module",
   "license": "MIT",

package/src/url/index.ts

@@ -1,5 +1,5 @@
 // Public surface of @sarimarcus/content-sites-core/url.
-export { url, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from './url.ts';
+export { url, publicImageUrl, normalizePagePath, toAbsoluteSiteUrl, normalizeSiteUrl } from './url.ts';
 export { getOgImagePath } from './ogImage.ts';
 export { normalizeHref, extractProseHrefs, dedupRelated } from './relatedDedup.ts';
 export { buildImageMap, keyBySlug } from './imageMap.ts';

package/src/url/url.ts

@@ -72,3 +72,16 @@ export function normalizeSiteUrl(input: string, siteUrl: string, basePath = '/')
     return input;
   }
 }
+
+/**
+ * A `public/` asset path under the site base path, for an image a data file names: a root-relative path gets the
+ * base; an absolute or protocol-relative URL and a relative path pass through; no image stays undefined. Unlike
+ * `url()`, it never rewrites a URL that is not root-relative.
+ */
+export function publicImageUrl(image: string, basePath?: string): string;
+export function publicImageUrl(image?: string, basePath?: string): string | undefined;
+export function publicImageUrl(image?: string, basePath = '/'): string | undefined {
+  if (!image) return undefined;
+  const cleanBase = basePath.replace(/\/$/, '');
+  return image.startsWith('/') && !image.startsWith('//') ? `${cleanBase}${image}` : image;
+}