@reykjavik/webtools 0.1.37 → 0.2.1

package/CHANGELOG.md

@@ -4,6 +4,24 @@
 
 - ... <!-- Add new lines here. -->
 
+## 0.2.1
+
+_2024-12-17_
+
+- fix: Make typing of failed ResultTuple/ResultTupleObj less ambiguous
+
+## 0.2.0
+
+_2024-12-12_
+
+- feat: Add `@reykjavik/webtools/react-router/*` (previously `/remix/*`)
+- **BREAKING** feat: Remove all `@reykjavik/webtools/react-router/*` modules
+- **BREAKING** feat: Bump `pkg.engines.node` version to >=20
+- **BREAKING** feat: Remove `@reykjavik/webtools/next/SiteImprove` (deprecated
+  module)
+- **BREAKING** feat: Remove deprecated exports `vanillaNest` and
+  `vanillaClassNested` from `@reykjavik/webtools/vanillaExtract`
+
 ## 0.1.37
 
 _2024-10-23_

package/CookieHubConsent.d.ts

@@ -218,14 +218,14 @@ export type CookieHubProviderProps = EitherObj<{
  * management script and sets up a React state object with the relevant user
  * consent flags.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#cookiehubprovider-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cookiehubprovider-component
  */
 export declare const CookieHubProvider: (props: CookieHubProviderProps) => React.JSX.Element;
 /**
  * Returns up-to-date cookie consent flags. For use in React components or hook
  * functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#usecookiehubconsent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usecookiehubconsent
  */
 export declare const useCookieHubConsent: () => Partial<CookieHubContextState['consent']>;
 export {};

package/CookieHubConsent.js

@@ -61,7 +61,7 @@ const moveCookiehubScriptInDomTree = () => {
  * management script and sets up a React state object with the relevant user
  * consent flags.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#cookiehubprovider-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cookiehubprovider-component
  */
 const CookieHubProvider = (props) => {
     const [state, setState] = (0, react_1.useState)(initialConsentState);
@@ -134,7 +134,7 @@ exports.CookieHubProvider = CookieHubProvider;
  * Returns up-to-date cookie consent flags. For use in React components or hook
  * functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#usecookiehubconsent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usecookiehubconsent
  */
 const useCookieHubConsent = () => { var _a; return ((_a = (0, react_1.useContext)(CookieHubContext)) === null || _a === void 0 ? void 0 : _a.consent) || {}; };
 exports.useCookieHubConsent = useCookieHubConsent;

package/README.md

@@ -51,7 +51,7 @@ bun add @reykjavik/webtools
   - [`vanillaGlobal`](#vanillaglobal)
   - [`vanillaProps`](#vanillaprops)
 - [Framework Specific Tools](#framework-specific-tools)
-  - [Remix.run Tools](#remixrun-tools)
+  - [React-Router Tools](#react-router-tools)
   - [Next.js Tools](#nextjs-tools)
 - [Contributing](#contributing)
 - [Changelog](#changelog)
@@ -484,7 +484,8 @@ if (myResult.error) {
 
 ### `Result.catch`
 
-**Syntax:** `Result.catch<T, Err>(callback: () => T): ResultTupleObj<T, Err>`
+**Syntax:**
+`Result.catch<T, Err>(callback: () => T): ResultTupleObj<T, Err>`  
 **Syntax:**
 `Result.catch<T, Err>(promise: Promise<T>): Promise<ResultTupleObj<T, Err>>`
 
@@ -881,10 +882,13 @@ const myStyle = style({
 
 ## Framework Specific Tools
 
-### Remix.run Tools
+### React-Router Tools
+
+See [README-rr.md](./README-rr.md) for helpers and components specifically
+designed for use in Remix.run projects.
 
-See [README-remix.md](./README-remix.md) for helpers and components
-specifically designed for use in Remix.run projects.
+(NOTE: If you're still using [Remix.run](https://remix.run) you can install
+version `"^0.1.22"` of this package.)
 
 <!-- #fragment anchors to not break older v0.1 @see links -->
 

package/SiteImprove.d.ts

@@ -45,14 +45,14 @@ type SiteImproveCustomEvent = [
 /**
  * A small helper for tracking custom UI events and reporting them to SiteImrove.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#pingsiteimprove-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimprove-helper
  */
 export declare const pingSiteImprove: (category: string, action: string, label?: string) => void;
 /**
  * A small helper for reporting to SiteImrove when the user is programmatically
  * being sent to a different URL/resource.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#pingsiteimproveoutbound-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimproveoutbound-helper
  */
 export declare const pingSiteImproveOutbound: (ourl: string) => void;
 export type SiteImproveProps = EitherObj<{
@@ -94,7 +94,7 @@ export type SiteImproveProps = EitherObj<{
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across client-side (pushState, replaceState) routing.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#siteimprove-component
  */
 export declare const SiteImprove: (props: SiteImproveProps) => null;
 export {};

package/SiteImprove.js

@@ -29,7 +29,7 @@ const trackDynamicPageView = (url, refUrl, title) => _emitEvent(['trackdynamic',
 /**
  * A small helper for tracking custom UI events and reporting them to SiteImrove.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#pingsiteimprove-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimprove-helper
  */
 const pingSiteImprove = (category, action, label) => {
     if (process.env.NODE_ENV === 'development' &&
@@ -44,7 +44,7 @@ exports.pingSiteImprove = pingSiteImprove;
  * A small helper for reporting to SiteImrove when the user is programmatically
  * being sent to a different URL/resource.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#pingsiteimproveoutbound-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimproveoutbound-helper
  */
 const pingSiteImproveOutbound = (ourl) => {
     if (process.env.NODE_ENV === 'development' &&
@@ -125,7 +125,7 @@ const loc = typeof document !== 'undefined' ? document.location : {};
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across client-side (pushState, replaceState) routing.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#siteimprove-component
  */
 const SiteImprove = (props) => {
     const consented = useResolvedAnalyticsConsent(props.hasConsented);

package/async.d.ts

@@ -14,7 +14,7 @@ export declare const addLag: (length: number) => <T>(res: T) => Promise<T>;
  * Resolves as soon as all of the passed `promises` have resolved/settled,
  * or after `timeout` milliseconds — whichever comes first.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#maxwait
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#maxwait
  */
 export declare function maxWait(timeout: number, promises: Array<unknown>): Promise<void>;
 export declare function maxWait<PromiseMap extends PlainObj>(timeout: number, promises: PromiseMap): Promise<{
@@ -24,7 +24,7 @@ export declare function maxWait<PromiseMap extends PlainObj>(timeout: number, pr
  * A variation of `Promise.all()` that accepts an object with named promises
  * and returns a same-shaped object with the resolved values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#promiseallobject
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#promiseallobject
  */
 export declare const promiseAllObject: <T extends PlainObj>(promisesMap: T) => Promise<{ -readonly [K in keyof T]: Awaited<T[K]>; }>;
 export {};

package/async.js

@@ -45,7 +45,7 @@ exports.maxWait = maxWait;
  * A variation of `Promise.all()` that accepts an object with named promises
  * and returns a same-shaped object with the resolved values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#promiseallobject
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#promiseallobject
  */
 const promiseAllObject = (promisesMap) => Promise.all(Object.values(promisesMap)).then((results) => {
     const keys = Object.keys(promisesMap);

package/errorhandling.d.ts

@@ -2,7 +2,7 @@
  * Error subclass for thrown values that got cought and turned into an actual
  * Error, with the thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export declare class ErrorFromPayload extends Error {
     payload?: unknown;
@@ -17,28 +17,28 @@ export declare class ErrorFromPayload extends Error {
  * something else it is wrapped in a new `ErrorFromPayload` instance, and the
  * original value is stored in a `payload`
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export declare const asError: (maybeError: unknown) => ErrorFromPayload;
 type SuccessResult<T> = [error: undefined, result: T] & {
     error?: undefined;
     result: T;
 };
-type FailResult<E extends Error> = [error: E] & {
+type FailResult<E extends Error> = [error: E, result?: undefined] & {
     error: E;
     result?: undefined;
 };
 /**
  * Simple bare-bones discriminated tuple type for a [error, result] pair.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#type-resulttuple
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttuple
  */
-export type ResultTuple<T, E extends Error = Error> = [error: undefined, result: T] | [error: E];
+export type ResultTuple<T, E extends Error = Error> = [error: undefined, result: T] | [error: E, result?: undefined];
 /**
  * Discriminated tuple type for a `[error, result]` pair (same as `ResultTuple`)
  * but with named properties `error` and `result` attached for dev convenience.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#type-resulttupleobj
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttupleobj
  */
 export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | FailResult<E>;
 /**
@@ -50,7 +50,7 @@ export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | Fail
  *
  * Works on both promises and sync callback functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultcatch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultcatch
  */
 declare function catch_<T, E extends Error = ErrorFromPayload>(promise: Promise<T>): Promise<ResultTupleObj<T, E>>;
 declare function catch_<T, E extends Error = ErrorFromPayload>(callback: () => T): ResultTupleObj<T, E>;
@@ -58,19 +58,19 @@ declare function catch_<T, E extends Error = ErrorFromPayload>(callback: () => T
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
  */
 export declare const Result: {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
      */
     Success: <T>(result: T) => SuccessResult<T>;
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
      */
     Fail: <E extends Error = Error>(e: unknown) => FailResult<E>;
     catch: typeof catch_;
@@ -79,14 +79,14 @@ export declare const Result: {
      * object, applying a transformation function to the result, but retaining
      * the error as-is.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
      */
     map: <T_1, T2, E_1 extends Error>(result: ResultTuple<T_1, E_1>, mapFn: (resultValue: T_1) => T2) => ResultTupleObj<T2, E_1>;
     /**
      * Unwraps a discriminated [error, result] `Result.Tuple`-like object
      * and throws if there's an error, but returns the result otherwise.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
      */
     throw: <T_2>(result: ResultTuple<T_2, Error>) => T_2;
 };

package/errorhandling.js

@@ -5,7 +5,7 @@ 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.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 class ErrorFromPayload extends Error {
     constructor(payload) {
@@ -27,7 +27,7 @@ exports.ErrorFromPayload = ErrorFromPayload;
  * something else it is wrapped in a new `ErrorFromPayload` instance, and the
  * original value is stored in a `payload`
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 const asError = (maybeError) => {
     if (maybeError instanceof Error) {
@@ -48,7 +48,7 @@ const Fail = (e) => {
 };
 function catch_(something) {
     if (something instanceof Promise) {
-        return something.then((result) => Success(result), (e) => Fail(e));
+        return something.then(Success, (e) => Fail(e));
     }
     try {
         return Success(something());
@@ -61,19 +61,19 @@ function catch_(something) {
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
  */
 exports.Result = {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
      */
     Success,
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
      */
     Fail,
     // NOTE: The JSDoc must be placed above the `catch_` function above.
@@ -83,7 +83,7 @@ exports.Result = {
      * object, applying a transformation function to the result, but retaining
      * the error as-is.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
      */
     map: (result, mapFn) => {
         const [error, resultValue] = result;
@@ -96,7 +96,7 @@ exports.Result = {
      * Unwraps a discriminated [error, result] `Result.Tuple`-like object
      * and throws if there's an error, but returns the result otherwise.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
      */
     throw: (result) => {
         if (result[0]) {

package/esm/CookieHubConsent.d.ts

@@ -218,14 +218,14 @@ export type CookieHubProviderProps = EitherObj<{
  * management script and sets up a React state object with the relevant user
  * consent flags.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#cookiehubprovider-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cookiehubprovider-component
  */
 export declare const CookieHubProvider: (props: CookieHubProviderProps) => React.JSX.Element;
 /**
  * Returns up-to-date cookie consent flags. For use in React components or hook
  * functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#usecookiehubconsent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usecookiehubconsent
  */
 export declare const useCookieHubConsent: () => Partial<CookieHubContextState['consent']>;
 export {};

package/esm/CookieHubConsent.js

@@ -35,7 +35,7 @@ const moveCookiehubScriptInDomTree = () => {
  * management script and sets up a React state object with the relevant user
  * consent flags.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#cookiehubprovider-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#cookiehubprovider-component
  */
 export const CookieHubProvider = (props) => {
     const [state, setState] = useState(initialConsentState);
@@ -107,6 +107,6 @@ export const CookieHubProvider = (props) => {
  * Returns up-to-date cookie consent flags. For use in React components or hook
  * functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#usecookiehubconsent
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#usecookiehubconsent
  */
 export const useCookieHubConsent = () => { var _a; return ((_a = useContext(CookieHubContext)) === null || _a === void 0 ? void 0 : _a.consent) || {}; };

package/esm/SiteImprove.d.ts

@@ -45,14 +45,14 @@ type SiteImproveCustomEvent = [
 /**
  * A small helper for tracking custom UI events and reporting them to SiteImrove.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#pingsiteimprove-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimprove-helper
  */
 export declare const pingSiteImprove: (category: string, action: string, label?: string) => void;
 /**
  * A small helper for reporting to SiteImrove when the user is programmatically
  * being sent to a different URL/resource.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#pingsiteimproveoutbound-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimproveoutbound-helper
  */
 export declare const pingSiteImproveOutbound: (ourl: string) => void;
 export type SiteImproveProps = EitherObj<{
@@ -94,7 +94,7 @@ export type SiteImproveProps = EitherObj<{
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across client-side (pushState, replaceState) routing.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#siteimprove-component
  */
 export declare const SiteImprove: (props: SiteImproveProps) => null;
 export {};

package/esm/SiteImprove.js

@@ -26,7 +26,7 @@ const trackDynamicPageView = (url, refUrl, title) => _emitEvent(['trackdynamic',
 /**
  * A small helper for tracking custom UI events and reporting them to SiteImrove.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#pingsiteimprove-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimprove-helper
  */
 export const pingSiteImprove = (category, action, label) => {
     if (process.env.NODE_ENV === 'development' &&
@@ -40,7 +40,7 @@ export const pingSiteImprove = (category, action, label) => {
  * A small helper for reporting to SiteImrove when the user is programmatically
  * being sent to a different URL/resource.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#pingsiteimproveoutbound-helper
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#pingsiteimproveoutbound-helper
  */
 export const pingSiteImproveOutbound = (ourl) => {
     if (process.env.NODE_ENV === 'development' &&
@@ -120,7 +120,7 @@ const loc = typeof document !== 'undefined' ? document.location : {};
  * A component for loading a SiteImprove analytics script and set up page-view
  * tracking across client-side (pushState, replaceState) routing.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#siteimprove-component
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#siteimprove-component
  */
 export const SiteImprove = (props) => {
     const consented = useResolvedAnalyticsConsent(props.hasConsented);

package/esm/async.d.ts

@@ -14,7 +14,7 @@ export declare const addLag: (length: number) => <T>(res: T) => Promise<T>;
  * Resolves as soon as all of the passed `promises` have resolved/settled,
  * or after `timeout` milliseconds — whichever comes first.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#maxwait
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#maxwait
  */
 export declare function maxWait(timeout: number, promises: Array<unknown>): Promise<void>;
 export declare function maxWait<PromiseMap extends PlainObj>(timeout: number, promises: PromiseMap): Promise<{
@@ -24,7 +24,7 @@ export declare function maxWait<PromiseMap extends PlainObj>(timeout: number, pr
  * A variation of `Promise.all()` that accepts an object with named promises
  * and returns a same-shaped object with the resolved values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#promiseallobject
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#promiseallobject
  */
 export declare const promiseAllObject: <T extends PlainObj>(promisesMap: T) => Promise<{ -readonly [K in keyof T]: Awaited<T[K]>; }>;
 export {};

package/esm/async.js

@@ -39,7 +39,7 @@ export function maxWait(timeout, promises) {
  * A variation of `Promise.all()` that accepts an object with named promises
  * and returns a same-shaped object with the resolved values.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#promiseallobject
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#promiseallobject
  */
 export const promiseAllObject = (promisesMap) => Promise.all(Object.values(promisesMap)).then((results) => {
     const keys = Object.keys(promisesMap);

package/esm/errorhandling.d.ts

@@ -2,7 +2,7 @@
  * Error subclass for thrown values that got cought and turned into an actual
  * Error, with the thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export declare class ErrorFromPayload extends Error {
     payload?: unknown;
@@ -17,28 +17,28 @@ export declare class ErrorFromPayload extends Error {
  * something else it is wrapped in a new `ErrorFromPayload` instance, and the
  * original value is stored in a `payload`
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export declare const asError: (maybeError: unknown) => ErrorFromPayload;
 type SuccessResult<T> = [error: undefined, result: T] & {
     error?: undefined;
     result: T;
 };
-type FailResult<E extends Error> = [error: E] & {
+type FailResult<E extends Error> = [error: E, result?: undefined] & {
     error: E;
     result?: undefined;
 };
 /**
  * Simple bare-bones discriminated tuple type for a [error, result] pair.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#type-resulttuple
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttuple
  */
-export type ResultTuple<T, E extends Error = Error> = [error: undefined, result: T] | [error: E];
+export type ResultTuple<T, E extends Error = Error> = [error: undefined, result: T] | [error: E, result?: undefined];
 /**
  * Discriminated tuple type for a `[error, result]` pair (same as `ResultTuple`)
  * but with named properties `error` and `result` attached for dev convenience.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#type-resulttupleobj
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#type-resulttupleobj
  */
 export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | FailResult<E>;
 /**
@@ -50,7 +50,7 @@ export type ResultTupleObj<T, E extends Error = Error> = SuccessResult<T> | Fail
  *
  * Works on both promises and sync callback functions.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultcatch
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultcatch
  */
 declare function catch_<T, E extends Error = ErrorFromPayload>(promise: Promise<T>): Promise<ResultTupleObj<T, E>>;
 declare function catch_<T, E extends Error = ErrorFromPayload>(callback: () => T): ResultTupleObj<T, E>;
@@ -58,19 +58,19 @@ declare function catch_<T, E extends Error = ErrorFromPayload>(callback: () => T
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
  */
 export declare const Result: {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
      */
     Success: <T>(result: T) => SuccessResult<T>;
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
      */
     Fail: <E extends Error = Error>(e: unknown) => FailResult<E>;
     catch: typeof catch_;
@@ -79,14 +79,14 @@ export declare const Result: {
      * object, applying a transformation function to the result, but retaining
      * the error as-is.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
      */
     map: <T_1, T2, E_1 extends Error>(result: ResultTuple<T_1, E_1>, mapFn: (resultValue: T_1) => T2) => ResultTupleObj<T2, E_1>;
     /**
      * Unwraps a discriminated [error, result] `Result.Tuple`-like object
      * and throws if there's an error, but returns the result otherwise.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
      */
     throw: <T_2>(result: ResultTuple<T_2, Error>) => T_2;
 };

package/esm/errorhandling.js

@@ -2,7 +2,7 @@
  * Error subclass for thrown values that got cought and turned into an actual
  * Error, with the thrown value as the `payload` property.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export class ErrorFromPayload extends Error {
     constructor(payload) {
@@ -23,7 +23,7 @@ export class ErrorFromPayload extends Error {
  * something else it is wrapped in a new `ErrorFromPayload` instance, and the
  * original value is stored in a `payload`
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#aserror
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#aserror
  */
 export const asError = (maybeError) => {
     if (maybeError instanceof Error) {
@@ -43,7 +43,7 @@ const Fail = (e) => {
 };
 function catch_(something) {
     if (something instanceof Promise) {
-        return something.then((result) => Success(result), (e) => Fail(e));
+        return something.then(Success, (e) => Fail(e));
     }
     try {
         return Success(something());
@@ -56,19 +56,19 @@ function catch_(something) {
  * Singleton object with small methods for creating, mapping or handling
  * `ResultTupleObj` instances.
  *
- * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#result-singleton
+ * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#result-singleton
  */
 export const Result = {
     /**
      * Factory for creating a successful `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsuccess
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsuccess
      */
     Success,
     /**
      * Factory for creating a failed `Result.TupleObj`.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resultsfail
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resultsfail
      */
     Fail,
     // NOTE: The JSDoc must be placed above the `catch_` function above.
@@ -78,7 +78,7 @@ export const Result = {
      * object, applying a transformation function to the result, but retaining
      * the error as-is.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resulmap
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulmap
      */
     map: (result, mapFn) => {
         const [error, resultValue] = result;
@@ -91,7 +91,7 @@ export const Result = {
      * Unwraps a discriminated [error, result] `Result.Tuple`-like object
      * and throws if there's an error, but returns the result otherwise.
      *
-     * @see https://github.com/reykjavikcity/webtools/blob/v0.1/README.md#resulthrow
+     * @see https://github.com/reykjavikcity/webtools/blob/v0.2/README.md#resulthrow
      */
     throw: (result) => {
         if (result[0]) {