@augment-vir/common 31.68.0 → 31.68.2

package/dist/augments/function/wrap-in-try.d.ts

@@ -1,4 +1,5 @@
-import { type NoInputsFunction, type PartialWithUndefined } from '@augment-vir/core';
+import { type NoInputsFunction } from '@augment-vir/core';
+import { type RequireOneOrNone } from 'type-fest';
 /**
  * Options for {@link wrapInTry}.
  *
@@ -6,7 +7,7 @@ import { type NoInputsFunction, type PartialWithUndefined } from '@augment-vir/c
  * @category Package : @augment-vir/common
  * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
  */
-export type WrapInTryOptions<FallbackValue> = PartialWithUndefined<{
+export type WrapInTryOptions<FallbackValue> = RequireOneOrNone<{
     /**
      * Call this function if the callback passed to {@link wrapInTry} throws an error. The thrown
      * error is passed to this function. If a `fallbackValue` option is also provided, it will be
@@ -29,18 +30,18 @@ export declare function wrapInTry<Value>(callback: NoInputsFunction<Value>, opti
 }): Error | Value;
 export declare function wrapInTry<Value extends Promise<any>, FallbackValue = undefined>(callback: NoInputsFunction<Value>, options: {
     handleError: (error: unknown) => FallbackValue;
-    fallbackValue?: FallbackValue;
+    fallbackValue?: never;
 }): Promise<Awaited<FallbackValue> | Awaited<Value>>;
 export declare function wrapInTry<Value, FallbackValue = undefined>(callback: NoInputsFunction<Value>, options: {
     handleError: (error: unknown) => FallbackValue;
-    fallbackValue?: FallbackValue;
+    fallbackValue?: never;
 }): FallbackValue | Value;
 export declare function wrapInTry<Value extends Promise<any>, FallbackValue = undefined>(callback: NoInputsFunction<Value>, options: {
-    handleError?: ((error: unknown) => FallbackValue) | undefined;
+    handleError?: never;
     fallbackValue: FallbackValue;
 }): Promise<Awaited<FallbackValue> | Awaited<Value>>;
 export declare function wrapInTry<Value, FallbackValue = undefined>(callback: NoInputsFunction<Value>, options: {
-    handleError?: ((error: unknown) => FallbackValue) | undefined;
+    handleError?: never;
     fallbackValue: FallbackValue;
 }): FallbackValue | Value;
 export declare function wrapInTry<Value extends Promise<any>, FallbackValue = undefined>(callback: NoInputsFunction<Value>, options?: WrapInTryOptions<FallbackValue> | undefined): Promise<FallbackValue | Value | Error>;

package/dist/augments/function/wrap-in-try.js

@@ -1,5 +1,5 @@
 import { check } from '@augment-vir/assert';
-import { ensureError, } from '@augment-vir/core';
+import { ensureError } from '@augment-vir/core';
 /**
  * Calls the callback and returns its output. If the callback throws an error, it is handled in the
  * following ways:

package/dist/augments/json/copy-through-json.d.ts

@@ -1,11 +1,9 @@
-import { type JsonCompatibleValue, type PartialWithUndefined } from '@augment-vir/core';
+import { type JsonCompatibleValue } from '@augment-vir/core';
 import { type IsUnknown, type Jsonify, type Writable } from 'type-fest';
 /**
  * Deeply copy an object through JSON. This is the fastest deep copy, but the input must already be
  * JSON serializable otherwise the copy will not match the original.
  *
- * Note that this will truncate inputs if they are not safe to serialize.
- *
  * @category JSON : Common
  * @category Copy
  * @category Package : @augment-vir/common
@@ -34,6 +32,13 @@ import { type IsUnknown, type Jsonify, type Writable } from 'type-fest';
  *
  * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
  */
-export declare function copyThroughJson<const T>(input: T, { enableUnsafeCopyAll, }?: Readonly<PartialWithUndefined<{
-    enableUnsafeCopyAll: boolean;
-}>> | undefined): IsUnknown<T> extends true ? JsonCompatibleValue : Writable<Jsonify<T>>;
+export declare function copyThroughJson<const T>(input: T): IsUnknown<T> extends true ? JsonCompatibleValue : Writable<Jsonify<T>>;
+/**
+ * Same as {@link copyThroughJson} but this uses safe serialization from {@link safeJsonStringify}.
+ *
+ * @category JSON : Common
+ * @category Copy
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export declare function safeCopyThroughJson<const T>(input: T): IsUnknown<T> extends true ? JsonCompatibleValue : Writable<Jsonify<T>>;

package/dist/augments/json/copy-through-json.js

@@ -1,10 +1,9 @@
+import { ensureErrorAndPrependMessage } from '@augment-vir/core';
 import { safeJsonStringify } from './safe-json-stringify.js';
 /**
  * Deeply copy an object through JSON. This is the fastest deep copy, but the input must already be
  * JSON serializable otherwise the copy will not match the original.
  *
- * Note that this will truncate inputs if they are not safe to serialize.
- *
  * @category JSON : Common
  * @category Copy
  * @category Package : @augment-vir/common
@@ -33,14 +32,31 @@ import { safeJsonStringify } from './safe-json-stringify.js';
  *
  * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
  */
-export function copyThroughJson(input, { enableUnsafeCopyAll, } = {}) {
+export function copyThroughJson(input) {
+    try {
+        return JSON.parse(JSON.stringify(input));
+        /* node:coverage ignore next 4 */
+    }
+    catch (error) {
+        console.error(`Failed to JSON copy for:`, input);
+        throw ensureErrorAndPrependMessage(error, 'Failed JSON copy');
+    }
+}
+/**
+ * Same as {@link copyThroughJson} but this uses safe serialization from {@link safeJsonStringify}.
+ *
+ * @category JSON : Common
+ * @category Copy
+ * @category Package : @augment-vir/common
+ * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
+ */
+export function safeCopyThroughJson(input) {
     try {
-        const stringified = enableUnsafeCopyAll ? JSON.stringify(input) : safeJsonStringify(input);
-        return JSON.parse(stringified);
+        return JSON.parse(safeJsonStringify(input));
         /* node:coverage ignore next 4 */
     }
     catch (error) {
-        console.error(`Failed to JSON copy for`, input);
-        throw error;
+        console.error(`Failed to JSON copy for:`, input);
+        throw ensureErrorAndPrependMessage(error, 'Failed JSON copy');
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "31.68.0",
+    "version": "31.68.2",
     "description": "A collection of augments, helpers types, functions, and classes for any JavaScript environment.",
     "keywords": [
         "augment",
@@ -40,14 +40,14 @@
         "test:web": "virmator --no-deps test web"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.68.0",
-        "@augment-vir/core": "^31.68.0",
+        "@augment-vir/assert": "^31.68.2",
+        "@augment-vir/core": "^31.68.2",
         "@date-vir/duration": "^8.2.0",
         "ansi-styles": "^6.2.3",
         "deepcopy-esm": "^2.1.1",
         "json5": "^2.2.3",
         "type-fest": "^5.4.4",
-        "typed-event-target": "^4.2.0"
+        "typed-event-target": "^4.3.0"
     },
     "devDependencies": {
         "@web/dev-server-esbuild": "^1.0.5",