emessages 1.0.0 → 2.0.0

package/README.md

@@ -0,0 +1,145 @@
+# emessages
+
+A simple and flexible error messaging utility for JavaScript and TypeScript applications. Works in both Node.js and the browser, supporting CJS and ESM modules.
+
+## Features
+
+-   **Flexible Configuration**: Define error messages with custom behaviors.
+-   **Global & Local Scope**: Set global messages for your entire application and override them with local messages in specific files.
+-   **Multiple Actions**: Show console messages (`log`, `warn`, `error`), halt execution, show browser toasts, return the message, and run callbacks.
+-   **TypeScript Ready**: Fully typed for a great developer experience.
+-   **Isomorphic**: Works on both frontend and backend.
+
+## Installation
+
+```bash
+npm install emessages
+```
+
+## Quick Start
+
+### 1. Basic Usage
+
+In your JavaScript or TypeScript file:
+
+```javascript
+import { Emessage, showE } from "emessages";
+
+// Define a local error message
+Emessage({
+  GREETING_ERROR: "Cannot greet a user without a name.",
+  type: "war",
+  break: false, // Don't stop the code
+});
+
+function greet(name) {
+  if (!name) {
+    showE("GREETING_ERROR");
+    return;
+  }
+  console.log(`Hello, ${name}!`);
+}
+
+greet(); // outputs a warning
+greet("World"); // outputs: "Hello, World!"
+```
+
+### 2. Global Messages (Optional)
+
+To define messages that are accessible throughout your project, create a file (e.g., `globalMessages.ts`) and import it once in your application's entry point.
+
+**`globalMessages.ts`**
+```javascript
+import { Emessage } from "emessages";
+
+// Use Emessage.global to define messages available everywhere
+Emessage.global(
+  {
+    NAME_NOT_FOUND: "Name is required.",
+    type: "err",
+    break: false,
+  },
+  {
+    UNAUTHORIZED: "User is not authorized.",
+    type: "err",
+    tost: true,
+  }
+);
+```
+
+**`index.ts` (Your app's entry point)**
+```javascript
+import "./globalMessages";
+// ... rest of your app
+```
+
+**Priority**: Messages defined with `Emessage` (local) will always take priority over messages defined with `Emessage.global`.
+
+### 3. Toast Notifications (Browser)
+
+To use toast notifications, you must import the provided CSS file in your application.
+
+```javascript
+// Example in a React/Vue/Svelte entry file
+import "emessages/dist/emessages.css";
+```
+
+Then, use the `tost` option:
+
+```javascript
+Emessage({
+  STYLE_ERROR: "This will be a toast.",
+  type: "log", // It can be any type
+  tost: true, // Enable toast
+  break: false,
+});
+
+showE("STYLE_ERROR");
+```
+
+You can also customize the toast:
+
+```javascript
+showE({
+  CUSTOM_TOAST: "A custom toast!",
+  tost: {
+    message: "This message overrides the default.",
+    style: "text-yellow-400 text-base", // Custom CSS classes
+    position: "bottom-left",
+  },
+  break: false,
+});
+```
+
+## API Reference
+
+### `Emessage(...configs)`
+
+Defines one or more local error messages.
+
+### `Emessage.global(...configs)`
+
+Defines one or more global error messages.
+
+### Config Object
+
+Each config object passed to `Emessage` has one error name/message and a set of optional properties:
+
+-   `[errorName: string]: string`: The name of the error and its message.
+-   `type?`: `"log" | "war" | "err"`. The console method to use. **Default**: `"err"`.
+-   `break?`: `boolean`. If `true`, stops execution (throws in browser, `process.exit(1)` in Node.js). **Default**: `true`.
+-   `tost?`: `boolean | TostConfig`. If `true`, shows a toast. Can be an object for customization.
+-   `returnEM?`: `boolean`. If `true`, `showE` will return the error message as a string.
+-   `callBack?`: `() => void`. A function to execute.
+
+**`TostConfig` Object**
+-   `message?`: `string`. A different message for the toast.
+-   `style?`: `string`. Custom CSS classes to apply.
+-   `position?`: `string`. e.g., `"top-right"`, `"bottom-left"`, `"center"`.
+
+### `showE(errorName | config)`
+
+Triggers an error.
+
+-   `errorName: string`: The name of the pre-configured error to show. `showE` will look for a local definition first, then a global one.
+-   `config: object`: An inline config object for a one-off error message.

package/dist/index.cjs

@@ -0,0 +1,180 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Emessage: () => Emessage,
+  showE: () => showE
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/store.ts
+var individualMessageStore = /* @__PURE__ */ new Map();
+var globalMessageStore = /* @__PURE__ */ new Map();
+
+// src/utils.ts
+function isBrowser() {
+  return typeof window !== "undefined" && typeof window.document !== "undefined";
+}
+function showToast(message, tostConfig) {
+  if (!isBrowser()) {
+    return;
+  }
+  const toast = document.createElement("div");
+  const config = typeof tostConfig === "object" ? tostConfig : {};
+  toast.textContent = config.message || message;
+  toast.className = "emessage-toast";
+  if (config.style) {
+    toast.classList.add(...config.style.split(" "));
+  }
+  const position = config.position || "top-right";
+  toast.setAttribute("data-position", position);
+  document.body.appendChild(toast);
+  setTimeout(() => {
+    toast.classList.add("visible");
+  }, 10);
+  setTimeout(() => {
+    toast.classList.remove("visible");
+    toast.addEventListener("transitionend", () => {
+      if (toast.parentElement) {
+        toast.parentElement.removeChild(toast);
+      }
+    });
+  }, 3e3);
+}
+
+// src/index.ts
+function parseConfig(config) {
+  const options = {};
+  let message = null;
+  let name = null;
+  const optionKeys = ["type", "break", "tost", "returnEM", "callBack"];
+  for (const key in config) {
+    if (Object.prototype.hasOwnProperty.call(config, key)) {
+      if (optionKeys.includes(key)) {
+        options[key] = config[key];
+      } else {
+        if (name !== null) {
+          console.warn(
+            `emessages: Found multiple potential error names in one config object. Using first one found: "${name}".`
+          );
+          continue;
+        }
+        name = key;
+        message = String(config[key]);
+      }
+    }
+  }
+  if (name === null || message === null) {
+    console.error(
+      "emessages: Invalid config object. Could not find error name and message.",
+      config
+    );
+    return null;
+  }
+  return { name, options: { ...options, message } };
+}
+function processEmessage(errorName, config) {
+  const message = config.message;
+  const type = config.type ?? "err";
+  switch (type) {
+    case "log":
+      console.log(message);
+      break;
+    case "war":
+      console.warn(message);
+      break;
+    case "err":
+      console.error(message);
+      break;
+  }
+  if (config.tost && isBrowser()) {
+    showToast(message, config.tost);
+  }
+  if (config.callBack) {
+    try {
+      config.callBack();
+    } catch (e) {
+      console.error(
+        `emessages: Error in callBack for "${errorName}":`,
+        e.message
+      );
+    }
+  }
+  if (config.returnEM) {
+    return message;
+  }
+  if (config.break ?? true) {
+    if (isBrowser()) {
+      throw new Error(message);
+    } else {
+      process.exit(1);
+    }
+  }
+}
+function Emessage(...configs) {
+  for (const config of configs) {
+    const parsed = parseConfig(config);
+    if (parsed) {
+      individualMessageStore.set(parsed.name, parsed.options);
+    }
+  }
+}
+Emessage.global = function(...configs) {
+  for (const config of configs) {
+    const parsed = parseConfig(config);
+    if (parsed) {
+      globalMessageStore.set(parsed.name, parsed.options);
+    }
+  }
+};
+function showE(error) {
+  let config = null;
+  let errorName = null;
+  if (typeof error === "string") {
+    errorName = error;
+    config = individualMessageStore.get(error) ?? globalMessageStore.get(error) ?? null;
+    if (!config) {
+      console.error(`emessages: Error "${error}" not found.`);
+      return;
+    }
+  } else if (typeof error === "object" && error !== null) {
+    const parsed = parseConfig(error);
+    if (parsed) {
+      errorName = parsed.name;
+      config = parsed.options;
+    } else {
+      console.error("emessages: Invalid object passed to showE.");
+      return;
+    }
+  } else {
+    console.error("emessages: Invalid argument passed to showE.");
+    return;
+  }
+  if (config && errorName) {
+    return processEmessage(errorName, config);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Emessage,
+  showE
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/store.ts","../src/utils.ts"],"sourcesContent":["import { individualMessageStore, globalMessageStore } from \"./store\";\nimport type { EmessageOptions, StoredEmessage, TostConfig } from \"./types\";\nimport { isBrowser, showToast } from \"./utils\";\n\nfunction parseConfig(\n  config: Record<string, any>\n): { name: string; options: StoredEmessage } | null {\n  const options: EmessageOptions = {};\n  let message: string | null = null;\n  let name: string | null = null;\n  const optionKeys = [\"type\", \"break\", \"tost\", \"returnEM\", \"callBack\"];\n\n  for (const key in config) {\n    if (Object.prototype.hasOwnProperty.call(config, key)) {\n      if (optionKeys.includes(key)) {\n        (options as any)[key] = config[key];\n      } else {\n        if (name !== null) {\n          console.warn(\n            `emessages: Found multiple potential error names in one config object. Using first one found: \"${name}\".`\n          );\n          continue;\n        }\n        name = key;\n        message = String(config[key]);\n      }\n    }\n  }\n\n  if (name === null || message === null) {\n    console.error(\n      \"emessages: Invalid config object. Could not find error name and message.\",\n      config\n    );\n    return null;\n  }\n\n  return { name, options: { ...options, message } };\n}\n\nfunction processEmessage(\n  errorName: string,\n  config: StoredEmessage\n): string | void {\n  const message = config.message;\n  const type = config.type ?? \"err\";\n\n  // 1. Console log\n  switch (type) {\n    case \"log\":\n      console.log(message);\n      break;\n    case \"war\":\n      console.warn(message);\n      break;\n    case \"err\":\n      console.error(message);\n      break;\n  }\n\n  // 2. Toast notification\n  if (config.tost && isBrowser()) {\n    showToast(message, config.tost);\n  }\n\n  // 3. Callback\n  if (config.callBack) {\n    try {\n      config.callBack();\n    } catch (e: any) {\n      console.error(\n        `emessages: Error in callBack for \"${errorName}\":`,\n        e.message\n      );\n    }\n  }\n\n  // 4. Return error message\n  if (config.returnEM) {\n    return message;\n  }\n\n  // 5. Break execution\n  if (config.break ?? true) {\n    if (isBrowser()) {\n      throw new Error(message);\n    } else {\n      process.exit(1);\n    }\n  }\n}\n\nexport function Emessage(...configs: Record<string, any>[]) {\n  for (const config of configs) {\n    const parsed = parseConfig(config);\n    if (parsed) {\n      individualMessageStore.set(parsed.name, parsed.options);\n    }\n  }\n}\n\nEmessage.global = function (...configs: Record<string, any>[]) {\n  for (const config of configs) {\n    const parsed = parseConfig(config);\n    if (parsed) {\n      globalMessageStore.set(parsed.name, parsed.options);\n    }\n  }\n};\n\nexport function showE(error: string | Record<string, any>): string | void {\n  let config: StoredEmessage | null = null;\n  let errorName: string | null = null;\n\n  if (typeof error === \"string\") {\n    errorName = error;\n    config =\n      individualMessageStore.get(error) ?? globalMessageStore.get(error) ?? null;\n    if (!config) {\n      console.error(`emessages: Error \"${error}\" not found.`);\n      return;\n    }\n  } else if (typeof error === \"object\" && error !== null) {\n    const parsed = parseConfig(error);\n    if (parsed) {\n      errorName = parsed.name;\n      config = parsed.options;\n    } else {\n      console.error(\"emessages: Invalid object passed to showE.\");\n      return;\n    }\n  } else {\n    console.error(\"emessages: Invalid argument passed to showE.\");\n    return;\n  }\n\n  if (config && errorName) {\n    return processEmessage(errorName, config);\n  }\n}\n","import type { StoredEmessage } from \"./types\";\n\nexport const individualMessageStore = new Map<string, StoredEmessage>();\nexport const globalMessageStore = new Map<string, StoredEmessage>();\n","import { TostConfig } from \"./types\";\n\nexport function isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof window.document !== \"undefined\";\n}\n\nexport function showToast(\n  message: string,\n  tostConfig: boolean | TostConfig\n): void {\n  if (!isBrowser()) {\n    return;\n  }\n\n  const toast = document.createElement(\"div\");\n\n  const config: TostConfig = typeof tostConfig === \"object\" ? tostConfig : {};\n\n  toast.textContent = config.message || message;\n\n  // Base styles are applied via CSS, but some can be defaults.\n  toast.className = \"emessage-toast\";\n  if (config.style) {\n    toast.classList.add(...config.style.split(\" \"));\n  }\n\n  // Positioning\n  const position = config.position || \"top-right\";\n  toast.setAttribute(\"data-position\", position);\n\n  document.body.appendChild(toast);\n\n  // Animate in\n  setTimeout(() => {\n    toast.classList.add(\"visible\");\n  }, 10);\n\n  // Animate out and remove\n  setTimeout(() => {\n    toast.classList.remove(\"visible\");\n    toast.addEventListener(\"transitionend\", () => {\n      if (toast.parentElement) {\n        toast.parentElement.removeChild(toast);\n      }\n    });\n  }, 3000);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,7 @@
+declare function Emessage(...configs: Record<string, any>[]): void;
+declare namespace Emessage {
+    var global: (...configs: Record<string, any>[]) => void;
+}
+declare function showE(error: string | Record<string, any>): string | void;
+
+export { Emessage, showE };

package/dist/index.d.ts

@@ -1,11 +1,7 @@
-export type ErrorMap = Record<string, string>;
-export declare class ShowE extends Error {
-    code: string;
-    constructor(code: string);
+declare function Emessage(...configs: Record<string, any>[]): void;
+declare namespace Emessage {
+    var global: (...configs: Record<string, any>[]) => void;
 }
-declare global {
-    interface Function {
-        Emessage(map: ErrorMap): (...args: any[]) => Promise<any>;
-    }
-}
-export {};
+declare function showE(error: string | Record<string, any>): string | void;
+
+export { Emessage, showE };

package/dist/index.mjs

@@ -0,0 +1,152 @@
+// src/store.ts
+var individualMessageStore = /* @__PURE__ */ new Map();
+var globalMessageStore = /* @__PURE__ */ new Map();
+
+// src/utils.ts
+function isBrowser() {
+  return typeof window !== "undefined" && typeof window.document !== "undefined";
+}
+function showToast(message, tostConfig) {
+  if (!isBrowser()) {
+    return;
+  }
+  const toast = document.createElement("div");
+  const config = typeof tostConfig === "object" ? tostConfig : {};
+  toast.textContent = config.message || message;
+  toast.className = "emessage-toast";
+  if (config.style) {
+    toast.classList.add(...config.style.split(" "));
+  }
+  const position = config.position || "top-right";
+  toast.setAttribute("data-position", position);
+  document.body.appendChild(toast);
+  setTimeout(() => {
+    toast.classList.add("visible");
+  }, 10);
+  setTimeout(() => {
+    toast.classList.remove("visible");
+    toast.addEventListener("transitionend", () => {
+      if (toast.parentElement) {
+        toast.parentElement.removeChild(toast);
+      }
+    });
+  }, 3e3);
+}
+
+// src/index.ts
+function parseConfig(config) {
+  const options = {};
+  let message = null;
+  let name = null;
+  const optionKeys = ["type", "break", "tost", "returnEM", "callBack"];
+  for (const key in config) {
+    if (Object.prototype.hasOwnProperty.call(config, key)) {
+      if (optionKeys.includes(key)) {
+        options[key] = config[key];
+      } else {
+        if (name !== null) {
+          console.warn(
+            `emessages: Found multiple potential error names in one config object. Using first one found: "${name}".`
+          );
+          continue;
+        }
+        name = key;
+        message = String(config[key]);
+      }
+    }
+  }
+  if (name === null || message === null) {
+    console.error(
+      "emessages: Invalid config object. Could not find error name and message.",
+      config
+    );
+    return null;
+  }
+  return { name, options: { ...options, message } };
+}
+function processEmessage(errorName, config) {
+  const message = config.message;
+  const type = config.type ?? "err";
+  switch (type) {
+    case "log":
+      console.log(message);
+      break;
+    case "war":
+      console.warn(message);
+      break;
+    case "err":
+      console.error(message);
+      break;
+  }
+  if (config.tost && isBrowser()) {
+    showToast(message, config.tost);
+  }
+  if (config.callBack) {
+    try {
+      config.callBack();
+    } catch (e) {
+      console.error(
+        `emessages: Error in callBack for "${errorName}":`,
+        e.message
+      );
+    }
+  }
+  if (config.returnEM) {
+    return message;
+  }
+  if (config.break ?? true) {
+    if (isBrowser()) {
+      throw new Error(message);
+    } else {
+      process.exit(1);
+    }
+  }
+}
+function Emessage(...configs) {
+  for (const config of configs) {
+    const parsed = parseConfig(config);
+    if (parsed) {
+      individualMessageStore.set(parsed.name, parsed.options);
+    }
+  }
+}
+Emessage.global = function(...configs) {
+  for (const config of configs) {
+    const parsed = parseConfig(config);
+    if (parsed) {
+      globalMessageStore.set(parsed.name, parsed.options);
+    }
+  }
+};
+function showE(error) {
+  let config = null;
+  let errorName = null;
+  if (typeof error === "string") {
+    errorName = error;
+    config = individualMessageStore.get(error) ?? globalMessageStore.get(error) ?? null;
+    if (!config) {
+      console.error(`emessages: Error "${error}" not found.`);
+      return;
+    }
+  } else if (typeof error === "object" && error !== null) {
+    const parsed = parseConfig(error);
+    if (parsed) {
+      errorName = parsed.name;
+      config = parsed.options;
+    } else {
+      console.error("emessages: Invalid object passed to showE.");
+      return;
+    }
+  } else {
+    console.error("emessages: Invalid argument passed to showE.");
+    return;
+  }
+  if (config && errorName) {
+    return processEmessage(errorName, config);
+  }
+}
+export {
+  Emessage,
+  showE
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store.ts","../src/utils.ts","../src/index.ts"],"sourcesContent":["import type { StoredEmessage } from \"./types\";\n\nexport const individualMessageStore = new Map<string, StoredEmessage>();\nexport const globalMessageStore = new Map<string, StoredEmessage>();\n","import { TostConfig } from \"./types\";\n\nexport function isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof window.document !== \"undefined\";\n}\n\nexport function showToast(\n  message: string,\n  tostConfig: boolean | TostConfig\n): void {\n  if (!isBrowser()) {\n    return;\n  }\n\n  const toast = document.createElement(\"div\");\n\n  const config: TostConfig = typeof tostConfig === \"object\" ? tostConfig : {};\n\n  toast.textContent = config.message || message;\n\n  // Base styles are applied via CSS, but some can be defaults.\n  toast.className = \"emessage-toast\";\n  if (config.style) {\n    toast.classList.add(...config.style.split(\" \"));\n  }\n\n  // Positioning\n  const position = config.position || \"top-right\";\n  toast.setAttribute(\"data-position\", position);\n\n  document.body.appendChild(toast);\n\n  // Animate in\n  setTimeout(() => {\n    toast.classList.add(\"visible\");\n  }, 10);\n\n  // Animate out and remove\n  setTimeout(() => {\n    toast.classList.remove(\"visible\");\n    toast.addEventListener(\"transitionend\", () => {\n      if (toast.parentElement) {\n        toast.parentElement.removeChild(toast);\n      }\n    });\n  }, 3000);\n}\n","import { individualMessageStore, globalMessageStore } from \"./store\";\nimport type { EmessageOptions, StoredEmessage, TostConfig } from \"./types\";\nimport { isBrowser, showToast } from \"./utils\";\n\nfunction parseConfig(\n  config: Record<string, any>\n): { name: string; options: StoredEmessage } | null {\n  const options: EmessageOptions = {};\n  let message: string | null = null;\n  let name: string | null = null;\n  const optionKeys = [\"type\", \"break\", \"tost\", \"returnEM\", \"callBack\"];\n\n  for (const key in config) {\n    if (Object.prototype.hasOwnProperty.call(config, key)) {\n      if (optionKeys.includes(key)) {\n        (options as any)[key] = config[key];\n      } else {\n        if (name !== null) {\n          console.warn(\n            `emessages: Found multiple potential error names in one config object. Using first one found: \"${name}\".`\n          );\n          continue;\n        }\n        name = key;\n        message = String(config[key]);\n      }\n    }\n  }\n\n  if (name === null || message === null) {\n    console.error(\n      \"emessages: Invalid config object. Could not find error name and message.\",\n      config\n    );\n    return null;\n  }\n\n  return { name, options: { ...options, message } };\n}\n\nfunction processEmessage(\n  errorName: string,\n  config: StoredEmessage\n): string | void {\n  const message = config.message;\n  const type = config.type ?? \"err\";\n\n  // 1. Console log\n  switch (type) {\n    case \"log\":\n      console.log(message);\n      break;\n    case \"war\":\n      console.warn(message);\n      break;\n    case \"err\":\n      console.error(message);\n      break;\n  }\n\n  // 2. Toast notification\n  if (config.tost && isBrowser()) {\n    showToast(message, config.tost);\n  }\n\n  // 3. Callback\n  if (config.callBack) {\n    try {\n      config.callBack();\n    } catch (e: any) {\n      console.error(\n        `emessages: Error in callBack for \"${errorName}\":`,\n        e.message\n      );\n    }\n  }\n\n  // 4. Return error message\n  if (config.returnEM) {\n    return message;\n  }\n\n  // 5. Break execution\n  if (config.break ?? true) {\n    if (isBrowser()) {\n      throw new Error(message);\n    } else {\n      process.exit(1);\n    }\n  }\n}\n\nexport function Emessage(...configs: Record<string, any>[]) {\n  for (const config of configs) {\n    const parsed = parseConfig(config);\n    if (parsed) {\n      individualMessageStore.set(parsed.name, parsed.options);\n    }\n  }\n}\n\nEmessage.global = function (...configs: Record<string, any>[]) {\n  for (const config of configs) {\n    const parsed = parseConfig(config);\n    if (parsed) {\n      globalMessageStore.set(parsed.name, parsed.options);\n    }\n  }\n};\n\nexport function showE(error: string | Record<string, any>): string | void {\n  let config: StoredEmessage | null = null;\n  let errorName: string | null = null;\n\n  if (typeof error === \"string\") {\n    errorName = error;\n    config =\n      individualMessageStore.get(error) ?? globalMessageStore.get(error) ?? null;\n    if (!config) {\n      console.error(`emessages: Error \"${error}\" not found.`);\n      return;\n    }\n  } else if (typeof error === \"object\" && error !== null) {\n    const parsed = parseConfig(error);\n    if (parsed) {\n      errorName = parsed.name;\n      config = parsed.options;\n    } else {\n      console.error(\"emessages: Invalid object passed to showE.\");\n      return;\n    }\n  } else {\n    console.error(\"emessages: Invalid argument passed to showE.\");\n    return;\n  }\n\n  if (config && errorName) {\n    return processEmessage(errorName, config);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,25 +1,36 @@
-{
-  "name": "emessages",
-  "version": "1.0.0",
-  "description": "Function prototype based error handler with code-to-message mapping",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-
-  "sideEffects": true,
-
-  "scripts": {
-    "build": "tsc"
-  },
-
-  "devDependencies": {
-    "typescript": "^5.9.3"
-  }
-}
+{
+  "name": "emessages",
+  "version": "2.0.0",
+  "description": "A flexible error handling library for JS/TS. Define custom errors with console, toast, and callbacks, supporting global/local scopes and all environments.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./dist/emessages.css": "./dist/emessages.css"
+  },
+  "keywords": [
+    "error",
+    "message",
+    "logging",
+    "toast",
+    "notification"
+  ],
+  "sideEffects": true,
+  "scripts": {
+    "build": "tsup"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "tsup": "^8.0.2",
+    "typescript": "^5.3.3"
+  }
+}

package/dist/index.js

@@ -1,23 +0,0 @@
-export class ShowE extends Error {
-    constructor(code) {
-        super(code);
-        this.code = code;
-    }
-}
-const wrapWithHandler = (func, messages) => {
-    return async (...args) => {
-        var _a, _b;
-        try {
-            return await func(...args);
-        }
-        catch (error) {
-            const errorCode = (_a = error === null || error === void 0 ? void 0 : error.code) !== null && _a !== void 0 ? _a : "UNKNOWN_ERROR";
-            const message = (_b = messages[errorCode]) !== null && _b !== void 0 ? _b : "Unexpected error occurred";
-            console.error(`[${func.name || "anonymous"}] ${message}`);
-        }
-    };
-};
-// 🔥 Prototype extension — runs when module is imported
-Function.prototype.Emessage = function (map) {
-    return wrapWithHandler(this, map);
-};

package/src/index.ts

@@ -1,37 +0,0 @@
-export type ErrorMap = Record<string, string>;
-
-export class ShowE extends Error {
-  code: string;
-
-  constructor(code: string) {
-    super(code);
-    this.code = code;
-  }
-}
-
-const wrapWithHandler = (func: Function, messages: ErrorMap) => {
-  return async (...args: any[]) => {
-    try {
-      return await func(...args);
-    } catch (error: any) {
-      const errorCode = error?.code ?? "UNKNOWN_ERROR";
-      const message = messages[errorCode] ?? "Unexpected error occurred";
-      console.error(`[${func.name || "anonymous"}] ${message}`);
-    }
-  };
-};
-
-// 🌍 Global augmentation
-declare global {
-  interface Function {
-    Emessage(map: ErrorMap): (...args: any[]) => Promise<any>;
-  }
-}
-
-// 🔥 Prototype extension — runs when module is imported
-Function.prototype.Emessage = function (map: ErrorMap) {
-  return wrapWithHandler(this, map);
-};
-
-// Required for global augmentation
-export {};

package/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2019",
-    "module": "ESNext",
-    "declaration": true,
-    "outDir": "dist",
-    "strict": true,
-    "esModuleInterop": true
-  },
-  "include": ["src"]
-}