@azure/service-bus 7.10.0-beta.1 → 7.10.0-beta.3

package/dist/commonjs/dataTransformer.d.ts

@@ -0,0 +1,77 @@
+/** @internal */
+export declare const dataSectionTypeCode: 117;
+/** @internal */
+export declare const sequenceSectionTypeCode: 118;
+/** @internal */
+export declare const valueSectionTypeCode: 119;
+/**
+ * Mirror of the internal Section interface in rhea.
+ *
+ * @internal
+ */
+export interface RheaAmqpSection {
+    typecode: typeof dataSectionTypeCode | typeof sequenceSectionTypeCode | typeof valueSectionTypeCode;
+    content: any;
+}
+/**
+ * The default data transformer that will be used by the Azure SDK.
+ * @internal
+ */
+export declare const defaultDataTransformer: {
+    /**
+     * A function that takes the body property from an EventData object
+     * and returns an encoded body (some form of AMQP type).
+     *
+     * @param body - The AMQP message body
+     * @returns The encoded AMQP message body as an AMQP Data type
+     * (data section in rhea terms). Section object with following properties:
+     * - typecode: 117 (0x75)
+     * - content: The given AMQP message body as a Buffer.
+     * - multiple: true | undefined.
+     */
+    encode(body: unknown, bodyType: "data" | "value" | "sequence"): any;
+    /**
+     * A function that takes the body property from an AMQP message
+     * (an AMQP Data type (data section in rhea terms)) and returns the decoded message body.
+     * If it cannot decode the body then it returns the body
+     * as-is.
+     *
+     * NOTE: Use this to decode a message body when you know that the entire contents are _only_ contained
+     * in the 'data' section of the message (for instance, messages from the $mgmt link). Otherwise
+     * use 'defaultDataTransformer.decodeWithType', which can handle data coming from separate sections
+     * of the AMQP mesage.
+     *
+     * @param body - The AMQP message body
+     * @param skipParsingBodyAsJson - Boolean to skip running JSON.parse() on message body content.
+     * @returns decoded body or the given body as-is.
+     */
+    decode(body: unknown, skipParsingBodyAsJson: boolean): unknown;
+    /**
+     * A function that takes the body property from an AMQP message, which can come from either
+     * the 'data', 'value' or 'sequence' sections of an AMQP message.
+     *
+     * If the body is not a JSON string the the raw contents will be returned, along with the bodyType
+     * indicating which part of the AMQP message the body was decoded from.
+     *
+     * @param body - The AMQP message body as received from rhea.
+     * @param skipParsingBodyAsJson - Boolean to skip running JSON.parse() on message body.
+     * @returns The decoded/raw body and the body type.
+     */
+    decodeWithType(body: unknown | RheaAmqpSection, skipParsingBodyAsJson: boolean): {
+        body: unknown;
+        bodyType: "data" | "sequence" | "value";
+    };
+};
+/** @internal */
+export declare function isRheaAmqpSection(possibleSection: any | RheaAmqpSection): possibleSection is RheaAmqpSection;
+/**
+ * Attempts to decode 'body' as a JSON string. If it fails it returns body
+ * verbatim.
+ *
+ * @param body - An AMQP message body.
+ * @returns A JSON decoded object, or body if body was not a JSON string.
+ *
+ * @internal
+ */
+export declare function tryToJsonDecode(body: any): any;
+//# sourceMappingURL=dataTransformer.d.ts.map

package/dist/commonjs/dataTransformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataTransformer.d.ts","sourceRoot":"","sources":["../../src/dataTransformer.ts"],"names":[],"mappings":"AAQA,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,EAAG,GAAa,CAAC;AACjD,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,EAAG,GAAa,CAAC;AACrD,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,EAAG,GAAa,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EACJ,OAAO,mBAAmB,GAC1B,OAAO,uBAAuB,GAC9B,OAAO,oBAAoB,CAAC;IAChC,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;;;;;;;;OAUG;iBACU,OAAO,YAAY,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,GAAG;IA8BnE;;;;;;;;;;;;;;OAcG;iBACU,OAAO,yBAAyB,OAAO,GAAG,OAAO;IAS9D;;;;;;;;;;OAUG;yBAEK,OAAO,GAAG,eAAe,yBACR,OAAO,GAC7B;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAA;KAAE;CAkC9D,CAAC;AAEF,gBAAgB;AAChB,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,GAAG,GAAG,eAAe,GACrC,eAAe,IAAI,eAAe,CAQpC;AAED;;;;;;;;GAQG;AAEH,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAe9C"}

package/dist/commonjs/dataTransformer.js

