@hot-updater/azure 1.1.4 → 1.2.0-rc.0

package/dist/index.cjs

@@ -20,8 +20,9 @@ const serviceOf = (config) => "connectionString" in config ? _azure_storage_blob
 */
 function azureBlobStorage(config) {
 	const { containerName, basePath, getDownloadUrl } = config;
-	const service = serviceOf(config);
-	const container = service.getContainerClient(containerName);
+	let client;
+	const service = () => client ??= serviceOf(config);
+	const container = () => service().getContainerClient(containerName);
 	const normalizedBasePath = basePath?.replace(/^\/+|\/+$/g, "") ?? "";
 	const getStorageKey = (0, _hot_updater_plugin_core.createStorageKeyBuilder)(normalizedBasePath);
 	const getListPrefix = (prefix = "") => {
@@ -53,7 +54,7 @@ function azureBlobStorage(config) {
 	const delegationKey = () => {
 		const now = Date.now();
 		if (delegation === void 0 || delegation.renewAt <= now) {
-			const key = service.getUserDelegationKey(/* @__PURE__ */ new Date(now - 3e5), new Date(now + DELEGATION_KEY_LIFETIME_MS));
+			const key = service().getUserDelegationKey(/* @__PURE__ */ new Date(now - 3e5), new Date(now + DELEGATION_KEY_LIFETIME_MS));
 			key.catch(() => {
 				delegation = void 0;
 			});
@@ -65,7 +66,7 @@ function azureBlobStorage(config) {
 		return delegation.key;
 	};
 	const signedUrl = async (key) => {
-		const blob = container.getBlobClient(key);
+		const blob = container().getBlobClient(key);
 		const expiresOn = new Date(Date.now() + SAS_EXPIRES_IN_MS);
 		const permissions = _azure_storage_blob.BlobSASPermissions.parse("r");
 		if (blob.credential instanceof _azure_storage_blob.StorageSharedKeyCredential) return blob.generateSasUrl({
@@ -86,7 +87,7 @@ function azureBlobStorage(config) {
 		protocol: PROTOCOL,
 		async listObjects(prefix) {
 			const objects = [];
-			for await (const blob of container.listBlobsFlat({ prefix: getListPrefix(prefix) })) {
+			for await (const blob of container().listBlobsFlat({ prefix: getListPrefix(prefix) })) {
 				const storageUri = getListedStorageUri(blob.name);
 				if (storageUri === null) continue;
 				objects.push({
@@ -103,17 +104,36 @@ function azureBlobStorage(config) {
 			for (let offset = 0; offset < keys.length; offset += 256) {
 				const batch = keys.slice(offset, offset + 256);
 				if (batch.length === 0) continue;
-				const failed = (await container.getBlobBatchClient().deleteBlobs(batch.map((key) => container.getBlobClient(key)))).subResponses.filter(({ status }) => status >= 300 && status !== 404);
+				const failed = (await container().getBlobBatchClient().deleteBlobs(batch.map((key) => container().getBlobClient(key)))).subResponses.filter(({ status }) => status >= 300 && status !== 404);
 				if (failed.length > 0) throw new Error(`Failed to delete ${failed.length} Azure blob(s).`);
 			}
 		},
-		async put({ key, body, contentType }) {
+		async put({ key, body, contentLength, contentType }) {
 			const storageKey = getStorageKey(key);
-			const bytes = new Uint8Array(await new Response(body).arrayBuffer());
-			await container.getBlockBlobClient(storageKey).uploadData(bytes, { blobHTTPHeaders: {
+			const options = { blobHTTPHeaders: {
 				blobContentType: contentType,
 				blobCacheControl: "max-age=31536000"
-			} });
+			} };
+			const blob = container().getBlockBlobClient(storageKey);
+			if (contentLength === void 0) await blob.uploadData(new Uint8Array(await new Response(body).arrayBuffer()), options);
+			else {
+				const { Readable } = await import("node:stream");
+				const source = Readable.fromWeb(body);
+				const aborted = new AbortController();
+				let failure;
+				source.once("error", (error) => {
+					failure = error;
+					aborted.abort(error);
+				});
+				try {
+					await blob.upload(source, contentLength, {
+						...options,
+						abortSignal: aborted.signal
+					});
+				} catch (error) {
+					throw failure ?? error;
+				}
+			}
 			return { storageUri: (0, _hot_updater_plugin_core.createStorageUri)({
 				bucket: containerName,
 				key: storageKey,
@@ -123,7 +143,7 @@ function azureBlobStorage(config) {
 		async get({ storageUri }) {
 			const { key } = parseAndValidate(storageUri);
 			try {
-				const download = await container.getBlobClient(key).download();
+				const download = await container().getBlobClient(key).download();
 				const body = download.readableStreamBody;
 				if (body === void 0) return { response: null };
 				const headers = new Headers();
@@ -143,11 +163,11 @@ function azureBlobStorage(config) {
 		},
 		async exists({ storageUri }) {
 			const { key } = parseAndValidate(storageUri);
-			return { exists: await container.getBlobClient(key).exists() };
+			return { exists: await container().getBlobClient(key).exists() };
 		},
 		async delete({ storageUri }) {
 			const { key } = parseAndValidate(storageUri);
-			await container.getBlobClient(key).deleteIfExists();
+			await container().getBlobClient(key).deleteIfExists();
 			return { deleted: true };
 		}
 	});
@@ -364,7 +384,15 @@ const emulatorAborted = (error) => statusOf(error) === 500 && /PostgresError\(Sq
 * replaces the row it read.
 */
 const createCosmosStore = ({ client, databaseId, containerId, engine, nativePageSize }) => {
-	const container = client.database(databaseId).container(containerId);
+	let opened;
+	const open = () => opened ??= (() => {
+		const account = typeof client === "function" ? client() : client;
+		return {
+			client: account,
+			container: account.database(databaseId).container(containerId)
+		};
+	})();
+	const container = () => open().container;
 	/**
 	* The state of the items `ids` names, by id, with the rows of `rowIds`;
 	* a missing item has none.
@@ -372,7 +400,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 	const readStates = async (ids, rowIds) => {
 		const states = /* @__PURE__ */ new Map();
 		for (const [group, projection] of [[ids.filter((id) => !rowIds.has(id)), ""], [ids.filter((id) => rowIds.has(id)), ", c.row"]]) for (let at = 0; at < group.length; at += GET_BATCH) {
-			const { resources } = await container.items.query(`SELECT c.id, c._etag AS etag, c.row._v AS v, c.expireAt${projection} FROM c WHERE c.id IN (${idList(group.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
+			const { resources } = await container().items.query(`SELECT c.id, c._etag AS etag, c.row._v AS v, c.expireAt${projection} FROM c WHERE c.id IN (${idList(group.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
 			for (const { id, etag, v, expireAt, row } of resources) states.set(id, {
 				etag,
 				v,
@@ -510,7 +538,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 			const found = /* @__PURE__ */ new Map();
 			const ids = [...new Set(keys.map(cosmosItemId))];
 			for (let at = 0; at < ids.length; at += GET_BATCH) {
-				const { resources } = await container.items.query(`SELECT c.id, c.row FROM c WHERE c.id IN (${idList(ids.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
+				const { resources } = await container().items.query(`SELECT c.id, c.row FROM c WHERE c.id IN (${idList(ids.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
 				for (const resource of resources) found.set(resource.id, toRow(resource.row));
 			}
 			return keys.map((key) => found.get(cosmosItemId(key)) ?? null);
@@ -546,7 +574,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 					value: after
 				});
 			}
-			const { resources } = await container.items.query({
+			const { resources } = await container().items.query({
 				query: `SELECT TOP @size c.sk, c.row FROM c WHERE ${filters.join(" AND ")} ORDER BY c.pk ${order === "asc" ? "ASC" : "DESC"}, c.sk ${order === "asc" ? "ASC" : "DESC"}`,
 				parameters
 			}, {
@@ -596,7 +624,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 				if (planned.length > BATCH_OPERATIONS) throw new Error(`A Cosmos DB batch takes ${BATCH_OPERATIONS} operations; this write needs ${planned.length}.`);
 				let results;
 				try {
-					const response = await container.items.batch(planned.map(({ operation }) => operation), COSMOS_PARTITION);
+					const response = await container().items.batch(planned.map(({ operation }) => operation), COSMOS_PARTITION);
 					if (response.result === void 0) throw Object.assign(/* @__PURE__ */ new Error(`Cosmos DB refused the batch with status ${response.code}`), { code: response.code });
 					results = response.result;
 				} catch (error) {
@@ -630,7 +658,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 		async deleteConsumed(keys) {
 			let remaining = [...new Set(keys.map(cosmosItemId))];
 			for (let attempt = 0; remaining.length > 0; attempt += 1) {
-				const failed = (await container.items.executeBulkOperations(remaining.map((id) => ({
+				const failed = (await container().items.executeBulkOperations(remaining.map((id) => ({
 					operationType: "Delete",
 					id,
 					partitionKey: COSMOS_PARTITION
@@ -651,8 +679,8 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 		migrations: { 
 		/** Creates the database and the container when they are missing. */
 async apply() {
-			if (engine !== void 0) await assertCosmosContainerReusable(container, engine);
-			const { database } = await client.databases.createIfNotExists({ id: databaseId });
+			if (engine !== void 0) await assertCosmosContainerReusable(container(), engine);
+			const { database } = await open().client.databases.createIfNotExists({ id: databaseId });
 			const { resource } = await database.containers.createIfNotExists({
 				id: containerId,
 				partitionKey: { paths: [COSMOS_PARTITION_KEY_PATH] },
@@ -688,15 +716,15 @@ async apply() {
 const adapterOf = (config) => {
 	const { databaseId = AZURE_COSMOS_V1_DATABASE, containerId = AZURE_COSMOS_V1_CONTAINER, aggregateBatching: _, ...connection } = config;
 	if (connection.consistencyLevel !== void 0 && connection.consistencyLevel !== "Strong") throw new Error(`cosmosDatabase reads with strong consistency; consistencyLevel "${String(connection.consistencyLevel)}" is weaker.`);
-	const client = new _azure_cosmos.CosmosClient(connection);
+	let client;
 	const store = createCosmosStore({
-		client,
+		client: () => client ??= new _azure_cosmos.CosmosClient(connection),
 		databaseId,
 		containerId,
 		engine: currentCosmosEngine()
 	});
 	return {
-		client,
+		dispose: () => client?.dispose(),
 		adapter: (0, _hot_updater_plugin_core.createKvAdapter)({ store })
 	};
 };
@@ -708,8 +736,23 @@ const adapterOf = (config) => {
 * it with the managed server's plugins.
 */
 const migrateCosmosDatabase = (config, plugins = []) => {
-	const { client, adapter } = adapterOf(config);
-	return (0, _hot_updater_plugin_core.migrateCoreSchema)(adapter, "cosmosDatabase", plugins).finally(() => client.dispose());
+	const { dispose, adapter } = adapterOf(config);
+	return (0, _hot_updater_plugin_core.migrateCoreSchema)(adapter, "cosmosDatabase", plugins).finally(dispose);
+};
+/**
+* The resource this database reaches, without credentials, under the key
+* `hot-updater doctor` reads to tell the database `hot-updater init` saved
+* from another (a convention CLAUDE.md documents).
+*/
+const DATABASE_TARGET = Symbol.for("@hot-updater/database-target");
+/** The account host a client reaches: its endpoint, or the connection string's. */
+const accountHostOf = ({ endpoint, connectionString }) => {
+	const url = endpoint ?? connectionString?.match(/AccountEndpoint=([^;]+)/iu)?.[1];
+	try {
+		return url === void 0 ? void 0 : new URL(url).hostname;
+	} catch {
+		return;
+	}
 };
 /**
 * Hot Updater's database in one Azure Cosmos DB for NoSQL container,
@@ -718,16 +761,18 @@ const migrateCosmosDatabase = (config, plugins = []) => {
 * 20 GB.
 */
 const cosmosDatabase = (config) => {
-	const { client, adapter } = adapterOf(config);
+	const { dispose, adapter } = adapterOf(config);
+	const host = accountHostOf(config);
 	return {
 		...(0, _hot_updater_plugin_core.createEngineDatabase)({
 			name: "cosmosDatabase",
 			adapter,
 			aggregateBatching: config.aggregateBatching ?? {}
 		}),
+		...host === void 0 ? {} : { [DATABASE_TARGET]: `cosmos/${host}` },
 		async dispose() {
 			await adapter.dispose?.();
-			client.dispose();
+			dispose();
 		}
 	};
 };

package/dist/index.mjs

@@ -19,8 +19,9 @@ const serviceOf = (config) => "connectionString" in config ? BlobServiceClient.f
 */
 function azureBlobStorage(config) {
 	const { containerName, basePath, getDownloadUrl } = config;
-	const service = serviceOf(config);
-	const container = service.getContainerClient(containerName);
+	let client;
+	const service = () => client ??= serviceOf(config);
+	const container = () => service().getContainerClient(containerName);
 	const normalizedBasePath = basePath?.replace(/^\/+|\/+$/g, "") ?? "";
 	const getStorageKey = createStorageKeyBuilder(normalizedBasePath);
 	const getListPrefix = (prefix = "") => {
@@ -52,7 +53,7 @@ function azureBlobStorage(config) {
 	const delegationKey = () => {
 		const now = Date.now();
 		if (delegation === void 0 || delegation.renewAt <= now) {
-			const key = service.getUserDelegationKey(/* @__PURE__ */ new Date(now - 3e5), new Date(now + DELEGATION_KEY_LIFETIME_MS));
+			const key = service().getUserDelegationKey(/* @__PURE__ */ new Date(now - 3e5), new Date(now + DELEGATION_KEY_LIFETIME_MS));
 			key.catch(() => {
 				delegation = void 0;
 			});
@@ -64,7 +65,7 @@ function azureBlobStorage(config) {
 		return delegation.key;
 	};
 	const signedUrl = async (key) => {
-		const blob = container.getBlobClient(key);
+		const blob = container().getBlobClient(key);
 		const expiresOn = new Date(Date.now() + SAS_EXPIRES_IN_MS);
 		const permissions = BlobSASPermissions.parse("r");
 		if (blob.credential instanceof StorageSharedKeyCredential) return blob.generateSasUrl({
@@ -85,7 +86,7 @@ function azureBlobStorage(config) {
 		protocol: PROTOCOL,
 		async listObjects(prefix) {
 			const objects = [];
-			for await (const blob of container.listBlobsFlat({ prefix: getListPrefix(prefix) })) {
+			for await (const blob of container().listBlobsFlat({ prefix: getListPrefix(prefix) })) {
 				const storageUri = getListedStorageUri(blob.name);
 				if (storageUri === null) continue;
 				objects.push({
@@ -102,17 +103,36 @@ function azureBlobStorage(config) {
 			for (let offset = 0; offset < keys.length; offset += 256) {
 				const batch = keys.slice(offset, offset + 256);
 				if (batch.length === 0) continue;
-				const failed = (await container.getBlobBatchClient().deleteBlobs(batch.map((key) => container.getBlobClient(key)))).subResponses.filter(({ status }) => status >= 300 && status !== 404);
+				const failed = (await container().getBlobBatchClient().deleteBlobs(batch.map((key) => container().getBlobClient(key)))).subResponses.filter(({ status }) => status >= 300 && status !== 404);
 				if (failed.length > 0) throw new Error(`Failed to delete ${failed.length} Azure blob(s).`);
 			}
 		},
-		async put({ key, body, contentType }) {
+		async put({ key, body, contentLength, contentType }) {
 			const storageKey = getStorageKey(key);
-			const bytes = new Uint8Array(await new Response(body).arrayBuffer());
-			await container.getBlockBlobClient(storageKey).uploadData(bytes, { blobHTTPHeaders: {
+			const options = { blobHTTPHeaders: {
 				blobContentType: contentType,
 				blobCacheControl: "max-age=31536000"
-			} });
+			} };
+			const blob = container().getBlockBlobClient(storageKey);
+			if (contentLength === void 0) await blob.uploadData(new Uint8Array(await new Response(body).arrayBuffer()), options);
+			else {
+				const { Readable } = await import("node:stream");
+				const source = Readable.fromWeb(body);
+				const aborted = new AbortController();
+				let failure;
+				source.once("error", (error) => {
+					failure = error;
+					aborted.abort(error);
+				});
+				try {
+					await blob.upload(source, contentLength, {
+						...options,
+						abortSignal: aborted.signal
+					});
+				} catch (error) {
+					throw failure ?? error;
+				}
+			}
 			return { storageUri: createStorageUri({
 				bucket: containerName,
 				key: storageKey,
@@ -122,7 +142,7 @@ function azureBlobStorage(config) {
 		async get({ storageUri }) {
 			const { key } = parseAndValidate(storageUri);
 			try {
-				const download = await container.getBlobClient(key).download();
+				const download = await container().getBlobClient(key).download();
 				const body = download.readableStreamBody;
 				if (body === void 0) return { response: null };
 				const headers = new Headers();
@@ -142,11 +162,11 @@ function azureBlobStorage(config) {
 		},
 		async exists({ storageUri }) {
 			const { key } = parseAndValidate(storageUri);
-			return { exists: await container.getBlobClient(key).exists() };
+			return { exists: await container().getBlobClient(key).exists() };
 		},
 		async delete({ storageUri }) {
 			const { key } = parseAndValidate(storageUri);
-			await container.getBlobClient(key).deleteIfExists();
+			await container().getBlobClient(key).deleteIfExists();
 			return { deleted: true };
 		}
 	});
@@ -363,7 +383,15 @@ const emulatorAborted = (error) => statusOf(error) === 500 && /PostgresError\(Sq
 * replaces the row it read.
 */
 const createCosmosStore = ({ client, databaseId, containerId, engine, nativePageSize }) => {
-	const container = client.database(databaseId).container(containerId);
+	let opened;
+	const open = () => opened ??= (() => {
+		const account = typeof client === "function" ? client() : client;
+		return {
+			client: account,
+			container: account.database(databaseId).container(containerId)
+		};
+	})();
+	const container = () => open().container;
 	/**
 	* The state of the items `ids` names, by id, with the rows of `rowIds`;
 	* a missing item has none.
@@ -371,7 +399,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 	const readStates = async (ids, rowIds) => {
 		const states = /* @__PURE__ */ new Map();
 		for (const [group, projection] of [[ids.filter((id) => !rowIds.has(id)), ""], [ids.filter((id) => rowIds.has(id)), ", c.row"]]) for (let at = 0; at < group.length; at += GET_BATCH) {
-			const { resources } = await container.items.query(`SELECT c.id, c._etag AS etag, c.row._v AS v, c.expireAt${projection} FROM c WHERE c.id IN (${idList(group.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
+			const { resources } = await container().items.query(`SELECT c.id, c._etag AS etag, c.row._v AS v, c.expireAt${projection} FROM c WHERE c.id IN (${idList(group.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
 			for (const { id, etag, v, expireAt, row } of resources) states.set(id, {
 				etag,
 				v,
@@ -509,7 +537,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 			const found = /* @__PURE__ */ new Map();
 			const ids = [...new Set(keys.map(cosmosItemId))];
 			for (let at = 0; at < ids.length; at += GET_BATCH) {
-				const { resources } = await container.items.query(`SELECT c.id, c.row FROM c WHERE c.id IN (${idList(ids.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
+				const { resources } = await container().items.query(`SELECT c.id, c.row FROM c WHERE c.id IN (${idList(ids.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
 				for (const resource of resources) found.set(resource.id, toRow(resource.row));
 			}
 			return keys.map((key) => found.get(cosmosItemId(key)) ?? null);
@@ -545,7 +573,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 					value: after
 				});
 			}
-			const { resources } = await container.items.query({
+			const { resources } = await container().items.query({
 				query: `SELECT TOP @size c.sk, c.row FROM c WHERE ${filters.join(" AND ")} ORDER BY c.pk ${order === "asc" ? "ASC" : "DESC"}, c.sk ${order === "asc" ? "ASC" : "DESC"}`,
 				parameters
 			}, {
@@ -595,7 +623,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 				if (planned.length > BATCH_OPERATIONS) throw new Error(`A Cosmos DB batch takes ${BATCH_OPERATIONS} operations; this write needs ${planned.length}.`);
 				let results;
 				try {
-					const response = await container.items.batch(planned.map(({ operation }) => operation), COSMOS_PARTITION);
+					const response = await container().items.batch(planned.map(({ operation }) => operation), COSMOS_PARTITION);
 					if (response.result === void 0) throw Object.assign(/* @__PURE__ */ new Error(`Cosmos DB refused the batch with status ${response.code}`), { code: response.code });
 					results = response.result;
 				} catch (error) {
@@ -629,7 +657,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 		async deleteConsumed(keys) {
 			let remaining = [...new Set(keys.map(cosmosItemId))];
 			for (let attempt = 0; remaining.length > 0; attempt += 1) {
-				const failed = (await container.items.executeBulkOperations(remaining.map((id) => ({
+				const failed = (await container().items.executeBulkOperations(remaining.map((id) => ({
 					operationType: "Delete",
 					id,
 					partitionKey: COSMOS_PARTITION
@@ -650,8 +678,8 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 		migrations: { 
 		/** Creates the database and the container when they are missing. */
 async apply() {
-			if (engine !== void 0) await assertCosmosContainerReusable(container, engine);
-			const { database } = await client.databases.createIfNotExists({ id: databaseId });
+			if (engine !== void 0) await assertCosmosContainerReusable(container(), engine);
+			const { database } = await open().client.databases.createIfNotExists({ id: databaseId });
 			const { resource } = await database.containers.createIfNotExists({
 				id: containerId,
 				partitionKey: { paths: [COSMOS_PARTITION_KEY_PATH] },
@@ -687,15 +715,15 @@ async apply() {
 const adapterOf = (config) => {
 	const { databaseId = AZURE_COSMOS_V1_DATABASE, containerId = AZURE_COSMOS_V1_CONTAINER, aggregateBatching: _, ...connection } = config;
 	if (connection.consistencyLevel !== void 0 && connection.consistencyLevel !== "Strong") throw new Error(`cosmosDatabase reads with strong consistency; consistencyLevel "${String(connection.consistencyLevel)}" is weaker.`);
-	const client = new CosmosClient(connection);
+	let client;
 	const store = createCosmosStore({
-		client,
+		client: () => client ??= new CosmosClient(connection),
 		databaseId,
 		containerId,
 		engine: currentCosmosEngine()
 	});
 	return {
-		client,
+		dispose: () => client?.dispose(),
 		adapter: createKvAdapter({ store })
 	};
 };
@@ -707,8 +735,23 @@ const adapterOf = (config) => {
 * it with the managed server's plugins.
 */
 const migrateCosmosDatabase = (config, plugins = []) => {
-	const { client, adapter } = adapterOf(config);
-	return migrateCoreSchema(adapter, "cosmosDatabase", plugins).finally(() => client.dispose());
+	const { dispose, adapter } = adapterOf(config);
+	return migrateCoreSchema(adapter, "cosmosDatabase", plugins).finally(dispose);
+};
+/**
+* The resource this database reaches, without credentials, under the key
+* `hot-updater doctor` reads to tell the database `hot-updater init` saved
+* from another (a convention CLAUDE.md documents).
+*/
+const DATABASE_TARGET = Symbol.for("@hot-updater/database-target");
+/** The account host a client reaches: its endpoint, or the connection string's. */
+const accountHostOf = ({ endpoint, connectionString }) => {
+	const url = endpoint ?? connectionString?.match(/AccountEndpoint=([^;]+)/iu)?.[1];
+	try {
+		return url === void 0 ? void 0 : new URL(url).hostname;
+	} catch {
+		return;
+	}
 };
 /**
 * Hot Updater's database in one Azure Cosmos DB for NoSQL container,
@@ -717,16 +760,18 @@ const migrateCosmosDatabase = (config, plugins = []) => {
 * 20 GB.
 */
 const cosmosDatabase = (config) => {
-	const { client, adapter } = adapterOf(config);
+	const { dispose, adapter } = adapterOf(config);
+	const host = accountHostOf(config);
 	return {
 		...createEngineDatabase({
 			name: "cosmosDatabase",
 			adapter,
 			aggregateBatching: config.aggregateBatching ?? {}
 		}),
+		...host === void 0 ? {} : { [DATABASE_TARGET]: `cosmos/${host}` },
 		async dispose() {
 			await adapter.dispose?.();
-			client.dispose();
+			dispose();
 		}
 	};
 };

package/dist/init/index.cjs

@@ -266,7 +266,15 @@ const emulatorAborted = (error) => statusOf(error) === 500 && /PostgresError\(Sq
 * replaces the row it read.
 */
 const createCosmosStore = ({ client, databaseId, containerId, engine, nativePageSize }) => {
-	const container = client.database(databaseId).container(containerId);
+	let opened;
+	const open = () => opened ??= (() => {
+		const account = typeof client === "function" ? client() : client;
+		return {
+			client: account,
+			container: account.database(databaseId).container(containerId)
+		};
+	})();
+	const container = () => open().container;
 	/**
 	* The state of the items `ids` names, by id, with the rows of `rowIds`;
 	* a missing item has none.
@@ -274,7 +282,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 	const readStates = async (ids, rowIds) => {
 		const states = /* @__PURE__ */ new Map();
 		for (const [group, projection] of [[ids.filter((id) => !rowIds.has(id)), ""], [ids.filter((id) => rowIds.has(id)), ", c.row"]]) for (let at = 0; at < group.length; at += GET_BATCH) {
-			const { resources } = await container.items.query(`SELECT c.id, c._etag AS etag, c.row._v AS v, c.expireAt${projection} FROM c WHERE c.id IN (${idList(group.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
+			const { resources } = await container().items.query(`SELECT c.id, c._etag AS etag, c.row._v AS v, c.expireAt${projection} FROM c WHERE c.id IN (${idList(group.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
 			for (const { id, etag, v, expireAt, row } of resources) states.set(id, {
 				etag,
 				v,
@@ -412,7 +420,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 			const found = /* @__PURE__ */ new Map();
 			const ids = [...new Set(keys.map(cosmosItemId))];
 			for (let at = 0; at < ids.length; at += GET_BATCH) {
-				const { resources } = await container.items.query(`SELECT c.id, c.row FROM c WHERE c.id IN (${idList(ids.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
+				const { resources } = await container().items.query(`SELECT c.id, c.row FROM c WHERE c.id IN (${idList(ids.slice(at, at + GET_BATCH))})`, { partitionKey: COSMOS_PARTITION }).fetchAll().catch(missingContainer);
 				for (const resource of resources) found.set(resource.id, toRow(resource.row));
 			}
 			return keys.map((key) => found.get(cosmosItemId(key)) ?? null);
@@ -448,7 +456,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 					value: after
 				});
 			}
-			const { resources } = await container.items.query({
+			const { resources } = await container().items.query({
 				query: `SELECT TOP @size c.sk, c.row FROM c WHERE ${filters.join(" AND ")} ORDER BY c.pk ${order === "asc" ? "ASC" : "DESC"}, c.sk ${order === "asc" ? "ASC" : "DESC"}`,
 				parameters
 			}, {
@@ -498,7 +506,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 				if (planned.length > BATCH_OPERATIONS) throw new Error(`A Cosmos DB batch takes ${BATCH_OPERATIONS} operations; this write needs ${planned.length}.`);
 				let results;
 				try {
-					const response = await container.items.batch(planned.map(({ operation }) => operation), COSMOS_PARTITION);
+					const response = await container().items.batch(planned.map(({ operation }) => operation), COSMOS_PARTITION);
 					if (response.result === void 0) throw Object.assign(/* @__PURE__ */ new Error(`Cosmos DB refused the batch with status ${response.code}`), { code: response.code });
 					results = response.result;
 				} catch (error) {
@@ -532,7 +540,7 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 		async deleteConsumed(keys) {
 			let remaining = [...new Set(keys.map(cosmosItemId))];
 			for (let attempt = 0; remaining.length > 0; attempt += 1) {
-				const failed = (await container.items.executeBulkOperations(remaining.map((id) => ({
+				const failed = (await container().items.executeBulkOperations(remaining.map((id) => ({
 					operationType: "Delete",
 					id,
 					partitionKey: COSMOS_PARTITION
@@ -553,8 +561,8 @@ const createCosmosStore = ({ client, databaseId, containerId, engine, nativePage
 		migrations: { 
 		/** Creates the database and the container when they are missing. */
 async apply() {
-			if (engine !== void 0) await assertCosmosContainerReusable(container, engine);
-			const { database } = await client.databases.createIfNotExists({ id: databaseId });
+			if (engine !== void 0) await assertCosmosContainerReusable(container(), engine);
+			const { database } = await open().client.databases.createIfNotExists({ id: databaseId });
 			const { resource } = await database.containers.createIfNotExists({
 				id: containerId,
 				partitionKey: { paths: [COSMOS_PARTITION_KEY_PATH] },
@@ -590,15 +598,15 @@ async apply() {
 const adapterOf = (config) => {
 	const { databaseId = AZURE_COSMOS_V1_DATABASE, containerId = AZURE_COSMOS_V1_CONTAINER, aggregateBatching: _, ...connection } = config;
 	if (connection.consistencyLevel !== void 0 && connection.consistencyLevel !== "Strong") throw new Error(`cosmosDatabase reads with strong consistency; consistencyLevel "${String(connection.consistencyLevel)}" is weaker.`);
-	const client = new _azure_cosmos.CosmosClient(connection);
+	let client;
 	const store = createCosmosStore({
-		client,
+		client: () => client ??= new _azure_cosmos.CosmosClient(connection),
 		databaseId,
 		containerId,
 		engine: currentCosmosEngine()
 	});
 	return {
-		client,
+		dispose: () => client?.dispose(),
 		adapter: (0, _hot_updater_plugin_core.createKvAdapter)({ store })
 	};
 };
@@ -610,8 +618,23 @@ const adapterOf = (config) => {
 * it with the managed server's plugins.
 */
 const migrateCosmosDatabase = (config, plugins = []) => {
-	const { client, adapter } = adapterOf(config);
-	return (0, _hot_updater_plugin_core.migrateCoreSchema)(adapter, "cosmosDatabase", plugins).finally(() => client.dispose());
+	const { dispose, adapter } = adapterOf(config);
+	return (0, _hot_updater_plugin_core.migrateCoreSchema)(adapter, "cosmosDatabase", plugins).finally(dispose);
+};
+/**
+* The resource this database reaches, without credentials, under the key
+* `hot-updater doctor` reads to tell the database `hot-updater init` saved
+* from another (a convention CLAUDE.md documents).
+*/
+const DATABASE_TARGET = Symbol.for("@hot-updater/database-target");
+/** The account host a client reaches: its endpoint, or the connection string's. */
+const accountHostOf = ({ endpoint, connectionString }) => {
+	const url = endpoint ?? connectionString?.match(/AccountEndpoint=([^;]+)/iu)?.[1];
+	try {
+		return url === void 0 ? void 0 : new URL(url).hostname;
+	} catch {
+		return;
+	}
 };
 /**
 * Hot Updater's database in one Azure Cosmos DB for NoSQL container,
@@ -620,16 +643,18 @@ const migrateCosmosDatabase = (config, plugins = []) => {
 * 20 GB.
 */
 const cosmosDatabase = (config) => {
-	const { client, adapter } = adapterOf(config);
+	const { dispose, adapter } = adapterOf(config);
+	const host = accountHostOf(config);
 	return {
 		...(0, _hot_updater_plugin_core.createEngineDatabase)({
 			name: "cosmosDatabase",
 			adapter,
 			aggregateBatching: config.aggregateBatching ?? {}
 		}),
+		...host === void 0 ? {} : { [DATABASE_TARGET]: `cosmos/${host}` },
 		async dispose() {
 			await adapter.dispose?.();
-			client.dispose();
+			dispose();
 		}
 	};
 };