🐛 [firestore-bigquery-export] kit installation fails with TypeScript issues.

[ajperel]

[REQUIRED] Step 2: Describe your configuration

Installing a first instance of @firestore-function-kits/firestore-bigquery-export@0.0.2-rc.1 (latest)

[REQUIRED] Step 3: Describe the problem

Steps to reproduce:

Run functions:kits:install --package @firebase-function-kits/firestore-bigquery-export@next --project ajp-testing and accept all default values for kit id and instance id.

Expected result

Successful install

Actual result

A lot of typescript errors:

» firebaselocal functions:kits:install --package @firebase-function-kits/firestore-bigquery-export@next --project ajp-testing
✔ What would you like to name this kit? firestore-bigquery-export
✔ What would you like to name this instance? firestore-bigquery-export
✔  Wrote function-kits/firestore-bigquery-export/source/package.json
✔  Wrote function-kits/firestore-bigquery-export/source/tsconfig.json
✔  Wrote function-kits/firestore-bigquery-export/source/.gitignore
✔  Wrote function-kits/firestore-bigquery-export/source/src/index.ts
i  functions: Running npm install @firebase-function-kits/firestore-bigquery-export@next --save-prefix=^...
npm warn deprecated inflight@1.0.6: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm warn deprecated glob@7.2.3: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
npm warn deprecated uuid@9.0.1: uuid@10 and below is no longer supported.  For ESM codebases, update to uuid@latest.  For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).
npm warn deprecated uuid@9.0.1: uuid@10 and below is no longer supported.  For ESM codebases, update to uuid@latest.  For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).
npm warn deprecated glob@10.5.0: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me
npm warn deprecated glob@10.5.0: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me

added 1030 packages, and audited 1031 packages in 19s

157 packages are looking for funding
  run `npm fund` for details

15 moderate severity vulnerabilities

To address issues that do not require attention, run:
  npm audit fix

To address all issues (including breaking changes), run:
  npm audit fix --force

Run `npm audit` for details.
npm warn allow-scripts 7 packages have install scripts not yet covered by allowScripts:
npm warn allow-scripts   @firebase/util@1.15.3 (postinstall: node ./postinstall.js)
npm warn allow-scripts   protobufjs@7.6.6 (postinstall: node scripts/postinstall)
npm warn allow-scripts   unrs-resolver@1.12.2 (postinstall: node postinstall.js)
npm warn allow-scripts   @firebase/util@1.15.3 (postinstall: node ./postinstall.js)
npm warn allow-scripts   esbuild@0.28.2 (postinstall: node install.js)
npm warn allow-scripts   fsevents@2.3.3 (install: (install scripts present))
npm warn allow-scripts   protobufjs@7.6.5 (postinstall: node scripts/postinstall)
npm warn allow-scripts
npm warn allow-scripts Run `npm approve-scripts --allow-scripts-pending` to review, or `npm approve-scripts <pkg>` to allow.
i  functions: Building TypeScript source...

> build
> tsc

node_modules/@firebase-function-kits/firestore-bigquery-export/node_modules/@google-cloud/firestore/types/firestore.d.ts:21:1 - error TS6200: Definitions of the following identifiers conflict with those in another file: DocumentFieldValue, DocumentData, PartialWithFieldValue, WithFieldValue, UpdateData, Primitive, NestedUpdateFields, ChildUpdateFields, AddPrefixToKeys, UnionToIntersection, Firestore, GeoPoint, Transaction, BulkWriter, BulkWriterError, WriteBatch, SetOptions, WriteResult, DocumentReference, DocumentSnapshot, QueryDocumentSnapshot, OrderByDirection, WhereFilterOp, Query, QuerySnapshot, VectorQuerySnapshot, DocumentChangeType, CollectionReference, CollectionGroup, QueryPartition, AggregateType, AggregateFieldType, AggregateField, AggregateSpecData, AggregateQuery, AggregateQuerySnapshot, VectorQuery, VectorValue, FieldValue, FieldPath, Timestamp, BundleBuilder, v1beta1, v1, OK, CANCELLED, UNKNOWN, INVALID_ARGUMENT, DEADLINE_EXCEEDED, NOT_FOUND, ALREADY_EXISTS, PERMISSION_DENIED, RESOURCE_EXHAUSTED, FAILED_PRECONDITION, ABORTED, OUT_OF_RANGE, UNIMPLEMENTED, INTERNAL, UNAVAILABLE, DATA_LOSS, UNAUTHENTICATED, Filter, Duration, FirebaseFirestore

