tsondb 0.3.0 → 0.4.0

package/lib/{server → node/server}/api/declarations.js

@@ -1,10 +1,10 @@
 import Debug from "debug";
 import express from "express";
+import { isOk } from "../../../shared/utils/result.js";
 import { serializeDecl } from "../../schema/declarations/Declaration.js";
 import { isEntityDecl } from "../../schema/declarations/EntityDecl.js";
 import { isEnumDecl } from "../../schema/declarations/EnumDecl.js";
 import { isTypeAliasDecl } from "../../schema/declarations/TypeAliasDecl.js";
-import { isOk } from "../../utils/result.js";
 import { createInstance, deleteInstance, updateInstance } from "./instanceOperations.js";
 const debug = Debug("tsondb:server:api:declarations");
 export const declarationsApi = express.Router();

package/lib/{server → node/server}/api/git.js

@@ -1,9 +1,9 @@
 import Debug from "debug";
-import express from "express";
+import express, {} from "express";
 import { join } from "node:path";
+import { hasFileChanges } from "../../../shared/utils/git.js";
+import { getInstanceContainerOverview } from "../../../shared/utils/instances.js";
 import { serializeEntityDecl } from "../../schema/index.js";
-import { hasFileChanges } from "../../shared/utils/git.js";
-import { getInstanceContainerOverview } from "../../shared/utils/instances.js";
 import { attachGitStatusToInstancesByEntityName } from "../../utils/instances.js";
 import { reinit } from "../init.js";
 const debug = Debug("tsondb:server:api:git");
