@jakubmazanec/error 3.0.15 → 3.0.16-unstable.2468857d

package/build/constants.js

@@ -1,7 +1,10 @@
-"use strict";
-export const ERROR_MESSAGE_TOKEN_PATTERN = /\{(\d+)\}/gu;
-export const UNKNOWN_ERROR = "UNKNOWN_ERROR";
-export const INTERNAL_ERROR_MESSAGES = {
-  [UNKNOWN_ERROR]: "An unknown error has occurred."
-};
-//# sourceMappingURL=constants.js.map
+//#region source/constants.ts
+const ERROR_MESSAGE_TOKEN_PATTERN = /\{(\d+)\}/gu;
+/**
+* Code for an unknown error. You should never use nor encounter this error code.
+*/
+const UNKNOWN_ERROR = "UNKNOWN_ERROR";
+const INTERNAL_ERROR_MESSAGES = { [UNKNOWN_ERROR]: "An unknown error has occurred." };
+
+//#endregion
+export { ERROR_MESSAGE_TOKEN_PATTERN, INTERNAL_ERROR_MESSAGES, UNKNOWN_ERROR };

package/build/createCustomError.js

@@ -1,23 +1,32 @@
-"use strict";
 import { INTERNAL_ERROR_MESSAGES, UNKNOWN_ERROR } from "./constants.js";
