@reykjavik/webtools 0.2.6 → 0.2.7

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 - ... <!-- Add new lines here. -->
 
+## 0.2.7
+
+_2025-09-01_
+
+- `@reykjavik/webtools/fixIcelandicLocale`:
+  - fix: Check for support of each Intl class separately
+- docs: Improve JSDocs and README for `asError()` and `ErrorFromPayload`
+
 ## 0.2.6
 
 _2025-06-20_

package/README.md

@@ -386,7 +386,8 @@ Guarantees that a caught (`catch (e)`) value of `unknown` type, is indeed an
 
 If the input is an `Error` instance, it is returned as-is. If the input is
 something else it is wrapped in a new `ErrorFromPayload` instance, and the
-original value is stored in as a `payload` property.
+original value is stored in as a `payload` property, and it's `.toString()` is
+used for the `message` property.
 
 ```ts
 import { asError, type ErrorFromPayload } from '@reykjavik/webtools/errorhandling';
@@ -395,21 +396,23 @@ const theError = new Error('Something went wrong');
 try {
   throw theError;
 } catch (err) {
+  // theError is an instance of Error so it's returned as-is
   const error = asError(theError);
   console.error(error === theError); // true
-  console.error('patload' in error); // false
+  console.error('payload' in error); // false
 }
 
-const someObject = ['Something went wrong'];
+const someObject = ['Oops', 'Something went wrong'];
 try {
   throw someObject;
 } catch (err) {
+  // the thrown someObject is not an Error so an `ErrorFromPayload` is returned
   const error = asError(someObject);
   console.error(error === someObject); // false
-  console.error(error.message === someObject.join(',')); // false
   console.error(error instanceOf ErrorFromPayload); // true
 
   console.error(error.payload === someObject); // true
+  console.error(error.message === someObject.join(',')); // true
 }
 ```
 

package/errorhandling.d.ts

@@ -1,10 +1,18 @@
 /**
- * Error subclass for thrown values that got cought and turned into an actual
- * Error, with the thrown value as the `payload` property.
+ * Error subclass for thrown NON-Error values that got turned into an actual
+ * Error, with the original thrown value as the `payload` property.
  *
  * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export declare class ErrorFromPayload extends Error {
+    /**
+     * This payload property is only set if the original `throw` value was NOT
+     * `instanceof Error`.
+     *
+     * In such cases it contains the thrown value as is, and the `message`
+     * property of this `ErrorFromPayload` instance is set to the `.toString()`
+     * representation of the payload.
+     */
     payload?: unknown;
     constructor(payload: unknown);
     name: string;
@@ -50,7 +58,7 @@ export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | Fail
  * `[error, results]` tuple with the `result` and `error` also attached as
  * named properties.
  *
- * Works on both promises and sync callback functions.
+ * Works on both promises and (synchronous) callback functions.
  *
  * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultcatch
  */

package/errorhandling.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Result = exports.asError = exports.ErrorFromPayload = void 0;
 /**
- * Error subclass for thrown values that got cought and turned into an actual
- * Error, with the thrown value as the `payload` property.
+ * Error subclass for thrown NON-Error values that got turned into an actual
+ * Error, with the original thrown value as the `payload` property.
  *
  * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */

package/esm/errorhandling.d.ts

@@ -1,10 +1,18 @@
 /**
- * Error subclass for thrown values that got cought and turned into an actual
- * Error, with the thrown value as the `payload` property.
+ * Error subclass for thrown NON-Error values that got turned into an actual
+ * Error, with the original thrown value as the `payload` property.
  *
  * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export declare class ErrorFromPayload extends Error {
+    /**
+     * This payload property is only set if the original `throw` value was NOT
+     * `instanceof Error`.
+     *
+     * In such cases it contains the thrown value as is, and the `message`
+     * property of this `ErrorFromPayload` instance is set to the `.toString()`
+     * representation of the payload.
+     */
     payload?: unknown;
     constructor(payload: unknown);
     name: string;
@@ -50,7 +58,7 @@ export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | Fail
  * `[error, results]` tuple with the `result` and `error` also attached as
  * named properties.
  *
- * Works on both promises and sync callback functions.
+ * Works on both promises and (synchronous) callback functions.
  *
  * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultcatch
  */

package/esm/errorhandling.js

@@ -1,6 +1,6 @@
 /**
- * Error subclass for thrown values that got cought and turned into an actual
- * Error, with the thrown value as the `payload` property.
+ * Error subclass for thrown NON-Error values that got turned into an actual
+ * Error, with the original thrown value as the `payload` property.
  *
  * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */

package/esm/fixIcelandicLocale.js

