@azure/storage-blob-changefeed 12.0.0-preview.3 → 12.0.0-preview.5

package/dist/browser/BlobChangeFeedClient.js

@@ -0,0 +1,242 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { BlobServiceClient, Pipeline } from "@azure/storage-blob";
+import { ChangeFeedFactory } from "./ChangeFeedFactory.js";
+import { CHANGE_FEED_MAX_PAGE_SIZE, SDK_VERSION } from "./utils/constants.js";
+/**
+ * Contains paged response data for the {@link BlobChangeFeedClient.listChanges} operation.
+ */
+export class BlobChangeFeedEventPage {
+    /**
+     * Array of {@link BlobChangeFeedEvent}.
+     */
+    events;
+    /**
+     * The token that keeps track of where to continue the iterator.
+     */
+    continuationToken;
+    constructor() {
+        this.events = [];
+        this.continuationToken = "";
+    }
+}
+/**
+ * Creates a new Pipeline object with Credential provided.
+ *
+ * @param credential -  Such as AnonymousCredential, StorageSharedKeyCredential or any credential from the `@azure/identity` package to authenticate requests to the service. You can also provide an object that implements the TokenCredential interface. If not specified, AnonymousCredential is used.
+ * @param pipelineOptions - Optional. Options.
+ * @returns A new Pipeline object.
+ */
+export function newPipeline(credential, pipelineOptions = {}) {
+    return newPipeline(credential, appendUserAgentPrefix(pipelineOptions));
+}
+function appendUserAgentPrefix(options) {
+    if (!options) {
+        options = {};
+    }
+    if (options.userAgentOptions === undefined) {
+        options.userAgentOptions = {};
+    }
+    if (options.userAgentOptions.userAgentPrefix === undefined) {
+        options.userAgentOptions.userAgentPrefix = "";
+    }
+    else if (options.userAgentOptions.userAgentPrefix !== "") {
+        options.userAgentOptions.userAgentPrefix += " ";
+    }
+    options.userAgentOptions.userAgentPrefix += `changefeed-js/${SDK_VERSION}`;
+    return options;
+}
+/**
+ * BlobChangeFeedClient.
+ * @see https://learn.microsoft.com/azure/storage/blobs/storage-blob-change-feed?tabs=azure-portal
+ */
+export class BlobChangeFeedClient {
+    /**
+     * blobServiceClient provided by `@azure/storage-blob` package.
+     */
+    blobServiceClient;
+    changeFeedFactory;
+    changeFeedClientOptions;
+    /**
+     *
+     * Creates an instance of BlobChangeFeedClient from connection string.
+     *
+     * @param connectionString - Account connection string or a SAS connection string of an Azure storage account.
+     *                                  [ Note - Account connection string can only be used in NODE.JS runtime. ]
+     *                                  Account connection string example -
+     *                                  `DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net`
+     *                                  SAS connection string example -
+     *                                  `BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString`
+     * @param options - Optional. Options to configure the HTTP pipeline.
+     */
+    static fromConnectionString(connectionString, 
+    // Legacy, no way to fix the eslint error without breaking. Disable the rule for this line.
+    /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */
+    options, 
+    // Static method to construct an object, the option is for the object not for the method.
+    /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */
+    changeFeedClientOptions) {
+        const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString, options);
+        return new BlobChangeFeedClient(blobServiceClient.url, blobServiceClient.credential, appendUserAgentPrefix(options), changeFeedClientOptions);
+    }
+    constructor(urlOrClient, credentialOrPipeline, 
+    // Legacy, no way to fix the eslint error without breaking. Disable the rule for this line.
+    /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */
+    options, changeFeedClientOptions) {
+        this.changeFeedClientOptions = changeFeedClientOptions || {};
+        this.changeFeedFactory = new ChangeFeedFactory(this.changeFeedClientOptions.maximumTransferSize);
+        if (credentialOrPipeline instanceof Pipeline) {
+            this.blobServiceClient = new BlobServiceClient(urlOrClient, credentialOrPipeline);
+        }
+        else {
+            this.blobServiceClient = new BlobServiceClient(urlOrClient, credentialOrPipeline, appendUserAgentPrefix(options));
+        }
+    }
+    async *getChange(options = {}) {
+        const changeFeed = await this.changeFeedFactory.create(this.blobServiceClient, undefined, options);
+        while (changeFeed.hasNext()) {
+            const event = await changeFeed.getChange({
+                abortSignal: options.abortSignal,
+                tracingOptions: options.tracingOptions,
+            });
+            if (event) {
+                yield event;
+            }
+            else {
+                return;
+            }
+        }
+    }
+    // start in ChangeFeedListChangesOptions will be ignored when continuationToken is specified.
+    async *getPage(continuationToken, maxPageSize, options = {}) {
+        const changeFeed = await this.changeFeedFactory.create(this.blobServiceClient, continuationToken, options);
+        if (!maxPageSize || maxPageSize > CHANGE_FEED_MAX_PAGE_SIZE) {
+            maxPageSize = CHANGE_FEED_MAX_PAGE_SIZE;
+        }
+        while (changeFeed.hasNext()) {
+            const eventPage = new BlobChangeFeedEventPage();
+            while (changeFeed.hasNext() && eventPage.events.length < maxPageSize) {
+                const event = await changeFeed.getChange({
+                    abortSignal: options.abortSignal,
+                    tracingOptions: options.tracingOptions,
+                });
+                if (event) {
+                    eventPage.events.push(event);
+                }
+            }
+            if (changeFeed.hasNext()) {
+                eventPage.continuationToken = JSON.stringify(changeFeed.getCursor());
+            }
+            if (eventPage.events.length > 0) {
+                yield eventPage;
+            }
+            else {
+                return;
+            }
+        }
+    }
+    /**
+     * Returns an async iterable iterator to list all the change feed events
+     * in the specified account.
+     *
+     * .byPage() returns an async iterable iterator to list the change feed events in pages.
+     *
+     * Example using `for await` syntax:
+     *
+     * ```ts snippet:ReadmeSampleListChanges
+     * import { StorageSharedKeyCredential } from "@azure/storage-blob";
+     * import { BlobChangeFeedClient } from "@azure/storage-blob-changefeed";
+     *
+     * const account = "<account>";
+     * const accountKey = "<accountkey>";
+     * const sharedKeyCredential = new StorageSharedKeyCredential(account, accountKey);
+     * const changeFeedClient = new BlobChangeFeedClient(
+     *   `https://${account}.blob.core.windows.net`,
+     *   sharedKeyCredential,
+     * );
+     *
+     * // Use for await to iterate through the change feed
+     * for await (const event of changeFeedClient.listChanges()) {
+     *   console.log(`Event: ${event.eventType}`);
+     *   console.log(`Event time: ${event.eventTime}`);
+     *   console.log(`Event data: ${JSON.stringify(event.data)}`);
+     * }
+     *
+     * // Use `byPage` to iterate through the change feed
+     * for await (const page of changeFeedClient.listChanges().byPage()) {
+     *   console.log(`Page: ${JSON.stringify(page)}`);
+     *   for (const event of page.events) {
+     *     console.log(`Event: ${event.eventType}`);
+     *     console.log(`Event time: ${event.eventTime}`);
+     *     console.log(`Event data: ${JSON.stringify(event.data)}`);
+     *   }
+     * }
+     * ```
+     *
+     * Example using paging with a marker:
+     *
+     * ```ts snippet:ReadmeSampleListChanges_Continuation
+     * import { StorageSharedKeyCredential } from "@azure/storage-blob";
+     * import { BlobChangeFeedClient } from "@azure/storage-blob-changefeed";
+     *
+     * const account = "<account>";
+     * const accountKey = "<accountkey>";
+     * const sharedKeyCredential = new StorageSharedKeyCredential(account, accountKey);
+     * const changeFeedClient = new BlobChangeFeedClient(
+     *   `https://${account}.blob.core.windows.net`,
+     *   sharedKeyCredential,
+     * );
+     *
+     * let iterator = changeFeedClient.listChanges().byPage({ maxPageSize: 2 });
+     * let response = (await iterator.next()).value;
+     * // Prints 2 page ranges
+     * if (response.pageRange) {
+     *   for (const pageRange of response.pageRange) {
+     *     console.log(`Event: ${pageRange.eventType}`);
+     *     console.log(`Event time: ${pageRange.eventTime}`);
+     *     console.log(`Event data: ${JSON.stringify(pageRange.data)}`);
+     *   }
+     * }
+     * // Gets next marker
+     * let marker = response.continuationToken;
+     * // Passing next marker as continuationToken
+     * iterator = changeFeedClient.listChanges().byPage({ continuationToken: marker, maxPageSize: 10 });
+     * response = (await iterator.next()).value;
+     * // Prints 10 page ranges
+     * if (response.pageRange) {
+     *   for (const pageRange of response.pageRange) {
+     *     console.log(`Event: ${pageRange.eventType}`);
+     *     console.log(`Event time: ${pageRange.eventTime}`);
+     *     console.log(`Event data: ${JSON.stringify(pageRange.data)}`);
+     *   }
+     * }
+     * ```
+     *
+     * @param options - Options to list change feed events.
+     * @returns An asyncIterableIterator that supports paging.
+     */
+    listChanges(options = {}) {
+        const iter = this.getChange(options);
+        return {
+            /**
+             * The next method, part of the iteration protocol
+             */
+            async next() {
+                return iter.next();
+            },
+            /**
+             * The connection to the async iterator, part of the iteration protocol
+             */
+            [Symbol.asyncIterator]() {
+                return this;
+            },
+            /**
+             * Return an AsyncIterableIterator that works a page at a time
+             */
+            byPage: (settings = {}) => {
+                return this.getPage(settings.continuationToken, settings.maxPageSize, options);
+            },
+        };
+    }
+}
+//# sourceMappingURL=BlobChangeFeedClient.js.map

