@firebase-function-kits/bigquery-firestore-export 0.0.1 → 0.0.2-rc.0

package/CHANGELOG.md

@@ -0,0 +1 @@
+- Initial release

package/README.md

@@ -0,0 +1,188 @@
+# @firebase/bigquery-firestore-export
+
+Schedule a BigQuery query and write each run's rows and metadata to Firestore.
+This is the Export BigQuery to Firestore Firebase Extension as an npm package
+you add to your own Firebase Functions codebase and deploy.
+
+The kit creates or reconciles a BigQuery Data Transfer scheduled query, listens
+for its Pub/Sub completion notifications, reads the destination table, and
+writes the rows to Firestore. The functions run in your own Firebase project;
+there is no hosted version, so you deploy them yourself.
+
+## Install
+
+```sh
+npm install @firebase/bigquery-firestore-export
+```
+
+## Required IAM
+
+Deploy needs these Google Cloud roles and APIs for the function's service
+account. Firebase CLI 15.23.0 or later creates that account, grants the roles
+below, enables the listed APIs, and attaches the account to every function in
+this kit. Do not set a custom runtime service account for this codebase—it
+conflicts with that automatic setup.
+
+| Role / API                            | Why                                                                 |
+| ------------------------------------- | ------------------------------------------------------------------- |
+| `roles/datastore.user`                | store transfer configs, run metadata, and query output in Firestore |
+| `roles/bigquery.admin`                | create scheduled queries and read their destination tables          |
+| `roles/pubsub.admin`                  | create the transfer-notification topic                              |
+| `roles/eventarc.eventReceiver`        | receive Gen2 Pub/Sub trigger events                                 |
+| `roles/run.invoker`                   | allow Eventarc/Tasks to invoke the Gen2 Cloud Run services          |
+| `bigquery.googleapis.com`             | run queries and read destination tables                             |
+| `bigquerydatatransfer.googleapis.com` | create and reconcile scheduled-query transfer configs               |
+| `pubsub.googleapis.com`               | deliver transfer-completion notifications                           |
+
+## Usage
+
+Export both functions from your functions codebase entry:
+
+```ts
+// functions/src/index.ts
+export {
+  processMessages,
+  upsertTransferConfig,
+} from "@firebase/bigquery-firestore-export";
+```
+
+and configure them with a `.env` (or `.env.<projectId>`):
+
+```sh
+INSTANCE_ID=analytics-export
+BIGQUERY_DATASET_LOCATION=US
+DATASET_ID=analytics
+TABLE_NAME=users
+QUERY_STRING=SELECT * FROM `my-project.source.users`
+DISPLAY_NAME=Export users to Firestore
+SCHEDULE=every 24 hours
+```
+
+- `processMessages` consumes BigQuery Data Transfer completion messages.
+- `upsertTransferConfig` is the idempotent lifecycle task that creates, links,
+  or updates the scheduled query and its notification topic.
+
+Importing the package without exporting its functions deploys nothing—the CLI
+only deploys what your entry file exports.
+
+## Deploy
+
+The package's `firebase.json` declares a `kit` stanza (Firebase CLI 15.25.1 or
+later, behind the `kits` experiment):
+
+```json
+{
+  "functions": [
+    {
+      "source": ".",
+      "kit": "bigquery-firestore-export",
+      "instances": {
+        "default": "."
+      }
+    }
+  ]
+}
+```
+
+`instances` maps each instance id to the directory (relative to
+`firebase.json`) holding that instance's `.env`. The CLI prefixes every
+function and task queue name with `kit-<instance id>-`, so the functions above
+deploy as `kit-default-processMessages` and
+`kit-default-upsertTransferConfig`.
+
+```sh
+firebase experiments:enable kits
+firebase deploy --only functions
+```
+
+Deploy a single instance with `firebase deploy --only functions:<instance id>`.
+
+## Configuration
+
+Set these values in a `.env` (or `.env.<projectId>`) file. The Firebase CLI
+loads them at deploy time and prompts for required values that are missing.
+`PROJECT_ID` is supplied by the Firebase CLI.
+
+| Field                     | Env var                     | Required | Default           | Description                                                  |
+| ------------------------- | --------------------------- | -------- | ----------------- | ------------------------------------------------------------ |
+| `instanceId`              | `INSTANCE_ID`               | yes      | —                 | Must match this instance's key in the `instances` map        |
+| `bigqueryDatasetLocation` | `BIGQUERY_DATASET_LOCATION` | no       | `US`              | BigQuery destination dataset location                        |
+| `transferConfigName`      | `TRANSFER_CONFIG_NAME`      | no       | (empty)           | Existing DTS config resource to link instead of creating one |
+| `datasetId`               | `DATASET_ID`                | yes      | —                 | BigQuery destination dataset id                              |
+| `tableName`               | `TABLE_NAME`                | yes      | —                 | Prefix for per-run destination tables                        |
+| `queryString`             | `QUERY_STRING`              | yes      | —                 | Scheduled Standard SQL query                                 |
+| `displayName`             | `DISPLAY_NAME`              | yes      | —                 | Human-readable scheduled-query name                          |
+| `partitioningField`       | `PARTITIONING_FIELD`        | no       | (empty)           | Destination-table partitioning field                         |
+| `schedule`                | `SCHEDULE`                  | yes      | —                 | DTS schedule, such as `every 24 hours`                       |
+| `firestoreCollection`     | `COLLECTION_PATH`           | no       | `transferConfigs` | Root Firestore collection for configs and output             |
+| `logLevel`                | `LOG_LEVEL`                 | no       | `info`            | `debug`, `info`, `warn`, `error`, or `silent`                |
+
+## Multiple instances
+
+To run several reverse-sync instances, add one entry per instance to the
+`instances` map, each pointing at its own config directory with its own `.env`:
+
+```json
+{
+  "functions": [
+    {
+      "source": ".",
+      "kit": "bigquery-firestore-export",
+      "instances": {
+        "users": "instances/users",
+        "orders": "instances/orders"
+      }
+    }
+  ]
+}
+```
+
+Instance ids must be unique across all kit stanzas in the project, and every
+instance's function names are namespaced by its `kit-<instance id>-` prefix, so
+the instances cannot collide. Set `INSTANCE_ID` in each config directory to the
+same value as that directory's key in the `instances` map; it also namespaces
+the Pub/Sub notification topic and associates the deployment with its transfer
+config.
+
+## Provisioning
+
+The kit wires `upsertTransferConfig` to both `afterFirstDeploy` and
+`afterRedeploy`. The lifecycle task creates the Pub/Sub topic and scheduled
+query on first deploy, then reconciles supported query, table, schedule,
+dataset, partitioning, and topic changes on later deploys. It retries transient
+failures up to five times with at least 30 seconds of backoff.
+
+Set `TRANSFER_CONFIG_NAME` to link an existing scheduled-query config without
+changing it. Otherwise the kit stores `extInstanceId` on the Firestore config
+document and uses that value to find the config on later deploys. BigQuery DTS
+does not support clearing a partitioning field once set; create a new transfer
+config to remove partitioning.
+
+## Firestore layout
+
+For a transfer config `{configId}` and run `{runId}`, the kit writes:
+
+```text
+transferConfigs/{configId}
+transferConfigs/{configId}/runs/{runId}
+transferConfigs/{configId}/runs/{runId}/output/{rowId}
+transferConfigs/{configId}/runs/latest
+```
+
+The run document stores DTS metadata and row counts. Its `output` subcollection
+contains converted query rows. The `latest` document is updated transactionally
+so an older completion message cannot replace a newer run.
+
+## API surface
+
+- **Main entry** (`@firebase/bigquery-firestore-export`): exports
+  `processMessages` and `upsertTransferConfig`, registers first-deploy and
+  redeploy lifecycle hooks, and resolves runtime dependencies lazily. Use this
+  entry from Firebase deploy/emulator/runtime.
+- **Library entry** (`./lib`): side-effect-free config helpers, DTS helpers,
+  injectable handlers, BigQuery-to-Firestore conversion helpers, and public
+  message/config types for consumers that own trigger registration.
+
+## License
+
+Apache-2.0

