@rakun-kit/core 1.0.0

package/dist/esm/lib/Logger.js

@@ -0,0 +1,226 @@
+import { AsyncLocalStorage } from "async_hooks";
+import fs from "fs";
+import { inspect } from "util";
+export const LEVELS = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+};
+const COLORS = {
+    trace: "\x1b[90m", // gris
+    debug: "\x1b[36m", // cyan
+    info: "\x1b[32m", // verde
+    warn: "\x1b[33m", // amarillo
+    error: "\x1b[31m", // rojo
+    fatal: "\x1b[35m", // magenta
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    bright: "\x1b[1m",
+};
+export function createLogger({ level = "info", file = null, maxQueue = 50000, batchSize = 200, flushIntervalMs = 0, prettify = false, maxTraceEntries = 200, } = {}) {
+    const minLevel = LEVELS[level] ?? LEVELS.info;
+    const traceStorage = new AsyncLocalStorage();
+    let globalTraceSteps = [];
+    const stream = file
+        ? fs.createWriteStream(file, { flags: "a", highWaterMark: 1 << 20 }) // 1MB buffer
+        : process.stdout;
+    let queue = [];
+    let scheduled = false;
+    let dropped = 0;
+    let timer = null;
+    function shouldLog(lvl) {
+        return (LEVELS[lvl] ?? 999) >= minLevel;
+    }
+    function safeStringify(value) {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return String(value);
+        }
+    }
+    function trimTraceSteps(steps) {
+        if (steps.length <= maxTraceEntries)
+            return;
+        steps.splice(0, steps.length - maxTraceEntries);
+    }
+    function getCurrentTraceSteps() {
+        return traceStorage.getStore()?.steps ?? globalTraceSteps;
+    }
+    function formatTraceStack(steps) {
+        return steps
+            .map((step, index) => {
+            const timestamp = new Date(step.t).toISOString();
+            const data = step.data !== undefined ? ` ${safeStringify(step.data)}` : "";
+            return `${index + 1}. ${timestamp} ${step.msg}${data}`;
+        })
+            .join("\n");
+    }
+    function formatPretty(entry) {
+        const color = COLORS[entry.lvl] || COLORS.reset;
+        const timestamp = new Date(entry.t)
+            .toISOString()
+            .replace("T", " ")
+            .replace("Z", "");
+        const lines = [];
+        lines.push(`${color}┌${COLORS.reset}`);
+        lines.push(`${color}│${COLORS.reset} ${COLORS.bright}${entry.lvl.toUpperCase()}${COLORS.reset} ${color}${timestamp}${COLORS.reset} ${COLORS.dim}pid:${entry.pid}${COLORS.reset}`);
+        for (const [key, value] of Object.entries(entry)) {
+            if (key === "t" || key === "lvl" || key === "pid")
+                continue;
+            if (key === "stack" && typeof value === "string") {
+                lines.push(`${color}│${COLORS.reset}   ${color}${key}${COLORS.reset}:`);
+                const stackLines = value.split("\n");
+                for (const stackLine of stackLines) {
+                    if (stackLine.trim()) {
+                        lines.push(`${color}│${COLORS.reset}     ${COLORS.dim}${stackLine.trim()}${COLORS.reset}`);
+                    }
+                }
+                continue;
+            }
+            if (value && typeof value === "object") {
+                lines.push(`${color}│${COLORS.reset}   ${color}${key}${COLORS.reset}:`);
+                const rendered = inspect(value, {
+                    depth: 8,
+                    colors: false,
+                    compact: false,
+                    breakLength: 100,
+                    sorted: true,
+                });
+                for (const line of rendered.split("\n")) {
+                    lines.push(`${color}│${COLORS.reset}     ${COLORS.dim}${line}${COLORS.reset}`);
+                }
+                continue;
+            }
+            lines.push(`${color}│${COLORS.reset}   ${color}${key}${COLORS.reset}: ${String(value)}`);
+        }
+        lines.push(`${color}└${COLORS.reset}`);
+        return lines.join("\n");
+    }
+    function enqueue(line) {
+        if (queue.length >= maxQueue) {
+            dropped++;
+            return;
+        }
+        queue.push(line);
+        scheduleFlush();
+    }
+    function scheduleFlush() {
+        if (!scheduled) {
+            scheduled = true;
+            setImmediate(flush);
+        }
+    }
+    function flush() {
+        scheduled = false;
+        if (queue.length === 0)
+            return;
+        const n = Math.min(batchSize, queue.length);
+        const chunk = queue.slice(0, n).join("\n") + "\n";
+        queue = queue.slice(n);
+        const ok = stream.write(chunk);
+        if (!ok) {
+            stream.once("drain", () => scheduleFlush());
+            return;
+        }
+        if (queue.length > 0)
+            scheduleFlush();
+    }
+    function log(lvl, msg, extra) {
+        if (!shouldLog(lvl))
+            return;
+        const entry = {
+            t: Date.now(),
+            lvl,
+            pid: process.pid,
+            msg,
+            ...(typeof extra === "object" && extra ? extra : null),
+            ...(typeof extra === "string" ? { extra: extra } : null),
+        };
+        if (lvl === "error" || lvl === "fatal") {
+            if (extra instanceof Error) {
+                entry.cause = extra.message;
+            }
+            else if (typeof extra === "string") {
+                entry.cause = extra;
+            }
+        }
+        if (lvl === "trace" || lvl === "error" || lvl === "fatal") {
+            const steps = getCurrentTraceSteps();
+            if (steps.length > 0) {
+                entry.stack = formatTraceStack(steps);
+            }
+        }
+        if (dropped) {
+            entry.dropped = dropped;
+            dropped = 0;
+        }
+        enqueue(prettify ? formatPretty(entry) : JSON.stringify(entry));
+    }
+    const api = {
+        withTraceScope: (fn) => traceStorage.run({ steps: [] }, fn),
+        addTrace: (msg, data) => {
+            const steps = getCurrentTraceSteps();
+            steps.push({ t: Date.now(), msg, data });
+            trimTraceSteps(steps);
+        },
+        clearTrace: () => {
+            const store = traceStorage.getStore();
+            if (store) {
+                store.steps = [];
+                return;
+            }
+            globalTraceSteps = [];
+        },
+        getTrace: () => [...getCurrentTraceSteps()],
+        trace: (a, b) => log("trace", a, b),
+        debug: (a, b) => log("debug", a, b),
+        info: (a, b) => log("info", a, b),
+        warn: (a, b) => log("warn", a, b),
+        error: (a, b) => log("error", a, b),
+        fatal: (a, b) => log("fatal", a, b),
+        flush: () => new Promise((res) => {
+            if (queue.length === 0)
+                return res();
+            // fuerza flush completo
+            const drainAll = () => {
+                if (queue.length === 0)
+                    return res();
+                scheduled = true;
+                flush();
+                if (queue.length === 0)
+                    return res();
+                // si hay backpressure, resuelve en drain
+                stream.once("drain", drainAll);
+            };
+            drainAll();
+        }),
+        close: async () => {
+            await api.flush();
+            if (stream !== process.stdout)
+                stream.end();
+        },
+    };
+    if (flushIntervalMs > 0) {
+        timer = setInterval(() => scheduleFlush(), flushIntervalMs);
+        timer.unref?.();
+    }
+    // Buen cierre
+    process.on("beforeExit", () => api.flush());
+    process.on("SIGTERM", async () => {
+        await api.close();
+        process.exit(0);
+    });
+    process.on("SIGINT", async () => {
+        await api.close();
+        process.exit(0);
+    });
+    _logger = api;
+    return api;
+}
+let _logger;
+export { _logger as Logger };
+//# sourceMappingURL=Logger.js.map

