azure-mock 2.35.0 → 2.37.2

package/README.md

@@ -5,7 +5,7 @@
 [![NPM downloads][badge-npm-downloads]][url-npm]
 [![NPM Unpacked Size (with version)][badge-npm-unpacked-size]][url-npm]
 
-Mock Azure service classes for local development and testing. Provides in-memory implementations of Azure Table Storage, Blob Storage, Queue Storage, Service Bus, and EventGrid clients that mirror the real Azure SDK interfaces.
+Mock Azure service classes for local development and testing. Provides in-memory implementations of Azure Table Storage, Blob Storage, Service Bus, and EventGrid clients that mirror the real Azure SDK interfaces.
 
 ## Table of Contents
 
@@ -18,22 +18,29 @@ Mock Azure service classes for local development and testing. Provides in-memory
 ## <a name="getting-started">🚀 Getting Started</a>
 
 ```bash
-pnpm i -D azure-mock @azure/core-http-compat @azure/core-rest-pipeline @azure/data-tables @azure/eventgrid @azure/service-bus @azure/storage-blob @azure/storage-queue
+pnpm i -D azure-mock @azure/core-http-compat @azure/core-rest-pipeline @azure/data-tables @azure/eventgrid @azure/service-bus @azure/storage-blob
 ```
 
 ## <a name="documentation">📖 Documentation</a>
 
