firebase-functions 7.2.0-rc.0 → 7.2.0

package/lib/esm/params/index.mjs

@@ -1,5 +1,5 @@
 import { __export } from "../_virtual/rolldown_runtime.mjs";
-import { BUCKET_PICKER, BooleanParam, Expression, FloatParam, IntParam, InternalExpression, JsonSecretParam, ListParam, SecretParam, StringParam, multiSelect, select } from "./types.mjs";
+import { BUCKET_PICKER, BooleanParam, Expression, FloatParam, IntParam, InternalExpression, InterpolationExpression, JsonSecretParam, ListParam, SecretParam, StringParam, multiSelect, select } from "./types.mjs";
 
 //#region src/params/index.ts
 var params_exports = /* @__PURE__ */ __export({
@@ -15,6 +15,7 @@ var params_exports = /* @__PURE__ */ __export({
 	defineList: () => defineList,
 	defineSecret: () => defineSecret,
 	defineString: () => defineString,
+	expr: () => expr,
 	gcloudProject: () => gcloudProject,
 	multiSelect: () => multiSelect,
 	projectID: () => projectID,
@@ -59,23 +60,23 @@ function clearParams() {
 * A built-in parameter that resolves to the default RTDB database URL associated
 * with the project, without prompting the deployer. Empty string if none exists.
 */
-const databaseURL = new InternalExpression("DATABASE_URL", (env) => JSON.parse(env.FIREBASE_CONFIG)?.databaseURL || "");
+const databaseURL = new InternalExpression("DATABASE_URL", (env) => JSON.parse(env.FIREBASE_CONFIG || "{}")?.databaseURL || "");
 /**
 * A built-in parameter that resolves to the Cloud project ID associated with
 * the project, without prompting the deployer.
 */
-const projectID = new InternalExpression("PROJECT_ID", (env) => JSON.parse(env.FIREBASE_CONFIG)?.projectId || "");
+const projectID = new InternalExpression("PROJECT_ID", (env) => JSON.parse(env.FIREBASE_CONFIG || "{}")?.projectId || "");
 /**
 * A built-in parameter that resolves to the Cloud project ID, without prompting
 * the deployer.
 */
-const gcloudProject = new InternalExpression("GCLOUD_PROJECT", (env) => JSON.parse(env.FIREBASE_CONFIG)?.projectId || "");
+const gcloudProject = new InternalExpression("GCLOUD_PROJECT", (env) => JSON.parse(env.FIREBASE_CONFIG || "{}")?.projectId || "");
 /**
 * A builtin parameter that resolves to the Cloud storage bucket associated
 * with the function, without prompting the deployer. Empty string if not
 * defined.
 */
-const storageBucket = new InternalExpression("STORAGE_BUCKET", (env) => JSON.parse(env.FIREBASE_CONFIG)?.storageBucket || "");
+const storageBucket = new InternalExpression("STORAGE_BUCKET", (env) => JSON.parse(env.FIREBASE_CONFIG || "{}")?.storageBucket || "");
 /**
 * Declares a secret param, that will persist values only in Cloud Secret Manager.
 * Secrets are stored internally as bytestrings. Use `ParamOptions.as` to provide type
@@ -84,8 +85,8 @@ const storageBucket = new InternalExpression("STORAGE_BUCKET", (env) => JSON.par
 * @param name The name of the environment variable to use to load the parameter.
 * @returns A parameter with a `string` return type for `.value`.
 */
-function defineSecret(name) {
-	const param = new SecretParam(name);
+function defineSecret(name, options = {}) {
+	const param = new SecretParam(name, options);
 	registerParam(param);
 	return param;
 }
@@ -101,8 +102,8 @@ function defineSecret(name) {
 * @returns A parameter whose `.value()` method returns the parsed JSON object.
 * ```
 */
-function defineJsonSecret(name) {
-	const param = new JsonSecretParam(name);
+function defineJsonSecret(name, options = {}) {
+	const param = new JsonSecretParam(name, options);
 	registerParam(param);
 	return param;
 }
@@ -168,6 +169,19 @@ function defineList(name, options = {}) {
 	registerParam(param);
 	return param;
 }
+/**
+* Creates an Expression representing a string, which can interpolate
+* other Expressions into it using template literal syntax.
+*
+* @example
+* ```
+* const topicParam = defineString('TOPIC');
+* const topicExpr = expr`projects/my-project/topics/${topicParam}`;
+* ```
+*/
+function expr(strings, ...values) {
+	return new InterpolationExpression(strings, values);
+}
 
 //#endregion
-export { BUCKET_PICKER, Expression, clearParams, databaseURL, declaredParams, defineBoolean, defineFloat, defineInt, defineJsonSecret, defineList, defineSecret, defineString, gcloudProject, multiSelect, params_exports, projectID, select, storageBucket };
+export { BUCKET_PICKER, Expression, clearParams, databaseURL, declaredParams, defineBoolean, defineFloat, defineInt, defineJsonSecret, defineList, defineSecret, defineString, expr, gcloudProject, multiSelect, params_exports, projectID, select, storageBucket };

package/lib/esm/params/types.mjs

@@ -37,9 +37,56 @@ var Expression = class {
 		return this.toString();
 	}
 };
+/**
+* An InterpolationExpression allows string fragments and Expressions to be
+* joined natively into a new Expression block evaluating to a string string.
+*/
+var InterpolationExpression = class extends Expression {
+	constructor(strings, values) {
+		super();
+		this.strings = strings;
+		this.values = values;
+	}
+	/** @internal */
+	runtimeValue() {
+		return this.strings.reduce((result, str, i) => {
+			const val = i < this.values.length ? String(valueOf(this.values[i])) : "";
+			return result + str + val;
+		}, "");
+	}
+	toCEL() {
+		return this.strings.reduce((result, str, i) => {
+			const val = i < this.values.length ? celOf(this.values[i]) : "";
+			return result + str + val;
+		}, "");
+	}
+};
+/** @internal */
+var TransformedStringExpression = class extends Expression {
+	constructor(source, transformer) {
+		super();
+		this.source = source;
+		this.transformer = transformer;
+	}
+	runtimeValue() {
+		return this.transformer(valueOf(this.source));
+	}
+	toCEL() {
+		return this.source instanceof Expression ? this.source.toCEL() : this.transformer(this.source);
+	}
+};
 function valueOf(arg) {
 	return arg instanceof Expression ? arg.runtimeValue() : arg;
 }
+function celOf(arg) {
+	return arg instanceof Expression ? arg.toCEL() : arg;
+}
+/**
+* Transforms a string or a string expression using a function.
+*/
+function transform(source, transformer) {
+	return new TransformedStringExpression(source, transformer);
+}
 /**
 * Returns how an entity (either an `Expression` or a literal value) should be represented in CEL.
 * - Expressions delegate to the `.toString()` method, which is used by the WireManifest
@@ -91,7 +138,7 @@ var CompareExpression = class extends Expression {
 	}
 	/** @internal */
 	runtimeValue() {
-		const left = this.lhs.runtimeValue();
+		const left = valueOf(this.lhs);
 		const right = valueOf(this.rhs);
 		switch (this.cmp) {
 			case "==": return Array.isArray(left) ? this.arrayEquals(left, right) : left === right;
@@ -108,8 +155,7 @@ var CompareExpression = class extends Expression {
 		return a.every((item) => b.includes(item)) && b.every((item) => a.includes(item));
 	}
 	toString() {
-		const rhsStr = refOf(this.rhs);
-		return `${this.lhs} ${this.cmp} ${rhsStr}`;
+		return `${refOf(this.lhs)} ${this.cmp} ${refOf(this.rhs)}`;
 	}
 	/** Returns a `TernaryExpression` which can resolve to one of two values, based on the resolution of this comparison. */
 	thenElse(ifTrue, ifFalse) {
@@ -231,7 +277,8 @@ var SecretParam = class {
 	static {
 		this.type = "secret";
 	}
-	constructor(name) {
+	constructor(name, options = {}) {
+		this.options = options;
 		this.name = name;
 	}
 	/** @internal */
@@ -246,7 +293,8 @@ var SecretParam = class {
 	toSpec() {
 		return {
 			type: "secret",
-			name: this.name
+			name: this.name,
+			...this.options
 		};
 	}
 	/** Returns the secret's value at runtime. Throws an error if accessed during deployment. */
@@ -268,7 +316,8 @@ var JsonSecretParam = class {
 	static {
 		this.type = "secret";
 	}
-	constructor(name) {
+	constructor(name, options = {}) {
+		this.options = options;
 		this.name = name;
 	}
 	/** @internal */
@@ -288,6 +337,7 @@ var JsonSecretParam = class {
 		return {
 			type: "secret",
 			name: this.name,
+			...this.options,
 			format: "json"
 		};
 	}
@@ -410,4 +460,4 @@ var ListParam = class extends Param {
 };
 
 //#endregion
-export { BUCKET_PICKER, BooleanParam, CompareExpression, Expression, FloatParam, IntParam, InternalExpression, JsonSecretParam, ListParam, Param, SecretParam, StringParam, TernaryExpression, multiSelect, select };
+export { BUCKET_PICKER, BooleanParam, CompareExpression, Expression, FloatParam, IntParam, InternalExpression, InterpolationExpression, JsonSecretParam, ListParam, Param, SecretParam, StringParam, TernaryExpression, TransformedStringExpression, celOf, multiSelect, select, transform, valueOf };

package/lib/esm/v1/cloud-functions.mjs

@@ -1,4 +1,5 @@
 import { warn } from "../logger/index.mjs";
+import { Expression, celOf, valueOf } from "../params/types.mjs";
 import { RESET_VALUE, ResetValue } from "../common/options.mjs";
 import { initV1Endpoint, initV1ScheduleTrigger } from "../runtime/manifest.mjs";
 import { Change } from "../common/change.mjs";
@@ -55,10 +56,11 @@ function makeCloudFunction({ contextOnlyHandler, dataConstructor = (raw) => raw.
 		if (triggerResource() == null) {
 			return {};
 		}
+		const tr = triggerResource();
 		const trigger = {
 			...optionsToTrigger(options),
 			eventTrigger: {
-				resource: triggerResource(),
+				resource: celOf(tr),
 				eventType: legacyEventType || provider + "." + eventType,
 				service
 			}
@@ -81,13 +83,16 @@ function makeCloudFunction({ contextOnlyHandler, dataConstructor = (raw) => raw.
 			...optionsToEndpoint(options)
 		};
 		if (options.schedule) {
-			endpoint.scheduleTrigger = initV1ScheduleTrigger(options.schedule.schedule, options);
+			endpoint.scheduleTrigger = initV1ScheduleTrigger(celOf(options.schedule.schedule), options);
 			copyIfPresent(endpoint.scheduleTrigger, options.schedule, "timeZone");
+			if (endpoint.scheduleTrigger.timeZone instanceof Expression) {
+				endpoint.scheduleTrigger.timeZone = endpoint.scheduleTrigger.timeZone.toCEL();
+			}
 			copyIfPresent(endpoint.scheduleTrigger.retryConfig, options.schedule.retryConfig, "retryCount", "maxDoublings", "maxBackoffDuration", "maxRetryDuration", "minBackoffDuration");
 		} else {
 			endpoint.eventTrigger = {
 				eventType: legacyEventType || provider + "." + eventType,
-				eventFilters: { resource: triggerResource() },
+				eventFilters: { resource: celOf(triggerResource()) },
 				retry: !!options.failurePolicy
 			};
 		}
@@ -110,7 +115,7 @@ function _makeParams(context, triggerResourceGetter) {
 	if (!context.resource) {
 		return {};
 	}
-	const triggerResource = triggerResourceGetter();
+	const triggerResource = valueOf(triggerResourceGetter());
 	const wildcards = triggerResource.match(WILDCARD_REGEX);
 	const params = {};
 	const eventResourceParts = context?.resource?.name?.split?.("/");

package/lib/esm/v1/providers/analytics.mjs

@@ -1,4 +1,5 @@
 import { __export } from "../../_virtual/rolldown_runtime.mjs";
+import { expr } from "../../params/index.mjs";
 import { makeCloudFunction } from "../cloud-functions.mjs";
 
 //#region src/v1/providers/analytics.ts
@@ -34,7 +35,7 @@ function _eventWithOptions(analyticsEventType, options) {
 		if (!process.env.GCLOUD_PROJECT) {
 			throw new Error("process.env.GCLOUD_PROJECT is not set.");
 		}
-		return "projects/" + process.env.GCLOUD_PROJECT + "/events/" + analyticsEventType;
+		return expr`projects/${process.env.GCLOUD_PROJECT}/events/${analyticsEventType}`;
 	}, options);
 }
 /**
@@ -43,7 +44,7 @@ function _eventWithOptions(analyticsEventType, options) {
 * Access via `functions.analytics.event()`.
 */
 var AnalyticsEventBuilder = class {
-	/** @hidden */
+	/** @internal */
 	constructor(triggerResource, options) {
 		this.triggerResource = triggerResource;
 		this.options = options;

package/lib/esm/v1/providers/database.mjs

@@ -1,4 +1,6 @@
 import { __export } from "../../_virtual/rolldown_runtime.mjs";
+import { transform } from "../../params/types.mjs";
+import { expr } from "../../params/index.mjs";
 import { firebaseConfig } from "../../common/config.mjs";
 import { getApp } from "../../common/app.mjs";
 import { makeCloudFunction } from "../cloud-functions.mjs";
@@ -96,14 +98,14 @@ var InstanceBuilder = class {
 	* @returns Firebase Realtime Database reference builder interface.
 	*/
 	ref(path) {
-		const normalized = normalizePath(path);
-		return new RefBuilder(() => `projects/_/instances/${this.instance}/refs/${normalized}`, this.options);
+		const normalized = transform(path, normalizePath);
+		return new RefBuilder(() => expr`projects/_/instances/${this.instance}/refs/${normalized}`, this.options);
 	}
 };
 /** @internal */
 function _refWithOptions(path, options) {
 	const resourceGetter = () => {
-		const normalized = normalizePath(path);
+		const normalized = transform(path, normalizePath);
 		const databaseURL = firebaseConfig().databaseURL;
 		if (!databaseURL) {
 			throw new Error("Missing expected firebase config value databaseURL, " + "config is actually" + JSON.stringify(firebaseConfig()) + "\n If you are unit testing, please set process.env.FIREBASE_CONFIG");
@@ -121,7 +123,7 @@ function _refWithOptions(path, options) {
 		if (!instance$1) {
 			throw new Error("Invalid value for config firebase.databaseURL: " + databaseURL);
 		}
-		return `projects/_/instances/${instance$1}/refs/${normalized}`;
+		return expr`projects/_/instances/${instance$1}/refs/${normalized}`;
 	};
 	return new RefBuilder(resourceGetter, options);
 }

package/lib/esm/v1/providers/firestore.mjs

@@ -1,8 +1,9 @@
 import { __export } from "../../_virtual/rolldown_runtime.mjs";
+import { CompareExpression, Expression } from "../../params/types.mjs";
+import { expr, projectID } from "../../params/index.mjs";
 import { Change } from "../../common/change.mjs";
 import { makeCloudFunction } from "../cloud-functions.mjs";
 import { createBeforeSnapshotFromJson, createSnapshotFromJson } from "../../common/providers/firestore.mjs";
-import { posix } from "path";
 
 //#region src/v1/providers/firestore.ts
 var firestore_exports = /* @__PURE__ */ __export({
@@ -74,13 +75,23 @@ var NamespaceBuilder = class {
 		this.namespace = namespace$1;
 	}
 	document(path) {
-		return new DocumentBuilder(() => {
+		const triggerResource = () => {
 			if (!process.env.GCLOUD_PROJECT) {
 				throw new Error("process.env.GCLOUD_PROJECT is not set.");
 			}
-			const database$1 = posix.join("projects", process.env.GCLOUD_PROJECT, "databases", this.database);
-			return posix.join(database$1, this.namespace ? `documents@${this.namespace}` : "documents", path);
-		}, this.options);
+			let project = projectID;
+			if (process.env.GCLOUD_PROJECT && process.env.FUNCTIONS_CONTROL_API !== "true") {
+				project = process.env.GCLOUD_PROJECT;
+			}
+			let nsPart = "";
+			if (this.namespace instanceof Expression) {
+				nsPart = new CompareExpression("==", this.namespace, "").thenElse("", expr`@${this.namespace}`);
+			} else if (this.namespace) {
+				nsPart = `@${this.namespace}`;
+			}
+			return expr`projects/${project}/databases/${this.database}/documents${nsPart}/${path}`;
+		};
+		return new DocumentBuilder(triggerResource, this.options);
 	}
 };
 function snapshotConstructor(event) {
@@ -93,6 +104,7 @@ function changeConstructor(raw) {
 	return Change.fromObjects(beforeSnapshotConstructor(raw), snapshotConstructor(raw));
 }
 var DocumentBuilder = class {
+	/** @internal */
 	constructor(triggerResource, options) {
 		this.triggerResource = triggerResource;
 		this.options = options;

package/lib/esm/v1/providers/pubsub.mjs

@@ -1,4 +1,6 @@
 import { __export } from "../../_virtual/rolldown_runtime.mjs";
+import { Expression } from "../../params/types.mjs";
+import { expr } from "../../params/index.mjs";
 import { makeCloudFunction } from "../cloud-functions.mjs";
 
 //#region src/v1/providers/pubsub.ts
@@ -29,15 +31,16 @@ function topic(topic$1) {
 }
 /** @internal */
 function _topicWithOptions(topic$1, options) {
-	if (topic$1.indexOf("/") !== -1) {
+	if (typeof topic$1 === "string" && topic$1.indexOf("/") !== -1) {
 		throw new Error("Topic name may not have a /");
 	}
-	return new TopicBuilder(() => {
+	const triggerResource = () => {
 		if (!process.env.GCLOUD_PROJECT) {
 			throw new Error("process.env.GCLOUD_PROJECT is not set.");
 		}
-		return `projects/${process.env.GCLOUD_PROJECT}/topics/${topic$1}`;
-	}, options);
+		return expr`projects/${process.env.GCLOUD_PROJECT}/topics/${topic$1}`;
+	};
+	return new TopicBuilder(triggerResource, options);
 }
 /**
 * The Google Cloud Pub/Sub topic builder.
@@ -89,7 +92,7 @@ function _scheduleWithOptions(schedule$1, options) {
 	};
 	return new ScheduleBuilder(triggerResource, {
 		...options,
-		schedule: { schedule: schedule$1 }
+		schedule: { schedule: schedule$1 instanceof Expression ? schedule$1.toCEL() : schedule$1 }
 	});
 }
 /**

package/lib/esm/v1/providers/storage.mjs

@@ -1,4 +1,5 @@
 import { __export } from "../../_virtual/rolldown_runtime.mjs";
+import { expr } from "../../params/index.mjs";
 import { firebaseConfig } from "../../common/config.mjs";
 import { makeCloudFunction } from "../cloud-functions.mjs";
 
@@ -40,14 +41,14 @@ function object() {
 /** @internal */
 function _bucketWithOptions(options, bucket$1) {
 	const resourceGetter = () => {
-		bucket$1 = bucket$1 || firebaseConfig().storageBucket;
-		if (!bucket$1) {
+		const bucketName = bucket$1 || firebaseConfig().storageBucket;
+		if (!bucketName) {
 			throw new Error("Missing bucket name. If you are unit testing, please provide a bucket name" + " through `functions.storage.bucket(bucketName)`, or set process.env.FIREBASE_CONFIG.");
 		}
-		if (!/^[a-z\d][a-z\d\\._-]{1,230}[a-z\d]$/.test(bucket$1)) {
-			throw new Error(`Invalid bucket name ${bucket$1}`);
+		if (typeof bucketName === "string" && !/^[a-z\d][a-z\d\\._-]{1,230}[a-z\d]$/.test(bucketName)) {
+			throw new Error(`Invalid bucket name ${bucketName}`);
 		}
-		return `projects/_/buckets/${bucket$1}`;
+		return expr`projects/_/buckets/${bucketName}`;
 	};
 	return new BucketBuilder(resourceGetter, options);
 }

package/lib/params/index.d.ts

@@ -2,11 +2,11 @@
  * @hidden
  * @alpha
  */
-import { BooleanParam, Expression, IntParam, Param, ParamOptions, SecretParam, JsonSecretParam, StringParam, ListParam } from "./types";
+import { BooleanParam, Expression, IntParam, Param, ParamOptions, SecretParam, JsonSecretParam, StringParam, ListParam, SecretParamOptions } from "./types";
 export { BUCKET_PICKER, select, multiSelect } from "./types";
 export type { TextInput, SelectInput, SelectOptions, MultiSelectInput, Param, SecretParam, JsonSecretParam, StringParam, BooleanParam, IntParam, ListParam, } from "./types";
 export { Expression };
-export type { ParamOptions };
+export type { ParamOptions, SecretParamOptions };
 type SecretOrExpr = Param<any> | SecretParam | JsonSecretParam<any>;
 export declare const declaredParams: SecretOrExpr[];
 /**
@@ -38,7 +38,7 @@ export declare const storageBucket: Param<string>;
  * @param name The name of the environment variable to use to load the parameter.
  * @returns A parameter with a `string` return type for `.value`.
  */
-export declare function defineSecret(name: string): SecretParam;
+export declare function defineSecret(name: string, options?: SecretParamOptions): SecretParam;
 /**
  * Declares a secret parameter that retrieves a structured JSON object in Cloud Secret Manager.
  * This is useful for managing groups of related configuration values, such as all settings
@@ -51,7 +51,7 @@ export declare function defineSecret(name: string): SecretParam;
  * @returns A parameter whose `.value()` method returns the parsed JSON object.
  * ```
  */
-export declare function defineJsonSecret<T = any>(name: string): JsonSecretParam<T>;
+export declare function defineJsonSecret<T = any>(name: string, options?: SecretParamOptions): JsonSecretParam<T>;
 /**
  * Declare a string parameter.
  *
@@ -84,3 +84,14 @@ export declare function defineInt(name: string, options?: ParamOptions<number>):
  * @returns A parameter with a `string[]` return type for `.value`.
  */
 export declare function defineList(name: string, options?: ParamOptions<string[]>): ListParam;
+/**
+ * Creates an Expression representing a string, which can interpolate
+ * other Expressions into it using template literal syntax.
+ *
+ * @example
+ * ```
+ * const topicParam = defineString('TOPIC');
+ * const topicExpr = expr`projects/my-project/topics/${topicParam}`;
+ * ```
+ */
+export declare function expr(strings: TemplateStringsArray, ...values: (string | Expression<string>)[]): Expression<string>;

package/lib/params/index.js

@@ -15,6 +15,7 @@ var params_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
 	defineList: () => defineList,
 	defineSecret: () => defineSecret,
 	defineString: () => defineString,
+	expr: () => expr,
 	gcloudProject: () => gcloudProject,
 	multiSelect: () => require_params_types.multiSelect,
 	projectID: () => projectID,
@@ -59,23 +60,23 @@ function clearParams() {
 * A built-in parameter that resolves to the default RTDB database URL associated
 * with the project, without prompting the deployer. Empty string if none exists.
 */
-const databaseURL = new require_params_types.InternalExpression("DATABASE_URL", (env) => JSON.parse(env.FIREBASE_CONFIG)?.databaseURL || "");
+const databaseURL = new require_params_types.InternalExpression("DATABASE_URL", (env) => JSON.parse(env.FIREBASE_CONFIG || "{}")?.databaseURL || "");
 /**
 * A built-in parameter that resolves to the Cloud project ID associated with
 * the project, without prompting the deployer.
 */
-const projectID = new require_params_types.InternalExpression("PROJECT_ID", (env) => JSON.parse(env.FIREBASE_CONFIG)?.projectId || "");
+const projectID = new require_params_types.InternalExpression("PROJECT_ID", (env) => JSON.parse(env.FIREBASE_CONFIG || "{}")?.projectId || "");
 /**
 * A built-in parameter that resolves to the Cloud project ID, without prompting
 * the deployer.
 */
-const gcloudProject = new require_params_types.InternalExpression("GCLOUD_PROJECT", (env) => JSON.parse(env.FIREBASE_CONFIG)?.projectId || "");
+const gcloudProject = new require_params_types.InternalExpression("GCLOUD_PROJECT", (env) => JSON.parse(env.FIREBASE_CONFIG || "{}")?.projectId || "");
 /**
 * A builtin parameter that resolves to the Cloud storage bucket associated
 * with the function, without prompting the deployer. Empty string if not
 * defined.
 */
-const storageBucket = new require_params_types.InternalExpression("STORAGE_BUCKET", (env) => JSON.parse(env.FIREBASE_CONFIG)?.storageBucket || "");
+const storageBucket = new require_params_types.InternalExpression("STORAGE_BUCKET", (env) => JSON.parse(env.FIREBASE_CONFIG || "{}")?.storageBucket || "");
 /**
 * Declares a secret param, that will persist values only in Cloud Secret Manager.
 * Secrets are stored internally as bytestrings. Use `ParamOptions.as` to provide type
@@ -84,8 +85,8 @@ const storageBucket = new require_params_types.InternalExpression("STORAGE_BUCKE
 * @param name The name of the environment variable to use to load the parameter.
 * @returns A parameter with a `string` return type for `.value`.
 */
-function defineSecret(name) {
-	const param = new require_params_types.SecretParam(name);
+function defineSecret(name, options = {}) {
+	const param = new require_params_types.SecretParam(name, options);
 	registerParam(param);
 	return param;
 }
@@ -101,8 +102,8 @@ function defineSecret(name) {
 * @returns A parameter whose `.value()` method returns the parsed JSON object.
 * ```
 */
-function defineJsonSecret(name) {
-	const param = new require_params_types.JsonSecretParam(name);
+function defineJsonSecret(name, options = {}) {
+	const param = new require_params_types.JsonSecretParam(name, options);
 	registerParam(param);
 	return param;
 }
@@ -168,6 +169,19 @@ function defineList(name, options = {}) {
 	registerParam(param);
 	return param;
 }
+/**
+* Creates an Expression representing a string, which can interpolate
+* other Expressions into it using template literal syntax.
+*
+* @example
+* ```
+* const topicParam = defineString('TOPIC');
+* const topicExpr = expr`projects/my-project/topics/${topicParam}`;
+* ```
+*/
+function expr(strings, ...values) {
+	return new require_params_types.InterpolationExpression(strings, values);
+}
 
 //#endregion
 exports.BUCKET_PICKER = require_params_types.BUCKET_PICKER;
@@ -182,6 +196,7 @@ exports.defineJsonSecret = defineJsonSecret;
 exports.defineList = defineList;
 exports.defineSecret = defineSecret;
 exports.defineString = defineString;
+exports.expr = expr;
 exports.gcloudProject = gcloudProject;
 exports.multiSelect = require_params_types.multiSelect;
 Object.defineProperty(exports, 'params_exports', {

package/lib/params/types.d.ts

@@ -15,6 +15,22 @@ export declare abstract class Expression<T extends string | number | boolean | s
     /** Returns the expression's representation as JSON. */
     toJSON(): string;
 }
+/**
+ * An InterpolationExpression allows string fragments and Expressions to be
+ * joined natively into a new Expression block evaluating to a string string.
+ */
+export declare class InterpolationExpression extends Expression<string> {
+    private strings;
+    private values;
+    constructor(strings: TemplateStringsArray, values: (string | Expression<any>)[]);
+    toCEL(): string;
+}
+export declare function valueOf<T extends string | number | boolean | string[]>(arg: T | Expression<T>): T;
+export declare function celOf<T extends string | number | boolean | string[]>(arg: T | Expression<T>): T | string;
+/**
+ * Transforms a string or a string expression using a function.
+ */
+export declare function transform(source: string | Expression<string>, transformer: (val: string) => string): Expression<string>;
 /**
  * A CEL expression corresponding to a ternary operator, e.g {{ cond ? ifTrue : ifFalse }}
  */
@@ -31,9 +47,9 @@ export declare class TernaryExpression<T extends string | number | boolean | str
  */
 export declare class CompareExpression<T extends string | number | boolean | string[]> extends Expression<boolean> {
     cmp: "==" | "!=" | ">" | ">=" | "<" | "<=";
-    lhs: Expression<T>;
+    lhs: T | Expression<T>;
     rhs: T | Expression<T>;
-    constructor(cmp: "==" | "!=" | ">" | ">=" | "<" | "<=", lhs: Expression<T>, rhs: T | Expression<T>);
+    constructor(cmp: "==" | "!=" | ">" | ">=" | "<" | "<=", lhs: T | Expression<T>, rhs: T | Expression<T>);
     toString(): string;
     /** Returns a `TernaryExpression` which can resolve to one of two values, based on the resolution of this comparison. */
     thenElse<retT extends string | number | boolean | string[]>(ifTrue: retT | Expression<retT>, ifFalse: retT | Expression<retT>): TernaryExpression<retT>;
@@ -145,6 +161,13 @@ export type WireParamSpec<T extends string | number | boolean | string[]> = {
 };
 /** Configuration options which can be used to customize the prompting behavior of a parameter. */
 export type ParamOptions<T extends string | number | boolean | string[]> = Omit<ParamSpec<T>, "name" | "type">;
+/** Configuration options which can be used to customize the behavior of a secret parameter. */
+export interface SecretParamOptions {
+    /** An optional human-readable string to be used as a replacement for the parameter's name when prompting. */
+    label?: string;
+    /** An optional long-form description of the parameter to be displayed while prompting. */
+    description?: string;
+}
 /**
  * Represents a parametrized value that will be read from .env files if present,
  * or prompted for by the CLI if missing. Instantiate these with the defineX
@@ -183,9 +206,10 @@ export declare abstract class Param<T extends string | number | boolean | string
  * during execution of that Function.
  */
 export declare class SecretParam {
+    readonly options: SecretParamOptions;
     static type: ParamValueType;
     name: string;
-    constructor(name: string);
+    constructor(name: string, options?: SecretParamOptions);
     /** Returns the secret's value at runtime. Throws an error if accessed during deployment. */
     value(): string;
 }
@@ -197,9 +221,10 @@ export declare class SecretParam {
  * of that Function.
  */
 export declare class JsonSecretParam<T = any> {
+    readonly options: SecretParamOptions;
     static type: ParamValueType;
     name: string;
-    constructor(name: string);
+    constructor(name: string, options?: SecretParamOptions);
     /** Returns the secret's parsed JSON value at runtime. Throws an error if accessed during deployment, if the secret is not set, or if the value is not valid JSON. */
     value(): T;
 }

package/lib/params/types.js

@@ -37,9 +37,56 @@ var Expression = class {
 		return this.toString();
 	}
 };
+/**
+* An InterpolationExpression allows string fragments and Expressions to be
+* joined natively into a new Expression block evaluating to a string string.
+*/
+var InterpolationExpression = class extends Expression {
+	constructor(strings, values) {
+		super();
+		this.strings = strings;
+		this.values = values;
+	}
+	/** @internal */
+	runtimeValue() {
+		return this.strings.reduce((result, str, i) => {
+			const val = i < this.values.length ? String(valueOf(this.values[i])) : "";
+			return result + str + val;
+		}, "");
+	}
+	toCEL() {
+		return this.strings.reduce((result, str, i) => {
+			const val = i < this.values.length ? celOf(this.values[i]) : "";
+			return result + str + val;
+		}, "");
+	}
+};
+/** @internal */
+var TransformedStringExpression = class extends Expression {
+	constructor(source, transformer) {
+		super();
+		this.source = source;
+		this.transformer = transformer;
+	}
+	runtimeValue() {
+		return this.transformer(valueOf(this.source));
+	}
+	toCEL() {
+		return this.source instanceof Expression ? this.source.toCEL() : this.transformer(this.source);
+	}
+};
 function valueOf(arg) {
 	return arg instanceof Expression ? arg.runtimeValue() : arg;
 }
+function celOf(arg) {
+	return arg instanceof Expression ? arg.toCEL() : arg;
+}
+/**
+* Transforms a string or a string expression using a function.
+*/
+function transform(source, transformer) {
+	return new TransformedStringExpression(source, transformer);
+}
 /**
 * Returns how an entity (either an `Expression` or a literal value) should be represented in CEL.
 * - Expressions delegate to the `.toString()` method, which is used by the WireManifest
@@ -91,7 +138,7 @@ var CompareExpression = class extends Expression {
 	}
 	/** @internal */
 	runtimeValue() {
-		const left = this.lhs.runtimeValue();
+		const left = valueOf(this.lhs);
 		const right = valueOf(this.rhs);
 		switch (this.cmp) {
 			case "==": return Array.isArray(left) ? this.arrayEquals(left, right) : left === right;
@@ -108,8 +155,7 @@ var CompareExpression = class extends Expression {
 		return a.every((item) => b.includes(item)) && b.every((item) => a.includes(item));
 	}
 	toString() {
-		const rhsStr = refOf(this.rhs);
-		return `${this.lhs} ${this.cmp} ${rhsStr}`;
+		return `${refOf(this.lhs)} ${this.cmp} ${refOf(this.rhs)}`;
 	}
 	/** Returns a `TernaryExpression` which can resolve to one of two values, based on the resolution of this comparison. */
 	thenElse(ifTrue, ifFalse) {
@@ -231,7 +277,8 @@ var SecretParam = class {
 	static {
 		this.type = "secret";
 	}
-	constructor(name) {
+	constructor(name, options = {}) {
+		this.options = options;
 		this.name = name;
 	}
 	/** @internal */
@@ -246,7 +293,8 @@ var SecretParam = class {
 	toSpec() {
 		return {
 			type: "secret",
-			name: this.name
+			name: this.name,
+			...this.options
 		};
 	}
 	/** Returns the secret's value at runtime. Throws an error if accessed during deployment. */
@@ -268,7 +316,8 @@ var JsonSecretParam = class {
 	static {
 		this.type = "secret";
 	}
-	constructor(name) {
+	constructor(name, options = {}) {
+		this.options = options;
 		this.name = name;
 	}
 	/** @internal */
@@ -288,6 +337,7 @@ var JsonSecretParam = class {
 		return {
 			type: "secret",
 			name: this.name,
+			...this.options,
 			format: "json"
 		};
 	}
@@ -417,11 +467,16 @@ exports.Expression = Expression;
 exports.FloatParam = FloatParam;
 exports.IntParam = IntParam;
 exports.InternalExpression = InternalExpression;
+exports.InterpolationExpression = InterpolationExpression;
 exports.JsonSecretParam = JsonSecretParam;
 exports.ListParam = ListParam;
 exports.Param = Param;
 exports.SecretParam = SecretParam;
 exports.StringParam = StringParam;
 exports.TernaryExpression = TernaryExpression;
+exports.TransformedStringExpression = TransformedStringExpression;
+exports.celOf = celOf;
 exports.multiSelect = multiSelect;
-exports.select = select;
+exports.select = select;
+exports.transform = transform;
+exports.valueOf = valueOf;

package/lib/v1/cloud-functions.js

@@ -1,4 +1,5 @@
 const require_logger_index = require('../logger/index.js');
+const require_params_types = require('../params/types.js');
 const require_common_options = require('../common/options.js');
 const require_runtime_manifest = require('../runtime/manifest.js');
 const require_common_change = require('../common/change.js');
@@ -55,10 +56,11 @@ function makeCloudFunction({ contextOnlyHandler, dataConstructor = (raw) => raw.
 		if (triggerResource() == null) {
 			return {};
 		}
+		const tr = triggerResource();
 		const trigger = {
 			...optionsToTrigger(options),
 			eventTrigger: {
-				resource: triggerResource(),
+				resource: require_params_types.celOf(tr),
 				eventType: legacyEventType || provider + "." + eventType,
 				service
 			}
@@ -81,13 +83,16 @@ function makeCloudFunction({ contextOnlyHandler, dataConstructor = (raw) => raw.
 			...optionsToEndpoint(options)
 		};
 		if (options.schedule) {
-			endpoint.scheduleTrigger = require_runtime_manifest.initV1ScheduleTrigger(options.schedule.schedule, options);
+			endpoint.scheduleTrigger = require_runtime_manifest.initV1ScheduleTrigger(require_params_types.celOf(options.schedule.schedule), options);
 			require_common_encoding.copyIfPresent(endpoint.scheduleTrigger, options.schedule, "timeZone");
+			if (endpoint.scheduleTrigger.timeZone instanceof require_params_types.Expression) {
+				endpoint.scheduleTrigger.timeZone = endpoint.scheduleTrigger.timeZone.toCEL();
+			}
 			require_common_encoding.copyIfPresent(endpoint.scheduleTrigger.retryConfig, options.schedule.retryConfig, "retryCount", "maxDoublings", "maxBackoffDuration", "maxRetryDuration", "minBackoffDuration");
 		} else {
 			endpoint.eventTrigger = {
 				eventType: legacyEventType || provider + "." + eventType,
-				eventFilters: { resource: triggerResource() },
+				eventFilters: { resource: require_params_types.celOf(triggerResource()) },
 				retry: !!options.failurePolicy
 			};
 		}
@@ -110,7 +115,7 @@ function _makeParams(context, triggerResourceGetter) {
 	if (!context.resource) {
 		return {};
 	}
-	const triggerResource = triggerResourceGetter();
+	const triggerResource = require_params_types.valueOf(triggerResourceGetter());
 	const wildcards = triggerResource.match(WILDCARD_REGEX);
 	const params = {};
 	const eventResourceParts = context?.resource?.name?.split?.("/");

package/lib/v1/function-configuration.d.ts

@@ -85,13 +85,13 @@ export interface Schedule {
      * schedule: "every 5 minutes"
      * ```
      */
-    schedule: string;
+    schedule: string | Expression<string>;
     /**
      * Specifies the time zone to be used in interpreting {@link Schedule.schedule}.
      *
      * The value of this field must be a time zone name from the tz database.
      */
-    timeZone?: string | ResetValue;
+    timeZone?: string | Expression<string> | ResetValue;
     /**
      * Settings that determine the retry behavior.
      */

package/lib/v1/providers/analytics.d.ts

@@ -1,5 +1,5 @@
 import { CloudFunction, EventContext } from "../cloud-functions";
-import { DeploymentOptions } from "../function-configuration";
+import { Expression } from "../../params/types";
 /**
  * Registers a function to handle analytics events.
  *
@@ -8,7 +8,7 @@ import { DeploymentOptions } from "../function-configuration";
  *
  * @returns Analytics event builder interface.
  */
-export declare function event(analyticsEventType: string): AnalyticsEventBuilder;
+export declare function event(analyticsEventType: string | Expression<string>): AnalyticsEventBuilder;
 /**
  * The Firebase Analytics event builder interface.
  *
@@ -17,8 +17,6 @@ export declare function event(analyticsEventType: string): AnalyticsEventBuilder
 export declare class AnalyticsEventBuilder {
     private triggerResource;
     private options;
-    /** @hidden */
-    constructor(triggerResource: () => string, options: DeploymentOptions);
     /**
      * Event handler that fires every time a Firebase Analytics event occurs.
      *

package/lib/v1/providers/analytics.js

@@ -1,4 +1,5 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
+const require_params_index = require('../../params/index.js');
 const require_v1_cloud_functions = require('../cloud-functions.js');
 
 //#region src/v1/providers/analytics.ts
@@ -34,7 +35,7 @@ function _eventWithOptions(analyticsEventType, options) {
 		if (!process.env.GCLOUD_PROJECT) {
 			throw new Error("process.env.GCLOUD_PROJECT is not set.");
 		}
-		return "projects/" + process.env.GCLOUD_PROJECT + "/events/" + analyticsEventType;
+		return require_params_index.expr`projects/${process.env.GCLOUD_PROJECT}/events/${analyticsEventType}`;
 	}, options);
 }
 /**
@@ -43,7 +44,7 @@ function _eventWithOptions(analyticsEventType, options) {
 * Access via `functions.analytics.event()`.
 */
 var AnalyticsEventBuilder = class {
-	/** @hidden */
+	/** @internal */
 	constructor(triggerResource, options) {
 		this.triggerResource = triggerResource;
 		this.options = options;

package/lib/v1/providers/database.d.ts

@@ -3,6 +3,7 @@ import { ParamsOf } from "../../common/params";
 import { DataSnapshot } from "../../common/providers/database";
 import { CloudFunction, EventContext } from "../cloud-functions";
 import { DeploymentOptions } from "../function-configuration";
+import { Expression } from "../../params/types";
 export { DataSnapshot };
 /**
  * Registers a function that triggers on events from a specific
@@ -19,7 +20,7 @@ export { DataSnapshot };
  *   to watch for write events.
  * @returns Firebase Realtime Database instance builder interface.
  */
-export declare function instance(instance: string): InstanceBuilder;
+export declare function instance(instance: string | Expression<string>): InstanceBuilder;
 /**
  * Registers a function that triggers on Firebase Realtime Database write
  * events.
@@ -52,7 +53,7 @@ export declare function instance(instance: string): InstanceBuilder;
  * @param path The path within the Database to watch for write events.
  * @returns Firebase Realtime Database builder interface.
  */
-export declare function ref<Ref extends string>(path: Ref): RefBuilder<Ref>;
+export declare function ref<Ref extends string>(path: Ref | Expression<string>): RefBuilder<Ref>;
 /**
  * The Firebase Realtime Database instance builder interface.
  *
@@ -61,11 +62,11 @@ export declare function ref<Ref extends string>(path: Ref): RefBuilder<Ref>;
 export declare class InstanceBuilder {
     private instance;
     private options;
-    constructor(instance: string, options: DeploymentOptions);
+    constructor(instance: string | Expression<string>, options: DeploymentOptions);
     /**
      * @returns Firebase Realtime Database reference builder interface.
      */
-    ref<Ref extends string>(path: Ref): RefBuilder<Ref>;
+    ref<Ref extends string>(path: Ref | Expression<string>): RefBuilder<Ref>;
 }
 /**
  * The Firebase Realtime Database reference builder interface.
@@ -75,7 +76,7 @@ export declare class InstanceBuilder {
 export declare class RefBuilder<Ref extends string> {
     private triggerResource;
     private options;
-    constructor(triggerResource: () => string, options: DeploymentOptions);
+    constructor(triggerResource: () => string | Expression<string>, options: DeploymentOptions);
     /**
      * Event handler that fires every time a Firebase Realtime Database write
      * of any kind (creation, update, or delete) occurs.

package/lib/v1/providers/database.js

@@ -1,4 +1,6 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
+const require_params_types = require('../../params/types.js');
+const require_params_index = require('../../params/index.js');
 const require_common_config = require('../../common/config.js');
 const require_common_app = require('../../common/app.js');
 const require_v1_cloud_functions = require('../cloud-functions.js');
@@ -96,14 +98,14 @@ var InstanceBuilder = class {
 	* @returns Firebase Realtime Database reference builder interface.
 	*/
 	ref(path) {
-		const normalized = require_common_utilities_path.normalizePath(path);
-		return new RefBuilder(() => `projects/_/instances/${this.instance}/refs/${normalized}`, this.options);
+		const normalized = require_params_types.transform(path, require_common_utilities_path.normalizePath);
+		return new RefBuilder(() => require_params_index.expr`projects/_/instances/${this.instance}/refs/${normalized}`, this.options);
 	}
 };
 /** @internal */
 function _refWithOptions(path, options) {
 	const resourceGetter = () => {
-		const normalized = require_common_utilities_path.normalizePath(path);
+		const normalized = require_params_types.transform(path, require_common_utilities_path.normalizePath);
 		const databaseURL = require_common_config.firebaseConfig().databaseURL;
 		if (!databaseURL) {
 			throw new Error("Missing expected firebase config value databaseURL, " + "config is actually" + JSON.stringify(require_common_config.firebaseConfig()) + "\n If you are unit testing, please set process.env.FIREBASE_CONFIG");
@@ -121,7 +123,7 @@ function _refWithOptions(path, options) {
 		if (!instance$1) {
 			throw new Error("Invalid value for config firebase.databaseURL: " + databaseURL);
 		}
-		return `projects/_/instances/${instance$1}/refs/${normalized}`;
+		return require_params_index.expr`projects/_/instances/${instance$1}/refs/${normalized}`;
 	};
 	return new RefBuilder(resourceGetter, options);
 }

package/lib/v1/providers/firestore.d.ts

@@ -1,4 +1,5 @@
 import * as firestore from "firebase-admin/firestore";
+import { Expression } from "../../params/types";
 import { Change } from "../../common/change";
 import { ParamsOf } from "../../common/params";
 import { CloudFunction, LegacyEvent, EventContext } from "../cloud-functions";
@@ -12,29 +13,28 @@ export type QueryDocumentSnapshot = firestore.QueryDocumentSnapshot;
  * collection is named "users" and the document is named "Ada", then the
  * path is "/users/Ada".
  */
-export declare function document<Path extends string>(path: Path): DocumentBuilder<Path>;
-export declare function namespace(namespace: string): NamespaceBuilder;
-export declare function database(database: string): DatabaseBuilder;
+export declare function document<Path extends string>(path: Path | Expression<string>): DocumentBuilder<Path>;
+export declare function namespace(namespace: string | Expression<string>): NamespaceBuilder;
+export declare function database(database: string | Expression<string>): DatabaseBuilder;
 export declare class DatabaseBuilder {
     private database;
     private options;
-    constructor(database: string, options: DeploymentOptions);
-    namespace(namespace: string): NamespaceBuilder;
-    document<Path extends string>(path: Path): DocumentBuilder<Path>;
+    constructor(database: string | Expression<string>, options: DeploymentOptions);
+    namespace(namespace: string | Expression<string>): NamespaceBuilder;
+    document<Path extends string>(path: Path | Expression<string>): DocumentBuilder<Path>;
 }
 export declare class NamespaceBuilder {
     private database;
     private options;
     private namespace?;
-    constructor(database: string, options: DeploymentOptions, namespace?: string);
-    document<Path extends string>(path: Path): DocumentBuilder<Path>;
+    constructor(database: string | Expression<string>, options: DeploymentOptions, namespace?: string | Expression<string>);
+    document<Path extends string>(path: Path | Expression<string>): DocumentBuilder<Path>;
 }
 export declare function snapshotConstructor(event: LegacyEvent): DocumentSnapshot;
 export declare function beforeSnapshotConstructor(event: LegacyEvent): DocumentSnapshot;
 export declare class DocumentBuilder<Path extends string> {
     private triggerResource;
     private options;
-    constructor(triggerResource: () => string, options: DeploymentOptions);
     /** Respond to all document writes (creates, updates, or deletes). */
     onWrite(handler: (change: Change<DocumentSnapshot>, context: EventContext<ParamsOf<Path>>) => PromiseLike<any> | any): CloudFunction<Change<DocumentSnapshot>>;
     /** Respond only to document updates. */

package/lib/v1/providers/firestore.js

@@ -1,9 +1,9 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
+const require_params_types = require('../../params/types.js');
+const require_params_index = require('../../params/index.js');
 const require_common_change = require('../../common/change.js');
 const require_v1_cloud_functions = require('../cloud-functions.js');
 const require_common_providers_firestore = require('../../common/providers/firestore.js');
-let path = require("path");
-path = require_rolldown_runtime.__toESM(path);
 
 //#region src/v1/providers/firestore.ts
 var firestore_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
@@ -35,8 +35,8 @@ const defaultDatabase = "(default)";
 * collection is named "users" and the document is named "Ada", then the
 * path is "/users/Ada".
 */
-function document(path$1) {
-	return _documentWithOptions(path$1, {});
+function document(path) {
+	return _documentWithOptions(path, {});
 }
 function namespace(namespace$1) {
 	return _namespaceWithOptions(namespace$1, {});
@@ -53,8 +53,8 @@ function _namespaceWithOptions(namespace$1, options) {
 	return _databaseWithOptions(defaultDatabase, options).namespace(namespace$1);
 }
 /** @internal */
-function _documentWithOptions(path$1, options) {
-	return _databaseWithOptions(defaultDatabase, options).document(path$1);
+function _documentWithOptions(path, options) {
+	return _databaseWithOptions(defaultDatabase, options).document(path);
 }
 var DatabaseBuilder = class {
 	constructor(database$1, options) {
@@ -64,8 +64,8 @@ var DatabaseBuilder = class {
 	namespace(namespace$1) {
 		return new NamespaceBuilder(this.database, this.options, namespace$1);
 	}
-	document(path$1) {
-		return new NamespaceBuilder(this.database, this.options).document(path$1);
+	document(path) {
+		return new NamespaceBuilder(this.database, this.options).document(path);
 	}
 };
 var NamespaceBuilder = class {
@@ -74,14 +74,24 @@ var NamespaceBuilder = class {
 		this.options = options;
 		this.namespace = namespace$1;
 	}
-	document(path$1) {
-		return new DocumentBuilder(() => {
+	document(path) {
+		const triggerResource = () => {
 			if (!process.env.GCLOUD_PROJECT) {
 				throw new Error("process.env.GCLOUD_PROJECT is not set.");
 			}
-			const database$1 = path.posix.join("projects", process.env.GCLOUD_PROJECT, "databases", this.database);
-			return path.posix.join(database$1, this.namespace ? `documents@${this.namespace}` : "documents", path$1);
-		}, this.options);
+			let project = require_params_index.projectID;
+			if (process.env.GCLOUD_PROJECT && process.env.FUNCTIONS_CONTROL_API !== "true") {
+				project = process.env.GCLOUD_PROJECT;
+			}
+			let nsPart = "";
+			if (this.namespace instanceof require_params_types.Expression) {
+				nsPart = new require_params_types.CompareExpression("==", this.namespace, "").thenElse("", require_params_index.expr`@${this.namespace}`);
+			} else if (this.namespace) {
+				nsPart = `@${this.namespace}`;
+			}
+			return require_params_index.expr`projects/${project}/databases/${this.database}/documents${nsPart}/${path}`;
+		};
+		return new DocumentBuilder(triggerResource, this.options);
 	}
 };
 function snapshotConstructor(event) {
@@ -94,6 +104,7 @@ function changeConstructor(raw) {
 	return require_common_change.Change.fromObjects(beforeSnapshotConstructor(raw), snapshotConstructor(raw));
 }
 var DocumentBuilder = class {
+	/** @internal */
 	constructor(triggerResource, options) {
 		this.triggerResource = triggerResource;
 		this.options = options;

package/lib/v1/providers/pubsub.d.ts

@@ -1,5 +1,6 @@
 import { CloudFunction, EventContext } from "../cloud-functions";
 import { DeploymentOptions, ScheduleRetryConfig } from "../function-configuration";
+import { Expression } from "../../params/types";
 /**
  * Registers a Cloud Function triggered when a Google Cloud Pub/Sub message
  * is sent to a specified topic.
@@ -7,7 +8,7 @@ import { DeploymentOptions, ScheduleRetryConfig } from "../function-configuratio
  * @param topic - The Pub/Sub topic to watch for message events.
  * @returns Pub/Sub topic builder interface.
  */
-export declare function topic(topic: string): TopicBuilder;
+export declare function topic(topic: string | Expression<string>): TopicBuilder;
 /**
  * The Google Cloud Pub/Sub topic builder.
  *
@@ -17,7 +18,7 @@ export declare class TopicBuilder {
     private triggerResource;
     private options;
     /** @hidden */
-    constructor(triggerResource: () => string, options: DeploymentOptions);
+    constructor(triggerResource: () => string | Expression<string>, options: DeploymentOptions);
     /**
      * Event handler that fires every time a Cloud Pub/Sub message is
      * published.
@@ -34,7 +35,7 @@ export declare class TopicBuilder {
  * @param schedule - The schedule, in Unix Crontab or AppEngine syntax.
  * @returns ScheduleBuilder interface.
  */
-export declare function schedule(schedule: string): ScheduleBuilder;
+export declare function schedule(schedule: string | Expression<string>): ScheduleBuilder;
 /**
  * The builder for scheduled functions, which are powered by
  * Google Pub/Sub and Cloud Scheduler. Describes the Cloud Scheduler
@@ -48,7 +49,7 @@ export declare class ScheduleBuilder {
     private triggerResource;
     private options;
     /** @hidden */
-    constructor(triggerResource: () => string, options: DeploymentOptions);
+    constructor(triggerResource: () => string | Expression<string>, options: DeploymentOptions);
     retryConfig(config: ScheduleRetryConfig): ScheduleBuilder;
     timeZone(timeZone: string): ScheduleBuilder;
     /**

package/lib/v1/providers/pubsub.js

@@ -1,4 +1,6 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
+const require_params_types = require('../../params/types.js');
+const require_params_index = require('../../params/index.js');
 const require_v1_cloud_functions = require('../cloud-functions.js');
 
 //#region src/v1/providers/pubsub.ts
@@ -29,15 +31,16 @@ function topic(topic$1) {
 }
 /** @internal */
 function _topicWithOptions(topic$1, options) {
-	if (topic$1.indexOf("/") !== -1) {
+	if (typeof topic$1 === "string" && topic$1.indexOf("/") !== -1) {
 		throw new Error("Topic name may not have a /");
 	}
-	return new TopicBuilder(() => {
+	const triggerResource = () => {
 		if (!process.env.GCLOUD_PROJECT) {
 			throw new Error("process.env.GCLOUD_PROJECT is not set.");
 		}
-		return `projects/${process.env.GCLOUD_PROJECT}/topics/${topic$1}`;
-	}, options);
+		return require_params_index.expr`projects/${process.env.GCLOUD_PROJECT}/topics/${topic$1}`;
+	};
+	return new TopicBuilder(triggerResource, options);
 }
 /**
 * The Google Cloud Pub/Sub topic builder.
@@ -89,7 +92,7 @@ function _scheduleWithOptions(schedule$1, options) {
 	};
 	return new ScheduleBuilder(triggerResource, {
 		...options,
-		schedule: { schedule: schedule$1 }
+		schedule: { schedule: schedule$1 instanceof require_params_types.Expression ? schedule$1.toCEL() : schedule$1 }
 	});
 }
 /**

package/lib/v1/providers/storage.d.ts

@@ -1,4 +1,5 @@
 import { CloudFunction, EventContext } from "../cloud-functions";
+import { Expression } from "../../params/types";
 /**
  * Registers a Cloud Function scoped to a specific storage bucket.
  *
@@ -7,7 +8,7 @@ import { CloudFunction, EventContext } from "../cloud-functions";
  *
  * @returns Storage bucket builder interface.
  */
-export declare function bucket(bucket?: string): BucketBuilder;
+export declare function bucket(bucket?: string | Expression<string>): BucketBuilder;
 /**
  * Registers a Cloud Function scoped to the default storage bucket for the
  * project.

package/lib/v1/providers/storage.js

@@ -1,4 +1,5 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
+const require_params_index = require('../../params/index.js');
 const require_common_config = require('../../common/config.js');
 const require_v1_cloud_functions = require('../cloud-functions.js');
 
@@ -40,14 +41,14 @@ function object() {
 /** @internal */
 function _bucketWithOptions(options, bucket$1) {
 	const resourceGetter = () => {
-		bucket$1 = bucket$1 || require_common_config.firebaseConfig().storageBucket;
-		if (!bucket$1) {
+		const bucketName = bucket$1 || require_common_config.firebaseConfig().storageBucket;
+		if (!bucketName) {
 			throw new Error("Missing bucket name. If you are unit testing, please provide a bucket name" + " through `functions.storage.bucket(bucketName)`, or set process.env.FIREBASE_CONFIG.");
 		}
-		if (!/^[a-z\d][a-z\d\\._-]{1,230}[a-z\d]$/.test(bucket$1)) {
-			throw new Error(`Invalid bucket name ${bucket$1}`);
+		if (typeof bucketName === "string" && !/^[a-z\d][a-z\d\\._-]{1,230}[a-z\d]$/.test(bucketName)) {
+			throw new Error(`Invalid bucket name ${bucketName}`);
 		}
-		return `projects/_/buckets/${bucket$1}`;
+		return require_params_index.expr`projects/_/buckets/${bucketName}`;
 	};
 	return new BucketBuilder(resourceGetter, options);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-functions",
-  "version": "7.2.0-rc.0",
+  "version": "7.2.0",
   "description": "Firebase SDK for Cloud Functions",
   "keywords": [
     "firebase",