Backend half

2025-07-11 19:56:28 +02:00
parent fa868e7c1d
commit 8600fa7c1d
19426 changed files with 3750448 additions and 8108 deletions
@@ -0,0 +1,201 @@
+                                Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
@@ -0,0 +1,4 @@
+# @smithy/protocol-http
+
+[![NPM version](https://img.shields.io/npm/v/@smithy/protocol-http/latest.svg)](https://www.npmjs.com/package/@smithy/protocol-http)
+[![NPM downloads](https://img.shields.io/npm/dm/@smithy/protocol-http.svg)](https://www.npmjs.com/package/@smithy/protocol-http)
@@ -0,0 +1 @@
+module.exports = require("./index.js");
@@ -0,0 +1 @@
+module.exports = require("./index.js");
@@ -0,0 +1 @@
+module.exports = require("../index.js");
@@ -0,0 +1 @@
+module.exports = require("../index.js");
@@ -0,0 +1 @@
+module.exports = require("./index.js");
@@ -0,0 +1 @@
+module.exports = require("./index.js");
@@ -0,0 +1 @@
+module.exports = require("./index.js");
@@ -0,0 +1,262 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Field: () => Field,
+  Fields: () => Fields,
+  HttpRequest: () => HttpRequest,
+  HttpResponse: () => HttpResponse,
+  IHttpRequest: () => import_types.HttpRequest,
+  getHttpHandlerExtensionConfiguration: () => getHttpHandlerExtensionConfiguration,
+  isValidHostname: () => isValidHostname,
+  resolveHttpHandlerRuntimeConfig: () => resolveHttpHandlerRuntimeConfig
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/extensions/httpExtensionConfiguration.ts
+var getHttpHandlerExtensionConfiguration = /* @__PURE__ */ __name((runtimeConfig) => {
+  return {
+    setHttpHandler(handler) {
+      runtimeConfig.httpHandler = handler;
+    },
+    httpHandler() {
+      return runtimeConfig.httpHandler;
+    },
+    updateHttpClientConfig(key, value) {
+      runtimeConfig.httpHandler?.updateHttpClientConfig(key, value);
+    },
+    httpHandlerConfigs() {
+      return runtimeConfig.httpHandler.httpHandlerConfigs();
+    }
+  };
+}, "getHttpHandlerExtensionConfiguration");
+var resolveHttpHandlerRuntimeConfig = /* @__PURE__ */ __name((httpHandlerExtensionConfiguration) => {
+  return {
+    httpHandler: httpHandlerExtensionConfiguration.httpHandler()
+  };
+}, "resolveHttpHandlerRuntimeConfig");
+
+// src/Field.ts
+var import_types = require("@smithy/types");
+var Field = class {
+  static {
+    __name(this, "Field");
+  }
+  constructor({ name, kind = import_types.FieldPosition.HEADER, values = [] }) {
+    this.name = name;
+    this.kind = kind;
+    this.values = values;
+  }
+  /**
+   * Appends a value to the field.
+   *
+   * @param value The value to append.
+   */
+  add(value) {
+    this.values.push(value);
+  }
+  /**
+   * Overwrite existing field values.
+   *
+   * @param values The new field values.
+   */
+  set(values) {
+    this.values = values;
+  }
+  /**
+   * Remove all matching entries from list.
+   *
+   * @param value Value to remove.
+   */
+  remove(value) {
+    this.values = this.values.filter((v) => v !== value);
+  }
+  /**
+   * Get comma-delimited string.
+   *
+   * @returns String representation of {@link Field}.
+   */
+  toString() {
+    return this.values.map((v) => v.includes(",") || v.includes(" ") ? `"${v}"` : v).join(", ");
+  }
+  /**
+   * Get string values as a list
+   *
+   * @returns Values in {@link Field} as a list.
+   */
+  get() {
+    return this.values;
+  }
+};
+
+// src/Fields.ts
+var Fields = class {
+  constructor({ fields = [], encoding = "utf-8" }) {
+    this.entries = {};
+    fields.forEach(this.setField.bind(this));
+    this.encoding = encoding;
+  }
+  static {
+    __name(this, "Fields");
+  }
+  /**
+   * Set entry for a {@link Field} name. The `name`
+   * attribute will be used to key the collection.
+   *
+   * @param field The {@link Field} to set.
+   */
+  setField(field) {
+    this.entries[field.name.toLowerCase()] = field;
+  }
+  /**
+   *  Retrieve {@link Field} entry by name.
+   *
+   * @param name The name of the {@link Field} entry
+   *  to retrieve
+   * @returns The {@link Field} if it exists.
+   */
+  getField(name) {
+    return this.entries[name.toLowerCase()];
+  }
+  /**
+   * Delete entry from collection.
+   *
+   * @param name Name of the entry to delete.
+   */
+  removeField(name) {
+    delete this.entries[name.toLowerCase()];
+  }
+  /**
+   * Helper function for retrieving specific types of fields.
+   * Used to grab all headers or all trailers.
+   *
+   * @param kind {@link FieldPosition} of entries to retrieve.
+   * @returns The {@link Field} entries with the specified
+   *  {@link FieldPosition}.
+   */
+  getByType(kind) {
+    return Object.values(this.entries).filter((field) => field.kind === kind);
+  }
+};
+
+// src/httpRequest.ts
+
+var HttpRequest = class _HttpRequest {
+  static {
+    __name(this, "HttpRequest");
+  }
+  constructor(options) {
+    this.method = options.method || "GET";
+    this.hostname = options.hostname || "localhost";
+    this.port = options.port;
+    this.query = options.query || {};
+    this.headers = options.headers || {};
+    this.body = options.body;
+    this.protocol = options.protocol ? options.protocol.slice(-1) !== ":" ? `${options.protocol}:` : options.protocol : "https:";
+    this.path = options.path ? options.path.charAt(0) !== "/" ? `/${options.path}` : options.path : "/";
+    this.username = options.username;
+    this.password = options.password;
+    this.fragment = options.fragment;
+  }
+  /**
+   * Note: this does not deep-clone the body.
+   */
+  static clone(request) {
+    const cloned = new _HttpRequest({
+      ...request,
+      headers: { ...request.headers }
+    });
+    if (cloned.query) {
+      cloned.query = cloneQuery(cloned.query);
+    }
+    return cloned;
+  }
+  /**
+   * This method only actually asserts that request is the interface {@link IHttpRequest},
+   * and not necessarily this concrete class. Left in place for API stability.
+   *
+   * Do not call instance methods on the input of this function, and
+   * do not assume it has the HttpRequest prototype.
+   */
+  static isInstance(request) {
+    if (!request) {
+      return false;
+    }
+    const req = request;
+    return "method" in req && "protocol" in req && "hostname" in req && "path" in req && typeof req["query"] === "object" && typeof req["headers"] === "object";
+  }
+  /**
+   * @deprecated use static HttpRequest.clone(request) instead. It's not safe to call
+   * this method because {@link HttpRequest.isInstance} incorrectly
+   * asserts that IHttpRequest (interface) objects are of type HttpRequest (class).
+   */
+  clone() {
+    return _HttpRequest.clone(this);
+  }
+};
+function cloneQuery(query) {
+  return Object.keys(query).reduce((carry, paramName) => {
+    const param = query[paramName];
+    return {
+      ...carry,
+      [paramName]: Array.isArray(param) ? [...param] : param
+    };
+  }, {});
+}
+__name(cloneQuery, "cloneQuery");
+
+// src/httpResponse.ts
+var HttpResponse = class {
+  static {
+    __name(this, "HttpResponse");
+  }
+  constructor(options) {
+    this.statusCode = options.statusCode;
+    this.reason = options.reason;
+    this.headers = options.headers || {};
+    this.body = options.body;
+  }
+  static isInstance(response) {
+    if (!response)
+      return false;
+    const resp = response;
+    return typeof resp.statusCode === "number" && typeof resp.headers === "object";
+  }
+};
+
+// src/isValidHostname.ts
+function isValidHostname(hostname) {
+  const hostPattern = /^[a-z0-9][a-z0-9\.\-]*[a-z0-9]$/;
+  return hostPattern.test(hostname);
+}
+__name(isValidHostname, "isValidHostname");
+// Annotate the CommonJS export names for ESM import in node:
+
+0 && (module.exports = {
+  getHttpHandlerExtensionConfiguration,
+  resolveHttpHandlerRuntimeConfig,
+  Field,
+  Fields,
+  HttpRequest,
+  HttpResponse,
+  isValidHostname
+});
+
@@ -0,0 +1 @@
+module.exports = require("./index.js");
@@ -0,0 +1 @@
+module.exports = require("./index.js");
@@ -0,0 +1,23 @@
+import { FieldPosition } from "@smithy/types";
+export class Field {
+    constructor({ name, kind = FieldPosition.HEADER, values = [] }) {
+        this.name = name;
+        this.kind = kind;
+        this.values = values;
+    }
+    add(value) {
+        this.values.push(value);
+    }
+    set(values) {
+        this.values = values;
+    }
+    remove(value) {
+        this.values = this.values.filter((v) => v !== value);
+    }
+    toString() {
+        return this.values.map((v) => (v.includes(",") || v.includes(" ") ? `"${v}"` : v)).join(", ");
+    }
+    get() {
+        return this.values;
+    }
+}
@@ -0,0 +1,19 @@
+export class Fields {
+    constructor({ fields = [], encoding = "utf-8" }) {
+        this.entries = {};
+        fields.forEach(this.setField.bind(this));
+        this.encoding = encoding;
+    }
+    setField(field) {
+        this.entries[field.name.toLowerCase()] = field;
+    }
+    getField(name) {
+        return this.entries[name.toLowerCase()];
+    }
+    removeField(name) {
+        delete this.entries[name.toLowerCase()];
+    }
+    getByType(kind) {
+        return Object.values(this.entries).filter((field) => field.kind === kind);
+    }
+}
@@ -0,0 +1,21 @@
+export const getHttpHandlerExtensionConfiguration = (runtimeConfig) => {
+    return {
+        setHttpHandler(handler) {
+            runtimeConfig.httpHandler = handler;
+        },
+        httpHandler() {
+            return runtimeConfig.httpHandler;
+        },
+        updateHttpClientConfig(key, value) {
+            runtimeConfig.httpHandler?.updateHttpClientConfig(key, value);
+        },
+        httpHandlerConfigs() {
+            return runtimeConfig.httpHandler.httpHandlerConfigs();
+        },
+    };
+};
+export const resolveHttpHandlerRuntimeConfig = (httpHandlerExtensionConfiguration) => {
+    return {
+        httpHandler: httpHandlerExtensionConfiguration.httpHandler(),
+    };
+};
@@ -0,0 +1 @@
+export * from "./httpExtensionConfiguration";
@@ -0,0 +1 @@
+export {};
@@ -0,0 +1,53 @@
+export class HttpRequest {
+    constructor(options) {
+        this.method = options.method || "GET";
+        this.hostname = options.hostname || "localhost";
+        this.port = options.port;
+        this.query = options.query || {};
+        this.headers = options.headers || {};
+        this.body = options.body;
+        this.protocol = options.protocol
+            ? options.protocol.slice(-1) !== ":"
+                ? `${options.protocol}:`
+                : options.protocol
+            : "https:";
+        this.path = options.path ? (options.path.charAt(0) !== "/" ? `/${options.path}` : options.path) : "/";
+        this.username = options.username;
+        this.password = options.password;
+        this.fragment = options.fragment;
+    }
+    static clone(request) {
+        const cloned = new HttpRequest({
+            ...request,
+            headers: { ...request.headers },
+        });
+        if (cloned.query) {
+            cloned.query = cloneQuery(cloned.query);
+        }
+        return cloned;
+    }
+    static isInstance(request) {
+        if (!request) {
+            return false;
+        }
+        const req = request;
+        return ("method" in req &&
+            "protocol" in req &&
+            "hostname" in req &&
+            "path" in req &&
+            typeof req["query"] === "object" &&
+            typeof req["headers"] === "object");
+    }
+    clone() {
+        return HttpRequest.clone(this);
+    }
+}
+function cloneQuery(query) {
+    return Object.keys(query).reduce((carry, paramName) => {
+        const param = query[paramName];
+        return {
+            ...carry,
+            [paramName]: Array.isArray(param) ? [...param] : param,
+        };
+    }, {});
+}
@@ -0,0 +1,14 @@
+export class HttpResponse {
+    constructor(options) {
+        this.statusCode = options.statusCode;
+        this.reason = options.reason;
+        this.headers = options.headers || {};
+        this.body = options.body;
+    }
+    static isInstance(response) {
+        if (!response)
+            return false;
+        const resp = response;
+        return typeof resp.statusCode === "number" && typeof resp.headers === "object";
+    }
+}
@@ -0,0 +1,8 @@
+export * from "./extensions";
+export * from "./Field";
+export * from "./Fields";
+export * from "./httpHandler";
+export * from "./httpRequest";
+export * from "./httpResponse";
+export * from "./isValidHostname";
+export * from "./types";
@@ -0,0 +1,4 @@
+export function isValidHostname(hostname) {
+    const hostPattern = /^[a-z0-9][a-z0-9\.\-]*[a-z0-9]$/;
+    return hostPattern.test(hostname);
+}
@@ -0,0 +1 @@
+export {};
@@ -0,0 +1,49 @@
+import { FieldOptions, FieldPosition } from "@smithy/types";
+/**
+ * A name-value pair representing a single field
+ * transmitted in an HTTP Request or Response.
+ *
+ * The kind will dictate metadata placement within
+ * an HTTP message.
+ *
+ * All field names are case insensitive and
+ * case-variance must be treated as equivalent.
+ * Names MAY be normalized but SHOULD be preserved
+ * for accuracy during transmission.
+ */
+export declare class Field {
+    readonly name: string;
+    readonly kind: FieldPosition;
+    values: string[];
+    constructor({ name, kind, values }: FieldOptions);
+    /**
+     * Appends a value to the field.
+     *
+     * @param value The value to append.
+     */
+    add(value: string): void;
+    /**
+     * Overwrite existing field values.
+     *
+     * @param values The new field values.
+     */
+    set(values: string[]): void;
+    /**
+     * Remove all matching entries from list.
+     *
+     * @param value Value to remove.
+     */
+    remove(value: string): void;
+    /**
+     * Get comma-delimited string.
+     *
+     * @returns String representation of {@link Field}.
+     */
+    toString(): string;
+    /**
+     * Get string values as a list
+     *
+     * @returns Values in {@link Field} as a list.
+     */
+    get(): string[];
+}
@@ -0,0 +1,44 @@
+import { FieldPosition } from "@smithy/types";
+import { Field } from "./Field";
+export type FieldsOptions = {
+    fields?: Field[];
+    encoding?: string;
+};
+/**
+ * Collection of Field entries mapped by name.
+ */
+export declare class Fields {
+    private readonly entries;
+    private readonly encoding;
+    constructor({ fields, encoding }: FieldsOptions);
+    /**
+     * Set entry for a {@link Field} name. The `name`
+     * attribute will be used to key the collection.
+     *
+     * @param field The {@link Field} to set.
+     */
+    setField(field: Field): void;
+    /**
+     *  Retrieve {@link Field} entry by name.
+     *
+     * @param name The name of the {@link Field} entry
+     *  to retrieve
+     * @returns The {@link Field} if it exists.
+     */
+    getField(name: string): Field | undefined;
+    /**
+     * Delete entry from collection.
+     *
+     * @param name Name of the entry to delete.
+     */
+    removeField(name: string): void;
+    /**
+     * Helper function for retrieving specific types of fields.
+     * Used to grab all headers or all trailers.
+     *
+     * @param kind {@link FieldPosition} of entries to retrieve.
+     * @returns The {@link Field} entries with the specified
+     *  {@link FieldPosition}.
+     */
+    getByType(kind: FieldPosition): Field[];
+}
@@ -0,0 +1,33 @@
+import { HttpHandler } from "../httpHandler";
+/**
+ * @internal
+ */
+export interface HttpHandlerExtensionConfiguration<HandlerConfig extends object = {}> {
+    setHttpHandler(handler: HttpHandler<HandlerConfig>): void;
+    httpHandler(): HttpHandler<HandlerConfig>;
+    updateHttpClientConfig(key: keyof HandlerConfig, value: HandlerConfig[typeof key]): void;
+    httpHandlerConfigs(): HandlerConfig;
+}
+/**
+ * @internal
+ */
+export type HttpHandlerExtensionConfigType<HandlerConfig extends object = {}> = Partial<{
+    httpHandler: HttpHandler<HandlerConfig>;
+}>;
+/**
+ * @internal
+ *
+ * Helper function to resolve default extension configuration from runtime config
+ */
+export declare const getHttpHandlerExtensionConfiguration: <HandlerConfig extends object = {}>(runtimeConfig: HttpHandlerExtensionConfigType<HandlerConfig>) => {
+    setHttpHandler(handler: HttpHandler<HandlerConfig>): void;
+    httpHandler(): HttpHandler<HandlerConfig>;
+    updateHttpClientConfig(key: keyof HandlerConfig, value: HandlerConfig[typeof key]): void;
+    httpHandlerConfigs(): HandlerConfig;
+};
+/**
+ * @internal
+ *
+ * Helper function to resolve runtime config from default extension configuration
+ */
+export declare const resolveHttpHandlerRuntimeConfig: <HandlerConfig extends object = {}>(httpHandlerExtensionConfiguration: HttpHandlerExtensionConfiguration<HandlerConfig>) => HttpHandlerExtensionConfigType<HandlerConfig>;
@@ -0,0 +1 @@
+export * from "./httpExtensionConfiguration";
@@ -0,0 +1,35 @@
+import type { FetchHttpHandlerOptions, HttpHandlerOptions, NodeHttpHandlerOptions, RequestHandler } from "@smithy/types";
+import type { HttpRequest } from "./httpRequest";
+import type { HttpResponse } from "./httpResponse";
+/**
+ * @internal
+ */
+export type HttpHandler<HttpHandlerConfig extends object = {}> = RequestHandler<HttpRequest, HttpResponse, HttpHandlerOptions> & {
+    /**
+     * @internal
+     */
+    updateHttpClientConfig(key: keyof HttpHandlerConfig, value: HttpHandlerConfig[typeof key]): void;
+    /**
+     * @internal
+     */
+    httpHandlerConfigs(): HttpHandlerConfig;
+};
+/**
+ * @public
+ *
+ * A type representing the accepted user inputs for the `requestHandler` field
+ * of a client's constructor object.
+ *
+ * You may provide an instance of an HttpHandler, or alternatively
+ * provide the constructor arguments as an object which will be passed
+ * to the constructor of the default request handler.
+ *
+ * The default class constructor to which your arguments will be passed
+ * varies. The Node.js default is the NodeHttpHandler and the browser/react-native
+ * default is the FetchHttpHandler. In rarer cases specific clients may be
+ * configured to use other default implementations such as Websocket or HTTP2.
+ *
+ * The fallback type Record<string, unknown> is part of the union to allow
+ * passing constructor params to an unknown requestHandler type.
+ */
+export type HttpHandlerUserInput = HttpHandler | NodeHttpHandlerOptions | FetchHttpHandlerOptions | Record<string, unknown>;
@@ -0,0 +1,55 @@
+import { HeaderBag, HttpMessage, HttpRequest as IHttpRequest, QueryParameterBag, URI } from "@smithy/types";
+type HttpRequestOptions = Partial<HttpMessage> & Partial<URI> & {
+    method?: string;
+};
+/**
+ * Use the distinct IHttpRequest interface from \@smithy/types instead.
+ * This should not be used due to
+ * overlapping with the concrete class' name.
+ *
+ * This is not marked deprecated since that would mark the concrete class
+ * deprecated as well.
+ *
+ * @internal
+ */
+export interface HttpRequest extends IHttpRequest {
+}
+/**
+ * @public
+ */
+export { IHttpRequest };
+/**
+ * @public
+ */
+export declare class HttpRequest implements HttpMessage, URI {
+    method: string;
+    protocol: string;
+    hostname: string;
+    port?: number;
+    path: string;
+    query: QueryParameterBag;
+    headers: HeaderBag;
+    username?: string;
+    password?: string;
+    fragment?: string;
+    body?: any;
+    constructor(options: HttpRequestOptions);
+    /**
+     * Note: this does not deep-clone the body.
+     */
+    static clone(request: IHttpRequest): HttpRequest;
+    /**
+     * This method only actually asserts that request is the interface {@link IHttpRequest},
+     * and not necessarily this concrete class. Left in place for API stability.
+     *
+     * Do not call instance methods on the input of this function, and
+     * do not assume it has the HttpRequest prototype.
+     */
+    static isInstance(request: unknown): request is HttpRequest;
+    /**
+     * @deprecated use static HttpRequest.clone(request) instead. It's not safe to call
+     * this method because {@link HttpRequest.isInstance} incorrectly
+     * asserts that IHttpRequest (interface) objects are of type HttpRequest (class).
+     */
+    clone(): HttpRequest;
+}
@@ -0,0 +1,29 @@
+import { HeaderBag, HttpMessage, HttpResponse as IHttpResponse } from "@smithy/types";
+type HttpResponseOptions = Partial<HttpMessage> & {
+    statusCode: number;
+    reason?: string;
+};
+/**
+ * Use the distinct IHttpResponse interface from \@smithy/types instead.
+ * This should not be used due to
+ * overlapping with the concrete class' name.
+ *
+ * This is not marked deprecated since that would mark the concrete class
+ * deprecated as well.
+ *
+ * @internal
+ */
+export interface HttpResponse extends IHttpResponse {
+}
+/**
+ * @public
+ */
+export declare class HttpResponse {
+    statusCode: number;
+    reason?: string;
+    headers: HeaderBag;
+    body?: any;
+    constructor(options: HttpResponseOptions);
+    static isInstance(response: unknown): response is HttpResponse;
+}
+export {};
@@ -0,0 +1,8 @@
+export * from "./extensions";
+export * from "./Field";
+export * from "./Fields";
+export * from "./httpHandler";
+export * from "./httpRequest";
+export * from "./httpResponse";
+export * from "./isValidHostname";
+export * from "./types";
@@ -0,0 +1 @@
+export declare function isValidHostname(hostname: string): boolean;
@@ -0,0 +1,49 @@
+import { FieldOptions, FieldPosition } from "@smithy/types";
+/**
+ * A name-value pair representing a single field
+ * transmitted in an HTTP Request or Response.
+ *
+ * The kind will dictate metadata placement within
+ * an HTTP message.
+ *
+ * All field names are case insensitive and
+ * case-variance must be treated as equivalent.
+ * Names MAY be normalized but SHOULD be preserved
+ * for accuracy during transmission.
+ */
+export declare class Field {
+    readonly name: string;
+    readonly kind: FieldPosition;
+    values: string[];
+    constructor({ name, kind, values }: FieldOptions);
+    /**
+     * Appends a value to the field.
+     *
+     * @param value The value to append.
+     */
+    add(value: string): void;
+    /**
+     * Overwrite existing field values.
+     *
+     * @param values The new field values.
+     */
+    set(values: string[]): void;
+    /**
+     * Remove all matching entries from list.
+     *
+     * @param value Value to remove.
+     */
+    remove(value: string): void;
+    /**
+     * Get comma-delimited string.
+     *
+     * @returns String representation of {@link Field}.
+     */
+    toString(): string;
+    /**
+     * Get string values as a list
+     *
+     * @returns Values in {@link Field} as a list.
+     */
+    get(): string[];
+}
@@ -0,0 +1,44 @@
+import { FieldPosition } from "@smithy/types";
+import { Field } from "./Field";
+export type FieldsOptions = {
+    fields?: Field[];
+    encoding?: string;
+};
+/**
+ * Collection of Field entries mapped by name.
+ */
+export declare class Fields {
+    private readonly entries;
+    private readonly encoding;
+    constructor({ fields, encoding }: FieldsOptions);
+    /**
+     * Set entry for a {@link Field} name. The `name`
+     * attribute will be used to key the collection.
+     *
+     * @param field The {@link Field} to set.
+     */
+    setField(field: Field): void;
+    /**
+     *  Retrieve {@link Field} entry by name.
+     *
+     * @param name The name of the {@link Field} entry
+     *  to retrieve
+     * @returns The {@link Field} if it exists.
+     */
+    getField(name: string): Field | undefined;
+    /**
+     * Delete entry from collection.
+     *
+     * @param name Name of the entry to delete.
+     */
+    removeField(name: string): void;
+    /**
+     * Helper function for retrieving specific types of fields.
+     * Used to grab all headers or all trailers.
+     *
+     * @param kind {@link FieldPosition} of entries to retrieve.
+     * @returns The {@link Field} entries with the specified
+     *  {@link FieldPosition}.
+     */
+    getByType(kind: FieldPosition): Field[];
+}
@@ -0,0 +1,33 @@
+import { HttpHandler } from "../httpHandler";
+/**
+ * @internal
+ */
+export interface HttpHandlerExtensionConfiguration<HandlerConfig extends object = {}> {
+    setHttpHandler(handler: HttpHandler<HandlerConfig>): void;
+    httpHandler(): HttpHandler<HandlerConfig>;
+    updateHttpClientConfig(key: keyof HandlerConfig, value: HandlerConfig[typeof key]): void;
+    httpHandlerConfigs(): HandlerConfig;
+}
+/**
+ * @internal
+ */
+export type HttpHandlerExtensionConfigType<HandlerConfig extends object = {}> = Partial<{
+    httpHandler: HttpHandler<HandlerConfig>;
+}>;
+/**
+ * @internal
+ *
+ * Helper function to resolve default extension configuration from runtime config
+ */
+export declare const getHttpHandlerExtensionConfiguration: <HandlerConfig extends object = {}>(runtimeConfig: HttpHandlerExtensionConfigType<HandlerConfig>) => {
+    setHttpHandler(handler: HttpHandler<HandlerConfig>): void;
+    httpHandler(): HttpHandler<HandlerConfig>;
+    updateHttpClientConfig(key: keyof HandlerConfig, value: HandlerConfig[typeof key]): void;
+    httpHandlerConfigs(): HandlerConfig;
+};
+/**
+ * @internal
+ *
+ * Helper function to resolve runtime config from default extension configuration
+ */
+export declare const resolveHttpHandlerRuntimeConfig: <HandlerConfig extends object = {}>(httpHandlerExtensionConfiguration: HttpHandlerExtensionConfiguration<HandlerConfig>) => HttpHandlerExtensionConfigType<HandlerConfig>;
@@ -0,0 +1 @@
+export * from "./httpExtensionConfiguration";
@@ -0,0 +1,35 @@
+import { FetchHttpHandlerOptions, HttpHandlerOptions, NodeHttpHandlerOptions, RequestHandler } from "@smithy/types";
+import { HttpRequest } from "./httpRequest";
+import { HttpResponse } from "./httpResponse";
+/**
+ * @internal
+ */
+export type HttpHandler<HttpHandlerConfig extends object = {}> = RequestHandler<HttpRequest, HttpResponse, HttpHandlerOptions> & {
+    /**
+     * @internal
+     */
+    updateHttpClientConfig(key: keyof HttpHandlerConfig, value: HttpHandlerConfig[typeof key]): void;
+    /**
+     * @internal
+     */
+    httpHandlerConfigs(): HttpHandlerConfig;
+};
+/**
+ * @public
+ *
+ * A type representing the accepted user inputs for the `requestHandler` field
+ * of a client's constructor object.
+ *
+ * You may provide an instance of an HttpHandler, or alternatively
+ * provide the constructor arguments as an object which will be passed
+ * to the constructor of the default request handler.
+ *
+ * The default class constructor to which your arguments will be passed
+ * varies. The Node.js default is the NodeHttpHandler and the browser/react-native
+ * default is the FetchHttpHandler. In rarer cases specific clients may be
+ * configured to use other default implementations such as Websocket or HTTP2.
+ *
+ * The fallback type Record<string, unknown> is part of the union to allow
+ * passing constructor params to an unknown requestHandler type.
+ */
+export type HttpHandlerUserInput = HttpHandler | NodeHttpHandlerOptions | FetchHttpHandlerOptions | Record<string, unknown>;
@@ -0,0 +1,55 @@
+import { HeaderBag, HttpMessage, HttpRequest as IHttpRequest, QueryParameterBag, URI } from "@smithy/types";
+type HttpRequestOptions = Partial<HttpMessage> & Partial<URI> & {
+    method?: string;
+};
+/**
+ * Use the distinct IHttpRequest interface from \@smithy/types instead.
+ * This should not be used due to
+ * overlapping with the concrete class' name.
+ *
+ * This is not marked deprecated since that would mark the concrete class
+ * deprecated as well.
+ *
+ * @internal
+ */
+export interface HttpRequest extends IHttpRequest {
+}
+/**
+ * @public
+ */
+export { IHttpRequest };
+/**
+ * @public
+ */
+export declare class HttpRequest implements HttpMessage, URI {
+    method: string;
+    protocol: string;
+    hostname: string;
+    port?: number;
+    path: string;
+    query: QueryParameterBag;
+    headers: HeaderBag;
+    username?: string;
+    password?: string;
+    fragment?: string;
+    body?: any;
+    constructor(options: HttpRequestOptions);
+    /**
+     * Note: this does not deep-clone the body.
+     */
+    static clone(request: IHttpRequest): HttpRequest;
+    /**
+     * This method only actually asserts that request is the interface {@link IHttpRequest},
+     * and not necessarily this concrete class. Left in place for API stability.
+     *
+     * Do not call instance methods on the input of this function, and
+     * do not assume it has the HttpRequest prototype.
+     */
+    static isInstance(request: unknown): request is HttpRequest;
+    /**
+     * @deprecated use static HttpRequest.clone(request) instead. It's not safe to call
+     * this method because {@link HttpRequest.isInstance} incorrectly
+     * asserts that IHttpRequest (interface) objects are of type HttpRequest (class).
+     */
+    clone(): HttpRequest;
+}
@@ -0,0 +1,29 @@
+import { HeaderBag, HttpMessage, HttpResponse as IHttpResponse } from "@smithy/types";
+type HttpResponseOptions = Partial<HttpMessage> & {
+    statusCode: number;
+    reason?: string;
+};
+/**
+ * Use the distinct IHttpResponse interface from \@smithy/types instead.
+ * This should not be used due to
+ * overlapping with the concrete class' name.
+ *
+ * This is not marked deprecated since that would mark the concrete class
+ * deprecated as well.
+ *
+ * @internal
+ */
+export interface HttpResponse extends IHttpResponse {
+}
+/**
+ * @public
+ */
+export declare class HttpResponse {
+    statusCode: number;
+    reason?: string;
+    headers: HeaderBag;
+    body?: any;
+    constructor(options: HttpResponseOptions);
+    static isInstance(response: unknown): response is HttpResponse;
+}
+export {};
@@ -0,0 +1,8 @@
+export * from "./extensions";
+export * from "./Field";
+export * from "./Fields";
+export * from "./httpHandler";
+export * from "./httpRequest";
+export * from "./httpResponse";
+export * from "./isValidHostname";
+export * from "./types";
@@ -0,0 +1 @@
+export declare function isValidHostname(hostname: string): boolean;
@@ -0,0 +1,21 @@
+import { FieldOptions as __FieldOptions, FieldPosition as __FieldPosition, HeaderBag as __HeaderBag, HttpHandlerOptions as __HttpHandlerOptions, HttpMessage as __HttpMessage } from "@smithy/types";
+/**
+ * @deprecated Use FieldOptions from `@smithy/types` instead
+ */
+export type FieldOptions = __FieldOptions;
+/**
+ * @deprecated Use FieldPosition from `@smithy/types` instead
+ */
+export type FieldPosition = __FieldPosition;
+/**
+ * @deprecated Use HeaderBag from `@smithy/types` instead
+ */
+export type HeaderBag = __HeaderBag;
+/**
+ * @deprecated Use HttpMessage from `@smithy/types` instead
+ */
+export type HttpMessage = __HttpMessage;
+/**
+ * @deprecated Use HttpHandlerOptions from `@smithy/types` instead
+ */
+export type HttpHandlerOptions = __HttpHandlerOptions;
@@ -0,0 +1,21 @@
+import { FieldOptions as __FieldOptions, FieldPosition as __FieldPosition, HeaderBag as __HeaderBag, HttpHandlerOptions as __HttpHandlerOptions, HttpMessage as __HttpMessage } from "@smithy/types";
+/**
+ * @deprecated Use FieldOptions from `@smithy/types` instead
+ */
+export type FieldOptions = __FieldOptions;
+/**
+ * @deprecated Use FieldPosition from `@smithy/types` instead
+ */
+export type FieldPosition = __FieldPosition;
+/**
+ * @deprecated Use HeaderBag from `@smithy/types` instead
+ */
+export type HeaderBag = __HeaderBag;
+/**
+ * @deprecated Use HttpMessage from `@smithy/types` instead
+ */
+export type HttpMessage = __HttpMessage;
+/**
+ * @deprecated Use HttpHandlerOptions from `@smithy/types` instead
+ */
+export type HttpHandlerOptions = __HttpHandlerOptions;
@@ -0,0 +1,61 @@
+{
+  "name": "@smithy/protocol-http",
+  "version": "5.1.2",
+  "scripts": {
+    "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types && yarn build:types:downlevel'",
+    "build:cjs": "node ../../scripts/inline protocol-http",
+    "build:es": "yarn g:tsc -p tsconfig.es.json",
+    "build:types": "yarn g:tsc -p tsconfig.types.json",
+    "build:types:downlevel": "rimraf dist-types/ts3.4 && downlevel-dts dist-types dist-types/ts3.4",
+    "stage-release": "rimraf ./.release && yarn pack && mkdir ./.release && tar zxvf ./package.tgz --directory ./.release && rm ./package.tgz",
+    "clean": "rimraf ./dist-* && rimraf *.tsbuildinfo || exit 0",
+    "lint": "eslint -c ../../.eslintrc.js \"src/**/*.ts\"",
+    "format": "prettier --config ../../prettier.config.js --ignore-path ../../.prettierignore --write \"**/*.{ts,md,json}\"",
+    "test": "yarn g:vitest run",
+    "test:watch": "yarn g:vitest watch"
+  },
+  "main": "./dist-cjs/index.js",
+  "module": "./dist-es/index.js",
+  "types": "./dist-types/index.d.ts",
+  "author": {
+    "name": "AWS Smithy Team",
+    "email": "",
+    "url": "https://smithy.io"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@smithy/types": "^4.3.1",
+    "tslib": "^2.6.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "typesVersions": {
+    "<4.0": {
+      "dist-types/*": [
+        "dist-types/ts3.4/*"
+      ]
+    }
+  },
+  "files": [
+    "dist-*/**"
+  ],
+  "homepage": "https://github.com/smithy-lang/smithy-typescript/tree/main/packages/protocol-http",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/smithy-lang/smithy-typescript.git",
+    "directory": "packages/protocol-http"
+  },
+  "devDependencies": {
+    "concurrently": "7.0.0",
+    "downlevel-dts": "0.10.1",
+    "rimraf": "3.0.2",
+    "typedoc": "0.23.23"
+  },
+  "typedoc": {
+    "entryPoint": "src/index.ts"
+  },
+  "publishConfig": {
+    "directory": ".release/package"
+  }
+}
				`@@ -0,0 +1 @@`
				`export * from "./httpExtensionConfiguration";`
				`@@ -0,0 +1 @@`
				`export declare function isValidHostname(hostname: string): boolean;`