@azure/eventhubs-checkpointstore-blob 1.1.0-alpha.20241121.1 → 1.1.0-alpha.20241204.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@azure/eventhubs-checkpointstore-blob",
|
|
3
3
|
"sdk-type": "client",
|
|
4
|
-
"version": "1.1.0-alpha.
|
|
4
|
+
"version": "1.1.0-alpha.20241204.2",
|
|
5
5
|
"description": "An Azure Storage Blob solution to store checkpoints when using Event Hubs.",
|
|
6
6
|
"author": "Microsoft Corporation",
|
|
7
7
|
"license": "MIT",
|
|
@@ -1,124 +0,0 @@
|
|
|
1
|
-
import { AzureLogger } from '@azure/logger';
|
|
2
|
-
import type { BlobItem } from '@azure/storage-blob';
|
|
3
|
-
import type { BlobSetMetadataOptions } from '@azure/storage-blob';
|
|
4
|
-
import type { BlockBlobUploadOptions } from '@azure/storage-blob';
|
|
5
|
-
import type { BlockBlobUploadResponse } from '@azure/storage-blob';
|
|
6
|
-
import type { Checkpoint } from '@azure/event-hubs';
|
|
7
|
-
import type { CheckpointStore } from '@azure/event-hubs';
|
|
8
|
-
import type { ContainerListBlobFlatSegmentResponse } from '@azure/storage-blob';
|
|
9
|
-
import type { ContainerListBlobsOptions } from '@azure/storage-blob';
|
|
10
|
-
import type { ContainerSetMetadataResponse } from '@azure/storage-blob';
|
|
11
|
-
import type { HttpRequestBody } from '@azure/storage-blob';
|
|
12
|
-
import type { Metadata } from '@azure/storage-blob';
|
|
13
|
-
import type { OperationOptions } from '@azure/event-hubs';
|
|
14
|
-
import type { PagedAsyncIterableIterator } from '@azure/core-paging';
|
|
15
|
-
import type { PartitionOwnership } from '@azure/event-hubs';
|
|
16
|
-
|
|
17
|
-
/**
|
|
18
|
-
* An implementation of CheckpointStore that uses Azure Blob Storage to persist checkpoint data.
|
|
19
|
-
*/
|
|
20
|
-
export declare class BlobCheckpointStore implements CheckpointStore {
|
|
21
|
-
private _containerClient;
|
|
22
|
-
/**
|
|
23
|
-
* Constructs a new instance of {@link BlobCheckpointStore}
|
|
24
|
-
* @param containerClient - An instance of a storage blob ContainerClient.
|
|
25
|
-
*/
|
|
26
|
-
constructor(containerClient: ContainerClientLike);
|
|
27
|
-
/**
|
|
28
|
-
* Get the list of all existing partition ownership from the underlying data store. May return empty
|
|
29
|
-
* results if there are is no existing ownership information.
|
|
30
|
-
* Partition Ownership contains the information on which `EventHubConsumerClient` subscribe call is currently processing the partition.
|
|
31
|
-
*
|
|
32
|
-
* @param fullyQualifiedNamespace - The fully qualified Event Hubs namespace. This is likely to be similar to
|
|
33
|
-
* <yournamespace>.servicebus.windows.net.
|
|
34
|
-
* @param eventHubName - The event hub name.
|
|
35
|
-
* @param consumerGroup - The consumer group name.
|
|
36
|
-
* @param options - A set of options that can be specified to influence the behavior of this method.
|
|
37
|
-
* - `abortSignal`: A signal used to request operation cancellation.
|
|
38
|
-
* - `tracingOptions`: Options for configuring tracing.
|
|
39
|
-
* @returns Partition ownership details of all the partitions that have had an owner.
|
|
40
|
-
*/
|
|
41
|
-
listOwnership(fullyQualifiedNamespace: string, eventHubName: string, consumerGroup: string, options?: OperationOptions): Promise<PartitionOwnership[]>;
|
|
42
|
-
/**
|
|
43
|
-
* Claim ownership of a list of partitions. This will return the list of partitions that were
|
|
44
|
-
* successfully claimed.
|
|
45
|
-
*
|
|
46
|
-
* @param partitionOwnership - The list of partition ownership this instance is claiming to own.
|
|
47
|
-
* @param options - A set of options that can be specified to influence the behavior of this method.
|
|
48
|
-
* - `abortSignal`: A signal used to request operation cancellation.
|
|
49
|
-
* - `tracingOptions`: Options for configuring tracing.
|
|
50
|
-
* @returns A list partitions this instance successfully claimed ownership.
|
|
51
|
-
*/
|
|
52
|
-
claimOwnership(partitionOwnership: PartitionOwnership[], options?: OperationOptions): Promise<PartitionOwnership[]>;
|
|
53
|
-
/**
|
|
54
|
-
* Lists all the checkpoints in a data store for a given namespace, eventhub and consumer group.
|
|
55
|
-
*
|
|
56
|
-
* @param fullyQualifiedNamespace - The fully qualified Event Hubs namespace. This is likely to be similar to
|
|
57
|
-
* <yournamespace>.servicebus.windows.net.
|
|
58
|
-
* @param eventHubName - The event hub name.
|
|
59
|
-
* @param consumerGroup - The consumer group name.
|
|
60
|
-
* @param options - A set of options that can be specified to influence the behavior of this method.
|
|
61
|
-
* - `abortSignal`: A signal used to request operation cancellation.
|
|
62
|
-
* - `tracingOptions`: Options for configuring tracing.
|
|
63
|
-
*/
|
|
64
|
-
listCheckpoints(fullyQualifiedNamespace: string, eventHubName: string, consumerGroup: string, options?: OperationOptions): Promise<Checkpoint[]>;
|
|
65
|
-
/**
|
|
66
|
-
* Updates the checkpoint in the data store for a partition.
|
|
67
|
-
*
|
|
68
|
-
* @param checkpoint - The checkpoint.
|
|
69
|
-
* @param options - A set of options that can be specified to influence the behavior of this method.
|
|
70
|
-
* - `abortSignal`: A signal used to request operation cancellation.
|
|
71
|
-
* - `tracingOptions`: Options for configuring tracing.
|
|
72
|
-
* @returns The new etag on successful update.
|
|
73
|
-
*/
|
|
74
|
-
updateCheckpoint(checkpoint: Checkpoint, options?: OperationOptions): Promise<void>;
|
|
75
|
-
private static getBlobPrefix;
|
|
76
|
-
private _setBlobMetadata;
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
/**
|
|
80
|
-
* An interface compatible with an instance of {@link BlobClient}.
|
|
81
|
-
*/
|
|
82
|
-
export declare interface BlobClientLike {
|
|
83
|
-
/**
|
|
84
|
-
* Creates a BlockBlobClient object.
|
|
85
|
-
*/
|
|
86
|
-
getBlockBlobClient(): BlockBlobClientLike;
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
/**
|
|
90
|
-
* An interface compatible with Storage Blob's BlockBlobClient class.
|
|
91
|
-
*/
|
|
92
|
-
export declare interface BlockBlobClientLike {
|
|
93
|
-
/**
|
|
94
|
-
* Creates a new block blob, or updated the content of an existing block blob.
|
|
95
|
-
*/
|
|
96
|
-
upload(body: HttpRequestBody, contentLength: number, options?: BlockBlobUploadOptions): Promise<BlockBlobUploadResponse>;
|
|
97
|
-
/**
|
|
98
|
-
* Sets user-defined metadata for the specified blob as one or more name-value pairs.
|
|
99
|
-
*/
|
|
100
|
-
setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions): Promise<ContainerSetMetadataResponse>;
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
/**
|
|
104
|
-
* An interface compatible with Storage Blob's ContainerClient class.
|
|
105
|
-
*/
|
|
106
|
-
export declare interface ContainerClientLike {
|
|
107
|
-
/**
|
|
108
|
-
* Creates a {@link BlobClient}
|
|
109
|
-
*/
|
|
110
|
-
getBlobClient(blobName: string): BlobClientLike;
|
|
111
|
-
/**
|
|
112
|
-
* Returns an async iterable iterator to list all the blobs
|
|
113
|
-
* under the specified account.
|
|
114
|
-
*/
|
|
115
|
-
listBlobsFlat(options?: ContainerListBlobsOptions): PagedAsyncIterableIterator<BlobItem, ContainerListBlobFlatSegmentResponse>;
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
/**
|
|
119
|
-
* The `@azure/logger` configuration for this package.
|
|
120
|
-
* This will output logs using the `azure:eventhubs-checkpointstore-blob` namespace prefix.
|
|
121
|
-
*/
|
|
122
|
-
export declare const logger: AzureLogger;
|
|
123
|
-
|
|
124
|
-
export { }
|