@aidc-toolkit/app-extension 1.0.45-beta → 1.0.45

package/dist/lib-proxy.js

@@ -1,276 +0,0 @@
-import { mapIterable } from "@aidc-toolkit/utility";
-import { i18nextAppExtension } from "./locale/i18n.js";
-/**
- * Library proxy.
- *
- * @template ThrowError
- * If true, errors are reported through the throw/catch mechanism.
- *
- * @template TError
- * Error type.
- *
- * @template TInvocationContext
- * Application-specific invocation context type.
- *
- * @template TStreamingInvocationContext
- * Application-specific streaming invocation context type.
- *
- * @template TBigInt
- * Type to which big integer is mapped.
- */
-export class LibProxy {
-    /**
-     * Application extension.
-     */
-    #appExtension;
-    /**
-     * Constructor.
-     *
-     * @param appExtension
-     * Application extension.
-     */
-    constructor(appExtension) {
-        this.#appExtension = appExtension;
-    }
-    /**
-     * Get the application extension.
-     */
-    get appExtension() {
-        return this.#appExtension;
-    }
-    /**
-     * Map big integer to another type if necessary.
-     *
-     * @param value
-     * Big integer value to map.
-     *
-     * @returns
-     * Mapped big integer value.
-     */
-    mapBigInt(value) {
-        return this.#appExtension.mapBigInt(value);
-    }
-    /**
-     * Handle an error thrown by a function call. Return type is {@linkcode SingletonResult} to ensure assignment
-     * compatibility.
-     *
-     * @param e
-     * Error.
-     *
-     * @returns
-     * Error if errors are not thrown.
-     */
-    #handleError(e) {
-        let result;
-        if (e instanceof RangeError) {
-            const error = this.#appExtension.mapRangeError(e);
-            if (this.#appExtension.throwError) {
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type is determined by application mapping.
-                throw error;
-            }
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Won't get here if ThrowError is false so result is TError.
-            result = error;
-        }
-        else {
-            // Unknown error; pass on to application extension.
-            result = this.appExtension.handleError(e instanceof Error ? e.message : String(e));
-        }
-        return result;
-    }
-    /**
-     * Call a singleton result function with error handling.
-     *
-     * @param callback
-     * Callback.
-     *
-     * @returns
-     * Callback return or error if errors are not thrown.
-     */
-    singletonResult(callback) {
-        let result;
-        try {
-            result = callback();
-        }
-        catch (e) {
-            result = this.#handleError(e);
-        }
-        return result;
-    }
-    /**
-     * Call a matrix result function with error handling.
-     *
-     * @param matrixValues
-     * Matrix of values.
-     *
-     * @param valueCallback
-     * Callback to process value.
-     *
-     * @returns
-     * Matrix of callback results and errors if errors are not thrown.
-     */
-    matrixResult(matrixValues, valueCallback) {
-        return matrixValues.map(rowValues => rowValues.map(value => this.singletonResult(() => valueCallback(value))));
-    }
-    /**
-     * Map a matrix of validate string results to boolean. If the string is empty, the result is true, indicating that
-     * there is no error.
-     *
-     * @param matrixValidateResults
-     * Matrix of results from a call to a validate function.
-     *
-     * @returns
-     * Matrix of boolean values, true if corresponding string is empty.
-     */
-    isValidString(matrixValidateResults) {
-        return matrixValidateResults.map(rowValues => rowValues.map(value => (validateResult => validateResult === "")(value)));
-    }
-    /**
-     * Set up a mapping and call a matrix result function with error handling.
-     *
-     * @param setUpCallback
-     * Callback to set up the mapping.
-     *
-     * @param matrixValues
-     * Matrix of values.
-     *
-     * @param valueCallback
-     * Callback to process value.
-     *
-     * @returns
-     * Matrix of callback results and errors if errors are not thrown.
-     */
-    setUpMatrixResult(setUpCallback, matrixValues, valueCallback) {
-        let result;
-        try {
-            result = matrixValues.map(rowValues => rowValues.map(value => this.singletonResult(() => valueCallback(setUpCallback(), value))));
-        }
-        catch (e) {
-            result = [[this.#handleError(e)]];
-        }
-        return result;
-    }
-    /**
-     * Do the callback for an array return.
-     *
-     * @param value
-     * Value.
-     *
-     * @param callback
-     * Callback.
-     *
-     * @returns
-     * Callback result or error as array if errors are not thrown.
-     */
-    #arrayCallback(value, callback) {
-        const result = this.singletonResult(() => callback(value));
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- If result is not an array, it must be an error.
-        return result instanceof Array ? result : [result];
-    }
-    /**
-     * Call an array result function with error handling and map to a matrix.
-     *
-     * @param matrixValues
-     * Matrix of values.
-     *
-     * @param callback
-     * Callback.
-     *
-     * @returns
-     * Matrix of callback results and errors if errors are not thrown.
-     */
-    arrayResult(matrixValues, callback) {
-        let result;
-        if (matrixValues.length === 0) {
-            // Special case; unlikely to occur.
-            result = [[]];
-        }
-        else if (matrixValues.length === 1) {
-            result = [];
-            matrixValues[0].forEach((value, columnIndex) => {
-                const arrayResult = this.#arrayCallback(value, callback);
-                arrayResult.forEach((resultError, rowIndex) => {
-                    // Append a row if necessary.
-                    if (result.length <= rowIndex) {
-                        result.push([]);
-                    }
-                    // Assignment will automatically expand row to the number of columns in the matrix.
-                    result[rowIndex][columnIndex] = resultError;
-                });
-            });
-        }
-        else {
-            result = matrixValues.map((rowValue) => {
-                let arrayResult;
-                if (rowValue.length === 0) {
-                    // Special case; unlikely to occur.
-                    arrayResult = [];
-                }
-                else if (rowValue.length === 1) {
-                    arrayResult = this.#arrayCallback(rowValue[0], callback);
-                }
-                else {
-                    arrayResult = [this.#handleError(new RangeError(i18nextAppExtension.t("Proxy.matrixMustBeArray")))];
-                }
-                return arrayResult;
-            });
-        }
-        return result;
-    }
-    /**
-     * Call a matrix result function with error handling and map a non-error result to an empty string and {@linkcode
-     * RangeError} to the string error message.
-     *
-     * @param matrixValues
-     * Matrix of values.
-     *
-     * @param callback
-     * Callback that either returns or throws an exception.
-     *
-     * @returns
-     * Matrix of strings.
-     */
-    matrixErrorResult(matrixValues, callback) {
-        return matrixValues.map(rowValues => rowValues.map((value) => {
-            let result;
-            try {
-                callback(value);
-                // No error; return empty string.
-                result = "";
-            }
-            catch (e) {
-                if (e instanceof RangeError) {
-                    // Library error; return error message.
-                    result = e.message;
-                }
-                else {
-                    // Unknown error; pass up the stack.
-                    throw e;
-                }
-            }
-            return result;
-        }));
-    }
-    /**
-     * Call an iterable result function with error handling and map to a matrix. Although the natural approach would be
-     * to map to a single-element array containing an array of *N* results (i.e., [[r0, r1, r2, ..., r*N*]]), this is
-     * rendered visually as a single row. The more readable approach is as a single column, so the mapping is to an
-     * *N*-element array of single-element result arrays (i.e., [[r0], [r1], [r2], ..., [r*N*]]).
-     *
-     * @param iterableCallback
-     * Iterable callback.
-     *
-     * @returns
-     * Matrix of callback results.
-     */
-    iterableResult(iterableCallback) {
-        let result;
-        try {
-            result = Array.from(mapIterable(iterableCallback(), result => [result]));
-        }
-        catch (e) {
-            result = [[this.#handleError(e)]];
-        }
-        return result;
-    }
-}
-//# sourceMappingURL=lib-proxy.js.map

package/dist/lib-proxy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lib-proxy.js","sourceRoot":"","sources":["../src/lib-proxy.ts"],"names":[],"mappings":"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"}