@@ -0,0 +1,169 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultDataTransformer = exports.valueSectionTypeCode = exports.sequenceSectionTypeCode = exports.dataSectionTypeCode = void 0;
+exports.isRheaAmqpSection = isRheaAmqpSection;
+exports.tryToJsonDecode = tryToJsonDecode;
+const tslib_1 = require("tslib");
+const rhea_promise_1 = require("rhea-promise");
+const is_buffer_1 = tslib_1.__importDefault(require("is-buffer"));
+const buffer_1 = require("buffer");
+const log_js_1 = require("./log.js");
+/** @internal */
+exports.dataSectionTypeCode = 0x75;
+/** @internal */
+exports.sequenceSectionTypeCode = 0x76;
+/** @internal */
+exports.valueSectionTypeCode = 0x77;
+/**
+ * The default data transformer that will be used by the Azure SDK.
+ * @internal
+ */
+exports.defaultDataTransformer = {
+    /**
+     * A function that takes the body property from an EventData object
+     * and returns an encoded body (some form of AMQP type).
+     *
+     * @param body - The AMQP message body
+     * @returns The encoded AMQP message body as an AMQP Data type
+     * (data section in rhea terms). Section object with following properties:
+     * - typecode: 117 (0x75)
+     * - content: The given AMQP message body as a Buffer.
+     * - multiple: true | undefined.
+     */
+    encode(body, bodyType) {
+        let result;
+        if (bodyType === "value") {
+            // TODO: Expose value_section from `rhea` similar to the data_section and sequence_section. Right now there isn't a way to create a value section officially.
+            result = rhea_promise_1.message.data_section(body);
+            result.typecode = exports.valueSectionTypeCode;
+        }
+        else if (bodyType === "sequence") {
+            result = rhea_promise_1.message.sequence_section(body);
+        }
+        else if ((0, is_buffer_1.default)(body) || body instanceof Uint8Array) {
+            result = rhea_promise_1.message.data_section(body);
+        }
+        else {
+            // string, undefined, null, boolean, array, object, number should end up here
+            // coercing undefined to null as that will ensure that null value will be given to the
+            // customer on receive.
+            if (body === undefined)
+                body = null; // tslint:disable-line
+            try {
+                const bodyStr = JSON.stringify(body);
+                result = rhea_promise_1.message.data_section(buffer_1.Buffer.from(bodyStr, "utf8"));
+            }
+            catch (err) {
+                const msg = `An error occurred while executing JSON.stringify() on the given body ` +
+                    body +
+                    `${err ? err.stack : JSON.stringify(err)}`;
+                log_js_1.logger.warning("[encode] " + msg);
+                (0, log_js_1.logErrorStackTrace)(log_js_1.logger, err);
+                throw new Error(msg);
+            }
+        }
+        return result;
+    },
+    /**
+     * A function that takes the body property from an AMQP message
+     * (an AMQP Data type (data section in rhea terms)) and returns the decoded message body.
+     * If it cannot decode the body then it returns the body
+     * as-is.
+     *
+     * NOTE: Use this to decode a message body when you know that the entire contents are _only_ contained
+     * in the 'data' section of the message (for instance, messages from the $mgmt link). Otherwise
+     * use 'defaultDataTransformer.decodeWithType', which can handle data coming from separate sections
+     * of the AMQP mesage.
+     *
+     * @param body - The AMQP message body
+     * @param skipParsingBodyAsJson - Boolean to skip running JSON.parse() on message body content.
+     * @returns decoded body or the given body as-is.
+     */
+    decode(body, skipParsingBodyAsJson) {
+        let actualContent = body;
+        if (isRheaAmqpSection(body)) {
+            actualContent = body.content;
+        }
+        return skipParsingBodyAsJson ? actualContent : tryToJsonDecode(actualContent);
+    },
+    /**
+     * A function that takes the body property from an AMQP message, which can come from either
+     * the 'data', 'value' or 'sequence' sections of an AMQP message.
+     *
+     * If the body is not a JSON string the the raw contents will be returned, along with the bodyType
+     * indicating which part of the AMQP message the body was decoded from.
+     *
+     * @param body - The AMQP message body as received from rhea.
+     * @param skipParsingBodyAsJson - Boolean to skip running JSON.parse() on message body.
+     * @returns The decoded/raw body and the body type.
+     */
+    decodeWithType(body, skipParsingBodyAsJson) {
+        try {
+            if (isRheaAmqpSection(body)) {
+                switch (body.typecode) {
+                    case exports.dataSectionTypeCode:
+                        return {
+                            body: skipParsingBodyAsJson ? body.content : tryToJsonDecode(body.content),
+                            bodyType: "data",
+                        };
+                    case exports.sequenceSectionTypeCode:
+                        // typecode:
+                        // handle sequences
+                        return { body: body.content, bodyType: "sequence" };
+                    case exports.valueSectionTypeCode:
+                        // value
+                        return { body: body.content, bodyType: "value" };
+                }
+            }
+            else {
+                // not sure - we have to try to infer the proper bodyType and content
+                if ((0, is_buffer_1.default)(body)) {
+                    // This indicates that we are getting the AMQP described type. Let us try decoding it.
+                    return { body: skipParsingBodyAsJson ? body : tryToJsonDecode(body), bodyType: "data" };
+                }
+                else {
+                    return { body: body, bodyType: "value" };
+                }
+            }
+        }
+        catch (err) {
+            log_js_1.logger.verbose("[decode] An error occurred while decoding the received message body. The error is: %O", err);
+            throw err;
+        }
+    },
+};
+/** @internal */
+function isRheaAmqpSection(possibleSection) {
+    return (possibleSection != null &&
+        typeof possibleSection.typecode === "number" &&
+        (possibleSection.typecode === exports.dataSectionTypeCode ||
+            possibleSection.typecode === exports.valueSectionTypeCode ||
+            possibleSection.typecode === exports.sequenceSectionTypeCode));
+}
+/**
+ * Attempts to decode 'body' as a JSON string. If it fails it returns body
+ * verbatim.
+ *
+ * @param body - An AMQP message body.
+ * @returns A JSON decoded object, or body if body was not a JSON string.
+ *
+ * @internal
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+function tryToJsonDecode(body) {
+    let processedBody = body;
+    try {
+        // Trying to stringify and JSON.parse() anything else will fail flat and we shall return
+        // the original type back
+        const bodyStr = processedBody.toString("utf8");
+        processedBody = JSON.parse(bodyStr);
+    }
+    catch (err) {
+        log_js_1.logger.verbose("[decode] An error occurred while trying JSON.parse() on the received body. " +
+            "The error is %O", err);
+    }
+    return processedBody;
+}
+//# sourceMappingURL=dataTransformer.js.map

package/dist/commonjs/dataTransformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataTransformer.js","sourceRoot":"","sources":["../../src/dataTransformer.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { message } from \"rhea-promise\";\nimport isBuffer from \"is-buffer\";\nimport { Buffer } from \"buffer\";\nimport { logErrorStackTrace, logger } from \"./log.js\";\n\n/** @internal */\nexport const dataSectionTypeCode = 0x75 as const;\n/** @internal */\nexport const sequenceSectionTypeCode = 0x76 as const;\n/** @internal */\nexport const valueSectionTypeCode = 0x77 as const;\n\n/**\n * Mirror of the internal Section interface in rhea.\n *\n * @internal\n */\nexport interface RheaAmqpSection {\n  typecode:\n    | typeof dataSectionTypeCode\n    | typeof sequenceSectionTypeCode\n    | typeof valueSectionTypeCode;\n  content: any;\n}\n\n/**\n * The default data transformer that will be used by the Azure SDK.\n * @internal\n */\nexport const defaultDataTransformer = {\n  /**\n   * A function that takes the body property from an EventData object\n   * and returns an encoded body (some form of AMQP type).\n   *\n   * @param body - The AMQP message body\n   * @returns The encoded AMQP message body as an AMQP Data type\n   * (data section in rhea terms). Section object with following properties:\n   * - typecode: 117 (0x75)\n   * - content: The given AMQP message body as a Buffer.\n   * - multiple: true | undefined.\n   */\n  encode(body: unknown, bodyType: \"data\" | \"value\" | \"sequence\"): any {\n    let result: any;\n    if (bodyType === \"value\") {\n      // TODO: Expose value_section from `rhea` similar to the data_section and sequence_section. Right now there isn't a way to create a value section officially.\n      result = message.data_section(body);\n      result.typecode = valueSectionTypeCode;\n    } else if (bodyType === \"sequence\") {\n      result = message.sequence_section(body);\n    } else if (isBuffer(body) || body instanceof Uint8Array) {\n      result = message.data_section(body);\n    } else {\n      // string, undefined, null, boolean, array, object, number should end up here\n      // coercing undefined to null as that will ensure that null value will be given to the\n      // customer on receive.\n      if (body === undefined) body = null; // tslint:disable-line\n      try {\n        const bodyStr = JSON.stringify(body);\n        result = message.data_section(Buffer.from(bodyStr, \"utf8\"));\n      } catch (err: any) {\n        const msg =\n          `An error occurred while executing JSON.stringify() on the given body ` +\n          body +\n          `${err ? err.stack : JSON.stringify(err)}`;\n        logger.warning(\"[encode] \" + msg);\n        logErrorStackTrace(logger, err);\n        throw new Error(msg);\n      }\n    }\n    return result;\n  },\n  /**\n   * A function that takes the body property from an AMQP message\n   * (an AMQP Data type (data section in rhea terms)) and returns the decoded message body.\n   * If it cannot decode the body then it returns the body\n   * as-is.\n   *\n   * NOTE: Use this to decode a message body when you know that the entire contents are _only_ contained\n   * in the 'data' section of the message (for instance, messages from the $mgmt link). Otherwise\n   * use 'defaultDataTransformer.decodeWithType', which can handle data coming from separate sections\n   * of the AMQP mesage.\n   *\n   * @param body - The AMQP message body\n   * @param skipParsingBodyAsJson - Boolean to skip running JSON.parse() on message body content.\n   * @returns decoded body or the given body as-is.\n   */\n  decode(body: unknown, skipParsingBodyAsJson: boolean): unknown {\n    let actualContent = body;\n\n    if (isRheaAmqpSection(body)) {\n      actualContent = body.content;\n    }\n\n    return skipParsingBodyAsJson ? actualContent : tryToJsonDecode(actualContent);\n  },\n  /**\n   * A function that takes the body property from an AMQP message, which can come from either\n   * the 'data', 'value' or 'sequence' sections of an AMQP message.\n   *\n   * If the body is not a JSON string the the raw contents will be returned, along with the bodyType\n   * indicating which part of the AMQP message the body was decoded from.\n   *\n   * @param body - The AMQP message body as received from rhea.\n   * @param skipParsingBodyAsJson - Boolean to skip running JSON.parse() on message body.\n   * @returns The decoded/raw body and the body type.\n   */\n  decodeWithType(\n    body: unknown | RheaAmqpSection,\n    skipParsingBodyAsJson: boolean,\n  ): { body: unknown; bodyType: \"data\" | \"sequence\" | \"value\" } {\n    try {\n      if (isRheaAmqpSection(body)) {\n        switch (body.typecode) {\n          case dataSectionTypeCode:\n            return {\n              body: skipParsingBodyAsJson ? body.content : tryToJsonDecode(body.content),\n              bodyType: \"data\",\n            };\n          case sequenceSectionTypeCode:\n            // typecode:\n            // handle sequences\n            return { body: body.content, bodyType: \"sequence\" };\n          case valueSectionTypeCode:\n            // value\n            return { body: body.content, bodyType: \"value\" };\n        }\n      } else {\n        // not sure - we have to try to infer the proper bodyType and content\n        if (isBuffer(body)) {\n          // This indicates that we are getting the AMQP described type. Let us try decoding it.\n          return { body: skipParsingBodyAsJson ? body : tryToJsonDecode(body), bodyType: \"data\" };\n        } else {\n          return { body: body, bodyType: \"value\" };\n        }\n      }\n    } catch (err: any) {\n      logger.verbose(\n        \"[decode] An error occurred while decoding the received message body. The error is: %O\",\n        err,\n      );\n      throw err;\n    }\n  },\n};\n\n/** @internal */\nexport function isRheaAmqpSection(\n  possibleSection: any | RheaAmqpSection,\n): possibleSection is RheaAmqpSection {\n  return (\n    possibleSection != null &&\n    typeof possibleSection.typecode === \"number\" &&\n    (possibleSection.typecode === dataSectionTypeCode ||\n      possibleSection.typecode === valueSectionTypeCode ||\n      possibleSection.typecode === sequenceSectionTypeCode)\n  );\n}\n\n/**\n * Attempts to decode 'body' as a JSON string. If it fails it returns body\n * verbatim.\n *\n * @param body - An AMQP message body.\n * @returns A JSON decoded object, or body if body was not a JSON string.\n *\n * @internal\n */\n// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types\nexport function tryToJsonDecode(body: any): any {\n  let processedBody = body;\n  try {\n    // Trying to stringify and JSON.parse() anything else will fail flat and we shall return\n    // the original type back\n    const bodyStr: string = processedBody.toString(\"utf8\");\n    processedBody = JSON.parse(bodyStr);\n  } catch (err: any) {\n    logger.verbose(\n      \"[decode] An error occurred while trying JSON.parse() on the received body. \" +\n        \"The error is %O\",\n      err,\n    );\n  }\n  return processedBody;\n}\n"]}