package/dist/esm/lib/Logger.js.map

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

package/dist/esm/lib/Permissions.d.ts

@@ -0,0 +1,7 @@
+import { ManagerUserSchema } from "../internal-content-types/ManagerUser";
+export declare const PermissionsList: readonly ["manager.users.readAny", "manager.users.updateAny", "manager.users.deleteAny", "manager.roles.readAny", "manager.roles.updateAny", "manager.roles.deleteAny", "manager.routes.readAny", "manager.routes.updateAny", "manager.routes.deleteAny", "manager.languages.readAny", "manager.languages.updateAny", "manager.languages.deleteAny", "content.Media.readAny", "content.Media.own", "content.Media.updateAny", "content.Media.deleteAny", "content.Redirect.readAny", "content.Redirect.own", "content.Redirect.updateAny", "content.Redirect.deleteAny", "manager.literals.readAny", "manager.literals.updateAny"];
+export type Permission = (typeof PermissionsList)[number];
+export declare const getPermissionList: () => string[];
+export declare const mapPermissions: (permissions: string[]) => Permission[];
+export declare const hasPermissions: (user: ManagerUserSchema, permissions: Permission[]) => boolean;
+//# sourceMappingURL=Permissions.d.ts.map

package/dist/esm/lib/Permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Permissions.d.ts","sourceRoot":"","sources":["../../../src/lib/Permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAgB1E,eAAO,MAAM,eAAe,omBASlB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB,QAAuC,MAAM,EAAE,CAAC;AAU9E,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE,KAAG,UAAU,EAKhE,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,MAAM,iBAAiB,EACvB,aAAa,UAAU,EAAE,YAe1B,CAAC"}