package/dist/browser/BlobChangeFeedClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlobChangeFeedClient.js","sourceRoot":"","sources":["../../src/BlobChangeFeedClient.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  StoragePipelineOptions,\n  StorageSharedKeyCredential,\n  AnonymousCredential,\n} from \"@azure/storage-blob\";\nimport { BlobServiceClient, Pipeline } from \"@azure/storage-blob\";\nimport type { PagedAsyncIterableIterator, PageSettings } from \"@azure/core-paging\";\nimport type { BlobChangeFeedEvent } from \"./models/BlobChangeFeedEvent.js\";\nimport { ChangeFeedFactory } from \"./ChangeFeedFactory.js\";\nimport type { ChangeFeed } from \"./ChangeFeed.js\";\nimport { CHANGE_FEED_MAX_PAGE_SIZE, SDK_VERSION } from \"./utils/constants.js\";\nimport type { BlobChangeFeedListChangesOptions } from \"./models/models.js\";\nimport type { TokenCredential } from \"@azure/core-auth\";\n\n/**\n * Contains paged response data for the {@link BlobChangeFeedClient.listChanges} operation.\n */\nexport class BlobChangeFeedEventPage {\n  /**\n   * Array of {@link BlobChangeFeedEvent}.\n   */\n  public events: BlobChangeFeedEvent[];\n\n  /**\n   * The token that keeps track of where to continue the iterator.\n   */\n  public continuationToken: string;\n\n  constructor() {\n    this.events = [];\n    this.continuationToken = \"\";\n  }\n}\n\n/**\n * Creates a new Pipeline object with Credential provided.\n *\n * @param credential -  Such as AnonymousCredential, StorageSharedKeyCredential or any credential from the `@azure/identity` package to authenticate requests to the service. You can also provide an object that implements the TokenCredential interface. If not specified, AnonymousCredential is used.\n * @param pipelineOptions - Optional. Options.\n * @returns A new Pipeline object.\n */\nexport function newPipeline(\n  credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential,\n  pipelineOptions: StoragePipelineOptions = {},\n): Pipeline {\n  return newPipeline(credential, appendUserAgentPrefix(pipelineOptions));\n}\n\nfunction appendUserAgentPrefix(options?: StoragePipelineOptions): StoragePipelineOptions {\n  if (!options) {\n    options = {};\n  }\n  if (options.userAgentOptions === undefined) {\n    options.userAgentOptions = {};\n  }\n\n  if (options.userAgentOptions.userAgentPrefix === undefined) {\n    options.userAgentOptions.userAgentPrefix = \"\";\n  } else if (options.userAgentOptions.userAgentPrefix !== \"\") {\n    options.userAgentOptions.userAgentPrefix += \" \";\n  }\n  options.userAgentOptions.userAgentPrefix += `changefeed-js/${SDK_VERSION}`;\n  return options;\n}\n\n/**\n * Blob Change Feed client options.\n */\nexport interface BlobChangeFeedClientOptions {\n  /**\n   * The maximum length of an transfer in bytes.\n   */\n  maximumTransferSize?: number;\n}\n\n/**\n * BlobChangeFeedClient.\n * @see https://learn.microsoft.com/azure/storage/blobs/storage-blob-change-feed?tabs=azure-portal\n */\nexport class BlobChangeFeedClient {\n  /**\n   * blobServiceClient provided by `@azure/storage-blob` package.\n   */\n  private blobServiceClient: BlobServiceClient;\n  private changeFeedFactory: ChangeFeedFactory;\n  private changeFeedClientOptions: BlobChangeFeedClientOptions;\n\n  /**\n   *\n   * Creates an instance of BlobChangeFeedClient from connection string.\n   *\n   * @param connectionString - Account connection string or a SAS connection string of an Azure storage account.\n   *                                  [ Note - Account connection string can only be used in NODE.JS runtime. ]\n   *                                  Account connection string example -\n   *                                  `DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net`\n   *                                  SAS connection string example -\n   *                                  `BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString`\n   * @param options - Optional. Options to configure the HTTP pipeline.\n   */\n  public static fromConnectionString(\n    connectionString: string,\n    // Legacy, no way to fix the eslint error without breaking. Disable the rule for this line.\n    /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */\n    options?: StoragePipelineOptions,\n    // Static method to construct an object, the option is for the object not for the method.\n    /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */\n    changeFeedClientOptions?: BlobChangeFeedClientOptions,\n  ): BlobChangeFeedClient {\n    const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString, options);\n    return new BlobChangeFeedClient(\n      blobServiceClient.url,\n      blobServiceClient.credential,\n      appendUserAgentPrefix(options),\n      changeFeedClientOptions,\n    );\n  }\n\n  /**\n   * Creates an instance of BlobChangeFeedClient.\n   *\n   * @param url - A Client string pointing to Azure Storage blob service, such as\n   *                     \"https://myaccount.blob.core.windows.net\". You can append a SAS\n   *                     if using AnonymousCredential, such as \"https://myaccount.blob.core.windows.net?sasString\".\n   * @param credential -  Such as AnonymousCredential, StorageSharedKeyCredential or any credential from the `@azure/identity` package to authenticate requests to the service. You can also provide an object that implements the TokenCredential interface. If not specified, AnonymousCredential is used.\n   * @param options - Optional. Options to configure the HTTP pipeline.\n   *\n   * Example using DefaultAzureCredential from `@azure/identity`:\n   *\n   * ```ts snippet:ReadmeSampleCreateClient_TokenCredential\n   * import { DefaultAzureCredential } from \"@azure/identity\";\n   * import { BlobChangeFeedClient } from \"@azure/storage-blob-changefeed\";\n   *\n   * // Enter your storage account name and shared key\n   * const account = \"<account>\";\n   * const credential = new DefaultAzureCredential();\n   * const changeFeedClient = new BlobChangeFeedClient(\n   *   // When using AnonymousCredential, following url should include a valid SAS or support public access\n   *   `https://${account}.blob.core.windows.net`,\n   *   credential,\n   * );\n   * ```\n   *\n   * Example using an account name/key:\n   *\n   * ```ts snippet:ReadmeSampleCreateClient\n   * import { StorageSharedKeyCredential } from \"@azure/storage-blob\";\n   * import { BlobChangeFeedClient } from \"@azure/storage-blob-changefeed\";\n   *\n   * // Enter your storage account name and shared key\n   * const account = \"<account>\";\n   * const accountKey = \"<accountkey>\";\n   * // Use StorageSharedKeyCredential with storage account and account key\n   * // StorageSharedKeyCredential is only available in Node.js runtime, not in browsers\n   * const sharedKeyCredential = new StorageSharedKeyCredential(account, accountKey);\n   * const changeFeedClient = new BlobChangeFeedClient(\n   *   // When using AnonymousCredential, following url should include a valid SAS or support public access\n   *   `https://${account}.blob.core.windows.net`,\n   *   sharedKeyCredential,\n   * );\n   * ```\n   */\n  constructor(\n    url: string,\n    credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential,\n    // Legacy, no way to fix the eslint error without breaking. Disable the rule for this line.\n    /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */\n    options?: StoragePipelineOptions,\n    changeFeedClientOptions?: BlobChangeFeedClientOptions,\n  );\n\n  /**\n   * Creates an instance of BlobChangeFeedClient.\n   *\n   * @param url - A Client string pointing to Azure Storage blob service, such as\n   *                     \"https://myaccount.blob.core.windows.net\". You can append a SAS\n   *                     if using AnonymousCredential, such as \"https://myaccount.blob.core.windows.net?sasString\".\n   * @param pipeline - Call newPipeline() to create a default\n   *                            pipeline, or provide a customized pipeline.\n   */\n  constructor(url: string, pipeline: Pipeline);\n  constructor(\n    urlOrClient: string,\n    credentialOrPipeline?:\n      | StorageSharedKeyCredential\n      | AnonymousCredential\n      | TokenCredential\n      | Pipeline,\n    // Legacy, no way to fix the eslint error without breaking. Disable the rule for this line.\n    /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */\n    options?: StoragePipelineOptions,\n    changeFeedClientOptions?: BlobChangeFeedClientOptions,\n  ) {\n    this.changeFeedClientOptions = changeFeedClientOptions || {};\n    this.changeFeedFactory = new ChangeFeedFactory(\n      this.changeFeedClientOptions.maximumTransferSize,\n    );\n\n    if (credentialOrPipeline instanceof Pipeline) {\n      this.blobServiceClient = new BlobServiceClient(urlOrClient, credentialOrPipeline);\n    } else {\n      this.blobServiceClient = new BlobServiceClient(\n        urlOrClient,\n        credentialOrPipeline,\n        appendUserAgentPrefix(options),\n      );\n    }\n  }\n\n  private async *getChange(\n    options: BlobChangeFeedListChangesOptions = {},\n  ): AsyncIterableIterator<BlobChangeFeedEvent> {\n    const changeFeed: ChangeFeed = await this.changeFeedFactory.create(\n      this.blobServiceClient,\n      undefined,\n      options,\n    );\n\n    while (changeFeed.hasNext()) {\n      const event = await changeFeed.getChange({\n        abortSignal: options.abortSignal,\n        tracingOptions: options.tracingOptions,\n      });\n      if (event) {\n        yield event;\n      } else {\n        return;\n      }\n    }\n  }\n\n  // start in ChangeFeedListChangesOptions will be ignored when continuationToken is specified.\n  private async *getPage(\n    continuationToken?: string,\n    maxPageSize?: number,\n    options: BlobChangeFeedListChangesOptions = {},\n  ): AsyncIterableIterator<BlobChangeFeedEventPage> {\n    const changeFeed: ChangeFeed = await this.changeFeedFactory.create(\n      this.blobServiceClient,\n      continuationToken,\n      options,\n    );\n\n    if (!maxPageSize || maxPageSize > CHANGE_FEED_MAX_PAGE_SIZE) {\n      maxPageSize = CHANGE_FEED_MAX_PAGE_SIZE;\n    }\n    while (changeFeed.hasNext()) {\n      const eventPage = new BlobChangeFeedEventPage();\n      while (changeFeed.hasNext() && eventPage.events.length < maxPageSize) {\n        const event = await changeFeed.getChange({\n          abortSignal: options.abortSignal,\n          tracingOptions: options.tracingOptions,\n        });\n        if (event) {\n          eventPage.events.push(event);\n        }\n      }\n      if (changeFeed.hasNext()) {\n        eventPage.continuationToken = JSON.stringify(changeFeed.getCursor());\n      }\n      if (eventPage.events.length > 0) {\n        yield eventPage;\n      } else {\n        return;\n      }\n    }\n  }\n\n  /**\n   * Returns an async iterable iterator to list all the change feed events\n   * in the specified account.\n   *\n   * .byPage() returns an async iterable iterator to list the change feed events in pages.\n   *\n   * Example using `for await` syntax:\n   *\n   * ```ts snippet:ReadmeSampleListChanges\n   * import { StorageSharedKeyCredential } from \"@azure/storage-blob\";\n   * import { BlobChangeFeedClient } from \"@azure/storage-blob-changefeed\";\n   *\n   * const account = \"<account>\";\n   * const accountKey = \"<accountkey>\";\n   * const sharedKeyCredential = new StorageSharedKeyCredential(account, accountKey);\n   * const changeFeedClient = new BlobChangeFeedClient(\n   *   `https://${account}.blob.core.windows.net`,\n   *   sharedKeyCredential,\n   * );\n   *\n   * // Use for await to iterate through the change feed\n   * for await (const event of changeFeedClient.listChanges()) {\n   *   console.log(`Event: ${event.eventType}`);\n   *   console.log(`Event time: ${event.eventTime}`);\n   *   console.log(`Event data: ${JSON.stringify(event.data)}`);\n   * }\n   *\n   * // Use `byPage` to iterate through the change feed\n   * for await (const page of changeFeedClient.listChanges().byPage()) {\n   *   console.log(`Page: ${JSON.stringify(page)}`);\n   *   for (const event of page.events) {\n   *     console.log(`Event: ${event.eventType}`);\n   *     console.log(`Event time: ${event.eventTime}`);\n   *     console.log(`Event data: ${JSON.stringify(event.data)}`);\n   *   }\n   * }\n   * ```\n   *\n   * Example using paging with a marker:\n   *\n   * ```ts snippet:ReadmeSampleListChanges_Continuation\n   * import { StorageSharedKeyCredential } from \"@azure/storage-blob\";\n   * import { BlobChangeFeedClient } from \"@azure/storage-blob-changefeed\";\n   *\n   * const account = \"<account>\";\n   * const accountKey = \"<accountkey>\";\n   * const sharedKeyCredential = new StorageSharedKeyCredential(account, accountKey);\n   * const changeFeedClient = new BlobChangeFeedClient(\n   *   `https://${account}.blob.core.windows.net`,\n   *   sharedKeyCredential,\n   * );\n   *\n   * let iterator = changeFeedClient.listChanges().byPage({ maxPageSize: 2 });\n   * let response = (await iterator.next()).value;\n   * // Prints 2 page ranges\n   * if (response.pageRange) {\n   *   for (const pageRange of response.pageRange) {\n   *     console.log(`Event: ${pageRange.eventType}`);\n   *     console.log(`Event time: ${pageRange.eventTime}`);\n   *     console.log(`Event data: ${JSON.stringify(pageRange.data)}`);\n   *   }\n   * }\n   * // Gets next marker\n   * let marker = response.continuationToken;\n   * // Passing next marker as continuationToken\n   * iterator = changeFeedClient.listChanges().byPage({ continuationToken: marker, maxPageSize: 10 });\n   * response = (await iterator.next()).value;\n   * // Prints 10 page ranges\n   * if (response.pageRange) {\n   *   for (const pageRange of response.pageRange) {\n   *     console.log(`Event: ${pageRange.eventType}`);\n   *     console.log(`Event time: ${pageRange.eventTime}`);\n   *     console.log(`Event data: ${JSON.stringify(pageRange.data)}`);\n   *   }\n   * }\n   * ```\n   *\n   * @param options - Options to list change feed events.\n   * @returns An asyncIterableIterator that supports paging.\n   */\n  public listChanges(\n    options: BlobChangeFeedListChangesOptions = {},\n  ): PagedAsyncIterableIterator<BlobChangeFeedEvent, BlobChangeFeedEventPage> {\n    const iter = this.getChange(options);\n    return {\n      /**\n       * The next method, part of the iteration protocol\n       */\n      async next() {\n        return iter.next();\n      },\n      /**\n       * The connection to the async iterator, part of the iteration protocol\n       */\n      [Symbol.asyncIterator]() {\n        return this;\n      },\n      /**\n       * Return an AsyncIterableIterator that works a page at a time\n       */\n      byPage: (settings: PageSettings = {}) => {\n        return this.getPage(settings.continuationToken, settings.maxPageSize, options);\n      },\n    };\n  }\n}\n"]}

