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

package/lib/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AA+BA;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,YAM7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,SAAgB,MAAM,GAAG,MAAM,2BAc3D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QAAe,KAAK,YAAY,MAAM,2BAelE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,uBAG5B;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,2BAeA,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,SAAgB,MAAM,GAAG,MAAM,2BAchE,CAAC"}

package/lib/events.js

@@ -0,0 +1,154 @@
+"use strict";
+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.recordCompletionEvent = exports.recordSuccessEvent = exports.recordErrorEvent = exports.recordStartEvent = exports.setupEventChannel = void 0;
+/*
+ * Copyright 2019 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.
+ */
+const eventArc = __importStar(require("firebase-admin/eventarc"));
+const { getEventarc } = eventArc;
+/**
+ * Builds the Eventarc event type for this extension.
+ *
+ * @param eventName The name of the event (e.g., "onStart", "onError", etc.)
+ * @returns The event type string.
+ */
+const getEventTypes = (eventName) => [
+    `firebase.extensions.firestore-bigquery-export.v1.${eventName}`,
+];
+let eventChannel;
+/**
+ * Sets up the Eventarc channel.
+ *
+ * This function retrieves the Eventarc channel based on the environment variables:
+ * - `EVENTARC_CHANNEL` specifies the channel to use for publishing events.
+ * - `EXT_SELECTED_EVENTS` defines the allowed event types.
+ *
+ * @function setupEventChannel
+ */
+const setupEventChannel = () => {
+    eventChannel = process.env.EVENTARC_CHANNEL
+        ? getEventarc().channel(process.env.EVENTARC_CHANNEL, {
+            allowedEventTypes: process.env.EXT_SELECTED_EVENTS,
+        })
+        : undefined;
+};
+exports.setupEventChannel = setupEventChannel;
+/**
+ * Publishes a "start" event using both OLD and NEW event types.
+ *
+ * @param data The payload to send with the event. Can be a string or an object.
+ * @returns A Promise resolving when both events are published.
+ */
+const recordStartEvent = async (data) => {
+    if (!eventChannel)
+        return Promise.resolve();
+    const eventTypes = getEventTypes("onStart");
+    // Publish events for both OLD and NEW event types
+    return Promise.all(eventTypes.map((type) => eventChannel.publish({
+        type,
+        data,
+    })));
+};
+exports.recordStartEvent = recordStartEvent;
+/**
+ * Publishes an "error" event using both OLD and NEW event types.
+ *
+ * @param err The Error object containing the error message.
+ * @param subject (Optional) Subject identifier related to the error event.
+ * @returns A Promise resolving when both events are published.
+ */
+const recordErrorEvent = async (err, subject) => {
+    if (!eventChannel)
+        return Promise.resolve();
+    const eventTypes = getEventTypes("onError");
+    // Publish events for both OLD and NEW event types
+    return Promise.all(eventTypes.map((type) => eventChannel.publish({
+        type,
+        data: { message: err.message },
+        subject,
+    })));
+};
+exports.recordErrorEvent = recordErrorEvent;
+/**
+ * Publishes a "success" event using both OLD and NEW event types.
+ *
+ * @param params An object containing the subject and the event data.
+ * @param params.subject A string representing the subject of the event.
+ * @param params.data The payload to send with the event.
+ * @returns A Promise resolving when both events are published.
+ */
+const recordSuccessEvent = async ({ subject, data, }) => {
+    if (!eventChannel)
+        return Promise.resolve();
+    const eventTypes = getEventTypes("onSuccess");
+    // Publish events for both OLD and NEW event types
+    return Promise.all(eventTypes.map((type) => eventChannel.publish({
+        type,
+        subject,
+        data,
+    })));
+};
+exports.recordSuccessEvent = recordSuccessEvent;
+/**
+ * Publishes a "completion" event using both OLD and NEW event types.
+ *
+ * @param data The payload to send with the event. Can be a string or an object.
+ * @returns A Promise resolving when both events are published.
+ */
+const recordCompletionEvent = async (data) => {
+    if (!eventChannel)
+        return Promise.resolve();
+    const eventTypes = getEventTypes("onCompletion");
+    // Publish events for both OLD and NEW event types
+    return Promise.all(eventTypes.map((type) => eventChannel.publish({
+        type,
+        data,
+    })));
+};
+exports.recordCompletionEvent = recordCompletionEvent;
+//# sourceMappingURL=events.js.map

package/lib/events.js.map

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

package/lib/export-config.d.ts