-We highly recommend you take a look at the [documentation](https://esposter.com/docs/modules/azure-mock.html) to level up.
+We highly recommend you take a look at the [documentation](https://esposter.com/docs/api/modules/azure-mock.html) to level up.
 
 ### Available Mocks
 
-| Class                          | Azure Equivalent           | Description                   |
-| ------------------------------ | -------------------------- | ----------------------------- |
-| `MockTableClient`              | `TableClient`              | In-memory Azure Table Storage |
-| `MockBlobServiceClient`        | `BlobServiceClient`        | In-memory Azure Blob Storage  |
-| `MockQueueClient`              | `QueueClient`              | In-memory Azure Queue Storage |
-| `MockServiceBusSender`         | `ServiceBusSender`         | In-memory Azure Service Bus   |
-| `MockEventGridPublisherClient` | `EventGridPublisherClient` | No-op EventGrid publisher     |
+| Class                          | Azure Equivalent           | Description                                  |
+| ------------------------------ | -------------------------- | -------------------------------------------- |
+| `MockTableClient`              | `TableClient`              | In-memory Azure Table Storage                |
+| `MockContainerClient`          | `ContainerClient`          | In-memory blob container, listing and paging |
+| `MockBlobClient`               | `BlobClient`               | In-memory blob read, copy and delete         |
+| `MockBlockBlobClient`          | `BlockBlobClient`          | In-memory block blob upload and download     |
+| `MockBlobBatchClient`          | `BlobBatchClient`          | In-memory batched blob deletion              |
+| `MockSearchClient`             | `SearchClient`             | In-memory Azure AI Search index              |
+| `MockQueueClient`              | `QueueClient`              | In-memory Azure Storage Queue                |
+| `MockServiceBusSender`         | `ServiceBusSender`         | In-memory Azure Service Bus                  |
+| `MockWebPubSubServiceClient`   | `WebPubSubServiceClient`   | In-memory Azure Web PubSub                   |
+| `MockEventGridPublisherClient` | `EventGridPublisherClient` | In-memory EventGrid publisher                |
+
+Each client's state lives in an exported `Mock*Database` map (`MockTableDatabase`, `MockContainerDatabase`, …), so a test resets by clearing the one it seeded.
 
 ### Usage
 

package/dist/index.d.ts

@@ -1,31 +1,32 @@
+import { PipelineRequest, RestError } from "@azure/core-rest-pipeline";
 import { HttpHeadersLike, WebResourceLike } from "@azure/core-http-compat";
 import { MapValue } from "@esposter/shared";
-import { PipelineRequest } from "@azure/core-rest-pipeline";
-import { AnonymousCredential, AppendBlobClient, BlobAbortCopyFromURLResponse, BlobBatchClient, BlobBatchDeleteBlobsResponse, BlobBeginCopyFromURLResponse, BlobClient, BlobCopyFromURLResponse, BlobCreateSnapshotResponse, BlobDeleteIfExistsResponse, BlobDeleteImmutabilityPolicyResponse, BlobDeleteOptions, BlobDeleteResponse, BlobDownloadResponseModel, BlobDownloadResponseParsed, BlobGenerateSasUrlOptions, BlobGetAccountInfoResponse, BlobGetPropertiesResponse, BlobGetTagsResponse, BlobItem, BlobLeaseClient, BlobPrefix, BlobSetHTTPHeadersResponse, BlobSetImmutabilityPolicyResponse, BlobSetLegalHoldResponse, BlobSetMetadataResponse, BlobSetTagsResponse, BlobSetTierResponse, BlobUndeleteResponse, BlobUploadCommonResponse, BlockBlobClient, BlockBlobCommitBlockListResponse, BlockBlobGetBlockListResponse, BlockBlobPutBlobFromUrlResponse, BlockBlobStageBlockFromURLResponse, BlockBlobStageBlockResponse, BlockBlobUploadResponse, ContainerClient, ContainerCreateIfNotExistsResponse, ContainerCreateResponse, ContainerDeleteIfExistsResponse, ContainerDeleteResponse, ContainerFindBlobsByTagsSegmentResponse, ContainerGenerateSasUrlOptions, ContainerGetAccessPolicyResponse, ContainerGetAccountInfoResponse, ContainerGetPropertiesResponse, ContainerListBlobFlatSegmentResponse, ContainerListBlobHierarchySegmentResponse, ContainerListBlobsOptions, ContainerSetAccessPolicyResponse, ContainerSetMetadataResponse, FilterBlobItem, HttpRequestBody, PageBlobClient, PollOperationState, PollerLikeWithCancellation, StorageSharedKeyCredential } from "@azure/storage-blob";
+import { AnonymousCredential, AppendBlobClient, BlobAbortCopyFromURLResponse, BlobBatchClient, BlobBatchDeleteBlobsResponse, BlobBeginCopyFromURLResponse, BlobClient, BlobCopyFromURLResponse, BlobCreateSnapshotResponse, BlobDeleteIfExistsResponse, BlobDeleteImmutabilityPolicyResponse, BlobDeleteOptions, BlobDeleteResponse, BlobDownloadResponseModel, BlobDownloadResponseParsed, BlobGenerateSasUrlOptions, BlobGetAccountInfoResponse, BlobGetPropertiesResponse, BlobGetTagsResponse, BlobHierarchyListSegment, BlobItem, BlobLeaseClient, BlobPrefix, BlobSetHTTPHeadersResponse, BlobSetImmutabilityPolicyResponse, BlobSetLegalHoldResponse, BlobSetMetadataResponse, BlobSetTagsResponse, BlobSetTierResponse, BlobUndeleteResponse, BlobUploadCommonResponse, BlockBlobClient, BlockBlobCommitBlockListResponse, BlockBlobGetBlockListResponse, BlockBlobPutBlobFromUrlResponse, BlockBlobStageBlockFromURLResponse, BlockBlobStageBlockResponse, BlockBlobUploadOptions, BlockBlobUploadResponse, ContainerClient, ContainerCreateIfNotExistsResponse, ContainerCreateResponse, ContainerDeleteIfExistsResponse, ContainerDeleteResponse, ContainerFindBlobsByTagsSegmentResponse, ContainerGenerateSasUrlOptions, ContainerGetAccessPolicyResponse, ContainerGetAccountInfoResponse, ContainerGetPropertiesResponse, ContainerListBlobFlatSegmentResponse, ContainerListBlobHierarchySegmentResponse, ContainerListBlobsOptions, ContainerSetAccessPolicyResponse, ContainerSetMetadataResponse, FilterBlobItem, HttpRequestBody, PageBlobClient, PollOperationState, PollerLikeWithCancellation, StorageSharedKeyCredential } from "@azure/storage-blob";
 import { BinaryOperator, Clause } from "@esposter/db-schema";
 import { EventGridEvent, EventGridPublisherClient } from "@azure/eventgrid";
 import { ServiceBusMessage, ServiceBusMessageBatch, ServiceBusSender } from "@azure/service-bus";
 import { CreateTableEntityResponse, GetAccessPolicyResponse, GetTableEntityResponse, ListTableEntitiesOptions, TableClient, TableDeleteEntityHeaders, TableEntity, TableEntityResult, TableEntityResultPage, TableMergeEntityHeaders, TableSetAccessPolicyHeaders, TableTransactionResponse, UpdateMode } from "@azure/data-tables";
 import { QueueClearMessagesResponse, QueueClient, QueueCreateIfNotExistsResponse, QueueCreateOptions, QueueCreateResponse, QueueDeleteIfExistsResponse, QueueDeleteMessageResponse, QueueDeleteResponse, QueueGenerateSasUrlOptions, QueueGetAccessPolicyResponse, QueueGetPropertiesResponse, QueueItem, QueuePeekMessagesOptions, QueuePeekMessagesResponse, QueueReceiveMessageOptions, QueueReceiveMessageResponse, QueueSendMessageOptions, QueueSendMessageResponse, QueueServiceProperties, QueueSetAccessPolicyResponse, QueueSetMetadataResponse, QueueUpdateMessageResponse, SignedIdentifier } from "@azure/storage-queue";
 import { AutocompleteResult, CountDocumentsOptions, DeleteDocumentsOptions, GetDocumentOptions, IndexDocumentsBatch, IndexDocumentsOptions, IndexDocumentsResult, MergeDocumentsOptions, MergeOrUploadDocumentsOptions, NarrowedModel, SearchClient, SearchDocumentsResult, SearchOptions, SelectFields, SuggestDocumentsResult, SuggestOptions, UploadDocumentsOptions } from "@azure/search-documents";
-declare const MOCK_BLOB_BASE_URL = "https://mockaccount.blob.core.windows.net";
-declare const MOCK_QUEUE_BASE_URL = "https://mockaccount.queue.core.windows.net";
-declare const MOCK_SEARCH_BASE_URL = "https://mockaccount.search.windows.net";
-declare const MOCK_TABLE_BASE_URL = "https://mockaccount.table.core.windows.net";
-interface MockResponse {
+export declare const BLOB_NOT_FOUND_ERROR_CODE = "BlobNotFound";
+export declare const BLOB_NOT_FOUND_MESSAGE = "The specified blob does not exist.";
+export declare const MOCK_BLOB_BASE_URL = "https://mockaccount.blob.core.windows.net";
+export declare const MOCK_QUEUE_BASE_URL = "https://mockaccount.queue.core.windows.net";
+export declare const MOCK_SEARCH_BASE_URL = "https://mockaccount.search.windows.net";
+export declare const MOCK_TABLE_BASE_URL = "https://mockaccount.table.core.windows.net";
+export interface MockResponse {
   headers: HttpHeadersLike;
   parsedHeaders: Record<string, never>;
   request: WebResourceLike;
   status: number;
 }
-declare class MockRestError extends Error {
-  statusCode: number;
+export declare class MockRestError extends RestError {
   constructor(message: string, statusCode: number);
 }
 /**
  * An interface that tracks the settings for paged iteration
  */
-interface PageSettings {
+export interface PageSettings {
   /**
    * The token that keeps track of where to continue the iterator
    */
@@ -38,7 +39,7 @@ interface PageSettings {
 /**
  * An interface that allows async iterable iteration both to completion and by page.
  */
-interface PagedAsyncIterableIterator<TElement, TPage = TElement[], TPageSettings = PageSettings> {
+export interface PagedAsyncIterableIterator<TElement, TPage = TElement[], TPageSettings = PageSettings> {
   /**
    * The connection to the async iterator, part of the iteration protocol
    */
@@ -52,22 +53,26 @@ interface PagedAsyncIterableIterator<TElement, TPage = TElement[], TPageSettings
    */
   next: () => Promise<IteratorResult<TElement>>;
 }
-declare const createMockResponse: (status: number, url?: string) => MockResponse;
-declare const getMockSasUrl: (url: string, permissions: undefined | {
+export declare const createMockResponse: (status: number, url?: string) => MockResponse;
+export declare const getMockSasUrl: (url: string, permissions: undefined | {
   toString: () => string;
 }, resourceType?: string) => string;
-declare const MockContainerDatabase: Map<string, Map<string, Buffer>>;
-declare const MockEventGridDatabase: Map<string, EventGridEvent<unknown>[]>;
-declare const MockQueueDatabase: Map<string, string[]>;
-declare const MockSearchDatabase: Map<string, object[]>;
-declare const MockServiceBusDatabase: Map<string, ServiceBusMessage[]>;
-declare const MockTableDatabase: Map<string, Map<string, TableEntity>>;
-type BlobHierarchyItem = (BlobItem & {
+export declare const MockContainerCreatedOnDatabase: Map<string, Date>;
+export declare const MOCK_BLOB_SEEDED_CREATED_ON: Date;
+export declare const getMockContainerCreatedOnKey: (containerName: string, blobName: string) => string;
+export declare const MockContainerDatabase: Map<string, Map<string, Buffer>>;
+export declare const MockEventGridDatabase: Map<string, EventGridEvent<unknown>[]>;
+export declare const MockQueueDatabase: Map<string, string[]>;
+export declare const MockSearchDatabase: Map<string, object[]>;
+export declare const MockServiceBusDatabase: Map<string, ServiceBusMessage[]>;
+export declare const MockTableDatabase: Map<string, Map<string, TableEntity>>;
+export type BlobHierarchyItem = (BlobItem & {
   kind: "blob";
 }) | (BlobPrefix & {
   kind: "prefix";
 });
-declare class MockBlobBatchClient implements BlobBatchClient {
+export declare class MockBlobBatchClient implements BlobBatchClient {
+  #private;
   url: string;
   constructor(url: string);
   /**
@@ -812,7 +817,7 @@ type PostPayloadFixed = Except<UserData, 'email'>;
 */
 type Except<ObjectType, KeysType extends keyof ObjectType, Options extends ExceptOptions = {}> = _Except<ObjectType, KeysType, ApplyDefaultOptions<ExceptOptions, DefaultExceptOptions, Options>>;
 type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Required<ExceptOptions>> = { [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType]; } & (Options['requireExactProps'] extends true ? Partial<Record<KeysType, never>> : {});
-declare class MockBlobClient implements Except<BlobClient, "accountName"> {
+export declare class MockBlobClient implements Except<BlobClient, "accountName"> {
   connectionString: string;
   containerName: string;
   credential: AnonymousCredential;
@@ -852,14 +857,14 @@ declare class MockBlobClient implements Except<BlobClient, "accountName"> {
   withSnapshot(): BlockBlobClient;
   withVersion(): BlobClient;
 }
-declare class MockBlockBlobClient extends MockBlobClient implements Except<BlockBlobClient, "accountName"> {
+export declare class MockBlockBlobClient extends MockBlobClient implements Except<BlockBlobClient, "accountName"> {
   commitBlockList(): Promise<BlockBlobCommitBlockListResponse>;
   getBlockList(): Promise<BlockBlobGetBlockListResponse>;
   query(): Promise<BlobDownloadResponseModel>;
   stageBlock(): Promise<BlockBlobStageBlockResponse>;
   stageBlockFromURL(): Promise<BlockBlobStageBlockFromURLResponse>;
   syncUploadFromURL(): Promise<BlockBlobPutBlobFromUrlResponse>;
-  upload(body: HttpRequestBody, _contentLength: number): Promise<BlockBlobUploadResponse>;
+  upload(body: HttpRequestBody, _contentLength: number, options?: BlockBlobUploadOptions): Promise<BlockBlobUploadResponse>;
   uploadBrowserData(): Promise<BlobUploadCommonResponse>;
   uploadData(): Promise<BlobUploadCommonResponse>;
   uploadFile(): Promise<BlobUploadCommonResponse>;
@@ -875,7 +880,7 @@ declare class MockBlockBlobClient extends MockBlobClient implements Except<Block
  * await blockBlobClient.upload("hello world", 11);
  * const content = await blockBlobClient.downloadToBuffer();
  */
-declare class MockContainerClient implements Except<ContainerClient, "accountName"> {
+export declare class MockContainerClient implements Except<ContainerClient, "accountName"> {
   #private;
   connectionString: string;
   containerName: string;
@@ -904,7 +909,7 @@ declare class MockContainerClient implements Except<ContainerClient, "accountNam
   getPageBlobClient(): PageBlobClient;
   getProperties(): Promise<ContainerGetPropertiesResponse>;
   listBlobsByHierarchy(delimiter: string, options?: ContainerListBlobsOptions): PagedAsyncIterableIterator<BlobHierarchyItem, ContainerListBlobHierarchySegmentResponse>;
-  listBlobsFlat(): PagedAsyncIterableIterator<BlobItem, ContainerListBlobFlatSegmentResponse>;
+  listBlobsFlat(options?: ContainerListBlobsOptions): PagedAsyncIterableIterator<BlobItem, ContainerListBlobFlatSegmentResponse>;
   setAccessPolicy(): Promise<ContainerSetAccessPolicyResponse>;
   setMetadata(): Promise<ContainerSetMetadataResponse>;
   uploadBlockBlob(blobName: string, body: HttpRequestBody, contentLength: number): Promise<{
@@ -917,7 +922,7 @@ declare class MockContainerClient implements Except<ContainerClient, "accountNam
  * It uses a Map to simulate event grid storage and correctly implements the EventGridPublisherClient interface.
  * `client` is excluded because it is a private member of the real class and cannot be satisfied structurally.
  */
-declare class MockEventGridPublisherClient implements Except<EventGridPublisherClient<"EventGrid">, "apiVersion"> {
+export declare class MockEventGridPublisherClient implements Except<EventGridPublisherClient<"EventGrid">, "apiVersion"> {
   readonly endpointUrl: string;
   readonly inputSchema: "EventGrid";
   readonly topicType: "EventGrid";
@@ -934,7 +939,7 @@ declare class MockEventGridPublisherClient implements Except<EventGridPublisherC
  * await mockQueueClient.sendMessage("hello world");
  * const messages = await mockQueueClient.peekMessages();
  */
-declare class MockQueueClient implements Except<QueueClient, "accountName"> {
+export declare class MockQueueClient implements Except<QueueClient, "accountName"> {
   connectionString: string;
   name: string;
   url: string;
@@ -971,7 +976,7 @@ declare class MockQueueClient implements Except<QueueClient, "accountName"> {
  * await mockSearchClient.uploadDocuments([{ ... }]);
  * const { count, results } = await mockSearchClient.search("*", { filter, includeTotalCount: true });
  */
-declare class MockSearchClient<TModel extends object = Record<string, unknown>> implements Except<SearchClient<TModel>, "pipeline"> {
+export declare class MockSearchClient<TModel extends object = Record<string, unknown>> implements Except<SearchClient<TModel>, "pipeline"> {
   readonly apiVersion: string;
   readonly endpoint: string;
   readonly indexName: string;
@@ -998,7 +1003,7 @@ declare class MockSearchClient<TModel extends object = Record<string, unknown>>
  * const mockServiceBusSender = new MockServiceBusSender("hello world");
  * await mockServiceBusSender.scheduleMessages({ body: "hello world" }, new Date());
  */
-declare class MockServiceBusSender implements ServiceBusSender {
+export declare class MockServiceBusSender implements ServiceBusSender {
   entityPath: string;
   identifier: string;
   isClosed: boolean;
@@ -1019,7 +1024,7 @@ declare class MockServiceBusSender implements ServiceBusSender {
  * await mockTableClient.createEntity({ partitionKey: "partitionKey", rowKey: "rowKey" });
  * const entity = await mockTableClient.getEntity("partitionKey", "rowKey");
  */
-declare class MockTableClient<TEntity extends TableEntity = TableEntity> implements Except<TableClient, "pipeline"> {
+export declare class MockTableClient<TEntity extends TableEntity = TableEntity> implements Except<TableClient, "pipeline"> {
   #private;
   entityType: TEntity;
   tableName: string;
@@ -1035,39 +1040,54 @@ declare class MockTableClient<TEntity extends TableEntity = TableEntity> impleme
   listEntities<T extends object>(options?: ListTableEntitiesOptions): PagedAsyncIterableIterator<TableEntityResult<T>, TableEntityResultPage<T>>;
   setAccessPolicy(): Promise<TableSetAccessPolicyHeaders>;
   submitTransaction(actions: Parameters<TableClient["submitTransaction"]>[0]): Promise<TableTransactionResponse>;
-  updateEntity<T extends object>(entity: TableEntity<T>, mode?: UpdateMode): Promise<TableMergeEntityHeaders>;
+  updateEntity<T extends object>(entity: TableEntity<T>, mode?: UpdateMode, options?: {
+    etag?: string;
+  }): Promise<TableMergeEntityHeaders>;
   upsertEntity<T extends object>(entity: TableEntity<T>, mode?: UpdateMode): Promise<TableMergeEntityHeaders>;
 }
 /**
  * A minimal mock of the Azure WebPubSubServiceClient for testing purposes.
  * Only implements `group().sendToAll` — the only method used in azure-functions tests.
  */
-declare class MockWebPubSubServiceClient {
+export declare class MockWebPubSubServiceClient {
   group(_groupName: string): {
     sendToAll: () => Promise<void>;
   };
 }
-declare const bodyToBuffer: (body: HttpRequestBody) => Promise<Buffer>;
+export declare const bodyToBuffer: (body: HttpRequestBody) => Promise<Buffer>;
 /**
  * Generates a standard Azure Storage error XML response body.
  * @param errorCode The official Azure error code (e.g., "BlobNotFound").
  * @param errorMessage The user-friendly error message.
  * @returns A formatted XML string.
  */
-declare const getAzureErrorXml: (errorCode: string, errorMessage: string) => string;
-declare const getBlobItemXml: ({ name, properties }: BlobItem) => string;
-declare const getBlobPrefixXml: (name: string) => string;
+export declare const getAzureErrorXml: (errorCode: string, errorMessage: string) => string;
+export declare const getBlobItemXml: ({ name, properties }: BlobItem) => string;
+export declare const getBlobPrefixXml: (name: string) => string;
+export declare const getBlobUrl: (containerName: string, blobName: string) => string;
+export declare const getBlobUrlParts: (url: string) => undefined | {
+  blobName: string;
+  containerName: string;
+};
+export declare const getListBlobsSegmentResponse: (containerName: string, prefix: string, segment: BlobHierarchyListSegment, blobsXml: string) => ContainerListBlobHierarchySegmentResponse;
 /**
  * Generates a standard Azure Storage list blobs XML response body.
  * @param containerName The container name.
  * @param blobsXml The blobs xml data.
  * @returns A formatted XML string.
  */
-declare const getListBlobsXml: (containerName: string, blobsXml: string) => string;
-declare const isReadableStream: (value: unknown) => value is NodeJS.ReadableStream;
-declare const toWebResourceLike: (request: PipelineRequest) => WebResourceLike;
-declare const applyFilter: <T extends Record<string, unknown>>(documents: T[], clauses: Clause<T>[]) => T[];
-declare const compare: <T>(operator: BinaryOperator, leftHandSide: T, rightHandSide: null | T) => boolean;
-declare const createFilterPredicate: (filter: string) => ((document: Record<string, unknown>) => boolean);
-declare const isNullClause: (clause: Clause<Record<string, unknown>>) => boolean;
-export { BlobHierarchyItem, MOCK_BLOB_BASE_URL, MOCK_QUEUE_BASE_URL, MOCK_SEARCH_BASE_URL, MOCK_TABLE_BASE_URL, MockBlobBatchClient, MockBlobClient, MockBlockBlobClient, MockContainerClient, MockContainerDatabase, MockEventGridDatabase, MockEventGridPublisherClient, MockQueueClient, MockQueueDatabase, MockResponse, MockRestError, MockSearchClient, MockSearchDatabase, MockServiceBusDatabase, MockServiceBusSender, MockTableClient, MockTableDatabase, MockWebPubSubServiceClient, PageSettings, PagedAsyncIterableIterator, applyFilter, bodyToBuffer, compare, createFilterPredicate, createMockResponse, getAzureErrorXml, getBlobItemXml, getBlobPrefixXml, getListBlobsXml, getMockSasUrl, isNullClause, isReadableStream, toWebResourceLike };
+export declare const getListBlobsXml: (containerName: string, blobsXml: string) => string;
+export declare const getMockContainer: (containerName: string) => MapValue<typeof MockContainerDatabase>;
+export declare const isReadableStream: (value: unknown) => value is NodeJS.ReadableStream;
+export declare const toWebResourceLike: (request: PipelineRequest) => WebResourceLike;
+export declare const applyFilter: <T extends Record<string, unknown>>(documents: T[], clauses: Clause<T>[]) => T[];
+export declare const compare: <T>(operator: BinaryOperator, leftHandSide: T, rightHandSide: null | T) => boolean;
+export declare const createFilterPredicate: (filter: string) => ((document: Record<string, unknown>) => boolean);
+export declare const isNullClause: (clause: Clause<Record<string, unknown>>) => boolean;
+export declare const getMockQueueMessageItem: (messageText: string) => {
+  expiresOn: Date;
+  insertedOn: Date;
+  messageId: string;
+  messageText: string;
+};
+export declare const compareByCompositeKey: (a: TableEntity, b: TableEntity) => number;

package/dist/index.js

@@ -1,6 +1,6 @@
+import { RestError, createHttpHeaders, createPipelineRequest } from "@azure/core-rest-pipeline";
 import { toHttpHeadersLike } from "@azure/core-http-compat";
-import { ID_SEPARATOR, InvalidOperationError, Operation, exhaustiveGuard, getOrCreate, getResultAsync, html, noop, streamToText, takeOne } from "@esposter/shared";
-import { createHttpHeaders, createPipelineRequest } from "@azure/core-rest-pipeline";
+import { ID_SEPARATOR, InvalidOperationError, Operation, chunk, exhaustiveGuard, getDecodedUriComponent, getOrCreate, getResult, html, noop, streamToText, takeOne } from "@esposter/shared";
 import { AnonymousCredential } from "@azure/storage-blob";
 import { Readable } from "node:stream";
 import { MAX_QUEUE_VISIBILITY_TIMEOUT_MS, deserializeClause, deserializeKey, getTableNullClause, serializeClauses } from "@esposter/db";
@@ -22,20 +22,20 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
+const BLOB_NOT_FOUND_ERROR_CODE = "BlobNotFound";
+const BLOB_NOT_FOUND_MESSAGE = "The specified blob does not exist.";
 const MOCK_BLOB_BASE_URL = "https://mockaccount.blob.core.windows.net";
 const MOCK_QUEUE_BASE_URL = "https://mockaccount.queue.core.windows.net";
 const MOCK_SEARCH_BASE_URL = "https://mockaccount.search.windows.net";
 const MOCK_TABLE_BASE_URL = "https://mockaccount.table.core.windows.net";
-var MockRestError = class extends Error {
-	statusCode;
+var MockRestError = class extends RestError {
 	constructor(message, statusCode) {
-		super(message);
+		super(message, { statusCode });
 		this.name = "MockRestError";
-		this.statusCode = statusCode;
 	}
 };
 const toWebResourceLike = (request) => ({
@@ -70,7 +70,16 @@ const createMockResponse = (status, url = "") => ({
 	status
 });
 const getMockSasUrl = (url, permissions, resourceType) => `${url}?sv=2025-11-05&${resourceType ? `sr=${resourceType}&` : ""}sig=mock-signature&st=1970-01-01T00:00:00Z&se=2099-12-31T23:59:59Z&sp=${permissions?.toString() ?? "r"}`;
-const MockContainerDatabase = /* @__PURE__ */ new Map();
+const MockContainerCreatedOnDatabase = /* @__PURE__ */ new Map();
+const MOCK_BLOB_SEEDED_CREATED_ON = /* @__PURE__ */ new Date(-864e13);
+const getMockContainerCreatedOnKey = (containerName, blobName) => `${containerName}/${blobName}`;
+var MockContainerDatabaseMap = class extends Map {
+	clear() {
+		super.clear();
+		MockContainerCreatedOnDatabase.clear();
+	}
+};
+const MockContainerDatabase = new MockContainerDatabaseMap();
 const MockEventGridDatabase = /* @__PURE__ */ new Map();
 const MockQueueDatabase = /* @__PURE__ */ new Map();
 const MockSearchDatabase = /* @__PURE__ */ new Map();
@@ -87,6 +96,18 @@ const getAzureErrorXml = (errorCode, errorMessage) => html`<?xml version="1.0" e
       <code>${errorCode}</code>
       <Message>${errorMessage}</Message>
     </Error>`;
+const decodeSegment = (segment) => getDecodedUriComponent(segment, segment);
+const getBlobUrlParts = (url) => {
+	const parsedUrl = getResult(() => new URL(url)).unwrapOr(void 0);
+	if (!parsedUrl) return void 0;
+	const pathSegments = parsedUrl.pathname.split("/").filter(Boolean);
+	if (pathSegments.length < 2) return void 0;
+	return {
+		blobName: decodeSegment(pathSegments.slice(1).join("/")),
+		containerName: decodeSegment(takeOne(pathSegments))
+	};
+};
+const getMockContainer = (containerName) => getOrCreate(MockContainerDatabase, containerName, () => /* @__PURE__ */ new Map());
 var MockBlobBatchClient = class {
 	url;
 	constructor(url) {
@@ -103,29 +124,17 @@ var MockBlobBatchClient = class {
 		let subResponsesSucceededCount = 0;
 		let subResponsesFailedCount = 0;
 		for (const url of urls) {
-			const pathSegments = new URL(url).pathname.split("/").filter(Boolean);
-			if (pathSegments.length < 2) {
-				const errorCode = "InvalidUri";
-				const statusMessage = "Invalid blob URL format.";
-				subResponses.push({
-					_request: {
-						credential,
-						url: this.url
-					},
-					bodyAsText: getAzureErrorXml(errorCode, statusMessage),
-					errorCode,
-					headers: toHttpHeadersLike(createHttpHeaders()),
-					status: 400,
-					statusMessage
-				});
+			const urlParts = getBlobUrlParts(url);
+			if (!urlParts) {
+				subResponses.push(this.#createFailedSubResponse(credential, 400, "InvalidUri", "Invalid blob URL format."));
 				subResponsesFailedCount++;
 				continue;
 			}
-			const containerName = takeOne(pathSegments);
-			const blobName = pathSegments.slice(1).join("/");
+			const { blobName, containerName } = urlParts;
 			const container = this.getContainer(containerName);
 			if (container.has(blobName)) {
 				container.delete(blobName);
+				MockContainerCreatedOnDatabase.delete(getMockContainerCreatedOnKey(containerName, blobName));
 				subResponses.push({
 					_request: {
 						credential,
@@ -137,19 +146,7 @@ var MockBlobBatchClient = class {
 				});
 				subResponsesSucceededCount++;
 			} else {
-				const errorCode = "BlobNotFound";
-				const statusMessage = "The specified blob does not exist.";
-				subResponses.push({
-					_request: {
-						credential,
-						url: this.url
-					},
-					bodyAsText: getAzureErrorXml(errorCode, statusMessage),
-					errorCode,
-					headers: toHttpHeadersLike(createHttpHeaders()),
-					status: 404,
-					statusMessage
-				});
+				subResponses.push(this.#createFailedSubResponse(credential, 404, BLOB_NOT_FOUND_ERROR_CODE, BLOB_NOT_FOUND_MESSAGE));
 				subResponsesFailedCount++;
 			}
 		}
@@ -167,9 +164,23 @@ var MockBlobBatchClient = class {
 		});
 	}
 	getContainer(containerName) {
-		return getOrCreate(MockContainerDatabase, containerName, () => /* @__PURE__ */ new Map());
+		return getMockContainer(containerName);
+	}
+	#createFailedSubResponse(credential, status, errorCode, statusMessage) {
+		return {
+			_request: {
+				credential,
+				url: this.url
+			},
+			bodyAsText: getAzureErrorXml(errorCode, statusMessage),
+			errorCode,
+			headers: toHttpHeadersLike(createHttpHeaders()),
+			status,
+			statusMessage
+		};
 	}
 };
+const getBlobUrl = (containerName, blobName) => `${MOCK_BLOB_BASE_URL}/${containerName}/${blobName.split("/").map((segment) => encodeURIComponent(segment)).join("/")}`;
 var MockBlobClient = class {
 	connectionString;
 	containerName;
@@ -177,27 +188,27 @@ var MockBlobClient = class {
 	name;
 	url;
 	get container() {
-		return getOrCreate(MockContainerDatabase, this.containerName, () => /* @__PURE__ */ new Map());
+		return getMockContainer(this.containerName);
 	}
 	constructor(connectionString, containerName, blobName) {
 		this.connectionString = connectionString;
 		this.containerName = containerName;
 		this.name = blobName;
-		this.url = `${MOCK_BLOB_BASE_URL}/${this.containerName}/${this.name}`;
+		this.url = getBlobUrl(this.containerName, this.name);
 	}
 	abortCopyFromURL() {
 		throw new Error("Method not implemented.");
 	}
 	beginCopyFromURL(copySource) {
-		const pathSegments = new URL(copySource).pathname.split("/").filter(Boolean);
-		if (pathSegments.length < 2) throw new MockRestError("Invalid copy source URL format", 400);
-		const sourceContainerName = takeOne(pathSegments);
-		const sourceBlobName = pathSegments.slice(1).join("/");
+		const sourceParts = getBlobUrlParts(copySource);
+		if (!sourceParts) throw new MockRestError("Invalid copy source URL format", 400);
+		const { blobName: sourceBlobName, containerName: sourceContainerName } = sourceParts;
 		const sourceContainer = MockContainerDatabase.get(sourceContainerName);
 		if (!sourceContainer) throw new MockRestError("Source container not found", 404);
 		const sourceData = sourceContainer.get(sourceBlobName);
 		if (!sourceData) throw new MockRestError("Source blob not found", 404);
 		this.container.set(this.name, Buffer.from(sourceData));
+		MockContainerCreatedOnDatabase.set(getMockContainerCreatedOnKey(this.containerName, this.name), /* @__PURE__ */ new Date());
 		const response = { _response: createMockResponse(202, `${this.url}?comp=copy`) };
 		return Promise.resolve({
 			cancelOperation: () => Promise.resolve(),
@@ -218,13 +229,17 @@ var MockBlobClient = class {
 		throw new Error("Method not implemented.");
 	}
 	delete() {
-		if (!this.container.has(this.name)) throw new MockRestError("The specified blob does not exist.", 404);
+		if (!this.container.has(this.name)) throw new MockRestError(BLOB_NOT_FOUND_MESSAGE, 404);
 		this.container.delete(this.name);
+		MockContainerCreatedOnDatabase.delete(getMockContainerCreatedOnKey(this.containerName, this.name));
 		return Promise.resolve({ _response: createMockResponse(200) });
 	}
 	deleteIfExists() {
 		const succeeded = this.container.has(this.name);
-		if (succeeded) this.container.delete(this.name);
+		if (succeeded) {
+			this.container.delete(this.name);
+			MockContainerCreatedOnDatabase.delete(getMockContainerCreatedOnKey(this.containerName, this.name));
+		}
 		return Promise.resolve({
 			_response: createMockResponse(succeeded ? 200 : 404),
 			succeeded
@@ -242,14 +257,14 @@ var MockBlobClient = class {
 	}
 	downloadToBuffer() {
 		const data = this.container.get(this.name);
-		if (!data) throw new MockRestError("The specified blob does not exist.", 404);
+		if (!data) throw new MockRestError(BLOB_NOT_FOUND_MESSAGE, 404);
 		return Promise.resolve(Buffer.from(data));
 	}
 	downloadToFile() {
 		throw new Error("Method not implemented.");
 	}
 	exists() {
-		throw new Error("Method not implemented.");
+		return Promise.resolve(this.container.has(this.name));
 	}
 	generateSasStringToSign() {
 		throw new Error("Method not implemented.");
@@ -362,8 +377,11 @@ var MockBlockBlobClient = class extends MockBlobClient {
 	syncUploadFromURL() {
 		throw new Error("Method not implemented.");
 	}
-	async upload(body, _contentLength) {
-		this.container.set(this.name, await bodyToBuffer(body));
+	async upload(body, _contentLength, options) {
+		const buffer = await bodyToBuffer(body);
+		if (options?.conditions?.ifNoneMatch === "*" && this.container.has(this.name)) throw new MockRestError("The specified blob already exists.", 409);
+		this.container.set(this.name, buffer);
+		MockContainerCreatedOnDatabase.set(getMockContainerCreatedOnKey(this.containerName, this.name), /* @__PURE__ */ new Date());
 		return { _response: createMockResponse(201) };
 	}
 	uploadBrowserData() {
@@ -403,6 +421,23 @@ const getListBlobsXml = (containerName, blobsXml) => html`<?xml version="1.0" en
       <Blobs>${blobsXml}</Blobs>
       <NextMarker />
     </EnumerationResults>`;
+const getListBlobsSegmentResponse = (containerName, prefix, segment, blobsXml) => {
+	const segmentResponse = {
+		containerName,
+		marker: "",
+		prefix,
+		segment,
+		serviceEndpoint: ""
+	};
+	return {
+		_response: {
+			...createMockResponse(200),
+			bodyAsText: getListBlobsXml(containerName, blobsXml),
+			parsedBody: segmentResponse
+		},
+		...segmentResponse
+	};
+};
 /**
 * An in-memory mock of the Azure ContainerClient.
 * It uses a Map to simulate blob storage.
@@ -419,7 +454,7 @@ var MockContainerClient = class {
 	credential = new AnonymousCredential();
 	url;
 	get container() {
-		return getOrCreate(MockContainerDatabase, this.containerName, () => /* @__PURE__ */ new Map());
+		return getMockContainer(this.containerName);
 	}
 	constructor(connectionString, containerName) {
 		this.connectionString = connectionString;
@@ -436,9 +471,10 @@ var MockContainerClient = class {
 		throw new Error("Method not implemented.");
 	}
 	deleteBlob(blobName) {
-		if (!this.container.has(blobName)) throw new MockRestError("The specified blob does not exist.", 404);
+		if (!this.container.has(blobName)) throw new MockRestError(BLOB_NOT_FOUND_MESSAGE, 404);
 		this.container.delete(blobName);
-		return Promise.resolve({ _response: createMockResponse(200, `${this.url}/${blobName}`) });
+		MockContainerCreatedOnDatabase.delete(getMockContainerCreatedOnKey(this.containerName, blobName));
+		return Promise.resolve({ _response: createMockResponse(200, getBlobUrl(this.containerName, blobName)) });
 	}
 	deleteIfExists() {
 		throw new Error("Method not implemented.");
@@ -503,24 +539,10 @@ var MockContainerClient = class {
 					allBlobPrefixes.push({ name: blobHierarchyItem.name });
 					allBlobPrefixXml.push(getBlobPrefixXml(blobHierarchyItem.name));
 				}
-				if (allBlobItems.length > 0 || allBlobPrefixes.length > 0) yield await Promise.resolve({
-					_response: {
-						...createMockResponse(200),
-						bodyAsText: getListBlobsXml(this.containerName, `${allBlobItemXml.join("")}${allBlobPrefixXml.join("")}`),
-						parsedBody: {
-							containerName: this.containerName,
-							marker: "",
-							prefix: options?.prefix ?? "",
-							segment: { blobItems: allBlobItems },
-							serviceEndpoint: ""
-						}
-					},
-					containerName: this.containerName,
-					marker: "",
-					prefix: options?.prefix ?? "",
-					segment: { blobItems: allBlobItems },
-					serviceEndpoint: ""
-				});
+				if (allBlobItems.length > 0 || allBlobPrefixes.length > 0) yield await Promise.resolve(getListBlobsSegmentResponse(this.containerName, options?.prefix ?? "", {
+					blobItems: allBlobItems,
+					blobPrefixes: allBlobPrefixes
+				}, `${allBlobItemXml.join("")}${allBlobPrefixXml.join("")}`));
 			}.bind(this)(),
 			next: blobHierarchyItemIterator.next.bind(blobHierarchyItemIterator),
 			[Symbol.asyncIterator]() {
@@ -528,8 +550,8 @@ var MockContainerClient = class {
 			}
 		};
 	}
-	listBlobsFlat() {
-		const blobItemIterator = this.#getBlobItemIterator();
+	listBlobsFlat(options) {
+		const blobItemIterator = this.#getBlobItemIterator(options);
 		return {
 			byPage: () => async function* () {
 				const allBlobItems = [];
@@ -538,24 +560,7 @@ var MockContainerClient = class {
 					allBlobItems.push(blobItem);
 					allBlobItemXml.push(getBlobItemXml(blobItem));
 				}
-				if (allBlobItems.length > 0) yield await Promise.resolve({
-					_response: {
-						...createMockResponse(200),
-						bodyAsText: getListBlobsXml(this.containerName, allBlobItemXml.join("")),
-						parsedBody: {
-							containerName: this.containerName,
-							marker: "",
-							prefix: "",
-							segment: { blobItems: allBlobItems },
-							serviceEndpoint: ""
-						}
-					},
-					containerName: this.containerName,
-					marker: "",
-					prefix: "",
-					segment: { blobItems: allBlobItems },
-					serviceEndpoint: ""
-				});
+				if (allBlobItems.length > 0) yield await Promise.resolve(getListBlobsSegmentResponse(this.containerName, options?.prefix ?? "", { blobItems: allBlobItems }, allBlobItemXml.join("")));
 			}.bind(this)(),
 			next: blobItemIterator.next.bind(blobItemIterator),
 			[Symbol.asyncIterator]() {
@@ -584,20 +589,7 @@ var MockContainerClient = class {
 			if (!name.startsWith(prefix)) continue;
 			const nameAfterPrefix = name.slice(prefix.length);
 			const delimiterIndex = nameAfterPrefix.indexOf(delimiter);
-			if (delimiterIndex === -1) blobsInCurrentLevel.push({
-				deleted: false,
-				name,
-				properties: {
-					blobType: "BlockBlob",
-					contentLength: buffer.length,
-					contentType: "application/octet-stream",
-					etag: `"${crypto.randomUUID()}"`,
-					lastModified: /* @__PURE__ */ new Date(),
-					leaseState: "available",
-					leaseStatus: "unlocked"
-				},
-				snapshot: ""
-			});
+			if (delimiterIndex === -1) blobsInCurrentLevel.push(this.#getBlobItem(name, buffer));
 			else {
 				const subprefix = `${prefix}${nameAfterPrefix.slice(0, delimiterIndex + delimiter.length)}`;
 				uniqueSubprefixes.add(subprefix);
@@ -612,21 +604,29 @@ var MockContainerClient = class {
 			...blobItem
 		});
 	}
-	async *#getBlobItemIterator() {
-		for (const [name, buffer] of this.container.entries()) yield await Promise.resolve({
+	#getBlobItem(name, buffer) {
+		return {
 			deleted: false,
 			name,
 			properties: {
 				blobType: "BlockBlob",
 				contentLength: buffer.length,
 				contentType: "application/octet-stream",
+				createdOn: MockContainerCreatedOnDatabase.get(getMockContainerCreatedOnKey(this.containerName, name)) ?? MOCK_BLOB_SEEDED_CREATED_ON,
 				etag: `"${crypto.randomUUID()}"`,
 				lastModified: /* @__PURE__ */ new Date(),
 				leaseState: "available",
 				leaseStatus: "unlocked"
 			},
 			snapshot: ""
-		});
+		};
+	}
+	async *#getBlobItemIterator(options) {
+		const prefix = options?.prefix ?? "";
+		for (const [name, buffer] of this.container.entries()) {
+			if (!name.startsWith(prefix)) continue;
+			yield await Promise.resolve(this.#getBlobItem(name, buffer));
+		}
 	}
 };
 /**
@@ -648,6 +648,15 @@ var MockEventGridPublisherClient = class {
 		return Promise.resolve();
 	}
 };
+const getMockQueueMessageItem = (messageText) => {
+	const insertedOn = /* @__PURE__ */ new Date();
+	return {
+		expiresOn: new Date(insertedOn.getTime() + MAX_QUEUE_VISIBILITY_TIMEOUT_MS),
+		insertedOn,
+		messageId: crypto.randomUUID(),
+		messageText
+	};
+};
 /**
 * An in-memory mock of the Azure QueueClient.
 * It uses a Map to simulate queue storage and correctly implements the QueueClient interface.
@@ -718,10 +727,7 @@ var MockQueueClient = class {
 	peekMessages(_options) {
 		const peekedMessageItems = this.queue.map((text) => ({
 			dequeueCount: 0,
-			expiresOn: new Date(Date.now() + MAX_QUEUE_VISIBILITY_TIMEOUT_MS),
-			insertedOn: /* @__PURE__ */ new Date(),
-			messageId: crypto.randomUUID(),
-			messageText: text
+			...getMockQueueMessageItem(text)
 		}));
 		return Promise.resolve({
 			_response: {
@@ -733,12 +739,8 @@ var MockQueueClient = class {
 		});
 	}
 	receiveMessages(_options) {
-		const receivedMessageItems = this.queue.splice(0).map((text) => ({
+		const receivedMessageItems = this.queue.splice(0).map((text) => Object.assign(getMockQueueMessageItem(text), {
 			dequeueCount: 1,
-			expiresOn: new Date(Date.now() + MAX_QUEUE_VISIBILITY_TIMEOUT_MS),
-			insertedOn: /* @__PURE__ */ new Date(),
-			messageId: crypto.randomUUID(),
-			messageText: text,
 			nextVisibleOn: /* @__PURE__ */ new Date(),
 			popReceipt: crypto.randomUUID()
 		}));
@@ -753,11 +755,8 @@ var MockQueueClient = class {
 	}
 	sendMessage(messageText, _options) {
 		this.queue.push(messageText);
-		const now = /* @__PURE__ */ new Date();
-		const expiresOn = new Date(now.getTime() + MAX_QUEUE_VISIBILITY_TIMEOUT_MS);
-		const insertedOn = now;
-		const messageId = crypto.randomUUID();
-		const nextVisibleOn = now;
+		const { expiresOn, insertedOn, messageId } = getMockQueueMessageItem(messageText);
+		const nextVisibleOn = insertedOn;
 		const popReceipt = crypto.randomUUID();
 		const enqueuedMessages = [{
 			expiresOn,
@@ -837,18 +836,24 @@ var import_fast_deep_equal = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJS
 	};
 })))(), 1);
 const isNullClause = (clause) => {
-	return (0, import_fast_deep_equal.default)(clause, getTableNullClause(clause.key));
+	const tableNullClause = getTableNullClause(clause.key);
+	return (0, import_fast_deep_equal.default)(clause, tableNullClause);
 };
 const createFilterPredicate = (filter) => {
-	const orGroups = filter.replaceAll(String.raw`(`, " ").replaceAll(String.raw`)`, "").split(/\s+and\s+/iu).filter(Boolean).map((group) => group.split(/\s+or\s+/iu).filter(Boolean));
+	const orGroups = filter.replaceAll(String.raw`(`, " ").replaceAll(String.raw`)`, "").split(/\s+and\s+/iu).filter(Boolean).map((group) => group.split(/\s+or\s+/iu).filter(Boolean).map((clauseString) => {
+		const clause = deserializeClause(clauseString);
+		return {
+			clause,
+			isNull: isNullClause(clause)
+		};
+	}));
 	return (document) => {
 		for (const orGroup of orGroups) {
 			let isGroupMatched = false;
-			for (const group of orGroup) {
-				const clause = deserializeClause(group);
+			for (const { clause, isNull } of orGroup) {
 				const value = takeOne(document, clause.key);
 				let isMatched;
-				if (isNullClause(clause)) isMatched = compare(BinaryOperator.eq, value, null);
+				if (isNull) isMatched = compare(BinaryOperator.eq, value, null);
 				else {
 					const comparisonResult = compare(clause.operator, value, clause.value);
 					isMatched = clause.not ? !comparisonResult : comparisonResult;
@@ -874,15 +879,22 @@ const compareValues = (leftHandSide, rightHandSide) => {
 	if (typeof left === "number" && typeof right === "number") return left - right;
 	return String(left).localeCompare(String(right));
 };
-const sortDocuments = (documents, orderBy) => [...documents].toSorted((leftHandSide, rightHandSide) => {
-	for (const clause of orderBy) {
+const sortDocuments = (documents, orderBy) => {
+	const parsedOrderBy = orderBy.map((clause) => {
 		const [field = "", direction = "asc"] = clause.split(/\s+/u);
-		const key = deserializeKey(field);
-		const comparison = compareValues(leftHandSide[key], rightHandSide[key]);
-		if (comparison !== 0) return direction === "desc" ? -comparison : comparison;
-	}
-	return 0;
-});
+		return {
+			direction,
+			key: deserializeKey(field)
+		};
+	});
+	return documents.toSorted((leftHandSide, rightHandSide) => {
+		for (const { direction, key } of parsedOrderBy) {
+			const comparison = compareValues(leftHandSide[key], rightHandSide[key]);
+			if (comparison !== 0) return direction === "desc" ? -comparison : comparison;
+		}
+		return 0;
+	});
+};
 const getSearchFieldValues = (value, pathSegments) => {
 	if (pathSegments.length === 0) return [value];
 	if (Array.isArray(value)) return value.flatMap((item) => getSearchFieldValues(item, pathSegments));
@@ -893,7 +905,8 @@ const getSearchFieldValues = (value, pathSegments) => {
 const searchDocuments = (documents, searchText, searchFields) => {
 	if (!searchText || searchText === "*") return documents;
 	const normalizedSearchText = searchText.toLocaleLowerCase();
-	return documents.filter((document) => (searchFields ?? Object.keys(document)).some((searchField) => getSearchFieldValues(document, searchField.split("/")).some((value) => value !== null && value !== void 0 && String(value).toLocaleLowerCase().includes(normalizedSearchText))));
+	const searchFieldPaths = searchFields?.map((searchField) => searchField.split("/"));
+	return documents.filter((document) => (searchFieldPaths ?? Object.keys(document).map((field) => field.split("/"))).some((pathSegments) => getSearchFieldValues(document, pathSegments).some((value) => typeof value === "string" && value.toLocaleLowerCase().includes(normalizedSearchText))));
 };
 /**
 * An in-memory mock of the Azure SearchClient.
@@ -1004,6 +1017,11 @@ var MockServiceBusSender = class {
 		return Promise.resolve();
 	}
 };
+const compareByCompositeKey = (a, b) => {
+	if (a.partitionKey !== b.partitionKey) return a.partitionKey < b.partitionKey ? -1 : 1;
+	else if (a.rowKey === b.rowKey) return 0;
+	else return a.rowKey < b.rowKey ? -1 : 1;
+};
 /**
 * An in-memory mock of the Azure TableClient.
 * It uses a Map to simulate table storage and correctly implements the TableClient interface.
@@ -1024,9 +1042,7 @@ var MockTableClient = class {
 		this.url = `${MOCK_TABLE_BASE_URL}/${this.tableName}`;
 	}
 	createEntity(entity) {
-		const key = this.#getCompositeKey(entity.partitionKey, entity.rowKey);
-		if (this.table.has(key)) throw new MockRestError("The specified entity already exists.", 409);
-		this.table.set(key, entity);
+		this.#applyCreate(entity);
 		return Promise.resolve({
 			date: /* @__PURE__ */ new Date(),
 			etag: this.#getEtag()
@@ -1036,9 +1052,7 @@ var MockTableClient = class {
 		throw new Error("Method not implemented.");
 	}
 	deleteEntity(partitionKey, rowKey) {
-		const key = this.#getCompositeKey(partitionKey, rowKey);
-		if (!this.table.has(key)) throw new MockRestError("The specified resource does not exist.", 404);
-		this.table.delete(key);
+		this.#applyDelete(partitionKey, rowKey);
 		return Promise.resolve({});
 	}
 	deleteTable() {
@@ -1053,7 +1067,7 @@ var MockTableClient = class {
 		if (!entity) throw new MockRestError("The specified resource does not exist.", 404);
 		return Promise.resolve({
 			...entity,
-			etag: this.#getEtag()
+			etag: entity.etag ?? this.#getEtag()
 		});
 	}
 	listEntities(options) {
@@ -1061,22 +1075,22 @@ var MockTableClient = class {
 		const filter = options?.queryOptions?.filter;
 		const tableEntities = [...this.table.values()];
 		const predicate = filter ? createFilterPredicate(filter) : void 0;
-		const resultTableEntities = predicate ? tableEntities.filter((e) => predicate(e)) : tableEntities;
+		const resultTableEntities = (predicate ? tableEntities.filter((e) => predicate(e)) : tableEntities).toSorted(compareByCompositeKey);
+		const entityIterator = (async function* (entities) {
+			for (const entity of entities) yield await Promise.resolve(withMetadata(entity));
+		})(resultTableEntities);
 		return {
 			byPage: ({ maxPageSize } = {}) => (async function* (entities) {
 				if (maxPageSize !== void 0 && maxPageSize <= 0) throw new RangeError("maxPageSize must be greater than 0.");
 				else if (maxPageSize !== void 0 && maxPageSize > AZURE_MAX_PAGE_SIZE) throw new MockRestError("One of the request inputs is not valid.", 400);
-				const allEntitiesWithMetadata = entities.map((e) => withMetadata(e));
-				if (allEntitiesWithMetadata.length === 0) return;
+				if (entities.length === 0) return;
 				else if (!maxPageSize) {
-					yield await Promise.resolve(allEntitiesWithMetadata);
+					yield await Promise.resolve(entities.map((e) => withMetadata(e)));
 					return;
 				}
-				for (let i = 0; i < allEntitiesWithMetadata.length; i += maxPageSize) yield await Promise.resolve(allEntitiesWithMetadata.slice(i, i + maxPageSize));
+				for (const page of chunk(entities, maxPageSize)) yield await Promise.resolve(page.map((e) => withMetadata(e)));
 			})(resultTableEntities),
-			next: () => (async function* (entities) {
-				for (const entity of entities) yield await Promise.resolve(withMetadata(entity));
-			})(resultTableEntities).next(),
+			next: () => entityIterator.next(),
 			[Symbol.asyncIterator]() {
 				return this;
 			}
@@ -1085,24 +1099,24 @@ var MockTableClient = class {
 	setAccessPolicy() {
 		throw new Error("Method not implemented.");
 	}
-	async submitTransaction(actions) {
+	submitTransaction(actions) {
 		let partitionKey;
 		for (const [, entity] of actions) if (partitionKey === void 0) partitionKey = entity.partitionKey;
 		else if (entity.partitionKey !== partitionKey) throw new MockRestError("All transaction actions must target the same partitionKey.", 400);
 		const snapshot = new Map(this.table);
-		await getResultAsync(async () => {
+		getResult(() => {
 			for (const [type, entity, updateMode] of actions) switch (type) {
 				case "create":
-					await this.createEntity(entity);
+					this.#applyCreate(entity);
 					break;
 				case "delete":
-					await this.deleteEntity(entity.partitionKey, entity.rowKey);
+					this.#applyDelete(entity.partitionKey, entity.rowKey);
 					break;
 				case "update":
-					await this.updateEntity(entity, updateMode);
+					this.#applyUpdate(entity, updateMode);
 					break;
 				case "upsert":
-					await this.upsertEntity(entity, updateMode);
+					this.#applyUpsert(entity, updateMode);
 					break;
 				default: exhaustiveGuard(type);
 			}
@@ -1112,57 +1126,77 @@ var MockTableClient = class {
 		}).match(noop, (error) => {
 			throw error;
 		});
-		return {
-			getResponseForEntity: noop,
+		return Promise.resolve({
+			getResponseForEntity: () => void 0,
 			status: 202,
 			subResponses: []
-		};
+		});
 	}
-	updateEntity(entity, mode = "Merge") {
+	updateEntity(entity, mode = "Merge", options) {
+		this.#applyUpdate(entity, mode, options?.etag);
+		return Promise.resolve({
+			date: /* @__PURE__ */ new Date(),
+			etag: this.#getEtag()
+		});
+	}
+	upsertEntity(entity, mode = "Merge") {
+		this.#applyUpsert(entity, mode);
+		return Promise.resolve({
+			date: /* @__PURE__ */ new Date(),
+			etag: this.#getEtag()
+		});
+	}
+	#applyCreate(entity) {
+		const key = this.#getCompositeKey(entity.partitionKey, entity.rowKey);
+		if (this.table.has(key)) throw new MockRestError("The specified entity already exists.", 409);
+		this.table.set(key, {
+			...entity,
+			etag: this.#getEtag()
+		});
+	}
+	#applyDelete(partitionKey, rowKey) {
+		const key = this.#getCompositeKey(partitionKey, rowKey);
+		if (!this.table.has(key)) throw new MockRestError("The specified resource does not exist.", 404);
+		this.table.delete(key);
+	}
+	#applyUpdate(entity, mode = "Merge", etag) {
 		const key = this.#getCompositeKey(entity.partitionKey, entity.rowKey);
 		const existingEntity = this.table.get(key);
 		if (!existingEntity) throw new MockRestError("The specified resource does not exist.", 404);
-		else if (mode === "Merge") return this.#mergeEntity(key, existingEntity, entity);
-		else {
-			this.table.set(key, entity);
-			return Promise.resolve({
-				date: /* @__PURE__ */ new Date(),
-				etag: this.#getEtag()
-			});
-		}
+		else if (etag !== void 0 && etag !== "*" && etag !== existingEntity.etag) throw new MockRestError("The update condition specified in the request was not satisfied.", 412);
+		else if (mode === "Merge") this.table.set(key, {
+			...existingEntity,
+			...entity,
+			etag: this.#getEtag()
+		});
+		else this.table.set(key, {
+			...entity,
+			etag: this.#getEtag()
+		});
 	}
-	upsertEntity(entity, mode = "Merge") {
+	#applyUpsert(entity, mode = "Merge") {
 		const key = this.#getCompositeKey(entity.partitionKey, entity.rowKey);
 		const existingEntity = this.table.get(key);
-		if (existingEntity && mode === "Merge") return this.#mergeEntity(key, existingEntity, entity);
-		else {
-			this.table.set(key, entity);
-			return Promise.resolve({
-				date: /* @__PURE__ */ new Date(),
-				etag: this.#getEtag()
-			});
-		}
+		if (existingEntity && mode === "Merge") this.table.set(key, {
+			...existingEntity,
+			...entity,
+			etag: this.#getEtag()
+		});
+		else this.table.set(key, {
+			...entity,
+			etag: this.#getEtag()
+		});
 	}
 	#getCompositeKey(partitionKey, rowKey) {
 		return `${partitionKey}${ID_SEPARATOR}${rowKey}`;
 	}
 	#getEtag() {
-		return `W/"datetime'${(/* @__PURE__ */ new Date()).toISOString()}'"`;
-	}
-	#mergeEntity(key, entity, entityToMerge) {
-		this.table.set(key, {
-			...entity,
-			...entityToMerge
-		});
-		return Promise.resolve({
-			date: /* @__PURE__ */ new Date(),
-			etag: this.#getEtag()
-		});
+		return `W/"${crypto.randomUUID()}"`;
 	}
 	#withMetadata(entity) {
 		return {
 			...entity,
-			etag: this.#getEtag()
+			etag: entity.etag ?? this.#getEtag()
 		};
 	}
 };
@@ -1179,4 +1213,4 @@ const applyFilter = (documents, clauses) => {
 	const predicate = createFilterPredicate(serializeClauses(clauses));
 	return documents.filter((document) => predicate(document));
 };
-export { MOCK_BLOB_BASE_URL, MOCK_QUEUE_BASE_URL, MOCK_SEARCH_BASE_URL, MOCK_TABLE_BASE_URL, MockBlobBatchClient, MockBlobClient, MockBlockBlobClient, MockContainerClient, MockContainerDatabase, MockEventGridDatabase, MockEventGridPublisherClient, MockQueueClient, MockQueueDatabase, MockRestError, MockSearchClient, MockSearchDatabase, MockServiceBusDatabase, MockServiceBusSender, MockTableClient, MockTableDatabase, MockWebPubSubServiceClient, applyFilter, bodyToBuffer, compare, createFilterPredicate, createMockResponse, getAzureErrorXml, getBlobItemXml, getBlobPrefixXml, getListBlobsXml, getMockSasUrl, isNullClause, isReadableStream, toWebResourceLike };
+export { BLOB_NOT_FOUND_ERROR_CODE, BLOB_NOT_FOUND_MESSAGE, MOCK_BLOB_BASE_URL, MOCK_BLOB_SEEDED_CREATED_ON, MOCK_QUEUE_BASE_URL, MOCK_SEARCH_BASE_URL, MOCK_TABLE_BASE_URL, MockBlobBatchClient, MockBlobClient, MockBlockBlobClient, MockContainerClient, MockContainerCreatedOnDatabase, MockContainerDatabase, MockEventGridDatabase, MockEventGridPublisherClient, MockQueueClient, MockQueueDatabase, MockRestError, MockSearchClient, MockSearchDatabase, MockServiceBusDatabase, MockServiceBusSender, MockTableClient, MockTableDatabase, MockWebPubSubServiceClient, applyFilter, bodyToBuffer, compare, compareByCompositeKey, createFilterPredicate, createMockResponse, getAzureErrorXml, getBlobItemXml, getBlobPrefixXml, getBlobUrl, getBlobUrlParts, getListBlobsSegmentResponse, getListBlobsXml, getMockContainer, getMockContainerCreatedOnKey, getMockQueueMessageItem, getMockSasUrl, isNullClause, isReadableStream, toWebResourceLike };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azure-mock",
-  "version": "2.35.0",
+  "version": "2.37.2",
   "description": "A library that contains azure mock classes.",
   "keywords": [
     "azure",
@@ -47,15 +47,15 @@
     "typecheck": "tsgo"
   },
   "dependencies": {
-    "@esposter/db": "2.35.0",
-    "@esposter/db-schema": "2.35.0",
-    "@esposter/shared": "2.35.0",
+    "@esposter/db": "2.37.2",
+    "@esposter/db-schema": "2.37.2",
+    "@esposter/shared": "2.37.2",
     "fast-deep-equal": "^3.1.3"
   },
   "devDependencies": {
-    "@esposter/configuration": "2.35.0",
-    "ctix": "^2.8.1",
-    "rolldown": "^1.1.5",
+    "@esposter/configuration": "2.37.2",
+    "ctix": "^2.8.2",
+    "rolldown": "^1.2.4",
     "type-fest": "^5.8.0",
     "typedoc": "^0.28.20",
     "vitest": "^4.1.10"
@@ -70,5 +70,5 @@
     "@azure/storage-blob": "^12.33.0",
     "@azure/storage-queue": "^12.31.0"
   },
-  "gitHead": "3cd4a45d586379867ceba91c23052d755d95ff8f"
+  "gitHead": "4d775dbd8289e6caaee48f08038b65fddb4babbc"
 }