package/lib/config.d.ts

@@ -0,0 +1,5 @@
+import type { BigqueryFirestoreExportConfig, DeployTimeOptions } from "./export-config";
+export declare const CONFIG_EXPRESSIONS: DeployTimeOptions;
+/** Reads runtime values from Firebase deploy-time parameters. */
+export declare function configFromEnv(): BigqueryFirestoreExportConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,6BAA6B,EAC7B,iBAAiB,EAElB,MAAM,iBAAiB,CAAC;AA0BzB,eAAO,MAAM,kBAAkB,EAAE,iBAEhC,CAAC;AAcF,iEAAiE;AACjE,wBAAgB,aAAa,IAAI,6BAA6B,CAkB7D"}

package/lib/config.js

@@ -0,0 +1,75 @@
+"use strict";
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_EXPRESSIONS = void 0;
+exports.configFromEnv = configFromEnv;
+const params_1 = require("firebase-functions/params");
+const LOG_LEVEL_OPTIONS = ["debug", "info", "warn", "error", "silent"];
+const instanceId = (0, params_1.defineString)("INSTANCE_ID");
+const params = {
+    instanceId,
+    bigqueryDatasetLocation: (0, params_1.defineString)("BIGQUERY_DATASET_LOCATION", {
+        default: "US",
+    }),
+    transferConfigName: (0, params_1.defineString)("TRANSFER_CONFIG_NAME", { default: "" }),
+    datasetId: (0, params_1.defineString)("DATASET_ID"),
+    tableName: (0, params_1.defineString)("TABLE_NAME"),
+    queryString: (0, params_1.defineString)("QUERY_STRING"),
+    displayName: (0, params_1.defineString)("DISPLAY_NAME"),
+    partitioningField: (0, params_1.defineString)("PARTITIONING_FIELD", { default: "" }),
+    schedule: (0, params_1.defineString)("SCHEDULE"),
+    firestoreCollection: (0, params_1.defineString)("COLLECTION_PATH", {
+        default: "transferConfigs",
+    }),
+    logLevel: (0, params_1.defineString)("LOG_LEVEL", {
+        default: "info",
+        input: (0, params_1.select)([...LOG_LEVEL_OPTIONS]),
+    }),
+};
+exports.CONFIG_EXPRESSIONS = {
+    pubSubTopic: (0, params_1.expr) `kit-${instanceId}-processMessages`,
+};
+function optional(value) {
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+function normalizeLogLevel(value) {
+    const normalized = value.toLowerCase();
+    return LOG_LEVEL_OPTIONS.includes(normalized)
+        ? normalized
+        : "info";
+}
+/** Reads runtime values from Firebase deploy-time parameters. */
+function configFromEnv() {
+    const resolvedInstanceId = params.instanceId.value();
+    return {
+        bigqueryDatasetLocation: params.bigqueryDatasetLocation.value(),
+        projectId: params_1.projectID.value(),
+        instanceId: resolvedInstanceId,
+        transferConfigName: optional(params.transferConfigName.value()),
+        datasetId: params.datasetId.value(),
+        tableName: params.tableName.value(),
+        queryString: params.queryString.value(),
+        displayName: params.displayName.value(),
+        partitioningField: optional(params.partitioningField.value()),
+        schedule: params.schedule.value(),
+        pubSubTopic: `kit-${resolvedInstanceId}-processMessages`,
+        firestoreCollection: params.firestoreCollection.value(),
+        logLevel: normalizeLogLevel(params.logLevel.value()),
+    };
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/lib/dts.d.ts

@@ -0,0 +1,14 @@
+import * as bigqueryDataTransfer from "@google-cloud/bigquery-data-transfer";
+import type { ResolvedBigqueryFirestoreExportConfig } from "./export-config";
+export type DataTransferClient = bigqueryDataTransfer.v1.DataTransferServiceClient;
+export type TransferConfig = bigqueryDataTransfer.protos.google.cloud.bigquery.datatransfer.v1.ITransferConfig;
+export declare const PARTITIONING_FIELD_REMOVAL_ERROR_PREFIX = "Cannot remove partitioning_field from an existing transfer config";
+export declare const PARTITIONING_FIELD_REMOVAL_ERROR = "Cannot remove partitioning_field from an existing transfer config. The BigQuery Data Transfer API does not support clearing this parameter once it has been set. To change partitioning, create a new transfer config with the desired setting.";
+/** Creates the protobuf-shaped request used for a scheduled query. */
+export declare function createTransferConfigRequest(config: ResolvedBigqueryFirestoreExportConfig, serviceAccountEmail?: string): bigqueryDataTransfer.protos.google.cloud.bigquery.datatransfer.v1.ICreateTransferConfigRequest;
+export declare function getTransferConfig(client: DataTransferClient, transferConfigName: string): Promise<TransferConfig | null>;
+export declare function createTransferConfig(client: DataTransferClient, config: ResolvedBigqueryFirestoreExportConfig): Promise<TransferConfig>;
+/** Builds a minimal update mask while retaining unsupported immutable fields. */
+export declare function constructUpdateTransferConfigRequest(client: DataTransferClient, transferConfigName: string, config: ResolvedBigqueryFirestoreExportConfig): Promise<bigqueryDataTransfer.protos.google.cloud.bigquery.datatransfer.v1.IUpdateTransferConfigRequest>;
+export declare function updateTransferConfig(client: DataTransferClient, transferConfigName: string, config: ResolvedBigqueryFirestoreExportConfig): Promise<TransferConfig>;
+//# sourceMappingURL=dts.d.ts.map

package/lib/dts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts.d.ts","sourceRoot":"","sources":["../src/dts.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,oBAAoB,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,iBAAiB,CAAC;AAG7E,MAAM,MAAM,kBAAkB,GAC5B,oBAAoB,CAAC,EAAE,CAAC,yBAAyB,CAAC;AACpD,MAAM,MAAM,cAAc,GACxB,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,eAAe,CAAC;AAMpF,eAAO,MAAM,uCAAuC,sEACxB,CAAC;AAC7B,eAAO,MAAM,gCAAgC,oPAAgN,CAAC;AAoC9P,sEAAsE;AACtE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,qCAAqC,EAC7C,mBAAmB,CAAC,EAAE,MAAM,GAC3B,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,4BAA4B,CAwBhG;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAchC;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,qCAAqC,GAC5C,OAAO,CAAC,cAAc,CAAC,CAUzB;AAED,iFAAiF;AACjF,wBAAsB,oCAAoC,CACxD,MAAM,EAAE,kBAAkB,EAC1B,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,qCAAqC,GAC5C,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAyDzG;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,kBAAkB,EAC1B,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,qCAAqC,GAC5C,OAAO,CAAC,cAAc,CAAC,CAczB"}

package/lib/dts.js

@@ -0,0 +1,189 @@
+"use strict";
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARTITIONING_FIELD_REMOVAL_ERROR = exports.PARTITIONING_FIELD_REMOVAL_ERROR_PREFIX = void 0;
+exports.createTransferConfigRequest = createTransferConfigRequest;
+exports.getTransferConfig = getTransferConfig;
+exports.createTransferConfig = createTransferConfig;
+exports.constructUpdateTransferConfigRequest = constructUpdateTransferConfigRequest;
+exports.updateTransferConfig = updateTransferConfig;
+const bigqueryDataTransfer = __importStar(require("@google-cloud/bigquery-data-transfer"));
+const logs = __importStar(require("./logs"));
+const GRPC_NOT_FOUND = 5;
+const PACKAGE_PARTITIONING_ERROR = "Cannot remove partitioning_field from an existing transfer config";
+exports.PARTITIONING_FIELD_REMOVAL_ERROR_PREFIX = PACKAGE_PARTITIONING_ERROR;
+exports.PARTITIONING_FIELD_REMOVAL_ERROR = `${PACKAGE_PARTITIONING_ERROR}. The BigQuery Data Transfer API does not support clearing this parameter once it has been set. To change partitioning, create a new transfer config with the desired setting.`;
+function isNotFoundError(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === GRPC_NOT_FOUND);
+}
+function transferConfigFields(config) {
+    const fields = config.params?.fields;
+    if (!fields) {
+        throw new Error("Transfer config has invalid structure: missing params.fields");
+    }
+    if (!fields.query) {
+        throw new Error("Transfer config has invalid structure: missing params.fields.query");
+    }
+    if (!fields.destination_table_name_template) {
+        throw new Error("Transfer config has invalid structure: missing params.fields.destination_table_name_template");
+    }
+    return fields;
+}
+function stringField(value) {
+    return { stringValue: value ?? "" };
+}
+/** Creates the protobuf-shaped request used for a scheduled query. */
+function createTransferConfigRequest(config, serviceAccountEmail) {
+    return {
+        parent: `projects/${config.projectId}`,
+        transferConfig: {
+            destinationDatasetId: config.datasetId,
+            displayName: config.displayName,
+            dataSourceId: "scheduled_query",
+            params: {
+                fields: {
+                    query: stringField(config.queryString),
+                    destination_table_name_template: stringField(`${config.tableName}_{run_time|"%H%M%S"}`),
+                    write_disposition: stringField("WRITE_TRUNCATE"),
+                    partitioning_field: stringField(config.partitioningField),
+                },
+            },
+            schedule: config.schedule,
+            notificationPubsubTopic: `projects/${config.projectId}/topics/${config.pubSubTopic}`,
+            ...(serviceAccountEmail
+                ? { serviceAccountName: serviceAccountEmail }
+                : {}),
+        },
+    };
+}
+async function getTransferConfig(client, transferConfigName) {
+    try {
+        const [config] = await client.getTransferConfig({
+            name: transferConfigName,
+        });
+        return config;
+    }
+    catch (err) {
+        if (isNotFoundError(err)) {
+            logs.transferConfigNotFound(transferConfigName);
+            return null;
+        }
+        logs.getTransferConfigFailed(transferConfigName, err);
+        throw err;
+    }
+}
+async function createTransferConfig(client, config) {
+    logs.createTransferConfig();
+    const [created] = await client.createTransferConfig(createTransferConfigRequest(config, config.serviceAccount));
+    if (!created.name) {
+        throw new Error("BigQuery API returned a transfer config without a name");
+    }
+    logs.transferConfigCreated(created.name);
+    return created;
+}
+/** Builds a minimal update mask while retaining unsupported immutable fields. */
+async function constructUpdateTransferConfigRequest(client, transferConfigName, config) {
+    const transferConfig = await getTransferConfig(client, transferConfigName);
+    if (!transferConfig)
+        throw new Error("Transfer config not found");
+    const fields = transferConfigFields(transferConfig);
+    const updatedConfig = JSON.parse(JSON.stringify(transferConfig));
+    const updatedFields = transferConfigFields(updatedConfig);
+    const updateMask = [];
+    if (config.datasetId !== transferConfig.destinationDatasetId) {
+        updateMask.push("destination_dataset_id");
+        updatedConfig.destinationDatasetId = config.datasetId;
+    }
+    if (config.queryString !== fields.query.stringValue) {
+        updateMask.push("params");
+        updatedFields.query.stringValue = config.queryString;
+    }
+    const tableTemplate = `${config.tableName}_{run_time|"%H%M%S"}`;
+    if (tableTemplate !== fields.destination_table_name_template.stringValue) {
+        updateMask.push("params");
+        updatedFields.destination_table_name_template.stringValue = tableTemplate;
+    }
+    const existingPartitioningField = fields.partitioning_field?.stringValue ?? "";
+    const newPartitioningField = config.partitioningField ?? "";
+    if (newPartitioningField !== existingPartitioningField) {
+        if (!newPartitioningField) {
+            logs.partitioningFieldRemovalAttempted(transferConfigName, existingPartitioningField);
+            throw new Error(exports.PARTITIONING_FIELD_REMOVAL_ERROR);
+        }
+        updateMask.push("params");
+        updatedFields.partitioning_field ??= {};
+        updatedFields.partitioning_field.stringValue = newPartitioningField;
+    }
+    if (config.schedule !== transferConfig.schedule) {
+        updateMask.push("schedule");
+        updatedConfig.schedule = config.schedule;
+    }
+    const expectedTopic = `projects/${config.projectId}/topics/${config.pubSubTopic}`;
+    if (expectedTopic !== transferConfig.notificationPubsubTopic) {
+        updateMask.push("notification_pubsub_topic");
+        updatedConfig.notificationPubsubTopic = expectedTopic;
+    }
+    return {
+        transferConfig: updatedConfig,
+        updateMask: { paths: [...new Set(updateMask)] },
+    };
+}
+async function updateTransferConfig(client, transferConfigName, config) {
+    const request = await constructUpdateTransferConfigRequest(client, transferConfigName, config);
+    logs.updateTransferConfig(transferConfigName);
+    const converted = bigqueryDataTransfer.protos.google.cloud.bigquery.datatransfer.v1.UpdateTransferConfigRequest.fromObject(request);
+    const [updated] = await client.updateTransferConfig(converted);
+    logs.transferConfigUpdated(transferConfigName);
+    return updated;
+}
+//# sourceMappingURL=dts.js.map

package/lib/dts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts.js","sourceRoot":"","sources":["../src/dts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,MAAY,oBAAoB,iEAA6C;AAE7E,MAAY,IAAI,mCAAe;AAO/B,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,0BAA0B,GAC9B,mEAAmE,CAAC;AAEzD,QAAA,uCAAuC,GAClD,0BAA0B,CAAC;AAChB,QAAA,gCAAgC,GAAG,GAAG,0BAA0B,gLAAgL,CAAC;AAE9P,SAAS,eAAe,CAAC,GAAY;IACnC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACb,GAAG,CAAC,IAAI,KAAK,cAAc,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAsB;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACrC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,+BAA+B,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,8FAA8F,CAC/F,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAyB;IAC5C,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,sEAAsE;AACtE,qCACE,MAA6C,EAC7C,mBAA4B;IAE5B,OAAO;QACL,MAAM,EAAE,YAAY,MAAM,CAAC,SAAS,EAAE;QACtC,cAAc,EAAE;YACd,oBAAoB,EAAE,MAAM,CAAC,SAAS;YACtC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,iBAAiB;YAC/B,MAAM,EAAE;gBACN,MAAM,EAAE;oBACN,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC;oBACtC,+BAA+B,EAAE,WAAW,CAC1C,GAAG,MAAM,CAAC,SAAS,sBAAsB,CAC1C;oBACD,iBAAiB,EAAE,WAAW,CAAC,gBAAgB,CAAC;oBAChD,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,iBAAiB,CAAC;iBAC1D;aACF;YACD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,uBAAuB,EAAE,YAAY,MAAM,CAAC,SAAS,WAAW,MAAM,CAAC,WAAW,EAAE;YACpF,GAAG,CAAC,mBAAmB;gBACrB,CAAC,CAAC,EAAE,kBAAkB,EAAE,mBAAmB,EAAE;gBAC7C,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC;AAEM,KAAK,4BACV,MAA0B,EAC1B,kBAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC;YAC9C,IAAI,EAAE,kBAAkB;SACzB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,uBAAuB,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAEM,KAAK,+BACV,MAA0B,EAC1B,MAA6C;IAE7C,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,MAAM,CAAC,oBAAoB,CACjD,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAC3D,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iFAAiF;AAC1E,KAAK,+CACV,MAA0B,EAC1B,kBAA0B,EAC1B,MAA6C;IAE7C,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3E,IAAI,CAAC,cAAc;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAElE,MAAM,MAAM,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAC9B,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CACb,CAAC;IACpB,MAAM,aAAa,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,MAAM,CAAC,SAAS,KAAK,cAAc,CAAC,oBAAoB,EAAE,CAAC;QAC7D,UAAU,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC1C,aAAa,CAAC,oBAAoB,GAAG,MAAM,CAAC,SAAS,CAAC;IACxD,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACpD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,aAAa,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACvD,CAAC;IAED,MAAM,aAAa,GAAG,GAAG,MAAM,CAAC,SAAS,sBAAsB,CAAC;IAChE,IAAI,aAAa,KAAK,MAAM,CAAC,+BAA+B,CAAC,WAAW,EAAE,CAAC;QACzE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,aAAa,CAAC,+BAA+B,CAAC,WAAW,GAAG,aAAa,CAAC;IAC5E,CAAC;IAED,MAAM,yBAAyB,GAC7B,MAAM,CAAC,kBAAkB,EAAE,WAAW,IAAI,EAAE,CAAC;IAC/C,MAAM,oBAAoB,GAAG,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAC5D,IAAI,oBAAoB,KAAK,yBAAyB,EAAE,CAAC;QACvD,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,IAAI,CAAC,iCAAiC,CACpC,kBAAkB,EAClB,yBAAyB,CAC1B,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,QAAA,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,aAAa,CAAC,kBAAkB,KAAK,EAAE,CAAC;QACxC,aAAa,CAAC,kBAAkB,CAAC,WAAW,GAAG,oBAAoB,CAAC;IACtE,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,cAAc,CAAC,QAAQ,EAAE,CAAC;QAChD,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5B,aAAa,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED,MAAM,aAAa,GAAG,YAAY,MAAM,CAAC,SAAS,WAAW,MAAM,CAAC,WAAW,EAAE,CAAC;IAClF,IAAI,aAAa,KAAK,cAAc,CAAC,uBAAuB,EAAE,CAAC;QAC7D,UAAU,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC7C,aAAa,CAAC,uBAAuB,GAAG,aAAa,CAAC;IACxD,CAAC;IAED,OAAO;QACL,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE;KAChD,CAAC;AACJ,CAAC;AAEM,KAAK,+BACV,MAA0B,EAC1B,kBAA0B,EAC1B,MAA6C;IAE7C,MAAM,OAAO,GAAG,MAAM,oCAAoC,CACxD,MAAM,EACN,kBAAkB,EAClB,MAAM,CACP,CAAC;IACF,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAC9C,MAAM,SAAS,GACb,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,2BAA2B,CAAC,UAAU,CACtG,OAAO,CACR,CAAC;IACJ,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/export-config.d.ts

@@ -0,0 +1,58 @@
+import type { Expression } from "firebase-functions/params";
+/** Log levels supported by the original extension. */
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+/** Public configuration for the BigQuery-to-Firestore functions. */
+export interface BigqueryFirestoreExportConfig {
+    /** Location of the BigQuery destination dataset, for example `US`. */
+    bigqueryDatasetLocation: string;
+    /** Google Cloud project id. */
+    projectId: string;
+    /** Stable id used to associate a DTS config with this deployment. */
+    instanceId: string;
+    /** Link this existing DTS config instead of creating one. */
+    transferConfigName?: string;
+    /** BigQuery destination dataset id. */
+    datasetId: string;
+    /** Prefix for per-run destination tables. */
+    tableName: string;
+    /** Scheduled query text. */
+    queryString: string;
+    /** Human-readable DTS scheduled-query name. */
+    displayName: string;
+    /** Optional destination-table partitioning field. */
+    partitioningField?: string;
+    /** BigQuery Data Transfer schedule, for example `every 15 minutes`. */
+    schedule: string;
+    /** Pub/Sub topic receiving DTS completion notifications. */
+    pubSubTopic?: string;
+    /** Root Firestore collection for configs and run output. */
+    firestoreCollection?: string;
+    /** Runtime identity used when creating a DTS config. */
+    serviceAccount?: string;
+    /** Log verbosity. Defaults to `info`. */
+    logLevel?: LogLevel;
+}
+/** Configuration after defaults and validation have been applied. */
+export interface ResolvedBigqueryFirestoreExportConfig {
+    bigqueryDatasetLocation: string;
+    projectId: string;
+    instanceId: string;
+    transferConfigName?: string;
+    datasetId: string;
+    tableName: string;
+    queryString: string;
+    displayName: string;
+    partitioningField?: string;
+    schedule: string;
+    pubSubTopic: string;
+    firestoreCollection: string;
+    serviceAccount?: string;
+    logLevel: LogLevel;
+}
+/** Deploy-time values used to construct the v2 triggers. */
+export interface DeployTimeOptions {
+    pubSubTopic: string | Expression<string>;
+}
+/** Applies package defaults and validates a user-supplied configuration. */
+export declare function resolveConfig(config: BigqueryFirestoreExportConfig): ResolvedBigqueryFirestoreExportConfig;
+//# sourceMappingURL=export-config.d.ts.map

package/lib/export-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-config.d.ts","sourceRoot":"","sources":["../src/export-config.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE,oEAAoE;AACpE,MAAM,WAAW,6BAA6B;IAC5C,sEAAsE;IACtE,uBAAuB,EAAE,MAAM,CAAC;IAChC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,qCAAqC;IACpD,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;CAC1C;AAgBD,4EAA4E;AAC5E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,6BAA6B,GACpC,qCAAqC,CA6BvC"}

package/lib/export-config.js

@@ -0,0 +1,56 @@
+"use strict";
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfig = resolveConfig;
+function required(value, field) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new Error(`${field} must be a non-empty string.`);
+    }
+    return normalized;
+}
+function optional(value) {
+    if (value === undefined)
+        return undefined;
+    const normalized = value.trim();
+    return normalized || undefined;
+}
+/** Applies package defaults and validates a user-supplied configuration. */
+function resolveConfig(config) {
+    const instanceId = required(config.instanceId, "instanceId");
+    const logLevel = config.logLevel ?? "info";
+    if (!["debug", "info", "warn", "error", "silent"].includes(logLevel)) {
+        throw new Error(`Unsupported logLevel: ${logLevel}`);
+    }
+    return {
+        bigqueryDatasetLocation: required(config.bigqueryDatasetLocation, "bigqueryDatasetLocation"),
+        projectId: required(config.projectId, "projectId"),
+        instanceId,
+        transferConfigName: optional(config.transferConfigName),
+        datasetId: required(config.datasetId, "datasetId"),
+        tableName: required(config.tableName, "tableName"),
+        queryString: required(config.queryString, "queryString"),
+        displayName: required(config.displayName, "displayName"),
+        partitioningField: optional(config.partitioningField),
+        schedule: required(config.schedule, "schedule"),
+        pubSubTopic: optional(config.pubSubTopic) ?? `kit-${instanceId}-processMessages`,
+        firestoreCollection: optional(config.firestoreCollection) ?? "transferConfigs",
+        serviceAccount: optional(config.serviceAccount),
+        logLevel,
+    };
+}
+//# sourceMappingURL=export-config.js.map