package/dist/commonjs/diagnostics/instrumentServiceBusMessage.d.ts

@@ -0,0 +1,50 @@
+import type { TracingContext, TracingSpanOptions } from "@azure/core-tracing";
+import type { ConnectionContext } from "../connectionContext.js";
+import type { OperationOptionsBase } from "../modelsToBeSharedWithEventHubs.js";
+import type { ServiceBusReceiver } from "../receivers/receiver.js";
+import type { ServiceBusMessage, ServiceBusReceivedMessage } from "../serviceBusMessage.js";
+import type { MessagingOperationNames } from "./tracing.js";
+/**
+ * @internal
+ */
+export declare const TRACEPARENT_PROPERTY = "Diagnostic-Id";
+/**
+ * @hidden
+ */
+export interface InstrumentableMessage {
+    /**
+     * The application specific properties which can be
+     * used for custom message metadata.
+     */
+    applicationProperties?: {
+        [key: string]: number | boolean | string | Date | null;
+    };
+}
+/**
+ * Instruments an AMQP message with a proper `Diagnostic-Id` for tracing.
+ *
+ * @hidden
+ */
+export declare function instrumentMessage<T extends InstrumentableMessage>(message: T, options: OperationOptionsBase, entityPath: string, host: string, operation: MessagingOperationNames): {
+    /**
+     * If instrumentation was done, a copy of the message with
+     * message.applicationProperties['Diagnostic-Id'] filled
+     * out appropriately.
+     */
+    message: T;
+    /**
+     * A valid SpanContext if this message should be linked to a parent span, or undefined otherwise.
+     */
+    spanContext: TracingContext | undefined;
+};
+/**
+ * Extracts the `SpanContext` from an `ServiceBusMessage` if the context exists.
+ * @param message - An individual `ServiceBusMessage` object.
+ * @internal
+ */
+export declare function extractSpanContextFromServiceBusMessage(message: ServiceBusMessage): TracingContext | undefined;
+/**
+ * @internal
+ */
+export declare function toProcessingSpanOptions(receivedMessages: ServiceBusReceivedMessage | ServiceBusReceivedMessage[], receiver: Pick<ServiceBusReceiver, "entityPath">, connectionConfig: Pick<ConnectionContext["config"], "host">, operation: MessagingOperationNames): TracingSpanOptions;
+//# sourceMappingURL=instrumentServiceBusMessage.d.ts.map