package/{types/3.1/storage-blob-changefeed/src → dist/browser}/ChangeFeed.d.ts

@@ -1,37 +1,37 @@
-import { ContainerClient, CommonOptions } from "@azure/storage-blob";
-import { Segment } from "./Segment";
-import { SegmentFactory } from "./SegmentFactory";
-import { BlobChangeFeedEvent } from "./models/BlobChangeFeedEvent";
-import { ChangeFeedCursor } from "./models/ChangeFeedCursor";
-import { AbortSignalLike } from "@azure/core-http";
-/**
- * Options to configure {@link ChangeFeed.getChange} operation.
- */
-export interface ChangeFeedGetChangeOptions extends CommonOptions {
-    /**
-     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
-     * For example, use the @azure/abort-controller to create an `AbortSignal`.
-     */
-    abortSignal?: AbortSignalLike;
-}
-export declare class ChangeFeed {
-    /**
-     * BlobContainerClient for making List Blob requests and creating Segments.
-     */
-    private readonly containerClient?;
-    private readonly segmentFactory?;
-    private readonly years;
-    private segments;
-    private currentSegment?;
-    private lastConsumable?;
-    private startTime?;
-    private endTime?;
-    private end?;
-    constructor();
-    constructor(containerClient: ContainerClient, segmentFactory: SegmentFactory, years: number[], segments: string[], currentSegment: Segment, lastConsumable: Date, startTime?: Date, endTime?: Date);
-    private advanceSegmentIfNecessary;
-    hasNext(): boolean;
-    getChange(options?: ChangeFeedGetChangeOptions): Promise<BlobChangeFeedEvent | undefined>;
-    getCursor(): ChangeFeedCursor;
-}
-//# sourceMappingURL=ChangeFeed.d.ts.map
+import type { ContainerClient, CommonOptions } from "@azure/storage-blob";
+import type { Segment } from "./Segment.js";
+import type { SegmentFactory } from "./SegmentFactory.js";
+import type { BlobChangeFeedEvent } from "./models/BlobChangeFeedEvent.js";
+import type { ChangeFeedCursor } from "./models/ChangeFeedCursor.js";
+import type { AbortSignalLike } from "@azure/abort-controller";
+/**
+ * Options to configure {@link ChangeFeed.getChange} operation.
+ */
+export interface ChangeFeedGetChangeOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+}
+export declare class ChangeFeed {
+    /**
+     * BlobContainerClient for making List Blob requests and creating Segments.
+     */
+    private readonly containerClient?;
+    private readonly segmentFactory?;
+    private readonly years;
+    private segments;
+    private currentSegment?;
+    private lastConsumable?;
+    private startTime?;
+    private endTime?;
+    private end?;
+    constructor();
+    constructor(containerClient: ContainerClient, segmentFactory: SegmentFactory, years: number[], segments: string[], currentSegment: Segment, lastConsumable: Date, startTime?: Date, endTime?: Date);
+    private advanceSegmentIfNecessary;
+    hasNext(): boolean;
+    getChange(options?: ChangeFeedGetChangeOptions): Promise<BlobChangeFeedEvent | undefined>;
+    getCursor(): ChangeFeedCursor;
+}
+//# sourceMappingURL=ChangeFeed.d.ts.map

