@genesislcap/foundation-state-machine 14.70.0

package/dist/dts/index.federated.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.federated.d.ts.map

package/dist/dts/index.federated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.federated.d.ts","sourceRoot":"","sources":["../../src/index.federated.ts"],"names":[],"mappings":""}

package/dist/dts/machines/fetch/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * NetworkError.
+ * @remarks
+ * Failed to reach server.
+ * @public
+ */
+export declare class NetworkError extends Error {
+    url: string;
+    constructor(url: string, message?: string);
+}
+/**
+ * APIError.
+ * @remarks
+ * Bad server `Response`.
+ * @public
+ */
+export declare class APIError extends Error {
+    status: number;
+    data?: unknown;
+    constructor(status: number, data?: unknown, message?: string);
+}
+/**
+ * @param error - An error.
+ * @public
+ */
+export declare const isAPIError: (error: unknown) => boolean;
+/**
+ * @param error - An error.
+ * @public
+ */
+export declare const isNetworkError: (error: unknown) => boolean;
+/**
+ * @param error - An error.
+ * @public
+ */
+export declare const isNotFoundError: (error: {
+    status?: number;
+}) => boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/dts/machines/fetch/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/machines/fetch/errors.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAE5B,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM,EAClB,OAAO,GAAE,MAAiC;CAM7C;AAED;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAExB,MAAM,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,OAAO;gBADd,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACrB,OAAO,GAAE,MAA6B;CAMzC;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,UAAW,OAAO,YAA8B,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAW,OAAO,YAEwB,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,eAAe,UAAW;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,YACG,CAAC"}

package/dist/dts/machines/fetch/index.d.ts

@@ -0,0 +1,5 @@
+export * from './errors';
+export * from './policies';
+export * from './types';
+export * from './machine';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/machines/fetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/machines/fetch/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}

package/dist/dts/machines/fetch/machine.d.ts

@@ -0,0 +1,57 @@
+import type { IMergedPolicy } from 'cockatiel';
+import type { InterpreterOptions } from 'xstate';
+import { AbstractMachine, Machine } from '../../core';
+import type { FetchMachineContext, FetchMachineEvent, ResponseDataExtractor, ResponseOkChecker } from './types';
+/**
+ * FetchConfig interface.
+ * @public
+ */
+export interface FetchConfig {
+    /**
+     * Defaults to {@link typescript#fetch}.
+     * @privateRemarks
+     * This config property allows us to mock {@link typescript#Response | responses} during testing.
+     */
+    fetcher: typeof fetch;
+    /**
+     * Defaults to {@link defaultFetchPolicy}
+     */
+    fetchPolicy?: IMergedPolicy<any, any, any>;
+    /**
+     * Defaults to {@link defaultResponseOkChecker}
+     */
+    responseOkChecker?: ResponseOkChecker;
+    /**
+     * Defaults to {@link defaultResponseDataExtractor}
+     */
+    responseDataExtractor?: ResponseDataExtractor;
+}
+/**
+ * FetchConfig DI key.
+ * @internal
+ */
+export declare const FetchConfig: import("@microsoft/fast-foundation").InterfaceSymbol<FetchConfig>;
+/**
+ * FetchMachine interface.
+ * @public
+ */
+export interface FetchMachine extends Machine<FetchMachineContext, FetchMachineEvent> {
+}
+/**
+ * Default FetchMachine.
+ * @public
+ */
+export declare class DefaultFetchMachine extends AbstractMachine<FetchMachineContext, FetchMachineEvent> implements FetchMachine {
+    private config;
+    constructor(config?: FetchConfig);
+    /** {@inheritDoc Machine.start} */
+    start(options?: InterpreterOptions<typeof this.machine>): void;
+    /** {@inheritDoc Machine.getFromContainer} */
+    getFromContainer(): this;
+}
+/**
+ * FetchMachine DI key.
+ * @internal
+ */
+export declare const FetchMachine: import("@microsoft/fast-foundation").InterfaceSymbol<FetchMachine>;
+//# sourceMappingURL=machine.d.ts.map

