@nice-code/common-errors 0.0.19 → 0.0.21

package/build/hono/index.js

@@ -380,6 +380,7 @@ class NiceError extends Error {
   ids;
   wasntNice;
   httpStatusCode;
+  timeCreated;
   originError;
   _packedState;
   _errorDataMap;
@@ -393,6 +394,7 @@ class NiceError extends Error {
     if (options.originError != null) {
       this.originError = options.originError;
     }
+    this.timeCreated = options.timeCreated ?? Date.now();
   }
   hasId(id) {
     return id in this._errorDataMap;
@@ -470,7 +472,12 @@ class NiceError extends Error {
       } else {
         contextState = data.contextState;
       }
-      errorData[id] = { contextState, message: data.message, httpStatusCode: data.httpStatusCode };
+      errorData[id] = {
+        contextState,
+        message: data.message,
+        httpStatusCode: data.httpStatusCode,
+        timeAdded: data.timeAdded
+      };
     }
     return {
       name: "NiceError",
@@ -480,34 +487,49 @@ class NiceError extends Error {
       wasntNice: this.wasntNice,
       message: this.message,
       httpStatusCode: this.httpStatusCode,
+      timeCreated: this.timeCreated,
       ...this.stack != null ? { stack: this.stack } : {},
       originError
     };
   }
+  toJsonString() {
+    return JSON.stringify(this.toJsonObject());
+  }
+  toHttpResponse() {
+    return new Response(this.toJsonString(), {
+      status: this.httpStatusCode,
+      headers: { "Content-Type": "application/json" }
+    });
+  }
   hydrate(definedNiceError) {
     return definedNiceError.hydrate(this);
   }
-  handleWith(cases) {
-    for (const c of cases) {
-      if (!c._domain.isExact(this))
-        continue;
-      if (c._ids != null && !this.hasOneOfIds(c._ids))
-        continue;
-      c._handler(c._domain.hydrate(this));
-      return true;
+  handleWithSync(handlerInput, handlerOptions = {}) {
+    const handlersArray = Array.isArray(handlerInput) ? handlerInput : [handlerInput];
+    for (const handler of handlersArray) {
+      const result = handler.handleErrorWithPromiseInspection(this, handlerOptions);
+      if (result.matched) {
+        if (result.isPromise) {
+          console.warn(`[NiceError.handleWith] Handler ${result.target.identifier} returned a Promise but was called via \`handleWith\` (synchronous). ` + `The Promise will not be awaited. Use \`handleWithAsync\` for async handlers.`);
+        }
+        return result.isPromise ? undefined : result.handlerResponse;
+      }
     }
-    return false;
+    if (handlerOptions.throwOnUnhandled === true)
+      throw this;
+    return;
   }
-  async handleWithAsync(cases) {
-    for (const c of cases) {
-      if (!c._domain.isExact(this))
-        continue;
-      if (c._ids != null && !this.hasOneOfIds(c._ids))
-        continue;
-      await c._handler(c._domain.hydrate(this));
-      return true;
+  async handleWithAsync(handlerInput, handlerOptions = {}) {
+    const handlersArray = Array.isArray(handlerInput) ? handlerInput : [handlerInput];
+    for (const handler of handlersArray) {
+      const result = handler.handleErrorWithPromiseInspection(this, handlerOptions);
+      if (result.matched) {
+        return result.isPromise ? await result.handlerPromise : result.handlerResponse;
+      }
     }
-    return false;
+    if (handlerOptions.throwOnUnhandled === true)
+      throw this;
+    return;
   }
   get isPacked() {
     return this._packedState != null;
@@ -587,7 +609,7 @@ class NiceErrorHydrated extends NiceError {
 }
 
 // ../nice-error/src/NiceErrorDefined/NiceErrorDefined.ts
-class NiceErrorDefined {
+class NiceErrorDomain {
   domain;
   allDomains;
   defaultHttpStatusCode;
@@ -612,7 +634,7 @@ class NiceErrorDefined {
     }
   }
   createChildDomain(subErrorDef) {
-    const child = new NiceErrorDefined({
+    const child = new NiceErrorDomain({
       domain: subErrorDef.domain,
       allDomains: [subErrorDef.domain, ...this.allDomains],
       schema: subErrorDef.schema,
@@ -668,9 +690,10 @@ class NiceErrorDefined {
     if (errDef.domain !== this.domain) {
       throw new Error(`[NiceErrorDefined.hydrate] Domain mismatch: this definition is "${this.domain}" ` + `but the error belongs to "${errDef.domain}". ` + `Call \`niceErrorDefined.is(error)\` before hydrating to ensure compatibility.`);
     }
+    const finalError = error instanceof NiceError ? error : new NiceError(error);
     const reconciledErrorData = {};
-    for (const id of error.getIds()) {
-      const existingData = error.getErrorDataForId(id);
+    for (const id of finalError.getIds()) {
+      const existingData = finalError.getErrorDataForId(id);
       if (existingData == null)
         continue;
       let contextState = existingData.contextState;
@@ -688,18 +711,20 @@ class NiceErrorDefined {
       reconciledErrorData[id] = {
         contextState,
         message: existingData.message,
-        httpStatusCode: existingData.httpStatusCode
+        httpStatusCode: existingData.httpStatusCode,
+        timeAdded: existingData.timeAdded
       };
     }
     return new NiceErrorHydrated({
       def: this._buildDef(),
       niceErrorDefined: this,
-      ids: error.ids,
+      ids: finalError.ids,
       errorData: reconciledErrorData,
-      message: error.message,
-      httpStatusCode: error.httpStatusCode,
-      wasntNice: error.wasntNice,
-      originError: error.originError
+      message: finalError.message,
+      httpStatusCode: finalError.httpStatusCode,
+      wasntNice: finalError.wasntNice,
+      originError: finalError.originError,
+      timeCreated: finalError.timeCreated
     });
   }
   fromId(...args) {
@@ -790,13 +815,13 @@ class NiceErrorDefined {
     } else {
       contextState = { kind: "serde_unset" /* serde_unset */, value: context };
     }
-    return { contextState, message, httpStatusCode };
+    return { contextState, message, httpStatusCode, timeAdded: Date.now() };
   }
 }
 
 // ../nice-error/src/NiceErrorDefined/defineNiceError.ts
 var defineNiceError = (definition) => {
-  return new NiceErrorDefined({
+  return new NiceErrorDomain({
     domain: definition.domain,
     allDomains: [definition.domain],
     schema: definition.schema,
@@ -864,6 +889,10 @@ var err_cast_not_nice = err_nice.createChildDomain({
     })
   }
 });
+var err_nice_handler = err_nice.createChildDomain({
+  domain: "err_nice_handler",
+  schema: {}
+});
 // ../../node_modules/.bun/tslog@4.10.2/node_modules/tslog/esm/urlToObj.js
 function urlToObject(url) {
   return {

package/build/index.js

@@ -380,6 +380,7 @@ class NiceError extends Error {
   ids;
   wasntNice;
   httpStatusCode;
+  timeCreated;
   originError;
   _packedState;
   _errorDataMap;
@@ -393,6 +394,7 @@ class NiceError extends Error {
     if (options.originError != null) {
       this.originError = options.originError;
     }
+    this.timeCreated = options.timeCreated ?? Date.now();
   }
   hasId(id) {
     return id in this._errorDataMap;
@@ -470,7 +472,12 @@ class NiceError extends Error {
       } else {
         contextState = data.contextState;
       }
-      errorData[id] = { contextState, message: data.message, httpStatusCode: data.httpStatusCode };
+      errorData[id] = {
+        contextState,
+        message: data.message,
+        httpStatusCode: data.httpStatusCode,
+        timeAdded: data.timeAdded
+      };
     }
     return {
       name: "NiceError",
@@ -480,34 +487,49 @@ class NiceError extends Error {
       wasntNice: this.wasntNice,
       message: this.message,
       httpStatusCode: this.httpStatusCode,
+      timeCreated: this.timeCreated,
       ...this.stack != null ? { stack: this.stack } : {},
       originError
     };
   }
+  toJsonString() {
+    return JSON.stringify(this.toJsonObject());
+  }
+  toHttpResponse() {
+    return new Response(this.toJsonString(), {
+      status: this.httpStatusCode,
+      headers: { "Content-Type": "application/json" }
+    });
+  }
   hydrate(definedNiceError) {
     return definedNiceError.hydrate(this);
   }
-  handleWith(cases) {
-    for (const c of cases) {
-      if (!c._domain.isExact(this))
-        continue;
-      if (c._ids != null && !this.hasOneOfIds(c._ids))
-        continue;
-      c._handler(c._domain.hydrate(this));
-      return true;
+  handleWithSync(handlerInput, handlerOptions = {}) {
+    const handlersArray = Array.isArray(handlerInput) ? handlerInput : [handlerInput];
+    for (const handler of handlersArray) {
+      const result = handler.handleErrorWithPromiseInspection(this, handlerOptions);
+      if (result.matched) {
+        if (result.isPromise) {
+          console.warn(`[NiceError.handleWith] Handler ${result.target.identifier} returned a Promise but was called via \`handleWith\` (synchronous). ` + `The Promise will not be awaited. Use \`handleWithAsync\` for async handlers.`);
+        }
+        return result.isPromise ? undefined : result.handlerResponse;
+      }
     }
-    return false;
+    if (handlerOptions.throwOnUnhandled === true)
+      throw this;
+    return;
   }
-  async handleWithAsync(cases) {
-    for (const c of cases) {
-      if (!c._domain.isExact(this))
-        continue;
-      if (c._ids != null && !this.hasOneOfIds(c._ids))
-        continue;
-      await c._handler(c._domain.hydrate(this));
-      return true;
+  async handleWithAsync(handlerInput, handlerOptions = {}) {
+    const handlersArray = Array.isArray(handlerInput) ? handlerInput : [handlerInput];
+    for (const handler of handlersArray) {
+      const result = handler.handleErrorWithPromiseInspection(this, handlerOptions);
+      if (result.matched) {
+        return result.isPromise ? await result.handlerPromise : result.handlerResponse;
+      }
     }
-    return false;
+    if (handlerOptions.throwOnUnhandled === true)
+      throw this;
+    return;
   }
   get isPacked() {
     return this._packedState != null;
@@ -587,7 +609,7 @@ class NiceErrorHydrated extends NiceError {
 }
 
 // ../nice-error/src/NiceErrorDefined/NiceErrorDefined.ts
-class NiceErrorDefined {
+class NiceErrorDomain {
   domain;
   allDomains;
   defaultHttpStatusCode;
@@ -612,7 +634,7 @@ class NiceErrorDefined {
     }
   }
   createChildDomain(subErrorDef) {
-    const child = new NiceErrorDefined({
+    const child = new NiceErrorDomain({
       domain: subErrorDef.domain,
       allDomains: [subErrorDef.domain, ...this.allDomains],
       schema: subErrorDef.schema,
@@ -668,9 +690,10 @@ class NiceErrorDefined {
     if (errDef.domain !== this.domain) {
       throw new Error(`[NiceErrorDefined.hydrate] Domain mismatch: this definition is "${this.domain}" ` + `but the error belongs to "${errDef.domain}". ` + `Call \`niceErrorDefined.is(error)\` before hydrating to ensure compatibility.`);
     }
+    const finalError = error instanceof NiceError ? error : new NiceError(error);
     const reconciledErrorData = {};
-    for (const id of error.getIds()) {
-      const existingData = error.getErrorDataForId(id);
+    for (const id of finalError.getIds()) {
+      const existingData = finalError.getErrorDataForId(id);
       if (existingData == null)
         continue;
       let contextState = existingData.contextState;
@@ -688,18 +711,20 @@ class NiceErrorDefined {
       reconciledErrorData[id] = {
         contextState,
         message: existingData.message,
-        httpStatusCode: existingData.httpStatusCode
+        httpStatusCode: existingData.httpStatusCode,
+        timeAdded: existingData.timeAdded
       };
     }
     return new NiceErrorHydrated({
       def: this._buildDef(),
       niceErrorDefined: this,
-      ids: error.ids,
+      ids: finalError.ids,
       errorData: reconciledErrorData,
-      message: error.message,
-      httpStatusCode: error.httpStatusCode,
-      wasntNice: error.wasntNice,
-      originError: error.originError
+      message: finalError.message,
+      httpStatusCode: finalError.httpStatusCode,
+      wasntNice: finalError.wasntNice,
+      originError: finalError.originError,
+      timeCreated: finalError.timeCreated
     });
   }
   fromId(...args) {
@@ -790,13 +815,13 @@ class NiceErrorDefined {
     } else {
       contextState = { kind: "serde_unset" /* serde_unset */, value: context };
     }
-    return { contextState, message, httpStatusCode };
+    return { contextState, message, httpStatusCode, timeAdded: Date.now() };
   }
 }
 
 // ../nice-error/src/NiceErrorDefined/defineNiceError.ts
 var defineNiceError = (definition) => {
-  return new NiceErrorDefined({
+  return new NiceErrorDomain({
     domain: definition.domain,
     allDomains: [definition.domain],
     schema: definition.schema,
@@ -864,6 +889,10 @@ var err_cast_not_nice = err_nice.createChildDomain({
     })
   }
 });
+var err_nice_handler = err_nice.createChildDomain({
+  domain: "err_nice_handler",
+  schema: {}
+});
 // ../../node_modules/.bun/tslog@4.10.2/node_modules/tslog/esm/urlToObj.js
 function urlToObject(url) {
   return {

package/build/types/validation/err_validation.d.ts

@@ -2,7 +2,7 @@ import type { IErrContext_HonoStandardSchema } from "./err_validation.types";
 export declare enum EValidator {
     standard_schema = "standard_schema"
 }
-export declare const err_validation: import("@nice-code/error").NiceErrorDefined<{
+export declare const err_validation: import("@nice-code/error").NiceErrorDomain<{
     domain: string;
     allDomains: [string, "err_nice"];
     schema: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nice-code/common-errors",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "private": false,
   "type": "module",
   "exports": {
@@ -29,7 +29,7 @@
     "build-types": "tsc --project tsconfig.build.json"
   },
   "dependencies": {
-    "@nice-code/error": "0.0.14",
+    "@nice-code/error": "0.0.21",
     "@standard-schema/spec": "^1.1.0",
     "@hono/standard-validator": "^0.2.2",
     "http-status-codes": "^2.3.0"