package/lib/export-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-config.js","sourceRoot":"","sources":["../src/export-config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AA8DH,SAAS,QAAQ,CAAC,KAAa,EAAE,KAAa;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC;AAED,4EAA4E;AAC5E,uBACE,MAAqC;IAErC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC;IAE3C,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,uBAAuB,EAAE,QAAQ,CAC/B,MAAM,CAAC,uBAAuB,EAC9B,yBAAyB,CAC1B;QACD,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC;QAClD,UAAU;QACV,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACvD,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC;QAClD,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC;QAClD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;QACxD,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC;QACxD,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACrD,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC/C,WAAW,EACT,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,OAAO,UAAU,kBAAkB;QACrE,mBAAmB,EACjB,QAAQ,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,iBAAiB;QAC3D,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC;QAC/C,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/lib/handlers.d.ts

@@ -0,0 +1,22 @@
+import type { BigQuery } from "@google-cloud/bigquery";
+import type { PubSub } from "@google-cloud/pubsub";
+import type { Firestore } from "firebase-admin/firestore";
+import type { CloudEvent } from "firebase-functions/v2";
+import type { MessagePublishedData } from "firebase-functions/v2/pubsub";
+import { type DataTransferClient } from "./dts";
+import type { ResolvedBigqueryFirestoreExportConfig } from "./export-config";
+import type { TransferRunPayload } from "./types";
+export type TransferRunEvent = CloudEvent<MessagePublishedData<TransferRunPayload>>;
+/** External services used by both handlers, injected for testability. */
+export interface HandlerContext {
+    db: Firestore;
+    bigquery: BigQuery;
+    dataTransfer: DataTransferClient;
+    pubsub: PubSub;
+    config: ResolvedBigqueryFirestoreExportConfig;
+}
+/** Handles a v2 Pub/Sub completion notification from BigQuery DTS. */
+export declare function handleMessagePublished(event: TransferRunEvent, ctx: HandlerContext): Promise<void>;
+/** Idempotently creates, links, or updates this deployment's DTS config. */
+export declare function handleUpsertTransferConfig(ctx: HandlerContext): Promise<void>;
+//# sourceMappingURL=handlers.d.ts.map