package/dist/dts/machines/fetch/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../../../../src/machines/fetch/machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,OAAO,EACL,eAAe,EAOf,OAAO,EAER,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAEjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,OAAO,EAAE,OAAO,KAAK,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C;;OAEG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;OAEG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,mEAAoC,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;CAAG;AAExF;;;GAGG;AACH,qBAAa,mBACX,SAAQ,eAAe,CAAC,mBAAmB,EAAE,iBAAiB,CAC9D,YAAW,YAAY;IAEY,OAAO,CAAC,MAAM;gBAAN,MAAM,cAAqB;IAkMtE,kCAAkC;IAClC,KAAK,CACH,OAAO,GAAE,kBAAkB,CAAC,OAAO,IAAI,CAAC,OAAO,CAE9C;IAKH,6CAA6C;IAC7C,gBAAgB,IAAI,IAAI;CAGzB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,oEAExB,CAAC"}

package/dist/dts/machines/fetch/policies.d.ts

@@ -0,0 +1,25 @@
+import type { IBackoffFactory, IRetryBackoffContext } from 'cockatiel';
+import { StatusCodes } from 'http-status-codes';
+/**
+ * Default retry stats codes.
+ * @public
+ */
+export declare const defaultRetryStatsCodes: StatusCodes[];
+/**
+ * A fetch policy factory.
+ * @remarks
+ * Will retry network errors and responses with certain status codes up to the specified max attempts.
+ * @param maxAttempts - Max attempts. Defaults to `2`.
+ * @param retryCodes - Status code array to retry. Defaults to {@link defaultRetryStatsCodes}.
+ * @param backoff - Backoff algo. Defaults to {@link cockatiel#ExponentialBackoff}.
+ * @param timeoutDuration - Timeout duration. Defaults to 3 seconds.
+ * @param logEvents - Log events to the console. Defaults to `true`.
+ * @public
+ */
+export declare const createFetchPolicy: (maxAttempts?: number, retryCodes?: StatusCodes[] | number[], backoff?: IBackoffFactory<IRetryBackoffContext<unknown>>, timeoutDuration?: number, logEvents?: boolean) => import("cockatiel").IMergedPolicy<import("cockatiel").IRetryContext & import("cockatiel").ICancellationContext, never, [import("cockatiel").RetryPolicy, import("cockatiel").TimeoutPolicy]>;
+/**
+ * The default fetch policy.
+ * @public
+ */
+export declare const defaultFetchPolicy: import("cockatiel").IMergedPolicy<import("cockatiel").IRetryContext & import("cockatiel").ICancellationContext, never, [import("cockatiel").RetryPolicy, import("cockatiel").TimeoutPolicy]>;
+//# sourceMappingURL=policies.d.ts.map

package/dist/dts/machines/fetch/policies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../../../../src/machines/fetch/policies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,eAOlC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,iBACf,MAAM,eACP,WAAW,EAAE,GAAG,MAAM,EAAE,YAC3B,gBAAgB,qBAAqB,OAAO,CAAC,CAAC,oBACtC,MAAM,cACZ,OAAO,iMAmBnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,8LAAsB,CAAC"}

package/dist/dts/machines/fetch/types.d.ts

