@paroicms/public-server-lib 0.6.0

package/README.md

@@ -0,0 +1,9 @@
+# @paroicms/public-server-lib
+
+Common utilitaries for paroicms plugins.
+
+This package is part of [ParoiCMS](https://www.npmjs.com/package/@paroicms/server).
+
+## License
+
+Released under the [MIT license](https://gitlab.com/paroi/opensource/paroicms/-/blob/main/LICENSE.md).

package/dist/html-helpers/html-helpers.d.ts

@@ -0,0 +1,11 @@
+export declare function escapeHtml(text: string, options?: {
+    newLinesToBr?: boolean;
+}): string;
+export declare function decodeHtmlEntities(str: string): string;
+export declare function newLinesToBr(text: string): string;
+export declare function htmlToText(html: string): string;
+export declare function stripHtmlTags(html: string, { blockSeparator }?: {
+    blockSeparator?: string;
+}): string;
+export declare function insertBlockSeparators(html: string, sep: string): string;
+export declare function replaceLinks(html: string): string;

package/dist/html-helpers/html-helpers.js

@@ -0,0 +1,85 @@
+"use strict";
+// TODO: Remove all Rome ignore comment and resolve issues
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceLinks = exports.insertBlockSeparators = exports.stripHtmlTags = exports.htmlToText = exports.newLinesToBr = exports.decodeHtmlEntities = exports.escapeHtml = void 0;
+/**
+ * @see https://stackoverflow.com/a/4835406/3786294
+ */
+const htmlEntities = {
+    "&": "&",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#039;",
+};
+function escapeHtml(text, options = {}) {
+    let val = text;
+    val = val.replace(/[&<>"']/g, (m) => htmlEntities[m]);
+    if (options.newLinesToBr) {
+        val = newLinesToBr(val);
+    }
+    return val;
+}
+exports.escapeHtml = escapeHtml;
+function decodeHtmlEntities(str) {
+    const entities = {
+        "&lt;": "<",
+        "&#60;": "<",
+        "&#x3C;": "<",
+        "&gt;": ">",
+        "&#62;": ">",
+        "&#x3E;": ">",
+        "&#47;": "/",
+        "&#x2F;": "/",
+        "&apos;": "'",
+        "&#39;": "'",
+        "&#x27;": "'",
+        "&quot;": '"',
+        "&#34;": '"',
+        "&#x22;": '"',
+        "&amp;": "&",
+        "&#38;": "&",
+        "&#x26;": "&",
+    };
+    return str.replace(/&lt;|&#60;|&#x3C;|&gt;|&#62;|&#x3E;|&#47;|&#x2F;|&apos;|&#39;|&#x27;|&quot;|&#34;|&#x22;|&amp;|&#38;|&#x26;/g, (match) => entities[match]);
+}
+exports.decodeHtmlEntities = decodeHtmlEntities;
+function newLinesToBr(text) {
+    return text.replace(/(?:\r\n|\r|\n)/g, "<br>\n");
+}
+exports.newLinesToBr = newLinesToBr;
+function htmlToText(html) {
+    return stripHtmlTags(replaceLinks(html));
+}
+exports.htmlToText = htmlToText;
+/**
+ * Thanks to https://stackoverflow.com/a/430240/3786294
+ */
+const tagBody = "(?:[^\"'>]|\"[^\"]*\"|'[^']*')*";
+const tagOrComment = new RegExp(`<(?:!--(?:(?:-*[^->])*--+|-?)|script\\b${tagBody}>[\\s\\S]*?</script\\s*|style\\b${tagBody}>[\\s\\S]*?</style\\s*|/?[a-z]${tagBody})>`, "gi");
+function stripHtmlTags(html, { blockSeparator } = {}) {
+    let val = blockSeparator ? insertBlockSeparators(html, blockSeparator) : html;
+    val = val.replace(/<br\s*\/?>/gi, "\n");
+    let prev;
+    do {
+        prev = val;
+        val = val.replace(tagOrComment, "");
+    } while (val !== prev);
+    if (blockSeparator && val.endsWith(blockSeparator)) {
+        val = val.slice(0, -blockSeparator.length);
+    }
+    return decodeHtmlEntities(val);
+}
+exports.stripHtmlTags = stripHtmlTags;
+function insertBlockSeparators(html, sep) {
+    const regex = /(\w)(<\/(?:address|article|aside|blockquote|canvas|dd|div|dl|dt|fieldset|figcaption|figure|footer|form|h[1-6]|header|hr|li|main|nav|noscript|ol|p|pre|section|table|tfoot|ul|video)>)/g;
+    return html.replace(regex, (_, p1, p2) => `${p1}${sep}${p2}`);
+}
+exports.insertBlockSeparators = insertBlockSeparators;
+function replaceLinks(html) {
+    return html.replace(/<a\s+[^>]*href="([^"]*)"[^>]*>([^<]*)<\/a>/gi, (_, url, label) => {
+        return `${label.trim()} ( ${url} )`;
+    });
+}
+exports.replaceLinks = replaceLinks;
+//# sourceMappingURL=html-helpers.js.map

package/dist/html-helpers/html-helpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type * from "../types/backend-plugin-types";
+export type * from "../types/plugin-site-context-types";
+export * from "./html-helpers/html-helpers";
+export * from "./obfuscate.helper";
+export * from "./server-image-cache-engine.helper";
+export * from "./simple-i18n";
+export * from "./url.helpers";

package/dist/index.js

@@ -0,0 +1,22 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./html-helpers/html-helpers"), exports);
+__exportStar(require("./obfuscate.helper"), exports);
+__exportStar(require("./server-image-cache-engine.helper"), exports);
+__exportStar(require("./simple-i18n"), exports);
+__exportStar(require("./url.helpers"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,8DAA4C;AAC5C,qDAAmC;AACnC,qEAAmD;AACnD,gDAA8B;AAC9B,gDAA8B"}

package/dist/obfuscate.helper.d.ts

@@ -0,0 +1,2 @@
+export declare function generateObfuscatedHtml(inputString: string): string;
+export declare function obfuscateAsHtmlLink(phoneOrEmail: string): string;

package/dist/obfuscate.helper.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.obfuscateAsHtmlLink = exports.generateObfuscatedHtml = void 0;
+const html_helpers_1 = require("./html-helpers/html-helpers");
+function generateObfuscatedHtml(inputString) {
+    const jsString = JSON.stringify(btoa(inputString));
+    return `<script>document.write(atob(${jsString}))</script>`;
+}
+exports.generateObfuscatedHtml = generateObfuscatedHtml;
+function obfuscateAsHtmlLink(phoneOrEmail) {
+    return generateObfuscatedHtml(generateTargetHtml(phoneOrEmail));
+}
+exports.obfuscateAsHtmlLink = obfuscateAsHtmlLink;
+function generateTargetHtml(str) {
+    const inputString = str.trim();
+    const linkString = generateLinkString(inputString);
+    return `<a href="${(0, html_helpers_1.escapeHtml)(linkString)}">${(0, html_helpers_1.escapeHtml)(inputString)}</a>`;
+}
+function generateLinkString(inputString) {
+    if (inputString.includes("@")) {
+        return `mailto:${inputString}`;
+    }
+    const plus = inputString.startsWith("+");
+    const allDigits = inputString.replaceAll(/[^0-9]/g, "");
+    return plus ? `tel:+${allDigits}` : `tel:${allDigits}`;
+}
+//# sourceMappingURL=obfuscate.helper.js.map

package/dist/obfuscate.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obfuscate.helper.js","sourceRoot":"","sources":["../src/obfuscate.helper.ts"],"names":[],"mappings":";;;AAAA,8DAAyD;AAEzD,SAAgB,sBAAsB,CAAC,WAAmB;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACnD,OAAO,+BAA+B,QAAQ,aAAa,CAAC;AAC9D,CAAC;AAHD,wDAGC;AAED,SAAgB,mBAAmB,CAAC,YAAoB;IACtD,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;AAClE,CAAC;AAFD,kDAEC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACnD,OAAO,YAAY,IAAA,yBAAU,EAAC,UAAU,CAAC,KAAK,IAAA,yBAAU,EAAC,WAAW,CAAC,MAAM,CAAC;AAC9E,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAmB;IAC7C,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC;AACzD,CAAC"}

package/dist/server-image-cache-engine.helper.d.ts

@@ -0,0 +1,5 @@
+import type { ImageSize, VariantName } from "@paroicms/public-anywhere-lib";
+export declare function isImageSize(imageSize: string): imageSize is ImageSize;
+export declare function isVariantName(variantName: string): variantName is VariantName;
+export declare function generateImageSlug(fromName?: string): string | undefined;
+export declare function applyRatioToImageSize(imageSize: ImageSize, pixelRatio: number): ImageSize;

package/dist/server-image-cache-engine.helper.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyRatioToImageSize = exports.generateImageSlug = exports.isVariantName = exports.isImageSize = void 0;
+const data_formatters_lib_1 = require("@paroi/data-formatters-lib");
+const internal_anywhere_lib_1 = require("@paroicms/internal-anywhere-lib");
+function isImageSize(imageSize) {
+    return /^[0-9]+x|x[0-9]+|x[0-9]+x|[0-9]+x[0-9]+$/.test(imageSize);
+}
+exports.isImageSize = isImageSize;
+function isVariantName(variantName) {
+    return /^[0-9]+x[0-9]+$/.test(variantName);
+}
+exports.isVariantName = isVariantName;
+function generateImageSlug(fromName) {
+    if (!fromName)
+        return;
+    return (0, internal_anywhere_lib_1.generateSlug)(fromName).substring(0, 12).replace(/-$/g, "");
+}
+exports.generateImageSlug = generateImageSlug;
+function applyRatioToImageSize(imageSize, pixelRatio) {
+    const splitted = imageSize.split("x");
+    if (splitted.length === 3) {
+        const value = splitted[1];
+        splitted[1] = `${Math.round((0, data_formatters_lib_1.nbVal)(value) * pixelRatio)}`;
+    }
+    else if (splitted.length === 2) {
+        const width = splitted[0];
+        const height = splitted[1];
+        if (height !== "")
+            splitted[1] = `${Math.round((0, data_formatters_lib_1.nbVal)(height) * pixelRatio)}`;
+        if (width !== "")
+            splitted[0] = `${Math.round((0, data_formatters_lib_1.nbVal)(width) * pixelRatio)}`;
+    }
+    return splitted.join("x");
+}
+exports.applyRatioToImageSize = applyRatioToImageSize;
+//# sourceMappingURL=server-image-cache-engine.helper.js.map

package/dist/server-image-cache-engine.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-image-cache-engine.helper.js","sourceRoot":"","sources":["../src/server-image-cache-engine.helper.ts"],"names":[],"mappings":";;;AAAA,oEAAmD;AACnD,2EAA+D;AAG/D,SAAgB,WAAW,CAAC,SAAiB;IAC3C,OAAO,0CAA0C,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACpE,CAAC;AAFD,kCAEC;AAED,SAAgB,aAAa,CAAC,WAAmB;IAC/C,OAAO,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAC7C,CAAC;AAFD,sCAEC;AAED,SAAgB,iBAAiB,CAAC,QAAiB;IACjD,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,OAAO,IAAA,oCAAY,EAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACpE,CAAC;AAHD,8CAGC;AAED,SAAgB,qBAAqB,CAAC,SAAoB,EAAE,UAAkB;IAC5E,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,2BAAK,EAAC,KAAK,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC;IAC3D,CAAC;SAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,MAAM,KAAK,EAAE;YAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,2BAAK,EAAC,MAAM,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC;QAC7E,IAAI,KAAK,KAAK,EAAE;YAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,2BAAK,EAAC,KAAK,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC;IAC7E,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAc,CAAC;AACzC,CAAC;AAfD,sDAeC"}

package/dist/simple-i18n.d.ts

@@ -0,0 +1,14 @@
+import type { AppLog } from "../types/plugin-site-context-types";
+export interface SimpleTranslator {
+    translate: (options: SimpleTranslateOptions) => string;
+}
+export interface SimpleTranslateOptions {
+    language: string;
+    key: string;
+    args?: (string | number)[];
+}
+export declare function createSimpleTranslator(options: {
+    l10nDir: string;
+    languages: string[];
+    appLog: Pick<AppLog, "warn">;
+}): Promise<SimpleTranslator>;

package/dist/simple-i18n.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSimpleTranslator = void 0;
+const data_formatters_lib_1 = require("@paroi/data-formatters-lib");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+async function createSimpleTranslator(options) {
+    const labels = await loadLabels(options);
+    return {
+        translate: (options) => translate(labels, options),
+    };
+}
+exports.createSimpleTranslator = createSimpleTranslator;
+function translate(labels, { args = [], key, language }) {
+    let label = labels.get(language)?.[key] ?? key;
+    const variables = findVariablesInString(label, args.length);
+    variables.reverse();
+    for (const { indexInString, variableName, variableNumber } of variables) {
+        const value = args[variableNumber - 1];
+        const before = label.substring(0, indexInString);
+        const after = label.substring(indexInString + variableName.length);
+        label = `${before}${value}${after}`;
+    }
+    return label;
+}
+function findVariablesInString(str, max) {
+    const matches = [];
+    const regex = /\$[0-9]+/g;
+    let match;
+    while (true) {
+        match = regex.exec(str);
+        if (!match)
+            break;
+        const [variableName] = match;
+        const variableNumber = (0, data_formatters_lib_1.nbVal)(variableName.substring(1), { varName: variableName });
+        if (variableNumber <= max) {
+            matches.push({
+                variableName,
+                variableNumber,
+                indexInString: match.index,
+            });
+        }
+    }
+    return matches;
+}
+async function loadLabels({ l10nDir, languages, appLog, }) {
+    const labels = new Map();
+    for (const language of languages) {
+        let content;
+        try {
+            content = await (0, promises_1.readFile)((0, node_path_1.join)(l10nDir, `${language}.json`), "utf-8");
+        }
+        catch {
+            continue; // it's fine, there is no locale file for this language
+        }
+        try {
+            labels.set(language, flattenLocales(JSON.parse(content)));
+        }
+        catch {
+            appLog.warn(`invalid locale file '${(0, node_path_1.join)(l10nDir, `${language}.json`)}'`);
+        }
+    }
+    return labels;
+}
+function flattenLocales(source, prefix = "") {
+    const result = {};
+    for (const [key, val] of Object.entries(source)) {
+        if (val === null)
+            throw new Error(`invalid null value for '${key}'`);
+        if (typeof val === "string") {
+            result[`${prefix}${key}`] = val;
+        }
+        else if (typeof val === "object") {
+            Object.assign(result, flattenLocales(val, `${prefix}${key}.`));
+        }
+        else {
+            throw new Error(`invalid value for '${key}'`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=simple-i18n.js.map

package/dist/simple-i18n.js.map

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

package/dist/url.helpers.d.ts

@@ -0,0 +1,40 @@
+import type { VariantName } from "@paroicms/public-anywhere-lib";
+import type { PluginSiteContext } from "../types/plugin-site-context-types";
+export interface GetBoUrlOptions {
+    path?: string;
+    publicProtocol: string;
+    boPort: number;
+    fqdn: string;
+}
+export declare function getBoUrl({ path, fqdn, publicProtocol, boPort }: GetBoUrlOptions): string;
+export interface UrlOfMediaFileValues {
+    mediaUid: string;
+    mediaType: string;
+    originalName: string | undefined;
+    absoluteUrl?: boolean;
+}
+export declare function makeUrlOfMediaFile(siteContext: Pick<PluginSiteContext, "siteUrl">, values: UrlOfMediaFileValues): string;
+export declare function makeUrlOfMediaFile(siteContext: Pick<PluginSiteContext, "siteUrl">, values: UrlOfMediaFileValues, options: {
+    returnObj: true;
+}): {
+    url: string;
+    fileName: string;
+};
+export interface UrlOfImageVariantValues {
+    mediaUid: string;
+    mediaType: string;
+    variantName: VariantName;
+    resourceVersion: string | undefined;
+    slug: string | undefined;
+    absoluteUrl?: boolean;
+}
+export declare function makeUrlOfImageVariant(siteContext: Pick<PluginSiteContext, "siteUrl">, values: UrlOfImageVariantValues): string;
+export declare function makeUrlOfImageVariant(siteContext: Pick<PluginSiteContext, "siteUrl">, values: UrlOfImageVariantValues, options: {
+    returnObj: true;
+}): {
+    url: string;
+    fileName: string;
+};
+export declare function fileExtensionOf(mediaType: string): string;
+export declare function toAbsoluteUrl(siteContext: Pick<PluginSiteContext, "siteUrl">, url: string): string;
+export declare function makeFeedUrl(siteContext: Pick<PluginSiteContext, "multilingual" | "siteUrl">, language?: string): string;

package/dist/url.helpers.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFeedUrl = exports.toAbsoluteUrl = exports.fileExtensionOf = exports.makeUrlOfImageVariant = exports.makeUrlOfMediaFile = exports.getBoUrl = void 0;
+function getBoUrl({ path, fqdn, publicProtocol, boPort }) {
+    return `${publicProtocol}://${fqdn}${boPort === 80 ? "" : `:${boPort}`}${path ?? ""}`;
+}
+exports.getBoUrl = getBoUrl;
+function makeUrlOfMediaFile(siteContext, values, options) {
+    const { mediaUid, mediaType, originalName, absoluteUrl } = values;
+    const fileName = `${originalName ?? "unamed"}${fileExtensionOf(mediaType)}`;
+    const relUrl = `/medias/${encodeURIComponent(mediaUid)}/file/${encodeURIComponent(fileName)}`;
+    const url = absoluteUrl ? toAbsoluteUrl(siteContext, relUrl) : relUrl;
+    return options?.returnObj ? { url, fileName } : url;
+}
+exports.makeUrlOfMediaFile = makeUrlOfMediaFile;
+function makeUrlOfImageVariant(siteContext, values, options) {
+    const { mediaUid, mediaType, variantName, slug, resourceVersion, absoluteUrl } = values;
+    const fileName = `${slug ?? "unamed"}-${variantName}${fileExtensionOf(mediaType)}`;
+    let relUrl;
+    if (resourceVersion) {
+        relUrl = `/medias/${encodeURIComponent(mediaUid)}/image/${encodeURIComponent(resourceVersion)}/${encodeURIComponent(fileName)}`;
+    }
+    else {
+        relUrl = `/medias/${encodeURIComponent(mediaUid)}/image/${encodeURIComponent(fileName)}`;
+    }
+    const url = absoluteUrl ? toAbsoluteUrl(siteContext, relUrl) : relUrl;
+    return options?.returnObj ? { url, fileName } : url;
+}
+exports.makeUrlOfImageVariant = makeUrlOfImageVariant;
+function fileExtensionOf(mediaType) {
+    const regexMatchArray = mediaType.match(/\w+\/([-+.\w]+)/);
+    if (!regexMatchArray) {
+        throw new Error("media extension is incorrect.");
+    }
+    return `.${regexMatchArray[1]}`;
+}
+exports.fileExtensionOf = fileExtensionOf;
+function toAbsoluteUrl(siteContext, url) {
+    return url.startsWith("/") ? `${siteContext.siteUrl}${url}` : url;
+}
+exports.toAbsoluteUrl = toAbsoluteUrl;
+function makeFeedUrl(siteContext, language) {
+    if (siteContext.multilingual && !language) {
+        throw new Error("language is required for multilingual site");
+    }
+    return toAbsoluteUrl(siteContext, siteContext.multilingual ? `/${language}/feed` : "/feed");
+}
+exports.makeFeedUrl = makeFeedUrl;
+//# sourceMappingURL=url.helpers.js.map

package/dist/url.helpers.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@paroicms/public-server-lib",
+  "version": "0.6.0",
+  "description": "Common utilitaries for paroicms plugins (backend side).",
+  "author": "Paroi Team",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/paroi/opensource/paroicms.git",
+    "directory": "packages/public-server-lib"
+  },
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "clear": "rimraf dist/*",
+    "dev": "tsc --watch --preserveWatchOutput",
+    "eslint": "eslint ."
+  },
+  "devDependencies": {
+    "@types/node": "~20.12.8",
+    "rimraf": "~5.0.5",
+    "typescript": "~5.4.5",
+    "vitest": "~1.6.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@paroi/data-formatters-lib": "~0.4.0",
+    "@paroicms/internal-anywhere-lib": "1.17.0",
+    "@paroicms/public-anywhere-lib": "0.2.0"
+  }
+}