azure-mock 4.3.3 → 4.5.0

package/README.md

@@ -5,43 +5,26 @@
 [![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, Service Bus, and EventGrid clients that mirror the real Azure SDK interfaces.
+It provides mock Azure service classes for local development and testing. They are in-memory implementations of the Azure Table Storage, Blob Storage, Service Bus and EventGrid clients, and they mirror the real Azure SDK interfaces.
+
+Design notes live in [the specs](https://github.com/Esposter/Esposter/tree/main/openspec/specs).
 
 ## Table of Contents
 
 - 🚀 [Getting Started](#getting-started)
-- 📖 [Documentation](#documentation)
+- 🧩 [Key Exports](#key-exports)
 - ⚖️ [License](#license)
 
 ---
 
 ## <a name="getting-started">🚀 Getting Started</a>
 
+Install the package and its Azure peer packages as dev dependencies:
+
 ```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
+pnpm i -D azure-mock @azure/core-http-compat @azure/core-rest-pipeline @azure/data-tables @azure/eventgrid @azure/search-documents @azure/service-bus @azure/storage-blob @azure/storage-queue
 ```
 
-## <a name="documentation">📖 Documentation</a>
-
-We highly recommend you take a look at the [documentation](https://github.com/Esposter/Esposter/tree/main/openspec/specs) to level up.
-
-### Available Mocks
-
-| 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
 
 ```ts
@@ -53,18 +36,24 @@ await mockTableClient.upsertEntity({ partitionKey: "pk", rowKey: "rk", value: 42
 const entity = await mockTableClient.getEntity("pk", "rk");
 ```
 
-Replace real Azure clients with their mock equivalents by swapping them in your test setup or local `.env` configuration.
+Replace each real Azure client with its mock equivalent. Make the replacement in your test setup or in your local `.env` configuration.
 
-### Commands
+## <a name="key-exports">🧩 Key Exports</a>
 
-Run from `packages/azure-mock/`:
+| Class                          | Azure Equivalent           | Description                                                                                |
+| ------------------------------ | -------------------------- | ------------------------------------------------------------------------------------------ |
+| `MockBlobBatchClient`          | `BlobBatchClient`          | In-memory batched blob deletion                                                            |
+| `MockBlobClient`               | `BlobClient`               | In-memory blob read, copy and delete                                                       |
+| `MockBlockBlobClient`          | `BlockBlobClient`          | In-memory block blob upload and download                                                   |
+| `MockContainerClient`          | `ContainerClient`          | In-memory blob container, listing and paging                                               |
+| `MockEventGridPublisherClient` | `EventGridPublisherClient` | In-memory EventGrid publisher                                                              |
+| `MockQueueClient`              | `QueueClient`              | In-memory Azure Storage Queue                                                              |
+| `MockSearchClient`             | `SearchClient`             | In-memory Azure AI Search index                                                            |
+| `MockServiceBusSender`         | `ServiceBusSender`         | In-memory Azure Service Bus                                                                |
+| `MockTableClient`              | `TableClient`              | In-memory Azure Table Storage                                                              |
+| `MockWebPubSubServiceClient`   | `WebPubSubServiceClient`   | In-memory group membership: `group().addUser` and `removeUser`; `sendToAll` reaches nobody |
 
-```bash
-pnpm build        # compile to dist/
-pnpm test         # vitest watch mode (coverage is run from the repo root)
-pnpm lint:fix     # auto-fix lint
-pnpm typecheck    # type check
-```
+Each client stores its state in an exported `Mock*Database` map, such as `MockTableDatabase` or `MockContainerDatabase`. To reset a test, clear the map that the test seeded.
 
 ## <a name="license">⚖️ License</a>
 

package/dist/index.d.ts

@@ -1,20 +1,13 @@
 import { HttpHeadersLike, WebResourceLike } from "@azure/core-http-compat";
 import { PipelineRequest, RestError } 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, 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, Metadata, PageBlobClient, PollOperationState, PollerLikeWithCancellation, StorageSharedKeyCredential } from "@azure/storage-blob";
 import { BinaryOperator, Clause } from "@esposter/azure";
+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, BlockBlobUploadStreamOptions, ContainerClient, ContainerCreateIfNotExistsResponse, ContainerCreateResponse, ContainerDeleteIfExistsResponse, ContainerDeleteResponse, ContainerFindBlobsByTagsSegmentResponse, ContainerGenerateSasUrlOptions, ContainerGetAccessPolicyResponse, ContainerGetAccountInfoResponse, ContainerGetPropertiesResponse, ContainerListBlobFlatSegmentResponse, ContainerListBlobHierarchySegmentResponse, ContainerListBlobsOptions, ContainerSetAccessPolicyResponse, ContainerSetMetadataResponse, FilterBlobItem, HttpRequestBody, Metadata, PageBlobClient, PollOperationState, PollerLikeWithCancellation, StorageSharedKeyCredential } from "@azure/storage-blob";
+import { Readable } from "node:stream";
 import { EventGridEvent, EventGridPublisherClient } from "@azure/eventgrid";
 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";
 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";
-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 CONDITION_NOT_MET_ERROR_CODE = "ConditionNotMet";
-export declare const CONDITION_NOT_MET_MESSAGE = "The condition specified using HTTP conditional header(s) is not met.";
-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 type BlobHierarchyItem = (BlobItem & {
   kind: "blob";
 }) | (BlobPrefix & {
@@ -769,6 +762,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>> : {});
 export declare class MockBlobClient implements Except<BlobClient, "accountName"> {
+  #private;
   connectionString: string;
   containerName: string;
   credential: AnonymousCredential;
@@ -779,8 +773,8 @@ export declare class MockBlobClient implements Except<BlobClient, "accountName">
   abortCopyFromURL(): Promise<BlobAbortCopyFromURLResponse>;
   beginCopyFromURL(copySource: string): Promise<PollerLikeWithCancellation<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>;
   createSnapshot(): Promise<BlobCreateSnapshotResponse>;
-  delete(): Promise<BlobDeleteResponse>;
-  deleteIfExists(): Promise<BlobDeleteIfExistsResponse>;
+  delete(options?: BlobDeleteOptions): Promise<BlobDeleteResponse>;
+  deleteIfExists(options?: BlobDeleteOptions): Promise<BlobDeleteIfExistsResponse>;
   deleteImmutabilityPolicy(): Promise<BlobDeleteImmutabilityPolicyResponse>;
   download(): Promise<BlobDownloadResponseParsed>;
   downloadToBuffer(): Promise<Buffer>;
@@ -824,7 +818,7 @@ export declare class MockBlockBlobClient extends MockBlobClient implements Excep
   uploadBrowserData(): Promise<BlobUploadCommonResponse>;
   uploadData(): Promise<BlobUploadCommonResponse>;
   uploadFile(): Promise<BlobUploadCommonResponse>;
-  uploadStream(): Promise<BlobUploadCommonResponse>;
+  uploadStream(stream: Readable, _bufferSize?: number, _maxConcurrency?: number, options?: BlockBlobUploadStreamOptions): Promise<BlobUploadCommonResponse>;
 }
 /**
  * An interface that tracks the settings for paged iteration
@@ -924,6 +918,7 @@ export declare const MockQueueDatabase: Map<string, string[]>;
  * const messages = await mockQueueClient.peekMessages();
  */
 export declare class MockQueueClient implements Except<QueueClient, "accountName"> {
+  #private;
   connectionString: string;
   name: string;
   url: string;
@@ -1045,18 +1040,31 @@ export declare class MockTableClient<TEntity extends TableEntity = TableEntity>
   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.
+ * A minimal in-memory mock of the Azure WebPubSubServiceClient — no service and no network.
+ * A group's members are the user ids added to it, and `sendToAll` reaches nobody, since no connection is held.
  */
 export declare class MockWebPubSubServiceClient {
-  group(_groupName: string): {
+  group(groupName: string): {
+    addUser: (userId: string) => Promise<void>;
+    removeUser: (userId: string) => Promise<void>;
     sendToAll: () => Promise<void>;
   };
 }
+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 CONDITION_NOT_MET_ERROR_CODE = "ConditionNotMet";
+export declare const CONDITION_NOT_MET_MESSAGE = "The condition specified using HTTP conditional header(s) is not met.";
+export declare const INVALID_INPUT_MESSAGE = "One of the request inputs is not valid.";
+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 declare const assertMockBlobIfMatch: (containerName: string, blobName: string, ifMatch: string | undefined) => void;
 export declare const bodyToBuffer: (body: HttpRequestBody) => Promise<Buffer>;
 export declare const checkIsReadableStream: (value: unknown) => value is NodeJS.ReadableStream;
 export declare const MOCK_BLOB_SEEDED_DATE: Date;
 export declare const MOCK_BLOB_SEEDED_PROPERTIES: MockBlobDates;
+export declare const decodeSegment: (segment: string) => string;
 export declare const deleteMockBlob: (containerName: string, blobName: string) => boolean;
 /**
  * Generates a standard Azure Storage error XML response body.
@@ -1097,12 +1105,18 @@ export declare const getMockQueueMessageItem: (messageText: string) => {
   messageId: string;
   messageText: string;
 };
+export declare const compareValues: (firstValue: unknown, secondValue: unknown) => number;
+export declare const getSearchFieldValues: (value: unknown, pathSegments: string[]) => unknown[];
+export declare const searchDocuments: (documents: Record<string, unknown>[], searchText: string | undefined, searchFields: readonly string[] | undefined) => Record<string, unknown>[];
+export declare const sortDocuments: (documents: Record<string, unknown>[], orderBy: string[]) => Record<string, unknown>[];
+export declare const toComparable: (value: unknown) => number | string;
 export declare const createMockResponse: (status: number, url?: string) => MockResponse;
 export declare const getMockSasUrl: (url: string, permissions: undefined | {
   toString: () => string;
-}, resourceType?: string) => string;
+}, resourceType?: string, expiresOn?: Date) => string;
 export declare const compareByCompositeKey: (firstEntity: TableEntity, secondEntity: TableEntity) => number;
 export declare const MockContainerBlobDatesDatabase: Map<string, MockBlobDates>;
 export declare const MockContainerBlobMetadataDatabase: Map<string, Record<string, string>>;
 export declare const MockEventGridDatabase: Map<string, EventGridEvent<unknown>[]>;
+export declare const MockWebPubSubDatabase: Map<string, Set<string>>;
 export {};

package/dist/index.js

@@ -1,25 +1,26 @@
 import { ID_SEPARATOR, InvalidOperationError, Operation, checkIsDeepEqual, chunk, exhaustiveGuard, getDecodedUriComponent, getOrCreate, getResult, html, noop, streamToText, takeOne } from "@esposter/shared";
 import { toHttpHeadersLike } from "@azure/core-http-compat";
 import { RestError, createHttpHeaders, createPipelineRequest } from "@azure/core-rest-pipeline";
+import { AZURE_MAX_BATCH_SIZE, AZURE_MAX_PAGE_SIZE, AZURE_MAX_QUEUE_VISIBILITY_TIMEOUT_MS, BinaryOperator, MAX_BLOB_BATCH_DELETIONS, MAX_EVENT_GRID_PUBLISH_EVENT_COUNT, MAX_EVENT_GRID_PUBLISH_REQUEST_BYTES, deserializeClause, deserializeKey, getTableNullClause, serializeClauses } from "@esposter/azure";
 import { AnonymousCredential } from "@azure/storage-blob";
 import { Readable } from "node:stream";
-import { AZURE_MAX_PAGE_SIZE, AZURE_MAX_QUEUE_VISIBILITY_TIMEOUT_MS, BinaryOperator, deserializeClause, deserializeKey, getTableNullClause, serializeClauses } from "@esposter/azure";
-// src/constants.ts
+// src/models/shared/NotImplementedError.ts
+var NotImplementedError = class extends Error {
+	constructor(name) {
+		super(`${name} is not implemented in the mock`);
+		this.name = "NotImplementedError";
+	}
+};
+// src/services/constants.ts
 const BLOB_NOT_FOUND_ERROR_CODE = "BlobNotFound";
 const BLOB_NOT_FOUND_MESSAGE = "The specified blob does not exist.";
 const CONDITION_NOT_MET_ERROR_CODE = "ConditionNotMet";
 const CONDITION_NOT_MET_MESSAGE = "The condition specified using HTTP conditional header(s) is not met.";
+const INVALID_INPUT_MESSAGE = "One of the request inputs is not valid.";
 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";
-// src/models/shared/NotImplementedError.ts
-var NotImplementedError = class extends Error {
-	constructor(name) {
-		super(`${name} is not implemented in the mock`);
-		this.name = "NotImplementedError";
-	}
-};
 // src/services/container/getMockBlobKey.ts
 const getMockBlobKey = (containerName, blobName) => `${encodeURIComponent(containerName)}${ID_SEPARATOR}${encodeURIComponent(blobName)}`;
 // src/store/MockContainerBlobDatesDatabase.ts
@@ -62,15 +63,16 @@ const getAzureErrorXml = (errorCode, errorMessage) => html`<?xml version="1.0" e
       <code>${errorCode}</code>
       <Message>${errorMessage}</Message>
     </Error>`;
-// src/services/container/getBlobUrlParts.ts
+// src/services/container/decodeSegment.ts
 const decodeSegment = (segment) => getDecodedUriComponent(segment, segment);
+// src/services/container/getBlobUrlParts.ts
 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("/")),
+		blobName: pathSegments.slice(1).map((segment) => decodeSegment(segment)).join("/"),
 		containerName: decodeSegment(takeOne(pathSegments))
 	};
 };
@@ -132,6 +134,7 @@ var MockBlobBatchClient = class {
 		const { ifUnmodifiedSince, ...unsupportedConditions } = options?.conditions ?? {};
 		const unsupportedConditionName = Object.entries(unsupportedConditions).find(([, value]) => value !== void 0)?.[0];
 		if (unsupportedConditionName !== void 0) return Promise.reject(new NotImplementedError(`deleteBlobs with ${unsupportedConditionName}`));
+		if (urls.length > MAX_BLOB_BATCH_DELETIONS) return Promise.reject(/* @__PURE__ */ new RangeError(`Cannot exceed ${MAX_BLOB_BATCH_DELETIONS} sub requests in a single batch`));
 		const subResponses = [];
 		let subResponsesSucceededCount = 0;
 		let subResponsesFailedCount = 0;
@@ -204,6 +207,11 @@ var MockRestError = class extends RestError {
 		this.name = "MockRestError";
 	}
 };
+// src/services/container/assertMockBlobIfMatch.ts
+const assertMockBlobIfMatch = (containerName, blobName, ifMatch) => {
+	if (ifMatch === void 0) return;
+	if (ifMatch !== (getMockContainer(containerName).has(blobName) ? readMockBlobDates(containerName, blobName).etag : void 0)) throw new MockRestError(CONDITION_NOT_MET_MESSAGE, 412);
+};
 // src/services/container/getBlobUrl.ts
 const getBlobUrl = (containerName, blobName) => `${MOCK_BLOB_BASE_URL}/${containerName}/${blobName.split("/").map((segment) => encodeURIComponent(segment)).join("/")}`;
 // src/services/container/storeMockBlobWrite.ts
@@ -217,7 +225,8 @@ const storeMockBlobWrite = (containerName, blobName, isExisting) => {
 	});
 };
 // src/services/shared/getMockSasUrl.ts
-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 MOCK_SAS_FAR_FUTURE_EXPIRY = /* @__PURE__ */ new Date("2099-12-31T23:59:59Z");
+const getMockSasUrl = (url, permissions, resourceType, expiresOn = MOCK_SAS_FAR_FUTURE_EXPIRY) => `${url}?sv=2025-11-05&${resourceType ? `sr=${resourceType}&` : ""}sig=mock-signature&st=1970-01-01T00:00:00Z&se=${expiresOn.toISOString().replace(/\.\d{3}Z$/u, "Z")}&sp=${permissions?.toString() ?? "r"}`;
 // src/models/container/MockBlobClient.ts
 var MockBlobClient = class {
 	connectionString;
@@ -266,12 +275,12 @@ var MockBlobClient = class {
 	createSnapshot() {
 		throw new NotImplementedError(this.createSnapshot.name);
 	}
-	delete() {
-		if (!deleteMockBlob(this.containerName, this.name)) throw new MockRestError(BLOB_NOT_FOUND_MESSAGE, 404);
+	delete(options) {
+		if (!this.#deleteIfPresent(options?.conditions?.ifMatch)) throw new MockRestError(BLOB_NOT_FOUND_MESSAGE, 404);
 		return Promise.resolve({ _response: createMockResponse(200) });
 	}
-	deleteIfExists() {
-		const succeeded = deleteMockBlob(this.containerName, this.name);
+	deleteIfExists(options) {
+		const succeeded = this.#deleteIfPresent(options?.conditions?.ifMatch);
 		return Promise.resolve({
 			_response: createMockResponse(succeeded ? 200 : 404),
 			succeeded
@@ -304,7 +313,7 @@ var MockBlobClient = class {
 		throw new NotImplementedError(this.generateSasStringToSign.name);
 	}
 	generateSasUrl(options) {
-		return Promise.resolve(getMockSasUrl(this.url, options.permissions, "b"));
+		return Promise.resolve(getMockSasUrl(this.url, options.permissions, "b", options.expiresOn));
 	}
 	generateUserDelegationSasStringToSign() {
 		throw new NotImplementedError(this.generateUserDelegationSasStringToSign.name);
@@ -375,6 +384,11 @@ var MockBlobClient = class {
 	withVersion() {
 		throw new NotImplementedError(this.withVersion.name);
 	}
+	#deleteIfPresent(ifMatch) {
+		if (!this.container.has(this.name)) return false;
+		assertMockBlobIfMatch(this.containerName, this.name, ifMatch);
+		return deleteMockBlob(this.containerName, this.name);
+	}
 };
 // src/services/container/checkIsReadableStream.ts
 const checkIsReadableStream = (value) => value instanceof Readable;
@@ -429,7 +443,7 @@ var MockBlockBlobClient = class extends MockBlobClient {
 	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);
-		if (options?.conditions?.ifMatch !== void 0 && options.conditions.ifMatch !== (this.container.has(this.name) ? readMockBlobDates(this.containerName, this.name).etag : void 0)) throw new MockRestError("The condition specified using HTTP conditional header(s) is not met.", 412);
+		assertMockBlobIfMatch(this.containerName, this.name, options?.conditions?.ifMatch);
 		storeMockBlobWrite(this.containerName, this.name, this.container.has(this.name));
 		storeMockBlobMetadata(this.containerName, this.name, options?.metadata);
 		this.container.set(this.name, buffer);
@@ -448,8 +462,10 @@ var MockBlockBlobClient = class extends MockBlobClient {
 	uploadFile() {
 		throw new NotImplementedError(this.uploadFile.name);
 	}
-	uploadStream() {
-		throw new NotImplementedError(this.uploadStream.name);
+	async uploadStream(stream, _bufferSize, _maxConcurrency, options) {
+		const chunks = [];
+		for await (const chunk of stream) chunks.push(chunk);
+		return this.upload(Buffer.concat(chunks), 0, options);
 	}
 };
 // src/services/container/getBlobItemXml.ts
@@ -548,7 +564,7 @@ var MockContainerClient = class {
 		throw new NotImplementedError(this.generateSasStringToSign.name);
 	}
 	generateSasUrl(options) {
-		return Promise.resolve(getMockSasUrl(this.url, options.permissions, "c"));
+		return Promise.resolve(getMockSasUrl(this.url, options.permissions, "c", options.expiresOn));
 	}
 	generateUserDelegationSasStringToSign() {
 		throw new NotImplementedError(this.generateUserDelegationSasStringToSign.name);
@@ -707,6 +723,7 @@ var MockEventGridPublisherClient = class {
 		this.inputSchema = topicType;
 	}
 	send(newEvents) {
+		if (newEvents.length > MAX_EVENT_GRID_PUBLISH_EVENT_COUNT || Buffer.byteLength(JSON.stringify(newEvents)) > MAX_EVENT_GRID_PUBLISH_REQUEST_BYTES) throw new MockRestError("The publish request exceeds the Event Grid publish limits.", 413);
 		getOrCreate(MockEventGridDatabase, this.endpointUrl, () => []).push(...newEvents);
 		return Promise.resolve();
 	}
@@ -770,7 +787,7 @@ var MockQueueClient = class {
 		throw new NotImplementedError(this.generateSasStringToSign.name);
 	}
 	generateSasUrl(options) {
-		return getMockSasUrl(this.url, options.permissions);
+		return getMockSasUrl(this.url, options.permissions, void 0, options.expiresOn);
 	}
 	generateUserDelegationSasUrl() {
 		throw new NotImplementedError(this.generateUserDelegationSasUrl.name);
@@ -796,11 +813,7 @@ var MockQueueClient = class {
 			...getMockQueueMessageItem(text)
 		}));
 		return Promise.resolve({
-			_response: {
-				...createMockResponse(200, this.url),
-				bodyAsText: "",
-				parsedBody: peekedMessageItems
-			},
+			_response: this.#createResponse(peekedMessageItems),
 			peekedMessageItems
 		});
 	}
@@ -813,11 +826,7 @@ var MockQueueClient = class {
 			popReceipt: crypto.randomUUID()
 		}));
 		return Promise.resolve({
-			_response: {
-				...createMockResponse(200, this.url),
-				bodyAsText: "",
-				parsedBody: receivedMessageItems
-			},
+			_response: this.#createResponse(receivedMessageItems),
 			receivedMessageItems
 		});
 	}
@@ -833,11 +842,7 @@ var MockQueueClient = class {
 		};
 		const enqueuedMessages = [enqueuedMessage];
 		return Promise.resolve({
-			_response: {
-				...createMockResponse(200, this.url),
-				bodyAsText: "",
-				parsedBody: enqueuedMessages
-			},
+			_response: this.#createResponse(enqueuedMessages),
 			...enqueuedMessage
 		});
 	}
@@ -850,6 +855,13 @@ var MockQueueClient = class {
 	updateMessage() {
 		throw new NotImplementedError(this.updateMessage.name);
 	}
+	#createResponse(parsedBody) {
+		return {
+			...createMockResponse(200, this.url),
+			bodyAsText: "",
+			parsedBody
+		};
+	}
 };
 // src/services/filter/checkIsNullClause.ts
 const checkIsNullClause = (clause) => {
@@ -877,9 +889,16 @@ const compare = (operator, leftHandSide, rightHandSide) => {
 	}
 };
 // src/services/filter/createFilterPredicate.ts
+const LITERAL_REGEX = /'(?:[^']|'')*'/gu;
+const LITERAL_PLACEHOLDER = "";
+const LITERAL_PLACEHOLDER_REGEX = new RegExp(`${LITERAL_PLACEHOLDER}(\\d+)${LITERAL_PLACEHOLDER}`, "gu");
 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).map((clauseString) => {
-		const clause = deserializeClause(clauseString);
+	const literals = [];
+	const orGroups = filter.replaceAll(LITERAL_REGEX, (literal) => {
+		literals.push(literal);
+		return `${LITERAL_PLACEHOLDER}${literals.length - 1}${LITERAL_PLACEHOLDER}`;
+	}).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.replaceAll(LITERAL_PLACEHOLDER_REGEX, (_placeholder, index) => takeOne(literals, Number(index))));
 		return {
 			clause,
 			isNull: checkIsNullClause(clause)
@@ -906,20 +925,36 @@ const createFilterPredicate = (filter) => {
 		return true;
 	};
 };
-// src/store/MockSearchDatabase.ts
-const MockSearchDatabase = /* @__PURE__ */ new Map();
-// src/models/search/MockSearchClient.ts
+// src/services/search/getSearchFieldValues.ts
+const getSearchFieldValues = (value, pathSegments) => {
+	if (pathSegments.length === 0) return [value];
+	else if (Array.isArray(value)) return value.flatMap((item) => getSearchFieldValues(item, pathSegments));
+	else if (typeof value === "object" && value !== null) {
+		const [field = "", ...remainingPathSegments] = pathSegments;
+		return getSearchFieldValues(value[deserializeKey(field)], remainingPathSegments);
+	} else return [];
+};
+// src/services/search/searchDocuments.ts
+const searchDocuments = (documents, searchText, searchFields) => {
+	if (!searchText || searchText === "*") return documents;
+	const normalizedSearchText = searchText.toLocaleLowerCase();
+	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))));
+};
+// src/services/search/toComparable.ts
 const toComparable = (value) => {
 	if (value instanceof Date) return value.getTime();
 	else if (typeof value === "number" || typeof value === "string") return value;
 	else return String(value);
 };
+// src/services/search/compareValues.ts
 const compareValues = (firstValue, secondValue) => {
 	const firstComparable = toComparable(firstValue);
 	const secondComparable = toComparable(secondValue);
 	if (typeof firstComparable === "number" && typeof secondComparable === "number") return firstComparable - secondComparable;
 	else return String(firstComparable).localeCompare(String(secondComparable));
 };
+// src/services/search/sortDocuments.ts
 const sortDocuments = (documents, orderBy) => {
 	const parsedOrderBy = orderBy.map((clause) => {
 		const [field = "", direction = "asc"] = clause.split(/\s+/u);
@@ -936,20 +971,9 @@ const sortDocuments = (documents, orderBy) => {
 		return 0;
 	});
 };
-const getSearchFieldValues = (value, pathSegments) => {
-	if (pathSegments.length === 0) return [value];
-	else if (Array.isArray(value)) return value.flatMap((item) => getSearchFieldValues(item, pathSegments));
-	else if (typeof value === "object" && value !== null) {
-		const [field = "", ...remainingPathSegments] = pathSegments;
-		return getSearchFieldValues(value[deserializeKey(field)], remainingPathSegments);
-	} else return [];
-};
-const searchDocuments = (documents, searchText, searchFields) => {
-	if (!searchText || searchText === "*") return documents;
-	const normalizedSearchText = searchText.toLocaleLowerCase();
-	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))));
-};
+// src/store/MockSearchDatabase.ts
+const MockSearchDatabase = /* @__PURE__ */ new Map();
+// src/models/search/MockSearchClient.ts
 /**
 * An in-memory mock of the Azure SearchClient — no emulator and no network. It applies the same OData filtering
 * as the other mock clients, so a query behaves the same here as it does against the service.
@@ -1013,7 +1037,12 @@ var MockSearchClient = class {
 		throw new NotImplementedError(this.suggest.name);
 	}
 	uploadDocuments(documents, _options) {
-		this.documents.push(...documents);
+		for (const document of documents) {
+			const key = document.rowKey;
+			const index = this.documents.findIndex((existingDocument) => existingDocument.rowKey === key);
+			if (index === -1) this.documents.push(document);
+			else this.documents[index] = document;
+		}
 		return Promise.resolve({ results: [] });
 	}
 };
@@ -1110,8 +1139,7 @@ var MockTableClient = class {
 	}
 	getEntity(partitionKey, rowKey) {
 		const key = this.#getCompositeKey(partitionKey, rowKey);
-		const entity = this.table.get(key);
-		if (!entity) throw new MockRestError("The specified resource does not exist.", 404);
+		const entity = this.#getExistingEntity(key);
 		return Promise.resolve({
 			...entity,
 			etag: entity.etag ?? this.#getEtag()
@@ -1129,7 +1157,7 @@ var MockTableClient = class {
 		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);
+				else if (maxPageSize !== void 0 && maxPageSize > AZURE_MAX_PAGE_SIZE) throw new MockRestError(INVALID_INPUT_MESSAGE, 400);
 				if (entities.length === 0) return;
 				else if (!maxPageSize) {
 					yield await Promise.resolve(entities.map((entity) => withMetadata(entity)));
@@ -1147,6 +1175,7 @@ var MockTableClient = class {
 		throw new NotImplementedError(this.setAccessPolicy.name);
 	}
 	submitTransaction(actions) {
+		if (actions.length > AZURE_MAX_BATCH_SIZE) throw new MockRestError(INVALID_INPUT_MESSAGE, 400);
 		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);
@@ -1203,15 +1232,13 @@ var MockTableClient = class {
 	}
 	#applyDelete(partitionKey, rowKey, etag) {
 		const key = this.#getCompositeKey(partitionKey, rowKey);
-		const existingEntity = this.table.get(key);
-		if (!existingEntity) throw new MockRestError("The specified resource does not exist.", 404);
+		const existingEntity = this.#getExistingEntity(key);
 		this.#assertEtag(existingEntity.etag, etag);
 		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);
+		const existingEntity = this.#getExistingEntity(key);
 		this.#assertEtag(existingEntity.etag, etag);
 		this.#writeEntity(key, entity, mode, existingEntity);
 	}
@@ -1229,6 +1256,11 @@ var MockTableClient = class {
 	#getEtag() {
 		return `W/"${crypto.randomUUID()}"`;
 	}
+	#getExistingEntity(key) {
+		const entity = this.table.get(key);
+		if (!entity) throw new MockRestError("The specified resource does not exist.", 404);
+		return entity;
+	}
 	#withMetadata(entity) {
 		return {
 			...entity,
@@ -1247,14 +1279,27 @@ var MockTableClient = class {
 		});
 	}
 };
+// src/store/MockWebPubSubDatabase.ts
+const MockWebPubSubDatabase = /* @__PURE__ */ new Map();
 // src/models/webPubSub/MockWebPubSubServiceClient.ts
 /**
-* A minimal mock of the Azure WebPubSubServiceClient for testing purposes.
-* Only implements `group().sendToAll` — the only method used in azure-functions tests.
+* A minimal in-memory mock of the Azure WebPubSubServiceClient — no service and no network.
+* A group's members are the user ids added to it, and `sendToAll` reaches nobody, since no connection is held.
 */
 var MockWebPubSubServiceClient = class {
-	group(_groupName) {
-		return { sendToAll: () => Promise.resolve() };
+	group(groupName) {
+		const getMembers = () => getOrCreate(MockWebPubSubDatabase, groupName, () => /* @__PURE__ */ new Set());
+		return {
+			addUser: (userId) => {
+				getMembers().add(userId);
+				return Promise.resolve();
+			},
+			removeUser: (userId) => {
+				getMembers().delete(userId);
+				return Promise.resolve();
+			},
+			sendToAll: () => Promise.resolve()
+		};
 	}
 };
 // src/services/filter/applyFilter.ts
@@ -1262,4 +1307,4 @@ const applyFilter = (documents, clauses) => {
 	const predicate = createFilterPredicate(serializeClauses(clauses));
 	return documents.filter((document) => predicate(document));
 };
-export { BLOB_NOT_FOUND_ERROR_CODE, BLOB_NOT_FOUND_MESSAGE, CONDITION_NOT_MET_ERROR_CODE, CONDITION_NOT_MET_MESSAGE, MOCK_BLOB_BASE_URL, MOCK_BLOB_SEEDED_DATE, MOCK_BLOB_SEEDED_PROPERTIES, MOCK_QUEUE_BASE_URL, MOCK_SEARCH_BASE_URL, MOCK_TABLE_BASE_URL, MockBlobBatchClient, MockBlobClient, MockBlockBlobClient, MockContainerBlobDatesDatabase, MockContainerBlobMetadataDatabase, MockContainerClient, MockContainerDatabase, MockEventGridDatabase, MockEventGridPublisherClient, MockQueueClient, MockQueueDatabase, MockRestError, MockSearchClient, MockSearchDatabase, MockServiceBusDatabase, MockServiceBusSender, MockTableClient, MockTableDatabase, MockWebPubSubServiceClient, NotImplementedError, applyFilter, bodyToBuffer, checkIsNullClause, checkIsReadableStream, compare, compareByCompositeKey, createFilterPredicate, createMockResponse, deleteMockBlob, getAzureErrorXml, getBlobItemXml, getBlobPrefixXml, getBlobUrl, getBlobUrlParts, getListBlobsSegmentResponse, getListBlobsXml, getMockBlobKey, getMockContainer, getMockQueueMessageItem, getMockSasUrl, readMockBlobDates, readMockBlobMetadata, storeMockBlobMetadata, storeMockBlobWrite, toWebResourceLike };
+export { BLOB_NOT_FOUND_ERROR_CODE, BLOB_NOT_FOUND_MESSAGE, CONDITION_NOT_MET_ERROR_CODE, CONDITION_NOT_MET_MESSAGE, INVALID_INPUT_MESSAGE, MOCK_BLOB_BASE_URL, MOCK_BLOB_SEEDED_DATE, MOCK_BLOB_SEEDED_PROPERTIES, MOCK_QUEUE_BASE_URL, MOCK_SEARCH_BASE_URL, MOCK_TABLE_BASE_URL, MockBlobBatchClient, MockBlobClient, MockBlockBlobClient, MockContainerBlobDatesDatabase, MockContainerBlobMetadataDatabase, MockContainerClient, MockContainerDatabase, MockEventGridDatabase, MockEventGridPublisherClient, MockQueueClient, MockQueueDatabase, MockRestError, MockSearchClient, MockSearchDatabase, MockServiceBusDatabase, MockServiceBusSender, MockTableClient, MockTableDatabase, MockWebPubSubDatabase, MockWebPubSubServiceClient, NotImplementedError, applyFilter, assertMockBlobIfMatch, bodyToBuffer, checkIsNullClause, checkIsReadableStream, compare, compareByCompositeKey, compareValues, createFilterPredicate, createMockResponse, decodeSegment, deleteMockBlob, getAzureErrorXml, getBlobItemXml, getBlobPrefixXml, getBlobUrl, getBlobUrlParts, getListBlobsSegmentResponse, getListBlobsXml, getMockBlobKey, getMockContainer, getMockQueueMessageItem, getMockSasUrl, getSearchFieldValues, readMockBlobDates, readMockBlobMetadata, searchDocuments, sortDocuments, storeMockBlobMetadata, storeMockBlobWrite, toComparable, toWebResourceLike };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azure-mock",
-  "version": "4.3.3",
+  "version": "4.5.0",
   "description": "A library that contains azure mock classes.",
   "keywords": [
     "azure",
@@ -48,15 +48,15 @@
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
     "test": "vitest",
-    "typecheck": "tsc"
+    "typecheck": "tsrs --fast"
   },
   "dependencies": {
-    "@esposter/azure": "4.3.3",
-    "@esposter/shared": "4.3.3"
+    "@esposter/azure": "4.5.0",
+    "@esposter/shared": "4.5.0"
   },
   "devDependencies": {
-    "@esposter/configuration": "4.3.3",
-    "tsdown": "^0.23.1",
+    "@esposter/configuration": "4.5.0",
+    "tsdown": "^0.23.5",
     "type-fest": "^5.10.0"
   },
   "peerDependencies": {
@@ -72,5 +72,5 @@
   "inlinedDependencies": {
     "type-fest": "5.10.0"
   },
-  "gitHead": "955bbc130ad9b28877fd4ae8efc73a045141ce01"
+  "gitHead": "e30c001f3b4b15693e75fb53092d62a97ade4d2b"
 }