firebase-tools 15.11.0 → 15.12.0

package/lib/functions/iac/terraform.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expr = expr;
+exports.copyField = copyField;
+exports.renameField = renameField;
+exports.serviceAccount = serviceAccount;
+exports.serializeValue = serializeValue;
+exports.blockToString = blockToString;
+const utils = require("../../utils");
+const error_1 = require("../../error");
+function expr(string) {
+    return { "@type": "HCLExpression", value: string };
+}
+function copyField(attributes, source, field, transform = (v) => v) {
+    renameField(attributes, source, utils.toLowerSnakeCase(field), field, transform);
+}
+function renameField(attributes, source, attributeField, sourceField, transform = (v) => v) {
+    const val = source[sourceField];
+    if (val === undefined) {
+        return;
+    }
+    attributes[attributeField] = val === null ? null : transform(val);
+}
+function serviceAccount(sa) {
+    if (sa.endsWith("@")) {
+        return `${sa}\${var.project}.iam.gserviceaccount.com`;
+    }
+    return sa;
+}
+function serializeValue(value, indentation = 0) {
+    if (typeof value === "string") {
+        value = value.replace(/{{ *params\.PROJECT_ID *}}/g, "${var.project}");
+        if (value.includes("{{ ")) {
+            throw new error_1.FirebaseError("Generalized parameterized fields are not supported in terraform yet");
+        }
+        return JSON.stringify(value);
+    }
+    else if (typeof value === "number" || typeof value === "boolean") {
+        return value.toString();
+    }
+    else if (value === null || value === undefined) {
+        return "null";
+    }
+    else if (Array.isArray(value)) {
+        if (value.some((e) => e !== null &&
+            typeof e === "object" &&
+            (Array.isArray(e) || e["@type"] !== "HCLExpression"))) {
+            return `[\n${value.map((v) => "  ".repeat(indentation + 1) + serializeValue(v, indentation + 1)).join(",\n")}\n${"  ".repeat(indentation)}]`;
+        }
+        return `[${value.map((v) => serializeValue(v)).join(", ")}]`;
+    }
+    else if (typeof value === "object") {
+        if (value["@type"] === "HCLExpression") {
+            return value.value;
+        }
+        const entries = Object.entries(value).map(([k, v]) => `${"  ".repeat(indentation + 1)}${k} = ${serializeValue(v, indentation + 1)}`);
+        return `{\n${entries.join("\n")}\n${"  ".repeat(indentation)}}`;
+    }
+    throw new error_1.FirebaseError(`Unsupported terraform value type ${typeof value}`, { exit: 1 });
+}
+const PREFIX_ARGUMENTS = new Set(["count", "for_each", "provider"]);
+const SUFFIX_ARGUMENTS = new Set(["lifecycle", "depends_on"]);
+const NON_BLOCK_PARAMETERS = {
+    google_cloudfunctions_function: new Set([
+        "name",
+        "runtime",
+        "description",
+        "available_memory_mb",
+        "timeout",
+        "entry_point",
+        "source_archive_bucket",
+        "source_archive_object",
+        "trigger_http",
+        "environment_variables",
+        "vpc_connector",
+        "service_account_email",
+        "max_instances",
+        "min_instances",
+        "project",
+        "region",
+    ]),
+    google_cloudfunctions2_function: new Set(["name", "location", "description", "project"]),
+    google_cloud_scheduler_job: new Set([
+        "name",
+        "description",
+        "schedule",
+        "time_zone",
+        "paused",
+        "attempt_deadline",
+        "region",
+        "project",
+    ]),
+    google_cloud_tasks_queue: new Set(["name", "location", "desired_state", "project"]),
+    google_eventarc_trigger: new Set(["name", "location", "project", "service_account"]),
+    google_pubsub_topic: new Set([
+        "name",
+        "project",
+        "labels",
+        "kms_key_name",
+        "message_retention_duration",
+    ]),
+    google_pubsub_subscription: new Set([
+        "name",
+        "topic",
+        "project",
+        "labels",
+        "ack_deadline_seconds",
+        "message_retention_duration",
+        "retain_acked_messages",
+        "enable_message_ordering",
+        "filter",
+    ]),
+};
+function serializeResourceAttributes(attributes, resourceType, indentation = 0) {
+    const nonBlockParams = NON_BLOCK_PARAMETERS[resourceType] || new Set();
+    const prefixGroup = [];
+    const nonBlockGroup = [];
+    const blockGroup = [];
+    const suffixGroup = [];
+    for (const [k, v] of Object.entries(attributes)) {
+        const serialized = `${"  ".repeat(indentation + 1)}${k} = ${serializeValue(v, indentation + 1)}`;
+        if (PREFIX_ARGUMENTS.has(k)) {
+            prefixGroup.push(serialized);
+        }
+        else if (nonBlockParams.has(k)) {
+            nonBlockGroup.push(serialized);
+        }
+        else if (SUFFIX_ARGUMENTS.has(k)) {
+            suffixGroup.push(serialized);
+        }
+        else {
+            blockGroup.push(serialized);
+        }
+    }
+    const nonemptyGroups = [prefixGroup, nonBlockGroup, blockGroup, suffixGroup].filter((g) => g.length > 0);
+    const joinedGroups = nonemptyGroups.map((g) => g.join("\n")).join("\n\n");
+    return `{\n${joinedGroups}\n${"  ".repeat(indentation)}}`;
+}
+function blockToString(block, indentation = 0) {
+    const labels = (block.labels || []).map((l) => `"${l}"`).join(" ");
+    if (block.type === "resource" && block.labels?.length) {
+        const resourceType = block.labels[0];
+        return `${"  ".repeat(indentation)}${block.type} ${labels ? labels + " " : ""}${serializeResourceAttributes(block.attributes, resourceType, indentation)}`;
+    }
+    return `${"  ".repeat(indentation)}${block.type} ${labels ? labels + " " : ""}${serializeValue(block.attributes, indentation)}`;
+}