@@ -19,7 +19,9 @@ gitApi.use((req, res, next) => {
 gitApi.get("/status", async (req, res) => {
     const locales = (Array.isArray(req.query["locales"]) ? req.query["locales"] : [req.query["locales"]]).filter(locale => typeof locale === "string");
     const status = await req.git.status();
-    attachGitStatusToInstancesByEntityName(req.instancesByEntityName, req.dataRoot, req.gitRoot, status);
+    attachGitStatusToInstancesByEntityName(req.instancesByEntityName, req.dataRoot, 
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    req.gitRoot, status);
     const body = {
         commitsAhead: status.ahead,
         commitsBehind: status.behind,
@@ -27,7 +29,9 @@ gitApi.get("/status", async (req, res) => {
             entityName,
             instances
                 .filter(instance => hasFileChanges(instance.gitStatus))
-                .map(instance => getInstanceContainerOverview(serializeEntityDecl(req.entitiesByName[entityName]), instance, locales)),
+                .map(instance => getInstanceContainerOverview(
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            serializeEntityDecl(req.entitiesByName[entityName]), instance, locales)),
         ])),
     };
     res.json(body);
@@ -118,7 +122,7 @@ gitApi.post("/commit", async (req, res) => {
         await req.git.commit(message);
         res.status(200).send("Commit successful");
     }
-    catch (error) {
+    catch {
         res.status(500).send("Commit failed");
     }
 });
@@ -127,7 +131,7 @@ gitApi.post("/push", async (req, res) => {
         await req.git.push();
         res.status(200).send("Push successful");
     }
-    catch (error) {
+    catch {
         res.status(500).send("Push failed");
     }
 });
@@ -136,7 +140,7 @@ gitApi.post("/pull", async (req, res) => {
         await req.git.pull();
         res.status(200).send("Pull successful");
     }
-    catch (error) {
+    catch {
         res.status(500).send("Pull failed");
     }
 });
@@ -159,7 +163,7 @@ gitApi.post("/branch", async (req, res) => {
         await reinit(req);
         res.status(200).send(`Creation of branch "${branchName}" successful`);
     }
-    catch (error) {
+    catch {
         res.status(500).send(`Creation of branch "${branchName}" failed`);
     }
 });
@@ -168,7 +172,7 @@ gitApi.post("/branch/:branchName", async (req, res) => {
         await req.git.checkout(req.params.branchName);
         res.status(200).send(`Switch to branch "${req.params.branchName}" successful`);
     }
-    catch (error) {
+    catch {
         res.status(500).send(`Switch to branch "${req.params.branchName}" failed`);
     }
 });

package/lib/{server → node/server}/api/instanceOperations.d.ts

@@ -1,6 +1,6 @@
-import { InstanceContainer } from "../../shared/utils/instances.js";
-import { Result } from "../../utils/result.js";
-import { TSONDBRequestLocals } from "../index.js";
+import type { InstanceContainer } from "../../../shared/utils/instances.js";
+import type { Result } from "../../../shared/utils/result.js";
+import type { TSONDBRequestLocals } from "../index.js";
 export declare const createInstance: (locals: TSONDBRequestLocals, entityName: string, instance: unknown, idQueryParam: unknown) => Promise<Result<InstanceContainer, [code: number, message: string]>>;
 export declare const updateInstance: (locals: TSONDBRequestLocals, entityName: string, instanceId: string, instance: unknown) => Promise<Result<InstanceContainer, [code: number, message: string]>>;
 export declare const deleteInstance: (locals: TSONDBRequestLocals, entityName: string, instanceId: string) => Promise<Result<InstanceContainer, [code: number, message: string]>>;

package/lib/{server → node/server}/api/instanceOperations.js

@@ -1,16 +1,19 @@
 import { rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { v4 as uuidv4 } from "uuid";
+import { removeAt } from "../../../shared/utils/array.js";
+import { error, ok } from "../../../shared/utils/result.js";
 import { validateEntityDecl } from "../../schema/declarations/EntityDecl.js";
 import { formatValue } from "../../schema/index.js";
 import { createValidators } from "../../schema/Node.js";
-import { removeAt } from "../../shared/utils/array.js";
 import { getErrorMessageForDisplay } from "../../utils/error.js";
 import { getGitFileStatusFromStatusResult } from "../../utils/git.js";
 import { updateReferencesToInstances } from "../../utils/references.js";
-import { error, ok } from "../../utils/result.js";
 export const createInstance = async (locals, entityName, instance, idQueryParam) => {
     const entity = locals.entitiesByName[entityName];
+    if (entity === undefined) {
+        return error([400, "Entity not found"]);
+    }
     const validationErrors = validateEntityDecl(createValidators(locals.instancesByEntityName), entity, instance);
     if (validationErrors.length > 0) {
         return error([400, validationErrors.map(getErrorMessageForDisplay).join("\n\n")]);
@@ -20,7 +23,7 @@ export const createInstance = async (locals, entityName, instance, idQueryParam)
     }
     const id = locals.localeEntity === entity ? idQueryParam : uuidv4();
     if (locals.localeEntity === entity &&
-        locals.instancesByEntityName[entity.name].some(instance => instance.id === id)) {
+        locals.instancesByEntityName[entity.name]?.some(instance => instance.id === id)) {
         return error([400, `Duplicate id "${id}" for locale entity`]);
     }
     const fileName = `${id}.json`;
@@ -46,6 +49,9 @@ export const updateInstance = async (locals, entityName, instanceId, instance) =
         return error([404, "Instance not found"]);
     }
     const entity = locals.entitiesByName[entityName];
+    if (entity === undefined) {
+        return error([400, "Entity not found"]);
+    }
     const validationErrors = validateEntityDecl(createValidators(locals.instancesByEntityName), entity, instance);
     if (validationErrors.length > 0) {
         return error([400, validationErrors.map(getErrorMessageForDisplay).join("\n\n")]);
@@ -77,6 +83,9 @@ export const deleteInstance = async (locals, entityName, instanceId) => {
         return ok(instanceContainer);
     }
     catch (err) {
-        return error([500, `Failed to delete instance: ${err}`]);
+        return error([
+            500,
+            `Failed to delete instance: ${err instanceof Error ? err.toString() : String(err)}`,
+        ]);
     }
 };

package/lib/{server → node/server}/api/instances.js

@@ -1,7 +1,7 @@
 import Debug from "debug";
 import express from "express";
+import { getDisplayNameFromEntityInstance } from "../../../shared/utils/displayName.js";
 import { serializeEntityDecl } from "../../schema/declarations/EntityDecl.js";
-import { getDisplayNameFromEntityInstance } from "../../shared/utils/displayName.js";
 const debug = Debug("tsondb:server:api:instances");
 export const instancesApi = express.Router();
 instancesApi.use((req, _res, next) => {
@@ -11,11 +11,15 @@ instancesApi.use((req, _res, next) => {
 instancesApi.get("/", (req, res) => {
     const locales = (Array.isArray(req.query["locales"]) ? req.query["locales"] : [req.query["locales"]]).filter(locale => typeof locale === "string");
     const body = {
-        instances: Object.fromEntries(Object.entries(req.instancesByEntityName).map(([entityName, instances]) => [
+        instances: Object.fromEntries(Object.entries(req.instancesByEntityName)
+            .filter(([entityName]) => Object.hasOwn(req.entitiesByName, entityName))
+            .map(([entityName, instances]) => [
             entityName,
             instances.map(instance => ({
                 id: instance.id,
-                name: getDisplayNameFromEntityInstance(serializeEntityDecl(req.entitiesByName[entityName]), instance.content, instance.id, locales),
+                name: getDisplayNameFromEntityInstance(
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                serializeEntityDecl(req.entitiesByName[entityName]), instance.content, instance.id, locales),
             })),
         ])),
     };

package/lib/node/server/index.d.ts

@@ -0,0 +1,28 @@
+import type { SimpleGit } from "simple-git";
+import type { InstancesByEntityName } from "../../shared/utils/instances.js";
+import type { Schema } from "../Schema.ts";
+import type { Decl } from "../schema/declarations/Declaration.js";
+import type { EntityDecl } from "../schema/declarations/EntityDecl.js";
+import type { ReferencesToInstances } from "../utils/references.js";
+export type ServerOptions = {
+    name: string;
+    port: number;
+};
+export interface TSONDBRequestLocals {
+    git: SimpleGit;
+    gitRoot: string | undefined;
+    dataRoot: string;
+    declarations: readonly Decl[];
+    entities: readonly EntityDecl[];
+    instancesByEntityName: InstancesByEntityName;
+    entitiesByName: Record<string, EntityDecl>;
+    localeEntity?: EntityDecl;
+    referencesToInstances: ReferencesToInstances;
+}
+declare global {
+    namespace Express {
+        interface Request extends TSONDBRequestLocals {
+        }
+    }
+}
+export declare const createServer: (schema: Schema, dataRootPath: string, instancesByEntityName: InstancesByEntityName, options?: Partial<ServerOptions>) => Promise<void>;

package/lib/{server → node/server}/index.js

@@ -8,7 +8,7 @@ const defaultOptions = {
     name: "tsondb server",
     port: 3000,
 };
-export const createServer = async (modelContainer, instancesByEntityName, options) => {
+export const createServer = async (schema, dataRootPath, instancesByEntityName, options) => {
     const { name, port } = { ...defaultOptions, ...options };
     const app = express();
     app.use(express.static(join(import.meta.dirname, "../../public")));
@@ -16,7 +16,7 @@ export const createServer = async (modelContainer, instancesByEntityName, option
     app.use("/js/client", express.static(join(import.meta.dirname, "../../lib/client")));
     app.use("/js/shared", express.static(join(import.meta.dirname, "../../lib/shared")));
     app.use(express.json());
-    const requestLocals = await init(modelContainer, Object.assign({}, instancesByEntityName));
+    const requestLocals = await init(schema, dataRootPath, Object.assign({}, instancesByEntityName));
     app.use((req, _res, next) => {
         Object.assign(req, requestLocals);
         next();
@@ -30,9 +30,6 @@ export const createServer = async (modelContainer, instancesByEntityName, option
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>TSONDB</title>
   <link rel="stylesheet" href="/css/styles.css">
-</head>
-<body>
-  <div id="app"></div>
   <script type="importmap">
     {
       "imports": {
@@ -43,11 +40,14 @@ export const createServer = async (modelContainer, instancesByEntityName, option
       }
     }
   </script>
+</head>
+<body>
+  <div id="app"></div>
   <script type="module" src="/js/client/index.js"></script>
 </body>
 </html>`);
     });
     app.listen(port, () => {
-        debug(`${name} listening on http://localhost:${port}`);
+        debug(`${name} listening on http://localhost:${port.toString()}`);
     });
 };

package/lib/node/server/init.d.ts

@@ -0,0 +1,5 @@
+import type { InstancesByEntityName } from "../../shared/utils/instances.js";
+import type { Schema } from "../Schema.ts";
+import type { TSONDBRequestLocals } from "./index.js";
+export declare const init: (schema: Schema, dataRootPath: string, instancesByEntityName: InstancesByEntityName) => Promise<TSONDBRequestLocals>;
+export declare const reinit: (locals: TSONDBRequestLocals) => Promise<void>;

package/lib/{server → node/server}/init.js

@@ -3,8 +3,8 @@ import { isEntityDecl } from "../schema/declarations/EntityDecl.js";
 import { resolveTypeArgumentsInDecls } from "../schema/index.js";
 import { attachGitStatusToInstancesByEntityName, getInstancesByEntityName, } from "../utils/instances.js";
 import { getReferencesToInstances } from "../utils/references.js";
-const getGit = async (modelContainer) => {
-    const git = simpleGit({ baseDir: modelContainer.dataRootPath });
+const getGit = async (dataRootPath) => {
+    const git = simpleGit({ baseDir: dataRootPath });
     if (await git.checkIsRepo()) {
         try {
             const root = await git.revparse({ "--show-toplevel": null });
@@ -19,25 +19,25 @@ const getGit = async (modelContainer) => {
         return { git };
     }
 };
-export const init = async (modelContainer, instancesByEntityName) => {
-    const { git, root: gitRoot, status: gitStatus } = await getGit(modelContainer);
-    const declarations = resolveTypeArgumentsInDecls(modelContainer.schema.declarations);
+export const init = async (schema, dataRootPath, instancesByEntityName) => {
+    const { git, root: gitRoot, status: gitStatus } = await getGit(dataRootPath);
+    const declarations = resolveTypeArgumentsInDecls(schema.declarations);
     const entities = declarations.filter(isEntityDecl);
     const entitiesByName = Object.fromEntries(entities.map(entity => [entity.name, entity]));
     const instancesByEntityNameInMemory = Object.assign({}, instancesByEntityName);
     const referencesToInstances = getReferencesToInstances(instancesByEntityName, entitiesByName);
     if (gitStatus) {
-        attachGitStatusToInstancesByEntityName(instancesByEntityName, modelContainer.dataRootPath, gitRoot, gitStatus);
+        attachGitStatusToInstancesByEntityName(instancesByEntityName, dataRootPath, gitRoot, gitStatus);
     }
     const requestLocals = {
         git: git,
         gitRoot: gitRoot,
-        dataRoot: modelContainer.dataRootPath,
+        dataRoot: dataRootPath,
         declarations: declarations,
         entities: entities,
         instancesByEntityName: instancesByEntityNameInMemory,
         entitiesByName: entitiesByName,
-        localeEntity: modelContainer.schema.localeEntity,
+        localeEntity: schema.localeEntity,
         referencesToInstances,
     };
     return requestLocals;

package/lib/{utils → node/utils}/error.js

@@ -1,7 +1,10 @@
 import { applyIndentation } from "./render.js";
 export const getErrorMessageForDisplay = (error) => {
     if (error instanceof AggregateError) {
-        return `${error.message}\n${applyIndentation(1, error.errors.map(subError => getErrorMessageForDisplay(subError)).join("\n"), 2)}`;
+        return `${error.message}\n${applyIndentation(1, error.errors
+            .filter(subError => subError instanceof Error)
+            .map(subError => getErrorMessageForDisplay(subError))
+            .join("\n"), 2)}`;
     }
     else if (error.cause instanceof Error) {
         return `${error.message}\n${applyIndentation(1, getErrorMessageForDisplay(error.cause), 2)}`;

package/lib/{utils → node/utils}/git.d.ts

@@ -1,3 +1,3 @@
-import { StatusResult } from "simple-git";
-import { GitFileStatus } from "../shared/utils/git.js";
+import type { StatusResult } from "simple-git";
+import type { GitFileStatus } from "../../shared/utils/git.js";
 export declare const getGitFileStatusFromStatusResult: (statusResult: StatusResult, repoRoot: string, dataRoot: string, entityName: string, fileName: string) => GitFileStatus | undefined;

package/lib/{utils → node/utils}/instances.d.ts

@@ -1,5 +1,5 @@
-import { StatusResult } from "simple-git";
-import { EntityDecl } from "../schema/declarations/EntityDecl.js";
-import { InstancesByEntityName } from "../shared/utils/instances.js";
+import type { StatusResult } from "simple-git";
+import type { InstancesByEntityName } from "../../shared/utils/instances.js";
+import type { EntityDecl } from "../schema/declarations/EntityDecl.js";
 export declare const getInstancesByEntityName: (dataRoot: string, entities: readonly EntityDecl[]) => Promise<InstancesByEntityName>;
 export declare const attachGitStatusToInstancesByEntityName: (instancesByEntityName: InstancesByEntityName, dataRoot: string, gitRoot: string, gitStatus: StatusResult) => void;

package/lib/{utils → node/utils}/instances.js

@@ -11,9 +11,11 @@ export const getInstancesByEntityName = async (dataRoot, entities) => Object.fro
     })));
     return [entity.name, instances];
 })));
-export const attachGitStatusToInstancesByEntityName = (instancesByEntityName, dataRoot, gitRoot, gitStatus) => Object.entries(instancesByEntityName).forEach(([entityName, instances]) => {
-    instancesByEntityName[entityName] = instances.map(instanceContainer => ({
-        ...instanceContainer,
-        gitStatus: getGitFileStatusFromStatusResult(gitStatus, gitRoot, dataRoot, entityName, instanceContainer.fileName),
-    }));
-});
+export const attachGitStatusToInstancesByEntityName = (instancesByEntityName, dataRoot, gitRoot, gitStatus) => {
+    Object.entries(instancesByEntityName).forEach(([entityName, instances]) => {
+        instancesByEntityName[entityName] = instances.map(instanceContainer => ({
+            ...instanceContainer,
+            gitStatus: getGitFileStatusFromStatusResult(gitStatus, gitRoot, dataRoot, entityName, instanceContainer.fileName),
+        }));
+    });
+};

package/lib/{utils → node/utils}/references.d.ts

@@ -1,5 +1,5 @@
-import { EntityDecl } from "../schema/declarations/EntityDecl.js";
-import { InstanceContainer } from "../shared/utils/instances.js";
+import type { InstanceContainer } from "../../shared/utils/instances.js";
+import type { EntityDecl } from "../schema/declarations/EntityDecl.js";
 export type ReferencesToInstances = {
     [instanceId: string]: string[];
 };

package/lib/{utils → node/utils}/references.js

@@ -1,5 +1,5 @@
+import { difference, removeAt } from "../../shared/utils/array.js";
 import { getReferencesForEntityDecl } from "../schema/declarations/EntityDecl.js";
-import { difference, removeAt } from "../shared/utils/array.js";
 const addReference = (acc, reference, instanceId) => ({
     ...acc,
     [reference]: [...(acc[reference] ?? []), instanceId],
@@ -31,8 +31,8 @@ export const updateReferencesToInstances = (entitiesByName, referencesToInstance
         if (newInstance === undefined) {
             return removeReferences(referencesToInstances, getReferencesForEntityDecl(entity, oldInstance), instanceId);
         }
-        const oldReferences = oldInstance === undefined ? [] : getReferencesForEntityDecl(entity, oldInstance);
-        const newReferences = newInstance === undefined ? [] : getReferencesForEntityDecl(entity, newInstance);
+        const oldReferences = getReferencesForEntityDecl(entity, oldInstance);
+        const newReferences = getReferencesForEntityDecl(entity, newInstance);
         const { added, removed } = difference(oldReferences, newReferences);
         return removeReferences(addReferences(referencesToInstances, added, instanceId), removed, instanceId);
     }

package/lib/{utils → node/utils}/render.js

@@ -1,5 +1,5 @@
 import { EOL } from "node:os";
-import { mergeObjects } from "../shared/utils/object.js";
+import { mergeObjects } from "../../shared/utils/object.js";
 export const prefixLines = (prefix, text, includeEmptyLines = false) => text
     .split(EOL)
     .map(line => (includeEmptyLines || line.length > 0 ? prefix + line : line))

package/lib/shared/api.d.ts

@@ -1,5 +1,5 @@
-import { SerializedDecl } from "../schema/declarations/Declaration.js";
-import { InstanceContainer, InstanceContainerOverview } from "./utils/instances.js";
+import type { SerializedDecl } from "../node/schema/declarations/Declaration.js";
+import type { InstanceContainer, InstanceContainerOverview } from "./utils/instances.js";
 export interface GetAllDeclarationsResponseBody<D extends SerializedDecl = SerializedDecl> {
     declarations: {
         declaration: D;
@@ -51,3 +51,9 @@ export interface GetAllGitBranchesResponseBody {
     allBranches: string[];
     currentBranch: string;
 }
+export interface CreateCommitRequestBody {
+    message: string;
+}
+export interface CreateBranchRequestBody {
+    branchName: string;
+}

package/lib/shared/utils/array.js

@@ -1,12 +1,15 @@
-export const removeAt = (arr, index) => [
-    ...arr.slice(0, index),
-    ...arr.slice(index + 1),
-];
-export const insertAt = (arr, index, item) => [
-    ...arr.slice(0, index),
-    item,
-    ...arr.slice(index),
-];
+export const removeAt = (arr, index) => {
+    if (index < 0 || index >= arr.length) {
+        throw new RangeError(`index ${index.toString()} is out of bounds for array of length ${arr.length.toString()}`);
+    }
+    return [...arr.slice(0, index), ...arr.slice(index + 1)];
+};
+export const insertAt = (arr, index, item) => {
+    if (index < 0 || index > arr.length) {
+        throw new RangeError(`index ${index.toString()} is out of bounds for array of length ${arr.length.toString()}`);
+    }
+    return [...arr.slice(0, index), item, ...arr.slice(index)];
+};
 /**
  * Calculates the difference between two arrays, including duplicated values.
  * @param oldArr - The original array.

package/lib/shared/utils/displayName.d.ts

@@ -1,2 +1,2 @@
-import { SerializedEntityDecl } from "../../schema/index.js";
+import type { SerializedEntityDecl } from "../../node/schema/index.js";
 export declare const getDisplayNameFromEntityInstance: (entity: SerializedEntityDecl, instance: unknown, defaultName: string, locales?: string[]) => string;

package/lib/shared/utils/displayName.js

@@ -23,9 +23,11 @@ export const getDisplayNameFromEntityInstance = (entity, instance, defaultName,
         const availableLocales = Object.keys(localeMap ?? {});
         return availableLocales.length === 0
             ? defaultName
-            : locales.reduce((name, locale) => name ??
+            : (locales.reduce((name, locale) => name ??
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 getValueAtPath(localeMap[locale], pathInLocaleMap), undefined) ??
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 getValueAtPath(localeMap[availableLocales[0]], pathInLocaleMap) ??
-                defaultName;
+                defaultName);
     }
 };

package/lib/shared/utils/instances.d.ts

@@ -1,5 +1,5 @@
-import { SerializedEntityDecl } from "../../schema/index.js";
-import { GitFileStatus } from "./git.js";
+import type { SerializedEntityDecl } from "../../node/schema/index.js";
+import type { GitFileStatus } from "./git.js";
 export interface InstanceContainer {
     fileName: string;
     id: string;

package/lib/{utils → shared/utils}/lazy.js

@@ -1,4 +1,4 @@
-import { assertExhaustive } from "../shared/utils/typeSafety.js";
+import { assertExhaustive } from "./typeSafety.js";
 /**
  * A lazy value that is only evaluated when it is needed.
  */

package/lib/shared/utils/markdown.js

@@ -1,18 +1,18 @@
 const boldWithItalicRule = {
     pattern: /\*\*(.*?\*.+?\*.*?)\*\*/,
-    map: (result, parseInside) => ({ kind: "bold", content: parseInside(result[1]) }),
+    map: (result, parseInside) => ({ kind: "bold", content: parseInside(result[1] ?? "") }),
 };
 const italicWithBoldRule = {
     pattern: /\*(.*?\*\*.+?\*\*.*?)\*/,
-    map: (result, parseInside) => ({ kind: "italic", content: parseInside(result[1]) }),
+    map: (result, parseInside) => ({ kind: "italic", content: parseInside(result[1] ?? "") }),
 };
 const boldRule = {
     pattern: /\*\*(.+?)\*\*/,
-    map: (result, parseInside) => ({ kind: "bold", content: parseInside(result[1]) }),
+    map: (result, parseInside) => ({ kind: "bold", content: parseInside(result[1] ?? "") }),
 };
 const italicRule = {
     pattern: /\*(.+?)\*/,
-    map: (result, parseInside) => ({ kind: "italic", content: parseInside(result[1]) }),
+    map: (result, parseInside) => ({ kind: "italic", content: parseInside(result[1] ?? "") }),
 };
 const rules = [boldWithItalicRule, italicWithBoldRule, boldRule, italicRule];
 export const parseBlockMarkdown = (text) => text.split(/\n{2,}/).map(par => ({ kind: "paragraph", content: parseInlineMarkdown(par) }));
@@ -20,10 +20,10 @@ const parseForRules = (rules, text) => {
     if (text.length === 0) {
         return [];
     }
-    if (rules.length === 0) {
+    const activeRule = rules[0];
+    if (activeRule === undefined) {
         return [{ kind: "text", content: text }];
     }
-    const activeRule = rules[0];
     const res = activeRule.pattern.exec(text);
     if (res && (activeRule.predicate?.(res) ?? true)) {
         const { index } = res;

package/lib/shared/utils/object.d.ts

@@ -1,3 +1,6 @@
 export declare const sortObjectKeys: (obj: Record<string, unknown>, keys: string[]) => Record<string, unknown>;
 export declare const sortObjectKeysAlphabetically: (obj: Record<string, unknown>) => Record<string, unknown>;
 export declare const mergeObjects: <T>(obj1: Record<string, T>, obj2: Record<string, T>, solveConflict: (a: T, b: T) => T) => Record<string, T>;
+export type Leaves<T> = T extends object ? {
+    [K in keyof T]: T[K] extends unknown[] ? never : `${Exclude<K, symbol>}${Leaves<T[K]> extends never ? "" : `.${Leaves<T[K]>}`}`;
+}[keyof T] : never;

package/lib/shared/utils/object.js

@@ -2,5 +2,6 @@ export const sortObjectKeys = (obj, keys) => Object.fromEntries(keys.flatMap(key
 export const sortObjectKeysAlphabetically = (obj) => Object.fromEntries(Object.entries(obj).sort(([keyA], [keyB]) => keyA.localeCompare(keyB)));
 export const mergeObjects = (obj1, obj2, solveConflict) => Object.entries(obj2).reduce((acc, [key, value]) => ({
     ...acc,
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
     [key]: Object.hasOwn(acc, key) ? solveConflict(acc[key], value) : value,
 }), obj1);

package/lib/{utils → shared/utils}/result.js

@@ -24,11 +24,11 @@ export const reduce = (result, fok, ferror) => (isOk(result) ? fok(result.value)
 /**
  * Maps the value of a result to a new value.
  */
-export const map = (result, f) => (isOk(result) ? ok(f(result.value)) : result);
+export const map = (result, f) => isOk(result) ? ok(f(result.value)) : result;
 /**
  * Maps an error to a new error.
  */
-export const mapError = (result, f) => (isError(result) ? error(f(result.error)) : result);
+export const mapError = (result, f) => isError(result) ? error(f(result.error)) : result;
 export const combine = (result1, result2, fok, ferror) => isOk(result1)
     ? isOk(result2)
         ? ok(fok(result1.value, result2.value))

package/lib/shared/utils/string.js

@@ -5,14 +5,17 @@ const separator = /[^a-z0-9]/;
 const lastChar = (str) => str[str.length - 1];
 const lastElement = (arr) => arr[arr.length - 1];
 const isAllUppercase = (str) => str === str.toUpperCase();
-export const splitStringParts = (str) => [...str].reduce((acc, char, i, strArr) => {
+export const splitStringParts = (str) => [...new Intl.Segmenter().segment(str)].reduce((acc, segment, i, strArr) => {
+    const char = segment.segment;
     if (acc.length === 0) {
         return letterOrDigit.test(char) ? [char] : acc;
     }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
     const lastPart = lastElement(acc);
     if (uppercase.test(char)) {
         const lastCharOfLastPart = lastChar(lastPart);
-        const nextChar = strArr[i + 1];
+        const nextSegment = strArr[i + 1];
+        const nextChar = nextSegment?.segment;
         if (lastCharOfLastPart === undefined ||
             (uppercase.test(lastCharOfLastPart) && (nextChar === undefined || separator.test(nextChar)))) {
             return [...acc.slice(0, -1), lastPart + char];
@@ -47,8 +50,8 @@ export const toKebabCase = (str) => splitStringParts(str)
 export const toSnakeCase = (str) => splitStringParts(str)
     .map(part => part.toLowerCase())
     .join("_");
-export const toTitleCase = (str) => splitStringParts(str)
-    .map(part => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
+export const toTitleCase = (str) => splitStringParts(isAllUppercase(str) ? str.toLowerCase() : str)
+    .map(part => isAllUppercase(part) ? part : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
     .join(" ");
 export const commonPrefix = (...strs) => {
     if (strs.length === 0) {

package/lib/shared/utils/validation.js

@@ -1,14 +1,15 @@
 import { gte, lte } from "./compare.js";
 export const parallelizeErrors = (errors) => errors.filter(error => error !== undefined);
+const normalizeLabel = (label) => Array.isArray(label) ? label : [label, label + "s"];
 export const validateLengthRangeBound = (end, label, rangeBound, value) => {
     if (rangeBound === undefined) {
         return;
     }
     const [operator, description] = end === "lower" ? [gte, "least"] : [lte, "most"];
     const length = value.length;
-    const normalizedLabel = Array.isArray(label) ? label : [label, label + "s"];
+    const normalizedLabel = normalizeLabel(label);
     if (!operator(length, rangeBound)) {
-        return RangeError(`Expected at ${description} ${rangeBound} ${normalizedLabel[rangeBound === 1 ? 0 : 1]}, but got ${length} ${normalizedLabel[length === 1 ? 0 : 1]}`);
+        return RangeError(`expected at ${description} ${rangeBound.toString()} ${normalizedLabel[rangeBound === 1 ? 0 : 1]}, but got ${length.toString()} ${normalizedLabel[length === 1 ? 0 : 1]}`);
     }
     return;
 };

package/lib/shared/validation/number.js

@@ -18,8 +18,8 @@ export const validateRangeBound = (end, rangeBound, value) => {
         : normalizedRangeBound.isExclusive
             ? [lt, "less than"]
             : [lte, "less than or equal"];
-    if (operator(value, normalizedRangeBound.value)) {
-        return RangeError(`expected a value ${description} ${normalizedRangeBound.value}, but got ${value}`);
+    if (!operator(value, normalizedRangeBound.value)) {
+        return RangeError(`expected a value ${description} ${normalizedRangeBound.value.toString()}, but got ${value.toString()}`);
     }
     return;
 };
@@ -28,7 +28,7 @@ export const validateMultipleOf = (multipleOf, value) => {
         return;
     }
     if (value % multipleOf !== 0) {
-        return RangeError(`expected a value that is a multiple of ${multipleOf}, but got ${value}`);
+        return RangeError(`expected a value that is a multiple of ${multipleOf.toString()}, but got ${value.toString()}`);
     }
     return;
 };

package/lib/shared/validation/object.js

@@ -1,11 +1,12 @@
 import { parallelizeErrors, validateLengthRangeBound } from "../utils/validation.js";
 export const validateObjectConstraints = (constraints, expectedKeys, value) => {
     const label = ["property", "properties"];
+    const actualKeys = Object.keys(value);
     return parallelizeErrors([
-        validateLengthRangeBound("lower", label, constraints.minProperties, expectedKeys),
-        validateLengthRangeBound("upper", label, constraints.maxProperties, expectedKeys),
+        validateLengthRangeBound("lower", label, constraints.minProperties, actualKeys),
+        validateLengthRangeBound("upper", label, constraints.maxProperties, actualKeys),
         ...(constraints.additionalProperties !== true
-            ? Object.keys(value).flatMap(valueKey => expectedKeys.includes(valueKey)
+            ? actualKeys.flatMap(valueKey => expectedKeys.includes(valueKey)
                 ? []
                 : [TypeError(`object does not allow unknown keys and key "${valueKey}" is not known`)])
             : []),