@aws-sdk/util-dynamodb 3.686.0 → 3.689.0

package/dist-cjs/index.js

@@ -117,7 +117,7 @@ var convertToAttr = /* @__PURE__ */ __name((data, options) => {
   } else if (typeof data === "boolean" || ((_d = data == null ? void 0 : data.constructor) == null ? void 0 : _d.name) === "Boolean") {
     return { BOOL: data.valueOf() };
   } else if (typeof data === "number" || ((_e = data == null ? void 0 : data.constructor) == null ? void 0 : _e.name) === "Number") {
-    return convertToNumberAttr(data);
+    return convertToNumberAttr(data, options);
   } else if (data instanceof NumberValue) {
     return data.toAttributeValue();
   } else if (typeof data === "bigint") {
@@ -157,7 +157,7 @@ var convertToSetAttr = /* @__PURE__ */ __name((set, options) => {
     };
   } else if (typeof item === "number") {
     return {
-      NS: Array.from(setToOperate).map(convertToNumberAttr).map((item2) => item2.N)
+      NS: Array.from(setToOperate).map((num) => convertToNumberAttr(num, options)).map((item2) => item2.N)
     };
   } else if (typeof item === "bigint") {
     return {
@@ -207,13 +207,15 @@ var convertToBigIntAttr = /* @__PURE__ */ __name((data) => ({ N: data.toString()
 var validateBigIntAndThrow = /* @__PURE__ */ __name((errorPrefix) => {
   throw new Error(`${errorPrefix} Use NumberValue from @aws-sdk/lib-dynamodb.`);
 }, "validateBigIntAndThrow");
-var convertToNumberAttr = /* @__PURE__ */ __name((num) => {
+var convertToNumberAttr = /* @__PURE__ */ __name((num, options) => {
   if ([Number.NaN, Number.POSITIVE_INFINITY, Number.NEGATIVE_INFINITY].map((val) => val.toString()).includes(num.toString())) {
     throw new Error(`Special numeric value ${num.toString()} is not allowed`);
-  } else if (num > Number.MAX_SAFE_INTEGER) {
-    validateBigIntAndThrow(`Number ${num.toString()} is greater than Number.MAX_SAFE_INTEGER.`);
-  } else if (num < Number.MIN_SAFE_INTEGER) {
-    validateBigIntAndThrow(`Number ${num.toString()} is lesser than Number.MIN_SAFE_INTEGER.`);
+  } else if (!(options == null ? void 0 : options.allowImpreciseNumbers)) {
+    if (num > Number.MAX_SAFE_INTEGER) {
+      validateBigIntAndThrow(`Number ${num.toString()} is greater than Number.MAX_SAFE_INTEGER.`);
+    } else if (num < Number.MIN_SAFE_INTEGER) {
+      validateBigIntAndThrow(`Number ${num.toString()} is lesser than Number.MIN_SAFE_INTEGER.`);
+    }
   }
   return { N: num.toString() };
 }, "convertToNumberAttr");
@@ -275,6 +277,9 @@ var convertToNative = /* @__PURE__ */ __name((data, options) => {
   throw new Error(`No value defined: ${JSON.stringify(data)}`);
 }, "convertToNative");
 var convertNumber = /* @__PURE__ */ __name((numString, options) => {
+  if (typeof (options == null ? void 0 : options.wrapNumbers) === "function") {
+    return options == null ? void 0 : options.wrapNumbers(numString);
+  }
   if (options == null ? void 0 : options.wrapNumbers) {
     return NumberValue.from(numString);
   }

package/dist-es/convertToAttr.js

@@ -29,7 +29,7 @@ export const convertToAttr = (data, options) => {
         return { BOOL: data.valueOf() };
     }
     else if (typeof data === "number" || data?.constructor?.name === "Number") {
-        return convertToNumberAttr(data);
+        return convertToNumberAttr(data, options);
     }
     else if (data instanceof NumberValue) {
         return data.toAttributeValue();
@@ -74,7 +74,7 @@ const convertToSetAttr = (set, options) => {
     else if (typeof item === "number") {
         return {
             NS: Array.from(setToOperate)
-                .map(convertToNumberAttr)
+                .map((num) => convertToNumberAttr(num, options))
                 .map((item) => item.N),
         };
     }
@@ -133,17 +133,19 @@ const convertToBigIntAttr = (data) => ({ N: data.toString() });
 const validateBigIntAndThrow = (errorPrefix) => {
     throw new Error(`${errorPrefix} Use NumberValue from @aws-sdk/lib-dynamodb.`);
 };
-const convertToNumberAttr = (num) => {
+const convertToNumberAttr = (num, options) => {
     if ([Number.NaN, Number.POSITIVE_INFINITY, Number.NEGATIVE_INFINITY]
         .map((val) => val.toString())
         .includes(num.toString())) {
         throw new Error(`Special numeric value ${num.toString()} is not allowed`);
     }
-    else if (num > Number.MAX_SAFE_INTEGER) {
-        validateBigIntAndThrow(`Number ${num.toString()} is greater than Number.MAX_SAFE_INTEGER.`);
-    }
-    else if (num < Number.MIN_SAFE_INTEGER) {
-        validateBigIntAndThrow(`Number ${num.toString()} is lesser than Number.MIN_SAFE_INTEGER.`);
+    else if (!options?.allowImpreciseNumbers) {
+        if (num > Number.MAX_SAFE_INTEGER) {
+            validateBigIntAndThrow(`Number ${num.toString()} is greater than Number.MAX_SAFE_INTEGER.`);
+        }
+        else if (num < Number.MIN_SAFE_INTEGER) {
+            validateBigIntAndThrow(`Number ${num.toString()} is lesser than Number.MIN_SAFE_INTEGER.`);
+        }
     }
     return { N: num.toString() };
 };

package/dist-es/convertToNative.js

@@ -31,6 +31,9 @@ export const convertToNative = (data, options) => {
     throw new Error(`No value defined: ${JSON.stringify(data)}`);
 };
 const convertNumber = (numString, options) => {
+    if (typeof options?.wrapNumbers === "function") {
+        return options?.wrapNumbers(numString);
+    }
     if (options?.wrapNumbers) {
         return NumberValue.from(numString);
     }

package/dist-types/marshall.d.ts

@@ -25,6 +25,14 @@ export interface marshallOptions {
      * but false if directly using the marshall function (backwards compatibility).
      */
     convertTopLevelContainer?: boolean;
+    /**
+     * Whether to allow numbers beyond Number.MAX_SAFE_INTEGER during marshalling.
+     * When set to true, allows numbers that may lose precision when converted to JavaScript numbers.
+     * When false (default), throws an error if a number exceeds Number.MAX_SAFE_INTEGER to prevent
+     * unintended loss of precision. Consider using the NumberValue type from @aws-sdk/lib-dynamodb
+     * for precise handling of large numbers.
+     */
+    allowImpreciseNumbers?: boolean;
 }
 /**
  * Convert a JavaScript object into a DynamoDB record.

package/dist-types/ts3.4/marshall.d.ts

@@ -6,6 +6,7 @@ export interface marshallOptions {
   removeUndefinedValues?: boolean;
   convertClassInstanceToMap?: boolean;
   convertTopLevelContainer?: boolean;
+  allowImpreciseNumbers?: boolean;
 }
 export declare function marshall(
   data: null,

package/dist-types/ts3.4/unmarshall.d.ts

@@ -1,7 +1,10 @@
 import { AttributeValue } from "@aws-sdk/client-dynamodb";
 import { NativeAttributeValue } from "./models";
+import { NumberValue } from "./NumberValue";
 export interface unmarshallOptions {
-  wrapNumbers?: boolean;
+  wrapNumbers?:
+    | boolean
+    | ((value: string) => number | bigint | NumberValue | any);
   convertWithoutMapWrapper?: boolean;
 }
 export declare const unmarshall: (

package/dist-types/unmarshall.d.ts

@@ -1,14 +1,19 @@
 import { AttributeValue } from "@aws-sdk/client-dynamodb";
 import { NativeAttributeValue } from "./models";
+import { NumberValue } from "./NumberValue";
 /**
  * An optional configuration object for `convertToNative`
  */
 export interface unmarshallOptions {
     /**
-     * Whether to return numbers as a string instead of converting them to native JavaScript numbers.
+     * Whether to modify how numbers are unmarshalled from DynamoDB.
+     * When set to true, returns numbers as NumberValue instances instead of native JavaScript numbers.
      * This allows for the safe round-trip transport of numbers of arbitrary size.
+     *
+     * If a function is provided, it will be called with the string representation of numbers to handle
+     * custom conversions (e.g., using BigInt or decimal libraries).
      */
-    wrapNumbers?: boolean;
+    wrapNumbers?: boolean | ((value: string) => number | bigint | NumberValue | any);
     /**
      * When true, skip wrapping the data in `{ M: data }` before converting.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-sdk/util-dynamodb",
-  "version": "3.686.0",
+  "version": "3.689.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline util-dynamodb",
@@ -25,7 +25,7 @@
     "tslib": "^2.6.2"
   },
   "devDependencies": {
-    "@aws-sdk/client-dynamodb": "3.686.0",
+    "@aws-sdk/client-dynamodb": "3.687.0",
     "@tsconfig/recommended": "1.0.1",
     "concurrently": "7.0.0",
     "downlevel-dts": "0.10.1",
@@ -33,7 +33,7 @@
     "typescript": "~4.9.5"
   },
   "peerDependencies": {
-    "@aws-sdk/client-dynamodb": "^3.686.0"
+    "@aws-sdk/client-dynamodb": "^3.687.0"
   },
   "engines": {
     "node": ">=16.0.0"