package/dist/commonjs/diagnostics/instrumentServiceBusMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentServiceBusMessage.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/instrumentServiceBusMessage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAmB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5D;;GAEG;AACH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,qBAAqB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC;CACpF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,qBAAqB,EAC/D,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,uBAAuB,GACjC;IACD;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,WAAW,EAAE,cAAc,GAAG,SAAS,CAAC;CACzC,CA+CA;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,iBAAiB,GACzB,cAAc,GAAG,SAAS,CAO5B;AAqBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,yBAAyB,GAAG,yBAAyB,EAAE,EACzE,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,EAChD,gBAAgB,EAAE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAC3D,SAAS,EAAE,uBAAuB,GACjC,kBAAkB,CAkBpB"}

package/dist/commonjs/diagnostics/instrumentServiceBusMessage.js

@@ -0,0 +1,107 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRACEPARENT_PROPERTY = void 0;
+exports.instrumentMessage = instrumentMessage;
+exports.extractSpanContextFromServiceBusMessage = extractSpanContextFromServiceBusMessage;
+exports.toProcessingSpanOptions = toProcessingSpanOptions;
+const tracing_js_1 = require("./tracing.js");
+/**
+ * @internal
+ */
+exports.TRACEPARENT_PROPERTY = "Diagnostic-Id";
+/**
+ * Instruments an AMQP message with a proper `Diagnostic-Id` for tracing.
+ *
+ * @hidden
+ */
+function instrumentMessage(message, options, entityPath, host, operation) {
+    // check if the event has already been instrumented
+    const previouslyInstrumented = Boolean(message.applicationProperties?.[exports.TRACEPARENT_PROPERTY]);
+    if (previouslyInstrumented) {
+        return {
+            message,
+            spanContext: undefined,
+        };
+    }
+    const { span: messageSpan, updatedOptions } = tracing_js_1.tracingClient.startSpan("message", options, (0, tracing_js_1.toSpanOptions)({ entityPath, host }, operation, "producer"));
+    try {
+        if (!messageSpan.isRecording()) {
+            return {
+                message,
+                spanContext: undefined,
+            };
+        }
+        const traceParent = tracing_js_1.tracingClient.createRequestHeaders(updatedOptions.tracingOptions?.tracingContext)["traceparent"];
+        if (traceParent) {
+            // create a copy so the original isn't modified
+            message = {
+                ...message,
+                applicationProperties: {
+                    ...message.applicationProperties,
+                    [exports.TRACEPARENT_PROPERTY]: traceParent,
+                },
+            };
+        }
+        return {
+            message,
+            spanContext: updatedOptions.tracingOptions?.tracingContext,
+        };
+    }
+    finally {
+        messageSpan.end();
+    }
+}
+/**
+ * Extracts the `SpanContext` from an `ServiceBusMessage` if the context exists.
+ * @param message - An individual `ServiceBusMessage` object.
+ * @internal
+ */
+function extractSpanContextFromServiceBusMessage(message) {
+    if (!message.applicationProperties || !message.applicationProperties[exports.TRACEPARENT_PROPERTY]) {
+        return;
+    }
+    const diagnosticId = message.applicationProperties[exports.TRACEPARENT_PROPERTY];
+    return tracing_js_1.tracingClient.parseTraceparentHeader(diagnosticId);
+}
+/**
+ * Provides an iterable over messages, whether it is a single message or multiple
+ * messages.
+ *
+ * @param receivedMessages - A single message or a set of messages
+ * @internal
+ */
+function* getReceivedMessages(receivedMessages) {
+    if (!Array.isArray(receivedMessages)) {
+        yield receivedMessages;
+    }
+    else {
+        for (const message of receivedMessages) {
+            yield message;
+        }
+    }
+}
+/**
+ * @internal
+ */
+function toProcessingSpanOptions(receivedMessages, receiver, connectionConfig, operation) {
+    const spanLinks = [];
+    for (const receivedMessage of getReceivedMessages(receivedMessages)) {
+        const tracingContext = extractSpanContextFromServiceBusMessage(receivedMessage);
+        if (tracingContext) {
+            spanLinks.push({
+                tracingContext,
+                attributes: {
+                    enqueuedTime: receivedMessage.enqueuedTimeUtc?.getTime(),
+                },
+            });
+        }
+    }
+    return {
+        spanLinks,
+        spanKind: "consumer",
+        ...(0, tracing_js_1.toSpanOptions)({ host: connectionConfig.host, entityPath: receiver.entityPath }, operation),
+    };
+}
+//# sourceMappingURL=instrumentServiceBusMessage.js.map

