@paroicms/public-server-lib 0.29.0 → 0.31.0

package/dist/api-error-handler.d.ts

@@ -0,0 +1,7 @@
+export type ApiErrorStatus = 400 | 401 | 403 | 404 | 409 | 500;
+export declare class ApiError extends Error {
+    readonly status: ApiErrorStatus;
+    readonly statusLabel: string;
+    constructor(status: ApiErrorStatus);
+    constructor(message: string, status: ApiErrorStatus);
+}

package/dist/api-error-handler.js

@@ -0,0 +1,30 @@
+export class ApiError extends Error {
+    status;
+    statusLabel;
+    constructor(arg1, arg2) {
+        const message = typeof arg1 === "string" ? arg1 : getErrorLabel(arg1);
+        const status = (typeof arg1 === "string" ? arg2 : arg1) ?? 500;
+        super(message);
+        this.status = status;
+        this.statusLabel = getErrorLabel(status);
+    }
+}
+function getErrorLabel(status) {
+    switch (status) {
+        case 400:
+            return "Bad Request";
+        case 401:
+            return "Unauthorized";
+        case 403:
+            return "Forbidden";
+        case 404:
+            return "Not Found";
+        case 409:
+            return "Conflict";
+        case 500:
+            return "Internal Server Error";
+        default:
+            return "Unknown Error";
+    }
+}
+//# sourceMappingURL=api-error-handler.js.map

package/dist/api-error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error-handler.js","sourceRoot":"","sources":["../src/api-error-handler.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAiB;IACvB,WAAW,CAAS;IAI7B,YAAY,IAA6B,EAAE,IAAqB;QAC9D,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,aAAa,CAAC;QACvB,KAAK,GAAG;YACN,OAAO,cAAc,CAAC;QACxB,KAAK,GAAG;YACN,OAAO,WAAW,CAAC;QACrB,KAAK,GAAG;YACN,OAAO,WAAW,CAAC;QACrB,KAAK,GAAG;YACN,OAAO,UAAU,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,uBAAuB,CAAC;QACjC;YACE,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC"}

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

@@ -1,7 +1,7 @@
 /**
  * @see https://stackoverflow.com/a/4835406/3786294
  */