package/dist/browser/ChangeFeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeFeed.d.ts","sourceRoot":"","sources":["../../src/ChangeFeed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,aAAa;IAC/D;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,qBAAa,UAAU;IACrB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAkB;IAEnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAiB;IAEjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IAEjC,OAAO,CAAC,QAAQ,CAAW;IAE3B,OAAO,CAAC,cAAc,CAAC,CAAU;IAEjC,OAAO,CAAC,cAAc,CAAC,CAAO;IAE9B,OAAO,CAAC,SAAS,CAAC,CAAO;IAEzB,OAAO,CAAC,OAAO,CAAC,CAAO;IAEvB,OAAO,CAAC,GAAG,CAAC,CAAO;;gBAIjB,eAAe,EAAE,eAAe,EAChC,cAAc,EAAE,cAAc,EAC9B,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,cAAc,EAAE,OAAO,EACvB,cAAc,EAAE,IAAI,EACpB,SAAS,CAAC,EAAE,IAAI,EAChB,OAAO,CAAC,EAAE,IAAI;YA0BF,yBAAyB;IA0DhC,OAAO,IAAI,OAAO;IAaZ,SAAS,CACpB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAiBpC,SAAS,IAAI,gBAAgB;CAYrC"}

package/{dist-esm/storage-blob-changefeed/src → dist/browser}/ChangeFeed.js