-import { createErrorMessage } from "./internals.js";
-export function createCustomError(errorName, errorMessages) {
-  return class InternalCustomError extends Error {
-    code;
-    constructor(errorCode, options) {
-      let errorMessage = createErrorMessage(errorCode, errorMessages, options?.messageParameters);
-      let errorOptions = {};
-      if (options?.cause !== void 0) {
-        errorOptions.cause = options.cause;
-      }
-      super(errorMessage, errorOptions);
-      this.code = errorCode;
-      this.name = errorName;
-      if (!this.message) {
-        this.code = UNKNOWN_ERROR;
-        this.message = createErrorMessage(UNKNOWN_ERROR, INTERNAL_ERROR_MESSAGES);
-      }
-    }
-  };
+import { createErrorMessage } from "./internals/createErrorMessage.js";
+
+//#region source/createCustomError.ts
+/**
+* Function for creating custom error classes. Such custom error class properly subclasses built-in `Error` and simplifies
+* generating error messages via predefined error codes.
+*
+* @param errorName Error name.
+* @param errorMessages Object containing all possible error messages.
+* @return Class that implements {@link CustomError}.
+*/
+function createCustomError(errorName, errorMessages) {
+	return class InternalCustomError extends Error {
+		code;
+		constructor(errorCode, options) {
+			let errorMessage = createErrorMessage(errorCode, errorMessages, options?.messageParameters);
+			let errorOptions = {};
+			if (options?.cause !== void 0) errorOptions.cause = options.cause;
+			super(errorMessage, errorOptions);
+			this.code = errorCode;
+			this.name = errorName;
+			if (!this.message) {
+				this.code = UNKNOWN_ERROR;
+				this.message = createErrorMessage(UNKNOWN_ERROR, INTERNAL_ERROR_MESSAGES);
+			}
+		}
+	};
 }
-//# sourceMappingURL=createCustomError.js.map
+
+//#endregion
+export { createCustomError };

package/build/createCustomErrorWithData.js

@@ -1,27 +1,26 @@
-"use strict";
 import { INTERNAL_ERROR_MESSAGES, UNKNOWN_ERROR } from "./constants.js";
-import { createErrorMessage } from "./internals.js";
-export function createCustomErrorWithData(errorName, errorMessages, errorData) {
-  return class InternalCustomError extends Error {
-    code;
-    data;
-    constructor(errorCode, options) {
-      let errorMessage = createErrorMessage(errorCode, errorMessages, options?.messageParameters);
-      let errorOptions = {};
-      if (options?.cause !== void 0) {
-        errorOptions.cause = options.cause;
-      }
-      super(errorMessage, errorOptions);
-      this.code = errorCode;
-      this.name = errorName;
-      if (options?.data !== void 0) {
-        this.data = options.data;
-      }
-      if (!this.message) {
-        this.code = UNKNOWN_ERROR;
-        this.message = createErrorMessage(UNKNOWN_ERROR, INTERNAL_ERROR_MESSAGES);
-      }
-    }
-  };
+import { createErrorMessage } from "./internals/createErrorMessage.js";
+
+//#region source/createCustomErrorWithData.ts
+function createCustomErrorWithData(errorName, errorMessages, errorData) {
+	return class InternalCustomError extends Error {
+		code;
+		data;
+		constructor(errorCode, options) {
+			let errorMessage = createErrorMessage(errorCode, errorMessages, options?.messageParameters);
+			let errorOptions = {};
+			if (options?.cause !== void 0) errorOptions.cause = options.cause;
+			super(errorMessage, errorOptions);
+			this.code = errorCode;
+			this.name = errorName;
+			if (options?.data !== void 0) this.data = options.data;
+			if (!this.message) {
+				this.code = UNKNOWN_ERROR;
+				this.message = createErrorMessage(UNKNOWN_ERROR, INTERNAL_ERROR_MESSAGES);
+			}
+		}
+	};
 }
-//# sourceMappingURL=createCustomErrorWithData.js.map
+
+//#endregion
+export { createCustomErrorWithData };

package/build/internals/createErrorMessage.js

@@ -1,13 +1,19 @@
-"use strict";
 import { ERROR_MESSAGE_TOKEN_PATTERN } from "../constants.js";
-export function createErrorMessage(errorCode, errorMessages, messageParameters = []) {
-  let errorMessage = errorMessages[errorCode];
-  if (!errorMessage) {
-    return "";
-  }
-  return `${errorCode}: ${errorMessage.replace(
-    ERROR_MESSAGE_TOKEN_PATTERN,
-    (match, index) => String(messageParameters[index])
-  )}`;
+
+//#region source/internals/createErrorMessage.ts
+/**
+* A function that generates an error message based on provided error code and message parameters. It is used only internally.
+*
+* @param errorCode Error code.
+* @param errorMessages Object containing all possible error messages.
+* @param messageParameters Array of values that are used as message parameters.
+* @return Error message.
+*/
+function createErrorMessage(errorCode, errorMessages, messageParameters = []) {
+	let errorMessage = errorMessages[errorCode];
+	if (!errorMessage) return "";
+	return `${errorCode}: ${errorMessage.replace(ERROR_MESSAGE_TOKEN_PATTERN, (match, index) => String(messageParameters[index]))}`;
 }
-//# sourceMappingURL=createErrorMessage.js.map
+
+//#endregion
+export { createErrorMessage };

package/build/main.js

@@ -1,5 +1,5 @@
-"use strict";
-export { UNKNOWN_ERROR } from "./constants.js";
-export * from "./createCustomError.js";
-export * from "./createCustomErrorWithData.js";
-//# sourceMappingURL=main.js.map
+import { UNKNOWN_ERROR } from "./constants.js";
+import { createCustomError } from "./createCustomError.js";
+import { createCustomErrorWithData } from "./createCustomErrorWithData.js";
+
+export { UNKNOWN_ERROR, createCustomError, createCustomErrorWithData };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakubmazanec/error",
-  "version": "3.0.15",
+  "version": "3.0.16-unstable.2468857d",
   "description": "Collection of utilities for creating and handling errors.",
   "repository": {
     "type": "git",
@@ -17,9 +17,9 @@
     "source"
   ],
   "scripts": {
-    "build": "del-cli build tsconfig.tsbuildinfo && esbuild \"source/**/*\" --platform=node --target=node24.3 --outdir=build --sourcemap && tsc",
+    "build": "del-cli build tsconfig.tsbuildinfo && tsdown && tsc",
     "clean": "del-cli coverage build *.tsbuildinfo",
-    "develop": "concurrently \"esbuild \"source/**/*\" --platform=node --target=node24.3 --outdir=build --sourcemap --watch\" \"tsc --watch\"",
+    "develop": "concurrently \"tsdown --watch\" \"tsc --watch\"",
     "document": "del-cli docs && typedoc --options typedoc.config.cjs",
     "format": "prettier . --write --ignore-unknown",
     "lint": "eslint .",
@@ -30,17 +30,17 @@
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@jakubmazanec/eslint-config": "^4.1.0",
+    "@jakubmazanec/eslint-config": "4.1.10-unstable.2468857d",
     "@types/lodash": "^4.17.21",
     "@types/node": "^24.0.4",
     "@vitest/coverage-v8": "^3.2.4",
     "concurrently": "^9.2.1",
     "del-cli": "^6.0.0",
-    "esbuild": "^0.27.0",
     "eslint": "^9.33.0",
     "lodash": "^4.17.21",
     "prettier": "^3.6.2",
     "prettier-plugin-packagejson": "^2.5.19",
+    "tsdown": "^0.17.2",
     "typedoc": "^0.28.14",
     "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.9.3",

package/build/constants.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/constants.ts"],
-  "sourcesContent": ["export const ERROR_MESSAGE_TOKEN_PATTERN = /\\{(\\d+)\\}/gu;\n\n/**\n * Code for an unknown error. You should never use nor encounter this error code.\n */\nexport const UNKNOWN_ERROR = 'UNKNOWN_ERROR';\n\nexport const INTERNAL_ERROR_MESSAGES = {\n  [UNKNOWN_ERROR]: 'An unknown error has occurred.',\n};\n"],
-  "mappings": ";AAAO,aAAM,8BAA8B;AAKpC,aAAM,gBAAgB;AAEtB,aAAM,0BAA0B;AAAA,EACrC,CAAC,aAAa,GAAG;AACnB;",
-  "names": []
-}

package/build/createCustomError.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/createCustomError.ts"],
-  "sourcesContent": ["import {INTERNAL_ERROR_MESSAGES, UNKNOWN_ERROR} from './constants.js';\nimport {createErrorMessage} from './internals.js';\nimport {type CustomError, type CustomErrorOptions, type ErrorMessages} from './types.js';\n\n/**\n * Function for creating custom error classes. Such custom error class properly subclasses built-in `Error` and simplifies\n * generating error messages via predefined error codes.\n *\n * @param errorName Error name.\n * @param errorMessages Object containing all possible error messages.\n * @return Class that implements {@link CustomError}.\n */\nexport function createCustomError<ErrorCode extends string>(\n  errorName: string,\n  errorMessages: ErrorMessages<ErrorCode>,\n): new (\n  code: ErrorCode,\n  options?: CustomErrorOptions,\n) => CustomError<ErrorCode | typeof UNKNOWN_ERROR> {\n  return class InternalCustomError extends Error implements CustomError<ErrorCode> {\n    code: ErrorCode | typeof UNKNOWN_ERROR;\n\n    constructor(errorCode: ErrorCode, options?: CustomErrorOptions) {\n      let errorMessage = createErrorMessage(errorCode, errorMessages, options?.messageParameters);\n      let errorOptions: ErrorOptions = {};\n\n      if (options?.cause !== undefined) {\n        errorOptions.cause = options.cause;\n      }\n\n      super(errorMessage, errorOptions);\n\n      this.code = errorCode;\n      this.name = errorName;\n\n      // if the message is empty, we are making this an unknown error\n      if (!this.message) {\n        this.code = UNKNOWN_ERROR;\n        this.message = createErrorMessage(UNKNOWN_ERROR, INTERNAL_ERROR_MESSAGES);\n      }\n    }\n  };\n}\n"],
-  "mappings": ";AAAA,SAAQ,yBAAyB,qBAAoB;AACrD,SAAQ,0BAAyB;AAW1B,gBAAS,kBACd,WACA,eAIiD;AACjD,SAAO,MAAM,4BAA4B,MAAwC;AAAA,IAC/E;AAAA,IAEA,YAAY,WAAsB,SAA8B;AAC9D,UAAI,eAAe,mBAAmB,WAAW,eAAe,SAAS,iBAAiB;AAC1F,UAAI,eAA6B,CAAC;AAElC,UAAI,SAAS,UAAU,QAAW;AAChC,qBAAa,QAAQ,QAAQ;AAAA,MAC/B;AAEA,YAAM,cAAc,YAAY;AAEhC,WAAK,OAAO;AACZ,WAAK,OAAO;AAGZ,UAAI,CAAC,KAAK,SAAS;AACjB,aAAK,OAAO;AACZ,aAAK,UAAU,mBAAmB,eAAe,uBAAuB;AAAA,MAC1E;AAAA,IACF;AAAA,EACF;AACF;",
-  "names": []
-}

package/build/createCustomErrorWithData.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/createCustomErrorWithData.ts"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any -- needed */\nimport {type z, type ZodObject} from 'zod';\n\nimport {INTERNAL_ERROR_MESSAGES, UNKNOWN_ERROR} from './constants.js';\nimport {createErrorMessage} from './internals.js';\nimport {\n  type CustomErrorWithData,\n  type CustomErrorWithDataOptions,\n  type ErrorMessages,\n} from './types.js';\n\n/**\n * Function for creating custom error classes. Such custom error class properly subclasses built-in `Error`, simplifies\n * generating error messages via predefined error codes and allows attaching custom data to the error instance.\n *\n * @param errorName Error name.\n * @param errorMessages Object containing all possible error messages.\n * @param errorData Runtime representation of the `ErrorData` type parameter; can be either a class expression, or a Zod schema.\n * @return Class that implements {@link CustomErrorWithData}.\n */\nexport function createCustomErrorWithData<ErrorCode extends string, ErrorData extends ZodObject>(\n  errorName: string,\n  errorMessages: ErrorMessages<ErrorCode>,\n  errorData: ErrorData,\n): new (\n  code: ErrorCode,\n  options?: CustomErrorWithDataOptions<z.infer<ErrorData>>,\n) => CustomErrorWithData<ErrorCode | typeof UNKNOWN_ERROR, z.infer<ErrorData>>;\nexport function createCustomErrorWithData<\n  ErrorCode extends string,\n  ErrorData extends abstract new (...args: any) => any,\n>(\n  errorName: string,\n  errorMessages: ErrorMessages<ErrorCode>,\n  errorData: ErrorData,\n): new (\n  code: ErrorCode,\n  options?: CustomErrorWithDataOptions<InstanceType<ErrorData>>,\n) => CustomErrorWithData<ErrorCode | typeof UNKNOWN_ERROR, InstanceType<ErrorData>>;\nexport function createCustomErrorWithData<ErrorCode extends string, ErrorData>(\n  errorName: string,\n  errorMessages: ErrorMessages<ErrorCode>,\n  errorData: ErrorData,\n): new (\n  code: ErrorCode,\n  options?: CustomErrorWithDataOptions<ErrorData>,\n) => CustomErrorWithData<ErrorCode | typeof UNKNOWN_ERROR, ErrorData> {\n  return class InternalCustomError\n    extends Error\n    implements CustomErrorWithData<ErrorCode, ErrorData>\n  {\n    code: ErrorCode | typeof UNKNOWN_ERROR;\n    data?: ErrorData;\n\n    constructor(errorCode: ErrorCode, options?: CustomErrorWithDataOptions<ErrorData>) {\n      let errorMessage = createErrorMessage(errorCode, errorMessages, options?.messageParameters);\n      let errorOptions: ErrorOptions = {};\n\n      if (options?.cause !== undefined) {\n        errorOptions.cause = options.cause;\n      }\n\n      super(errorMessage, errorOptions);\n\n      this.code = errorCode;\n      this.name = errorName;\n\n      if (options?.data !== undefined) {\n        this.data = options.data;\n      }\n\n      // if the message is empty, we are making this an unknown error\n      if (!this.message) {\n        this.code = UNKNOWN_ERROR;\n        this.message = createErrorMessage(UNKNOWN_ERROR, INTERNAL_ERROR_MESSAGES);\n      }\n    }\n  };\n}\n"],
-  "mappings": ";AAGA,SAAQ,yBAAyB,qBAAoB;AACrD,SAAQ,0BAAyB;AAmC1B,gBAAS,0BACd,WACA,eACA,WAIoE;AACpE,SAAO,MAAM,4BACH,MAEV;AAAA,IACE;AAAA,IACA;AAAA,IAEA,YAAY,WAAsB,SAAiD;AACjF,UAAI,eAAe,mBAAmB,WAAW,eAAe,SAAS,iBAAiB;AAC1F,UAAI,eAA6B,CAAC;AAElC,UAAI,SAAS,UAAU,QAAW;AAChC,qBAAa,QAAQ,QAAQ;AAAA,MAC/B;AAEA,YAAM,cAAc,YAAY;AAEhC,WAAK,OAAO;AACZ,WAAK,OAAO;AAEZ,UAAI,SAAS,SAAS,QAAW;AAC/B,aAAK,OAAO,QAAQ;AAAA,MACtB;AAGA,UAAI,CAAC,KAAK,SAAS;AACjB,aAAK,OAAO;AACZ,aAAK,UAAU,mBAAmB,eAAe,uBAAuB;AAAA,MAC1E;AAAA,IACF;AAAA,EACF;AACF;",
-  "names": []
-}