@@ -0,0 +1,96 @@
+import type { ChangeTrackerConfig, LogLevel } from "@firebaseextensions/firestore-bigquery-change-tracker";
+import type { Expression } from "firebase-functions/params";
+type TrackerLogLevel = "debug" | "info" | "warn" | "error" | "silent";
+type ConfigValue<T extends string | number | boolean | string[]> = T | Expression<T>;
+/** How the BigQuery changelog view is materialized. */
+export type ViewType = "view" | "materialized_incremental" | "materialized_non_incremental";
+/**
+ * The export configuration. The main entry point builds it from deploy-time
+ * params; handler consumers can construct it directly.
+ *
+ * `collectionPath`, `datasetId`, `tableId`, `location`, and `projectId` are
+ * required; everything else has a sensible default.
+ */
+export interface ExportConfig {
+    /** Firestore collection (or collection group) path to mirror, e.g. `users`
+     *  or `regions/{regionId}/users`. */
+    collectionPath: ConfigValue<string>;
+    /** BigQuery dataset id to write into. */
+    datasetId: ConfigValue<string>;
+    /** BigQuery changelog table id. */
+    tableId: ConfigValue<string>;
+    /** Region for the trigger and task queue. */
+    location: ConfigValue<string>;
+    /** BigQuery dataset location, e.g. `us`, `eu`. Defaults to `us`. */
+    datasetLocation?: ConfigValue<string>;
+    /** Project that owns the BigQuery dataset, if different from the function's
+     *  project. */
+    bqProjectId?: ConfigValue<string>;
+    /** GCP project id. */
+    projectId: ConfigValue<string>;
+    /** Firestore database id. Defaults to `(default)`. */
+    databaseId?: ConfigValue<string>;
+    /** Include path-param values as columns. Defaults to `false`. */
+    wildcardIds?: ConfigValue<boolean>;
+    /** Skip writing the previous document state on updates. Defaults to `false`. */
+    excludeOldData?: ConfigValue<boolean>;
+    /** Use the newer snapshot view query syntax. Defaults to `false`. */
+    useNewSnapshotQuerySyntax?: ConfigValue<boolean>;
+    /** Changelog view strategy. Defaults to `view`. */
+    viewType?: ConfigValue<ViewType>;
+    /** Partitioning strategy for the changelog table. */
+    partitioning?: ChangeTrackerConfig["partitioning"];
+    /** Clustering columns (max 4). */
+    clustering?: string[] | null;
+    /** Materialized-view max staleness interval, e.g. `0-0 0 4:0:0`. */
+    maxStaleness?: ConfigValue<string>;
+    /** Incremental materialized-view refresh interval in minutes. */
+    refreshIntervalMinutes?: ConfigValue<number>;
+    /** Collection id used for the changelog backup table. */
+    backupCollectionId?: ConfigValue<string>;
+    /** Name of a transform function to apply before writing. */
+    transformFunction?: ConfigValue<string>;
+    /** Customer-managed encryption key for the dataset. */
+    kmsKeyName?: ConfigValue<string>;
+    /** Log verbosity. Defaults to `info`. */
+    logLevel?: ConfigValue<TrackerLogLevel | LogLevel>;
+}
+/** {@link ExportConfig} with all defaults applied. */
+export interface ResolvedExportConfig {
+    collectionPath: string;
+    datasetId: string;
+    tableId: string;
+    location: string;
+    datasetLocation: string;
+    bqProjectId?: string;
+    projectId: string;
+    databaseId: string;
+    wildcardIds: boolean;
+    excludeOldData: boolean;
+    useNewSnapshotQuerySyntax: boolean;
+    viewType: ViewType;
+    partitioning?: ChangeTrackerConfig["partitioning"];
+    clustering: string[] | null;
+    maxStaleness?: string;
+    refreshIntervalMinutes?: number;
+    backupCollectionId?: string;
+    transformFunction?: string;
+    kmsKeyName?: string;
+    logLevel: TrackerLogLevel;
+}
+/**
+ * Applies defaults to an {@link ExportConfig}.
+ *
+ * @param config - The user-supplied configuration.
+ * @returns The configuration with every field populated.
+ */
+export declare function resolveExportConfig(config: ExportConfig): ResolvedExportConfig;
+/**
+ * Maps a resolved export config onto the change-tracker's config shape.
+ *
+ * @param config - The resolved export configuration.
+ * @returns The {@link ChangeTrackerConfig} for the event history tracker.
+ */
+export declare function toTrackerConfig(config: ResolvedExportConfig): ChangeTrackerConfig;
+export {};
+//# 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":"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"}