package/dist/esm/lib/Permissions.js

@@ -0,0 +1,48 @@
+const createContentPermission = (permission) => [
+    permission + ".readAny",
+    permission + ".own",
+    permission + ".updateAny",
+    permission + ".deleteAny",
+];
+const createManagerPermission = (permission) => [
+    permission + ".readAny",
+    permission + ".updateAny",
+    permission + ".deleteAny",
+];
+export const PermissionsList = [
+    ...createManagerPermission("manager.users"),
+    ...createManagerPermission("manager.roles"),
+    ...createManagerPermission("manager.routes"),
+    ...createManagerPermission("manager.languages"),
+    ...createContentPermission(`content.Media`),
+    ...createContentPermission(`content.Redirect`),
+    "manager.literals.readAny",
+    "manager.literals.updateAny",
+];
+export const getPermissionList = () => PermissionsList;
+const managerPermissionMap = {
+    "content.ManagerUser.own": ["manager.users.readAny"],
+    "content.ManagerRole.own": ["manager.roles.readAny"],
+    "content.ManagerRoute.own": ["manager.routes.readAny"],
+    "content.Language.own": ["manager.languages.readAny"],
+    "content.Language.readAny": ["manager.languages.readAny"],
+};
+export const mapPermissions = (permissions) => {
+    return permissions.flatMap((permission) => {
+        const mapped = managerPermissionMap[permission];
+        return mapped ? mapped : permission;
+    });
+};
+export const hasPermissions = (user, permissions) => {
+    const allPermissions = getPermissionList();
+    const mappedPermissions = mapPermissions(permissions);
+    for (const permission of mappedPermissions) {
+        if (!allPermissions.includes(permission)) {
+            return true;
+        }
+    }
+    return mappedPermissions.every((permission) => {
+        return user.role.permissions.includes(permission);
+    });
+};
+//# sourceMappingURL=Permissions.js.map

package/dist/esm/lib/Permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Permissions.js","sourceRoot":"","sources":["../../../src/lib/Permissions.ts"],"names":[],"mappings":"AAEA,MAAM,uBAAuB,GAAG,CAAmB,UAAa,EAAE,EAAE,CAClE;IACE,UAAU,GAAG,UAAU;IACvB,UAAU,GAAG,MAAM;IACnB,UAAU,GAAG,YAAY;IACzB,UAAU,GAAG,YAAY;CAC0C,CAAC;AACxE,MAAM,uBAAuB,GAAG,CAAmB,UAAa,EAAE,EAAE,CAClE;IACE,UAAU,GAAG,UAAU;IACvB,UAAU,GAAG,YAAY;IACzB,UAAU,GAAG,YAAY;CAC8B,CAAC;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,uBAAuB,CAAC,eAAe,CAAC;IAC3C,GAAG,uBAAuB,CAAC,eAAe,CAAC;IAC3C,GAAG,uBAAuB,CAAC,gBAAgB,CAAC;IAC5C,GAAG,uBAAuB,CAAC,mBAAmB,CAAC;IAC/C,GAAG,uBAAuB,CAAC,eAAe,CAAC;IAC3C,GAAG,uBAAuB,CAAC,kBAAkB,CAAC;IAC9C,0BAA0B;IAC1B,4BAA4B;CACpB,CAAC;AAIX,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,eAAsC,CAAC;AAE9E,MAAM,oBAAoB,GAAiC;IACzD,yBAAyB,EAAE,CAAC,uBAAuB,CAAC;IACpD,yBAAyB,EAAE,CAAC,uBAAuB,CAAC;IACpD,0BAA0B,EAAE,CAAC,wBAAwB,CAAC;IACtD,sBAAsB,EAAE,CAAC,2BAA2B,CAAC;IACrD,0BAA0B,EAAE,CAAC,2BAA2B,CAAC;CAC1D,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAqB,EAAgB,EAAE;IACpE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;QACxC,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IACtC,CAAC,CAAiB,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAuB,EACvB,WAAyB,EACzB,EAAE;IACF,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,MAAM,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAEtD,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;QAC3C,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/lib/Registry.d.ts