@@ -0,0 +1,118 @@
+/// <reference types="webappsec-credential-management" />
+import type { DoneInvokeEvent, ErrorEvent } from 'xstate';
+import type { MachineContext } from '../../core';
+import type { FetchConfig } from './machine';
+/**
+ * FetchMachineContext interface.
+ * @remarks
+ * Transient state during the machine's execution.
+ * @public
+ */
+export interface FetchMachineContext extends MachineContext {
+    /**
+     * The params of the fetch request.
+     */
+    params: {
+        url: string;
+        /**
+         * See {@link typescript#RequestInit} or {@link typescript#CMRequestInit}.
+         */
+        requestInit?: RequestInit | CMRequestInit;
+        /**
+         * Individual fetch requests can provide fetch config overrides when necessary.
+         */
+        fetchConfig?: FetchConfig;
+    };
+    /**
+     * The abort controller of the fetch request.
+     */
+    controller: AbortController;
+    /**
+     * The fetch response.
+     */
+    response: Response | undefined;
+    /**
+     * The extracted response data.
+     */
+    data: any;
+}
+/**
+ * FetchMachineOutput type.
+ * @remarks
+ * The output of the machine when it reaches it's final state, which is provided to host machines via handlers.
+ * @public
+ */
+export type FetchMachineOutput<TData = any> = Partial<Pick<FetchMachineContext, 'response' | 'error'>> & {
+    data: TData;
+};
+/**
+ * FetchMachineEvent type.
+ * @remarks
+ * The send action events used to invoke the machine.
+ * @public
+ */
+export type FetchMachineEvent = {
+    type: 'fetch';
+    params: FetchMachineContext['params'];
+} | {
+    type: 'cancel';
+} | DoneInvokeEvent<unknown> | ErrorEvent<unknown>;
+/**
+ * FetchMachineEventMap type.
+ * @remarks
+ * The mediation CustomEvent used to invoke machine actions.
+ * @public
+ */
+export type FetchMachineEventMap = {
+    'fetch-machine-event': FetchMachineEvent;
+};
+/**
+ * ResponseOkChecker type.
+ * @privateRemarks
+ * Genesis HTTP-Based APIs may provide unexpected status codes, so special handling can be required.
+ * @param response - The {@link typescript#Response}.
+ * @returns A boolean to indicate if the response is ok.
+ * @public
+ */
+export type ResponseOkChecker = (response: Response) => boolean;
+/**
+ * {@inheritDoc ResponseOkChecker}
+ * @public
+ */
+export declare const defaultResponseOkChecker: ResponseOkChecker;
+/**
+ * ResponseDataExtractor type.
+ * @remarks
+ * Extracts data from the {@link typescript#Response} and processes it accordingly. The default data extractor will inspect
+ * `content-type` and call `JSON.parse()` if it includes `application/json`. Custom data extractors can be used here.
+ * @privateRemarks
+ * Need to find out if the Genesis http layer returns mixed responses. If needed we can catch and return just the text.
+ * @typeParam TData - The expected data type. Defaults to any;
+ * @param response - The {@link typescript#Response}.
+ * @returns The extracted data.
+ * @public
+ */
+export type ResponseDataExtractor<TData = any> = (response: Response) => Promise<TData>;
+/**
+ * {@inheritDoc ResponseDataExtractor}
+ * @public
+ */
+export declare const defaultResponseDataExtractor: ResponseDataExtractor;
+/**
+ * Creates an extractor that applies a deserializer to the extracted response data.
+ * @param deserializer - The deserializer to apply.
+ * @param extractor - An optional data extractor. Defaults to {@link defaultResponseDataExtractor}.
+ * @public
+ */
+export declare const createResponseDataExtractorWithDeserializer: <TInput = any, TOutput = any>(deserializer: (data: TInput) => Promise<TOutput>, extractor?: ResponseDataExtractor) => ResponseDataExtractor;
+/**
+ * The default fetch config.
+ * @public
+ */
+export declare const defaultFetchConfig: FetchConfig;
+/**
+ * Default FetchMachineContext.
+ * @public
+ */
+export declare const defaultFetchMachineContext: Partial<FetchMachineContext>;
+//# sourceMappingURL=types.d.ts.map

package/dist/dts/machines/fetch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/machines/fetch/types.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD;;OAEG;IACH,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ;;WAEG;QACH,WAAW,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;QAC1C;;WAEG;QACH,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,CAAC;IACF;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC;IAC5B;;OAEG;IACH,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,IAAI,EAAE,GAAG,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,GAAG,GAAG,IAAI,OAAO,CACnD,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,OAAO,CAAC,CAChD,GAAG;IACF,IAAI,EAAE,KAAK,CAAC;CACb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACvC,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;CAChB,GACD,eAAe,CAAC,OAAO,CAAC,GACxB,UAAU,CAAC,OAAO,CAAC,CAAC;AAExB;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,qBAAqB,EAAE,iBAAiB,CAAC;CAC1C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAAuD,CAAC;AAE/F;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;AAExF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,qBAO1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2CAA2C,8FAGzC,qBAAqB,KAC/B,qBAIF,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAKhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,OAAO,CAAC,mBAAmB,CAKnE,CAAC"}

package/dist/dts/machines/index.d.ts

