@augment-vir/common 14.2.1 → 14.3.0

package/dist/cjs/augments/error.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeAndReturnError = exports.ensureError = exports.extractErrorMessage = exports.combineErrorMessages = exports.combineErrors = void 0;
+exports.executeAndReturnError = exports.wrapInTry = exports.ensureError = exports.extractErrorMessage = exports.combineErrorMessages = exports.combineErrors = void 0;
 const __1 = require("..");
 function combineErrors(errors) {
     if (!errors || errors.length === 0) {
@@ -41,6 +41,20 @@ function ensureError(input) {
     }
 }
 exports.ensureError = ensureError;
+function wrapInTry(inputs) {
+    try {
+        return inputs.callback();
+    }
+    catch (error) {
+        if (inputs.catchCallback) {
+            return inputs.catchCallback(error);
+        }
+        else {
+            return inputs.fallbackValue;
+        }
+    }
+}
+exports.wrapInTry = wrapInTry;
 function executeAndReturnError(callback) {
     let caughtError;
     try {

package/dist/esm/augments/error.js

@@ -34,6 +34,19 @@ export function ensureError(input) {
         return new Error(extractErrorMessage(input));
     }
 }
+export function wrapInTry(inputs) {
+    try {
+        return inputs.callback();
+    }
+    catch (error) {
+        if (inputs.catchCallback) {
+            return inputs.catchCallback(error);
+        }
+        else {
+            return inputs.fallbackValue;
+        }
+    }
+}
 export function executeAndReturnError(callback) {
     let caughtError;
     try {

package/dist/types/augments/error.d.ts

@@ -1,3 +1,4 @@
+import { RequireExactlyOne } from 'type-fest';
 import { AtLeastTuple, NoInputsFunction, UnPromise } from '..';
 export declare function combineErrors(errors: AtLeastTuple<Error, 1>): Error;
 export declare function combineErrors(errors: ReadonlyArray<never>): undefined;
@@ -6,5 +7,12 @@ export declare function combineErrors(errors?: undefined): undefined;
 export declare function combineErrorMessages(errors?: ReadonlyArray<Error | string | undefined> | undefined): string;
 export declare function extractErrorMessage(error: unknown): string;
 export declare function ensureError(input: unknown): Error;
+export type TryWrapInputs<CallbackReturn, FallbackReturn> = {
+    callback: () => CallbackReturn;
+} & RequireExactlyOne<{
+    fallbackValue: FallbackReturn;
+    catchCallback: (error: unknown) => FallbackReturn;
+}>;
+export declare function wrapInTry<CallbackReturn, FallbackReturn>(inputs: TryWrapInputs<CallbackReturn, FallbackReturn>): FallbackReturn | CallbackReturn;
 export declare function executeAndReturnError<CallbackGeneric extends NoInputsFunction<PromiseLike<any>>>(callback: CallbackGeneric): Promise<Error | UnPromise<ReturnType<CallbackGeneric>>>;
 export declare function executeAndReturnError<CallbackGeneric extends NoInputsFunction>(callback: CallbackGeneric): Error | ReturnType<CallbackGeneric>;

package/dist/types/augments/object/nested-keys.d.ts

@@ -1,11 +1,11 @@
 import { UnionToIntersection } from 'type-fest';
 import { PropertyValueType } from './object';
 export type NestedSequentialKeys<ObjectGeneric extends object> = PropertyValueType<{
-    [Prop in keyof ObjectGeneric]: NonNullable<ObjectGeneric[Prop]> extends object ? [Prop, ...(NestedSequentialKeys<NonNullable<ObjectGeneric[Prop]>> | [])] : [Prop];
+    [Prop in keyof ObjectGeneric]: NonNullable<ObjectGeneric[Prop]> extends object ? Readonly<[Prop, ...(NestedSequentialKeys<NonNullable<ObjectGeneric[Prop]>> | [])]> : Readonly<[Prop]>;
 }>;
 export type NestedKeys<ObjectGeneric extends object> = UnionToIntersection<Extract<PropertyValueType<ObjectGeneric>, object>> extends object ? [
     keyof ObjectGeneric,
     ...(NestedKeys<UnionToIntersection<Extract<PropertyValueType<ObjectGeneric>, object>>> | [])
 ] : [keyof ObjectGeneric];
 export type NestedValue<ObjectGeneric extends object, NestedKeysGeneric extends NestedSequentialKeys<ObjectGeneric>> = NestedKeysGeneric extends readonly [infer FirstEntry, ...infer FollowingEntries] ? FirstEntry extends keyof ObjectGeneric ? FollowingEntries extends never[] ? ObjectGeneric[FirstEntry] : ObjectGeneric[FirstEntry] extends object ? FollowingEntries extends NestedSequentialKeys<ObjectGeneric[FirstEntry]> ? NestedValue<ObjectGeneric[FirstEntry], FollowingEntries> : never : never : never : never;
-export declare function getValueFromNestedKeys<ObjectGeneric extends object, KeysGeneric extends NestedSequentialKeys<ObjectGeneric>>(inputObject: ObjectGeneric, nestedKeys: KeysGeneric): NestedValue<ObjectGeneric, KeysGeneric> | undefined;
+export declare function getValueFromNestedKeys<const ObjectGeneric extends object, const KeysGeneric extends NestedSequentialKeys<ObjectGeneric>>(inputObject: ObjectGeneric, nestedKeys: KeysGeneric): NestedValue<ObjectGeneric, KeysGeneric> | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "14.2.1",
+    "version": "14.3.0",
     "homepage": "https://github.com/electrovir/augment-vir/tree/main/packages/common",
     "bugs": {
         "url": "https://github.com/electrovir/augment-vir/issues"
@@ -27,7 +27,7 @@
         "type-fest": "^3.11.1"
     },
     "devDependencies": {
-        "typescript": "^5.0.4"
+        "typescript": "^5.1.3"
     },
     "publishConfig": {
         "access": "public"