@@ -1,9 +1,20 @@
 // Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-import { getSegmentsInYear, minDate, getHost } from "./utils/utils.common";
-import { createSpan } from "./utils/tracing";
-import { SpanStatusCode } from "@azure/core-tracing";
+// Licensed under the MIT License.
+import { getSegmentsInYear, minDate, getHost } from "./utils/utils.common.js";
+import { tracingClient } from "./utils/tracing.js";
 export class ChangeFeed {
+    /**
+     * BlobContainerClient for making List Blob requests and creating Segments.
+     */
+    containerClient;
+    segmentFactory;
+    years;
+    segments;
+    currentSegment;
+    lastConsumable;
+    startTime;
+    endTime;
+    end;
     constructor(containerClient, segmentFactory, years, segments, currentSegment, lastConsumable, startTime, endTime) {
         this.containerClient = containerClient;
         this.segmentFactory = segmentFactory;
@@ -18,8 +29,7 @@ export class ChangeFeed {
         }
     }
     async advanceSegmentIfNecessary(options = {}) {
-        const { span, updatedOptions } = createSpan("ChangeFeed-advanceSegmentIfNecessary", options);
-        try {
+        return tracingClient.withSpan("ChangeFeed-advanceSegmentIfNecessary", options, async (updatedOptions) => {
             if (!this.currentSegment) {
                 throw new Error("Empty Change Feed shouldn't call this function.");
             }
@@ -51,17 +61,7 @@ export class ChangeFeed {
                     this.currentSegment = undefined;
                 }
             }
-        }
-        catch (e) {
-            span.setStatus({
-                code: SpanStatusCode.ERROR,
-                message: e.message,
-            });
-            throw e;
-        }
-        finally {
-            span.end();
-        }
+        });
     }
     hasNext() {
         // Empty ChangeFeed, using currentSegment as the indicator.
@@ -74,8 +74,7 @@ export class ChangeFeed {
         return this.currentSegment.dateTime < this.end;
     }
     async getChange(options = {}) {
-        const { span, updatedOptions } = createSpan("ChangeFeed-getChange", options);
-        try {
+        return tracingClient.withSpan("ChangeFeed-getChange", options, async (updatedOptions) => {
             let event = undefined;
             while (event === undefined && this.hasNext()) {
                 event = await this.currentSegment.getChange({
@@ -88,27 +87,16 @@ export class ChangeFeed {
                 });
             }
             return event;
-        }
-        catch (e) {
-            span.setStatus({
-                code: SpanStatusCode.ERROR,
-                message: e.message,
-            });
-            throw e;
-        }
-        finally {
-            span.end();
-        }
+        });
     }
     getCursor() {
-        var _a;
         if (!this.currentSegment) {
             throw new Error("Empty Change Feed shouldn't call this function.");
         }
         return {
             CursorVersion: 1,
             UrlHost: getHost(this.containerClient.url),
-            EndTime: (_a = this.endTime) === null || _a === void 0 ? void 0 : _a.toJSON(),
+            EndTime: this.endTime?.toJSON(),
             CurrentSegmentCursor: this.currentSegment.getCursor(),
         };
     }

package/dist/browser/ChangeFeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeFeed.js","sourceRoot":"","sources":["../../src/ChangeFeed.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { ContainerClient, CommonOptions } from \"@azure/storage-blob\";\nimport type { Segment } from \"./Segment.js\";\nimport type { SegmentFactory } from \"./SegmentFactory.js\";\nimport type { BlobChangeFeedEvent } from \"./models/BlobChangeFeedEvent.js\";\nimport type { ChangeFeedCursor } from \"./models/ChangeFeedCursor.js\";\nimport { getSegmentsInYear, minDate, getHost } from \"./utils/utils.common.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { tracingClient } from \"./utils/tracing.js\";\n\n/**\n * Options to configure {@link ChangeFeed.getChange} operation.\n */\nexport interface ChangeFeedGetChangeOptions extends CommonOptions {\n  /**\n   * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.\n   * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\nexport class ChangeFeed {\n  /**\n   * BlobContainerClient for making List Blob requests and creating Segments.\n   */\n  private readonly containerClient?: ContainerClient;\n\n  private readonly segmentFactory?: SegmentFactory;\n\n  private readonly years: number[];\n\n  private segments: string[];\n\n  private currentSegment?: Segment;\n\n  private lastConsumable?: Date;\n\n  private startTime?: Date;\n\n  private endTime?: Date;\n\n  private end?: Date;\n\n  constructor();\n  constructor(\n    containerClient: ContainerClient,\n    segmentFactory: SegmentFactory,\n    years: number[],\n    segments: string[],\n    currentSegment: Segment,\n    lastConsumable: Date,\n    startTime?: Date,\n    endTime?: Date,\n  );\n\n  constructor(\n    containerClient?: ContainerClient,\n    segmentFactory?: SegmentFactory,\n    years?: number[],\n    segments?: string[],\n    currentSegment?: Segment,\n    lastConsumable?: Date,\n    startTime?: Date,\n    endTime?: Date,\n  ) {\n    this.containerClient = containerClient;\n    this.segmentFactory = segmentFactory;\n    this.years = years || [];\n    this.segments = segments || [];\n    this.currentSegment = currentSegment;\n    this.lastConsumable = lastConsumable;\n    this.startTime = startTime;\n    this.endTime = endTime;\n    if (this.lastConsumable) {\n      this.end = minDate(this.lastConsumable, this.endTime);\n    }\n  }\n\n  private async advanceSegmentIfNecessary(options: ChangeFeedGetChangeOptions = {}): Promise<void> {\n    return tracingClient.withSpan(\n      \"ChangeFeed-advanceSegmentIfNecessary\",\n      options,\n      async (updatedOptions) => {\n        if (!this.currentSegment) {\n          throw new Error(\"Empty Change Feed shouldn't call this function.\");\n        }\n\n        // If the current segment has more Events, we don't need to do anything.\n        if (this.currentSegment.hasNext()) {\n          return;\n        }\n\n        // If the current segment is completed, remove it\n        if (this.segments.length > 0) {\n          this.currentSegment = await this.segmentFactory!.create(\n            this.containerClient!,\n            this.segments.shift()!,\n            undefined,\n            {\n              abortSignal: options.abortSignal,\n              tracingOptions: updatedOptions.tracingOptions,\n            },\n          );\n        }\n        // If segments is empty, refill it\n        else if (this.segments.length === 0 && this.years.length > 0) {\n          const year = this.years.shift();\n          this.segments = await getSegmentsInYear(\n            this.containerClient!,\n            year!,\n            this.startTime,\n            this.end,\n            {\n              abortSignal: options.abortSignal,\n              tracingOptions: updatedOptions.tracingOptions,\n            },\n          );\n\n          if (this.segments.length > 0) {\n            this.currentSegment = await this.segmentFactory!.create(\n              this.containerClient!,\n              this.segments.shift()!,\n              undefined,\n              {\n                abortSignal: options.abortSignal,\n                tracingOptions: updatedOptions.tracingOptions,\n              },\n            );\n          } else {\n            this.currentSegment = undefined;\n          }\n        }\n      },\n    );\n  }\n\n  public hasNext(): boolean {\n    // Empty ChangeFeed, using currentSegment as the indicator.\n    if (!this.currentSegment) {\n      return false;\n    }\n\n    if (this.segments.length === 0 && this.years.length === 0 && !this.currentSegment.hasNext()) {\n      return false;\n    }\n\n    return this.currentSegment.dateTime < this.end!;\n  }\n\n  public async getChange(\n    options: ChangeFeedGetChangeOptions = {},\n  ): Promise<BlobChangeFeedEvent | undefined> {\n    return tracingClient.withSpan(\"ChangeFeed-getChange\", options, async (updatedOptions) => {\n      let event: BlobChangeFeedEvent | undefined = undefined;\n      while (event === undefined && this.hasNext()) {\n        event = await this.currentSegment!.getChange({\n          abortSignal: options.abortSignal,\n          tracingOptions: updatedOptions.tracingOptions,\n        });\n        await this.advanceSegmentIfNecessary({\n          abortSignal: options.abortSignal,\n          tracingOptions: updatedOptions.tracingOptions,\n        });\n      }\n      return event;\n    });\n  }\n\n  public getCursor(): ChangeFeedCursor {\n    if (!this.currentSegment) {\n      throw new Error(\"Empty Change Feed shouldn't call this function.\");\n    }\n\n    return {\n      CursorVersion: 1,\n      UrlHost: getHost(this.containerClient!.url)!,\n      EndTime: this.endTime?.toJSON(),\n      CurrentSegmentCursor: this.currentSegment!.getCursor(),\n    };\n  }\n}\n"]}

