@aws-sdk/core 3.936.0 → 3.943.0

package/dist-es/submodules/protocols/json/JsonShapeSerializer.js

@@ -3,10 +3,12 @@ import { NormalizedSchema } from "@smithy/core/schema";
 import { dateToUtcString, generateIdempotencyToken, LazyJsonString, NumericValue } from "@smithy/core/serde";
 import { toBase64 } from "@smithy/util-base64";
 import { SerdeContextConfig } from "../ConfigurableSerdeContext";
+import { serializingStructIterator } from "../structIterator";
 import { JsonReplacer } from "./jsonReplacer";
 export class JsonShapeSerializer extends SerdeContextConfig {
     settings;
     buffer;
+    useReplacer = false;
     rootSchema;
     constructor(settings) {
         super();
@@ -23,9 +25,13 @@ export class JsonShapeSerializer extends SerdeContextConfig {
         }
     }
     flush() {
-        const { rootSchema } = this;
+        const { rootSchema, useReplacer } = this;
         this.rootSchema = undefined;
+        this.useReplacer = false;
         if (rootSchema?.isStructSchema() || rootSchema?.isDocumentSchema()) {
+            if (!useReplacer) {
+                return JSON.stringify(this.buffer);
+            }
             const replacer = new JsonReplacer();
             return replacer.replaceInJson(JSON.stringify(this.buffer, replacer.createReplacer(), 0));
         }
@@ -34,68 +40,68 @@ export class JsonShapeSerializer extends SerdeContextConfig {
     _write(schema, value, container) {
         const isObject = value !== null && typeof value === "object";
         const ns = NormalizedSchema.of(schema);
-        if (ns.isListSchema() && Array.isArray(value)) {
-            const listMember = ns.getValueSchema();
-            const out = [];
-            const sparse = !!ns.getMergedTraits().sparse;
-            for (const item of value) {
-                if (sparse || item != null) {
-                    out.push(this._write(listMember, item));
+        if (isObject) {
+            if (ns.isStructSchema()) {
+                const out = {};
+                for (const [memberName, memberSchema] of serializingStructIterator(ns, value)) {
+                    const serializableValue = this._write(memberSchema, value[memberName], ns);
+                    if (serializableValue !== undefined) {
+                        const jsonName = memberSchema.getMergedTraits().jsonName;
+                        const targetKey = this.settings.jsonName ? jsonName ?? memberName : memberName;
+                        out[targetKey] = serializableValue;
+                    }
                 }
+                return out;
             }
-            return out;
-        }
-        else if (ns.isMapSchema() && isObject) {
-            const mapMember = ns.getValueSchema();
-            const out = {};
-            const sparse = !!ns.getMergedTraits().sparse;
-            for (const [_k, _v] of Object.entries(value)) {
-                if (sparse || _v != null) {
-                    out[_k] = this._write(mapMember, _v);
+            if (Array.isArray(value) && ns.isListSchema()) {
+                const listMember = ns.getValueSchema();
+                const out = [];
+                const sparse = !!ns.getMergedTraits().sparse;
+                for (const item of value) {
+                    if (sparse || item != null) {
+                        out.push(this._write(listMember, item));
+                    }
                 }
+                return out;
             }
-            return out;
-        }
-        else if (ns.isStructSchema() && isObject) {
-            const out = {};
-            for (const [memberName, memberSchema] of ns.structIterator()) {
-                const targetKey = this.settings.jsonName ? memberSchema.getMergedTraits().jsonName ?? memberName : memberName;
-                const serializableValue = this._write(memberSchema, value[memberName], ns);
-                if (serializableValue !== undefined) {
-                    out[targetKey] = serializableValue;
+            if (ns.isMapSchema()) {
+                const mapMember = ns.getValueSchema();
+                const out = {};
+                const sparse = !!ns.getMergedTraits().sparse;
+                for (const [_k, _v] of Object.entries(value)) {
+                    if (sparse || _v != null) {
+                        out[_k] = this._write(mapMember, _v);
+                    }
                 }
+                return out;
             }
-            return out;
-        }
-        if (value === null && container?.isStructSchema()) {
-            return void 0;
-        }
-        if ((ns.isBlobSchema() && (value instanceof Uint8Array || typeof value === "string")) ||
-            (ns.isDocumentSchema() && value instanceof Uint8Array)) {
-            if (ns === this.rootSchema) {
-                return value;
+            if (value instanceof Uint8Array && (ns.isBlobSchema() || ns.isDocumentSchema())) {
+                if (ns === this.rootSchema) {
+                    return value;
+                }
+                return (this.serdeContext?.base64Encoder ?? toBase64)(value);
             }
-            return (this.serdeContext?.base64Encoder ?? toBase64)(value);
-        }
-        if ((ns.isTimestampSchema() || ns.isDocumentSchema()) && value instanceof Date) {
-            const format = determineTimestampFormat(ns, this.settings);
-            switch (format) {
-                case 5:
-                    return value.toISOString().replace(".000Z", "Z");
-                case 6:
-                    return dateToUtcString(value);
-                case 7:
-                    return value.getTime() / 1000;
-                default:
-                    console.warn("Missing timestamp format, using epoch seconds", value);
-                    return value.getTime() / 1000;
+            if (value instanceof Date && (ns.isTimestampSchema() || ns.isDocumentSchema())) {
+                const format = determineTimestampFormat(ns, this.settings);
+                switch (format) {
+                    case 5:
+                        return value.toISOString().replace(".000Z", "Z");
+                    case 6:
+                        return dateToUtcString(value);
+                    case 7:
+                        return value.getTime() / 1000;
+                    default:
+                        console.warn("Missing timestamp format, using epoch seconds", value);
+                        return value.getTime() / 1000;
+                }
             }
-        }
-        if (ns.isNumericSchema() && typeof value === "number") {
-            if (Math.abs(value) === Infinity || isNaN(value)) {
-                return String(value);
+            if (value instanceof NumericValue) {
+                this.useReplacer = true;
             }
         }
+        if (value === null && container?.isStructSchema()) {
+            return void 0;
+        }
         if (ns.isStringSchema()) {
             if (typeof value === "undefined" && ns.isIdempotencyToken()) {
                 return generateIdempotencyToken();
@@ -107,12 +113,29 @@ export class JsonShapeSerializer extends SerdeContextConfig {
                     return LazyJsonString.from(value);
                 }
             }
+            return value;
+        }
+        if (typeof value === "number" && ns.isNumericSchema()) {
+            if (Math.abs(value) === Infinity || isNaN(value)) {
+                return String(value);
+            }
+            return value;
+        }
+        if (typeof value === "string" && ns.isBlobSchema()) {
+            if (ns === this.rootSchema) {
+                return value;
+            }
+            return (this.serdeContext?.base64Encoder ?? toBase64)(value);
+        }
+        if (typeof value === "bigint") {
+            this.useReplacer = true;
         }
         if (ns.isDocumentSchema()) {
             if (isObject) {
                 const out = Array.isArray(value) ? [] : {};
                 for (const [k, v] of Object.entries(value)) {
                     if (v instanceof NumericValue) {
+                        this.useReplacer = true;
                         out[k] = v;
                     }
                     else {

package/dist-es/submodules/protocols/json/experimental/SinglePassJsonShapeSerializer.js

@@ -3,6 +3,7 @@ import { NormalizedSchema } from "@smithy/core/schema";
 import { dateToUtcString, generateIdempotencyToken, LazyJsonString, NumericValue } from "@smithy/core/serde";
 import { toBase64 } from "@smithy/util-base64";
 import { SerdeContextConfig } from "../../ConfigurableSerdeContext";
+import { serializingStructIterator } from "../../structIterator";
 export class SinglePassJsonShapeSerializer extends SerdeContextConfig {
     settings;
     buffer;
@@ -44,7 +45,7 @@ export class SinglePassJsonShapeSerializer extends SerdeContextConfig {
         }
         else if (ns.isStructSchema()) {
             b += "{";
-            for (const [name, member] of ns.structIterator()) {
+            for (const [name, member] of serializingStructIterator(ns, value)) {
                 const item = value[name];
                 const targetKey = this.settings.jsonName ? member.getMergedTraits().jsonName ?? name : name;
                 const serializableValue = this.writeValue(member, item);

package/dist-es/submodules/protocols/query/QueryShapeSerializer.js

@@ -4,6 +4,7 @@ import { generateIdempotencyToken, NumericValue } from "@smithy/core/serde";
 import { dateToUtcString } from "@smithy/smithy-client";
 import { toBase64 } from "@smithy/util-base64";
 import { SerdeContextConfig } from "../ConfigurableSerdeContext";
+import { serializingStructIterator } from "../structIterator";
 export class QueryShapeSerializer extends SerdeContextConfig {
     settings;
     buffer;
@@ -113,7 +114,7 @@ export class QueryShapeSerializer extends SerdeContextConfig {
         }
         else if (ns.isStructSchema()) {
             if (value && typeof value === "object") {
-                for (const [memberName, member] of ns.structIterator()) {
+                for (const [memberName, member] of serializingStructIterator(ns, value)) {
                     if (value[memberName] == null && !member.isIdempotencyToken()) {
                         continue;
                     }

package/dist-es/submodules/protocols/structIterator.js

@@ -0,0 +1,40 @@
+import { NormalizedSchema } from "@smithy/core/schema";
+export function* serializingStructIterator(ns, sourceObject) {
+    if (ns.isUnitSchema()) {
+        return;
+    }
+    const struct = ns.getSchema();
+    for (let i = 0; i < struct[4].length; ++i) {
+        const key = struct[4][i];
+        const memberSchema = struct[5][i];
+        const memberNs = new NormalizedSchema([memberSchema, 0], key);
+        if (!(key in sourceObject) && !memberNs.isIdempotencyToken()) {
+            continue;
+        }
+        yield [key, memberNs];
+    }
+}
+export function* deserializingStructIterator(ns, sourceObject, nameTrait) {
+    if (ns.isUnitSchema()) {
+        return;
+    }
+    const struct = ns.getSchema();
+    let keysRemaining = Object.keys(sourceObject).filter((k) => k !== "__type").length;
+    for (let i = 0; i < struct[4].length; ++i) {
+        if (keysRemaining === 0) {
+            break;
+        }
+        const key = struct[4][i];
+        const memberSchema = struct[5][i];
+        const memberNs = new NormalizedSchema([memberSchema, 0], key);
+        let serializationKey = key;
+        if (nameTrait) {
+            serializationKey = memberNs.getMergedTraits()[nameTrait] ?? key;
+        }
+        if (!(serializationKey in sourceObject)) {
+            continue;
+        }
+        yield [key, memberNs];
+        keysRemaining -= 1;
+    }
+}

package/dist-es/submodules/protocols/xml/XmlShapeSerializer.js

@@ -5,6 +5,7 @@ import { generateIdempotencyToken, NumericValue } from "@smithy/core/serde";
 import { dateToUtcString } from "@smithy/smithy-client";
 import { fromBase64, toBase64 } from "@smithy/util-base64";
 import { SerdeContextConfig } from "../ConfigurableSerdeContext";
+import { serializingStructIterator } from "../structIterator";
 export class XmlShapeSerializer extends SerdeContextConfig {
     settings;
     stringBuffer;
@@ -63,7 +64,7 @@ export class XmlShapeSerializer extends SerdeContextConfig {
         }
         const structXmlNode = XmlNode.of(name);
         const [xmlnsAttr, xmlns] = this.getXmlnsAttribute(ns, parentXmlns);
-        for (const [memberName, memberSchema] of ns.structIterator()) {
+        for (const [memberName, memberSchema] of serializingStructIterator(ns, value)) {
             const val = value[memberName];
             if (val != null || memberSchema.isIdempotencyToken()) {
                 if (memberSchema.getMergedTraits().xmlAttribute) {

package/dist-types/submodules/protocols/json/AwsJson1_0Protocol.d.ts

@@ -1,13 +1,15 @@
 import { AwsJsonRpcProtocol } from "./AwsJsonRpcProtocol";
+import type { JsonCodec } from "./JsonCodec";
 /**
  * @public
  * @see https://smithy.io/2.0/aws/protocols/aws-json-1_1-protocol.html#differences-between-awsjson1-0-and-awsjson1-1
  */
 export declare class AwsJson1_0Protocol extends AwsJsonRpcProtocol {
-    constructor({ defaultNamespace, serviceTarget, awsQueryCompatible, }: {
+    constructor({ defaultNamespace, serviceTarget, awsQueryCompatible, jsonCodec, }: {
         defaultNamespace: string;
         serviceTarget: string;
         awsQueryCompatible?: boolean;
+        jsonCodec?: JsonCodec;
     });
     getShapeId(): string;
     protected getJsonRpcVersion(): "1.0";

package/dist-types/submodules/protocols/json/AwsJson1_1Protocol.d.ts

@@ -1,13 +1,15 @@
 import { AwsJsonRpcProtocol } from "./AwsJsonRpcProtocol";
+import type { JsonCodec } from "./JsonCodec";
 /**
  * @public
  * @see https://smithy.io/2.0/aws/protocols/aws-json-1_1-protocol.html#differences-between-awsjson1-0-and-awsjson1-1
  */
 export declare class AwsJson1_1Protocol extends AwsJsonRpcProtocol {
-    constructor({ defaultNamespace, serviceTarget, awsQueryCompatible, }: {
+    constructor({ defaultNamespace, serviceTarget, awsQueryCompatible, jsonCodec, }: {
         defaultNamespace: string;
         serviceTarget: string;
         awsQueryCompatible?: boolean;
+        jsonCodec?: JsonCodec;
     });
     getShapeId(): string;
     protected getJsonRpcVersion(): "1.1";

package/dist-types/submodules/protocols/json/AwsJsonRpcProtocol.d.ts

@@ -11,10 +11,11 @@ export declare abstract class AwsJsonRpcProtocol extends RpcProtocol {
     private readonly codec;
     private readonly mixin;
     private readonly awsQueryCompatible;
-    protected constructor({ defaultNamespace, serviceTarget, awsQueryCompatible, }: {
+    protected constructor({ defaultNamespace, serviceTarget, awsQueryCompatible, jsonCodec, }: {
         defaultNamespace: string;
         serviceTarget: string;
         awsQueryCompatible?: boolean;
+        jsonCodec?: JsonCodec;
     });
     serializeRequest<Input extends object>(operationSchema: OperationSchema, input: Input, context: HandlerExecutionContext & SerdeFunctions & EndpointBearer): Promise<HttpRequest>;
     getPayloadCodec(): JsonCodec;

package/dist-types/submodules/protocols/json/JsonShapeDeserializer.d.ts

@@ -9,5 +9,5 @@ export declare class JsonShapeDeserializer extends SerdeContextConfig implements
     constructor(settings: JsonSettings);
     read(schema: Schema, data: string | Uint8Array | unknown): Promise<any>;
     readObject(schema: Schema, data: DocumentType): any;
-    private _read;
+    protected _read(schema: Schema, value: unknown): any;
 }

package/dist-types/submodules/protocols/json/JsonShapeSerializer.d.ts

@@ -1,3 +1,4 @@
+import { NormalizedSchema } from "@smithy/core/schema";
 import type { Schema, ShapeSerializer } from "@smithy/types";
 import { SerdeContextConfig } from "../ConfigurableSerdeContext";
 import type { JsonSettings } from "./JsonCodec";
@@ -6,8 +7,13 @@ import type { JsonSettings } from "./JsonCodec";
  */
 export declare class JsonShapeSerializer extends SerdeContextConfig implements ShapeSerializer<string> {
     readonly settings: JsonSettings;
-    private buffer;
-    private rootSchema;
+    /**
+     * Write buffer. Reused per value serialization pass.
+     * In the initial implementation, this is not an incremental buffer.
+     */
+    protected buffer: any;
+    protected useReplacer: boolean;
+    protected rootSchema: NormalizedSchema | undefined;
     constructor(settings: JsonSettings);
     write(schema: Schema, value: unknown): void;
     /**
@@ -15,5 +21,8 @@ export declare class JsonShapeSerializer extends SerdeContextConfig implements S
      */
     writeDiscriminatedDocument(schema: Schema, value: unknown): void;
     flush(): string;
-    private _write;
+    /**
+     * Order if-statements by order of likelihood.
+     */
+    protected _write(schema: Schema, value: unknown, container?: NormalizedSchema): any;
 }

package/dist-types/submodules/protocols/structIterator.d.ts

@@ -0,0 +1,27 @@
+import { NormalizedSchema } from "@smithy/core/schema";
+/**
+ * @internal
+ */
+type SourceObject = Record<string, any>;
+/**
+ * For serialization use only.
+ * @internal
+ *
+ * @param ns - normalized schema object.
+ * @param sourceObject - source object from serialization.
+ */
+export declare function serializingStructIterator(ns: NormalizedSchema, sourceObject: SourceObject): Generator<any[], void, unknown>;
+/**
+ * For deserialization use only.
+ * Yields a subset of NormalizedSchema::structIterator matched to the source object keys.
+ * This is a performance optimization to avoid creation of NormalizedSchema member
+ * objects for members that are undefined in the source data object but may be numerous
+ * in the schema/model.
+ * @internal
+ *
+ * @param ns - normalized schema object.
+ * @param sourceObject - source object from deserialization.
+ * @param nameTrait - xmlName or jsonName trait to look for.
+ */
+export declare function deserializingStructIterator(ns: NormalizedSchema, sourceObject: SourceObject, nameTrait?: "xmlName" | "jsonName" | false): Generator<any[], void, unknown>;
+export {};

package/dist-types/ts3.4/submodules/protocols/json/AwsJson1_0Protocol.d.ts

@@ -1,13 +1,16 @@
 import { AwsJsonRpcProtocol } from "./AwsJsonRpcProtocol";
+import { JsonCodec } from "./JsonCodec";
 export declare class AwsJson1_0Protocol extends AwsJsonRpcProtocol {
   constructor({
     defaultNamespace,
     serviceTarget,
     awsQueryCompatible,
+    jsonCodec,
   }: {
     defaultNamespace: string;
     serviceTarget: string;
     awsQueryCompatible?: boolean;
+    jsonCodec?: JsonCodec;
   });
   getShapeId(): string;
   protected getJsonRpcVersion(): "1.0";

package/dist-types/ts3.4/submodules/protocols/json/AwsJson1_1Protocol.d.ts

@@ -1,13 +1,16 @@
 import { AwsJsonRpcProtocol } from "./AwsJsonRpcProtocol";
+import { JsonCodec } from "./JsonCodec";
 export declare class AwsJson1_1Protocol extends AwsJsonRpcProtocol {
   constructor({
     defaultNamespace,
     serviceTarget,
     awsQueryCompatible,
+    jsonCodec,
   }: {
     defaultNamespace: string;
     serviceTarget: string;
     awsQueryCompatible?: boolean;
+    jsonCodec?: JsonCodec;
   });
   getShapeId(): string;
   protected getJsonRpcVersion(): "1.1";

package/dist-types/ts3.4/submodules/protocols/json/AwsJsonRpcProtocol.d.ts

@@ -22,10 +22,12 @@ export declare abstract class AwsJsonRpcProtocol extends RpcProtocol {
     defaultNamespace,
     serviceTarget,
     awsQueryCompatible,
+    jsonCodec,
   }: {
     defaultNamespace: string;
     serviceTarget: string;
     awsQueryCompatible?: boolean;
+    jsonCodec?: JsonCodec;
   });
   serializeRequest<Input extends object>(
     operationSchema: OperationSchema,

package/dist-types/ts3.4/submodules/protocols/json/JsonShapeDeserializer.d.ts

@@ -9,5 +9,5 @@ export declare class JsonShapeDeserializer
   constructor(settings: JsonSettings);
   read(schema: Schema, data: string | Uint8Array | unknown): Promise<any>;
   readObject(schema: Schema, data: DocumentType): any;
-  private _read;
+  protected _read(schema: Schema, value: unknown): any;
 }

package/dist-types/ts3.4/submodules/protocols/json/JsonShapeSerializer.d.ts

@@ -1,3 +1,4 @@
+import { NormalizedSchema } from "@smithy/core/schema";
 import { Schema, ShapeSerializer } from "@smithy/types";
 import { SerdeContextConfig } from "../ConfigurableSerdeContext";
 import { JsonSettings } from "./JsonCodec";
@@ -6,11 +7,16 @@ export declare class JsonShapeSerializer
   implements ShapeSerializer<string>
 {
   readonly settings: JsonSettings;
-  private buffer;
-  private rootSchema;
+  protected buffer: any;
+  protected useReplacer: boolean;
+  protected rootSchema: NormalizedSchema | undefined;
   constructor(settings: JsonSettings);
   write(schema: Schema, value: unknown): void;
   writeDiscriminatedDocument(schema: Schema, value: unknown): void;
   flush(): string;
-  private _write;
+  protected _write(
+    schema: Schema,
+    value: unknown,
+    container?: NormalizedSchema
+  ): any;
 }

package/dist-types/ts3.4/submodules/protocols/structIterator.d.ts

@@ -0,0 +1,12 @@
+import { NormalizedSchema } from "@smithy/core/schema";
+type SourceObject = Record<string, any>;
+export declare function serializingStructIterator(
+  ns: NormalizedSchema,
+  sourceObject: SourceObject
+): Generator<any[], void, unknown>;
+export declare function deserializingStructIterator(
+  ns: NormalizedSchema,
+  sourceObject: SourceObject,
+  nameTrait?: "xmlName" | "jsonName" | false
+): Generator<any[], void, unknown>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-sdk/core",
-  "version": "3.936.0",
+  "version": "3.943.0",
   "description": "Core functions & classes shared by multiple AWS SDK clients.",
   "scripts": {
     "build": "yarn lint && concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",