package/dist/commonjs/diagnostics/instrumentServiceBusMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentServiceBusMessage.js","sourceRoot":"","sources":["../../../src/diagnostics/instrumentServiceBusMessage.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { TracingContext, TracingSpanLink, TracingSpanOptions } from \"@azure/core-tracing\";\nimport type { ConnectionContext } from \"../connectionContext.js\";\nimport type { OperationOptionsBase } from \"../modelsToBeSharedWithEventHubs.js\";\nimport type { ServiceBusReceiver } from \"../receivers/receiver.js\";\nimport type { ServiceBusMessage, ServiceBusReceivedMessage } from \"../serviceBusMessage.js\";\nimport type { MessagingOperationNames } from \"./tracing.js\";\nimport { toSpanOptions, tracingClient } from \"./tracing.js\";\n\n/**\n * @internal\n */\nexport const TRACEPARENT_PROPERTY = \"Diagnostic-Id\";\n\n/**\n * @hidden\n */\nexport interface InstrumentableMessage {\n  /**\n   * The application specific properties which can be\n   * used for custom message metadata.\n   */\n  applicationProperties?: { [key: string]: number | boolean | string | Date | null };\n}\n\n/**\n * Instruments an AMQP message with a proper `Diagnostic-Id` for tracing.\n *\n * @hidden\n */\nexport function instrumentMessage<T extends InstrumentableMessage>(\n  message: T,\n  options: OperationOptionsBase,\n  entityPath: string,\n  host: string,\n  operation: MessagingOperationNames,\n): {\n  /**\n   * If instrumentation was done, a copy of the message with\n   * message.applicationProperties['Diagnostic-Id'] filled\n   * out appropriately.\n   */\n  message: T;\n\n  /**\n   * A valid SpanContext if this message should be linked to a parent span, or undefined otherwise.\n   */\n  spanContext: TracingContext | undefined;\n} {\n  // check if the event has already been instrumented\n  const previouslyInstrumented = Boolean(message.applicationProperties?.[TRACEPARENT_PROPERTY]);\n\n  if (previouslyInstrumented) {\n    return {\n      message,\n      spanContext: undefined,\n    };\n  }\n\n  const { span: messageSpan, updatedOptions } = tracingClient.startSpan(\n    \"message\",\n    options,\n    toSpanOptions({ entityPath, host }, operation, \"producer\"),\n  );\n\n  try {\n    if (!messageSpan.isRecording()) {\n      return {\n        message,\n        spanContext: undefined,\n      };\n    }\n\n    const traceParent = tracingClient.createRequestHeaders(\n      updatedOptions.tracingOptions?.tracingContext,\n    )[\"traceparent\"];\n\n    if (traceParent) {\n      // create a copy so the original isn't modified\n      message = {\n        ...message,\n        applicationProperties: {\n          ...message.applicationProperties,\n          [TRACEPARENT_PROPERTY]: traceParent,\n        },\n      };\n    }\n\n    return {\n      message,\n      spanContext: updatedOptions.tracingOptions?.tracingContext,\n    };\n  } finally {\n    messageSpan.end();\n  }\n}\n\n/**\n * Extracts the `SpanContext` from an `ServiceBusMessage` if the context exists.\n * @param message - An individual `ServiceBusMessage` object.\n * @internal\n */\nexport function extractSpanContextFromServiceBusMessage(\n  message: ServiceBusMessage,\n): TracingContext | undefined {\n  if (!message.applicationProperties || !message.applicationProperties[TRACEPARENT_PROPERTY]) {\n    return;\n  }\n\n  const diagnosticId = message.applicationProperties[TRACEPARENT_PROPERTY] as string;\n  return tracingClient.parseTraceparentHeader(diagnosticId);\n}\n\n/**\n * Provides an iterable over messages, whether it is a single message or multiple\n * messages.\n *\n * @param receivedMessages - A single message or a set of messages\n * @internal\n */\nfunction* getReceivedMessages(\n  receivedMessages: ServiceBusReceivedMessage | ServiceBusReceivedMessage[],\n): Iterable<ServiceBusReceivedMessage> {\n  if (!Array.isArray(receivedMessages)) {\n    yield receivedMessages;\n  } else {\n    for (const message of receivedMessages) {\n      yield message;\n    }\n  }\n}\n\n/**\n * @internal\n */\nexport function toProcessingSpanOptions(\n  receivedMessages: ServiceBusReceivedMessage | ServiceBusReceivedMessage[],\n  receiver: Pick<ServiceBusReceiver, \"entityPath\">,\n  connectionConfig: Pick<ConnectionContext[\"config\"], \"host\">,\n  operation: MessagingOperationNames,\n): TracingSpanOptions {\n  const spanLinks: TracingSpanLink[] = [];\n  for (const receivedMessage of getReceivedMessages(receivedMessages)) {\n    const tracingContext = extractSpanContextFromServiceBusMessage(receivedMessage);\n    if (tracingContext) {\n      spanLinks.push({\n        tracingContext,\n        attributes: {\n          enqueuedTime: receivedMessage.enqueuedTimeUtc?.getTime(),\n        },\n      });\n    }\n  }\n  return {\n    spanLinks,\n    spanKind: \"consumer\",\n    ...toSpanOptions({ host: connectionConfig.host, entityPath: receiver.entityPath }, operation),\n  };\n}\n"]}

