@nice-code/common-errors 0.0.20 → 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @nice-code/common-errors
+
+Shared error domains for Standard Schema validation errors and Hono middleware integration.
+
+See the [main README](../../README.md#nice-codecommon-errors) for full documentation and examples.

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 {
@@ -2565,7 +2594,7 @@ var niceCatchSValidation = () => async (ctx, next) => {
     }
   }
 };
-// ../../node_modules/.bun/hono@4.12.14/node_modules/hono/dist/utils/url.js
+// ../../node_modules/.bun/hono@4.12.15/node_modules/hono/dist/utils/url.js
 var tryDecode = (str, decoder) => {
   try {
     return decoder(str);
@@ -2581,7 +2610,7 @@ var tryDecode = (str, decoder) => {
 };
 var decodeURIComponent_ = decodeURIComponent;
 
-// ../../node_modules/.bun/hono@4.12.14/node_modules/hono/dist/utils/cookie.js
+// ../../node_modules/.bun/hono@4.12.15/node_modules/hono/dist/utils/cookie.js
 var validCookieNameRegEx = /^[\w!#$%&'*.^`|~+-]+$/;
 var validCookieValueRegEx = /^[ !#-:<-[\]-~]*$/;
 var trimCookieWhitespace = (value) => {
@@ -2632,7 +2661,7 @@ var parse = (cookie, name) => {
   return parsedCookie;
 };
 
-// ../../node_modules/.bun/hono@4.12.14/node_modules/hono/dist/helper/cookie/index.js
+// ../../node_modules/.bun/hono@4.12.15/node_modules/hono/dist/helper/cookie/index.js
 var getCookie = (c, key, prefix) => {
   const cookie = c.req.raw.headers.get("Cookie");
   if (typeof key === "string") {
@@ -2655,7 +2684,7 @@ var getCookie = (c, key, prefix) => {
   return obj;
 };
 
-// ../../node_modules/.bun/hono@4.12.14/node_modules/hono/dist/http-exception.js
+// ../../node_modules/.bun/hono@4.12.15/node_modules/hono/dist/http-exception.js
 var HTTPException = class extends Error {
   res;
   status;
@@ -2678,7 +2707,7 @@ var HTTPException = class extends Error {
   }
 };
 
-// ../../node_modules/.bun/hono@4.12.14/node_modules/hono/dist/utils/buffer.js
+// ../../node_modules/.bun/hono@4.12.15/node_modules/hono/dist/utils/buffer.js
 var bufferToFormData = (arrayBuffer, contentType) => {
   const response = new Response(arrayBuffer, {
     headers: {
@@ -2688,7 +2717,7 @@ var bufferToFormData = (arrayBuffer, contentType) => {
   return response.formData();
 };
 
-// ../../node_modules/.bun/hono@4.12.14/node_modules/hono/dist/validator/validator.js
+// ../../node_modules/.bun/hono@4.12.15/node_modules/hono/dist/validator/validator.js
 var jsonRegex = /^application\/([a-z-\.]+\+)?json(;\s*[a-zA-Z0-9\-]+\=([^;]+))*$/;
 var multipartRegex = /^multipart\/form-data(;\s?boundary=[a-zA-Z0-9'"()+_,\-./:=?]+)?$/;
 var urlencodedRegex = /^application\/x-www-form-urlencoded(;\s*[a-zA-Z0-9\-]+\=([^;]+))*$/;
@@ -2765,7 +2794,7 @@ var validator = (target, validationFunc) => {
   };
 };
 
-// ../../node_modules/.bun/@hono+standard-validator@0.2.2+6f986fe481fa21c3/node_modules/@hono/standard-validator/dist/index.js
+// ../../node_modules/.bun/@hono+standard-validator@0.2.2+ba5f02f09be4faa7/node_modules/@hono/standard-validator/dist/index.js
 var RESTRICTED_DATA_FIELDS = { header: ["cookie"] };
 function sanitizeIssues(issues, vendor, target) {
   if (!(target in RESTRICTED_DATA_FIELDS))

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.20",
+  "version": "0.1.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -29,13 +29,13 @@
     "build-types": "tsc --project tsconfig.build.json"
   },
   "dependencies": {
-    "@nice-code/error": "0.0.20",
+    "@nice-code/error": "0.1.0",
     "@standard-schema/spec": "^1.1.0",
     "@hono/standard-validator": "^0.2.2",
     "http-status-codes": "^2.3.0"
   },
   "peerDependencies": {
     "valibot": "^1.3.1",
-    "hono": "^4.12.14"
+    "hono": "^4.12.15"
   }
 }