runtime-reporter 0.4.5 → 0.4.7

package/README.md

@@ -1,8 +1,28 @@
 # Runtime Reporter
 
-Structured runtime reporting that is type-safe, centralized, and production-ready — for front-end frameworks and applications.
+Replace ad-hoc logging with structured, code-based messaging.
 
-Runtime Reporter replaces ad-hoc logging with structured, code-based messaging.
+Runtime Reporter provides centralized, type-safe reporting that is convenient in development and secure in production.
+
+```ts
+// ./src/runtime-reporter.ts
+
+import { createReporter } from "runtime-reporter";
+
+export const reporter = createReporter({
+    ERR01: "Something went wrong",
+});
+
+// ./src/MyComponent.ts
+
+import { reporter } from "./runtime-reporter";
+
+export function MyComponent() {
+    useEffect(() => {
+        reporter.error("ERR01");
+    }, []);
+}
+```
 
 ## Why?
 
@@ -20,7 +40,14 @@ by introducing these features:
 - test assertions without string duplication
 - safer production output (no sensitive data exposure)
 
-in a lightweight, self-contained package (less than 1 KB).
+in a lightweight, self-contained package (less than 1 KB gzipped).
+
+## Who is this for?
+
+- Front-end frameworks and libraries
+- Projects that need stable error codes
+- Teams replacing custom logging systems
+- Projects that want safer production output
 
 ## Installation
 
@@ -30,11 +57,9 @@ npm install runtime-reporter
 
 ## Quick start
 
-A copy-and-paste example of how to use Runtime Reporter in your project.
+A full, copy-and-paste example of how to use Runtime Reporter in your project:
 
 ```ts
-// src/runtime-reporter.ts
-
 import { createReporter, type RuntimeReporterMessages } from "runtime-reporter";
 
 const messages: RuntimeReporterMessages<
@@ -64,62 +89,57 @@ const reporter = createReporter(messages);
 export default reporter;
 ```
 
-Once your reporter is created, import and use it wherever you want:
+## Features
 
-```ts
-// src/my-component.ts
+If you are new to Runtime Reporter, take a moment to explore its core features.
 
-import { reporter } from "./runtime-reporter";
+### 1. Code-based messaging
 
-export function MyComponent() {
-    useEffect(() => {
-        reporter.error("ERR01", { componentName: "MyComponent" });
-    }, []);
-
-    return <div>My Component</div>;
-}
-```
+Replace inline strings with centralized, code-based identifiers.
 
-## Features
+```ts
+// Without runtime-reporter
+console.log("Something went wrong");
+// ❌ Logs: "Something went wrong"
 
-If you are new to Runtime Reporter, take a moment to explore its core features.
+// With runtime-reporter
+reporter.log("ERR01");
+// ✅ Logs: "Something went wrong (ERR01)"
+```
 
-### 1. Basic usage
+### 2. Dynamic messages
 
-Create a reporter instance with your messages and start logging.
+Inject runtime data into your messages via message templates and tokenized variables.
 
 ```ts
-import { createReporter } from "runtime-reporter";
-
 const reporter = createReporter({
-    ERR01: "MyComponent failed to mount",
+    ERR01: "{{ componentName }} failed to mount",
 });
 
-reporter.error("ERR01");
+reporter.error("ERR01", { componentName: "MyComponent" });
+// Logs: "MyComponent failed to mount (ERR01)"
 ```
 
-### 2. Code-based messaging
+### 3. Development vs. production
 
-Replace inline strings with centralized, code-based identifiers.
+Pass an empty object to the `createReporter` function in production environments for better security and a smaller bundle size.
 
 ```ts
-// Without runtime-reporter (logs "MyComponent failed to mount")
-console.error("MyComponent failed to mount");
-
-// With runtime-reporter (logs "MyComponent failed to mount (ERR01)")
-reporter.error("ERR01");
+const reporter = createReporter(
+    process.env.NODE_ENV === "production" ? ({} as typeof messages) : messages
+);
 ```
 
-### 3. Dynamic messages
-
-Inject runtime data into your messages via message templates and tokenized variables.
+Development environments get detailed messaging, while production environments get as little as possible.
 
 ```ts
-const reporter = createReporter({
-    ERR01: "{{ componentName }} failed to mount",
-});
+reporter.error("ERR01");
+// In development, it logs: "Something went wrong (ERR01)"
+// In production, it does not log
 
-reporter.error("ERR01", { componentName: "MyComponent" });
+reporter.fail("ERR01");
+// In development, it throws: "Something went wrong (ERR01)"
+// In production, it throws: "An error occurred (ERR01)"
 ```
 
 ### 4. Type safety
@@ -147,17 +167,7 @@ reporter.error("ERR02", { componentName: "MyComponent" });
 reporter.error("ERR01");
 ```
 
-### 5. Production environments
-
-Pass an empty object to the `createReporter` function in production environments for better security and a smaller bundle size.
-
-```ts
-const reporter = createReporter(
-    process.env.NODE_ENV === "production" ? ({} as typeof messages) : messages
-);
-```
-
-### 6. Test friendly
+### 5. Test friendly
 
 Assert against resolved messages without duplicating message text in your test environment.
 

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "runtime-reporter",
-    "version": "0.4.5",
-    "description": "Structured runtime reporting that is type-safe, centralized, and production-ready.",
+    "version": "0.4.7",
+    "description": "Replace ad-hoc logging with structured, code-based messaging",
     "type": "module",
     "main": "./dist/index.cjs",
     "module": "./dist/index.js",