@@ -0,0 +1,2 @@
+export * from './fetch';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/machines/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/machines/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/dts/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.34.9"
+    }
+  ]
+}

package/dist/dts/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/dts/utils/logger.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @public
+ */
+export declare const logger: import("@genesislcap/foundation-utils").Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/dts/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,MAAM,gDAA2C,CAAC"}

package/dist/esm/core/actions.js

@@ -0,0 +1,46 @@
+import { createErrorMap } from '@genesislcap/foundation-utils';
+import { assign } from 'xstate';
+import { escalate } from 'xstate/actions';
+import { logger } from '../utils';
+import { isErrorEvent } from './guards';
+/**
+ * Set error action.
+ * @remarks
+ * Used to set a top level error on the machine. This may equal to {@link @genesislcap/foundation-utils#ErrorMap} `lastError` in the `errors` property.
+ * @public
+ */
+export const setError = assign(({ event }) => {
+    logger.debug('setError', event, isErrorEvent(event));
+    if (isErrorEvent(event)) {
+        return {
+            error: event.data,
+        };
+    }
+});
+/**
+ * Set error by key action.
+ * @remarks
+ * Used to set an error in the {@link @genesislcap/foundation-utils#ErrorMap} by key.
+ * @param key - The error key.
+ * @public
+ */
+export const setErrorByKey = (key) => assign(({ context, event }) => {
+    var _a;
+    if (isErrorEvent(event)) {
+        const errors = (_a = context.errors) !== null && _a !== void 0 ? _a : createErrorMap(logger.error);
+        errors.set(key, event.data);
+        return {
+            errors,
+        };
+    }
+});
+/**
+ * Escalate error action.
+ * @remarks
+ * Guard this call with a parent check to avoid warnings when there's no parent.
+ * @public
+ */
+export const escalateError = escalate(({ context }) => ({
+    error: context.error,
+    data: context.error,
+}));

package/dist/esm/core/binding.js

@@ -0,0 +1,16 @@
+/**
+ * @typeParam TTarget - The target interface.
+ * @param args - Binding args.
+ * @internal
+ */
+export const getBindArgs = (...args) => {
+    const [token] = args;
+    let binding = (x) => x;
+    if (typeof token === 'function') {
+        binding = token;
+    }
+    else if (typeof token === 'string') {
+        binding = (x) => x[token];
+    }
+    return binding;
+};

package/dist/esm/core/errors.js

@@ -0,0 +1,70 @@
+/**
+ * GenesisServerError.
+ * @remarks
+ * Represents an error received from a Genesis Server.
+ * @public
+ */
+export class GenesisServerError extends Error {
+    constructor(sent, received, message = 'Genesis Server Error Occurred') {
+        super(message);
+        this.sent = sent;
+        this.received = received;
+        this.name = 'GenesisServerError';
+        Object.setPrototypeOf(this, GenesisServerError.prototype);
+    }
+    /**
+     * Capture known edge cases.
+     * @privateRemarks
+     * This is ugly, lets figure out if this is still an issue and remove if not.
+     */
+    isIgnorableError() {
+        var _a, _b, _c, _d;
+        if ((_d = (_c = (_b = (_a = this.received) === null || _a === void 0 ? void 0 : _a.DETAILS) === null || _b === void 0 ? void 0 : _b.ERROR) === null || _c === void 0 ? void 0 : _c.toLowerCase()) === null || _d === void 0 ? void 0 : _d.includes('request needs the user to be logged')) {
+            return true;
+        }
+        return false;
+    }
+    getMessageError() {
+        var _a, _b;
+        return Array.isArray((_a = this.received) === null || _a === void 0 ? void 0 : _a.ERROR)
+            ? (_b = this.received) === null || _b === void 0 ? void 0 : _b.ERROR.map((error) => this.errorDetailFormatter(error)).join('\n')
+            : '';
+    }
+    getDetailsError() {
+        var _a, _b, _c, _d;
+        return Array.isArray((_b = (_a = this.received) === null || _a === void 0 ? void 0 : _a.DETAILS) === null || _b === void 0 ? void 0 : _b.ERROR)
+            ? (_d = (_c = this.received) === null || _c === void 0 ? void 0 : _c.DETAILS) === null || _d === void 0 ? void 0 : _d.ERROR.map((error) => this.errorDetailFormatter(error)).join('\n')
+            : '';
+    }
+    hasErrorCode(code) {
+        var _a, _b;
+        return Array.isArray((_a = this.received) === null || _a === void 0 ? void 0 : _a.ERROR)
+            ? (_b = this.received) === null || _b === void 0 ? void 0 : _b.ERROR.some((error) => error.CODE === code)
+            : false;
+    }
+    errorDetailFormatter(error) {
+        return `\n ${error.CODE}: \n ${error.TEXT}`;
+    }
+}
+/**
+ * @param error - An error.
+ * @public
+ */
+export const isGenesisServerError = (error) => error instanceof GenesisServerError;
+/**
+ * MappingError.
+ * @public
+ */
+export class MappingError extends Error {
+    constructor(dto, message = 'Mapping Error Occurred') {
+        super(message);
+        this.dto = dto;
+        this.name = 'MappingError';
+        Object.setPrototypeOf(this, MappingError.prototype);
+    }
+}
+/**
+ * @param error - An error.
+ * @public
+ */
+export const isMappingError = (error) => error instanceof MappingError;