package/dist/commonjs/diagnostics/tracing.d.ts

@@ -0,0 +1,21 @@
+import type { TracingSpanOptions, TracingSpanKind } from "@azure/core-tracing";
+import type { ConnectionConfig } from "@azure/core-amqp";
+/**
+ * The names of the operations that can be instrumented.
+ */
+export type MessagingOperationNames = "publish" | "receive" | "process" | "settle";
+/**
+ * The {@link TracingClient} that is used to add tracing spans.
+ */
+export declare const tracingClient: import("@azure/core-tracing").TracingClient;
+/**
+ * Creates {@link TracingSpanOptions} from the provided data.
+ * @param serviceBusConfig - The configuration object containing initial attributes to set on the span.
+ * @param spanKind - The {@link TracingSpanKind} for the newly created span.
+ * @param operation - The operation type.
+ * @returns a {@link TracingSpanOptions} that can be passed to a {@link TracingClient}
+ */
+export declare function toSpanOptions(serviceBusConfig: Pick<ConnectionConfig, "host"> & {
+    entityPath: string;
+}, operation: MessagingOperationNames, spanKind?: TracingSpanKind): TracingSpanOptions;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/commonjs/diagnostics/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/tracing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,aAAa,6CAIxB,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EACzE,SAAS,EAAE,uBAAuB,EAClC,QAAQ,CAAC,EAAE,eAAe,GACzB,kBAAkB,CAkBpB"}

package/dist/commonjs/diagnostics/tracing.js

@@ -0,0 +1,41 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tracingClient = void 0;
+exports.toSpanOptions = toSpanOptions;
+const core_tracing_1 = require("@azure/core-tracing");
+const constants_js_1 = require("../util/constants.js");
+/**
+ * The {@link TracingClient} that is used to add tracing spans.
+ */
+exports.tracingClient = (0, core_tracing_1.createTracingClient)({
+    namespace: "Microsoft.ServiceBus",
+    packageName: constants_js_1.packageJsonInfo.name,
+    packageVersion: constants_js_1.packageJsonInfo.version,
+});
+/**
+ * Creates {@link TracingSpanOptions} from the provided data.
+ * @param serviceBusConfig - The configuration object containing initial attributes to set on the span.
+ * @param spanKind - The {@link TracingSpanKind} for the newly created span.
+ * @param operation - The operation type.
+ * @returns a {@link TracingSpanOptions} that can be passed to a {@link TracingClient}
+ */
+function toSpanOptions(serviceBusConfig, operation, spanKind) {
+    const propertyName = operation === "process" || operation === "receive"
+        ? "messaging.source.name"
+        : "messaging.destination.name";
+    const spanOptions = {
+        spanAttributes: {
+            "messaging.system": "servicebus",
+            [propertyName]: serviceBusConfig.entityPath,
+            "messaging.operation": operation,
+            "net.peer.name": serviceBusConfig.host,
+        },
+    };
+    if (spanKind) {
+        spanOptions.spanKind = spanKind;
+    }
+    return spanOptions;
+}
+//# sourceMappingURL=tracing.js.map

package/dist/commonjs/diagnostics/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/diagnostics/tracing.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AA4BlC,sCAsBC;AA/CD,sDAA0D;AAE1D,uDAAuD;AAOvD;;GAEG;AACU,QAAA,aAAa,GAAG,IAAA,kCAAmB,EAAC;IAC/C,SAAS,EAAE,sBAAsB;IACjC,WAAW,EAAE,8BAAe,CAAC,IAAI;IACjC,cAAc,EAAE,8BAAe,CAAC,OAAO;CACxC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,SAAgB,aAAa,CAC3B,gBAAyE,EACzE,SAAkC,EAClC,QAA0B;IAE1B,MAAM,YAAY,GAChB,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;QAChD,CAAC,CAAC,uBAAuB;QACzB,CAAC,CAAC,4BAA4B,CAAC;IAEnC,MAAM,WAAW,GAAuB;QACtC,cAAc,EAAE;YACd,kBAAkB,EAAE,YAAY;YAChC,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC,UAAU;YAC3C,qBAAqB,EAAE,SAAS;YAChC,eAAe,EAAE,gBAAgB,CAAC,IAAI;SACvC;KACF,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAClC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { TracingSpanOptions, TracingSpanKind } from \"@azure/core-tracing\";\nimport { createTracingClient } from \"@azure/core-tracing\";\nimport type { ConnectionConfig } from \"@azure/core-amqp\";\nimport { packageJsonInfo } from \"../util/constants.js\";\n\n/**\n * The names of the operations that can be instrumented.\n */\nexport type MessagingOperationNames = \"publish\" | \"receive\" | \"process\" | \"settle\";\n\n/**\n * The {@link TracingClient} that is used to add tracing spans.\n */\nexport const tracingClient = createTracingClient({\n  namespace: \"Microsoft.ServiceBus\",\n  packageName: packageJsonInfo.name,\n  packageVersion: packageJsonInfo.version,\n});\n\n/**\n * Creates {@link TracingSpanOptions} from the provided data.\n * @param serviceBusConfig - The configuration object containing initial attributes to set on the span.\n * @param spanKind - The {@link TracingSpanKind} for the newly created span.\n * @param operation - The operation type.\n * @returns a {@link TracingSpanOptions} that can be passed to a {@link TracingClient}\n */\nexport function toSpanOptions(\n  serviceBusConfig: Pick<ConnectionConfig, \"host\"> & { entityPath: string },\n  operation: MessagingOperationNames,\n  spanKind?: TracingSpanKind,\n): TracingSpanOptions {\n  const propertyName =\n    operation === \"process\" || operation === \"receive\"\n      ? \"messaging.source.name\"\n      : \"messaging.destination.name\";\n\n  const spanOptions: TracingSpanOptions = {\n    spanAttributes: {\n      \"messaging.system\": \"servicebus\",\n      [propertyName]: serviceBusConfig.entityPath,\n      \"messaging.operation\": operation,\n      \"net.peer.name\": serviceBusConfig.host,\n    },\n  };\n  if (spanKind) {\n    spanOptions.spanKind = spanKind;\n  }\n  return spanOptions;\n}\n"]}