@@ -0,0 +1,12 @@
+import type ContentType from "./ContentType";
+import type { Field } from "./fields/Field";
+export declare function registerContentType(ct: ContentType): void;
+export declare function registerInternalContentType(ct: ContentType, options?: {
+    override?: boolean;
+}): void;
+export declare function getContentTypes(): ContentType<Record<string, Field<any, any, any, any, any, any>>, string>[];
+export declare function getContentTypesForManager(): ContentType<Record<string, Field<any, any, any, any, any, any>>, string>[];
+export declare function getInternalContentTypes(): ContentType<Record<string, Field<any, any, any, any, any, any>>, string>[];
+export declare function getExternalContentTypes(): ContentType<Record<string, Field<any, any, any, any, any, any>>, string>[];
+export declare function getContentTypeByName(name: string): ContentType<Record<string, Field<any, any, any, any, any, any>>, string>;
+//# sourceMappingURL=Registry.d.ts.map

package/dist/esm/lib/Registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../../../src/lib/Registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAQ5C,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,QAKlD;AAED,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,WAAW,EACf,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,QAMjC;AAED,wBAAgB,eAAe,+EAE9B;AAqDD,wBAAgB,yBAAyB,+EAIxC;AAED,wBAAgB,uBAAuB,+EAEtC;AAED,wBAAgB,uBAAuB,+EAEtC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,4EAEhD"}

package/dist/esm/lib/Registry.js

@@ -0,0 +1,83 @@
+import { ContentReferenceField } from "./fields/ContentReference";
+import { ListField } from "./fields/List";
+import { RelationField } from "./fields/Relation";
+import { SimpleListField } from "./fields/SimpleList";
+const registry = {};
+const internalRegistry = {};
+export function registerContentType(ct) {
+    if (registry[ct.name]) {
+        return;
+    }
+    registry[ct.name] = ct;
+}
+export function registerInternalContentType(ct, options) {
+    if (internalRegistry[ct.name] && !options?.override) {
+        return;
+    }
+    internalRegistry[ct.name] = ct;
+}
+export function getContentTypes() {
+    return Object.values(registry).concat(Object.values(internalRegistry));
+}
+const removeSchemaFromCT = (ct) => {
+    return {
+        ...ct,
+        fields: Object.fromEntries(Object.entries(ct.fields).map(([key, field]) => [
+            key,
+            removeSchemaFromField(field),
+        ])),
+    };
+};
+const removeSchemaFromField = (field) => {
+    if (field instanceof RelationField) {
+        return {
+            ...field,
+            schema: undefined,
+            contentType: removeSchemaFromCT(field.contentType),
+        };
+    }
+    if (field instanceof ContentReferenceField) {
+        const target = getContentTypeByName(field.contentType);
+        return {
+            ...field,
+            schema: undefined,
+            contentType: {
+                name: target?.name || field.contentType,
+                listFields: target?.listFields,
+            },
+        };
+    }
+    if (field instanceof ListField) {
+        return {
+            ...field,
+            schema: undefined,
+            fields: field.fields.map((f) => ({
+                name: f.name,
+                field: removeSchemaFromField(f.field),
+            })),
+        };
+    }
+    if (field instanceof SimpleListField) {
+        return {
+            ...field,
+            schema: undefined,
+            field: removeSchemaFromField(field.field),
+        };
+    }
+    return { ...field, schema: undefined };
+};
+export function getContentTypesForManager() {
+    return getContentTypes()
+        .map((ct) => removeSchemaFromCT(ct))
+        .filter((ct) => !ct.isHiddenFromManager);
+}
+export function getInternalContentTypes() {
+    return Object.values(internalRegistry);
+}
+export function getExternalContentTypes() {
+    return Object.values(registry);
+}
+export function getContentTypeByName(name) {
+    return registry[name] || internalRegistry[name];
+}
+//# sourceMappingURL=Registry.js.map

package/dist/esm/lib/Registry.js.map

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

package/dist/esm/lib/errors/AppError.d.ts

@@ -0,0 +1,12 @@
+import { type AppErrorShape, type ErrorCause, type ErrorKey } from "./errors";
+export declare class AppError<K extends ErrorKey = ErrorKey> extends Error {
+    readonly appError: Extract<AppErrorShape, {
+        key: K;
+    }>;
+    readonly statusCode: number;
+    constructor(key: K, cause: ErrorCause<K>);
+}
+export declare const isAppError: (error: unknown) => error is AppError;
+export declare const getAppErrorShape: (error: unknown) => AppErrorShape | null;
+export declare const getAppErrorStatusCode: (error: unknown) => number | null;
+//# sourceMappingURL=AppError.d.ts.map

