@paroicms/public-server-lib 0.43.0 → 0.45.0

package/dist/index.d.ts

@@ -1,6 +1,11 @@
+export type * from "../typeonly/common-schema-json-types.d.ts";
+export type * from "../typeonly/configuration-types.d.ts";
+export type * from "../typeonly/site-schema-json-types.d.ts";
+export type * from "../typeonly/theme-json-types.d.ts";
 export type * from "../types/backend-plugin-types.d.ts";
 export * from "./api-error-handler.js";
 export * from "./html-helpers.js";
 export * from "./obfuscate.helper.js";
 export * from "./server-image-cache-engine.helper.js";
 export * from "./simple-i18n.js";
+export * from "./typeonly-validator.js";

package/dist/index.js

@@ -3,4 +3,5 @@ export * from "./html-helpers.js";
 export * from "./obfuscate.helper.js";
 export * from "./server-image-cache-engine.helper.js";
 export * from "./simple-i18n.js";
+export * from "./typeonly-validator.js";
 //# sourceMappingURL=index.js.map

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,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uCAAuC,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/typeonly-validator.d.ts

@@ -0,0 +1,6 @@
+export declare const siteSchemaFormatVersion = "9";
+/**
+ * JSON types directory.
+ */
+export declare const jtDir: string;
+export declare const jsonTypeValidator: import("@typeonly/validator").TypeOnlyValidator;

package/dist/typeonly-validator.js

@@ -0,0 +1,14 @@
+import { esmDirName } from "@paroicms/script-lib";
+import { createValidator } from "@typeonly/validator";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const packageDir = dirname(esmDirName(import.meta.url));
+export const siteSchemaFormatVersion = "9";
+/**
+ * JSON types directory.
+ */
+export const jtDir = join(packageDir, "typeonly");
+export const jsonTypeValidator = createValidator({
+    bundle: JSON.parse(readFileSync(join(packageDir, "dist", "types.to.json"), "utf-8")),
+});
+//# sourceMappingURL=typeonly-validator.js.map

package/dist/typeonly-validator.js.map

@@ -0,0 +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,GAAG,CAAC;AAE3C;;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"}

package/dist/types.to.json