package/dist/commonjs/experimental/index.d.ts

@@ -0,0 +1,10 @@
+declare module "../models.js" {
+    interface PeekMessagesOptions {
+        /**
+         * (Experimental for diagnostic purpose) Specifies whether to omit the body when peeking messages. Default value `false`.
+         */
+        omitMessageBody?: boolean;
+    }
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/experimental/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/experimental/index.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,mBAAmB;QAC3B;;WAEG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;CACF"}

package/dist/commonjs/experimental/index.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/experimental/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/experimental/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\ndeclare module \"../models.js\" {\n  interface PeekMessagesOptions {\n    /**\n     * (Experimental for diagnostic purpose) Specifies whether to omit the body when peeking messages. Default value `false`.\n     */\n    omitMessageBody?: boolean;\n  }\n}\n"]}

package/dist/commonjs/index.d.ts

@@ -0,0 +1,26 @@
+export { delay, MessagingError, RetryOptions, RetryMode, TokenType, WebSocketOptions, } from "@azure/core-amqp";
+export { TokenCredential } from "@azure/core-auth";
+export { OperationOptions } from "@azure/core-client";
+export { Delivery, WebSocketImpl } from "rhea-promise";
+export { ServiceBusClientOptions } from "./constructorHelpers.js";
+export { CorrelationRuleFilter } from "./core/managementClient.js";
+export { DeleteMessagesOptions, PurgeMessagesOptions, CreateMessageBatchOptions, GetMessageIteratorOptions, MessageHandlers, PeekMessagesOptions, ProcessErrorArgs, ReceiveMessagesOptions, ServiceBusReceiverOptions, ServiceBusSessionReceiverOptions, ServiceBusSenderOptions, SubscribeOptions, } from "./models.js";
+export { OperationOptionsBase, TryAddOptions } from "./modelsToBeSharedWithEventHubs.js";
+export { ServiceBusReceiver } from "./receivers/receiver.js";
+export { ServiceBusSessionReceiver } from "./receivers/sessionReceiver.js";
+export { ServiceBusSender } from "./sender.js";
+export { ServiceBusRuleManager } from "./serviceBusRuleManager.js";
+export { NamespaceProperties } from "./serializers/namespaceResourceSerializer.js";
+export { CreateQueueOptions, QueueProperties, QueueRuntimeProperties, } from "./serializers/queueResourceSerializer.js";
+export { RuleProperties, SqlRuleAction, SqlRuleFilter, } from "./serializers/ruleResourceSerializer.js";
+export { CreateSubscriptionOptions, SubscriptionProperties, SubscriptionRuntimeProperties, } from "./serializers/subscriptionResourceSerializer.js";
+export { CreateTopicOptions, TopicProperties, TopicRuntimeProperties, } from "./serializers/topicResourceSerializer.js";
+export { EntitiesResponse, ServiceBusAdministrationClient, WithResponse, ServiceBusAdministrationClientOptions, } from "./serviceBusAtomManagementClient.js";
+export { ServiceBusClient } from "./serviceBusClient.js";
+export { isServiceBusError, ServiceBusError, ServiceBusErrorCode } from "./serviceBusError.js";
+export { DeadLetterOptions, ServiceBusMessage, ServiceBusReceivedMessage, } from "./serviceBusMessage.js";
+export { ServiceBusMessageBatch } from "./serviceBusMessageBatch.js";
+export { parseServiceBusConnectionString, ServiceBusConnectionStringProperties, } from "./util/connectionStringUtils.js";
+export { AuthorizationRule, EntityAvailabilityStatus, EntityStatus } from "./util/utils.js";
+export { HttpResponse, HttpHeader, RawHttpHeaders, HttpHeadersLike, TransferProgressEvent, WebResourceLike, } from "./util/compat/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,EACL,cAAc,EACd,YAAY,EACZ,SAAS,EACT,SAAS,EACT,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,sBAAsB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,sBAAsB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,YAAY,EACZ,qCAAqC,GACtC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,+BAA+B,EAC/B,oCAAoC,GACrC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,eAAe,GAChB,MAAM,wBAAwB,CAAC"}

package/dist/commonjs/index.js