package/lib/export-config.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveExportConfig = resolveExportConfig;
+exports.toTrackerConfig = toTrackerConfig;
+function isExpression(value) {
+    return typeof value === "object" && value !== null && "value" in value;
+}
+function resolveConfigValue(value) {
+    return isExpression(value) ? value.value() : value;
+}
+function resolveOptionalConfigValue(value) {
+    return value === undefined ? undefined : resolveConfigValue(value);
+}
+/**
+ * Applies defaults to an {@link ExportConfig}.
+ *
+ * @param config - The user-supplied configuration.
+ * @returns The configuration with every field populated.
+ */
+function resolveExportConfig(config) {
+    const projectId = resolveConfigValue(config.projectId);
+    const viewType = resolveOptionalConfigValue(config.viewType);
+    const logLevel = resolveOptionalConfigValue(config.logLevel);
+    return {
+        collectionPath: resolveConfigValue(config.collectionPath),
+        datasetId: resolveConfigValue(config.datasetId),
+        tableId: resolveConfigValue(config.tableId),
+        location: resolveConfigValue(config.location),
+        datasetLocation: resolveOptionalConfigValue(config.datasetLocation) ?? "us",
+        bqProjectId: resolveOptionalConfigValue(config.bqProjectId),
+        projectId,
+        databaseId: resolveOptionalConfigValue(config.databaseId) ?? "(default)",
+        wildcardIds: resolveOptionalConfigValue(config.wildcardIds) ?? false,
+        excludeOldData: resolveOptionalConfigValue(config.excludeOldData) ?? false,
+        useNewSnapshotQuerySyntax: resolveOptionalConfigValue(config.useNewSnapshotQuerySyntax) ?? false,
+        viewType: viewType ?? "view",
+        partitioning: config.partitioning,
+        clustering: config.clustering ?? null,
+        maxStaleness: resolveOptionalConfigValue(config.maxStaleness),
+        refreshIntervalMinutes: resolveOptionalConfigValue(config.refreshIntervalMinutes),
+        backupCollectionId: resolveOptionalConfigValue(config.backupCollectionId),
+        transformFunction: resolveOptionalConfigValue(config.transformFunction),
+        kmsKeyName: resolveOptionalConfigValue(config.kmsKeyName),
+        logLevel: logLevel ?? "info",
+    };
+}
+/**
+ * Maps a resolved export config onto the change-tracker's config shape.
+ *
+ * @param config - The resolved export configuration.
+ * @returns The {@link ChangeTrackerConfig} for the event history tracker.
+ */
+function toTrackerConfig(config) {
+    return {
+        firestoreInstanceId: config.databaseId,
+        tableId: config.tableId,
+        datasetId: config.datasetId,
+        datasetLocation: config.datasetLocation,
+        backupTableId: config.backupCollectionId,
+        transformFunction: config.transformFunction,
+        partitioning: config.partitioning,
+        databaseId: config.databaseId,
+        clustering: config.clustering,
+        wildcardIds: config.wildcardIds,
+        bqProjectId: config.bqProjectId ?? config.projectId,
+        useNewSnapshotQuerySyntax: config.useNewSnapshotQuerySyntax,
+        skipInit: true,
+        kmsKeyName: config.kmsKeyName,
+        useMaterializedView: config.viewType === "materialized_incremental" ||
+            config.viewType === "materialized_non_incremental",
+        useIncrementalMaterializedView: config.viewType === "materialized_incremental",
+        maxStaleness: config.maxStaleness,
+        refreshIntervalMinutes: config.refreshIntervalMinutes,
+        logLevel: config.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":";;;;AAiHA,SAAS,YAAY,CACnB,KAAqB;IAErB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC;AACzE,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAqB;IAErB,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACrD,CAAC;AAED,SAAS,0BAA0B,CAEjC,KAAiC;IACjC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED;;;;;GAKG;AACH,6BACE,MAAoB;IAEpB,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,0BAA0B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7D,OAAO;QACL,cAAc,EAAE,kBAAkB,CAAC,MAAM,CAAC,cAAc,CAAC;QACzD,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC;QAC/C,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC;QAC3C,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC7C,eAAe,EAAE,0BAA0B,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,IAAI;QAC3E,WAAW,EAAE,0BAA0B,CAAC,MAAM,CAAC,WAAW,CAAC;QAC3D,SAAS;QACT,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,WAAW;QACxE,WAAW,EAAE,0BAA0B,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK;QACpE,cAAc,EAAE,0BAA0B,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,KAAK;QAC1E,yBAAyB,EACvB,0BAA0B,CAAC,MAAM,CAAC,yBAAyB,CAAC,IAAI,KAAK;QACvE,QAAQ,EAAE,QAAQ,IAAI,MAAM;QAC5B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;QACrC,YAAY,EAAE,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC;QAC7D,sBAAsB,EAAE,0BAA0B,CAChD,MAAM,CAAC,sBAAsB,CAC9B;QACD,kBAAkB,EAAE,0BAA0B,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACzE,iBAAiB,EAAE,0BAA0B,CAAC,MAAM,CAAC,iBAAiB,CAAC;QACvE,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,UAAU,CAAC;QACzD,QAAQ,EAAG,QAA4B,IAAI,MAAM;KAClD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,yBACE,MAA4B;IAE5B,OAAO;QACL,mBAAmB,EAAE,MAAM,CAAC,UAAU;QACtC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,aAAa,EAAE,MAAM,CAAC,kBAAkB;QACxC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,SAAS;QACnD,yBAAyB,EAAE,MAAM,CAAC,yBAAyB;QAC3D,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,mBAAmB,EACjB,MAAM,CAAC,QAAQ,KAAK,0BAA0B;YAC9C,MAAM,CAAC,QAAQ,KAAK,8BAA8B;QACpD,8BAA8B,EAC5B,MAAM,CAAC,QAAQ,KAAK,0BAA0B;QAChD,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;QACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC"}

package/lib/handlers.d.ts

@@ -0,0 +1,29 @@
+import { type FirestoreBigQueryEventHistoryTracker } from "@firebaseextensions/firestore-bigquery-change-tracker";
+import type { Change, DocumentSnapshot, FirestoreEvent } from "firebase-functions/firestore";
+import type { ResolvedExportConfig } from "./export-config";
+/** The Firestore document-write event passed to {@link handleDocumentWrite}. */
+export type DocumentWriteEvent = FirestoreEvent<Change<DocumentSnapshot> | undefined, Record<string, string>>;
+/**
+ * Everything a handler needs to do its work, injected by the caller so the
+ * handlers stay free of global state.
+ */
+export interface HandlerContext {
+    tracker: FirestoreBigQueryEventHistoryTracker;
+    config: ResolvedExportConfig;
+    /**
+     * Provisions the BigQuery dataset/table/views once per instance. Only called
+     * after an inline write failure as a self-heal; the hot path relies on
+     * out-of-band provisioning (`initBigQuerySync` / `setupBigQuerySync`).
+     */
+    ensureInitialized: () => Promise<void>;
+}
+/**
+ * Handles a Firestore document write: serializes the change and writes it to
+ * BigQuery. Failed writes are surfaced to the trigger retry policy after one
+ * self-heal attempt.
+ *
+ * @param event - The Firestore document-write event.
+ * @param ctx - The handler context.
+ */
+export declare function handleDocumentWrite(event: DocumentWriteEvent, ctx: HandlerContext): Promise<void>;
+//# sourceMappingURL=handlers.d.ts.map

package/lib/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,oCAAoC,EAE1C,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EACV,MAAM,EACN,gBAAgB,EAChB,cAAc,EACf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAgB5D,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAC7C,MAAM,CAAC,gBAAgB,CAAC,GAAG,SAAS,EACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,oCAAoC,CAAC;IAC9C,MAAM,EAAE,oBAAoB,CAAC;IAC7B;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAuDD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAkFf"}

package/lib/handlers.js

@@ -0,0 +1,165 @@
+"use strict";
+/*
+ * Copyright 2019 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.handleDocumentWrite = handleDocumentWrite;
+const firestore_bigquery_change_tracker_1 = require("@firebaseextensions/firestore-bigquery-change-tracker");
+const events = __importStar(require("./events"));
+const logs = __importStar(require("./logs"));
+const util_1 = require("./util");
+/**
+ * Records a Firestore document change to BigQuery.
+ *
+ * @param change - Serialized change metadata and payload.
+ * @param tracker - The event history tracker to write through.
+ */
+async function recordEventToBigQuery(change, tracker) {
+    const event = {
+        timestamp: change.timestamp,
+        operation: change.changeType,
+        documentName: change.fullResourceName,
+        documentId: change.documentId,
+        pathParams: change.params,
+        eventId: change.eventId,
+        data: change.data,
+        oldData: change.oldData,
+    };
+    await tracker.record([event]);
+}
+/**
+ * Gives a failed inline write one self-heal attempt before surfacing it to the
+ * Firestore trigger retry policy.
+ *
+ * @param change - The serialized change to write.
+ * @param ctx - The handler context.
+ */
+async function retryAfterSelfHeal(change, ctx) {
+    try {
+        await ctx.ensureInitialized();
+        await recordEventToBigQuery(change, ctx.tracker);
+    }
+    catch (retryErr) {
+        await events.recordErrorEvent(retryErr);
+        logs.logFailedEventAction("Failed to write event to BigQuery from onWrite handler after self-heal", change.fullResourceName, change.eventId, change.changeType, retryErr);
+        throw retryErr;
+    }
+}
+/**
+ * Handles a Firestore document write: serializes the change and writes it to
+ * BigQuery. Failed writes are surfaced to the trigger retry policy after one
+ * self-heal attempt.
+ *
+ * @param event - The Firestore document-write event.
+ * @param ctx - The handler context.
+ */
+async function handleDocumentWrite(event, ctx) {
+    const { data, ...context } = event;
+    if (!data)
+        return;
+    logs.start();
+    // No provisioning on the hot path: BigQuery resources are provisioned
+    // out-of-band (afterFirstDeploy / afterRedeploy tasks). If they are missing,
+    // the inline write fails, self-heals once, then falls back to the trigger
+    // retry policy.
+    const { config, tracker } = ctx;
+    const changeType = (0, util_1.getChangeType)(data);
+    const documentId = (0, util_1.getDocumentId)(data);
+    const isCreated = changeType === firestore_bigquery_change_tracker_1.ChangeType.CREATE;
+    const isDeleted = changeType === firestore_bigquery_change_tracker_1.ChangeType.DELETE;
+    const newData = isDeleted ? undefined : data.after.data();
+    const oldData = isCreated || config.excludeOldData ? undefined : data.before.data();
+    const relativeName = context.document;
+    const projectId = config.projectId;
+    const fullResourceName = `projects/${projectId}/databases/${config.databaseId}/documents/${relativeName}`;
+    const eventId = context.id;
+    const operation = changeType;
+    logs.logEventAction("Firestore event received by onDocumentWritten trigger", fullResourceName, eventId, operation);
+    let serializedData;
+    let serializedOldData;
+    try {
+        serializedData = tracker.serializeData(newData);
+        serializedOldData = tracker.serializeData(oldData);
+    }
+    catch (err) {
+        logs.logFailedEventAction("Failed to serialize data", fullResourceName, eventId, operation, err);
+        throw err;
+    }
+    try {
+        await events.recordStartEvent({
+            documentId,
+            changeType,
+            before: { data: data.before.data() },
+            after: { data: data.after.data() },
+            context,
+        });
+    }
+    catch (err) {
+        logs.error(false, "Failed to record start event", err);
+        throw err;
+    }
+    const change = {
+        timestamp: context.time,
+        eventId: context.id,
+        fullResourceName,
+        changeType,
+        documentId,
+        params: config.wildcardIds ? { ...context.params, documentId } : null,
+        data: serializedData,
+        oldData: serializedOldData,
+    };
+    try {
+        await recordEventToBigQuery(change, tracker);
+    }
+    catch (err) {
+        logs.failedToWriteToBigQueryImmediately(err);
+        await retryAfterSelfHeal(change, ctx);
+    }
+    logs.complete();
+}
+//# sourceMappingURL=handlers.js.map

package/lib/handlers.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,23 @@
+export * from "./lib";
+/**
+ * Firestore trigger: streams document writes on the watched collection into the
+ * BigQuery changelog table. Failed executions are retried by the Firebase
+ * Functions runtime.
+ */
+export declare const fsexportbigquery: import("firebase-functions/core").CloudFunction<import("firebase-functions/firestore").FirestoreEvent<import("firebase-functions/firestore").Change<import("firebase-functions/firestore").DocumentSnapshot>, Record<string, string>>>;
+/**
+ * First-deploy provisioning task (`afterFirstDeploy`). Runs in the function's
+ * own identity, so it has the runtime service account and bound secrets that
+ * creating the dataset/table/views needs (e.g. CMEK). Cloud Tasks retries a
+ * failed initialization on its own schedule, so a transient BigQuery error does
+ * not leave the resources unprovisioned. It is idempotent (`initialize()`
+ * no-ops when resources already exist) and can also be invoked directly as an
+ * authenticated HTTP POST, without queue retries.
+ */
+export declare const initBigQuerySync: import("firebase-functions/tasks").TaskQueueFunction<any>;
+/**
+ * Update/configure lifecycle task. Uses the same idempotent provisioning path
+ * so BigQuery resources are reconciled after parameter changes.
+ */
+export declare const setupBigQuerySync: import("firebase-functions/tasks").TaskQueueFunction<any>;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgDA,cAAc,OAAO,CAAC;AA0EtB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,wOAQ5B,CAAC;AAWF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,2DAM5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,2DAM7B,CAAC"}