package/dist/esm/lib/errors/AppError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppError.d.ts","sourceRoot":"","sources":["../../../../src/lib/errors/AppError.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,UAAU,EACf,KAAK,QAAQ,EAEd,MAAM,UAAU,CAAC;AAElB,qBAAa,QAAQ,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,KAAK;IAChE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,GAAG,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;CAMzC;AAED,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,QAEpD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,aAAa,GAAG,IAUjE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,IAQ/D,CAAC"}

package/dist/esm/lib/errors/AppError.js

@@ -0,0 +1,29 @@
+import { ErrorCatalog, instanceofAppErrorShape, } from "./errors";
+export class AppError extends Error {
+    constructor(key, cause) {
+        super(key);
+        this.name = "AppError";
+        this.appError = { key, cause };
+        this.statusCode = ErrorCatalog[key].code;
+    }
+}
+export const isAppError = (error) => {
+    return error instanceof AppError;
+};
+export const getAppErrorShape = (error) => {
+    if (error instanceof AppError) {
+        return error.appError;
+    }
+    if (instanceofAppErrorShape(error)) {
+        return error;
+    }
+    return null;
+};
+export const getAppErrorStatusCode = (error) => {
+    const appError = getAppErrorShape(error);
+    if (!appError) {
+        return null;
+    }
+    return ErrorCatalog[appError.key].code;
+};
+//# sourceMappingURL=AppError.js.map

package/dist/esm/lib/errors/AppError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppError.js","sourceRoot":"","sources":["../../../../src/lib/errors/AppError.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAGZ,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAElB,MAAM,OAAO,QAAwC,SAAQ,KAAK;IAIhE,YAAY,GAAM,EAAE,KAAoB;QACtC,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,EAAE,KAAK,EAAwC,CAAC;QACrE,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE;IAC9D,OAAO,KAAK,YAAY,QAAQ,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAwB,EAAE;IACvE,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,IAAI,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAAiB,EAAE;IACrE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC,CAAC"}

package/dist/esm/lib/errors/errors.d.ts