-export declare function escapeHtml(text: string, options?: {
+export declare function escapeHtml(text: string | undefined, options?: {
     newLinesToBr?: boolean;
 }): string;
 export declare function decodeHtmlEntities(str: string): string;

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

@@ -9,6 +9,8 @@ const htmlEntities = {
     "'": "'",
 };
 export function escapeHtml(text, options = {}) {
+    if (!text)
+        return "";
     let val = text;
     val = val.replace(/[&<>"']/g, (m) => htmlEntities[m]);
     if (options.newLinesToBr) {

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

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

@@ -1,4 +1,5 @@
 export type * from "../types/backend-plugin-types.d.ts";
+export * from "./api-error-handler.js";
 export * from "./esm-module.helper.js";
 export * from "./html-helpers/html-helpers.js";
 export * from "./obfuscate.helper.js";

package/dist/index.js

@@ -1,3 +1,4 @@
+export * from "./api-error-handler.js";
 export * from "./esm-module.helper.js";
 export * from "./html-helpers/html-helpers.js";
 export * from "./obfuscate.helper.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paroicms/public-server-lib",
-  "version": "0.29.0",
+  "version": "0.31.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.26.0",
-    "@paroicms/public-anywhere-lib": "0.20.0",
+    "@paroicms/internal-anywhere-lib": "1.27.0",
+    "@paroicms/public-anywhere-lib": "0.21.0",
     "@types/express": "~4.17.21"
   },
   "devDependencies": {

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

@@ -1,8 +1,9 @@
 import type { Obj } from "@paroi/data-formatters-lib";
 import type {
-  FieldValue,
   ImageSize,
+  JsonFieldValue,
   ParsedNodelId,
+  ReadFieldValue,
   ScFieldDataType,
   ScSiteSchema,
   SiteIds,
@@ -74,11 +75,11 @@ export interface BackendPluginInitService {
     handler: PluginLiquidFilterHandler,
     options?: { raw?: boolean },
   ): void;
-  registerFieldPreprocessor(dataType: string, handler: FieldPreprocessor): void;
+  registerFieldPreprocessor(handler: FieldPreprocessor): void;
   registerHook(hookName: string, handler: BackendHookHandler, options?: { unique?: boolean }): void;
   setPublicApiHandler(handler: PublicApiHandler): void;
   addHeadTag(...htmlTags: string[]): void;
-  pluginConf: PluginConf;
+  configuration: PluginConfiguration;
   pluginAssetsUrl: string;
 }
 
@@ -104,9 +105,9 @@ export type PublicApiHandler = (
 
 export type FieldPreprocessor = (
   service: BackendPluginRenderService,
-  value: FieldValue,
+  value: ReadFieldValue,
   options: FieldPreprocessorOptions,
-) => FieldValue | undefined | Promise<FieldValue | undefined>;
+) => ReadFieldValue | undefined | Promise<ReadFieldValue | undefined>;
 
 export interface BackendPluginService {
   fqdn: string;
@@ -117,7 +118,7 @@ export interface BackendPluginService {
   validateRecaptchaResponse: (gRecaptchaResponse: string | undefined) => Promise<boolean>;
   sendMail: ({ subject, html, replyTo, to }: MailData) => Promise<void>;
   executeHook<T = unknown>(hookName: string, params?: any): T[];
-  pluginConf: PluginConf;
+  configuration: PluginConfiguration;
   pluginAssetsUrl: string;
   registerNewSite: (options: NewSiteOptions) => Promise<Readonly<SiteConf>>;
   /** This is the connector of the running instance of ParoiCMS. */
@@ -135,13 +136,13 @@ export interface BackendPluginRenderService extends BackendPluginService {
   getSiteFieldValue: (options: {
     fieldName: string;
     language?: string;
-  }) => Promise<FieldValue | undefined>;
+  }) => Promise<ReadFieldValue | undefined>;
   renderChildPartials(
     ctx: PaHttpContext,
     options: {
       params: PartialsParamsInput;
       parentDocumentId: ParsedNodelId;
-      labeledByTermId?: string;
+      labeledBy?: LabeledBy;
     },
   ): Promise<void>;
   renderSearchPartials(
@@ -158,6 +159,11 @@ export interface BackendPluginRenderService extends BackendPluginService {
   getDocument: (documentId: string) => Promise<PublicDocument | undefined>;
 }
 
+export interface LabeledBy {
+  termNodeId: string;
+  fieldName: string;
+}
+
 export interface PublicDocument {
   id: string;
   getUrl: (options?: { absoluteUrl?: boolean }) => Promise<string>;
@@ -182,13 +188,14 @@ export interface FieldPreprocessorOptions {
   outputType?: "plainText";
 }
 
-export interface PluginConfs {
-  [pluginName: string]: PluginConf;
+export interface PluginConfigurations {
+  [pluginName: string]: PluginConfiguration;
 }
 
-export interface PluginConf {
+export interface PluginConfiguration {
   [key: string]: unknown;
   backOffice?: Obj;
+  googleRecaptchaKey?: string;
 }
 
 export interface MailData {
@@ -338,7 +345,7 @@ export type RiFieldContent =
 export type RiStringContent = RiFieldContentTemplate<"string", string>;
 export type RiNumberContent = RiFieldContentTemplate<"number", number>;
 export type RiBooleanContent = RiFieldContentTemplate<"boolean", boolean>;
-export type RiQuillDeltaContent = RiFieldContentTemplate<"quillDelta", QuillDeltaValue>;
+export type RiQuillDeltaContent = RiFieldContentTemplate<"json", JsonFieldValue>;
 export type RiMediaContent = RiFieldContentTemplate<"media", RiMediaValue>;
 export type RiGalleryContent = RiFieldContentTemplate<"gallery", RiGalleryValue>;
 
@@ -367,8 +374,3 @@ export interface RiMediaValue {
 export interface RiGalleryValue {
   files: string[];
 }
-
-// TODO: replace with markdown content. The plugin should convert markdown to quill delta.
-export interface QuillDeltaValue {
-  ops: any[];
-}