firebase-functions/lib/esm/lifecycle/index.mjs

Firebase SDK for Cloud Functions

import { __export } from "../_virtual/rolldown_runtime.mjs";
import { globalManifest } from "../runtime/manifest.mjs";

//#region src/lifecycle/index.ts
var lifecycle_exports = /* @__PURE__ */ __export({
	afterFirstDeploy: () => afterFirstDeploy,
	afterRedeploy: () => afterRedeploy,
	clearDeclaredLifecycleHooks: () => clearDeclaredLifecycleHooks,
	declaredLifecycleHooks: () => declaredLifecycleHooks
});
/**
* Gets or creates the mutable lifecycle hooks record directly on `globalManifest`.
* Used exclusively for write operations (e.g., registering a hook) so that
* `globalManifest.lifecycleHooks` is created lazily on demand.
*/
function getOrCreateDeclaredLifecycleHooks() {
	if (!globalManifest.lifecycleHooks || typeof globalManifest.lifecycleHooks !== "object") {
		globalManifest.lifecycleHooks = {};
	}
	return globalManifest.lifecycleHooks;
}
/**
* Gets the existing lifecycle hooks record on `globalManifest` if defined,
* or returns a fallback empty object without mutating `globalManifest`.
* Used for read-only operations (e.g., property lookup, keys, descriptors)
* to avoid emitting an unwanted empty `lifecycleHooks: {}` into the manifest.
*/
function getExistingDeclaredLifecycleHooks() {
	if (!globalManifest.lifecycleHooks || typeof globalManifest.lifecycleHooks !== "object") {
		return {};
	}
	return globalManifest.lifecycleHooks;
}
/**
* Shared dictionary of declared lifecycle hooks.
*
* NOTE: A Proxy is necessary here because `lifecycleHooks` is only initialized
* on `globalManifest` when hooks are registered (to avoid emitting empty `{}`
* into the manifest). The Proxy dynamically delegates all property reads, writes,
* and key enumerations directly to `globalManifest.lifecycleHooks` on `globalThis`,
* ensuring dual-package hazard protection across ESM/CJS or duplicate module contexts.
*
* @internal
*/
const declaredLifecycleHooks = new Proxy({}, {
	get(_, prop) {
		if (typeof prop === "string") {
			return getExistingDeclaredLifecycleHooks()[prop];
		}
		return undefined;
	},
	set(_, prop, value) {
		if (typeof prop === "string") {
			getOrCreateDeclaredLifecycleHooks()[prop] = value;
			return true;
		}
		return false;
	},
	deleteProperty(_, prop) {
		if (typeof prop === "string" && globalManifest.lifecycleHooks) {
			const hooks = globalManifest.lifecycleHooks;
			delete hooks[prop];
			if (Object.keys(hooks).length === 0) {
				delete globalManifest.lifecycleHooks;
			}
			return true;
		}
		return false;
	},
	has(_, prop) {
		return Reflect.has(getExistingDeclaredLifecycleHooks(), prop);
	},
	ownKeys() {
		return Reflect.ownKeys(getExistingDeclaredLifecycleHooks());
	},
	getOwnPropertyDescriptor(_, prop) {
		const hooks = getExistingDeclaredLifecycleHooks();
		if (typeof prop === "string" && prop in hooks) {
			return {
				enumerable: true,
				configurable: true,
				writable: true,
				value: hooks[prop]
			};
		}
		return undefined;
	}
});
/**
* Registers an action to be executed automatically post-deployment when resources in this codebase
* are deployed for the first time.
*
* @param action The lifecycle action to execute.
*/
function afterFirstDeploy(action) {
	const hooks = getOrCreateDeclaredLifecycleHooks();
	if (hooks.afterFirstDeploy) {
		throw new Error("Only one afterFirstDeploy lifecycle hook is allowed per codebase.");
	}
	hooks.afterFirstDeploy = action;
}
/**
* Registers an action to be executed automatically post-deployment when resources in this codebase
* are updated.
*
* @param action The lifecycle action to execute.
*/
function afterRedeploy(action) {
	const hooks = getOrCreateDeclaredLifecycleHooks();
	if (hooks.afterRedeploy) {
		throw new Error("Only one afterRedeploy lifecycle hook is allowed per codebase.");
	}
	hooks.afterRedeploy = action;
}
/**
* Helper to clear declared lifecycle hooks.
* @internal
*/
function clearDeclaredLifecycleHooks() {
	delete globalManifest.lifecycleHooks;
}

//#endregion
export { afterFirstDeploy, afterRedeploy, clearDeclaredLifecycleHooks, declaredLifecycleHooks, lifecycle_exports };