package/build/internals/createErrorMessage.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../source/internals/createErrorMessage.ts"],
-  "sourcesContent": ["import {ERROR_MESSAGE_TOKEN_PATTERN} from '../constants.js';\nimport {type ErrorMessages} from '../types.js';\n\n/**\n * A function that generates an error message based on provided error code and message parameters. It is used only internally.\n *\n * @param errorCode Error code.\n * @param errorMessages Object containing all possible error messages.\n * @param messageParameters Array of values that are used as message parameters.\n * @return Error message.\n */\nexport function createErrorMessage<T extends string>(\n  errorCode: T,\n  errorMessages: ErrorMessages<T>,\n  messageParameters: unknown[] = [],\n): string {\n  let errorMessage = errorMessages[errorCode];\n\n  if (!errorMessage) {\n    return '';\n  }\n\n  return `${errorCode}: ${errorMessage.replace(\n    ERROR_MESSAGE_TOKEN_PATTERN,\n    (match: string, index: number) => String(messageParameters[index]),\n  )}`;\n}\n"],
-  "mappings": ";AAAA,SAAQ,mCAAkC;AAWnC,gBAAS,mBACd,WACA,eACA,oBAA+B,CAAC,GACxB;AACR,MAAI,eAAe,cAAc,SAAS;AAE1C,MAAI,CAAC,cAAc;AACjB,WAAO;AAAA,EACT;AAEA,SAAO,GAAG,SAAS,KAAK,aAAa;AAAA,IACnC;AAAA,IACA,CAAC,OAAe,UAAkB,OAAO,kBAAkB,KAAK,CAAC;AAAA,EACnE,CAAC;AACH;",
-  "names": []
-}