@@ -7,8 +7,12 @@ import { _PatchedCollator, _PatchedDateTimeFormat, _patchedDateToLocaleDateStrin
 if (!Intl.Collator.supportedLocalesOf(['is']).length) {
     Intl.Collator = _PatchedCollator;
     String.prototype.localeCompare = _patchedStringLocaleCompare;
+}
+if (!Intl.NumberFormat.supportedLocalesOf(['is']).length) {
     Intl.NumberFormat = _PatchedNumberFormat;
     Number.prototype.toLocaleString = _patchedNumberToLocaleString;
+}
+if (!Intl.DateTimeFormat.supportedLocalesOf(['is']).length) {
     Intl.DateTimeFormat = _PatchedDateTimeFormat;
     Date.prototype.toLocaleString = _patchedDateToLocaleString;
     Date.prototype.toLocaleDateString = _patchedDateToLocaleDateString;

package/esm/http.d.ts

@@ -11,6 +11,7 @@ export declare const HTTP_103_EarlyHints = 103;
 export declare const HTTP_200_OK = 200;
 /** The request succeeded, and a new resource was created as a result. This is typically the response sent after POST or PUT requests. */
 export declare const HTTP_201_Created = 201;
+/** The request has been received but not yet acted upon. Another process or server handles the request. */
 export declare const HTTP_202_Accepted = 202;
 /** The returned metadata is not necessarily complete. */
 export declare const HTTP_203_NonAuthoritativeInformation = 203;

package/esm/http.js

@@ -12,7 +12,7 @@ export const HTTP_103_EarlyHints = 103;
 export const HTTP_200_OK = 200;
 /** The request succeeded, and a new resource was created as a result. This is typically the response sent after POST or PUT requests. */
 export const HTTP_201_Created = 201;
-/* The request has been received but not yet acted upon. Another process or server handles the request. */
+/** The request has been received but not yet acted upon. Another process or server handles the request. */
 export const HTTP_202_Accepted = 202;
 /** The returned metadata is not necessarily complete. */
 export const HTTP_203_NonAuthoritativeInformation = 203;

package/fixIcelandicLocale.js

@@ -9,8 +9,12 @@ const fixIcelandicLocale_privates_js_1 = require("./fixIcelandicLocale.privates.
 if (!Intl.Collator.supportedLocalesOf(['is']).length) {
     Intl.Collator = fixIcelandicLocale_privates_js_1._PatchedCollator;
     String.prototype.localeCompare = fixIcelandicLocale_privates_js_1._patchedStringLocaleCompare;
+}
+if (!Intl.NumberFormat.supportedLocalesOf(['is']).length) {
     Intl.NumberFormat = fixIcelandicLocale_privates_js_1._PatchedNumberFormat;
     Number.prototype.toLocaleString = fixIcelandicLocale_privates_js_1._patchedNumberToLocaleString;
+}
+if (!Intl.DateTimeFormat.supportedLocalesOf(['is']).length) {
     Intl.DateTimeFormat = fixIcelandicLocale_privates_js_1._PatchedDateTimeFormat;
     Date.prototype.toLocaleString = fixIcelandicLocale_privates_js_1._patchedDateToLocaleString;
     Date.prototype.toLocaleDateString = fixIcelandicLocale_privates_js_1._patchedDateToLocaleDateString;

package/http.d.ts

@@ -11,6 +11,7 @@ export declare const HTTP_103_EarlyHints = 103;
 export declare const HTTP_200_OK = 200;
 /** The request succeeded, and a new resource was created as a result. This is typically the response sent after POST or PUT requests. */
 export declare const HTTP_201_Created = 201;
+/** The request has been received but not yet acted upon. Another process or server handles the request. */
 export declare const HTTP_202_Accepted = 202;
 /** The returned metadata is not necessarily complete. */
 export declare const HTTP_203_NonAuthoritativeInformation = 203;

package/http.js

@@ -16,7 +16,7 @@ exports.HTTP_103_EarlyHints = 103;
 exports.HTTP_200_OK = 200;
 /** The request succeeded, and a new resource was created as a result. This is typically the response sent after POST or PUT requests. */
 exports.HTTP_201_Created = 201;
-/* The request has been received but not yet acted upon. Another process or server handles the request. */
+/** The request has been received but not yet acted upon. Another process or server handles the request. */
 exports.HTTP_202_Accepted = 202;
 /** The returned metadata is not necessarily complete. */
 exports.HTTP_203_NonAuthoritativeInformation = 203;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@reykjavik/webtools",
-	"version": "0.2.6",
+	"version": "0.2.7",
 	"description": "Misc. JS/TS helpers used by Reykjavík City's web dev teams.",
 	"main": "index.js",
 	"repository": "ssh://git@github.com:reykjavikcity/webtools.git",