@@ -0,0 +1 @@
+{"./common-schema-json-types":{"imports":[{"from":"./site-schema-json-types","namedMembers":[{"name":"JtFieldType"},{"name":"JtLabelLocales"}]}],"namedTypes":[{"name":"JtInternalCommonSchema","exported":true,"docComment":"The common schema is currently an internal file. Here is its typing.","kind":"interface","properties":[{"name":"ParoiCMSSiteSchemaFormatVersion","type":{"kind":"name","group":"primitive","refName":"string"},"docComment":"This is the version of the schema engine."},{"name":"languages","type":{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"string"}},"docComment":"Specify the list of 2-letters language codes that can be used in the websites.\n\n@example [\"en\", \"fr\"]`"},{"name":"siteFields","type":{"kind":"array","itemType":{"kind":"importedRef","refName":"JtFieldType"}},"docComment":"The common fields of any websites. They are currently: `[\"title\", \"contactEmail\", \"favicon\", \"ogImage\"]`."}]},{"name":"JtInternalCommonSchemaTranslations","exported":true,"kind":"interface","properties":[{"name":"languageLabel","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"siteFields","type":{"kind":"interface","indexSignature":{"keyName":"fieldName","keyType":"string","type":{"kind":"importedRef","refName":"JtLabelLocales"}}},"optional":true}]}]},"./configuration-types":{"namedTypes":[{"name":"JtConfiguration","exported":true,"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtSingleSiteConfiguration"},{"kind":"localRef","refName":"JtMultisiteConfiguration"}]},{"name":"JtConfigurationBase","exported":true,"kind":"interface","properties":[{"name":"thisServer","type":{"kind":"localRef","refName":"JtDeprecatedThisServerConf"},"optional":true,"docComment":"@deprecated Move the sub-properties in the parent."},{"name":"port","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"It is required except if the legacy `thisServer` is still used."},{"name":"hostname","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true},{"name":"publicProtocol","type":{"kind":"composite","op":"union","types":[{"kind":"literal","literal":"http"},{"kind":"literal","literal":"https"}]},"optional":true,"docComment":"Default is `\"http\"`."},{"name":"publicPort","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true},{"name":"boPort","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"@deprecated Use adminUiPort instead."},{"name":"adminUiPort","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true},{"name":"allowRobots","type":{"kind":"name","group":"primitive","refName":"boolean"}},{"name":"enableCache","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"immutableAssets","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"cacheTimeToIdle","type":{"kind":"composite","op":"union","types":[{"kind":"name","group":"primitive","refName":"string"},{"kind":"literal","literal":"disabled"},{"kind":"literal","literal":"infinite"}]},"optional":true,"docComment":"For example: `\"14d\"`."},{"name":"clearCacheAfterStart","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"clearImageCacheAfterStart","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"log","type":{"kind":"localRef","refName":"JtLogConf"},"optional":true,"docComment":"@deprecated Replace `log.level` by `logLevel`, and `log.file` by `logFile`."},{"name":"logLevel","type":{"kind":"composite","op":"union","types":[{"kind":"literal","literal":"silent"},{"kind":"literal","literal":"error"},{"kind":"literal","literal":"warn"},{"kind":"literal","literal":"info"},{"kind":"literal","literal":"stats"},{"kind":"literal","literal":"debug"},{"kind":"literal","literal":"trace"}]},"optional":true},{"name":"logFile","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true,"docComment":"Omit for stdout."},{"name":"graphqlDevTools","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"generateMissingDatabases","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"googleAuth","type":{"kind":"localRef","refName":"JtGoogleAuthConf"},"optional":true},{"name":"awsSesMail","type":{"kind":"localRef","refName":"JtDeprecatedAwsSesMailConf"},"optional":true,"docComment":"@deprecated Use \"@paroicms/send-mail-aws-ses-plugin\" configuration instead"},{"name":"googleRecaptcha","type":{"kind":"localRef","refName":"JtDeprecatedGoogleRecaptchaConf"},"optional":true,"docComment":"@deprecated Use \"@paroicms/contact-form-plugin\" configuration instead"},{"name":"imageProcessor","type":{"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtImageProcessorConf"},{"kind":"localRef","refName":"JtLegacyImageProcessorConf"}]},"optional":true},{"name":"devAccount","type":{"kind":"localRef","refName":"JtDevAccountConf"},"optional":true},{"name":"platformAdminAccounts","type":{"kind":"array","itemType":{"kind":"localRef","refName":"JtPlatformAdminAccountConf"}},"optional":true},{"name":"plugins","type":{"kind":"composite","op":"union","types":[{"kind":"array","itemType":{"kind":"localRef","refName":"JtPluginStaticConfiguration"}},{"kind":"localRef","refName":"JtDeprecatedPluginConfigurations"}]},"optional":true},{"name":"httpRedirections","type":{"kind":"array","itemType":{"kind":"localRef","refName":"JtHttpRedirection"}},"optional":true}]},{"name":"JtHttpRedirection","exported":true,"kind":"interface","properties":[{"name":"fromFqdn","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"to","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"mapPaths","type":{"kind":"interface","indexSignature":{"keyName":"fromRegex","keyType":"string","type":{"kind":"name","group":"primitive","refName":"string"}}},"optional":true},{"name":"preservePath","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true}]},{"name":"JtSingleSiteConfiguration","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtConfigurationBase"},{"kind":"interface","properties":[{"name":"singleSite","type":{"kind":"localRef","refName":"JtSingleSiteConf"}}]}]},{"name":"JtMultisiteConfiguration","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtConfigurationBase"},{"kind":"interface","properties":[{"name":"platform","type":{"kind":"interface","properties":[{"name":"dataDir","type":{"kind":"name","group":"primitive","refName":"string"}}]}},{"name":"sitePacks","type":{"kind":"array","itemType":{"kind":"localRef","refName":"JtSitePackOrLegacyConf"}}}]}]},{"name":"JtDeprecatedThisServerConf","exported":true,"kind":"interface","properties":[{"name":"port","type":{"kind":"name","group":"primitive","refName":"number"}},{"name":"publicPort","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true},{"name":"boPublicPort","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true},{"name":"hostName","type":{"kind":"composite","op":"union","types":[{"kind":"name","group":"primitive","refName":"string"},{"kind":"name","group":"primitive","refName":"null"}]},"optional":true},{"name":"https","type":{"kind":"name","group":"primitive","refName":"boolean"}}]},{"name":"JtLogConf","exported":true,"kind":"interface","properties":[{"name":"level","type":{"kind":"composite","op":"union","types":[{"kind":"literal","literal":"silent"},{"kind":"literal","literal":"error"},{"kind":"literal","literal":"warn"},{"kind":"literal","literal":"info"},{"kind":"literal","literal":"stats"},{"kind":"literal","literal":"debug"},{"kind":"literal","literal":"trace"}]}},{"name":"file","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true,"docComment":"Omit for stdout."}]},{"name":"JtSingleSiteConf","exported":true,"kind":"interface","properties":[{"name":"siteDir","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"dataDir","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"cacheDir","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"backupDir","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"fqdn","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"redirectWww","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"trusted","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true}]},{"name":"JtSitePackOrLegacyConf","exported":true,"kind":"composite","op":"union","types":[{"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtSitePackConf"},{"kind":"localRef","refName":"JtLegacyFqdnSitePackConf"},{"kind":"localRef","refName":"JtLegacySubDomainSitePackConf"}]}]},{"name":"JtSitePackConf","exported":true,"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtFqdnSitePackConf"},{"kind":"localRef","refName":"JtSubDomainSitePackConf"}]},{"name":"JtSitePackConfBase","exported":true,"kind":"interface","properties":[{"name":"packName","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"sitesDir","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true},{"name":"dataDir","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"cacheDir","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"backupDir","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"redirectWww","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"trusted","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true}]},{"name":"JtFqdnSitePackConf","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtSitePackConfBase"},{"kind":"interface","properties":[{"name":"serveOn","type":{"kind":"literal","literal":"fqdn"}}]}]},{"name":"JtSubDomainSitePackConf","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtSitePackConfBase"},{"kind":"interface","properties":[{"name":"serveOn","type":{"kind":"literal","literal":"subDomain"}},{"name":"parentDomain","type":{"kind":"name","group":"primitive","refName":"string"}}]}]},{"name":"JtLegacyFqdnSitePackConf","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtSitePackConfBase"},{"kind":"interface","properties":[{"name":"serveAs","type":{"kind":"literal","literal":"fqdn"},"docComment":"@deprecated Renamed to `serveOn`"}]}]},{"name":"JtLegacySubDomainSitePackConf","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtSitePackConfBase"},{"kind":"interface","properties":[{"name":"serveAs","type":{"kind":"literal","literal":"subDomain"},"docComment":"@deprecated Renamed to `serveOn`"},{"name":"parentDomain","type":{"kind":"name","group":"primitive","refName":"string"}}]}]},{"name":"JtGoogleAuthConf","exported":true,"kind":"interface","properties":[{"name":"disabled","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"fqdn","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"clientId","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"clientSecret","type":{"kind":"name","group":"primitive","refName":"string"}}]},{"name":"JtDeprecatedAwsSesMailConf","exported":true,"docComment":"@deprecated Use \"@paroicms/send-mail-aws-ses-plugin\" configuration instead","kind":"interface","properties":[{"name":"disabled","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"from","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"accessKeyId","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"secretAccessKey","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"region","type":{"kind":"name","group":"primitive","refName":"string"}}]},{"name":"JtDeprecatedGoogleRecaptchaConf","exported":true,"docComment":"@deprecated Use \"@paroicms/contact-form-plugin\" configuration instead","kind":"interface","properties":[{"name":"disabled","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"siteKey","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"secretKey","type":{"kind":"name","group":"primitive","refName":"string"}}]},{"name":"JtImageProcessorConf","exported":true,"kind":"interface","properties":[{"name":"cpuCoresPerFile","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true},{"name":"allowConcurrency","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true}]},{"name":"JtLegacyImageProcessorConf","exported":true,"kind":"interface","properties":[{"name":"cpuCoresPerFile","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true},{"name":"oneSharpAtATime","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true}]},{"name":"JtDevAccountConf","exported":true,"kind":"interface","properties":[{"name":"email","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"name","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"password","type":{"kind":"name","group":"primitive","refName":"string"}}]},{"name":"JtPlatformAdminAccountConf","exported":true,"kind":"interface","properties":[{"name":"email","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"name","type":{"kind":"name","group":"primitive","refName":"string"}}]},{"name":"JtPluginStaticConfiguration","exported":true,"kind":"interface","properties":[{"name":"name","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"disabled","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"platform","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"configuration","type":{"kind":"interface","indexSignature":{"keyName":"key","keyType":"string","type":{"kind":"name","group":"ts","refName":"unknown"}}},"optional":true}]},{"name":"JtDeprecatedPluginConfigurations","exported":true,"docComment":"@deprecated Use JtPluginConfiguration[] instead","kind":"interface","indexSignature":{"keyName":"pluginName","keyType":"string","type":{"kind":"interface","indexSignature":{"keyName":"key","keyType":"string","type":{"kind":"name","group":"ts","refName":"unknown"}}}}}]},"./site-schema-json-types":{"namedTypes":[{"name":"JtSiteSchema","exported":true,"docComment":"This properties are part of a site schema, and part of the internal library as well.","kind":"interface","properties":[{"name":"ParoiCMSSiteSchemaFormatVersion","type":{"kind":"literal","literal":"9"},"docComment":"This is the version of the schema engine."},{"name":"languages","type":{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"string"}},"docComment":"Specify the list of 2-letters language codes (ISO 639-1) of the website. Use 3-letters codes (ISO 639-3) for languages that doesn't have a 2-letters code (\"qya\", etc.). It's possible but not recommanded to use 5-letters codes with regions (IETF BCP 47, for example \"fr-FR\"). Every language is allowed. The first language is the primary language of the website.\n@example `[\"en\", \"fr\"]`"},{"name":"languageRoutingMode","type":{"kind":"composite","op":"union","types":[{"kind":"literal","literal":"prefixSecondary"},{"kind":"literal","literal":"prefixAll"},{"kind":"literal","literal":"auto"}]},"optional":true,"docComment":"Routing mode for multilingual sites. Default is \"auto\".\n- \"auto\": behaves like \"prefixSecondary\" for unilingual sites, \"prefixAll\" for multilingual sites\n- \"prefixAll\": all languages are prefixed in URLs\n- \"prefixSecondary\": all languages but the first are prefixed in URLs"},{"name":"plugins","type":{"kind":"array","itemType":{"kind":"composite","op":"union","types":[{"kind":"name","group":"primitive","refName":"string"},{"kind":"localRef","refName":"JtPluginRef"}]}},"optional":true,"docComment":"List of plugins that are used in the schema.\n@example [\"@paroicms/quill-editor-plugin\"]"},{"name":"configuration","type":{"kind":"localRef","refName":"JtSiteConfiguration"},"optional":true},{"name":"nodeTypes","type":{"kind":"array","itemType":{"kind":"localRef","refName":"JtNodeType"}},"optional":true,"docComment":"Types of documents, parts that will be handled on the site."},{"name":"fieldTypes","type":{"kind":"array","itemType":{"kind":"localRef","refName":"JtFieldType"}},"optional":true,"docComment":"A library of fields."},{"name":"mediaPolicies","type":{"kind":"array","itemType":{"kind":"localRef","refName":"JtMediaPolicy"}},"optional":true,"docComment":"Media policies"},{"name":"imageQualityPolicy","type":{"kind":"array","itemType":{"kind":"localRef","refName":"JtImageCompressionQualityPolicyStep"}},"optional":true,"docComment":"We can set the image compression quality here. The list must be ordered from the lowest area\nto the highest."}]},{"name":"JtPluginRef","exported":true,"kind":"interface","properties":[{"name":"name","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"disabled","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"configuration","type":{"kind":"localRef","refName":"JtPluginConfFromSchema"},"optional":true}]},{"name":"JtPluginConfFromSchema","exported":true,"kind":"interface","indexSignature":{"keyName":"key","keyType":"string","type":{"kind":"name","group":"ts","refName":"unknown"}}},{"name":"JtSiteConfiguration","exported":true,"kind":"interface","properties":[{"name":"adminUi","type":{"kind":"interface","properties":[{"name":"enableMetaKeywords","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true}]},"optional":true}]},{"name":"JtNodeType","exported":true,"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtSiteType"},{"kind":"localRef","refName":"JtDocumentType"},{"kind":"localRef","refName":"JtPartType"}]},{"name":"JtSiteType","exported":true,"kind":"interface","properties":[{"name":"typeName","type":{"kind":"literal","literal":"_site"},"optional":true,"docComment":"Can be omitted. Its default value is `\"_site\"`."},{"name":"kind","type":{"kind":"literal","literal":"site"}},{"name":"fields","type":{"kind":"array","itemType":{"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtFieldType"},{"kind":"name","group":"primitive","refName":"string"}]}},"optional":true,"docComment":"The site fields. They will be appended to the required fields: `[\"access\", \"title\", \"contactEmail\", \"favicon\", \"ogImage\"]`.\n\n@example `[\"logo\", \"slogan\", \"phone\"]`"}]},{"name":"JtDocumentType","exported":true,"docComment":"A document is another name for a web page, with a path in the URL.","kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtRoutingDocumentType"},{"kind":"localRef","refName":"JtRegularDocumentType"}]},{"name":"JtDocumentTypeBase","exported":true,"kind":"interface","properties":[{"name":"typeName","type":{"kind":"name","group":"primitive","refName":"string"},"docComment":"The type name is the identifier of the document type."},{"name":"kind","type":{"kind":"literal","literal":"document"}},{"name":"ogType","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true,"docComment":"@see [Open Graph Protocol](https://ogp.me/)\n@example `\"article\"`"},{"name":"withFeaturedImage","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true,"docComment":"If `true`, the document will have a featured image. Most of the time, documents like\nsearch-page, contact-page, the home page, don't need a featured image. But other documents\ndoes."},{"name":"fields","type":{"kind":"array","itemType":{"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtFieldType"},{"kind":"name","group":"primitive","refName":"string"}]}},"optional":true,"docComment":"The fields in the document. Items in this list can be either field types or predefined field\ntype names."},{"name":"mediaPolicy","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true,"docComment":"The name of the media policy."},{"name":"lists","type":{"kind":"array","itemType":{"kind":"localRef","refName":"JtListType"}},"optional":true,"docComment":"Lists of parts in the document."},{"name":"routingChildren","type":{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"string"}},"optional":true,"docComment":"Type names of child routing documents."},{"name":"regularChildren","type":{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"string"}},"optional":true,"docComment":"Type names of child regular documents."},{"name":"regularChildrenSorting","type":{"kind":"localRef","refName":"JtSorting"},"optional":true,"docComment":"The sorting order of regular children. It is required when `children` is defined.\nExamples: `\"title asc\"`, `\"publishDate desc\"`, `\"manual\"`."},{"name":"childLimit","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"The maximum number of children."},{"name":"hasFrontendApp","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true,"docComment":"If `true`, the document will serve a SPA. It means that all the child routes will be handled by\nthe document.\n\nThis property is not compatible with `routingChildren`, `regularChildren`,  `redirectTo`\nproperties. Also, if the document type is regular, then sibling regular document types must not\nhave routing or regular children."},{"name":"useUrlQuery","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true,"docComment":"If `true`, then the url query will be exposed to the liquid templates. By default it's better\nto not enable it, then the same content will be served from the cache for all the URL query\nvalues."},{"name":"cluster","type":{"kind":"localRef","refName":"JtClusterType"},"optional":true,"docComment":"Cluster configuration for this document type."},{"name":"adminUi","type":{"kind":"localRef","refName":"JtDocumentAdminUiSettings"},"optional":true}]},{"name":"JtClusterType","exported":true,"kind":"interface","properties":[{"name":"autoCreate","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true,"docComment":"Determine if the routing documents of the cluster should be automatically created when the root\ndocument is created."}]},{"name":"JtSorting","exported":true,"kind":"composite","op":"union","types":[{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"string"}},{"kind":"literal","literal":"manual"},{"kind":"name","group":"primitive","refName":"string"}]},{"name":"JtRoutingDocumentType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtDocumentTypeBase"},{"kind":"interface","properties":[{"name":"documentKind","type":{"kind":"literal","literal":"routing"}},{"name":"redirectTo","type":{"kind":"literal","literal":"parent"},"optional":true,"docComment":"Value `\"parent\"` means that the document is just a hierarchy parent for other documents. But it\nhas no content itself.\n\nThis value is ignored in the home page type."},{"name":"route","type":{"kind":"composite","op":"union","types":[{"kind":"name","group":"primitive","refName":"string"},{"kind":"localRef","refName":"JtTranslatedStrings"}]},"optional":true,"docComment":"The `route` of a routing document contains a kind of _directory name_ (one per language) that\nwill be the last part of the document URL path.\n\nThis value is ignored in the home page type."}]}]},{"name":"JtTranslatedStrings","exported":true,"kind":"interface","indexSignature":{"keyName":"language","keyType":"string","type":{"kind":"name","group":"primitive","refName":"string"}}},{"name":"JtDocumentAdminUiSettings","exported":true,"kind":"interface","properties":[{"name":"defaultTab","type":{"kind":"localRef","refName":"JtDocumentTabName"},"optional":true,"docComment":"Default value is `\"auto\"`."},{"name":"menuPlacement","type":{"kind":"composite","op":"union","types":[{"kind":"literal","literal":"default"},{"kind":"literal","literal":"popup"}]},"optional":true,"docComment":"Used by routing documents only. Default value is `\"default\"`."}]},{"name":"JtDocumentTabName","exported":true,"kind":"composite","op":"union","types":[{"kind":"literal","literal":"auto"},{"kind":"literal","literal":"edit"},{"kind":"literal","literal":"childDocuments"},{"kind":"literal","literal":"parts"}]},{"name":"JtRegularDocumentType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtDocumentTypeBase"},{"kind":"interface","properties":[{"name":"documentKind","type":{"kind":"literal","literal":"regular"}},{"name":"route","type":{"kind":"name","group":"primitive","refName":"string"},"docComment":"Available values are: `\":relativeId-:slug\"` and `\":yyyy/:mm/:dd/:relativeId-:slug\"`."},{"name":"relativeIdGenerator","type":{"kind":"localRef","refName":"JtRelativeIdGeneratorType"},"optional":true},{"name":"autoPublish","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true,"docComment":"Value `true` means that the document will be automatically published without being a\ndraft before. Useful for taxonomy terms, like tags or categories."}]}]},{"name":"JtRelativeIdGeneratorType","exported":true,"kind":"array","itemType":{"kind":"name","group":"ts","refName":"any"}},{"name":"JtSubListType","exported":true,"kind":"interface","properties":[{"name":"parts","type":{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"string"}},"docComment":"Type names of the parts in the list."},{"name":"sorting","type":{"kind":"localRef","refName":"JtSorting"},"docComment":"How to sort the list. Example: `\"manual\"`."},{"name":"limit","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"The maximum number of parts in the list."}]},{"name":"JtListType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtSubListType"},{"kind":"interface","properties":[{"name":"listName","type":{"kind":"name","group":"primitive","refName":"string"}}]}]},{"name":"JtPartType","exported":true,"kind":"interface","properties":[{"name":"typeName","type":{"kind":"name","group":"primitive","refName":"string"},"docComment":"The type name is the identifier of the part type."},{"name":"kind","type":{"kind":"literal","literal":"part"}},{"name":"fields","type":{"kind":"array","itemType":{"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtFieldType"},{"kind":"name","group":"primitive","refName":"string"}]}},"optional":true},{"name":"list","type":{"kind":"localRef","refName":"JtSubListType"},"optional":true,"docComment":"If the part type can have children parts, then it's a sub-list."},{"name":"mediaPolicy","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true}]},{"name":"JtFieldType","exported":true,"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtMainDbFieldType"},{"kind":"localRef","refName":"JtMediaDbFieldType"},{"kind":"localRef","refName":"JtLabelingFieldType"}]},{"name":"JtFieldTypeBase","exported":true,"kind":"interface","properties":[{"name":"name","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"withGallery","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"useAsDefaultImage","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true},{"name":"renderAs","type":{"kind":"literal","literal":"html"},"optional":true},{"name":"useAsExcerpt","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true},{"name":"plugin","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true,"docComment":"A plugin name. For example: `@paroicms/quill-editor-plugin`."},{"name":"adminUi","type":{"kind":"localRef","refName":"JtFieldAdminUiSettings"},"optional":true,"docComment":"UI settings in the admin-ui."}]},{"name":"JtFieldAdminUiSettings","exported":true,"kind":"interface","properties":[{"name":"showInCard","type":{"kind":"composite","op":"union","types":[{"kind":"name","group":"primitive","refName":"boolean"},{"kind":"literal","literal":"auto"}]},"optional":true,"docComment":"Default is `\"auto\"`."}],"indexSignature":{"keyName":"key","keyType":"string","type":{"kind":"name","group":"ts","refName":"any"}}},{"name":"JtLocalizableFieldTypeBase","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtFieldTypeBase"},{"kind":"interface","properties":[{"name":"localized","type":{"kind":"name","group":"primitive","refName":"boolean"},"docComment":"If `true`, then each translation will have its own value. Otherwise, the value is shared\nbetween all translations."},{"name":"normalizeTypography","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true,"docComment":"This property should be set to `true` for real textual field types, like an html body or a\nlabel.\n\nNote: Its value has no effect when `localized` is `false`."}]}]},{"name":"JtLabelingFieldType","exported":true,"docComment":"The field type represents a labeling link between the current node, and a term from a taxonomy.","kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtFieldTypeBase"},{"kind":"interface","properties":[{"name":"localized","type":{"kind":"literal","literal":false}},{"name":"storedAs","type":{"kind":"literal","literal":"labeling"}},{"name":"taxonomy","type":{"kind":"name","group":"primitive","refName":"string"},"docComment":"It's the type name of a routing document. Regular documents that are child of this routing\ndocument will be the terms of the taxonomy.\n\nNotice: Any routing point can be used as a taxonomy. Terms are always regular documents."},{"name":"multiple","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true,"docComment":"If `true`, multiple terms can be selected. Otherwise, only one term can be selected."}]}]},{"name":"JtMainDbFieldType","exported":true,"kind":"composite","op":"union","types":[{"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtNumberFieldType"},{"kind":"localRef","refName":"JtBooleanFieldType"},{"kind":"localRef","refName":"JtDateFieldType"},{"kind":"localRef","refName":"JtDateTimeFieldType"},{"kind":"localRef","refName":"JtTimeFieldType"},{"kind":"localRef","refName":"JtStringFieldType"},{"kind":"localRef","refName":"JtJsonFieldType"}]}]},{"name":"JtNumberFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"literal","literal":"varchar"}},{"name":"dataType","type":{"kind":"literal","literal":"number"}},{"name":"currency","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true},{"name":"enum","type":{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"number"}},"optional":true}]}]},{"name":"JtBooleanFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"literal","literal":"varchar"}},{"name":"dataType","type":{"kind":"literal","literal":"boolean"}}]}]},{"name":"JtDateFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"literal","literal":"varchar"}},{"name":"dataType","type":{"kind":"literal","literal":"date"}}]}]},{"name":"JtDateTimeFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"literal","literal":"varchar"}},{"name":"dataType","type":{"kind":"literal","literal":"dateTime"}}]}]},{"name":"JtTimeFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"literal","literal":"varchar"}},{"name":"dataType","type":{"kind":"literal","literal":"time"}}]}]},{"name":"JtStringFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"composite","op":"union","types":[{"kind":"literal","literal":"text"},{"kind":"literal","literal":"varchar"}]}},{"name":"dataType","type":{"kind":"literal","literal":"string"}},{"name":"multiline","type":{"kind":"name","group":"primitive","refName":"boolean"},"optional":true},{"name":"enum","type":{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"string"}},"optional":true}]}]},{"name":"JtJsonFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"composite","op":"union","types":[{"kind":"literal","literal":"text"},{"kind":"literal","literal":"varchar"}]}},{"name":"dataType","type":{"kind":"literal","literal":"json"}}]}]},{"name":"JtMediaDbFieldType","exported":true,"kind":"composite","op":"union","types":[{"kind":"localRef","refName":"JtGalleryFieldType"},{"kind":"localRef","refName":"JtMediaFieldType"}]},{"name":"JtGalleryFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"literal","literal":"mediaHandle"}},{"name":"dataType","type":{"kind":"literal","literal":"gallery"}},{"name":"accept","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"refuse","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true}]}]},{"name":"JtMediaFieldType","exported":true,"kind":"composite","op":"intersection","types":[{"kind":"localRef","refName":"JtLocalizableFieldTypeBase"},{"kind":"interface","properties":[{"name":"storedAs","type":{"kind":"literal","literal":"mediaHandle"}},{"name":"dataType","type":{"kind":"literal","literal":"media"}},{"name":"accept","type":{"kind":"name","group":"primitive","refName":"string"}},{"name":"refuse","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true}]}]},{"name":"JtMediaPolicy","exported":true,"docComment":"These properties define the rules that are applied to medias.","kind":"interface","properties":[{"name":"policyName","type":{"kind":"name","group":"primitive","refName":"string"},"docComment":"The internal name of the policy.\n@example `\"myPolicyName\"`"},{"name":"mediaLimitPerDocument","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"Max media limit uploaded in a document.\n@example `10`"},{"name":"mediaLimitPerPart","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"Max media limit uploaded in a part.\n@example `10`"},{"name":"attachedDocument","type":{"kind":"localRef","refName":"JtAttachedDocumentPolicy"},"optional":true,"docComment":"Rules about non-image medias (like PDF files)."},{"name":"image","type":{"kind":"localRef","refName":"JtImagePolicy"},"optional":true,"docComment":"Rules about images."}]},{"name":"JtAttachedDocumentPolicy","exported":true,"docComment":"These properties define the rules that are applied to\ndocument uploaded in document and document part","kind":"interface","properties":[{"name":"siteWeightLimitB","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"Size limit in bytes.\n@example `2000000`"}]},{"name":"JtImagePolicy","exported":true,"docComment":"These properties define the rules that are applied to\nimages contained in document and document part","kind":"interface","properties":[{"name":"weightLimitB","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"Size limit in bytes.\n@example `2000000`"},{"name":"areaLimitPx","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"Maximum area (width × height, in pixels) of an image.\n@example `2000000`"}]},{"name":"JtImageCompressionQualityPolicyStep","exported":true,"docComment":"These properties define the rules applied to image\ncompression across all sites","kind":"interface","properties":[{"name":"areaLimitPx","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"The quality will apply for image with area smaller than this value.\n@example `600000`"},{"name":"quality","type":{"kind":"name","group":"primitive","refName":"number"},"docComment":"Webp quality loss, in percents.\n@example `80`"}]},{"name":"JtSiteSchemaTranslations","exported":true,"kind":"interface","properties":[{"name":"siteTheme","type":{"kind":"name","group":"primitive","refName":"string"},"optional":true},{"name":"nodeTypes","type":{"kind":"interface","indexSignature":{"keyName":"typeName","keyType":"string","type":{"kind":"localRef","refName":"JtLabelLocales"}}},"optional":true},{"name":"fieldTypes","type":{"kind":"interface","indexSignature":{"keyName":"fieldName","keyType":"string","type":{"kind":"localRef","refName":"JtLabelLocales"}}},"optional":true}]},{"name":"JtLabelLocales","exported":true,"kind":"interface","indexSignature":{"keyName":"key","keyType":"string","type":{"kind":"composite","op":"union","types":[{"kind":"name","group":"primitive","refName":"string"},{"kind":"localRef","refName":"JtLabelLocales"}]}}}]},"./theme-json-types":{"namedTypes":[{"name":"JtThemeConf","exported":true,"kind":"interface","properties":[{"name":"pixelRatio","type":{"kind":"name","group":"primitive","refName":"number"},"optional":true,"docComment":"Default value is `1`."},{"name":"fTextImages","type":{"kind":"array","itemType":{"kind":"name","group":"primitive","refName":"string"}}}]}]}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paroicms/public-server-lib",
-  "version": "0.43.0",
+  "version": "0.45.0",
   "description": "Common utilitaries for paroicms plugins (backend side).",
   "author": "Paroi Team",
   "repository": {
@@ -13,25 +13,31 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc",
+    "build": "npm run typeonly && npm run tsc",
+    "tsc": "tsc",
+    "typeonly": "typeonly --bundle dist/types.to.json -s ./typeonly",
     "test:watch": "vitest",
     "test": "vitest run",
     "clear": "rimraf dist/*",
     "dev": "tsc --watch --preserveWatchOutput"
   },
   "dependencies": {
-    "@paroicms/internal-anywhere-lib": "1.33.0",
-    "@paroicms/public-anywhere-lib": "0.34.0",
+    "@paroicms/internal-anywhere-lib": "1.34.0",
+    "@paroicms/public-anywhere-lib": "0.35.0",
+    "@paroicms/script-lib": "0.2.1",
+    "@typeonly/validator": "~1.1.2",
     "arktype": "~2.1.20"
   },
   "devDependencies": {
     "@types/node": "~24.0.1",
     "rimraf": "~6.0.1",
+    "typeonly": "~1.1.3",
     "typescript": "~5.8.3",
     "vitest": "~3.2.3"
   },
   "files": [
     "dist",
-    "types"
+    "types",
+    "typeonly"
   ]
 }

package/typeonly/common-schema-json-types.d.ts

@@ -0,0 +1,26 @@
+import type { JtFieldType, JtLabelLocales } from "./site-schema-json-types.d.ts";
+
+/**
+ * The common schema is currently an internal file. Here is its typing.
+ */
+export interface JtInternalCommonSchema {
+  /**
+   * This is the version of the schema engine.
+   */
+  ParoiCMSSiteSchemaFormatVersion: string;
+  /**
+   * Specify the list of 2-letters language codes that can be used in the websites.
+   *
+   * @example ["en", "fr"]`
+   */
+  languages: string[];
+  /**
+   * The common fields of any websites. They are currently: `["title", "contactEmail", "favicon", "ogImage"]`.
+   */
+  siteFields: JtFieldType[];
+}
+
+export interface JtInternalCommonSchemaTranslations {
+  languageLabel: string;
+  siteFields?: { [fieldName: string]: JtLabelLocales };
+}

package/typeonly/configuration-types.d.ts

@@ -0,0 +1,199 @@
+export type JtConfiguration = JtSingleSiteConfiguration | JtMultisiteConfiguration;
+
+export interface JtConfigurationBase {
+  /**
+   * @deprecated Move the sub-properties in the parent.
+   */
+  thisServer?: JtDeprecatedThisServerConf;
+  /**
+   * It is required except if the legacy `thisServer` is still used.
+   */
+  port?: number;
+  hostname?: string;
+  /**
+   * Default is `"http"`.
+   */
+  publicProtocol?: "http" | "https";
+  publicPort?: number;
+  /**
+   * @deprecated Use adminUiPort instead.
+   */
+  boPort?: number;
+  adminUiPort?: number;
+
+  allowRobots: boolean;
+  enableCache?: boolean;
+  immutableAssets?: boolean;
+  /**
+   * For example: `"14d"`.
+   */
+  cacheTimeToIdle?: string | "disabled" | "infinite";
+  clearCacheAfterStart?: boolean;
+  clearImageCacheAfterStart?: boolean;
+  /**
+   * @deprecated Replace `log.level` by `logLevel`, and `log.file` by `logFile`.
+   */
+  log?: JtLogConf;
+  logLevel?: "silent" | "error" | "warn" | "info" | "stats" | "debug" | "trace";
+  /**
+   * Omit for stdout.
+   */
+  logFile?: string;
+  graphqlDevTools?: boolean;
+  generateMissingDatabases?: boolean;
+  googleAuth?: JtGoogleAuthConf;
+  /** @deprecated Use "@paroicms/send-mail-aws-ses-plugin" configuration instead */
+  awsSesMail?: JtDeprecatedAwsSesMailConf;
+  /** @deprecated Use "@paroicms/contact-form-plugin" configuration instead */
+  googleRecaptcha?: JtDeprecatedGoogleRecaptchaConf;
+  imageProcessor?: JtImageProcessorConf | JtLegacyImageProcessorConf;
+  devAccount?: JtDevAccountConf;
+  platformAdminAccounts?: JtPlatformAdminAccountConf[];
+  plugins?: JtPluginStaticConfiguration[] | JtDeprecatedPluginConfigurations;
+  httpRedirections?: JtHttpRedirection[];
+}
+
+export interface JtHttpRedirection {
+  fromFqdn: string;
+  to: string;
+  mapPaths?: {
+    [fromRegex: string]: string;
+  };
+  preservePath?: boolean;
+}
+
+export interface JtSingleSiteConfiguration extends JtConfigurationBase {
+  singleSite: JtSingleSiteConf;
+}
+
+export interface JtMultisiteConfiguration extends JtConfigurationBase {
+  platform: {
+    dataDir: string;
+  };
+  sitePacks: JtSitePackOrLegacyConf[];
+}
+
+export interface JtDeprecatedThisServerConf {
+  port: number;
+  publicPort?: number;
+  boPublicPort?: number;
+  hostName?: string | null;
+  https: boolean;
+}
+
+export interface JtLogConf {
+  level: "silent" | "error" | "warn" | "info" | "stats" | "debug" | "trace";
+  /**
+   * Omit for stdout.
+   */
+  file?: string;
+}
+
+export interface JtSingleSiteConf {
+  siteDir: string;
+  dataDir: string;
+  cacheDir: string;
+  backupDir: string;
+  fqdn: string;
+  redirectWww?: boolean;
+  /* Default value is `true`. */
+  trusted?: boolean;
+}
+
+export type JtSitePackOrLegacyConf =
+  | JtSitePackConf
+  | JtLegacyFqdnSitePackConf
+  | JtLegacySubDomainSitePackConf;
+
+export type JtSitePackConf = JtFqdnSitePackConf | JtSubDomainSitePackConf;
+
+export interface JtSitePackConfBase {
+  packName: string;
+  sitesDir?: string;
+  dataDir: string;
+  cacheDir: string;
+  backupDir: string;
+  redirectWww?: boolean;
+  /* Default value is `true`. */
+  trusted?: boolean;
+}
+
+export interface JtFqdnSitePackConf extends JtSitePackConfBase {
+  serveOn: "fqdn";
+}
+
+export interface JtSubDomainSitePackConf extends JtSitePackConfBase {
+  serveOn: "subDomain";
+  parentDomain: string;
+}
+
+export interface JtLegacyFqdnSitePackConf extends JtSitePackConfBase {
+  /** @deprecated Renamed to `serveOn` */
+  serveAs: "fqdn";
+}
+
+export interface JtLegacySubDomainSitePackConf extends JtSitePackConfBase {
+  /** @deprecated Renamed to `serveOn` */
+  serveAs: "subDomain";
+  parentDomain: string;
+}
+
+export interface JtGoogleAuthConf {
+  disabled?: boolean;
+  fqdn: string;
+  clientId: string;
+  clientSecret: string;
+}
+
+/** @deprecated Use "@paroicms/send-mail-aws-ses-plugin" configuration instead */
+export interface JtDeprecatedAwsSesMailConf {
+  disabled?: boolean;
+  from: string;
+  accessKeyId: string;
+  secretAccessKey: string;
+  region: string;
+}
+
+/** @deprecated Use "@paroicms/contact-form-plugin" configuration instead */
+export interface JtDeprecatedGoogleRecaptchaConf {
+  disabled?: boolean;
+  siteKey: string;
+  secretKey: string;
+}
+
+export interface JtImageProcessorConf {
+  cpuCoresPerFile?: number;
+  allowConcurrency?: boolean;
+}
+
+export interface JtLegacyImageProcessorConf {
+  cpuCoresPerFile?: number;
+  oneSharpAtATime?: boolean;
+}
+
+export interface JtDevAccountConf {
+  email: string;
+  name: string;
+  password: string;
+}
+
+export interface JtPlatformAdminAccountConf {
+  email: string;
+  name: string;
+}
+
+export interface JtPluginStaticConfiguration {
+  name: string;
+  disabled?: boolean;
+  platform?: boolean;
+  configuration?: {
+    [key: string]: unknown;
+  };
+}
+
+/** @deprecated Use JtPluginConfiguration[] instead */
+export interface JtDeprecatedPluginConfigurations {
+  [pluginName: string]: {
+    [key: string]: unknown;
+  };
+}

package/typeonly/site-schema-json-types.d.ts

@@ -0,0 +1,449 @@
+// ----- SITE SCHEMA -----
+
+/**
+ * This properties are part of a site schema, and part of the internal library as well.
+ */
+export interface JtSiteSchema {
+  /**
+   * This is the version of the schema engine.
+   */
+  ParoiCMSSiteSchemaFormatVersion: "9";
+  /**
+   * Specify the list of 2-letters language codes (ISO 639-1) of the website. Use 3-letters codes (ISO 639-3) for languages that doesn't have a 2-letters code ("qya", etc.). It's possible but not recommanded to use 5-letters codes with regions (IETF BCP 47, for example "fr-FR"). Every language is allowed. The first language is the primary language of the website.
+   * @example `["en", "fr"]`
+   */
+  languages: string[];
+  /**
+   * Routing mode for multilingual sites. Default is "auto".
+   * - "auto": behaves like "prefixSecondary" for unilingual sites, "prefixAll" for multilingual sites
+   * - "prefixAll": all languages are prefixed in URLs
+   * - "prefixSecondary": all languages but the first are prefixed in URLs
+   */
+  languageRoutingMode?: "prefixSecondary" | "prefixAll" | "auto";
+  /**
+   * List of plugins that are used in the schema.
+   * @example ["@paroicms/quill-editor-plugin"]
+   */
+  plugins?: (string | JtPluginRef)[];
+  configuration?: JtSiteConfiguration;
+  /**
+   * Types of documents, parts that will be handled on the site.
+   */
+  nodeTypes?: JtNodeType[];
+  /**
+   * A library of fields.
+   */
+  fieldTypes?: JtFieldType[];
+  /**
+   * Media policies
+   */
+  mediaPolicies?: JtMediaPolicy[];
+  /**
+   * We can set the image compression quality here. The list must be ordered from the lowest area
+   * to the highest.
+   */
+  imageQualityPolicy?: JtImageCompressionQualityPolicyStep[];
+}
+
+export interface JtPluginRef {
+  name: string;
+  disabled?: boolean;
+  configuration?: JtPluginConfFromSchema;
+}
+
+export interface JtPluginConfFromSchema {
+  [key: string]: unknown;
+}
+
+export interface JtSiteConfiguration {
+  adminUi?: {
+    enableMetaKeywords?: boolean;
+  };
+}
+
+// ----- NODE TYPES -----
+
+export type JtNodeType = JtSiteType | JtDocumentType | JtPartType;
+
+export interface JtSiteType {
+  /**
+   * Can be omitted. Its default value is `"_site"`.
+   */
+  typeName?: "_site";
+  kind: "site";
+  /**
+   * The site fields. They will be appended to the required fields: `["access", "title", "contactEmail", "favicon", "ogImage"]`.
+   *
+   * @example `["logo", "slogan", "phone"]`
+   */
+  fields?: (JtFieldType | string)[];
+}
+
+/**
+ * A document is another name for a web page, with a path in the URL.
+ */
+export type JtDocumentType = JtRoutingDocumentType | JtRegularDocumentType;
+
+export interface JtDocumentTypeBase {
+  /**
+   * The type name is the identifier of the document type.
+   */
+  typeName: string;
+  kind: "document";
+  /**
+   * @see [Open Graph Protocol](https://ogp.me/)
+   * @example `"article"`
+   */
+  ogType?: string;
+  /**
+   * If `true`, the document will have a featured image. Most of the time, documents like
+   * search-page, contact-page, the home page, don't need a featured image. But other documents
+   * does.
+   */
+  withFeaturedImage?: boolean;
+  /**
+   * The fields in the document. Items in this list can be either field types or predefined field
+   * type names.
+   */
+  fields?: (JtFieldType | string)[];
+  /**
+   * The name of the media policy.
+   */
+  mediaPolicy?: string;
+  /**
+   * Lists of parts in the document.
+   */
+  lists?: JtListType[];
+  /**
+   * Type names of child routing documents.
+   */
+  routingChildren?: string[];
+  /**
+   * Type names of child regular documents.
+   */
+  regularChildren?: string[];
+  /**
+   * The sorting order of regular children. It is required when `children` is defined.
+   * Examples: `"title asc"`, `"publishDate desc"`, `"manual"`.
+   */
+  regularChildrenSorting?: JtSorting;
+  /**
+   * The maximum number of children.
+   */
+  childLimit?: number;
+  /**
+   * If `true`, the document will serve a SPA. It means that all the child routes will be handled by
+   * the document.
+   *
+   * This property is not compatible with `routingChildren`, `regularChildren`,  `redirectTo`
+   * properties. Also, if the document type is regular, then sibling regular document types must not
+   * have routing or regular children.
+   */
+  hasFrontendApp?: boolean;
+  /**
+   * If `true`, then the url query will be exposed to the liquid templates. By default it's better
+   * to not enable it, then the same content will be served from the cache for all the URL query
+   * values.
+   */
+  useUrlQuery?: boolean;
+  /**
+   * Cluster configuration for this document type.
+   */
+  cluster?: JtClusterType;
+  adminUi?: JtDocumentAdminUiSettings;
+}
+
+export interface JtClusterType {
+  /**
+   * Determine if the routing documents of the cluster should be automatically created when the root
+   * document is created.
+   */
+  autoCreate?: boolean;
+}
+
+export type JtSorting = string[] | "manual" | string;
+
+export interface JtRoutingDocumentType extends JtDocumentTypeBase {
+  documentKind: "routing";
+  /**
+   * Value `"parent"` means that the document is just a hierarchy parent for other documents. But it
+   * has no content itself.
+   *
+   * This value is ignored in the home page type.
+   */
+  redirectTo?: "parent";
+  /**
+   * The `route` of a routing document contains a kind of _directory name_ (one per language) that
+   * will be the last part of the document URL path.
+   *
+   * This value is ignored in the home page type.
+   */
+  route?: string | JtTranslatedStrings;
+}
+
+export interface JtTranslatedStrings {
+  [language: string]: string;
+}
+
+export interface JtDocumentAdminUiSettings {
+  /** Default value is `"auto"`. */
+  defaultTab?: JtDocumentTabName;
+  /** Used by routing documents only. Default value is `"default"`. */
+  menuPlacement?: "default" | "popup";
+}
+
+export type JtDocumentTabName = "auto" | "edit" | "childDocuments" | "parts";
+
+export interface JtRegularDocumentType extends JtDocumentTypeBase {
+  documentKind: "regular";
+  /**
+   * Available values are: `":relativeId-:slug"` and `":yyyy/:mm/:dd/:relativeId-:slug"`.
+   */
+  route: string;
+  relativeIdGenerator?: JtRelativeIdGeneratorType;
+  /**
+   * Value `true` means that the document will be automatically published without being a
+   * draft before. Useful for taxonomy terms, like tags or categories.
+   */
+  autoPublish?: boolean;
+}
+
+export type JtRelativeIdGeneratorType = any[]; // [makerName: string, ...args: any[]]
+
+// ----- PART TYPES -----
+
+export interface JtSubListType {
+  /** Type names of the parts in the list. */
+  parts: string[];
+  /** How to sort the list. Example: `"manual"`. */
+  sorting: JtSorting;
+  /**
+   * The maximum number of parts in the list.
+   */
+  limit?: number;
+}
+
+export interface JtListType extends JtSubListType {
+  listName: string;
+}
+
+export interface JtPartType {
+  /** The type name is the identifier of the part type. */
+  typeName: string;
+  kind: "part";
+  fields?: (JtFieldType | string)[];
+  /** If the part type can have children parts, then it's a sub-list. */
+  list?: JtSubListType;
+  mediaPolicy?: string;
+}
+
+// ----- FIELD TYPES -----
+
+export type JtFieldType = JtMainDbFieldType | JtMediaDbFieldType | JtLabelingFieldType;
+
+export interface JtFieldTypeBase {
+  name: string;
+  withGallery?: boolean;
+  useAsDefaultImage?: number;
+  renderAs?: "html";
+  useAsExcerpt?: number;
+  /** A plugin name. For example: `@paroicms/quill-editor-plugin`. */
+  plugin?: string;
+  /**
+   * UI settings in the admin-ui.
+   */
+  adminUi?: JtFieldAdminUiSettings;
+}
+
+export interface JtFieldAdminUiSettings {
+  /** Default is `"auto"`. */
+  showInCard?: boolean | "auto";
+  [key: string]: any;
+}
+
+export interface JtLocalizableFieldTypeBase extends JtFieldTypeBase {
+  /**
+   * If `true`, then each translation will have its own value. Otherwise, the value is shared
+   * between all translations.
+   */
+  localized: boolean;
+  /**
+   * This property should be set to `true` for real textual field types, like an html body or a
+   * label.
+   *
+   * Note: Its value has no effect when `localized` is `false`.
+   */
+  normalizeTypography?: boolean;
+}
+
+/**
+ * The field type represents a labeling link between the current node, and a term from a taxonomy.
+ */
+export interface JtLabelingFieldType extends JtFieldTypeBase {
+  localized: false;
+  storedAs: "labeling";
+  /**
+   * It's the type name of a routing document. Regular documents that are child of this routing
+   * document will be the terms of the taxonomy.
+   *
+   * Notice: Any routing point can be used as a taxonomy. Terms are always regular documents.
+   */
+  taxonomy: string;
+  /**
+   * If `true`, multiple terms can be selected. Otherwise, only one term can be selected.
+   */
+  multiple?: boolean;
+}
+
+export type JtMainDbFieldType =
+  | JtNumberFieldType
+  | JtBooleanFieldType
+  | JtDateFieldType
+  | JtDateTimeFieldType
+  | JtTimeFieldType
+  | JtStringFieldType
+  | JtJsonFieldType;
+
+export interface JtNumberFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "varchar";
+  dataType: "number";
+  currency?: string;
+  enum?: number[];
+}
+
+export interface JtBooleanFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "varchar";
+  dataType: "boolean";
+}
+
+export interface JtDateFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "varchar";
+  dataType: "date";
+}
+
+export interface JtDateTimeFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "varchar";
+  dataType: "dateTime";
+}
+
+export interface JtTimeFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "varchar";
+  dataType: "time";
+}
+
+export interface JtStringFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "text" | "varchar";
+  dataType: "string";
+  multiline?: boolean;
+  enum?: string[];
+}
+
+export interface JtJsonFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "text" | "varchar";
+  dataType: "json";
+}
+
+export type JtMediaDbFieldType = JtGalleryFieldType | JtMediaFieldType;
+
+export interface JtGalleryFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "mediaHandle";
+  dataType: "gallery";
+  accept: string;
+  refuse?: string;
+}
+
+export interface JtMediaFieldType extends JtLocalizableFieldTypeBase {
+  storedAs: "mediaHandle";
+  dataType: "media";
+  accept: string;
+  refuse?: string;
+}
+
+// ----- MEDIA POLICIES -----
+
+/**
+ * These properties define the rules that are applied to medias.
+ */
+export interface JtMediaPolicy {
+  /**
+   * The internal name of the policy.
+   * @example `"myPolicyName"`
+   */
+  policyName: string;
+  /**
+   * Max media limit uploaded in a document.
+   * @example `10`
+   */
+  mediaLimitPerDocument?: number;
+  /**
+   * Max media limit uploaded in a part.
+   * @example `10`
+   */
+  mediaLimitPerPart?: number;
+  /**
+   * Rules about non-image medias (like PDF files).
+   */
+  attachedDocument?: JtAttachedDocumentPolicy;
+  /**
+   * Rules about images.
+   */
+  image?: JtImagePolicy;
+}
+
+/**
+ * These properties define the rules that are applied to
+ * document uploaded in document and document part
+ */
+export interface JtAttachedDocumentPolicy {
+  /**
+   * Size limit in bytes.
+   * @example `2000000`
+   */
+  siteWeightLimitB?: number;
+}
+
+/**
+ * These properties define the rules that are applied to
+ * images contained in document and document part
+ */
+export interface JtImagePolicy {
+  /**
+   * Size limit in bytes.
+   * @example `2000000`
+   */
+  weightLimitB?: number;
+  /**
+   * Maximum area (width × height, in pixels) of an image.
+   * @example `2000000`
+   */
+  areaLimitPx?: number;
+}
+
+/**
+ * These properties define the rules applied to image
+ * compression across all sites
+ */
+export interface JtImageCompressionQualityPolicyStep {
+  /**
+   * The quality will apply for image with area smaller than this value.
+   * @example `600000`
+   */
+  areaLimitPx?: number;
+  /**
+   * Webp quality loss, in percents.
+   * @example `80`
+   */
+  quality: number;
+}
+
+// ----- LOCALIZATION -----
+
+export interface JtSiteSchemaTranslations {
+  siteTheme?: string;
+  nodeTypes?: { [typeName: string]: JtLabelLocales };
+  fieldTypes?: { [fieldName: string]: JtLabelLocales };
+}
+
+export interface JtLabelLocales {
+  [key: string]: string | JtLabelLocales;
+}