package/build/internals.js

@@ -1,3 +0,0 @@
-"use strict";
-export * from "./internals/createErrorMessage.js";
-//# sourceMappingURL=internals.js.map

package/build/internals.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/internals.ts"],
-  "sourcesContent": ["export * from './internals/createErrorMessage.js';\n"],
-  "mappings": ";AAAA,cAAc;",
-  "names": []
-}

package/build/main.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../source/main.ts"],
-  "sourcesContent": ["export {UNKNOWN_ERROR} from './constants.js';\nexport * from './createCustomError.js';\nexport * from './createCustomErrorWithData.js';\nexport type * from './types.js';\n"],
-  "mappings": ";AAAA,SAAQ,qBAAoB;AAC5B,cAAc;AACd,cAAc;",
-  "names": []
-}

package/build/types/CustomError.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=CustomError.js.map

package/build/types/CustomError.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/types/CustomErrorOptions.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=CustomErrorOptions.js.map

package/build/types/CustomErrorOptions.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/types/CustomErrorWithData.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=CustomErrorWithData.js.map

package/build/types/CustomErrorWithData.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/types/CustomErrorWithDataOptions.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=CustomErrorWithDataOptions.js.map

package/build/types/CustomErrorWithDataOptions.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/types/ErrorMessages.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=ErrorMessages.js.map

package/build/types/ErrorMessages.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}

package/build/types.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}