package/dist/browser/ChangeFeedFactory.d.ts

@@ -0,0 +1,13 @@
+import type { BlobServiceClient } from "@azure/storage-blob";
+import { ChangeFeed } from "./ChangeFeed.js";
+import { SegmentFactory } from "./SegmentFactory.js";
+import type { BlobChangeFeedListChangesOptions } from "./models/models.js";
+export declare class ChangeFeedFactory {
+    private readonly segmentFactory;
+    private readonly maxTransferSize?;
+    constructor(maxTransferSize?: number);
+    constructor(segmentFactory: SegmentFactory);
+    private static validateCursor;
+    create(blobServiceClient: BlobServiceClient, continuationToken?: string, options?: BlobChangeFeedListChangesOptions): Promise<ChangeFeed>;
+}
+//# sourceMappingURL=ChangeFeedFactory.d.ts.map

package/dist/browser/ChangeFeedFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeFeedFactory.d.ts","sourceRoot":"","sources":["../../src/ChangeFeedFactory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAa7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC;AAe3E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;gBAE9B,eAAe,CAAC,EAAE,MAAM;gBACxB,cAAc,EAAE,cAAc;IA0B1C,OAAO,CAAC,MAAM,CAAC,cAAc;IAShB,MAAM,CACjB,iBAAiB,EAAE,iBAAiB,EACpC,iBAAiB,CAAC,EAAE,MAAM,EAC1B,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,UAAU,CAAC;CA0GvB"}

package/{dist-esm/storage-blob-changefeed/src → dist/browser}/ChangeFeedFactory.js

@@ -1,23 +1,36 @@
 // Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-import { ChangeFeed } from "./ChangeFeed";