package/lib/gcp/ailogic.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.client = exports.AI_LOGIC_TRIGGERS_TO_EVENTS = exports.AI_LOGIC_EVENTS_TO_TRIGGER = exports.API_VERSION = void 0;
+exports.createTrigger = createTrigger;
+exports.getTrigger = getTrigger;
+exports.updateTrigger = updateTrigger;
+exports.deleteTrigger = deleteTrigger;
+exports.listTriggers = listTriggers;
+exports.upsertBlockingFunction = upsertBlockingFunction;
+exports.deleteBlockingFunction = deleteBlockingFunction;
+const apiv2_1 = require("../apiv2");
+const api_1 = require("../api");
+const ailogic_1 = require("../deploy/functions/services/ailogic");
+exports.API_VERSION = "v1beta";
+exports.AI_LOGIC_EVENTS_TO_TRIGGER = {
+    [ailogic_1.AI_LOGIC_BEFORE_GENERATE_CONTENT]: "before-generate-content",
+    [ailogic_1.AI_LOGIC_AFTER_GENERATE_CONTENT]: "after-generate-content",
+};
+exports.AI_LOGIC_TRIGGERS_TO_EVENTS = {
+    "before-generate-content": ailogic_1.AI_LOGIC_BEFORE_GENERATE_CONTENT,
+    "after-generate-content": ailogic_1.AI_LOGIC_AFTER_GENERATE_CONTENT,
+};
+exports.client = new apiv2_1.Client({
+    urlPrefix: (0, api_1.aiLogicProxyOrigin)(),
+    auth: true,
+    apiVersion: exports.API_VERSION,
+});
+async function createTrigger(projectId, location, triggerId, trigger, validateOnly = false) {
+    const parent = `projects/${projectId}/locations/${location}`;
+    const res = await exports.client.post(`${parent}/triggers`, trigger, {
+        queryParams: {
+            triggerId,
+            validateOnly: validateOnly ? "true" : "false",
+        },
+    });
+    return res.body;
+}
+async function getTrigger(projectId, location, triggerId) {
+    const name = `projects/${projectId}/locations/${location}/triggers/${triggerId}`;
+    const res = await exports.client.get(name);
+    return res.body;
+}
+async function updateTrigger(projectId, location, triggerId, trigger, updateMask, allowMissing = false, validateOnly = false) {
+    const name = `projects/${projectId}/locations/${location}/triggers/${triggerId}`;
+    const queryParams = {
+        allowMissing: allowMissing ? "true" : "false",
+        validateOnly: validateOnly ? "true" : "false",
+    };
+    if (updateMask && updateMask.length > 0) {
+        queryParams.updateMask = updateMask.join(",");
+    }
+    const res = await exports.client.patch(name, trigger, { queryParams });
+    return res.body;
+}
+async function deleteTrigger(projectId, location, triggerId, allowMissing = false, validateOnly = false, etag) {
+    const name = `projects/${projectId}/locations/${location}/triggers/${triggerId}`;
+    const queryParams = {
+        allowMissing: allowMissing ? "true" : "false",
+        validateOnly: validateOnly ? "true" : "false",
+    };
+    if (etag) {
+        queryParams.etag = etag;
+    }
+    await exports.client.delete(name, { queryParams });
+}
+async function listTriggers(projectId, location, filter) {
+    const parent = `projects/${projectId}/locations/${location}`;
+    let pageToken;
+    const triggers = [];
+    do {
+        const queryParams = pageToken ? { pageToken } : {};
+        if (filter) {
+            queryParams.filter = filter;
+        }
+        const res = await exports.client.get(`${parent}/triggers`, { queryParams });
+        if (res.body.triggers) {
+            triggers.push(...res.body.triggers);
+        }
+        pageToken = res.body.nextPageToken;
+    } while (pageToken);
+    return triggers;
+}
+async function upsertBlockingFunction(endpoint) {
+    const eventType = endpoint.blockingTrigger.eventType;
+    const triggerId = exports.AI_LOGIC_EVENTS_TO_TRIGGER[eventType];
+    const location = endpoint.blockingTrigger.options?.regionalWebhook ? endpoint.region : "global";
+    const triggerBody = {
+        cloudFunction: {
+            id: endpoint.id,
+            locationId: endpoint.region,
+        },
+    };
+    try {
+        return await createTrigger(endpoint.project, location, triggerId, triggerBody);
+    }
+    catch (err) {
+        if (err && typeof err === "object" && "status" in err && err.status === 409) {
+            return await updateTrigger(endpoint.project, location, triggerId, triggerBody);
+        }
+        throw err;
+    }
+}
+async function deleteBlockingFunction(endpoint) {
+    const eventType = endpoint.blockingTrigger.eventType;
+    const triggerId = exports.AI_LOGIC_EVENTS_TO_TRIGGER[eventType];
+    const location = endpoint.blockingTrigger.options?.regionalWebhook ? endpoint.region : "global";
+    await deleteTrigger(endpoint.project, location, triggerId, true);
+}

