@hot-updater/firebase 1.0.0-rc.47 → 1.0.1

package/dist/firebase/functions/index.cjs

@@ -4525,7 +4525,7 @@ const createKvAdapter = ({ store, tablePrefix = "" }) => {
 };
 //#endregion
 //#region ../../packages/server/dist/version.mjs
-const HOT_UPDATER_SERVER_VERSION = "1.0.0-rc.47";
+const HOT_UPDATER_SERVER_VERSION = "1.0.1";
 //#endregion
 //#region ../../packages/server/dist/handlerVersionRoutes.mjs
 /**
@@ -11460,10 +11460,11 @@ const createFirestoreStore = ({ firestore, collection, nativePageSize }) => {
 };
 //#endregion
 //#region src/firebaseDatabase.ts
-const adapterOf = ({ collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
+const adapterOf = ({ databaseId, collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
 	const app = (0, firebase_admin_app.getApps)().length ? (0, firebase_admin_app.getApp)() : (0, firebase_admin_app.initializeApp)(appOptions);
+	const firestore = databaseId ? (0, firebase_admin_firestore.getFirestore)(app, databaseId) : (0, firebase_admin_firestore.getFirestore)(app);
 	return createKvAdapter({ store: createFirestoreStore({
-		firestore: (0, firebase_admin_firestore.getFirestore)(app),
+		firestore,
 		collection
 	}) });
 };
@@ -11551,7 +11552,10 @@ const storageBucket = adminOptions.storageBucket;
 const cdnUrl = process.env.HOT_UPDATER_CDN_URL;
 if (!storageBucket) throw new Error("Firebase runtime requires storageBucket to read bundle manifests.");
 const hotUpdater = createHotUpdater({
-	database: firebaseDatabase({ ...adminOptions }),
+	database: firebaseDatabase({
+		...adminOptions,
+		databaseId: HotUpdater.FIRESTORE_DATABASE_ID
+	}),
 	plugins: [
 		insights(),
 		apiKeys(),

package/dist/index.cjs

@@ -168,10 +168,11 @@ const createFirestoreStore = ({ firestore, collection, nativePageSize }) => {
 };
 //#endregion
 //#region src/firebaseDatabase.ts
-const adapterOf = ({ collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
+const adapterOf = ({ databaseId, collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
 	const app = (0, firebase_admin_app.getApps)().length ? (0, firebase_admin_app.getApp)() : (0, firebase_admin_app.initializeApp)(appOptions);
+	const firestore = databaseId ? (0, firebase_admin_firestore.getFirestore)(app, databaseId) : (0, firebase_admin_firestore.getFirestore)(app);
 	return (0, _hot_updater_plugin_core.createKvAdapter)({ store: createFirestoreStore({
-		firestore: (0, firebase_admin_firestore.getFirestore)(app),
+		firestore,
 		collection
 	}) });
 };

package/dist/index.d.cts

@@ -2,6 +2,11 @@ import { EngineDatabase, PluginTables, StorageAdapterWith } from "@hot-updater/p
 import { AppOptions } from "firebase-admin/app";
 //#region src/firebaseDatabase.d.ts
 type FirebaseDatabaseConfig = AppOptions & {
+  /**
+   * The Firestore database the collection lives in, for a project with
+   * named databases. Defaults to the project's `(default)` database.
+   */
+  readonly databaseId?: string;
   /** The one collection the database keeps its items in. */
   readonly collection?: string;
   /**

package/dist/index.d.mts

@@ -2,6 +2,11 @@ import { EngineDatabase, PluginTables, StorageAdapterWith } from "@hot-updater/p
 import { AppOptions } from "firebase-admin/app";
 //#region src/firebaseDatabase.d.ts
 type FirebaseDatabaseConfig = AppOptions & {
+  /**
+   * The Firestore database the collection lives in, for a project with
+   * named databases. Defaults to the project's `(default)` database.
+   */
+  readonly databaseId?: string;
   /** The one collection the database keeps its items in. */
   readonly collection?: string;
   /**

package/dist/index.mjs

@@ -167,10 +167,11 @@ const createFirestoreStore = ({ firestore, collection, nativePageSize }) => {
 };
 //#endregion
 //#region src/firebaseDatabase.ts
-const adapterOf = ({ collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
+const adapterOf = ({ databaseId, collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
 	const app = getApps().length ? getApp() : initializeApp(appOptions);
+	const firestore = databaseId ? getFirestore(app, databaseId) : getFirestore(app);
 	return createKvAdapter({ store: createFirestoreStore({
-		firestore: getFirestore(app),
+		firestore,
 		collection
 	}) });
 };

package/dist/init/index.cjs

@@ -6864,10 +6864,11 @@ const createFirestoreStore = ({ firestore, collection, nativePageSize }) => {
 };
 //#endregion
 //#region src/firebaseDatabase.ts
-const adapterOf = ({ collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
+const adapterOf = ({ databaseId, collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
 	const app = (0, firebase_admin_app.getApps)().length ? (0, firebase_admin_app.getApp)() : (0, firebase_admin_app.initializeApp)(appOptions);
+	const firestore = databaseId ? (0, firebase_admin_firestore.getFirestore)(app, databaseId) : (0, firebase_admin_firestore.getFirestore)(app);
 	return (0, _hot_updater_plugin_core.createKvAdapter)({ store: createFirestoreStore({
-		firestore: (0, firebase_admin_firestore.getFirestore)(app),
+		firestore,
 		collection
 	}) });
 };
@@ -6888,6 +6889,8 @@ const firebaseDatabase = (config) => (0, _hot_updater_plugin_core.createEngineDa
 //#region iac/init/index.ts
 const isFirebaseRegion = (value) => value !== void 0 && /^[a-z]+(?:-[a-z]+)+[0-9]+$/.test(value);
 const isFirebaseProjectId = (value) => value !== void 0 && /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/.test(value);
+/** `(default)`, or a named database's ID: 4-63 lowercase letters, digits, or hyphens. */
+const isFirestoreDatabaseId = (value) => value !== void 0 && (value === "(default)" || /^[a-z][a-z0-9-]{2,61}[a-z0-9]$/.test(value));
 const initProvider = {
 	label: "Firebase",
 	inputs: {
@@ -6910,6 +6913,16 @@ const initProvider = {
 			},
 			validate: isFirebaseRegion
 		},
+		databaseId: {
+			envKey: "HOT_UPDATER_FIREBASE_DATABASE_ID",
+			help: "Firestore database ID",
+			optional: true,
+			prompt: {
+				message: "Select a Firestore database",
+				type: "select"
+			},
+			validate: isFirestoreDatabaseId
+		},
 		applicationCredentials: {
 			envKey: "GOOGLE_APPLICATION_CREDENTIALS",
 			help: "Service account JSON path",
@@ -6954,15 +6967,15 @@ const firebaseEngineSettingDocumentId = () => firestoreDocumentId({
 	pk: _hot_updater_plugin_core.SETTINGS_TABLE.name,
 	sk: (0, _hot_updater_plugin_core.encodeKvKey)([ENGINE_SETTING])
 });
-const assertFirebaseInfrastructureCanInitialize = async ({ applicationCredentials, projectId }) => {
+const assertFirebaseInfrastructureCanInitialize = async ({ applicationCredentials, databaseId, projectId }) => {
 	const credential = applicationCredentials ? (0, firebase_admin_app.cert)(JSON.parse(await fs_promises.default.readFile(applicationCredentials, "utf8"))) : (0, firebase_admin_app.applicationDefault)();
 	const app = (0, firebase_admin_app.initializeApp)({
 		credential,
 		projectId
 	}, `hot-updater-init-${projectId}-${Date.now()}`);
 	try {
-		const setting = await (0, firebase_admin_firestore.getFirestore)(app).collection(FIREBASE_V1_COLLECTION).doc(firebaseEngineSettingDocumentId()).get();
-		if (resolveFirebaseInfrastructureState({ engine: setting.exists ? setting.get("row.value") : void 0 }) === "incompatible") throw new _hot_updater_cli_tools.InitError(`Firebase v1 infrastructure in project ${projectId} records an unsupported database version. Use a new Firebase project, or delete the ${FIREBASE_V1_COLLECTION} collection, then rerun init.`);
+		const setting = await (0, firebase_admin_firestore.getFirestore)(app, databaseId).collection(FIREBASE_V1_COLLECTION).doc(firebaseEngineSettingDocumentId()).get();
+		if (resolveFirebaseInfrastructureState({ engine: setting.exists ? setting.get("row.value") : void 0 }) === "incompatible") throw new _hot_updater_cli_tools.InitError(`Firebase v1 infrastructure in project ${projectId} (Firestore database ${databaseId}) records an unsupported database version. Use a new Firebase project, or delete the ${FIREBASE_V1_COLLECTION} collection, then rerun init.`);
 	} catch (error) {
 		if (error instanceof _hot_updater_cli_tools.InitError) throw error;
 		const code = typeof error === "object" && error !== null ? Reflect.get(error, "code") : void 0;
@@ -7006,6 +7019,7 @@ const resolveFirebaseInitInputs = (existingEnv) => {
 	const applicationCredentials = (0, _hot_updater_cli_tools.resolveInitProviderInput)(existingEnv, inputs.applicationCredentials);
 	return {
 		applicationCredentials: applicationCredentials === "your-credentials.json" ? void 0 : applicationCredentials,
+		databaseId: (0, _hot_updater_cli_tools.resolveInitProviderInput)(existingEnv, inputs.databaseId),
 		projectId: (0, _hot_updater_cli_tools.resolveInitProviderInput)(existingEnv, inputs.projectId),
 		region: (0, _hot_updater_cli_tools.resolveInitProviderInput)(existingEnv, inputs.region)
 	};
@@ -7198,6 +7212,7 @@ const getConfigScaffold = (build) => {
 		}],
 		configString: `firebaseDatabase({
     projectId: process.env.HOT_UPDATER_FIREBASE_PROJECT_ID!,
+    databaseId: process.env.HOT_UPDATER_FIREBASE_DATABASE_ID,
     credential,
   })`
 	};
@@ -7228,8 +7243,58 @@ const credential = applicationDefault();`.trim()
 	return (0, _hot_updater_cli_tools.createHotUpdaterConfigScaffoldFromBuilder)(builder, { helperStatements });
 };
 //#endregion
+//#region iac/firestoreDatabase.ts
+const FIRESTORE_DEFAULT_DATABASE_ID = "(default)";
+/**
+* The IDs of a project's databases the Firestore API can use, from
+* `gcloud firestore databases list --format=json`, whose names are
+* `projects/<project>/databases/<id>`: not Datastore mode, and not an
+* Enterprise database with Firestore data access disabled, the default for
+* MongoDB-compatible ones.
+*/
+const parseFirestoreDatabaseIds = (databases) => Array.isArray(databases) ? databases.flatMap((database) => {
+	if (typeof database !== "object" || database === null) return [];
+	const name = Reflect.get(database, "name");
+	if (typeof name !== "string" || Reflect.get(database, "type") === "DATASTORE_MODE" || Reflect.get(database, "firestoreDataAccessMode") === "DATA_ACCESS_MODE_DISABLED") return [];
+	return [name.slice(name.lastIndexOf("/") + 1)];
+}) : [];
+/**
+* The database init sets up: the saved one, the only one, or the one the
+* user selects. Without a saved one, non-interactive init keeps `(default)`
+* and needs `HOT_UPDATER_FIREBASE_DATABASE_ID` only to choose among named
+* databases.
+*/
+const resolveFirestoreDatabaseId = async ({ databaseIds, nonInteractive, savedDatabaseId }) => {
+	const input = initProvider.inputs.databaseId;
+	if (savedDatabaseId !== void 0) {
+		if (databaseIds.includes(savedDatabaseId)) return savedDatabaseId;
+		if (nonInteractive) throw new _hot_updater_cli_tools.MissingInitInputsError([input.envKey]);
+		_hot_updater_cli_tools.p.log.warn(`Saved Firestore database ${savedDatabaseId} was not found. Select a database again.`);
+	}
+	const [onlyDatabaseId] = databaseIds;
+	if (databaseIds.length === 1 && onlyDatabaseId !== void 0) return onlyDatabaseId;
+	const hasDefault = databaseIds.includes(FIRESTORE_DEFAULT_DATABASE_ID);
+	if (nonInteractive) {
+		if (hasDefault) return FIRESTORE_DEFAULT_DATABASE_ID;
+		throw new _hot_updater_cli_tools.MissingInitInputsError([input.envKey]);
+	}
+	const selected = await _hot_updater_cli_tools.p.select({
+		initialValue: hasDefault ? FIRESTORE_DEFAULT_DATABASE_ID : onlyDatabaseId,
+		message: input.prompt.message,
+		options: databaseIds.map((databaseId) => ({
+			value: databaseId,
+			label: databaseId
+		}))
+	});
+	if (_hot_updater_cli_tools.p.isCancel(selected)) {
+		_hot_updater_cli_tools.p.cancel("Operation cancelled.");
+		process.exit(1);
+	}
+	return selected;
+};
+//#endregion
 //#region iac/select.ts
-const setEnv = async ({ applicationCredentials, projectId, storageBucket, build, region }) => {
+const setEnv = async ({ applicationCredentials, databaseId, projectId, storageBucket, build, region }) => {
 	await (0, _hot_updater_cli_tools.makeEnv)({
 		[initProvider.inputs.applicationCredentials.envKey]: {
 			comment: "Project Settings > Service Accounts > New Private Key > Download JSON",
@@ -7237,6 +7302,7 @@ const setEnv = async ({ applicationCredentials, projectId, storageBucket, build,
 		},
 		[initProvider.inputs.projectId.envKey]: projectId,
 		[initProvider.inputs.region.envKey]: region,
+		[initProvider.inputs.databaseId.envKey]: databaseId,
 		HOT_UPDATER_FIREBASE_STORAGE_BUCKET: storageBucket
 	}, ".env.hotupdater", { preserveKeys: applicationCredentials ? [] : [initProvider.inputs.applicationCredentials.envKey] });
 	_hot_updater_cli_tools.p.log.success("Firebase credentials have been successfully configured.");
@@ -7286,7 +7352,7 @@ const listProjects = async (nonInteractive = false, cliEnv) => {
 		throw error;
 	}
 };
-const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false, cliEnv, resolveCliEnv) => {
+const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false, cliEnv, resolveCliEnv, preferredDatabaseId) => {
 	if (!cliEnv) try {
 		const authList = await execa("gcloud", [
 			"auth",
@@ -7376,6 +7442,7 @@ const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false,
 			}
 		}
 	}]);
+	let databaseIds = [];
 	try {
 		const databases = await execa("gcloud", [
 			"firestore",
@@ -7391,7 +7458,8 @@ const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false,
 			*/
 			input: "N\n"
 		});
-		if (JSON.parse(databases.stdout).length === 0) {
+		databaseIds = parseFirestoreDatabaseIds(JSON.parse(databases.stdout));
+		if (databaseIds.length === 0) {
 			_hot_updater_cli_tools.p.log.warning("Firestore Database not found");
 			_hot_updater_cli_tools.p.log.step("Please enable Firestore in the Firebase Console:");
 			_hot_updater_cli_tools.p.log.step((0, _hot_updater_cli_tools.link)(`https://console.firebase.google.com/project/${projectId}/firestore`));
@@ -7401,6 +7469,11 @@ const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false,
 	} catch (err) {
 		handleError(err instanceof Error ? err : new Error(String(err)));
 	}
+	const databaseId = await resolveFirestoreDatabaseId({
+		databaseIds,
+		nonInteractive,
+		savedDatabaseId: preferredDatabaseId
+	});
 	let storageBucket = null;
 	await _hot_updater_cli_tools.p.tasks([{
 		title: "Getting storage bucket...",
@@ -7440,6 +7513,7 @@ const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false,
 	}
 	return {
 		status: "ready",
+		databaseId,
 		storageBucket,
 		projectNumber,
 		projectId
@@ -7551,10 +7625,23 @@ const mergeIndexes = (originalIndexes, newIndexes) => {
 		fieldOverrides: [...originalIndexes.fieldOverrides.filter((original) => !replaced(original)), ...newIndexes.fieldOverrides]
 	};
 };
-const deployFirestore = async (cwd, nonInteractive = false, cliEnv) => {
+/** Points the template's `firebase.json` at the database init sets up. */
+const setFirestoreDatabase = async (cwd, databaseId) => {
+	const configPath = path.default.join(cwd, "firebase.json");
+	const config = JSON.parse(await fs.default.promises.readFile(configPath, "utf-8"));
+	config.firestore = {
+		...config.firestore,
+		database: databaseId
+	};
+	await fs.default.promises.writeFile(configPath, JSON.stringify(config, null, 2));
+};
+const deployFirestore = async (cwd, databaseId, nonInteractive = false, cliEnv) => {
+	await setFirestoreDatabase(cwd, databaseId);
 	const original = await execa("npx", [
 		"firebase",
 		"firestore:indexes",
+		"--database",
+		databaseId,
 		...nonInteractive ? ["--non-interactive"] : []
 	], {
 		cwd,
@@ -7674,10 +7761,11 @@ const runInit = async ({ build, envFile }) => {
 			projectId
 		});
 		return cliEnv;
-	});
+	}, savedInputs.databaseId);
 	if (initializeVariable.status === "ready") {
 		await assertFirebaseInfrastructureCanInitialize({
 			applicationCredentials,
+			databaseId: initializeVariable.databaseId,
 			projectId: initializeVariable.projectId
 		});
 		await ensureCloudFunctionsApiEnabled(initializeVariable.projectId, cliEnv);
@@ -7693,6 +7781,7 @@ const runInit = async ({ build, envFile }) => {
 	const resolvedInputs = {
 		...savedInputs,
 		applicationCredentials: applicationCredentials || void 0,
+		databaseId: initializeVariable.status === "ready" ? initializeVariable.databaseId : savedInputs.databaseId,
 		projectId: initializeVariable.projectId,
 		region: currentRegion
 	};
@@ -7716,9 +7805,13 @@ const runInit = async ({ build, envFile }) => {
 		await removeTmpDir();
 		return;
 	}
-	const functionsCode = (0, _hot_updater_cli_tools.transformEnv)(functionsIndexPath, { REGION: currentRegion });
+	const functionsCode = (0, _hot_updater_cli_tools.transformEnv)(functionsIndexPath, {
+		REGION: currentRegion,
+		FIRESTORE_DATABASE_ID: initializeVariable.databaseId
+	});
 	await fs.default.promises.writeFile(functionsIndexPath, functionsCode);
 	await setEnv({
+		databaseId: initializeVariable.databaseId,
 		projectId: initializeVariable.projectId,
 		storageBucket: initializeVariable.storageBucket,
 		build,
@@ -7739,11 +7832,12 @@ const runInit = async ({ build, envFile }) => {
 			}
 		}
 	}]);
-	await deployFirestore(tmpDir, nonInteractive, cliEnv);
+	await deployFirestore(tmpDir, initializeVariable.databaseId, nonInteractive, cliEnv);
 	const credential = applicationCredentials ? (0, firebase_admin_app.cert)(JSON.parse(await fs.default.promises.readFile(applicationCredentials, "utf-8"))) : (0, firebase_admin_app.applicationDefault)();
 	const existingApps = new Set((0, firebase_admin_app.getApps)());
 	const databaseConfig = {
 		credential,
+		databaseId: initializeVariable.databaseId,
 		projectId: initializeVariable.projectId
 	};
 	const database = firebaseDatabase(databaseConfig);
@@ -7820,3 +7914,4 @@ const runInit = async ({ build, envFile }) => {
 exports.initProvider = initProvider;
 exports.mergeIndexes = mergeIndexes;
 exports.runInit = runInit;
+exports.setFirestoreDatabase = setFirestoreDatabase;

package/dist/init/index.d.cts

@@ -22,6 +22,16 @@ declare const initProvider: {
       };
       readonly validate: (value: string | undefined) => value is string;
     };
+    readonly databaseId: {
+      readonly envKey: "HOT_UPDATER_FIREBASE_DATABASE_ID";
+      readonly help: "Firestore database ID";
+      readonly optional: true;
+      readonly prompt: {
+        readonly message: "Select a Firestore database";
+        readonly type: "select";
+      };
+      readonly validate: (value: string | undefined) => value is string;
+    };
     readonly applicationCredentials: {
       readonly envKey: "GOOGLE_APPLICATION_CREDENTIALS";
       readonly help: "Service account JSON path";
@@ -74,6 +84,8 @@ declare const mergeIndexes: (originalIndexes: {
   indexes: FirebaseIndex[];
   fieldOverrides: FieldOverride[];
 };
+/** Points the template's `firebase.json` at the database init sets up. */
+declare const setFirestoreDatabase: (cwd: string, databaseId: string) => Promise<void>;
 declare const runInit: ({ build, envFile }: RunInitOptions) => Promise<void>;
 //#endregion
-export { initProvider, mergeIndexes, runInit };
+export { initProvider, mergeIndexes, runInit, setFirestoreDatabase };

package/dist/init/index.d.mts

@@ -22,6 +22,16 @@ declare const initProvider: {
       };
       readonly validate: (value: string | undefined) => value is string;
     };
+    readonly databaseId: {
+      readonly envKey: "HOT_UPDATER_FIREBASE_DATABASE_ID";
+      readonly help: "Firestore database ID";
+      readonly optional: true;
+      readonly prompt: {
+        readonly message: "Select a Firestore database";
+        readonly type: "select";
+      };
+      readonly validate: (value: string | undefined) => value is string;
+    };
     readonly applicationCredentials: {
       readonly envKey: "GOOGLE_APPLICATION_CREDENTIALS";
       readonly help: "Service account JSON path";
@@ -74,6 +84,8 @@ declare const mergeIndexes: (originalIndexes: {
   indexes: FirebaseIndex[];
   fieldOverrides: FieldOverride[];
 };
+/** Points the template's `firebase.json` at the database init sets up. */
+declare const setFirestoreDatabase: (cwd: string, databaseId: string) => Promise<void>;
 declare const runInit: ({ build, envFile }: RunInitOptions) => Promise<void>;
 //#endregion
-export { initProvider, mergeIndexes, runInit };
+export { initProvider, mergeIndexes, runInit, setFirestoreDatabase };

package/dist/init/index.mjs

@@ -6857,10 +6857,11 @@ const createFirestoreStore = ({ firestore, collection, nativePageSize }) => {
 };
 //#endregion
 //#region src/firebaseDatabase.ts
-const adapterOf = ({ collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
+const adapterOf = ({ databaseId, collection = FIREBASE_V1_COLLECTION, aggregateBatching: _, ...appOptions }) => {
 	const app = getApps().length ? getApp() : initializeApp(appOptions);
+	const firestore = databaseId ? getFirestore(app, databaseId) : getFirestore(app);
 	return createKvAdapter({ store: createFirestoreStore({
-		firestore: getFirestore(app),
+		firestore,
 		collection
 	}) });
 };
@@ -6881,6 +6882,8 @@ const firebaseDatabase = (config) => createEngineDatabase({
 //#region iac/init/index.ts
 const isFirebaseRegion = (value) => value !== void 0 && /^[a-z]+(?:-[a-z]+)+[0-9]+$/.test(value);
 const isFirebaseProjectId = (value) => value !== void 0 && /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/.test(value);
+/** `(default)`, or a named database's ID: 4-63 lowercase letters, digits, or hyphens. */
+const isFirestoreDatabaseId = (value) => value !== void 0 && (value === "(default)" || /^[a-z][a-z0-9-]{2,61}[a-z0-9]$/.test(value));
 const initProvider = {
 	label: "Firebase",
 	inputs: {
@@ -6903,6 +6906,16 @@ const initProvider = {
 			},
 			validate: isFirebaseRegion
 		},
+		databaseId: {
+			envKey: "HOT_UPDATER_FIREBASE_DATABASE_ID",
+			help: "Firestore database ID",
+			optional: true,
+			prompt: {
+				message: "Select a Firestore database",
+				type: "select"
+			},
+			validate: isFirestoreDatabaseId
+		},
 		applicationCredentials: {
 			envKey: "GOOGLE_APPLICATION_CREDENTIALS",
 			help: "Service account JSON path",
@@ -6947,15 +6960,15 @@ const firebaseEngineSettingDocumentId = () => firestoreDocumentId({
 	pk: SETTINGS_TABLE.name,
 	sk: encodeKvKey([ENGINE_SETTING])
 });
-const assertFirebaseInfrastructureCanInitialize = async ({ applicationCredentials, projectId }) => {
+const assertFirebaseInfrastructureCanInitialize = async ({ applicationCredentials, databaseId, projectId }) => {
 	const credential = applicationCredentials ? cert(JSON.parse(await fs$1.readFile(applicationCredentials, "utf8"))) : applicationDefault();
 	const app = initializeApp({
 		credential,
 		projectId
 	}, `hot-updater-init-${projectId}-${Date.now()}`);
 	try {
-		const setting = await getFirestore(app).collection(FIREBASE_V1_COLLECTION).doc(firebaseEngineSettingDocumentId()).get();
-		if (resolveFirebaseInfrastructureState({ engine: setting.exists ? setting.get("row.value") : void 0 }) === "incompatible") throw new InitError(`Firebase v1 infrastructure in project ${projectId} records an unsupported database version. Use a new Firebase project, or delete the ${FIREBASE_V1_COLLECTION} collection, then rerun init.`);
+		const setting = await getFirestore(app, databaseId).collection(FIREBASE_V1_COLLECTION).doc(firebaseEngineSettingDocumentId()).get();
+		if (resolveFirebaseInfrastructureState({ engine: setting.exists ? setting.get("row.value") : void 0 }) === "incompatible") throw new InitError(`Firebase v1 infrastructure in project ${projectId} (Firestore database ${databaseId}) records an unsupported database version. Use a new Firebase project, or delete the ${FIREBASE_V1_COLLECTION} collection, then rerun init.`);
 	} catch (error) {
 		if (error instanceof InitError) throw error;
 		const code = typeof error === "object" && error !== null ? Reflect.get(error, "code") : void 0;
@@ -6999,6 +7012,7 @@ const resolveFirebaseInitInputs = (existingEnv) => {
 	const applicationCredentials = resolveInitProviderInput(existingEnv, inputs.applicationCredentials);
 	return {
 		applicationCredentials: applicationCredentials === "your-credentials.json" ? void 0 : applicationCredentials,
+		databaseId: resolveInitProviderInput(existingEnv, inputs.databaseId),
 		projectId: resolveInitProviderInput(existingEnv, inputs.projectId),
 		region: resolveInitProviderInput(existingEnv, inputs.region)
 	};
@@ -7191,6 +7205,7 @@ const getConfigScaffold = (build) => {
 		}],
 		configString: `firebaseDatabase({
     projectId: process.env.HOT_UPDATER_FIREBASE_PROJECT_ID!,
+    databaseId: process.env.HOT_UPDATER_FIREBASE_DATABASE_ID,
     credential,
   })`
 	};
@@ -7221,8 +7236,58 @@ const credential = applicationDefault();`.trim()
 	return createHotUpdaterConfigScaffoldFromBuilder(builder, { helperStatements });
 };
 //#endregion
+//#region iac/firestoreDatabase.ts
+const FIRESTORE_DEFAULT_DATABASE_ID = "(default)";
+/**
+* The IDs of a project's databases the Firestore API can use, from
+* `gcloud firestore databases list --format=json`, whose names are
+* `projects/<project>/databases/<id>`: not Datastore mode, and not an
+* Enterprise database with Firestore data access disabled, the default for
+* MongoDB-compatible ones.
+*/
+const parseFirestoreDatabaseIds = (databases) => Array.isArray(databases) ? databases.flatMap((database) => {
+	if (typeof database !== "object" || database === null) return [];
+	const name = Reflect.get(database, "name");
+	if (typeof name !== "string" || Reflect.get(database, "type") === "DATASTORE_MODE" || Reflect.get(database, "firestoreDataAccessMode") === "DATA_ACCESS_MODE_DISABLED") return [];
+	return [name.slice(name.lastIndexOf("/") + 1)];
+}) : [];
+/**
+* The database init sets up: the saved one, the only one, or the one the
+* user selects. Without a saved one, non-interactive init keeps `(default)`
+* and needs `HOT_UPDATER_FIREBASE_DATABASE_ID` only to choose among named
+* databases.
+*/
+const resolveFirestoreDatabaseId = async ({ databaseIds, nonInteractive, savedDatabaseId }) => {
+	const input = initProvider.inputs.databaseId;
+	if (savedDatabaseId !== void 0) {
+		if (databaseIds.includes(savedDatabaseId)) return savedDatabaseId;
+		if (nonInteractive) throw new MissingInitInputsError([input.envKey]);
+		p.log.warn(`Saved Firestore database ${savedDatabaseId} was not found. Select a database again.`);
+	}
+	const [onlyDatabaseId] = databaseIds;
+	if (databaseIds.length === 1 && onlyDatabaseId !== void 0) return onlyDatabaseId;
+	const hasDefault = databaseIds.includes(FIRESTORE_DEFAULT_DATABASE_ID);
+	if (nonInteractive) {
+		if (hasDefault) return FIRESTORE_DEFAULT_DATABASE_ID;
+		throw new MissingInitInputsError([input.envKey]);
+	}
+	const selected = await p.select({
+		initialValue: hasDefault ? FIRESTORE_DEFAULT_DATABASE_ID : onlyDatabaseId,
+		message: input.prompt.message,
+		options: databaseIds.map((databaseId) => ({
+			value: databaseId,
+			label: databaseId
+		}))
+	});
+	if (p.isCancel(selected)) {
+		p.cancel("Operation cancelled.");
+		process.exit(1);
+	}
+	return selected;
+};
+//#endregion
 //#region iac/select.ts
-const setEnv = async ({ applicationCredentials, projectId, storageBucket, build, region }) => {
+const setEnv = async ({ applicationCredentials, databaseId, projectId, storageBucket, build, region }) => {
 	await makeEnv({
 		[initProvider.inputs.applicationCredentials.envKey]: {
 			comment: "Project Settings > Service Accounts > New Private Key > Download JSON",
@@ -7230,6 +7295,7 @@ const setEnv = async ({ applicationCredentials, projectId, storageBucket, build,
 		},
 		[initProvider.inputs.projectId.envKey]: projectId,
 		[initProvider.inputs.region.envKey]: region,
+		[initProvider.inputs.databaseId.envKey]: databaseId,
 		HOT_UPDATER_FIREBASE_STORAGE_BUCKET: storageBucket
 	}, ".env.hotupdater", { preserveKeys: applicationCredentials ? [] : [initProvider.inputs.applicationCredentials.envKey] });
 	p.log.success("Firebase credentials have been successfully configured.");
@@ -7279,7 +7345,7 @@ const listProjects = async (nonInteractive = false, cliEnv) => {
 		throw error;
 	}
 };
-const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false, cliEnv, resolveCliEnv) => {
+const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false, cliEnv, resolveCliEnv, preferredDatabaseId) => {
 	if (!cliEnv) try {
 		const authList = await execa("gcloud", [
 			"auth",
@@ -7369,6 +7435,7 @@ const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false,
 			}
 		}
 	}]);
+	let databaseIds = [];
 	try {
 		const databases = await execa("gcloud", [
 			"firestore",
@@ -7384,7 +7451,8 @@ const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false,
 			*/
 			input: "N\n"
 		});
-		if (JSON.parse(databases.stdout).length === 0) {
+		databaseIds = parseFirestoreDatabaseIds(JSON.parse(databases.stdout));
+		if (databaseIds.length === 0) {
 			p.log.warning("Firestore Database not found");
 			p.log.step("Please enable Firestore in the Firebase Console:");
 			p.log.step(link(`https://console.firebase.google.com/project/${projectId}/firestore`));
@@ -7394,6 +7462,11 @@ const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false,
 	} catch (err) {
 		handleError(err instanceof Error ? err : new Error(String(err)));
 	}
+	const databaseId = await resolveFirestoreDatabaseId({
+		databaseIds,
+		nonInteractive,
+		savedDatabaseId: preferredDatabaseId
+	});
 	let storageBucket = null;
 	await p.tasks([{
 		title: "Getting storage bucket...",
@@ -7433,6 +7506,7 @@ const initFirebaseUser = async (cwd, preferredProjectId, nonInteractive = false,
 	}
 	return {
 		status: "ready",
+		databaseId,
 		storageBucket,
 		projectNumber,
 		projectId
@@ -7544,10 +7618,23 @@ const mergeIndexes = (originalIndexes, newIndexes) => {
 		fieldOverrides: [...originalIndexes.fieldOverrides.filter((original) => !replaced(original)), ...newIndexes.fieldOverrides]
 	};
 };
-const deployFirestore = async (cwd, nonInteractive = false, cliEnv) => {
+/** Points the template's `firebase.json` at the database init sets up. */
+const setFirestoreDatabase = async (cwd, databaseId) => {
+	const configPath = path.join(cwd, "firebase.json");
+	const config = JSON.parse(await fs.promises.readFile(configPath, "utf-8"));
+	config.firestore = {
+		...config.firestore,
+		database: databaseId
+	};
+	await fs.promises.writeFile(configPath, JSON.stringify(config, null, 2));
+};
+const deployFirestore = async (cwd, databaseId, nonInteractive = false, cliEnv) => {
+	await setFirestoreDatabase(cwd, databaseId);
 	const original = await execa("npx", [
 		"firebase",
 		"firestore:indexes",
+		"--database",
+		databaseId,
 		...nonInteractive ? ["--non-interactive"] : []
 	], {
 		cwd,
@@ -7667,10 +7754,11 @@ const runInit = async ({ build, envFile }) => {
 			projectId
 		});
 		return cliEnv;
-	});
+	}, savedInputs.databaseId);
 	if (initializeVariable.status === "ready") {
 		await assertFirebaseInfrastructureCanInitialize({
 			applicationCredentials,
+			databaseId: initializeVariable.databaseId,
 			projectId: initializeVariable.projectId
 		});
 		await ensureCloudFunctionsApiEnabled(initializeVariable.projectId, cliEnv);
@@ -7686,6 +7774,7 @@ const runInit = async ({ build, envFile }) => {
 	const resolvedInputs = {
 		...savedInputs,
 		applicationCredentials: applicationCredentials || void 0,
+		databaseId: initializeVariable.status === "ready" ? initializeVariable.databaseId : savedInputs.databaseId,
 		projectId: initializeVariable.projectId,
 		region: currentRegion
 	};
@@ -7709,9 +7798,13 @@ const runInit = async ({ build, envFile }) => {
 		await removeTmpDir();
 		return;
 	}
-	const functionsCode = transformEnv(functionsIndexPath, { REGION: currentRegion });
+	const functionsCode = transformEnv(functionsIndexPath, {
+		REGION: currentRegion,
+		FIRESTORE_DATABASE_ID: initializeVariable.databaseId
+	});
 	await fs.promises.writeFile(functionsIndexPath, functionsCode);
 	await setEnv({
+		databaseId: initializeVariable.databaseId,
 		projectId: initializeVariable.projectId,
 		storageBucket: initializeVariable.storageBucket,
 		build,
@@ -7732,11 +7825,12 @@ const runInit = async ({ build, envFile }) => {
 			}
 		}
 	}]);
-	await deployFirestore(tmpDir, nonInteractive, cliEnv);
+	await deployFirestore(tmpDir, initializeVariable.databaseId, nonInteractive, cliEnv);
 	const credential = applicationCredentials ? cert(JSON.parse(await fs.promises.readFile(applicationCredentials, "utf-8"))) : applicationDefault();
 	const existingApps = new Set(getApps());
 	const databaseConfig = {
 		credential,
+		databaseId: initializeVariable.databaseId,
 		projectId: initializeVariable.projectId
 	};
 	const database = firebaseDatabase(databaseConfig);
@@ -7810,4 +7904,4 @@ const runInit = async ({ build, envFile }) => {
 	p.log.success("Done! 🎉");
 };
 //#endregion
-export { initProvider, mergeIndexes, runInit };
+export { initProvider, mergeIndexes, runInit, setFirestoreDatabase };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/firebase",
   "type": "module",
-  "version": "1.0.0-rc.47",
+  "version": "1.0.1",
   "description": "React Native OTA solution for self-hosted",
   "main": "dist/index.cjs",
   "types": "dist/index.d.cts",
@@ -37,10 +37,10 @@
   ],
   "dependencies": {
     "hono": "4.12.34",
-    "@hot-updater/plugin-core": "1.0.0-rc.47",
-    "@hot-updater/cli-tools": "1.0.0-rc.47",
-    "@hot-updater/protocol": "1.0.0-rc.47",
-    "@hot-updater/server": "1.0.0-rc.47"
+    "@hot-updater/cli-tools": "1.0.1",
+    "@hot-updater/server": "1.0.1",
+    "@hot-updater/plugin-core": "1.0.1",
+    "@hot-updater/protocol": "1.0.1"
   },
   "publishConfig": {
     "access": "public"
@@ -55,11 +55,11 @@
     "firebase-tools": "15.29.0",
     "fkill": "^9.0.0",
     "mime": "^4.0.4",
-    "@hot-updater/mock": "1.0.0-rc.47",
-    "@hot-updater/test-utils": "1.0.0-rc.47"
+    "@hot-updater/mock": "1.0.1",
+    "@hot-updater/test-utils": "1.0.1"
   },
   "peerDependencies": {
-    "firebase-admin": "*",
+    "firebase-admin": ">=11.10.0",
     "firebase-functions": "*"
   },
   "peerDependenciesMeta": {