package/dist/esm/core/guards.js

@@ -0,0 +1,73 @@
+import { TaskCancelledError } from 'cockatiel';
+/**
+ * assertEvent.
+ * @privateRemarks
+ * Note `asserts` need to be functions to work.
+ * @param event - An event.
+ * @param type - An event type.
+ * @public
+ */
+export function assertEvent(event, type) {
+    if (event.type !== type) {
+        throw new Error(`${type} event type expected, received ${event.type}.`);
+    }
+}
+/**
+ * isDoneInvokeEvent.
+ * @param event - An event.
+ * @public
+ */
+export const isDoneInvokeEvent = (event) => /^done.invoke/.test(event.type);
+/**
+ * isErrorEvent.
+ * @param event - An event.
+ * @public
+ */
+export const isErrorEvent = (event) => /^error.platform/.test(event.type);
+/**
+ * isErrorCustomEvent.
+ * @remarks
+ * What `escalate` from a child is typed as.
+ * @param event - An event.
+ * @public
+ */
+export const isErrorCustomEvent = (event) => /^xstate.error/.test(event.type);
+/**
+ * isActorErrorEvent.
+ * @param actorId - An actor id.
+ * @param event - An event.
+ * @public
+ */
+export const isActorErrorEvent = (actorId, event) => { var _a, _b; return ((_a = event.type) === null || _a === void 0 ? void 0 : _a.includes('error')) && ((_b = event.type) === null || _b === void 0 ? void 0 : _b.includes(actorId)); };
+/**
+ * isErrorType.
+ * @param type - An event type.
+ * @public
+ */
+export const isErrorType = (type) => (event) => {
+    if (isErrorEvent(event)) {
+        return event.data instanceof type;
+    }
+    return false;
+};
+/**
+ * isTypeError.
+ * @public
+ */
+export const isTypeError = ({ event }) => isErrorType(TypeError)(event);
+/**
+ * isSyntaxError.
+ * @public
+ */
+export const isSyntaxError = ({ event }) => isErrorType(SyntaxError)(event);
+/**
+ * isAbortError.
+ * @public
+ */
+export const isAbortError = ({ event }) => {
+    if (isErrorEvent(event)) {
+        return ((event.data instanceof DOMException && event.data.code == DOMException.ABORT_ERR) ||
+            event.data instanceof TaskCancelledError);
+    }
+    return false;
+};

package/dist/esm/core/index.js

@@ -0,0 +1,7 @@
+export * from './actions';
+export * from './binding';
+export * from './errors';
+export * from './guards';
+export * from './inputs';
+export * from './machine';
+export * from './state';

package/dist/esm/core/inputs.js

@@ -0,0 +1,10 @@
+/**
+ * Error workflow input.
+ * @param key - An error key.
+ * @public
+ */
+export const errorWorkflowInput = (key) => ({ context }) => ({
+    errorKey: key,
+    errorValue: context.errors.get(key),
+    errorMap: context.errors,
+});