package/lib/gcp/cloudfunctionsv2.js

@@ -21,6 +21,8 @@ const utils = require("../utils");
 const projectConfig = require("../functions/projectConfig");
 const constants_1 = require("../functions/constants");
 const cloudfunctions_1 = require("./cloudfunctions");
+const ailogic_1 = require("./ailogic");
+const ailogic_2 = require("../deploy/functions/services/ailogic");
 const k8s_1 = require("./k8s");
 exports.API_VERSION = "v2";
 const DEFAULT_MAX_INSTANCE_COUNT = 100;
@@ -263,6 +265,13 @@ function functionFromEndpoint(endpoint) {
     else if (backend.isDataConnectGraphqlTriggered(endpoint)) {
         gcfFunction.labels = { ...gcfFunction.labels, "deployment-fdcgraphql": "true" };
     }
+    else if ((0, ailogic_2.isAILogicEvent)(endpoint)) {
+        gcfFunction.labels = {
+            ...gcfFunction.labels,
+            "ailogic-event-type": ailogic_1.AI_LOGIC_EVENTS_TO_TRIGGER[endpoint.blockingTrigger.eventType],
+            "ailogic-locality": endpoint.blockingTrigger.options?.regionalWebhook ? "regional" : "global",
+        };
+    }
     else if (backend.isBlockingTriggered(endpoint)) {
         gcfFunction.labels = {
             ...gcfFunction.labels,
@@ -310,6 +319,21 @@ function endpointFromFunction(gcfFunction) {
             dataConnectGraphqlTrigger: {},
         };
     }
+    else if (gcfFunction.labels?.["ailogic-event-type"]) {
+        const triggerType = gcfFunction.labels["ailogic-event-type"];
+        const eventType = ailogic_1.AI_LOGIC_TRIGGERS_TO_EVENTS[triggerType];
+        if (!eventType) {
+            throw new error_1.FirebaseError(`Unrecognized ailogic-event-type label: ${triggerType}`);
+        }
+        trigger = {
+            blockingTrigger: {
+                eventType,
+                options: {
+                    regionalWebhook: gcfFunction.labels["ailogic-locality"] === "regional",
+                },
+            },
+        };
+    }
     else if (gcfFunction.labels?.[constants_1.BLOCKING_LABEL]) {
         trigger = {
             blockingTrigger: {

package/lib/init/features/agentSkills.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askQuestions = askQuestions;
+exports.actuate = actuate;
+const agentSkills_1 = require("../../agentSkills");
+const logger_1 = require("../../logger");
+const error_1 = require("../../error");
+async function askQuestions(setup) {
+    try {
+        logger_1.logger.info("If you are using an AI coding agent, Firebase Agent Skills make it an expert at Firebase.");
+        const shouldInstall = await (0, agentSkills_1.promptForAgentSkills)();
+        setup.featureInfo = setup.featureInfo || {};
+        setup.featureInfo.agentSkills = { shouldInstall };
+    }
+    catch (err) {
+        logger_1.logger.debug(`Could not prompt for agent skills: ${(0, error_1.getErrMsg)(err)}`);
+    }
+}
+async function actuate(setup, config) {
+    const info = setup.featureInfo?.agentSkills;
+    if (!info || !info.shouldInstall) {
+        return;
+    }
+    const cwd = config.projectDir;
+    void (0, agentSkills_1.installAgentSkills)({ background: true, cwd });
+}

package/lib/init/features/dataconnect/sdk.js

@@ -12,6 +12,7 @@ const path = require("path");
 const cwd = process.cwd();
 const prompt_1 = require("../../../prompt");
 const load_1 = require("../../../dataconnect/load");
+const experiments = require("../../../experiments");
 const error_1 = require("../../../error");
 const lodash_1 = require("lodash");
 const utils_1 = require("../../../utils");
@@ -275,19 +276,20 @@ function addSdkGenerateToConnectorYaml(connectorInfo, connectorYaml, app) {
         }
         case appUtils_1.Platform.WEB: {
             const javascriptSdk = {
-                outputDir: path.relative(connectorDir, path.join(appDir, `src/dataconnect-generated`)),
-                package: `@dataconnect/generated`,
-                packageJsonDir: path.relative(connectorDir, appDir),
-                react: false,
-                angular: false,
+                outputDir: path.relative(connectorDir, path.join(app.directory, "src/dataconnect-generated")),
+                package: "@dataconnect/generated",
+                packageJsonDir: path.relative(connectorDir, app.directory),
+                react: app.frameworks?.includes(appUtils_1.Framework.REACT) ?? false,
+                angular: app.frameworks?.includes(appUtils_1.Framework.ANGULAR) ?? false,
             };
-            for (const f of app.frameworks || []) {
-                javascriptSdk[f] = true;
+            if (experiments.isEnabled("fdcrealtime")) {
+                javascriptSdk.clientCache = {};
             }
             if (!(0, lodash_1.isArray)(generate?.javascriptSdk)) {
                 generate.javascriptSdk = generate.javascriptSdk ? [generate.javascriptSdk] : [];
             }
-            if (!generate.javascriptSdk.some((s) => s.outputDir === javascriptSdk.outputDir)) {
+            const existing = generate.javascriptSdk.find((s) => s.outputDir === javascriptSdk.outputDir);
+            if (!existing) {
                 generate.javascriptSdk.push(javascriptSdk);
             }
             break;
@@ -297,23 +299,31 @@ function addSdkGenerateToConnectorYaml(connectorInfo, connectorYaml, app) {
                 outputDir: path.relative(connectorDir, path.join(appDir, `lib/dataconnect_generated`)),
                 package: "dataconnect_generated/generated.dart",
             };
+            if (experiments.isEnabled("fdcrealtime")) {
+                dartSdk.clientCache = {};
+            }
             if (!(0, lodash_1.isArray)(generate?.dartSdk)) {
                 generate.dartSdk = generate.dartSdk ? [generate.dartSdk] : [];
             }
-            if (!generate.dartSdk.some((s) => s.outputDir === dartSdk.outputDir)) {
+            const existing = generate.dartSdk.find((s) => s.outputDir === dartSdk.outputDir);
+            if (!existing) {
                 generate.dartSdk.push(dartSdk);
             }
             break;
         }
         case appUtils_1.Platform.ANDROID: {
             const kotlinSdk = {
-                outputDir: path.relative(connectorDir, path.join(appDir, `src/main/kotlin`)),
+                outputDir: path.relative(connectorDir, path.join(app.directory, "src/main/kotlin")),
                 package: `com.google.firebase.dataconnect.generated`,
             };
+            if (experiments.isEnabled("fdcrealtime")) {
+                kotlinSdk.clientCache = {};
+            }
             if (!(0, lodash_1.isArray)(generate?.kotlinSdk)) {
                 generate.kotlinSdk = generate.kotlinSdk ? [generate.kotlinSdk] : [];
             }
-            if (!generate.kotlinSdk.some((s) => s.outputDir === kotlinSdk.outputDir)) {
+            const existing = generate.kotlinSdk.find((s) => s.outputDir === kotlinSdk.outputDir);
+            if (!existing) {
                 generate.kotlinSdk.push(kotlinSdk);
             }
             break;
@@ -323,10 +333,14 @@ function addSdkGenerateToConnectorYaml(connectorInfo, connectorYaml, app) {
                 outputDir: path.relative(connectorDir, path.join(app.directory, `../FirebaseDataConnectGenerated`)),
                 package: "DataConnectGenerated",
             };
+            if (experiments.isEnabled("fdcrealtime")) {
+                swiftSdk.clientCache = {};
+            }
             if (!(0, lodash_1.isArray)(generate?.swiftSdk)) {
                 generate.swiftSdk = generate.swiftSdk ? [generate.swiftSdk] : [];
             }
-            if (!generate.swiftSdk.some((s) => s.outputDir === swiftSdk.outputDir)) {
+            const existing = generate.swiftSdk.find((s) => s.outputDir === swiftSdk.outputDir);
+            if (!existing) {
                 generate.swiftSdk.push(swiftSdk);
             }
             break;

package/lib/init/features/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.authActuate = exports.authAskQuestions = exports.aiLogicActuate = exports.aiLogicAskQuestions = exports.aitools = exports.apptestingAcutate = exports.apptestingAskQuestions = exports.genkit = exports.apphosting = exports.dataconnectResolverActuate = exports.dataconnectResolverAskQuestions = exports.dataconnectSdkActuate = exports.dataconnectSdkAskQuestions = exports.dataconnectActuate = exports.dataconnectAskQuestions = exports.hostingGithub = exports.remoteconfig = exports.project = exports.extensions = exports.emulators = exports.storageActuate = exports.storageAskQuestions = exports.hostingActuate = exports.hostingAskQuestions = exports.functionsActuate = exports.functionsAskQuestions = exports.firestoreActuate = exports.firestoreAskQuestions = exports.databaseActuate = exports.databaseAskQuestions = exports.account = void 0;
+exports.agentSkillsActuate = exports.agentSkillsAskQuestions = exports.authActuate = exports.authAskQuestions = exports.aiLogicActuate = exports.aiLogicAskQuestions = exports.aitools = exports.apptestingAcutate = exports.apptestingAskQuestions = exports.genkit = exports.apphosting = exports.dataconnectResolverActuate = exports.dataconnectResolverAskQuestions = exports.dataconnectSdkActuate = exports.dataconnectSdkAskQuestions = exports.dataconnectActuate = exports.dataconnectAskQuestions = exports.hostingGithub = exports.remoteconfig = exports.project = exports.extensions = exports.emulators = exports.storageActuate = exports.storageAskQuestions = exports.hostingActuate = exports.hostingAskQuestions = exports.functionsActuate = exports.functionsAskQuestions = exports.firestoreActuate = exports.firestoreAskQuestions = exports.databaseActuate = exports.databaseAskQuestions = exports.account = void 0;
 var account_1 = require("./account");
 Object.defineProperty(exports, "account", { enumerable: true, get: function () { return account_1.doSetup; } });
 var database_1 = require("./database");
@@ -52,3 +52,6 @@ Object.defineProperty(exports, "aiLogicActuate", { enumerable: true, get: functi
 var auth_1 = require("./auth");
 Object.defineProperty(exports, "authAskQuestions", { enumerable: true, get: function () { return auth_1.askQuestions; } });
 Object.defineProperty(exports, "authActuate", { enumerable: true, get: function () { return auth_1.actuate; } });
+var agentSkills_1 = require("./agentSkills");
+Object.defineProperty(exports, "agentSkillsAskQuestions", { enumerable: true, get: function () { return agentSkills_1.askQuestions; } });
+Object.defineProperty(exports, "agentSkillsActuate", { enumerable: true, get: function () { return agentSkills_1.actuate; } });

package/lib/init/index.js

@@ -74,6 +74,12 @@ const featuresList = [
         askQuestions: features.authAskQuestions,
         actuate: features.authActuate,
     },
+    {
+        name: "agentSkills",
+        displayName: "Agent Skills",
+        askQuestions: features.agentSkillsAskQuestions,
+        actuate: features.agentSkillsActuate,
+    },
 ];
 const featureMap = new Map(featuresList.map((feature) => [feature.name, feature]));
 async function init(setup, config, options) {