21 declare namespace FirebaseFirestore {
   ~~~~~~~

  node_modules/@google-cloud/firestore/types/firestore.d.ts:24:1
    24 declare namespace FirebaseFirestore {
       ~~~~~~~
    Conflicts are in this file.

node_modules/@firebase-function-kits/firestore-bigquery-export/node_modules/@google-cloud/firestore/types/firestore.d.ts:512:5 - error TS2374: Duplicate index signature for type 'string'.

512     [key: string]: any; // Accept other properties, such as GRPC settings.
        ~~~~~~~~~~~~~~~~~~~

node_modules/@firebase-function-kits/firestore-bigquery-export/node_modules/@google-cloud/firestore/types/firestore.d.ts:2558:5 - error TS2374: Duplicate index signature for type 'string'.

2558     [field: string]: AggregateFieldType;
         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

node_modules/@google-cloud/firestore/types/firestore.d.ts:24:1 - error TS6200: Definitions of the following identifiers conflict with those in another file: DocumentFieldValue, DocumentData, PartialWithFieldValue, WithFieldValue, UpdateData, Primitive, NestedUpdateFields, ChildUpdateFields, AddPrefixToKeys, UnionToIntersection, Firestore, GeoPoint, Transaction, BulkWrit
er, BulkWriterError, WriteBatch, SetOptions, WriteResult, DocumentReference, DocumentSnapshot, QueryDocumentSnapshot, OrderByDirection, WhereFilterOp, Query, QuerySnapshot, VectorQuerySnapshot, DocumentChangeType, CollectionReference, CollectionGroup, QueryPartition, AggregateType, AggregateFieldType, AggregateField, AggregateSpecData, AggregateQuery, AggregateQuerySnapshot, VectorQuery, VectorValue, FieldValue, FieldPath, Timestamp, BundleBuilder, v1beta1, v1, OK, CANCELLED, UNKNOWN, INVALID_ARGUMENT, DEADLINE_EXCEEDED, NOT_FOUND, ALREADY_EXISTS, PERMISSION_DENIED, RESOURCE_EXHAUSTED, FAILED_PRECONDITION, ABORTED, OUT_OF_RANGE, UNIMPLEMENTED, INTERNAL, UNAVAILABLE, DATA_LOSS, UNAUTHENTICATED, Filter, Duration, FirebaseFirestore

24 declare namespace FirebaseFirestore {
   ~~~~~~~

  node_modules/@firebase-function-kits/firestore-bigquery-export/node_modules/@google-cloud/firestore/types/firestore.d.ts:21:1
    21 declare namespace FirebaseFirestore {
       ~~~~~~~
    Conflicts are in this file.

node_modules/@google-cloud/firestore/types/firestore.d.ts:470:5 - error TS2374: Duplicate index signature for type 'string'.

470     [key: string]: any; // Accept other properties, such as GRPC settings.
        ~~~~~~~~~~~~~~~~~~~

node_modules/@google-cloud/firestore/types/firestore.d.ts:2605:5 - error TS2374: Duplicate index signature for type 'string'.

2605     [field: string]: AggregateFieldType;
         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


Found 6 errors in 2 files.

Errors  Files
     3  node_modules/@firebase-function-kits/firestore-bigquery-export/node_modules/@google-cloud/firestore/types/firestore.d.ts:21
     3  node_modules/@google-cloud/firestore/types/firestore.d.ts:24

Error: TypeScript build failed: Error: spawn(npm, [run, build])
 exited with code: 2

[ajperel]

Note I just published this version of firestore-bigquery-export like minutes ago so it should reflect the latest code.

[IzaakGough]

I managed to reproduce this by having a package.json which pins firebase-functions to any version other than 7.3.2 (the one the kit pins) and then running the kit install command. Note that if you start from a completely fresh project, you can't reproduce this because the CLI's ^7.0.0 resolves to the version the kit pins.

A MRE for the above is as follows:

1. Create a fresh directory and an empty firebase.json

mkdir kit-test && cd kit-test
echo '{}' > firebase.json

2. Create the kits package.json in the correct location, pinning the version of firebase-functions to anything other than 7.3.2

mkdir -p function-kits/firestore-bigquery-export/source
cat > function-kits/firestore-bigquery-export/source/package.json <<'EOF'
{
  "name": "firestore-bigquery-export-wrapper",
  "private": true,
  "main": "lib/index.js",
  "scripts": { "build": "tsc" },
  "engines": { "node": "22" },
  "dependencies": { "firebase-admin": "^13.6.0", "firebase-functions": "7.2.5" },
  "devDependencies": { "typescript": "^6.0.0" }
}
EOF

3. Run the kit install command and accept all defaults

firebase functions:kits:install --npm_package @firebase-function-kits/firestore-bigquery-export@next --project <project-id>

[IzaakGough]

I will open a pr with a quick fix for now which will just use ^ on the version of firebase-functions and firebase-admin across all the kits.