@@ -0,0 +1,22 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseServiceBusConnectionString = exports.ServiceBusError = exports.isServiceBusError = exports.ServiceBusClient = exports.ServiceBusAdministrationClient = exports.TokenType = exports.RetryMode = exports.MessagingError = exports.delay = void 0;
+/// <reference lib="es2015" />
+/// <reference lib="esnext.asynciterable" />
+var core_amqp_1 = require("@azure/core-amqp");
+Object.defineProperty(exports, "delay", { enumerable: true, get: function () { return core_amqp_1.delay; } });
+Object.defineProperty(exports, "MessagingError", { enumerable: true, get: function () { return core_amqp_1.MessagingError; } });
+Object.defineProperty(exports, "RetryMode", { enumerable: true, get: function () { return core_amqp_1.RetryMode; } });
+Object.defineProperty(exports, "TokenType", { enumerable: true, get: function () { return core_amqp_1.TokenType; } });
+var serviceBusAtomManagementClient_js_1 = require("./serviceBusAtomManagementClient.js");
+Object.defineProperty(exports, "ServiceBusAdministrationClient", { enumerable: true, get: function () { return serviceBusAtomManagementClient_js_1.ServiceBusAdministrationClient; } });
+var serviceBusClient_js_1 = require("./serviceBusClient.js");
+Object.defineProperty(exports, "ServiceBusClient", { enumerable: true, get: function () { return serviceBusClient_js_1.ServiceBusClient; } });
+var serviceBusError_js_1 = require("./serviceBusError.js");
+Object.defineProperty(exports, "isServiceBusError", { enumerable: true, get: function () { return serviceBusError_js_1.isServiceBusError; } });
+Object.defineProperty(exports, "ServiceBusError", { enumerable: true, get: function () { return serviceBusError_js_1.ServiceBusError; } });
+var connectionStringUtils_js_1 = require("./util/connectionStringUtils.js");
+Object.defineProperty(exports, "parseServiceBusConnectionString", { enumerable: true, get: function () { return connectionStringUtils_js_1.parseServiceBusConnectionString; } });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,8BAA8B;AAC9B,4CAA4C;AAE5C,8CAO0B;AANxB,kGAAA,KAAK,OAAA;AACL,2GAAA,cAAc,OAAA;AAEd,sGAAA,SAAS,OAAA;AACT,sGAAA,SAAS,OAAA;AAgDX,yFAK6C;AAH3C,mJAAA,8BAA8B,OAAA;AAIhC,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,2DAA+F;AAAtF,uHAAA,iBAAiB,OAAA;AAAE,qHAAA,eAAe,OAAA;AAO3C,4EAGyC;AAFvC,2IAAA,+BAA+B,OAAA","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/// <reference lib=\"es2015\" />\n/// <reference lib=\"esnext.asynciterable\" />\n\nexport {\n  delay,\n  MessagingError,\n  RetryOptions,\n  RetryMode,\n  TokenType,\n  WebSocketOptions,\n} from \"@azure/core-amqp\";\nexport { TokenCredential } from \"@azure/core-auth\";\nexport { OperationOptions } from \"@azure/core-client\";\nexport { Delivery, WebSocketImpl } from \"rhea-promise\";\nexport { ServiceBusClientOptions } from \"./constructorHelpers.js\";\nexport { CorrelationRuleFilter } from \"./core/managementClient.js\";\nexport {\n  DeleteMessagesOptions,\n  PurgeMessagesOptions,\n  CreateMessageBatchOptions,\n  GetMessageIteratorOptions,\n  MessageHandlers,\n  PeekMessagesOptions,\n  ProcessErrorArgs,\n  ReceiveMessagesOptions,\n  ServiceBusReceiverOptions,\n  ServiceBusSessionReceiverOptions,\n  ServiceBusSenderOptions,\n  SubscribeOptions,\n} from \"./models.js\";\nexport { OperationOptionsBase, TryAddOptions } from \"./modelsToBeSharedWithEventHubs.js\";\nexport { ServiceBusReceiver } from \"./receivers/receiver.js\";\nexport { ServiceBusSessionReceiver } from \"./receivers/sessionReceiver.js\";\nexport { ServiceBusSender } from \"./sender.js\";\nexport { ServiceBusRuleManager } from \"./serviceBusRuleManager.js\";\nexport { NamespaceProperties } from \"./serializers/namespaceResourceSerializer.js\";\nexport {\n  CreateQueueOptions,\n  QueueProperties,\n  QueueRuntimeProperties,\n} from \"./serializers/queueResourceSerializer.js\";\nexport {\n  RuleProperties,\n  SqlRuleAction,\n  SqlRuleFilter,\n} from \"./serializers/ruleResourceSerializer.js\";\nexport {\n  CreateSubscriptionOptions,\n  SubscriptionProperties,\n  SubscriptionRuntimeProperties,\n} from \"./serializers/subscriptionResourceSerializer.js\";\nexport {\n  CreateTopicOptions,\n  TopicProperties,\n  TopicRuntimeProperties,\n} from \"./serializers/topicResourceSerializer.js\";\nexport {\n  EntitiesResponse,\n  ServiceBusAdministrationClient,\n  WithResponse,\n  ServiceBusAdministrationClientOptions,\n} from \"./serviceBusAtomManagementClient.js\";\nexport { ServiceBusClient } from \"./serviceBusClient.js\";\nexport { isServiceBusError, ServiceBusError, ServiceBusErrorCode } from \"./serviceBusError.js\";\nexport {\n  DeadLetterOptions,\n  ServiceBusMessage,\n  ServiceBusReceivedMessage,\n} from \"./serviceBusMessage.js\";\nexport { ServiceBusMessageBatch } from \"./serviceBusMessageBatch.js\";\nexport {\n  parseServiceBusConnectionString,\n  ServiceBusConnectionStringProperties,\n} from \"./util/connectionStringUtils.js\";\nexport { AuthorizationRule, EntityAvailabilityStatus, EntityStatus } from \"./util/utils.js\";\nexport {\n  HttpResponse,\n  HttpHeader,\n  RawHttpHeaders,\n  HttpHeadersLike,\n  TransferProgressEvent,\n  WebResourceLike,\n} from \"./util/compat/index.js\";\n"]}