@@ -0,0 +1,64 @@
+import { z } from "zod";
+export declare const ErrorCatalog: {
+    readonly AUTH_REQUIRED: {
+        readonly trpcCode: "UNAUTHORIZED";
+        readonly cause: z.ZodObject<{}, z.core.$strip>;
+        readonly code: 401;
+    };
+    readonly FORBIDDEN: {
+        readonly trpcCode: "FORBIDDEN";
+        readonly cause: z.ZodObject<{
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly code: 403;
+    };
+    readonly NOT_FOUND: {
+        readonly trpcCode: "NOT_FOUND";
+        readonly cause: z.ZodObject<{
+            resource: z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly code: 404;
+    };
+    readonly VALIDATION: {
+        readonly trpcCode: "BAD_REQUEST";
+        readonly cause: z.ZodObject<{
+            errors: z.ZodAny;
+        }, z.core.$strip>;
+        readonly code: 400;
+    };
+    readonly CONFLICT: {
+        readonly trpcCode: "CONFLICT";
+        readonly cause: z.ZodObject<{
+            key: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly code: 409;
+    };
+    readonly INTERNAL: {
+        readonly trpcCode: "INTERNAL_SERVER_ERROR";
+        readonly cause: z.ZodObject<{
+            traceId: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly code: 500;
+    };
+    readonly FEATURE_UNSUPPORTED: {
+        readonly trpcCode: "BAD_REQUEST";
+        readonly cause: z.ZodObject<{
+            feature: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly code: 400;
+    };
+};
+export type ErrorKey = keyof typeof ErrorCatalog;
+export type ErrorCause<K extends ErrorKey> = z.infer<(typeof ErrorCatalog)[K]["cause"]>;
+export type AppErrorShape = {
+    [K in ErrorKey]: {
+        key: K;
+        cause: ErrorCause<K>;
+    };
+}[ErrorKey];
+export declare const instanceofAppErrorShape: (error: unknown) => error is AppErrorShape;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/lib/errors/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/lib/errors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDf,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,YAAY,CAAC;AAEjD,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,CAAC,KAAK,CAClD,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAClC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;KACzB,CAAC,IAAI,QAAQ,GAAG;QAAE,GAAG,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;KAAE;CAClD,CAAC,QAAQ,CAAC,CAAC;AAEZ,eAAO,MAAM,uBAAuB,GAClC,OAAO,OAAO,KACb,KAAK,IAAI,aAQX,CAAC"}

package/dist/esm/lib/errors/errors.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+export const ErrorCatalog = {
+    AUTH_REQUIRED: {
+        trpcCode: "UNAUTHORIZED",
+        cause: z.object({}),
+        code: 401,
+    },
+    FORBIDDEN: {
+        trpcCode: "FORBIDDEN",
+        cause: z.object({ reason: z.string().optional() }),
+        code: 403,
+    },
+    NOT_FOUND: {
+        trpcCode: "NOT_FOUND",
+        cause: z.object({
+            resource: z.string().optional(),
+            id: z.string().optional(),
+        }),
+        code: 404,
+    },
+    VALIDATION: {
+        trpcCode: "BAD_REQUEST",
+        cause: z.object({
+            errors: z.any(),
+        }),
+        code: 400,
+    },
+    CONFLICT: {
+        trpcCode: "CONFLICT",
+        cause: z.object({
+            key: z.string().optional(),
+            message: z.string().optional(),
+        }),
+        code: 409,
+    },
+    INTERNAL: {
+        trpcCode: "INTERNAL_SERVER_ERROR",
+        cause: z.object({
+            traceId: z.string().optional(),
+            message: z.string().optional(),
+        }),
+        code: 500,
+    },
+    FEATURE_UNSUPPORTED: {
+        trpcCode: "BAD_REQUEST",
+        cause: z.object({
+            feature: z.string().optional(),
+            message: z.string().optional(),
+        }),
+        code: 400,
+    },
+};
+export const instanceofAppErrorShape = (error) => {
+    return (typeof error === "object" &&
+        error !== null &&
+        "key" in error &&
+        typeof error.key === "string" &&
+        error.key in ErrorCatalog);
+};
+//# sourceMappingURL=errors.js.map

package/dist/esm/lib/errors/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/lib/errors/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa,EAAE;QACb,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,IAAI,EAAE,GAAG;KACV;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClD,IAAI,EAAE,GAAG;KACV;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,CAAC;QACF,IAAI,EAAE,GAAG;KACV;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,aAAa;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;SAChB,CAAC;QACF,IAAI,EAAE,GAAG;KACV;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;QACF,IAAI,EAAE,GAAG;KACV;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,uBAAuB;QACjC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;QACF,IAAI,EAAE,GAAG;KACV;IACD,mBAAmB,EAAE;QACnB,QAAQ,EAAE,aAAa;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B,CAAC;QACF,IAAI,EAAE,GAAG;KACV;CACO,CAAC;AAYX,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,KAAc,EACU,EAAE;IAC1B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,IAAI,KAAK;QACd,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,KAAK,CAAC,GAAG,IAAI,YAAY,CAC1B,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/lib/errors/index.d.ts

@@ -0,0 +1,5 @@
+export { ErrorCatalog } from './errors';
+export { throwAppError } from './throwAppError';
+export { AppError, isAppError, getAppErrorShape, getAppErrorStatusCode, } from './AppError';
+export type { ErrorKey, ErrorCause, AppErrorShape } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/lib/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA"}

package/dist/esm/lib/errors/index.js

@@ -0,0 +1,4 @@
+export { ErrorCatalog } from './errors';
+export { throwAppError } from './throwAppError';
+export { AppError, isAppError, getAppErrorShape, getAppErrorStatusCode, } from './AppError';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EACL,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,YAAY,CAAA"}

package/dist/esm/lib/errors/throwAppError.d.ts

@@ -0,0 +1,3 @@
+import { type ErrorKey, type ErrorCause } from "./errors";
+export declare function throwAppError<K extends ErrorKey>(key: K, cause?: ErrorCause<K>): never;
+//# sourceMappingURL=throwAppError.d.ts.map

package/dist/esm/lib/errors/throwAppError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throwAppError.d.ts","sourceRoot":"","sources":["../../../../src/lib/errors/throwAppError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAExE,wBAAgB,aAAa,CAAC,CAAC,SAAS,QAAQ,EAC9C,GAAG,EAAE,CAAC,EACN,KAAK,GAAE,UAAU,CAAC,CAAC,CAAuB,GACzC,KAAK,CAeP"}