package/typeonly/theme-json-types.d.ts

@@ -0,0 +1,7 @@
+export interface JtThemeConf {
+  /**
+   * Default value is `1`.
+   */
+  pixelRatio?: number;
+  fTextImages: string[];
+}

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

@@ -1,4 +1,5 @@
 import type {
+  HomeRoutingCluster,
   JsonFieldValue,
   MImageVariant,
   MSourceImage,
@@ -10,7 +11,6 @@ import type {
   ScFieldDataType,
   ScFieldType,
   ScSiteSchema,
-  SiteIds,
   ThemeConf,
   UpdateFieldValue,
   UpdateLabelingFieldValue,
@@ -194,7 +194,7 @@ export interface BackendPluginService extends PluginStaticConfiguration {
   registeredSite: RegisteredSite;
   pluginAssetsUrl: string;
   /** This is the connector of the running instance of ParoiCMS. */
-  connector: RunningInstanceConnector;
+  connector: RunningServerConnector;
   getSiteFieldValue: (options: {
     fieldName: string;
     language?: string;
@@ -363,7 +363,7 @@ export interface SubDomainSitePackConfiguration extends SitePackConfigurationBas
 
 /* Running instance types */
 
-export interface RunningInstanceConnector {
+export interface RunningServerConnector {
   getSitePackConf(packName: string): SitePackConfiguration;
   loadSiteSchemaAndIds(fqdn: string): Promise<RiSiteSchemaAndIds>;
   createAccount(
@@ -395,11 +395,18 @@ export interface RunningInstanceConnector {
   ): Promise<ParsedLNodeId[]>;
   registerNewSite: (options: NewSiteOptions) => Promise<RegisteredSite>;
   removeSite: (fqdn: string) => Promise<void>;
+  migrateSiteSchemas(): Promise<void>;
+  createBlankSiteFromExisting(options: CreateBlankSiteOptions): Promise<void>;
+}
+
+export interface CreateBlankSiteOptions {
+  siteDir: string;
+  languages: string[];
 }
 
 export interface RiSiteSchemaAndIds {
   siteSchema: ScSiteSchema;
-  siteIds: SiteIds;
+  homeRoutingCluster: HomeRoutingCluster;
 }
 
 export type RiNewAccount = RiLocalNewAccount | RiExternalNewAccount;