@paroicms/public-server-lib 0.12.3 → 0.14.0

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 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";

package/dist/index.js.map

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

package/dist/simple-i18n.d.ts

@@ -1,4 +1,4 @@
-import type { AppLog } from "../types/plugin-site-context-types";
+import type { AppLog } from "../types/backend-plugin-types";
 export interface SimpleTranslator {
     translate: (options: SimpleTranslateOptions) => string;
 }

package/dist/simple-i18n.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSimpleTranslator = createSimpleTranslator;
+const data_formatters_lib_1 = require("@paroi/data-formatters-lib");
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
-const data_formatters_lib_1 = require("@paroi/data-formatters-lib");
 async function createSimpleTranslator(options) {
     const labels = await loadLabels(options);
     return {

package/dist/simple-i18n.js.map

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

package/dist/url.helpers.d.ts

@@ -1,5 +1,5 @@
 import type { VariantName } from "@paroicms/public-anywhere-lib";
-import type { PluginSiteContext } from "../types/plugin-site-context-types";
+import type { BackendPluginService } from "../types/backend-plugin-types";
 export interface GetBoUrlOptions {
     path?: string;
     publicProtocol: string;
@@ -13,8 +13,8 @@ export interface UrlOfMediaFileValues {
     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: {
+export declare function makeUrlOfMediaFile(service: Pick<BackendPluginService, "siteUrl">, values: UrlOfMediaFileValues): string;
+export declare function makeUrlOfMediaFile(service: Pick<BackendPluginService, "siteUrl">, values: UrlOfMediaFileValues, options: {
     returnObj: true;
 }): {
     url: string;
@@ -28,13 +28,13 @@ export interface UrlOfImageVariantValues {
     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: {
+export declare function makeUrlOfImageVariant(service: Pick<BackendPluginService, "siteUrl">, values: UrlOfImageVariantValues): string;
+export declare function makeUrlOfImageVariant(service: Pick<BackendPluginService, "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, "siteSchema" | "siteUrl">, language?: string): string;
+export declare function toAbsoluteUrl(service: Pick<BackendPluginService, "siteUrl">, url: string): string;
+export declare function makeFeedUrl(service: Pick<BackendPluginService, "siteSchema" | "siteUrl">, language?: string): string;

package/dist/url.helpers.js

@@ -9,14 +9,14 @@ exports.makeFeedUrl = makeFeedUrl;
 function getBoUrl({ path, fqdn, publicProtocol, boPort }) {
     return `${publicProtocol}://${fqdn}${boPort === 80 ? "" : `:${boPort}`}${path ?? ""}`;
 }
-function makeUrlOfMediaFile(siteContext, values, options) {
+function makeUrlOfMediaFile(service, 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;
+    const url = absoluteUrl ? toAbsoluteUrl(service, relUrl) : relUrl;
     return options?.returnObj ? { url, fileName } : url;
 }
-function makeUrlOfImageVariant(siteContext, values, options) {
+function makeUrlOfImageVariant(service, values, options) {
     const { mediaUid, mediaType, variantName, slug, resourceVersion, absoluteUrl } = values;
     const fileName = `${slug ?? "unamed"}-${variantName}${fileExtensionOf(mediaType)}`;
     let relUrl;
@@ -26,7 +26,7 @@ function makeUrlOfImageVariant(siteContext, values, options) {
     else {
         relUrl = `/medias/${encodeURIComponent(mediaUid)}/image/${encodeURIComponent(fileName)}`;
     }
-    const url = absoluteUrl ? toAbsoluteUrl(siteContext, relUrl) : relUrl;
+    const url = absoluteUrl ? toAbsoluteUrl(service, relUrl) : relUrl;
     return options?.returnObj ? { url, fileName } : url;
 }
 function fileExtensionOf(mediaType) {
@@ -36,14 +36,14 @@ function fileExtensionOf(mediaType) {
     }
     return `.${regexMatchArray[1]}`;
 }
-function toAbsoluteUrl(siteContext, url) {
-    return url.startsWith("/") ? `${siteContext.siteUrl}${url}` : url;
+function toAbsoluteUrl(service, url) {
+    return url.startsWith("/") ? `${service.siteUrl}${url}` : url;
 }
-function makeFeedUrl(siteContext, language) {
-    const isMultilingual = siteContext.siteSchema.isMultilingual;
+function makeFeedUrl(service, language) {
+    const isMultilingual = service.siteSchema.isMultilingual;
     if (isMultilingual && !language) {
         throw new Error("language is required for multilingual site");
     }
-    return toAbsoluteUrl(siteContext, isMultilingual ? `/${language}/feed` : "/feed");
+    return toAbsoluteUrl(service, isMultilingual ? `/${language}/feed` : "/feed");
 }
 //# sourceMappingURL=url.helpers.js.map

package/dist/url.helpers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paroicms/public-server-lib",
-  "version": "0.12.3",
+  "version": "0.14.0",
   "description": "Common utilitaries for paroicms plugins (backend side).",
   "author": "Paroi Team",
   "repository": {
@@ -21,8 +21,8 @@
   },
   "dependencies": {
     "@paroi/data-formatters-lib": "~0.4.0",
-    "@paroicms/internal-anywhere-lib": "1.18.4",
-    "@paroicms/public-anywhere-lib": "0.6.0",
+    "@paroicms/internal-anywhere-lib": "1.18.6",
+    "@paroicms/public-anywhere-lib": "0.8.0",
     "@types/express": "*"
   },
   "devDependencies": {

package/types/backend-plugin-types.d.ts

@@ -1,49 +1,104 @@
 import type { Obj } from "@paroi/data-formatters-lib";
-import type { ImageSize } from "@paroicms/public-anywhere-lib";
+import type {
+  ImageSize,
+  ParsedSectionId,
+  ScSiteSchema,
+  ThemeConf,
+} from "@paroicms/public-anywhere-lib";
 import type { Request, Response } from "express";
-import type { AppLog, PluginSiteContext } from "./plugin-site-context-types";
 
 export interface ParoiCmsPlugin {
   version: string;
-  siteInit?: (api: PluginInitApi) => void | Promise<void>;
+  /**
+   * The slug of the plugin. It must be unique among all plugins. When it is not provided, then it
+   * is generated from the plugin name.
+   */
+  slug?: string;
+  siteInit?: (service: BackendPluginInitService) => void | Promise<void>;
 }
 
-export interface PluginInitApi {
-  siteLog: AppLog;
+export interface BackendPluginInitService {
+  logger: AppLog;
   setPublicAssetsDirectory(directory: string): void;
   setBoAssetsDirectory(directory: string): void;
   registerSiteSchemaLibrary(directory: string): void;
   registerLiquidRootDirectory(directory: string): void;
   registerLiquidFilter(
     filterName: string,
-    handler: (value: unknown) => string | Promise<string>,
+    handler: PluginLiquidFilterHandler,
     options?: { raw?: boolean },
   ): void;
   registerFieldPreprocessor(dataType: string, handler: FieldPreprocessor): void;
+  registerHook(hookName: string, handler: BackendHookHandler, options?: { unique?: boolean }): void;
   setPublicApiHandler(handler: PublicApiHandler): void;
   addHeadTag(...htmlTags: string[]): void;
   pluginConf: PluginConf;
+  pluginAssetsUrl: string;
 }
 
+export type BackendHookHandler = (service: BackendPluginService, params: any) => any;
+
+export type PluginLiquidFilterHandler = (
+  service: BackendPluginRenderService,
+  value: unknown,
+  options: {
+    /**
+     * The Liquid context
+     */
+    ctx: any;
+    args: any[];
+  },
+) => string | Promise<string>;
+
 export type PublicApiHandler = (
-  pluginSiteContext: PluginSiteContext,
+  service: BackendPluginRenderService,
   req: Request,
   res: Response,
   relativePath: string,
 ) => Promise<void> | void;
 
 export type FieldPreprocessor = (
-  ctx: FieldPreprocessorContext,
+  service: BackendPluginRenderService,
   value: unknown,
   options: FieldPreprocessorOptions,
 ) => unknown | Promise<unknown>;
 
-export interface FieldPreprocessorContext {
-  siteContext: PluginSiteContext;
-  useImage: UseImage;
+export interface BackendPluginService {
+  fqdn: string;
+  siteUrl: string;
+  siteSchema: ScSiteSchema;
+  themeConf: ThemeConf;
+  logger: AppLog;
+  validateRecaptchaResponse: (gRecaptchaResponse: string | undefined) => Promise<boolean>;
+  sendMail: ({ subject, html, replyTo, to }: MailData) => Promise<void>;
+  executeHook(hookName: string, params: any): any[];
+  pluginConf: PluginConf;
+  pluginAssetsUrl: string;
 }
 
-export type UseImage = (options: { imageUid: string; size: ImageSize }) => Promise<UsedImage>;
+export interface BackendPluginRenderService extends BackendPluginService {
+  getSiteFieldValue: (options: {
+    fieldName: string;
+    language?: string;
+  }) => Promise<unknown | undefined>;
+  renderChildPartials(options: {
+    req: Request;
+    res: Response;
+    params: PartialsParamsInput;
+    parentDocumentId: ParsedSectionId;
+    labeledByTermId?: string;
+  }): Promise<void>;
+  renderSearchPartials(options: {
+    req: Request;
+    res: Response;
+    language: string;
+    words: string[];
+    limit: number;
+    start: number;
+    templateName: string;
+  }): Promise<void>;
+  useImage: (options: { imageUid: string; size: ImageSize }) => Promise<UsedImage>;
+}
 
 export interface UsedImage {
   url: string;
@@ -65,3 +120,29 @@ export interface PluginConf {
   [key: string]: unknown;
   bo?: Obj;
 }
+
+export interface MailData {
+  subject: string;
+  html: string;
+  replyTo?: ReplyTo;
+  to: string;
+}
+
+export interface ReplyTo {
+  email: string;
+  name: string;
+}
+
+export interface AppLog {
+  error(...messages: any[]): void;
+  warn(...messages: any[]): void;
+  info(...messages: any[]): void;
+  debug(...messages: any[]): void;
+}
+
+export interface PartialsParamsInput {
+  templateName: string;
+  documentId: string;
+  offset: string;
+  limit: string;
+}

package/types/plugin-site-context-types.d.ts

@@ -1,64 +0,0 @@
-import type { ParsedSectionId, ScSiteSchema, ThemeConf } from "@paroicms/public-anywhere-lib";
-import type { Request, Response } from "express";
-export interface PluginSiteContext {
-  fqdn: string;
-  siteUrl: string;
-  siteSchema: ScSiteSchema;
-  themeConf: ThemeConf;
-  siteLog: AppLog;
-  validateRecaptchaResponse: (gRecaptchaResponse: string | undefined) => Promise<boolean>;
-  getSiteFieldValue: (options: {
-    fieldName: string;
-    language?: string;
-  }) => Promise<unknown | undefined>;
-  sendMail: (
-    { subject, html, replyTo, to }: MailData,
-    {
-      appLog,
-    }: {
-      appLog: AppLog;
-    },
-  ) => Promise<void>;
-  renderChildPartials(options: {
-    req: Request;
-    res: Response;
-    params: PartialsParamsInput;
-    parentDocumentId: ParsedSectionId;
-    labeledByTermId?: string;
-  }): Promise<void>;
-  renderSearchPartials(options: {
-    req: Request;
-    res: Response;
-    language: string;
-    words: string[];
-    limit: number;
-    start: number;
-    templateName: string;
-  }): Promise<void>;
-}
-
-export interface MailData {
-  subject: string;
-  html: string;
-  replyTo?: ReplyTo;
-  to: string;
-}
-
-export interface ReplyTo {
-  email: string;
-  name: string;
-}
-
-export interface AppLog {
-  error(...messages: any[]): void;
-  warn(...messages: any[]): void;
-  info(...messages: any[]): void;
-  debug(...messages: any[]): void;
-}
-
-export interface PartialsParamsInput {
-  templateName: string;
-  documentId: string;
-  offset: string;
-  limit: string;
-}