@paroicms/public-server-lib 0.48.5 → 0.49.0

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

@@ -1,4 +1,4 @@
-export type ApiErrorStatus = 400 | 401 | 403 | 404 | 409 | 500 | 503;
+export type ApiErrorStatus = 400 | 401 | 403 | 404 | 405 | 409 | 500 | 503;
 export declare class ApiError extends Error {
     readonly status: ApiErrorStatus;
     readonly statusLabel: string;

package/dist/api-error-handler.js

@@ -19,6 +19,8 @@ function getErrorLabel(status) {
             return "Forbidden";
         case 404:
             return "Not Found";
+        case 405:
+            return "Method Not Allowed";
         case 409:
             return "Conflict";
         case 500:

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

@@ -1 +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,KAAK,GAAG;YACN,OAAO,qBAAqB,CAAC;QAC/B;YACE,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC"}
+{"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,oBAAoB,CAAC;QAC9B,KAAK,GAAG;YACN,OAAO,UAAU,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,uBAAuB,CAAC;QACjC,KAAK,GAAG;YACN,OAAO,qBAAqB,CAAC;QAC/B;YACE,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export type * from "../types/load-descriptor-types.d.ts";
 export * from "./api-error-handler.js";
 export * from "./html-helpers.js";
 export * from "./load-descriptors.js";
+export * from "./media-handle-helpers.js";
 export * from "./obfuscate.helper.js";
 export * from "./server-image-cache-engine.helper.js";
 export * from "./simple-i18n.js";

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from "./api-error-handler.js";
 export * from "./html-helpers.js";
 export * from "./load-descriptors.js";
+export * from "./media-handle-helpers.js";
 export * from "./obfuscate.helper.js";
 export * from "./server-image-cache-engine.helper.js";
 export * from "./simple-i18n.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC"}

package/dist/internal/internal-html-utils.js

@@ -1,27 +1,36 @@
 const entities = {
     "&lt;": "<",
     "&#60;": "<",
+    "&#060;": "<",
     "&#x3C;": "<",
+    "&#x3c;": "<",
     "&gt;": ">",
     "&#62;": ">",
+    "&#062;": ">",
     "&#x3E;": ">",
+    "&#x3e;": ">",
     "&#47;": "/",
+    "&#047;": "/",
     "&#x2F;": "/",
+    "&#x2f;": "/",
     "&apos;": "'",
     "&#39;": "'",
+    "&#039;": "'",
     "&#x27;": "'",
     "&quot;": '"',
     "&#34;": '"',
+    "&#034;": '"',
     "&#x22;": '"',
     "&amp;": "&",
     "&#38;": "&",
+    "&#038;": "&",
     "&#x26;": "&",
 };
 export function newLinesToBr(text) {
     return text.replace(/(?:\r\n|\r|\n)/g, "<br>\n");
 }
 export function decodeHtmlEntities(str) {
-    return str.replace(/&lt;|&#60;|&#x3C;|&gt;|&#62;|&#x3E;|&#47;|&#x2F;|&apos;|&#39;|&#x27;|&quot;|&#34;|&#x22;|&amp;|&#38;|&#x26;/g, (match) => entities[match]);
+    return str.replace(/&lt;|&#0?60;|&#x3[Cc];|&gt;|&#0?62;|&#x3[Ee];|&#0?47;|&#x2[Ff];|&apos;|&#0?39;|&#x27;|&quot;|&#0?34;|&#x22;|&amp;|&#0?38;|&#x26;/g, (match) => entities[match]);
 }
 export function replaceLinks(html) {
     return html.replace(/<a\s+[^>]*href="([^"]*)"[^>]*>([^<]*)<\/a>/gi, (_, url, label) => {

package/dist/internal/internal-html-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-html-utils.js","sourceRoot":"","sources":["../../src/internal/internal-html-utils.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAiC;IAC7C,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,OAAO,CAChB,8GAA8G,EAC9G,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,8CAA8C,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACpF,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,GAAW;IAC7D,MAAM,KAAK,GACT,wLAAwL,CAAC;IAC3L,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"internal-html-utils.js","sourceRoot":"","sources":["../../src/internal/internal-html-utils.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAiC;IAC7C,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,OAAO,CAChB,mIAAmI,EACnI,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,8CAA8C,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACpF,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,GAAW;IAC7D,MAAM,KAAK,GACT,wLAAwL,CAAC;IAC3L,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/media-handle-helpers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Get the media handle for a document's or part's featured image.
+ * @param nodeId The nodeId of a document or a part. Do not use with the site node id.
+ */
+export declare function getHandleOfFeaturedImage(nodeId: string): string;
+/**
+ * Get the media handle for a field on a node.
+ * Use this for non-localized media fields and for gallery fields.
+ * @param siteNodeId The nodeId of the site (from homeRoutingCluster.siteNodeId)
+ * @param nodeId The nodeId of the target node
+ * @param fieldName The name of the field
+ */
+export declare function getHandleOfFieldOnNode({ siteNodeId, nodeId, fieldName, }: {
+    siteNodeId: string;
+    nodeId: string;
+    fieldName: string;
+}): string;
+/**
+ * Get the media handle for a site field.
+ * @param fieldName The name of the site field (e.g., "favicon", "ogImage", "logo")
+ */
+export declare function getHandleOfSiteField(fieldName: string): string;

package/dist/media-handle-helpers.js

@@ -0,0 +1,27 @@
+/**
+ * Get the media handle for a document's or part's featured image.
+ * @param nodeId The nodeId of a document or a part. Do not use with the site node id.
+ */
+export function getHandleOfFeaturedImage(nodeId) {
+    return `node:${nodeId}:featuredImage`;
+}
+/**
+ * Get the media handle for a field on a node.
+ * Use this for non-localized media fields and for gallery fields.
+ * @param siteNodeId The nodeId of the site (from homeRoutingCluster.siteNodeId)
+ * @param nodeId The nodeId of the target node
+ * @param fieldName The name of the field
+ */
+export function getHandleOfFieldOnNode({ siteNodeId, nodeId, fieldName, }) {
+    if (nodeId === siteNodeId)
+        return `site:${fieldName}`;
+    return `node:${nodeId}:${fieldName}`;
+}
+/**
+ * Get the media handle for a site field.
+ * @param fieldName The name of the site field (e.g., "favicon", "ogImage", "logo")
+ */
+export function getHandleOfSiteField(fieldName) {
+    return `site:${fieldName}`;
+}
+//# sourceMappingURL=media-handle-helpers.js.map

package/dist/media-handle-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-handle-helpers.js","sourceRoot":"","sources":["../src/media-handle-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,UAAU,EACV,MAAM,EACN,SAAS,GAKV;IACC,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,QAAQ,SAAS,EAAE,CAAC;IACtD,OAAO,QAAQ,MAAM,IAAI,SAAS,EAAE,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,QAAQ,SAAS,EAAE,CAAC;AAC7B,CAAC"}

package/dist/typeonly-validator.d.ts

@@ -3,4 +3,8 @@ export declare const siteSchemaFormatVersion = "10";
  * JSON types directory.
  */
 export declare const jtDir: string;
+/**
+ * Docs directory.
+ */
+export declare const docsDir: string;
 export declare const jsonTypeValidator: import("@typeonly/validator").TypeOnlyValidator;

package/dist/typeonly-validator.js

@@ -8,6 +8,10 @@ export const siteSchemaFormatVersion = "10";
  * JSON types directory.
  */
 export const jtDir = join(packageDir, "typeonly");
+/**
+ * Docs directory.
+ */
+export const docsDir = join(packageDir, "docs");
 export const jsonTypeValidator = createValidator({
     bundle: JSON.parse(readFileSync(join(packageDir, "dist", "types.to.json"), "utf-8")),
 });

package/dist/typeonly-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"typeonly-validator.js","sourceRoot":"","sources":["../src/typeonly-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;IAC/C,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;CACrF,CAAC,CAAC"}
+{"version":3,"file":"typeonly-validator.js","sourceRoot":"","sources":["../src/typeonly-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;IAC/C,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;CACrF,CAAC,CAAC"}

package/docs/introduction-to-paroicms.md

@@ -0,0 +1,15 @@
+We use **ParoiCMS** to power a website.
+
+With this technology, a web page is called a **document**. A website is a tree of documents. The home page is a document, the site section with news posts is a document, each post is a document. Each document has its own path in the URL.
+
+There is a special kind of documents that we want to detect: **routing documents** are the site sections. They can't be duplicated. They are never items of a list. For example, the homepage document, the search-page document, the "about us" document, the parent page of blog posts are _routing documents_. Other documents are **regular documents**, and they are always items of a list.
+
+A document always has the following base attributes: a localized _title_, a _publish date_, an optional _featured image_, and a _draft_ flag. Additionally, a sequence of **fields** can be defined.
+
+A document can contain lists of **parts**. A _part_ is a sub-section of a document, or of another _part_. A part always has a _publish date_ and a _draft_ flag. It may contain a sequence of fields and/or a sequence of child parts. A part is always an item of a list.
+
+Any routing document which is parent of regular documents can be used as a **taxonomy**. Then, the terms are the regular child documents. Then a taxonomy can be used in any document or part, by declaring a **labeling field**. There is a special taxonomy: the **authors** taxonomy can be declared, but it is implicitly defined when it is omitted. But the authors labeling field must be explicitly declared in document and part types when needed.
+
+Documents and parts are **nodes** in a tree. Children are part of the definition of a node type. When 2 node types appear identical, but their children types are not the same, then they are 2 different node types and they should have 2 different names.
+
+The **site schema** is the representation of this ParoiCMS site structure.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paroicms/public-server-lib",
-  "version": "0.48.5",
+  "version": "0.49.0",
   "description": "Common utilitaries for paroicms plugins (backend side).",
   "author": "Paroi Team",
   "repository": {
@@ -22,21 +22,22 @@
     "dev": "tsc --watch --preserveWatchOutput"
   },
   "dependencies": {
-    "@paroicms/internal-anywhere-lib": "1.35.8",
-    "@paroicms/public-anywhere-lib": "0.38.3",
-    "@paroicms/script-lib": "0.3.8",
+    "@paroicms/internal-anywhere-lib": "1.35.9",
+    "@paroicms/public-anywhere-lib": "0.39.0",
+    "@paroicms/script-lib": "0.3.9",
     "@typeonly/validator": "~1.1.2",
     "arktype": "~2.1.27"
   },
   "devDependencies": {
     "@types/node": "~24.10.1",
-    "rimraf": "~6.1.0",
+    "rimraf": "~6.1.2",
     "typeonly": "~1.1.3",
     "typescript": "~5.9.3",
-    "vitest": "~4.0.10"
+    "vitest": "~4.0.13"
   },
   "files": [
     "dist",
+    "docs",
     "types",
     "typeonly"
   ]

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

@@ -1,19 +1,19 @@
 import type {
   HomeRoutingCluster,
   JsonFieldValue,
+  MAttachedData,
   MImageVariant,
   MSourceImage,
   MSourceMedia,
   Obj,
-  ParsedLNodeId,
   ReadFieldValue,
+  ReadFieldValues,
   ResizeRule,
-  ScFieldDataType,
   ScFieldType,
   ScSiteSchema,
   ThemeConf,
   UpdateFieldValue,
-  UpdateLabelingFieldValue,
+  UpdateFieldValues,
   WithAttachedData,
 } from "@paroicms/public-anywhere-lib";
 import type Stream from "node:stream";
@@ -112,6 +112,10 @@ export interface BackendPluginInitService extends PluginStaticConfiguration {
     >,
   ): void;
   registerHook(hookName: "sendMail", handler: BackendHookHandler<MailData, undefined, void>): void;
+  registerHook(
+    hookName: "markdownToNative",
+    handler: BackendHookHandler<string, { language: string }, JsonFieldValue | string>,
+  ): void;
   registerRenderingHook(hookName: "fieldPreprocessor", handler: RenderingHookHandler): void;
   setPublicApiHandler(handler: PublicApiHandler): void;
   /** @deprecated Use `registerHeadTags` instead. */
@@ -132,10 +136,10 @@ export type BackendHookHandler<V = unknown, O = unknown, R = unknown> = (hookPay
   options: O;
 }) => Promise<R> | R;
 
-export type RenderingHookHandler = (hookPayload: {
+export type RenderingHookHandler<V extends ReadFieldValue = ReadFieldValue> = (hookPayload: {
   service: PluginRenderingService;
+  value: V;
   options: RenderingHookOptions;
-  value: ReadFieldValue;
 }) => ReadFieldValue | undefined | Promise<ReadFieldValue | undefined>;
 
 export interface RenderingHookOptions {
@@ -196,8 +200,9 @@ export interface BackendPluginService extends PluginStaticConfiguration {
   ): Promise<unknown> | unknown;
   registeredSite: RegisteredSite;
   pluginAssetsUrl: string;
-  /** This is the connector of the running instance of ParoiCMS. */
-  connector: RunningServerConnector;
+  getSiteConnector(input: { pat: string }): RunningSiteConnector;
+  getUnsafeSiteConnector(input: { fqdn: string }): RunningSiteConnector;
+  getServerConnector(): RunningServerConnector;
   getSiteFieldValue: (options: {
     fieldName: string;
     language?: string;
@@ -359,39 +364,163 @@ export interface SubDomainSitePackConfiguration extends SitePackConfigurationBas
 
 /* Running instance types */
 
+export interface RunningSiteConnector {
+  loadSiteSchemaAndIds(): Promise<RiSiteSchemaAndIds>;
+  getSiteInfo(): Promise<SiteInfo>;
+  createAccount(account: RiNewAccount, options?: { asContactEmail?: boolean }): Promise<string>;
+  updateSiteFields(language: string, values: UpdateFieldValues): Promise<void>;
+  removeSite: () => Promise<void>;
+  searchDocuments(input: {
+    language: string;
+    words: string[];
+    limit?: number;
+    offset?: number;
+  }): Promise<{
+    items: DocumentInfo[];
+    total?: number;
+  }>;
+  deleteDocument(documentId: string): Promise<void>;
+  publishDocument(documentId: string, publishDate?: string): Promise<void>;
+  unpublishDocument(documentId: string): Promise<void>;
+  getDocument(documentId: string): Promise<FullDocument>;
+  updateDocument(documentId: string, values: UpdateDocumentValues): Promise<void>;
+  updateFields(lNodeId: string, values: UpdateFieldValues): Promise<void>;
+  createDocument(input: CreateDocumentInput): Promise<MinimalDocumentInfo>;
+  createDocumentTranslation(input: CreateDocumentTranslationInput): Promise<MinimalDocumentInfo>;
+  createPart(input: CreatePartInput): Promise<MinimalPartInfo>;
+  createPartTranslation(input: CreatePartTranslationInput): Promise<MinimalPartInfo>;
+  setMedia(input: SetMediaInput): Promise<MSourceMedia>;
+}
+
+export interface MinimalDocumentInfo {
+  documentId: string;
+  nodeId: string;
+  parentNodeId: string;
+  relativeId: string;
+  typeName: string;
+  /** ISO 8601 date string */
+  publishDate?: string;
+  /** If `false`, then it's a draft */
+  ready: boolean;
+  language: string;
+  title?: string;
+  slug?: string;
+}
+
+export interface SiteInfo {
+  siteNodeId: string;
+  title: { [language: string]: string | undefined };
+  siteSchema: ScSiteSchema;
+  mainCluster: ClusterNodeInfo;
+}
+
+export interface ClusterNodeInfo {
+  nodeId: string;
+  typeName: string;
+  relativeId?: string;
+  /** ISO 8601 date string */
+  publishDate?: string;
+  availableIn: { [language: string]: MinimalDocumentClusterInfo };
+  children?: { [typeName: string]: ClusterNodeInfo };
+}
+
+export interface MinimalDocumentClusterInfo {
+  documentId: string;
+  language: string;
+  /** If `false`, then it's a draft */
+  ready: boolean;
+  title?: string;
+  slug?: string;
+}
+
+export interface MinimalPartInfo {
+  partId: string;
+  nodeId: string;
+  parentNodeId: string;
+  relativeId: string;
+  typeName: string;
+  listName: string;
+  /** ISO 8601 date string */
+  publishDate?: string;
+  ready: boolean;
+  language: string;
+}
+
+export interface DocumentInfo extends MinimalDocumentInfo {
+  /** Absolute URL, only present when document is published (ready & publishDate in the past) */
+  url?: string;
+  relatedTerms: RelatedTermsInfo;
+}
+
+export interface RelatedTermsInfo {
+  [fieldName: string]: {
+    taxonomyTypeName: string;
+    terms: MinimalDocumentInfo[];
+  };
+}
+
+export interface UpdateDocumentValues {
+  title?: string;
+  slug?: string;
+  metaDescription?: string;
+  metaKeywords?: string;
+}
+
+export interface CreateDocumentInput {
+  parentLNodeId: string;
+  typeName: string;
+  title?: string;
+  slug?: string;
+  values?: UpdateFieldValues;
+}
+
+export interface CreatePartInput {
+  parentLNodeId: string;
+  typeName: string;
+  values?: UpdateFieldValues;
+}
+
+export interface CreateDocumentTranslationInput {
+  nodeId: string;
+  language: string;
+  title?: string;
+  slug?: string;
+  values?: UpdateFieldValues;
+}
+
+export interface CreatePartTranslationInput {
+  nodeId: string;
+  language: string;
+  values?: UpdateFieldValues;
+}
+
+export interface SetMediaInput {
+  /** The media handle - use helper functions to compute this */
+  handle: string;
+  /** Local file path to the media file */
+  filePath: string;
+  /** Optional attached data (caption, credit, etc.) */
+  attachedData?: MAttachedData;
+  /** If true, replaces existing media at this handle. If false (default), adds to handle (for galleries) */
+  replace?: boolean;
+}
+
+export interface FullDocument extends DocumentInfo {
+  fieldValues: ReadFieldValues;
+  parts: {
+    [listName: string]: FullPart[];
+  };
+}
+
+export interface FullPart extends MinimalPartInfo {
+  fieldValues: ReadFieldValues;
+  children?: FullPart[];
+}
+
 export interface RunningServerConnector {
   getSitePackConf(packName: string): SitePackConfiguration;
-  loadSiteSchemaAndIds(fqdn: string): Promise<RiSiteSchemaAndIds>;
-  createAccount(
-    fqdn: string,
-    account: RiNewAccount,
-    options?: { asContactEmail?: boolean },
-  ): Promise<string>;
-  updateSiteFields(fqdn: string, fields: RiFieldSetContent): Promise<void>;
-  updateNodeContent(
-    fqdn: string,
-    options: {
-      nodeId: string;
-      content: RiNodeContent;
-    },
-  ): Promise<void>;
-  addMultipleDocumentContents(
-    fqdn: string,
-    options: {
-      parentNodeId: string;
-      contents: RiDocumentContent[];
-    },
-  ): Promise<ParsedLNodeId[]>;
-  addMultiplePartContents(
-    fqdn: string,
-    options: {
-      parentNodeId: string;
-      contents: RiPartContent[];
-    },
-  ): Promise<ParsedLNodeId[]>;
-  registerNewSite: (options: NewSiteOptions) => Promise<RegisteredSite>;
-  removeSite: (fqdn: string) => Promise<void>;
   migrateSiteSchemas(): Promise<void>;
+  registerNewSite: (options: NewSiteOptions) => Promise<RegisteredSite>;
   createBlankSiteFromExisting(options: CreateBlankSiteOptions): Promise<void>;
 }
 
@@ -421,66 +550,3 @@ export interface RiExternalNewAccount {
   name: string;
   roles: string[];
 }
-
-export type RiNodeContent = RiDocumentContent | RiPartContent;
-
-export interface RiDocumentContent {
-  kind: "document";
-  typeName: string;
-  title?: { [language: string]: string };
-  featuredImage?: RiMediaValue;
-  fields: RiFieldSetContent;
-}
-
-export interface RiPartContent {
-  kind: "part";
-  typeName: string;
-  fields: RiFieldSetContent;
-}
-
-export interface RiFieldSetContent {
-  [fieldName: string]: RiFieldContent;
-}
-
-export type RiFieldContent =
-  | RiStringContent
-  | RiNumberContent
-  | RiBooleanContent
-  | RiJsonContent
-  | RiMediaContent
-  | RiGalleryContent
-  | RiLabelingContent;
-
-export type RiStringContent = RiFieldContentTemplate<"string", string>;
-export type RiNumberContent = RiFieldContentTemplate<"number", number>;
-export type RiBooleanContent = RiFieldContentTemplate<"boolean", boolean>;
-export type RiJsonContent = RiFieldContentTemplate<"json", JsonFieldValue>;
-export type RiMediaContent = RiFieldContentTemplate<"media", RiMediaValue>;
-export type RiGalleryContent = RiFieldContentTemplate<"gallery", RiGalleryValue>;
-export type RiLabelingContent = RiUnlocalizedFieldContent<"labeling", UpdateLabelingFieldValue>;
-
-export type RiFieldContentTemplate<T extends ScFieldDataType, V> =
-  | RiLocalizedFieldContent<T, V>
-  | RiUnlocalizedFieldContent<T, V>;
-
-export interface RiLocalizedFieldContent<T extends ScFieldDataType, V> {
-  dataType: T;
-  localized: true;
-  value: {
-    [language: string]: V | null;
-  };
-}
-
-export interface RiUnlocalizedFieldContent<T extends ScFieldDataType, V> {
-  dataType: T;
-  localized: false;
-  value: V | null;
-}
-
-export interface RiMediaValue {
-  file: string;
-}
-
-export interface RiGalleryValue {
-  files: string[];
-}