@paroicms/internal-server-lib 1.6.0

package/README.md

@@ -0,0 +1,9 @@
+# @paroicms/internal-server-lib
+
+This is an internal package.
+
+This package is part of [ParoiCMS](https://www.npmjs.com/package/@paroicms/server).
+
+## License
+
+Released under the [MIT license](https://gitlab.com/paroi/opensource/paroicms/-/blob/main/LICENSE.md).

package/dist/cron-like.d.ts

@@ -0,0 +1,14 @@
+import type { BasicAppLog } from "./public.types";
+export interface CronLikeOptions {
+    shouldExecute: ShouldExecuteFn;
+    immediate?: boolean;
+    appLog: BasicAppLog;
+}
+export type ShouldExecuteFn = (lastTime: Date) => boolean;
+/**
+ * @returns A function to stop the cron-like process.
+ */
+export declare function startCronLike(task: () => Promise<void>, { shouldExecute, immediate, appLog }: CronLikeOptions): () => Promise<void>;
+export declare function eachDay({ hours }: {
+    hours: number;
+}): ShouldExecuteFn;

package/dist/cron-like.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eachDay = exports.startCronLike = void 0;
+/**
+ * @returns A function to stop the cron-like process.
+ */
+function startCronLike(task, { shouldExecute, immediate, appLog }) {
+    const intervalMs = 15 * 60 * 1000;
+    let lastTime;
+    let taskPromise;
+    const intervalId = setInterval(async () => {
+        if (taskPromise)
+            return;
+        try {
+            if ((lastTime && !shouldExecute(lastTime)) || (!lastTime && !immediate))
+                return;
+            lastTime = new Date();
+            taskPromise = task();
+            await taskPromise;
+        }
+        catch (error) {
+            appLog.error(error);
+        }
+        taskPromise = undefined;
+    }, intervalMs);
+    appLog.info("Cron-like is started.");
+    return async () => {
+        clearInterval(intervalId);
+        if (!taskPromise)
+            return;
+        try {
+            await taskPromise;
+        }
+        catch {
+            // The error is already logged in the 'setInterval' callback.
+        }
+        appLog.info("Cron-like is stopped.");
+    };
+}
+exports.startCronLike = startCronLike;
+function eachDay({ hours }) {
+    return (lastTime) => {
+        const now = new Date();
+        if (lastTime && sameDay(lastTime, now))
+            return false;
+        return now.getHours() === hours;
+    };
+}
+exports.eachDay = eachDay;
+function sameDay(d1, d2) {
+    return (d1.getFullYear() === d2.getFullYear() &&
+        d1.getMonth() === d2.getMonth() &&
+        d1.getDate() === d2.getDate());
+}
+//# sourceMappingURL=cron-like.js.map

package/dist/cron-like.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-like.js","sourceRoot":"","sources":["../src/cron-like.ts"],"names":[],"mappings":";;;AAUA;;GAEG;AACH,SAAgB,aAAa,CAC3B,IAAyB,EACzB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAmB;IAErD,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAClC,IAAI,QAA0B,CAAC;IAC/B,IAAI,WAAsC,CAAC;IAE3C,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACxC,IAAI,WAAW;YAAE,OAAO;QACxB,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC;gBAAE,OAAO;YAChF,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;YACtB,WAAW,GAAG,IAAI,EAAE,CAAC;YACrB,MAAM,WAAW,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,WAAW,GAAG,SAAS,CAAC;IAC1B,CAAC,EAAE,UAAU,CAAC,CAAC;IAEf,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAErC,OAAO,KAAK,IAAI,EAAE;QAChB,aAAa,CAAC,UAAU,CAAC,CAAC;QAC1B,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,IAAI,CAAC;YACH,MAAM,WAAW,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC;AAjCD,sCAiCC;AAED,SAAgB,OAAO,CAAC,EAAE,KAAK,EAAqB;IAClD,OAAO,CAAC,QAAc,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACrD,OAAO,GAAG,CAAC,QAAQ,EAAE,KAAK,KAAK,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAND,0BAMC;AAED,SAAS,OAAO,CAAC,EAAQ,EAAE,EAAQ;IACjC,OAAO,CACL,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE;QACrC,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE;QAC/B,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,CAC9B,CAAC;AACJ,CAAC"}

package/dist/fs-utils.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="node" />
+import type { Stats } from "node:fs";
+export declare function pathExists(path: string): Promise<boolean>;
+/**
+ * @returns undefined if the file does not exist or can't be accessed
+ */
+export declare function fileStatsOrUndef(path: string): Promise<Stats | undefined>;
+export declare function ensureDirectory(path: string): Promise<void>;

package/dist/fs-utils.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirectory = exports.fileStatsOrUndef = exports.pathExists = void 0;
+const promises_1 = require("node:fs/promises");
+async function pathExists(path) {
+    return !!(await fileStatsOrUndef(path));
+}
+exports.pathExists = pathExists;
+/**
+ * @returns undefined if the file does not exist or can't be accessed
+ */
+async function fileStatsOrUndef(path) {
+    try {
+        return await (0, promises_1.stat)(path);
+    }
+    catch { }
+}
+exports.fileStatsOrUndef = fileStatsOrUndef;
+async function ensureDirectory(path) {
+    if (!(await pathExists(path))) {
+        await (0, promises_1.mkdir)(path);
+    }
+}
+exports.ensureDirectory = ensureDirectory;
+//# sourceMappingURL=fs-utils.js.map

package/dist/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":";;;AACA,+CAA+C;AAExC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,OAAO,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1C,CAAC;AAFD,gCAEC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,IAAI,CAAC;QACH,OAAO,MAAM,IAAA,eAAI,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC;AAJD,4CAIC;AAEM,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAA,gBAAK,EAAC,IAAI,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAJD,0CAIC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import "reflect-metadata";
+export * from "./cron-like";
+export * from "./fs-utils";
+export * from "./jwt-secret.helpers";
+export * from "./pino-app-log";
+export * from "./public.types";
+export * from "./read-configuration";
+export * from "./relative-id-helper";
+export * from "./resource-version";
+export * from "./sql-logger";
+export * from "./sqlite-db-init";
+export * from "./tracker";

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata"); // needed by TypeORM
+__exportStar(require("./cron-like"), exports);
+__exportStar(require("./fs-utils"), exports);
+__exportStar(require("./jwt-secret.helpers"), exports);
+__exportStar(require("./pino-app-log"), exports);
+__exportStar(require("./public.types"), exports);
+__exportStar(require("./read-configuration"), exports);
+__exportStar(require("./relative-id-helper"), exports);
+__exportStar(require("./resource-version"), exports);
+__exportStar(require("./sql-logger"), exports);
+__exportStar(require("./sqlite-db-init"), exports);
+__exportStar(require("./tracker"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAA0B,CAAC,oBAAoB;AAE/C,8CAA4B;AAC5B,6CAA2B;AAC3B,uDAAqC;AACrC,iDAA+B;AAC/B,iDAA+B;AAC/B,uDAAqC;AACrC,uDAAqC;AACrC,qDAAmC;AACnC,+CAA6B;AAC7B,mDAAiC;AACjC,4CAA0B"}

package/dist/jwt-secret.helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function getJwtSecretSync(file: string): string;
+export declare function makeSecret(length: number): string;

package/dist/jwt-secret.helpers.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeSecret = exports.getJwtSecretSync = void 0;
+const node_fs_1 = require("node:fs");
+function getJwtSecretSync(file) {
+    if (!pathExistsSync(file)) {
+        (0, node_fs_1.writeFileSync)(file, makeSecret(50), "utf8");
+    }
+    return (0, node_fs_1.readFileSync)(file, "utf8");
+}
+exports.getJwtSecretSync = getJwtSecretSync;
+function makeSecret(length) {
+    const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let result = "";
+    for (let i = 0; i < length; i++) {
+        result += characters.charAt(Math.floor(Math.random() * characters.length));
+    }
+    return result;
+}
+exports.makeSecret = makeSecret;
+function pathExistsSync(path) {
+    try {
+        (0, node_fs_1.accessSync)(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=jwt-secret.helpers.js.map

package/dist/jwt-secret.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-secret.helpers.js","sourceRoot":"","sources":["../src/jwt-secret.helpers.ts"],"names":[],"mappings":";;;AAAA,qCAAkE;AAElE,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,IAAA,uBAAa,EAAC,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AALD,4CAKC;AAED,SAAgB,UAAU,CAAC,MAAc;IACvC,MAAM,UAAU,GAAG,gEAAgE,CAAC;IACpF,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAPD,gCAOC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,IAAA,oBAAU,EAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/pino-app-log.d.ts

@@ -0,0 +1,32 @@
+import type { Obj } from "@paroi/data-formatters-lib";
+export interface AppLog {
+    error(...messages: any[]): void;
+    warn(...messages: any[]): void;
+    info(...messages: any[]): void;
+    stats(...messages: any[]): void;
+    debug(...messages: any[]): void;
+    trace(...messages: any[]): void;
+}
+export type AppLogLevel = keyof AppLog;
+export interface PlatformLog extends AppLog {
+    createChildLog(properties: Obj): AppLog;
+    on(level: AppLogLevel, listener: (ev: AppLogEvent) => void): void;
+    untilReady: Promise<void>;
+    flushSync(): void;
+}
+export interface AppLogEvent {
+    level: AppLogLevel;
+    textMessage: string;
+    originalMessages: any[];
+}
+export interface AppLogOptions {
+    level: "silent" | AppLogLevel;
+    /**
+     * Omit for stdout.
+     */
+    file?: string;
+}
+/**
+ * Warning: install pino-pretty in development mode only.
+ */
+export declare function createPlatformLog({ file, level }: AppLogOptions): PlatformLog;

package/dist/pino-app-log.js

@@ -0,0 +1,142 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlatformLog = void 0;
+const async_lib_1 = require("@paroi/async-lib");
+const node_events_1 = require("node:events");
+const pino_1 = __importDefault(require("pino"));
+const levels = ["error", "warn", "info", "stats", "debug", "trace"];
+const levelIndexes = new Map(levels.map((l, index) => [l, index]));
+/**
+ * Warning: install pino-pretty in development mode only.
+ */
+function createPlatformLog({ file, level }) {
+    const destination = pino_1.default.destination({
+        dest: file,
+        // minLength: 4096,
+        sync: false,
+    });
+    const emitter = new node_events_1.EventEmitter();
+    let ready = false;
+    const { promise: untilReady, resolve, reject } = (0, async_lib_1.promiseToHandle)();
+    destination.on("error", reject);
+    destination.on("ready", () => {
+        ready = true;
+        destination.off("error", reject);
+        destination.on("error", (error) => console.error("[Error in Pino]", error));
+        resolve();
+    });
+    let waitingMessages;
+    function makeLogFn(level) {
+        return (...messages) => {
+            const textMessage = messagesToString(messages);
+            if (ready)
+                logger[level](textMessage);
+            else {
+                if (!waitingMessages) {
+                    waitingMessages = [];
+                    console.warn("There is something to log before the logger is ready");
+                    void untilReady.then(() => {
+                        if (waitingMessages) {
+                            if (file) {
+                                waitingMessages.forEach((wMessages) => logger[level](messagesToString(wMessages)));
+                            }
+                            waitingMessages = undefined;
+                        }
+                    });
+                }
+                if (level in console)
+                    console[level](...messages);
+                else
+                    console.log(...messages);
+                messages.unshift("[DELAYED]");
+                waitingMessages.push(messages);
+            }
+            try {
+                emitAppLogEvent({
+                    level,
+                    textMessage,
+                    originalMessages: messages,
+                }, emitter);
+            }
+            catch (error) {
+                if (ready)
+                    logger.error(messagesToString(["Error in app log listener:", error]));
+                else
+                    console.error("Error in app log listener:", error);
+            }
+        };
+    }
+    const logger = (0, pino_1.default)({
+        level,
+        customLevels: {
+            stats: 25,
+        },
+    }, destination);
+    console.log(`Application log with level '${level}' is in: ${file ?? "stdout"}.`);
+    function createChildLog(properties) {
+        return logger.child(properties);
+    }
+    return {
+        error: makeLogFn("error"),
+        warn: makeLogFn("warn"),
+        info: makeLogFn("info"),
+        stats: makeLogFn("stats"),
+        debug: makeLogFn("debug"),
+        trace: makeLogFn("trace"),
+        on: (level, listener) => emitter.on(`on-${level}`, listener),
+        untilReady,
+        flushSync() {
+            if (ready)
+                destination.flushSync();
+            else
+                console.warn("Flush is called before the logger is ready.");
+        },
+        createChildLog,
+    };
+}
+exports.createPlatformLog = createPlatformLog;
+function messagesToString(messages) {
+    return messages.map((msg) => messageToString(msg)).join(" ");
+}
+function messageToString(msg, parents = []) {
+    if (parents.includes(msg))
+        return "[recursive-ref]";
+    if (parents.length > 5)
+        return "[too-deep]";
+    switch (typeof msg) {
+        case "string":
+            return msg;
+        case "number":
+        case "bigint":
+        case "boolean":
+        case "undefined":
+        case "symbol":
+            return String(msg);
+        case "function":
+            return `[function ${msg.name}]`;
+        case "object":
+            if (msg === null)
+                return "null";
+            if (Array.isArray(msg))
+                return `[${msg.map((child) => messageToString(child, [...parents, msg])).join(",")}]`;
+            if (msg instanceof Error)
+                return msg.stack ?? `Error: ${msg.message ?? "-no-message-"}`;
+            return `{${Object.entries(msg)
+                .map(([key, child]) => `${key}: ${messageToString(child, [...parents, msg])}`)
+                .join(",")}}`;
+        default:
+            return `Unexpected message type: ${typeof msg}`;
+    }
+}
+function emitAppLogEvent(ev, emitter) {
+    let index = levelIndexes.get(ev.level);
+    if (index === undefined)
+        throw new Error(`Invalid level '${ev.level}'`);
+    do {
+        emitter.emit(`on-${levels[index]}`, ev);
+    } while (++index < levels.length);
+}
+//# sourceMappingURL=pino-app-log.js.map

package/dist/pino-app-log.js.map

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

package/dist/public.types.d.ts

@@ -0,0 +1,6 @@
+export interface BasicAppLog {
+    error(...messages: any[]): void;
+    warn(...messages: any[]): void;
+    info(...messages: any[]): void;
+    debug(...messages: any[]): void;
+}

package/dist/public.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=public.types.js.map

package/dist/public.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.types.js","sourceRoot":"","sources":["../src/public.types.ts"],"names":[],"mappings":""}

package/dist/read-configuration.d.ts

@@ -0,0 +1,7 @@
+import type { TypeOnlyValidator } from "@typeonly/validator";
+export interface ReadConfigFileOptions {
+    typeValidator: TypeOnlyValidator;
+    typeName: string;
+    defaultFileName?: string;
+}
+export declare function readConfigFileSync<T>({ typeValidator, typeName, defaultFileName, }: ReadConfigFileOptions): T;

package/dist/read-configuration.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readConfigFileSync = void 0;
+const data_formatters_lib_1 = require("@paroi/data-formatters-lib");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_process_1 = require("node:process");
+function readConfigFileSync({ typeValidator, typeName, defaultFileName, }) {
+    const paramIndex = process.argv.indexOf("--config");
+    const hasParam = paramIndex !== -1 && paramIndex + 1 < process.argv.length;
+    let confFile = hasParam ? process.argv[paramIndex + 1] : defaultFileName;
+    if (!confFile)
+        throw new Error("Missing configuration file parameter");
+    if (!(0, node_path_1.isAbsolute)(confFile)) {
+        confFile = (0, node_path_1.join)((0, node_process_1.cwd)(), confFile);
+    }
+    let data;
+    try {
+        const content = (0, node_fs_1.readFileSync)(confFile, "utf8");
+        data = JSON.parse(content);
+    }
+    catch (err) {
+        throw new Error(`Cannot load the configuration file '${confFile}': ${(0, data_formatters_lib_1.messageOf)(err)}`);
+    }
+    const result = typeValidator.validate(typeName, data);
+    if (!result.valid)
+        throw new Error(`Invalid config file: ${result.error ?? "(missing message)"}`);
+    return data;
+}
+exports.readConfigFileSync = readConfigFileSync;
+//# sourceMappingURL=read-configuration.js.map

package/dist/read-configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-configuration.js","sourceRoot":"","sources":["../src/read-configuration.ts"],"names":[],"mappings":";;;AAAA,oEAAuD;AAEvD,qCAAuC;AACvC,yCAA6C;AAC7C,+CAAmC;AAQnC,SAAgB,kBAAkB,CAAI,EACpC,aAAa,EACb,QAAQ,EACR,eAAe,GACO;IACtB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,UAAU,KAAK,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IAC3E,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;IACzE,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACvE,IAAI,CAAC,IAAA,sBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,QAAQ,GAAG,IAAA,gBAAI,EAAC,IAAA,kBAAG,GAAE,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,IAAS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,MAAM,IAAA,+BAAS,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,KAAK,IAAI,mBAAmB,EAAE,CAAC,CAAC;IAClG,OAAO,IAAI,CAAC;AACd,CAAC;AAtBD,gDAsBC"}

package/dist/relative-id-helper.d.ts

@@ -0,0 +1,10 @@
+export interface RandomCharsGeneratorConfig {
+    chars: string;
+    min: number;
+    max: number;
+}
+export declare function makeDefaultRelativeId({ smallAlphabet, bigAlphabet, size, }?: {
+    smallAlphabet?: string | undefined;
+    bigAlphabet?: string | undefined;
+    size?: number | undefined;
+}): string;

package/dist/relative-id-helper.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeDefaultRelativeId = void 0;
+function makeDefaultRelativeId({ smallAlphabet = "023456789", bigAlphabet = "023456789abcdefghijkmnopqrstuvwxyz", size = 3, } = {}) {
+    const flags = Array(size);
+    const maxFlagIndex = size - 1;
+    while (true) {
+        const remaining = [];
+        for (let i = 0; i < size; ++i) {
+            if (flags[i] === undefined) {
+                remaining.push(i);
+            }
+        }
+        if (remaining.length === 0)
+            break;
+        const remainingIndex = randomInt(0, remaining.length);
+        const flagIndex = remaining[remainingIndex];
+        flags[flagIndex] = "b";
+        if (flagIndex > 0)
+            flags[flagIndex - 1] = "s";
+        if (flagIndex < maxFlagIndex)
+            flags[flagIndex + 1] = "s";
+    }
+    const result = [];
+    for (let i = 0; i < size; ++i) {
+        result.push(randomCharacterOf(flags[i] === "b" ? bigAlphabet : smallAlphabet));
+    }
+    return result.join("");
+}
+exports.makeDefaultRelativeId = makeDefaultRelativeId;
+function randomCharacterOf(alphabet) {
+    return alphabet[Math.floor(Math.random() * alphabet.length)];
+}
+/**
+ * The maximum is exclusive and the minimum is inclusive
+ */
+function randomInt(min, max) {
+    return Math.floor(Math.random() * (max - min) + min);
+}
+//# sourceMappingURL=relative-id-helper.js.map

package/dist/relative-id-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-id-helper.js","sourceRoot":"","sources":["../src/relative-id-helper.ts"],"names":[],"mappings":";;;AAMA,SAAgB,qBAAqB,CAAC,EACpC,aAAa,GAAG,WAAW,EAC3B,WAAW,GAAG,oCAAoC,EAClD,IAAI,GAAG,CAAC,GACT,GAAG,EAAE;IACJ,MAAM,KAAK,GAA8B,KAAK,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC;IAE9B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,EAAE,CAAC;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC3B,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM;QAClC,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;QAC5C,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;QACvB,IAAI,SAAS,GAAG,CAAC;YAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QAC9C,IAAI,SAAS,GAAG,YAAY;YAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAC3D,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AA5BD,sDA4BC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,GAAW,EAAE,GAAW;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;AACvD,CAAC"}

package/dist/resource-version.d.ts

@@ -0,0 +1 @@
+export declare function generateResourceVersion(): string;

package/dist/resource-version.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateResourceVersion = void 0;
+const nanoid_1 = require("nanoid");
+function generateResourceVersion() {
+    return (0, nanoid_1.nanoid)();
+}
+exports.generateResourceVersion = generateResourceVersion;
+//# sourceMappingURL=resource-version.js.map

package/dist/resource-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-version.js","sourceRoot":"","sources":["../src/resource-version.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAEhC,SAAgB,uBAAuB;IACrC,OAAO,IAAA,eAAM,GAAE,CAAC;AAClB,CAAC;AAFD,0DAEC"}

package/dist/sql-logger.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from "typeorm";
+import type { BasicAppLog } from "./public.types";
+export interface SqlLogger {
+    typeOrmLogger: Logger;
+    logNextQuery: (count?: number) => void;
+}
+export declare function createSqlLogger({ appLog, dbSchemaName, }: {
+    appLog: BasicAppLog;
+    dbSchemaName: string;
+}): SqlLogger;

package/dist/sql-logger.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSqlLogger = void 0;
+const noOp = () => {
+    // nothing to do
+};
+function createSqlLogger({ appLog, dbSchemaName, }) {
+    let debugCount = 0;
+    const typeOrmLogger = {
+        logQuery(query, parameters) {
+            if (debugCount <= 0)
+                return;
+            --debugCount;
+            appLog.debug(`[${dbSchemaName}] ${formatSqlQuery(query)}
+  parameters: ${parameters?.map(parameterToString)}`);
+        },
+        logQueryError(error, query, parameters) {
+            appLog.error(`[${dbSchemaName}] sql error:`, error, query, parameters);
+        },
+        logQuerySlow: noOp,
+        logSchemaBuild: noOp,
+        logMigration: noOp,
+        log: noOp,
+    };
+    return {
+        typeOrmLogger,
+        logNextQuery(count = 1) {
+            debugCount += count;
+        },
+    };
+}
+exports.createSqlLogger = createSqlLogger;
+function formatSqlQuery(sql) {
+    return sql.replaceAll('"', "");
+}
+function parameterToString(parameter) {
+    if (parameter === undefined)
+        return "undefined";
+    if (parameter === null)
+        return "null";
+    const t = typeof parameter;
+    if (t === "number" || t === "boolean" || t === "bigint")
+        return parameter.toString();
+    if (t === "symbol")
+        return parameter.toString();
+    if (t === "string")
+        return JSON.stringify(parameter.length > 10 ? `${parameter.substring(0, 10)}…` : parameter);
+    return t; // "object" or "function"
+}
+//# sourceMappingURL=sql-logger.js.map

package/dist/sql-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-logger.js","sourceRoot":"","sources":["../src/sql-logger.ts"],"names":[],"mappings":";;;AAGA,MAAM,IAAI,GAAG,GAAG,EAAE;IAChB,gBAAgB;AAClB,CAAC,CAAC;AAOF,SAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,YAAY,GACkC;IAC9C,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,MAAM,aAAa,GAAW;QAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU;YACxB,IAAI,UAAU,IAAI,CAAC;gBAAE,OAAO;YAC5B,EAAE,UAAU,CAAC;YACb,MAAM,CAAC,KAAK,CACV,IAAI,YAAY,KAAK,cAAc,CAAC,KAAK,CAAC;gBAClC,UAAU,EAAE,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAC7C,CAAC;QACJ,CAAC;QAED,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU;YACpC,MAAM,CAAC,KAAK,CAAC,IAAI,YAAY,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACzE,CAAC;QAED,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE,IAAI;KACV,CAAC;IAEF,OAAO;QACL,aAAa;QACb,YAAY,CAAC,KAAK,GAAG,CAAC;YACpB,UAAU,IAAI,KAAK,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAhCD,0CAgCC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAc;IACvC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAChD,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACtC,MAAM,CAAC,GAAG,OAAO,SAAS,CAAC;IAC3B,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IACrF,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;IAChD,IAAI,CAAC,KAAK,QAAQ;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9F,OAAO,CAAC,CAAC,CAAC,yBAAyB;AACrC,CAAC"}

package/dist/sqlite-db-init.d.ts

@@ -0,0 +1,49 @@
+import { DataSource, type DataSourceOptions, type Logger, type SelectQueryBuilder } from "typeorm";
+import type { BasicAppLog } from "./public.types";
+export declare const METADATA_TABLE_NAME = "PaMetadata";
+export declare const DB_SCHEMA_VERSION_KEY = "dbSchemaVersion";
+export type DbMigrationReport = MigratedDbReport | NotMigratedDbReport;
+export interface MigratedDbReport {
+    migrated: true;
+    fromVersion: number;
+    schemaVersion: number;
+}
+export interface NotMigratedDbReport {
+    migrated: false;
+    schemaVersion: number;
+}
+export interface QueryBuilderConnection {
+    createQueryBuilder(): SelectQueryBuilder<any>;
+}
+export declare function createOrOpenSqliteConnection(options: {
+    sqliteFile: string;
+    ddlFile: string;
+    dbSchemaName: string;
+    canCreate: boolean;
+    logger: Logger;
+    entities: DataSourceOptions["entities"];
+    migrateDb: (cn: DataSource) => Promise<DbMigrationReport>;
+    appLog: BasicAppLog;
+}): Promise<{
+    cn: DataSource;
+    isNewDb: boolean;
+    migrationReport: DbMigrationReport;
+}>;
+export declare function executeDdl(cn: DataSource, ddlFile: string): Promise<void>;
+export declare function getMetadataValue(cn: DataSource, { dbSchemaName, key }: {
+    dbSchemaName: string;
+    key: string;
+}): Promise<string | undefined>;
+export declare function setMetadataValue(cn: DataSource, { dbSchemaName, key, value, errorIfMissing, }: {
+    dbSchemaName: string;
+    key: string;
+    value: string;
+    errorIfMissing?: boolean;
+}): Promise<void>;
+export declare function getMetadataDbSchemaVersion(cn: DataSource, { dbSchemaName }: {
+    dbSchemaName: string;
+}): Promise<number>;
+export declare function setMetadataDbSchemaVersion(cn: DataSource, { dbSchemaName, value }: {
+    dbSchemaName: string;
+    value: number;
+}): Promise<void>;

package/dist/sqlite-db-init.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setMetadataDbSchemaVersion = exports.getMetadataDbSchemaVersion = exports.setMetadataValue = exports.getMetadataValue = exports.executeDdl = exports.createOrOpenSqliteConnection = exports.DB_SCHEMA_VERSION_KEY = exports.METADATA_TABLE_NAME = void 0;
+const data_formatters_lib_1 = require("@paroi/data-formatters-lib");
+const promises_1 = require("node:fs/promises");
+const typeorm_1 = require("typeorm");
+const fs_utils_1 = require("./fs-utils");
+exports.METADATA_TABLE_NAME = "PaMetadata";
+exports.DB_SCHEMA_VERSION_KEY = "dbSchemaVersion";
+async function createOrOpenSqliteConnection(options) {
+    const { sqliteFile, ddlFile, dbSchemaName, canCreate, logger, entities, migrateDb, appLog } = options;
+    const isNewDb = !(await (0, fs_utils_1.pathExists)(sqliteFile));
+    if (isNewDb && !canCreate) {
+        throw new Error(`missing '${dbSchemaName}' database`);
+    }
+    const cn = await new typeorm_1.DataSource({
+        type: "sqlite",
+        database: sqliteFile,
+        enableWAL: false,
+        synchronize: false, // for relations test
+        logging: true,
+        entities,
+        logger,
+    }).initialize();
+    if (isNewDb) {
+        await executeDdl(cn, ddlFile);
+        appLog.info(`created '${dbSchemaName}' database`);
+    }
+    const migrationReport = await migrateDb(cn);
+    await cn.query("PRAGMA foreign_keys = 1"); // after migration scripts
+    return { cn, isNewDb, migrationReport };
+}
+exports.createOrOpenSqliteConnection = createOrOpenSqliteConnection;
+async function executeDdl(cn, ddlFile) {
+    const ddl = await (0, promises_1.readFile)(ddlFile, {
+        encoding: "utf-8",
+    });
+    const queries = ddl
+        .split(";")
+        .map((query) => query.trim())
+        .filter((query) => query !== "");
+    for (const query of queries) {
+        if (!onlySqlComment(query)) {
+            await cn.query(query);
+        }
+    }
+}
+exports.executeDdl = executeDdl;
+function onlySqlComment(sql) {
+    const lines = sql.split(/\r\n?|\n/);
+    for (let line of lines) {
+        line = line.trim();
+        if (line && !line.startsWith("--"))
+            return false;
+    }
+    return true;
+}
+async function getMetadataValue(cn, { dbSchemaName, key }) {
+    // specific to sqlite
+    const [row] = await cn.query(`select val from ${exports.METADATA_TABLE_NAME} where dbSchema = '${dbSchemaName}' and k = ?`, [key]);
+    if (row)
+        return (0, data_formatters_lib_1.strVal)(row.val, { varName: "val" });
+}
+exports.getMetadataValue = getMetadataValue;
+async function setMetadataValue(cn, { dbSchemaName, key, value, errorIfMissing, }) {
+    // specific to sqlite
+    const result = await cn.query(`update ${exports.METADATA_TABLE_NAME} set val = ? where dbSchema = '${dbSchemaName}' and k = ?`, [value, key]);
+    if (result.affectedRows === 0) {
+        if (errorIfMissing) {
+            throw new Error(`[${dbSchemaName}] missing '${key}' in '${exports.METADATA_TABLE_NAME}'`);
+        }
+        // specific to sqlite
+        await cn.query(`insert into ${exports.METADATA_TABLE_NAME} (dbSchema, k, val) values ('${dbSchemaName}', ?, ?)`, [key, value]);
+    }
+}
+exports.setMetadataValue = setMetadataValue;
+async function getMetadataDbSchemaVersion(cn, { dbSchemaName }) {
+    let value;
+    try {
+        value = await getMetadataValue(cn, { dbSchemaName, key: exports.DB_SCHEMA_VERSION_KEY });
+        if (value === undefined) {
+            throw new Error(`[${dbSchemaName}] missing '${exports.DB_SCHEMA_VERSION_KEY}' in '${exports.METADATA_TABLE_NAME}'`);
+        }
+    }
+    catch (error) {
+        try {
+            value = await migrateMetadataTable(cn, dbSchemaName);
+        }
+        catch {
+            throw error;
+        }
+    }
+    return Number(value);
+}
+exports.getMetadataDbSchemaVersion = getMetadataDbSchemaVersion;
+async function setMetadataDbSchemaVersion(cn, { dbSchemaName, value }) {
+    await setMetadataValue(cn, {
+        dbSchemaName,
+        key: exports.DB_SCHEMA_VERSION_KEY,
+        value: String(value),
+        errorIfMissing: true,
+    });
+}
+exports.setMetadataDbSchemaVersion = setMetadataDbSchemaVersion;
+async function migrateMetadataTable(cn, dbSchemaName) {
+    const [row] = await cn.query(`select dbVersion from PaDbMetadata where dbSchema = '${dbSchemaName}'`);
+    if (!row)
+        throw new Error(); // will be catched in the caller
+    const version = (0, data_formatters_lib_1.nbVal)(row.dbVersion);
+    await cn.query(`create table PaMetadata (
+  dbSchema varchar(100) not null,
+  k varchar(100) not null,
+  val varchar(250) not null,
+  primary key (dbSchema, k)
+)`);
+    await cn.query(`insert into PaMetadata (dbSchema, k, val) values ('${dbSchemaName}', 'dbSchemaVersion', '${version}')`);
+    await cn.query("drop table PaDbMetadata");
+    console.warn(`[${dbSchemaName}] … migrated 'PaDbMetadata' table to 'PaMetadata'`);
+    return String(version);
+}
+//# sourceMappingURL=sqlite-db-init.js.map

package/dist/sqlite-db-init.js.map

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

package/dist/tracker.d.ts

@@ -0,0 +1,12 @@
+export interface Tracker {
+    trackAccess(database: string, collection: string, accessType: TrackerAccessType): void;
+    toReport(): TrackerReport;
+}
+export type TrackerAccessType = "read" | "write" | "delete";
+export interface TrackerReport {
+    [database: string]: {
+        [accessType in TrackerAccessType]?: number;
+    };
+}
+export declare function createTracker(): Tracker;
+export declare function createNoTracker(): Tracker;

package/dist/tracker.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNoTracker = exports.createTracker = void 0;
+function createTracker() {
+    const byDatabases = new Map();
+    return {
+        trackAccess(database, collection, accessType) {
+            let byCollections = byDatabases.get(database);
+            if (!byCollections) {
+                byCollections = new Map();
+                byDatabases.set(database, byCollections);
+            }
+            let byAccessTypes = byCollections.get(collection);
+            if (!byAccessTypes) {
+                byAccessTypes = new Map();
+                byCollections.set(collection, byAccessTypes);
+            }
+            byAccessTypes.set(accessType, (byAccessTypes.get(accessType) ?? 0) + 1);
+        },
+        toReport() {
+            const report = {};
+            for (const [database, byCollections] of byDatabases) {
+                report[database] = {};
+                for (const [, byAccessTypes] of byCollections) {
+                    for (const [accessType, count] of byAccessTypes) {
+                        report[database][accessType] = count;
+                    }
+                }
+            }
+            return report;
+        },
+    };
+}
+exports.createTracker = createTracker;
+function createNoTracker() {
+    return {
+        trackAccess() {
+            // nothing to do
+        },
+        toReport() {
+            return {};
+        },
+    };
+}
+exports.createNoTracker = createNoTracker;
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":";;;AAaA,SAAgB,aAAa;IAC3B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuD,CAAC;IAEnF,OAAO;QACL,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU;YAC1C,IAAI,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;gBAC1B,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAClD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;gBAC1B,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YAC/C,CAAC;YACD,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,QAAQ;YACN,MAAM,MAAM,GAAkB,EAAE,CAAC;YACjC,KAAK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,WAAW,EAAE,CAAC;gBACpD,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;gBACtB,KAAK,MAAM,CAAC,EAAE,aAAa,CAAC,IAAI,aAAa,EAAE,CAAC;oBAC9C,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;wBAChD,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;oBACvC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AA/BD,sCA+BC;AAED,SAAgB,eAAe;IAC7B,OAAO;QACL,WAAW;YACT,gBAAgB;QAClB,CAAC;QACD,QAAQ;YACN,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC;AATD,0CASC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@paroicms/internal-server-lib",
+  "version": "1.6.0",
+  "description": "Common utilitaries for the paroicms server.",
+  "author": "Paroi Team",
+  "keywords": [
+    "paroicms",
+    "server",
+    "utilitaries"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/paroi/opensource/paroicms.git",
+    "directory": "packages/internal-server-lib"
+  },
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clear": "rimraf dist/*",
+    "dev": "tsc --watch --preserveWatchOutput",
+    "eslint": "eslint ."
+  },
+  "devDependencies": {
+    "@types/node": "~20.12.8",
+    "rimraf": "~5.0.5",
+    "typescript": "~5.4.5"
+  },
+  "dependencies": {
+    "@typeonly/validator": "~0.6.0",
+    "@paroi/data-formatters-lib": "~0.4.0",
+    "@paroicms/internal-anywhere-lib": "1.17.0",
+    "@paroicms/public-anywhere-lib": "0.2.0",
+    "@paroicms/public-server-lib": "0.6.0",
+    "nanoid": "~3.3.7",
+    "reflect-metadata": "~0.2.2",
+    "typeorm": "~0.3.19",
+    "sqlite3": "~5.1.7"
+  },
+  "files": [
+    "dist"
+  ]
+}