-import { CHANGE_FEED_CONTAINER_NAME, CHANGE_FEED_META_SEGMENT_PATH } from "./utils/constants";
-import { ceilToNearestHour, floorToNearestHour, getYearsPaths, getSegmentsInYear, minDate, getHost, parseDateFromSegmentPath, } from "./utils/utils.common";
-import { bodyToString } from "./utils/utils.node";
-import { SegmentFactory } from "./SegmentFactory";
-import { ShardFactory } from "./ShardFactory";
-import { ChunkFactory } from "./ChunkFactory";
-import { AvroReaderFactory } from "./AvroReaderFactory";
-import { createSpan } from "./utils/tracing";
-import { SpanStatusCode } from "@azure/core-tracing";
-import { LazyLoadingBlobStreamFactory } from "./LazyLoadingBlobStreamFactory";
+// Licensed under the MIT License.
+import { ChangeFeed } from "./ChangeFeed.js";
+import { CHANGE_FEED_CONTAINER_NAME, CHANGE_FEED_META_SEGMENT_PATH } from "./utils/constants.js";
+import { ceilToNearestHour, floorToNearestHour, getYearsPaths, getSegmentsInYear, minDate, getHost, parseDateFromSegmentPath, } from "./utils/utils.common.js";
+import { bodyToString } from "./utils/utils.node.js";
+import { SegmentFactory } from "./SegmentFactory.js";
+import { ShardFactory } from "./ShardFactory.js";
+import { ChunkFactory } from "./ChunkFactory.js";
+import { AvroReaderFactory } from "./AvroReaderFactory.js";
+import { tracingClient } from "./utils/tracing.js";
+import { LazyLoadingBlobStreamFactory } from "./LazyLoadingBlobStreamFactory.js";
+function isSegmentFactory(segmentFactoryOrMaxTransferSize) {
+    return segmentFactoryOrMaxTransferSize.create !== undefined;
+}
 export class ChangeFeedFactory {
-    constructor(segmentFactory) {
+    segmentFactory;
+    maxTransferSize;
+    constructor(segmentFactoryOrMaxTransferSize) {
+        let segmentFactory;
+        if (segmentFactoryOrMaxTransferSize) {
+            if (Number.isFinite(segmentFactoryOrMaxTransferSize)) {
+                this.maxTransferSize = segmentFactoryOrMaxTransferSize;
+            }
+            else if (isSegmentFactory(segmentFactoryOrMaxTransferSize)) {
+                segmentFactory = segmentFactoryOrMaxTransferSize;
+            }
+        }
         if (segmentFactory) {
             this.segmentFactory = segmentFactory;
         }
         else {
-            this.segmentFactory = new SegmentFactory(new ShardFactory(new ChunkFactory(new AvroReaderFactory(), new LazyLoadingBlobStreamFactory())));
+            this.segmentFactory = new SegmentFactory(new ShardFactory(new ChunkFactory(new AvroReaderFactory(), new LazyLoadingBlobStreamFactory(), this.maxTransferSize)));
         }
     }
     static validateCursor(containerClient, cursor) {
@@ -29,8 +42,7 @@ export class ChangeFeedFactory {
         }
     }
     async create(blobServiceClient, continuationToken, options = {}) {
-        const { span, updatedOptions } = createSpan("ChangeFeedFactory-create", options);
-        try {
+        return tracingClient.withSpan("ChangeFeedFactory-create", options, async (updatedOptions) => {
             const containerClient = blobServiceClient.getContainerClient(CHANGE_FEED_CONTAINER_NAME);
             let cursor = undefined;
             // Create cursor.
@@ -58,10 +70,21 @@ export class ChangeFeedFactory {
             }
             // Get last consumable.
             const blobClient = containerClient.getBlobClient(CHANGE_FEED_META_SEGMENT_PATH);
-            const blobDownloadRes = await blobClient.download(undefined, undefined, {
-                abortSignal: options.abortSignal,
-                tracingOptions: updatedOptions.tracingOptions,
-            });
+            let blobDownloadRes;
+            try {
+                blobDownloadRes = await blobClient.download(undefined, undefined, {
+                    abortSignal: options.abortSignal,
+                    tracingOptions: updatedOptions.tracingOptions,
+                });
+            }
+            catch (err) {
+                if (err.statusCode === 404) {
+                    return new ChangeFeed();
+                }
+                else {
+                    throw err;
+                }
+            }
             const lastConsumable = new Date(JSON.parse(await bodyToString(blobDownloadRes)).lastConsumable);
             // Get year paths
             const years = await getYearsPaths(containerClient, {
@@ -88,22 +111,12 @@ export class ChangeFeedFactory {
             if (segments.length === 0) {
                 return new ChangeFeed();
             }
-            const currentSegment = await this.segmentFactory.create(containerClient, segments.shift(), cursor === null || cursor === void 0 ? void 0 : cursor.CurrentSegmentCursor, {
+            const currentSegment = await this.segmentFactory.create(containerClient, segments.shift(), cursor?.CurrentSegmentCursor, {
                 abortSignal: options.abortSignal,
                 tracingOptions: updatedOptions.tracingOptions,
             });
             return new ChangeFeed(containerClient, this.segmentFactory, years, segments, currentSegment, lastConsumable, options.start, options.end);
-        }
-        catch (e) {
-            span.setStatus({
-                code: SpanStatusCode.ERROR,
-                message: e.message,
-            });
-            throw e;
-        }
-        finally {
-            span.end();
-        }
+        });
     }
 }
 //# sourceMappingURL=ChangeFeedFactory.js.map

package/dist/browser/ChangeFeedFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeFeedFactory.js","sourceRoot":"","sources":["../../src/ChangeFeedFactory.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAGlC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,OAAO,EACP,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAOjF,SAAS,gBAAgB,CACvB,+BAAwD;IAExD,OAAQ,+BAAkD,CAAC,MAAM,KAAK,SAAS,CAAC;AAClF,CAAC;AAED,MAAM,OAAO,iBAAiB;IACX,cAAc,CAAiB;IAC/B,eAAe,CAAU;IAI1C,YAAY,+BAAyD;QACnE,IAAI,cAA0C,CAAC;QAC/C,IAAI,+BAA+B,EAAE,CAAC;YACpC,IAAI,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC,eAAe,GAAG,+BAAyC,CAAC;YACnE,CAAC;iBAAM,IAAI,gBAAgB,CAAC,+BAA+B,CAAC,EAAE,CAAC;gBAC7D,cAAc,GAAG,+BAAiD,CAAC;YACrE,CAAC;QACH,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CACtC,IAAI,YAAY,CACd,IAAI,YAAY,CACd,IAAI,iBAAiB,EAAE,EACvB,IAAI,4BAA4B,EAAE,EAClC,IAAI,CAAC,eAAe,CACrB,CACF,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,eAAgC,EAAE,MAAwB;QACtF,IAAI,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,MAAM,CACjB,iBAAoC,EACpC,iBAA0B,EAC1B,UAA4C,EAAE;QAE9C,OAAO,aAAa,CAAC,QAAQ,CAAC,0BAA0B,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;YAC1F,MAAM,eAAe,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,0BAA0B,CAAC,CAAC;YACzF,IAAI,MAAM,GAAiC,SAAS,CAAC;YACrD,iBAAiB;YACjB,IAAI,iBAAiB,EAAE,CAAC;gBACtB,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBACvC,iBAAiB,CAAC,cAAc,CAAC,eAAe,EAAE,MAAO,CAAC,CAAC;gBAC3D,OAAO,CAAC,KAAK,GAAG,wBAAwB,CAAC,MAAO,CAAC,oBAAoB,CAAC,WAAY,CAAC,CAAC;gBACpF,OAAO,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,MAAO,CAAC,OAAQ,CAAC,CAAC;YAC3C,CAAC;YACD,2DAA2D;iBACtD,CAAC;gBACJ,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAClD,OAAO,CAAC,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/C,CAAC;YAED,0DAA0D;YAC1D,MAAM,yBAAyB,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC;gBAC7D,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,cAAc,EAAE,cAAc,CAAC,cAAc;aAC9C,CAAC,CAAC;YACH,IAAI,CAAC,yBAAyB,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;YACJ,CAAC;YAED,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBACjE,OAAO,IAAI,UAAU,EAAE,CAAC;YAC1B,CAAC;YAED,uBAAuB;YACvB,MAAM,UAAU,GAAG,eAAe,CAAC,aAAa,CAAC,6BAA6B,CAAC,CAAC;YAChF,IAAI,eAAe,CAAC;YACpB,IAAI,CAAC;gBACH,eAAe,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE;oBAChE,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,cAAc,EAAE,cAAc,CAAC,cAAc;iBAC9C,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;oBAC3B,OAAO,IAAI,UAAU,EAAE,CAAC;gBAC1B,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;YACD,MAAM,cAAc,GAAG,IAAI,IAAI,CAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,YAAY,CAAC,eAAe,CAAC,CAAkB,CAAC,cAAc,CACjF,CAAC;YAEF,iBAAiB;YACjB,MAAM,KAAK,GAAa,MAAM,aAAa,CAAC,eAAe,EAAE;gBAC3D,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,cAAc,EAAE,cAAc,CAAC,cAAc;aAC9C,CAAC,CAAC;YAEH,kDAAkD;YAClD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;gBACjD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC;oBAChD,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,IAAI,UAAU,EAAE,CAAC;YAC1B,CAAC;YAED,IAAI,QAAQ,GAAa,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnD,QAAQ,GAAG,MAAM,iBAAiB,CAChC,eAAe,EACf,KAAK,CAAC,KAAK,EAAG,EACd,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,EACpC;oBACE,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,cAAc,EAAE,cAAc,CAAC,cAAc;iBAC9C,CACF,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,UAAU,EAAE,CAAC;YAC1B,CAAC;YACD,MAAM,cAAc,GAAY,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAC9D,eAAe,EACf,QAAQ,CAAC,KAAK,EAAG,EACjB,MAAM,EAAE,oBAAoB,EAC5B;gBACE,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,cAAc,EAAE,cAAc,CAAC,cAAc;aAC9C,CACF,CAAC;YAEF,OAAO,IAAI,UAAU,CACnB,eAAe,EACf,IAAI,CAAC,cAAc,EACnB,KAAK,EACL,QAAQ,EACR,cAAc,EACd,cAAc,EACd,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,GAAG,CACZ,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { BlobServiceClient, ContainerClient } from \"@azure/storage-blob\";\nimport { ChangeFeed } from \"./ChangeFeed.js\";\nimport type { ChangeFeedCursor } from \"./models/ChangeFeedCursor.js\";\nimport { CHANGE_FEED_CONTAINER_NAME, CHANGE_FEED_META_SEGMENT_PATH } from \"./utils/constants.js\";\nimport {\n  ceilToNearestHour,\n  floorToNearestHour,\n  getYearsPaths,\n  getSegmentsInYear,\n  minDate,\n  getHost,\n  parseDateFromSegmentPath,\n} from \"./utils/utils.common.js\";\nimport { bodyToString } from \"./utils/utils.node.js\";\nimport { SegmentFactory } from \"./SegmentFactory.js\";\nimport { ShardFactory } from \"./ShardFactory.js\";\nimport { ChunkFactory } from \"./ChunkFactory.js\";\nimport { AvroReaderFactory } from \"./AvroReaderFactory.js\";\nimport type { Segment } from \"./Segment.js\";\nimport type { BlobChangeFeedListChangesOptions } from \"./models/models.js\";\nimport { tracingClient } from \"./utils/tracing.js\";\nimport { LazyLoadingBlobStreamFactory } from \"./LazyLoadingBlobStreamFactory.js\";\n\ninterface MetaSegments {\n  version?: number;\n  lastConsumable: string;\n}\n\nfunction isSegmentFactory(\n  segmentFactoryOrMaxTransferSize: SegmentFactory | number,\n): segmentFactoryOrMaxTransferSize is SegmentFactory {\n  return (segmentFactoryOrMaxTransferSize as SegmentFactory).create !== undefined;\n}\n\nexport class ChangeFeedFactory {\n  private readonly segmentFactory: SegmentFactory;\n  private readonly maxTransferSize?: number;\n\n  constructor(maxTransferSize?: number);\n  constructor(segmentFactory: SegmentFactory);\n  constructor(segmentFactoryOrMaxTransferSize?: SegmentFactory | number) {\n    let segmentFactory: SegmentFactory | undefined;\n    if (segmentFactoryOrMaxTransferSize) {\n      if (Number.isFinite(segmentFactoryOrMaxTransferSize)) {\n        this.maxTransferSize = segmentFactoryOrMaxTransferSize as number;\n      } else if (isSegmentFactory(segmentFactoryOrMaxTransferSize)) {\n        segmentFactory = segmentFactoryOrMaxTransferSize as SegmentFactory;\n      }\n    }\n\n    if (segmentFactory) {\n      this.segmentFactory = segmentFactory;\n    } else {\n      this.segmentFactory = new SegmentFactory(\n        new ShardFactory(\n          new ChunkFactory(\n            new AvroReaderFactory(),\n            new LazyLoadingBlobStreamFactory(),\n            this.maxTransferSize,\n          ),\n        ),\n      );\n    }\n  }\n\n  private static validateCursor(containerClient: ContainerClient, cursor: ChangeFeedCursor): void {\n    if (getHost(containerClient.url) !== cursor.UrlHost) {\n      throw new Error(\"Cursor URL host does not match container URL host.\");\n    }\n    if (cursor.CursorVersion !== 1) {\n      throw new Error(\"Unsupported cursor version.\");\n    }\n  }\n\n  public async create(\n    blobServiceClient: BlobServiceClient,\n    continuationToken?: string,\n    options: BlobChangeFeedListChangesOptions = {},\n  ): Promise<ChangeFeed> {\n    return tracingClient.withSpan(\"ChangeFeedFactory-create\", options, async (updatedOptions) => {\n      const containerClient = blobServiceClient.getContainerClient(CHANGE_FEED_CONTAINER_NAME);\n      let cursor: ChangeFeedCursor | undefined = undefined;\n      // Create cursor.\n      if (continuationToken) {\n        cursor = JSON.parse(continuationToken);\n        ChangeFeedFactory.validateCursor(containerClient, cursor!);\n        options.start = parseDateFromSegmentPath(cursor!.CurrentSegmentCursor.SegmentPath!);\n        options.end = new Date(cursor!.EndTime!);\n      }\n      // Round start and end time if we are not using the cursor.\n      else {\n        options.start = floorToNearestHour(options.start);\n        options.end = ceilToNearestHour(options.end);\n      }\n\n      // Check if Change Feed has been enabled for this account.\n      const changeFeedContainerExists = await containerClient.exists({\n        abortSignal: options.abortSignal,\n        tracingOptions: updatedOptions.tracingOptions,\n      });\n      if (!changeFeedContainerExists) {\n        throw new Error(\n          \"Change Feed hasn't been enabled on this account, or is currently being enabled.\",\n        );\n      }\n\n      if (options.start && options.end && options.start >= options.end) {\n        return new ChangeFeed();\n      }\n\n      // Get last consumable.\n      const blobClient = containerClient.getBlobClient(CHANGE_FEED_META_SEGMENT_PATH);\n      let blobDownloadRes;\n      try {\n        blobDownloadRes = await blobClient.download(undefined, undefined, {\n          abortSignal: options.abortSignal,\n          tracingOptions: updatedOptions.tracingOptions,\n        });\n      } catch (err: any) {\n        if (err.statusCode === 404) {\n          return new ChangeFeed();\n        } else {\n          throw err;\n        }\n      }\n      const lastConsumable = new Date(\n        (JSON.parse(await bodyToString(blobDownloadRes)) as MetaSegments).lastConsumable,\n      );\n\n      // Get year paths\n      const years: number[] = await getYearsPaths(containerClient, {\n        abortSignal: options.abortSignal,\n        tracingOptions: updatedOptions.tracingOptions,\n      });\n\n      // Dequeue any years that occur before start time.\n      if (options.start) {\n        const startYear = options.start.getUTCFullYear();\n        while (years.length > 0 && years[0] < startYear) {\n          years.shift();\n        }\n      }\n      if (years.length === 0) {\n        return new ChangeFeed();\n      }\n\n      let segments: string[] = [];\n      while (segments.length === 0 && years.length !== 0) {\n        segments = await getSegmentsInYear(\n          containerClient,\n          years.shift()!,\n          options.start,\n          minDate(lastConsumable, options.end),\n          {\n            abortSignal: options.abortSignal,\n            tracingOptions: updatedOptions.tracingOptions,\n          },\n        );\n      }\n      if (segments.length === 0) {\n        return new ChangeFeed();\n      }\n      const currentSegment: Segment = await this.segmentFactory.create(\n        containerClient,\n        segments.shift()!,\n        cursor?.CurrentSegmentCursor,\n        {\n          abortSignal: options.abortSignal,\n          tracingOptions: updatedOptions.tracingOptions,\n        },\n      );\n\n      return new ChangeFeed(\n        containerClient,\n        this.segmentFactory,\n        years,\n        segments,\n        currentSegment,\n        lastConsumable,\n        options.start,\n        options.end,\n      );\n    });\n  }\n}\n"]}