@firebase-function-kits/delete-user-data 0.0.1 → 0.0.2-rc.0

package/CHANGELOG.md

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

package/README.md

@@ -0,0 +1,151 @@
+# @firebase/delete-user-data
+
+Delete user data across Firestore, RTDB, and Storage on account deletion. This
+is the Delete User Data Firebase Extension as an npm package you add to your own
+Firebase Functions codebase and deploy.
+
+It listens for Firebase Auth user deletions, discovers configured (and optional
+auto-discovered) paths containing the user id, and clears matching data in
+Firestorestore, Realtime Database, and Cloud Storage. The functions run in your own
+Firebase project; there is no hosted version, so you deploy them yourself.
+
+## Install
+
+```sh
+npm install @firebase/delete-user-data
+```
+
+## Required IAM
+
+Deploy needs these Google Cloud roles on the function's service account.
+Firebase CLI 15.23.0 or later creates that account, grants the roles below,
+and attaches it to every function in this kit. Do not set a custom runtime
+service account for this codebase — it conflicts with that automatic setup.
+
+| Role | Why |
+|---|---|
+| `roles/datastore.owner` | discover and delete Firestore user data |
+| `roles/firebasedatabase.admin` | delete Realtime Database user data |
+| `roles/storage.admin` | delete Cloud Storage user objects |
+| `roles/pubsub.admin` | publish/subscribe discovery and deletion topics |
+| `roles/eventarc.eventReceiver` | receive Gen2 event triggers |
+| `roles/run.invoker` | allow Eventarc to invoke the Gen2 Cloud Run service |
+
+## Usage
+
+Export the functions from your functions codebase entry:
+
+```ts
+// functions/src/index.ts
+export {
+  clearData,
+  handleSearch,
+  handleDeletion,
+} from "@firebase/delete-user-data";
+```
+
+and configure with a `.env` (or `.env.<projectId>`).
+
+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": "delete-user-data",
+      "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-clearData`, `kit-default-handleSearch`, and
+`kit-default-handleDeletion`.
+
+```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 any required values that are missing.
+
+| Field | Env var | Required | Default | Description |
+|---|---|---|---|---|
+| `instanceId` | `INSTANCE_ID` | yes | — | Must match this instance's key in the `instances` map |
+| `firestorePaths` | `FIRESTORE_PATHS` | no | (empty) | Comma-separated Firestore paths with `{UID}` |
+| `firestoreDatabaseId` | `FIRESTORE_DATABASE_ID` | no | `(default)` | Firestore database id |
+| `firestoreDeleteMode` | `FIRESTORE_DELETE_MODE` | no | `shallow` | `shallow` or `recursive` |
+| `rtdbInstance` | `SELECTED_DATABASE_INSTANCE` | no | (empty) | RTDB instance id |
+| `rtdbLocation` | `SELECTED_DATABASE_LOCATION` | no | `us-central1` | RTDB location |
+| `rtdbPaths` | `RTDB_PATHS` | no | (empty) | Comma-separated RTDB paths with `{UID}` |
+| `storageBucket` | `CLOUD_STORAGE_BUCKET` | no | default Storage bucket | Bucket to clear |
+| `storagePaths` | `STORAGE_PATHS` | no | (empty) | Comma-separated Storage paths with `{UID}` |
+| `enableAutoDiscovery` | `ENABLE_AUTO_DISCOVERY` | no | `false` | Auto-discover user-linked docs |
+| `searchDepth` | `AUTO_DISCOVERY_SEARCH_DEPTH` | no | `3` | Discovery depth |
+| `searchFields` | `AUTO_DISCOVERY_SEARCH_FIELDS` | no | `id,uid,userId` | Fields treated as user ids |
+| `searchFunction` | `SEARCH_FUNCTION` | no | (empty) | Optional custom search function |
+| `discoveryTopicName` | `DISCOVERY_TOPIC_NAME` | no | `kit-<INSTANCE_ID>-discovery` | Pub/Sub discovery topic |
+| `deletionTopicName` | `DELETION_TOPIC_NAME` | no | `kit-<INSTANCE_ID>-deletion` | Pub/Sub deletion topic |
+
+## Multiple instances
+
+To run several deletion pipelines, add one entry per instance to the `instances`
+map, each pointing at its own config directory with its own `.env`:
+
+```json
+{
+  "functions": [
+    {
+      "source": ".",
+      "kit": "delete-user-data",
+      "instances": {
+        "app": "instances/app",
+        "admin": "instances/admin"
+      }
+    }
+  ]
+}
+```
+
+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.
+
+## Events
+
+When `EVENTARC_CHANNEL` is configured, the functions publish deletion events
+for each backend under `firebase.extensions.delete-user-data.v1.*`
+(`firestore`, `database`, and `storage`).
+
+## API surface
+
+- **Main entry** (`@firebase/delete-user-data`): exports `clearData`,
+  `handleSearch`, and `handleDeletion`. The main entry reads environment
+  variables when the module loads, so use it from Firebase deploy/emulator/runtime.
+  For your own triggers, import from `./lib` instead.
+- **Library entry** (`./lib`): handlers (`handleClear`, `handleSearch`,
+  `handleDeletion`), path helpers, search / batch-deletion utilities, and config
+  types (`DeleteUserDataConfig`, `resolveDeleteUserDataConfig`) for owning
+  trigger registration yourself.
+
+## License
+
+Apache-2.0

package/lib/config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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.
+ */
+import type { DeleteUserDataConfig } from "./export-config";
+export declare const CONFIG_EXPRESSIONS: {
+    readonly discoveryTopicName: import("firebase-functions/params").StringParam;
+    readonly deletionTopicName: import("firebase-functions/params").StringParam;
+};
+export declare function configFromEnv(): DeleteUserDataConfig;
+//# 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":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AA0C5D,eAAO,MAAM,kBAAkB;aAC7B,kBAAkB;aAClB,iBAAiB;CACT,CAAC;AAMX,wBAAgB,aAAa,IAAI,oBAAoB,CAqBpD"}

package/lib/config.js

@@ -0,0 +1,86 @@
+"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 instanceId = (0, params_1.defineString)("INSTANCE_ID");
+const params = {
+    instanceId,
+    firestorePaths: (0, params_1.defineString)("FIRESTORE_PATHS", { default: "" }),
+    firestoreDatabaseId: (0, params_1.defineString)("FIRESTORE_DATABASE_ID", {
+        default: "(default)",
+    }),
+    firestoreDeleteMode: (0, params_1.defineString)("FIRESTORE_DELETE_MODE", {
+        default: "shallow",
+        input: (0, params_1.select)(["recursive", "shallow"]),
+    }),
+    rtdbInstance: (0, params_1.defineString)("SELECTED_DATABASE_INSTANCE", { default: "" }),
+    rtdbLocation: (0, params_1.defineString)("SELECTED_DATABASE_LOCATION", {
+        default: "us-central1",
+        input: (0, params_1.select)(["us-central1", "europe-west1", "asia-southeast1"]),
+    }),
+    rtdbPaths: (0, params_1.defineString)("RTDB_PATHS", { default: "" }),
+    storageBucket: (0, params_1.defineString)("CLOUD_STORAGE_BUCKET", {
+        default: params_1.storageBucket,
+    }),
+    storagePaths: (0, params_1.defineString)("STORAGE_PATHS", { default: "" }),
+    enableAutoDiscovery: (0, params_1.defineBoolean)("ENABLE_AUTO_DISCOVERY", {
+        default: false,
+    }),
+    searchDepth: (0, params_1.defineInt)("AUTO_DISCOVERY_SEARCH_DEPTH", { default: 3 }),
+    searchFields: (0, params_1.defineString)("AUTO_DISCOVERY_SEARCH_FIELDS", {
+        default: "id,uid,userId",
+    }),
+    searchFunction: (0, params_1.defineString)("SEARCH_FUNCTION", { default: "" }),
+    // Non-empty defaults so Pub/Sub trigger bindings resolve during deploy
+    // discovery without freezing an empty topic name into the manifest.
+    discoveryTopicName: (0, params_1.defineString)("DISCOVERY_TOPIC_NAME", {
+        default: (0, params_1.expr) `kit-${instanceId}-discovery`,
+    }),
+    deletionTopicName: (0, params_1.defineString)("DELETION_TOPIC_NAME", {
+        default: (0, params_1.expr) `kit-${instanceId}-deletion`,
+    }),
+};
+exports.CONFIG_EXPRESSIONS = {
+    discoveryTopicName: params.discoveryTopicName,
+    deletionTopicName: params.deletionTopicName,
+};
+function optional(value) {
+    return value.length > 0 ? value : undefined;
+}
+function configFromEnv() {
+    return {
+        firestorePaths: optional(params.firestorePaths.value()),
+        firestoreDatabaseId: params.firestoreDatabaseId.value(),
+        firestoreDeleteMode: params.firestoreDeleteMode.value(),
+        rtdbInstance: optional(params.rtdbInstance.value()),
+        rtdbLocation: optional(params.rtdbLocation.value()),
+        rtdbPaths: optional(params.rtdbPaths.value()),
+        storageBucket: optional(params.storageBucket.value()) ?? process.env.STORAGE_BUCKET,
+        storagePaths: optional(params.storagePaths.value()),
+        enableAutoDiscovery: params.enableAutoDiscovery.value(),
+        searchDepth: params.searchDepth.value(),
+        searchFields: params.searchFields.value(),
+        searchFunction: optional(params.searchFunction.value()),
+        instanceId: params.instanceId.value(),
+        discoveryTopicName: optional(params.discoveryTopicName.value()),
+        deletionTopicName: optional(params.deletionTopicName.value()),
+        projectId: params_1.projectID.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/events.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export declare const setupEventChannel: () => void;
+export declare function publishDeletionEvent(target: "firestore" | "database" | "storage", data: object): Promise<unknown>;
+//# sourceMappingURL=events.d.ts.map

package/lib/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,eAAO,MAAM,iBAAiB,QAAO,IAMpC,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,EAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAMlB"}

package/lib/events.js

@@ -0,0 +1,71 @@
+"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.
+ */
+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.setupEventChannel = void 0;
+exports.publishDeletionEvent = publishDeletionEvent;
+const eventArc = __importStar(require("firebase-admin/eventarc"));
+let eventChannel;
+const setupEventChannel = () => {
+    eventChannel = process.env.EVENTARC_CHANNEL
+        ? eventArc.getEventarc().channel(process.env.EVENTARC_CHANNEL, {
+            allowedEventTypes: process.env.EXT_SELECTED_EVENTS,
+        })
+        : undefined;
+};
+exports.setupEventChannel = setupEventChannel;
+async function publishDeletionEvent(target, data) {
+    if (!eventChannel)
+        return Promise.resolve();
+    return eventChannel.publish({
+        type: `firebase.extensions.delete-user-data.v1.${target}`,
+        data,
+    });
+}
+//# sourceMappingURL=events.js.map

package/lib/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,MAAY,QAAQ,oDAAgC;AAEpD,IAAI,YAA0C,CAAC;AAExC,MAAM,iBAAiB,GAAG,GAAS,EAAE;IAC1C,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB;QACzC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE;YAC3D,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;SACnD,CAAC;QACJ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AANW,QAAA,iBAAiB,GAAjB,iBAAiB,CAM5B;AAEK,KAAK,+BACV,MAA4C,EAC5C,IAAY;IAEZ,IAAI,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,OAAO,YAAY,CAAC,OAAO,CAAC;QAC1B,IAAI,EAAE,2CAA2C,MAAM,EAAE;QACzD,IAAI;KACL,CAAC,CAAC;AACL,CAAC"}

package/lib/export-config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 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.
+ */
+export type FirestoreDeleteMode = "recursive" | "shallow";
+export interface DeleteUserDataConfig {
+    firestorePaths?: string;
+    firestoreDatabaseId?: string;
+    firestoreDeleteMode?: FirestoreDeleteMode;
+    rtdbInstance?: string;
+    rtdbLocation?: string;
+    rtdbPaths?: string;
+    storageBucket?: string;
+    storagePaths?: string;
+    enableAutoDiscovery?: boolean;
+    searchDepth?: number;
+    searchFields?: string;
+    searchFunction?: string;
+    instanceId: string;
+    discoveryTopicName?: string;
+    deletionTopicName?: string;
+    projectId?: string;
+}
+export interface ResolvedDeleteUserDataConfig {
+    firestorePaths?: string;
+    firestoreDatabaseId: string;
+    firestoreDeleteMode: FirestoreDeleteMode;
+    rtdbInstance?: string;
+    rtdbLocation?: string;
+    rtdbPaths?: string;
+    storageBucket?: string;
+    storagePaths?: string;
+    enableAutoDiscovery: boolean;
+    searchDepth: number;
+    searchFields: string;
+    searchFunction?: string;
+    instanceId: string;
+    discoveryTopicName: string;
+    deletionTopicName: string;
+    projectId?: string;
+}
+export declare function resolveDeleteUserDataConfig(config: DeleteUserDataConfig): ResolvedDeleteUserDataConfig;
+export declare function getDatabaseUrl(selectedDatabaseInstance: string | undefined, selectedDatabaseLocation: string | undefined): string | null;
+//# 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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAcD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,GAC3B,4BAA4B,CA8B9B;AAED,wBAAgB,cAAc,CAC5B,wBAAwB,EAAE,MAAM,GAAG,SAAS,EAC5C,wBAAwB,EAAE,MAAM,GAAG,SAAS,GAC3C,MAAM,GAAG,IAAI,CAMf"}

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.resolveDeleteUserDataConfig = resolveDeleteUserDataConfig;
+exports.getDatabaseUrl = getDatabaseUrl;
+const DEFAULT_FIRESTORE_DATABASE_ID = "(default)";
+const DEFAULT_FIRESTORE_DELETE_MODE = "shallow";
+const DEFAULT_SEARCH_DEPTH = 3;
+const DEFAULT_SEARCH_FIELDS = "id,uid,userId";
+function topicName(name, instanceId, suffix) {
+    return name ?? `kit-${instanceId}-${suffix}`;
+}
+function resolveDeleteUserDataConfig(config) {
+    const instanceId = config.instanceId;
+    return {
+        firestorePaths: config.firestorePaths,
+        firestoreDatabaseId: config.firestoreDatabaseId ?? DEFAULT_FIRESTORE_DATABASE_ID,
+        firestoreDeleteMode: config.firestoreDeleteMode ?? DEFAULT_FIRESTORE_DELETE_MODE,
+        rtdbInstance: config.rtdbInstance,
+        rtdbLocation: config.rtdbLocation,
+        rtdbPaths: config.rtdbPaths,
+        storageBucket: config.storageBucket,
+        storagePaths: config.storagePaths,
+        enableAutoDiscovery: config.enableAutoDiscovery ?? false,
+        searchDepth: config.searchDepth ?? DEFAULT_SEARCH_DEPTH,
+        searchFields: config.searchFields ?? DEFAULT_SEARCH_FIELDS,
+        searchFunction: config.searchFunction,
+        instanceId,
+        discoveryTopicName: topicName(config.discoveryTopicName, instanceId, "discovery"),
+        deletionTopicName: topicName(config.deletionTopicName, instanceId, "deletion"),
+        projectId: config.projectId,
+    };
+}
+function getDatabaseUrl(selectedDatabaseInstance, selectedDatabaseLocation) {
+    if (!selectedDatabaseLocation || !selectedDatabaseInstance)
+        return null;
+    if (selectedDatabaseLocation === "us-central1") {
+        return `https://${selectedDatabaseInstance}.firebaseio.com`;
+    }
+    return `https://${selectedDatabaseInstance}.${selectedDatabaseLocation}.firebasedatabase.app`;
+}
+//# 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;;;;AA0CH,MAAM,6BAA6B,GAAG,WAAW,CAAC;AAClD,MAAM,6BAA6B,GAAwB,SAAS,CAAC;AACrE,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAC9C,SAAS,SAAS,CAChB,IAAwB,EACxB,UAAkB,EAClB,MAAc;IAEd,OAAO,IAAI,IAAI,OAAO,UAAU,IAAI,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED,qCACE,MAA4B;IAE5B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,mBAAmB,EACjB,MAAM,CAAC,mBAAmB,IAAI,6BAA6B;QAC7D,mBAAmB,EACjB,MAAM,CAAC,mBAAmB,IAAI,6BAA6B;QAC7D,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,KAAK;QACxD,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,oBAAoB;QACvD,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,qBAAqB;QAC1D,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,UAAU;QACV,kBAAkB,EAAE,SAAS,CAC3B,MAAM,CAAC,kBAAkB,EACzB,UAAU,EACV,WAAW,CACZ;QACD,iBAAiB,EAAE,SAAS,CAC1B,MAAM,CAAC,iBAAiB,EACxB,UAAU,EACV,UAAU,CACX;QACD,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED,wBACE,wBAA4C,EAC5C,wBAA4C;IAE5C,IAAI,CAAC,wBAAwB,IAAI,CAAC,wBAAwB;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,wBAAwB,KAAK,aAAa,EAAE,CAAC;QAC/C,OAAO,WAAW,wBAAwB,iBAAiB,CAAC;IAC9D,CAAC;IACD,OAAO,WAAW,wBAAwB,IAAI,wBAAwB,uBAAuB,CAAC;AAChG,CAAC"}

package/lib/handlers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+import type * as admin from "firebase-admin";
+import { type PublisherContext } from "./runBatchPubSubDeletions";
+export interface HandlerContext extends PublisherContext {
+    firestore: admin.firestore.Firestore;
+    storage: admin.storage.Storage;
+    database: admin.database.Database;
+}
+export interface DeleteMessageData {
+    paths: string[];
+    uid: string;
+}
+export interface SearchMessageData {
+    path: string;
+    depth: number;
+    uid: string;
+}
+export declare function handleDeletion(data: DeleteMessageData, ctx: HandlerContext): Promise<void>;
+export declare function handleSearch(data: SearchMessageData, ctx: HandlerContext): Promise<void>;
+export declare function handleClear(uid: string, 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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAC;AAQ7C,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,2BAA2B,CAAC;AAInC,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC;IACrC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;IAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}