diff --git a/.firebaserc b/.firebaserc new file mode 100644 index 000000000..c0bfb3028 --- /dev/null +++ b/.firebaserc @@ -0,0 +1,5 @@ +{ + "projects": { + "default": "angularfire2-test" + } +} diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 000000000..772bfbbb9 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,5 @@ +src/**/firebase.ts linguist-generated=true +src/**/rxfire.ts linguist-generated=true +src/compat/**/base.ts linguist-generated=true +samples/**/* linguist-generated=true +yarn.lock linguist-generated=true \ No newline at end of file diff --git a/.github/workflows/codeql-analysis.yml b/.github/workflows/codeql-analysis.yml new file mode 100644 index 000000000..a1fbcb71c --- /dev/null +++ b/.github/workflows/codeql-analysis.yml @@ -0,0 +1,67 @@ +# For most projects, this workflow file will not need changing; you simply need +# to commit it to your repository. +# +# You may wish to alter this file to override the set of languages analyzed, +# or to provide custom queries or build logic. +# +# ******** NOTE ******** +# We have attempted to detect the languages in your repository. Please check +# the `language` matrix defined below to confirm you have the correct set of +# supported CodeQL languages. +# +name: "CodeQL" + +on: + push: + branches: [ main ] + pull_request: + # The branches below must be a subset of the branches above + branches: [ main ] + schedule: + - cron: '20 23 * * 3' + +jobs: + analyze: + name: Analyze + runs-on: ubuntu-latest + + strategy: + fail-fast: false + matrix: + language: [ 'javascript' ] + # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ] + # Learn more: + # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + + # Initializes the CodeQL tools for scanning. + - name: Initialize CodeQL + uses: github/codeql-action/init@v2 + with: + languages: ${{ matrix.language }} + # If you wish to specify custom queries, you can do so here or in a config file. + # By default, queries listed here will override any specified in a config file. + # Prefix the list here with "+" to use these queries and those in the config file. + # queries: ./path/to/local/query, your-org/your-repo/queries@main + + # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). + # If this step fails, then you should remove it and run the build manually (see below) + - name: Autobuild + uses: github/codeql-action/autobuild@v2 + + # ℹī¸ Command-line programs to run using the OS shell. + # 📚 https://git.io/JvXDl + + # ✏ī¸ If the Autobuild fails above, remove it and uncomment the following three lines + # and modify them (or add more) to build your code if your project + # uses a compiled language + + #- run: | + # make bootstrap + # make release + + - name: Perform CodeQL Analysis + uses: github/codeql-action/analyze@v2 diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml new file mode 100644 index 000000000..ebb9d9b3e --- /dev/null +++ b/.github/workflows/test.yml @@ -0,0 +1,220 @@ +name: Test and publish + +on: + push: + branches: + - main + paths-ignore: + - "**/*.md" + pull_request: + branches: + - "**" + release: + types: + - published + schedule: + - cron: 0 0 * * 1-5 + +jobs: + build: + runs-on: ubuntu-latest + name: Build + steps: + - name: Checkout + uses: actions/checkout@v3 + - name: Setup node + uses: actions/setup-node@v3 + with: + node-version: '20' + check-latest: false + - name: angular build cache + uses: actions/cache@v3 + with: + path: ./.angular + key: angular-cache + - name: node_modules cache + uses: actions/cache@v3 + id: node_modules_cache + with: + path: ./node_modules + key: ${{ runner.os }}-20-${{ hashFiles('package-lock.json') }} + restore-keys: | + ${{ runner.os }}-20- + - name: Install deps + if: steps.node_modules_cache.outputs.cache-hit != 'true' + run: | + npm ci + - name: Build + run: ./tools/build.sh + - name: 'Upload Artifact' + uses: actions/upload-artifact@v4 + with: + name: angularfire-${{ github.run_id }} + path: dist + retention-days: 1 + + test: + runs-on: ${{ matrix.os }} + needs: build + strategy: + matrix: + os: [ ubuntu-latest, macos-latest, windows-latest ] + node: ["18", "20", "22"] + fail-fast: false + name: Test Node ${{ matrix.node }} (${{ matrix.os }}) + steps: + - name: Checkout + uses: actions/checkout@v3 + - name: Setup node + uses: actions/setup-node@v3 + with: + node-version: ${{ matrix.node }} + check-latest: true + - name: node_modules cache + id: node_modules_cache + uses: actions/cache@v3 + with: + path: ./node_modules + key: ${{ runner.os }}-${{ matrix.node }}-${{ hashFiles('package-lock.json') }} + restore-keys: | + ${{ runner.os }}-${{ matrix.node }}- + - name: Install deps + if: steps.node_modules_cache.outputs.cache-hit != 'true' + run: npm ci + - name: Download Artifacts + uses: actions/download-artifact@v4 + - name: Relocate Artifacts + run: mv angularfire-${{ github.run_id }} dist + - name: Test Node + run: | + npm run build:jasmine + npm run test:node + + browser: + runs-on: ${{ matrix.os }} + needs: build + name: Test ${{ matrix.browser }} + strategy: + matrix: + os: [ ubuntu-latest ] + browser: [ chrome-headless, firefox-headless ] + # TODO(davideast): Figure out why Safari tests timeout only on CI + # include: + # - os: macos-latest + # browser: safari + fail-fast: false + steps: + - name: Checkout + uses: actions/checkout@v3 + - name: Setup node + uses: actions/setup-node@v3 + with: + node-version: 20 + check-latest: false + - name: Setup java + uses: actions/setup-java@v3 + with: + distribution: 'temurin' + java-version: '11' + - name: node_modules cache + id: node_modules_cache + uses: actions/cache@v3 + with: + path: ./node_modules + key: ${{ runner.os }}-${{ matrix.node }}-${{ hashFiles('package-lock.json') }} + restore-keys: | + ${{ runner.os }}-${{ matrix.node }}- + - name: Install deps + if: steps.node_modules_cache.outputs.cache-hit != 'true' + run: npm ci + - name: Firebase emulator cache + uses: actions/cache@v3 + with: + path: ~/.cache/firebase/emulators + key: firebase_emulators + - name: Download Artifacts + uses: actions/download-artifact@v4 + - name: Relocate Artifacts + run: mv angularfire-${{ github.run_id }} dist + - name: Test browser + run: npm run test:${{ matrix.browser }} + + contribute: + runs-on: ${{ matrix.os }} + name: Contribute Node ${{ matrix.node }} (${{ matrix.os }}) + strategy: + matrix: + os: [ ubuntu-latest, macos-latest, windows-latest ] + node: ["20"] + fail-fast: false + steps: + - name: Checkout + uses: actions/checkout@v3 + - name: Setup node + uses: actions/setup-node@v3 + with: + node-version: ${{ matrix.node }} + check-latest: true + - name: node_modules cache + uses: actions/cache@v3 + id: node_modules_cache + with: + path: ./node_modules + key: ${{ runner.os }}-${{ matrix.node }}-${{ hashFiles('package-lock.json') }} + restore-keys: | + ${{ runner.os }}-${{ matrix.node }}- + - name: Install deps + if: steps.node_modules_cache.outputs.cache-hit != 'true' + run: npm ci + #- name: Lint + # run: npm run lint + - name: Build + run: npm run build + - name: Test Node + run: | + npm run build:jasmine + npm run test:node + - name: Firebase emulator cache + uses: actions/cache@v3 + with: + path: ~/.cache/firebase/emulators + key: firebase_emulators + - name: Setup java + uses: actions/setup-java@v3 + with: + distribution: 'temurin' + java-version: '11' + - name: Test headless + run: npm run test:chrome-headless + # Tests are flaky on Windows + continue-on-error: ${{ matrix.os == 'windows-latest' }} + + # Break the branch protection test into a seperate step, so we can manage the matrix more easily + test_and_contribute: + runs-on: ubuntu-latest + name: Branch protection + needs: ['test', 'contribute', 'browser'] + steps: + - run: true + + publish: + runs-on: ubuntu-latest + name: Publish (NPM) + needs: ['build', 'test', 'browser'] + if: ${{ github.ref == 'refs/heads/main' || github.event_name == 'release' }} + steps: + - name: Setup node + uses: actions/setup-node@v3 + with: + node-version: '20' + registry-url: 'https://registry.npmjs.org/' + check-latest: false + - name: 'Download Artifacts' + uses: actions/download-artifact@v4 + - name: Publish + run: | + cd ./angularfire-${{ github.run_id }}/packages-dist + chmod +x publish.sh + ./publish.sh + env: + NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} diff --git a/.gitignore b/.gitignore index 9298d341a..beb5d455e 100644 --- a/.gitignore +++ b/.gitignore @@ -6,4 +6,22 @@ typings/ npm-debug.log .idea/ .vscode/settings.json -angularfire2-*.tgz \ No newline at end of file +angular-fire-*.tgz +angularfire2-*.tgz +*.ngfactory.ts +*.ngsummary.json +.DS_Store +yarn-error.log +*.bak +yarn.lock +test/ng-build/**/yarn.lock +tools/build.js +coverage +*.log +api-*.json +angularfire.tgz +unpack.sh +publish.sh +.firebase +.angular +.vscode \ No newline at end of file diff --git a/.npmignore b/.npmignore index 77923cf1e..02a57a315 100644 --- a/.npmignore +++ b/.npmignore @@ -1,2 +1,7 @@ *.spec.* - +test-config.* +publish.sh +__ivy_ngcc__/ +*.min.js +*.min.js.map +*.__ivy_ngcc_bak \ No newline at end of file diff --git a/.nvmrc b/.nvmrc new file mode 100644 index 000000000..1a2f5bd20 --- /dev/null +++ b/.nvmrc @@ -0,0 +1 @@ +lts/* \ No newline at end of file diff --git a/.travis.yml b/.travis.yml deleted file mode 100644 index 9f03314c1..000000000 --- a/.travis.yml +++ /dev/null @@ -1,43 +0,0 @@ -language: node_js -sudo: false -node_js: -- '6' - -addons: - firefox: latest - apt: - sources: - - ubuntu-toolchain-r-test - packages: - - g++-4.8 - -cache: - directories: - - node_modules - -env: - - CXX=g++-4.8 - -install: - - npm install -g yarn - - yarn install - -before_script: - - export DISPLAY=:99.0 - - sh -e /etc/init.d/xvfb start - -script: - - npm run build - - ./node_modules/.bin/karma start --single-run --browsers Firefox --reporters mocha - # Make sure the build that ships to npm builds without errors - - npm run build_npm - # Run integration test to make sure our typings are correct for user-land. - - node tools/run-typings-test.js - # Can't run until https://github.com/angular/protractor/issues/2784 is resolved - #- ./node_modules/.bin/protractor protractor.conf.js --browser firefox - -notifications: - webhooks: - on_success: always # options: [always|never|change] default: always - on_failure: always # options: [always|never|change] default: always - on_start: false # default: false diff --git a/CHANGELOG.md b/CHANGELOG.md deleted file mode 100644 index 5966e725d..000000000 --- a/CHANGELOG.md +++ /dev/null @@ -1,207 +0,0 @@ - -# [4.0.0-rc0](https://github.com/angular/angularfire2/compare/2.0.0-beta.8...v4.0.0-rc0) (2017-05-02) - - -### Bug Fixes - -* **auth:** Use the injected app ([980c447](https://github.com/angular/angularfire2/commit/980c447)) -* **build:** Add package.json files for deep paths ([cd5f2d1](https://github.com/angular/angularfire2/commit/cd5f2d1)), closes [#880](https://github.com/angular/angularfire2/issues/880) -* **database:** Fix test TypeScript errors ([750737c](https://github.com/angular/angularfire2/commit/750737c)), closes [#875](https://github.com/angular/angularfire2/issues/875) -* **database:** use switchMap when a list's query changes ([#831](https://github.com/angular/angularfire2/issues/831)) ([b85147d](https://github.com/angular/angularfire2/commit/b85147d)), closes [#830](https://github.com/angular/angularfire2/issues/830) - - -### Features - -* **auth:** New Auth API ([12aa422](https://github.com/angular/angularfire2/commit/12aa422)) -* **database:** Add AngularFireDatabaseModule ([b388627](https://github.com/angular/angularfire2/commit/b388627)) -* **database:** support optional endAt/equalTo key ([#838](https://github.com/angular/angularfire2/issues/838)) ([e146492](https://github.com/angular/angularfire2/commit/e146492)), closes [#837](https://github.com/angular/angularfire2/issues/837) -* **rc:** Implement rc0 API ([398e4e2](https://github.com/angular/angularfire2/commit/398e4e2)) - - - -# [2.0.0-beta.8](https://github.com/angular/angularfire2/compare/2.0.0-beta7...v2.0.0-beta.8) (2017-02-16) - - -### Bug Fixes - -* **database:** allow null values for equalTo, etc. ([#809](https://github.com/angular/angularfire2/issues/809)) ([561e7b7](https://github.com/angular/angularfire2/commit/561e7b7)) -* **database:** call apply instead of call ([7a85bd2](https://github.com/angular/angularfire2/commit/7a85bd2)) -* **database:** retrieve initial list content once ([#820](https://github.com/angular/angularfire2/issues/820)) ([5c5ff7b](https://github.com/angular/angularfire2/commit/5c5ff7b)), closes [#819](https://github.com/angular/angularfire2/issues/819) -* **database:** store unwrapped snapshots ([9f3c47b](https://github.com/angular/angularfire2/commit/9f3c47b)), closes [#791](https://github.com/angular/angularfire2/issues/791) -* **utils:** Make object $key and $exists properties non-enumerable ([253401f](https://github.com/angular/angularfire2/commit/253401f)) -* **utils:** Minor formatting improvement ([fc3774a](https://github.com/angular/angularfire2/commit/fc3774a)) - - -### Features - -* **database:** adds auditTime for queries ([f9cb5c3](https://github.com/angular/angularfire2/commit/f9cb5c3)), closes [#389](https://github.com/angular/angularfire2/issues/389) [#770](https://github.com/angular/angularfire2/issues/770) -* **database:** support the optional startAt key ([#821](https://github.com/angular/angularfire2/issues/821)) ([c469b11](https://github.com/angular/angularfire2/commit/c469b11)) - - - - -# [2.0.0-beta.7](https://github.com/angular/angularfire2/compare/2.0.0-beta.6...v2.0.0-beta.7) (2017-01-13) - - -### Breaking changes - -* **auth:** Remove `FirebaseAuth` in favor of `AngularFireAuth`. ([d422e6])(https://github.com/angular/angularfire2/commit/d422e62b46a80d9fb12c9a9e2cf1cf2f7db04dd3) - -### Bug Fixes - -* **aot:** Remove AuthBackend param for AOT support ([f875360](https://github.com/angular/angularfire2/commit/f875360)) -* **auth_backend:** Update logout method to return a promise ([169ce64](https://github.com/angular/angularfire2/commit/169ce64)), closes [#583](https://github.com/angular/angularfire2/issues/583) -* **config:** Add messagingSenderId to FirebaseAppConfig ([9c84869](https://github.com/angular/angularfire2/commit/9c84869)) -* **database:** Allow null values for equalTo, etc. ([70a3e94](https://github.com/angular/angularfire2/commit/70a3e94)), closes [#704](https://github.com/angular/angularfire2/issues/704) -* **database:** Removed unused query option ([9cbc59b](https://github.com/angular/angularfire2/commit/9cbc59b)), closes [#706](https://github.com/angular/angularfire2/issues/706) -* **list:** Fix FirebaseListObservable emit as array bug [#574](https://github.com/angular/angularfire2/issues/574) ([ce3de04](https://github.com/angular/angularfire2/commit/ce3de04)) -* **module:** Conditionally pass app name ([8427009](https://github.com/angular/angularfire2/commit/8427009)) - -### Features - -* **module:** Add a custom FirebaseApp name ([73a3e26](https://github.com/angular/angularfire2/commit/73a3e26)) - - - - -# [2.0.0-beta.6-preview](https://github.com/angular/angularfire2/compare/2.0.0-beta.5...v2.0.0-beta.6-preview) (2016-11-02) - - -### Bug Fixes - -* **Database:** use Zone scheduler for object and list factories ([e18da0e](https://github.com/angular/angularfire2/commit/e18da0e)), closes [#637](https://github.com/angular/angularfire2/issues/637) -* **AoT:** change constructor param interface type annotation to any ([2c0a57f](https://github.com/angular/angularfire2/commit/2c0a57f)) -* **build:** Fix npm test and test:watch commands for windows ([86b4b24](https://github.com/angular/angularfire2/commit/86b4b24)), closes [#217](https://github.com/angular/angularfire2/issues/217) -* **database:** Add $ref to observables ([#447](https://github.com/angular/angularfire2/issues/447)) ([a53fac0](https://github.com/angular/angularfire2/commit/a53fac0)), closes [#294](https://github.com/angular/angularfire2/issues/294) -* **imports:** add firebase imports to all places that reference firebase namespace ([c3a954c](https://github.com/angular/angularfire2/commit/c3a954c)), closes [#525](https://github.com/angular/angularfire2/issues/525) - - -### Features - -* **docs:** Add AoT installation and setup ([#546](https://github.com/angular/angularfire2/issues/546)) ([7c20d13](https://github.com/angular/angularfire2/commit/7c20d13)) -* **docs:** update installation guide to latest cli version ([#519](https://github.com/angular/angularfire2/issues/519)) ([648666f](https://github.com/angular/angularfire2/commit/648666f)) -* **hmr:** Add Hot module reloading ([c32a008](https://github.com/angular/angularfire2/commit/c32a008)) - -### Notes - -A TypeScript issue with the previous release has been fixed, where errors about a missing `firebase` namespace were reported. For -applications that worked around this issue by manually adding the `firebase.d.ts` typings to `tsconfig.json`, those typings -should now be removed since the firebase namespace should automatically be resolved within AngularFire. -See [this issue](https://github.com/angular/angularfire2/issues/525) for more context. - - -# [2.0.0-beta.5](https://github.com/angular/angularfire2/compare/2.0.0-beta.4...v2.0.0-beta.5) (2016-09-15) - - -### Bug Fixes - -* **docs:** Remove [@next](https://github.com/next) install ([5984a99](https://github.com/angular/angularfire2/commit/5984a99)) -* **docs:** typos ([197026a](https://github.com/angular/angularfire2/commit/197026a)) -* **docs:** Update for beta.4 ([f2d5ba5](https://github.com/angular/angularfire2/commit/f2d5ba5)) -* **docs:** Update for beta.4 ([b347e16](https://github.com/angular/angularfire2/commit/b347e16)) -* **firebase_*_factory.js:** Fix calls to off() which inadvertently cancel all listeners on the path ([#469](https://github.com/angular/angularfire2/issues/469)) ([b4fb281](https://github.com/angular/angularfire2/commit/b4fb281)), closes [#443](https://github.com/angular/angularfire2/issues/443) -* **package:** Version number ([986685a](https://github.com/angular/angularfire2/commit/986685a)) - - -### Features - -* **utils:** Add $exists method to AFUnwrappedSnapshot ([#471](https://github.com/angular/angularfire2/issues/471)) ([f67aab1](https://github.com/angular/angularfire2/commit/f67aab1)) -* upgrade to RC7 ([#505](https://github.com/angular/angularfire2/issues/505)) ([2410b2d](https://github.com/angular/angularfire2/commit/2410b2d)) - -### BREAKING CHANGES - -The way this project is packaged has changed to be consistent with other Angular packages. -Previously: - - * The project just consisted of CommonJS modules, with `angularfire2.js` as the main entry point. - * The project provided an `es6` directory which contained es2015 modules and es2015 JS - * Package.json included `main` and `jsnext:main` fields, pointing to `angularfire2.js` and `es6/angularfire2.js`, respectively. - -Now: - - * The project ships ES2015 modules with ES5 JS at the root, as well as an ES5 UMD bundle at `bundles/angulafire2.umd.js` - * The `main` field of `package.json` points to `bundles/angularfire2.umd.js`. - * Instead of `jsnext:main`, we're using the `module` field of package.json to point to `index.js`. - * Instead of `angularfire2.js` being the main entry point, an `index.js` has been added (though angulafire2.js hasn't changed significantly). - -If you're using Rollup or Webpack, they should _just work_ with this new setup (please open issues if not). If using SystemJS, you should be able to -add `format: 'esm'` inside of the packages configuration, and it should load and parse the es2015 modules correctly. - -The addition of the umd bundle will also make it possible to use AngularFire2 in a ` + + + + +
+ + + +
+
+ {% block content%} + {{ content | safe }} + {% endblock %} +
+
+ + + +
+ + + diff --git a/site/src/_includes/guide.njk b/site/src/_includes/guide.njk new file mode 100644 index 000000000..c90443d47 --- /dev/null +++ b/site/src/_includes/guide.njk @@ -0,0 +1,11 @@ +{% extends "default.njk" %} +{% import "next-prev.njk" as nextprev with context %} + +{% block content %} + +

{{ title }}

+ + {{ content | safe }} + {{ nextprev.contextgrid("guides") }} + +{% endblock %} diff --git a/site/src/_includes/next-prev.njk b/site/src/_includes/next-prev.njk new file mode 100644 index 000000000..703894789 --- /dev/null +++ b/site/src/_includes/next-prev.njk @@ -0,0 +1,65 @@ + +{% macro item(direction, title, url) %} + {% set justifyDirection = 'justify-center lg:justify-start xl:justify-start' %} + {% set textDirection = 'text-center lg:text-left xl:text-left' %} + + {% if direction === 'Next' %} + {% set justifyDirection = 'justify-center lg:justify-end xl:justify-end' %} + {% set textDirection = 'text-center lg:text-right xl:text-right' %} + {% endif%} + + +
+
+ {{ direction }} +
+ + {{ title }} + +
+ +{% endmacro %} + +{% macro grid(prevRecord, nextRecord) %} + +
+ + + +
+ +{% endmacro %} + +{% macro contextgrid(tag) %} + {# Get the current page index from eleventyNavigation and then get the next and previous pages #} + + {% if eleventyNavigation.parent %} + {% set children = nextprev[eleventyNavigation.parent].children %} + {% set prevRecord = children | findPreviousEntry(eleventyNavigation) %} + {% set nextRecord = children | findNextEntry(eleventyNavigation) %} + + {{ grid(prevRecord, nextRecord) }} + + {% endif%} + +{% endmacro %} diff --git a/site/src/_includes/side-nav.njk b/site/src/_includes/side-nav.njk new file mode 100644 index 000000000..b1772ea6f --- /dev/null +++ b/site/src/_includes/side-nav.njk @@ -0,0 +1,45 @@ +{# +Type of sectionEntry +[{ + "key": "Mammals", + "url": "/mammals/", + "title": "Mammals", + "children": [{ + "key": "Humans", + "parentKey": "Mammals", + "url": "/humans/", + "title": "Humans" + }, + { + "key": "Dogs", + "parentKey": "Mammals", + "url": "/dogs/", + "title": "Dogs" + }] + }] +#} + +{% macro navsection(sectionEntry, page) %} + +{% endmacro %} diff --git a/site/src/analytics/analytics.11tydata.json b/site/src/analytics/analytics.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/analytics/analytics.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/analytics/getting-started.md b/site/src/analytics/getting-started.md new file mode 100644 index 000000000..33753cf89 --- /dev/null +++ b/site/src/analytics/getting-started.md @@ -0,0 +1,140 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Analytics +--- + +## Google Analytics + +`AngularFireAnalytics` dynamically imports the `firebase/analytics` library and provides a promisified version of the [Firebase Analytics SDK (`firebase.analytics.Analytics`)](https://firebase.google.com/docs/reference/js/firebase.analytics.Analytics.html). + +## API Summary + +```ts +class AngularFireAnalytics { + updateConfig(options: {[key:string]: any}): Promise; + + // from firebase.analytics() proxy: + logEvent(eventName: string, eventParams?: {[key: string]: any}, options?: analytics.AnalyticsCallOptions): Promise; + setCurrentScreen(screenName: string, options?: analytics.AnalyticsCallOptions): Promise; + setUserId(id: string, options?: analytics.AnalyticsCallOptions): Promise; + setUserProperties(properties: analytics.CustomParams, options?: analytics.AnalyticsCallOptions): Promise; + setAnalyticsCollectionEnabled(enabled: boolean): Promise; + app: Promise; +} + +COLLECTION_ENABLED = InjectionToken; +APP_VERSION = InjectionToken; +APP_NAME = InjectionToken; +DEBUG_MODE = InjectionToken; +CONFIG = InjectionToken; +``` + +## Usage + +```ts +import { AngularFireAnalyticsModule } from '@angular/fire/analytics'; + +@NgModule({ + imports: [ + AngularFireModule.initializeApp(environment.firebase), + AngularFireAnalyticsModule + ] +}) +export class AppModule { } +``` + +`AngularFireAnalyticsModule` will dynamically import and configure `firebase/analytics`. A `page_view` event will automatically be logged (see `CONFIG` below if you wish to disable this behavior.) + +In your component you can then dependency inject `AngularFireAnalytics` and make calls against the SDK: + +```ts +import { AngularFireAnalytics } from '@angular/fire/analytics'; + +constructor(analytics: AngularFireAnalytics) { + analytics.logEvent('custom_event', { ... }); +} +``` + +## Tracking Screen Views + +You can log [`screen_view` events](https://firebase.google.com/docs/reference/js/firebase.analytics.Analytics.html#parameters_10) yourself of course, but AngularFire provides the `ScreenTrackingService` which automatically integrates with the Angular Router to provide Firebase with screen view tracking. You simply can integrate like so: + +```ts +import { AngularFireAnalyticsModule, ScreenTrackingService } from '@angular/fire/analytics'; + +@NgModule({ + imports: [ + AngularFireModule.initializeApp(environment.firebase), + AngularFireAnalyticsModule + ], + providers: [ + ScreenTrackingService + ] +}) +export class AppModule { } +``` + +`AngularFireAnalyticsModule` will initialize `ScreenTrackingService` if it is provided. + +## Tracking User Identifiers + +To enrich your Analytics data you can track the currently signed in user by setting [`setuserid`](https://firebase.google.com/docs/reference/js/firebase.analytics.Analytics.html#setuserid) and [`setUserProperties`](https://firebase.google.com/docs/reference/js/firebase.analytics.Analytics.html#set-user-properties). AngularFire provides a `UserTrackingService` which will dynamically import `firebase/auth`, monitor for changes in the logged in user, and call `setuserid` for you automatically. + + +```ts +import { AngularFireAnalyticsModule, UserTrackingService } from '@angular/fire/analytics'; + +@NgModule({ + imports: [ + AngularFireModule.initializeApp(environment.firebase), + AngularFireAnalyticsModule + ], + providers: [ + UserTrackingService + ] +}) +export class AppModule { } +``` + +`AngularFireAnalyticsModule` will initialize `UserTrackingService` if it is provided. + +## Configuration with Dependency Injection + +Using the `CONFIG` DI Token (*default: {}*) will allow you to configure Google Analytics. E.g, you could skip sending the initial `page_view` event, anonymize IP addresses, and disallow ads personalization signals for all events like so: + +```ts +import { AngularFireAnalyticsModule, CONFIG } from '@angular/fire/analytics'; + +@NgModule({ + imports: [ + AngularFireModule.initializeApp(environment.firebase), + AngularFireAnalyticsModule + ], + providers: [ + { provide: CONFIG, useValue: { + send_page_view: false, + allow_ad_personalization_signals: false, + anonymize_ip: true + } } + ] +}) +export class AppModule { } +``` + +See the gtag.js documentation to learn of the different configuration options at your disposal. + +## Use DebugView + +To use [DebugView in Analytics](https://console.firebase.google.com/project/_/analytics/debugview) set `DEBUG_MODE` to `true` (*default: false*). + +## Track deployments + +If you provide `APP_NAME` and `APP_VERSION` (*default: undefined*) you will be able to [track version adoption](https://console.firebase.google.com/project/_/analytics/latestrelease) of your PWA. + +## Disable collection + +If you set `COLLECTION_ENABLED` (*default: true*) to `false` then analytics collection will be disabled for this app on this device. To opt back in to analytics collection you could then call `setAnalyticsCollectionEnabled(true)`. + +Putting these APIs to use with cookies would allow you to create a flexible analytics collection scheme that would respect your user's preferences and data collection policies. diff --git a/site/src/analytics/index.md b/site/src/analytics/index.md new file mode 100644 index 000000000..4bcfd0e99 --- /dev/null +++ b/site/src/analytics/index.md @@ -0,0 +1,6 @@ +--- +eleventyNavigation: + key: Analytics + order: 5 +--- + diff --git a/site/src/assets/GoogleSans-Bold.woff2 b/site/src/assets/GoogleSans-Bold.woff2 new file mode 100644 index 000000000..f69d92101 Binary files /dev/null and b/site/src/assets/GoogleSans-Bold.woff2 differ diff --git a/site/src/assets/GoogleSans-Medium.woff2 b/site/src/assets/GoogleSans-Medium.woff2 new file mode 100644 index 000000000..ab01e3bbb Binary files /dev/null and b/site/src/assets/GoogleSans-Medium.woff2 differ diff --git a/site/src/assets/GoogleSans-Regular.woff2 b/site/src/assets/GoogleSans-Regular.woff2 new file mode 100644 index 000000000..7803436c9 Binary files /dev/null and b/site/src/assets/GoogleSans-Regular.woff2 differ diff --git a/site/src/assets/Roboto-900.woff2 b/site/src/assets/Roboto-900.woff2 new file mode 100644 index 000000000..802499d3f Binary files /dev/null and b/site/src/assets/Roboto-900.woff2 differ diff --git a/site/src/assets/Roboto-Italic.woff2 b/site/src/assets/Roboto-Italic.woff2 new file mode 100644 index 000000000..2741d4f08 Binary files /dev/null and b/site/src/assets/Roboto-Italic.woff2 differ diff --git a/site/src/assets/Roboto-Regular.woff2 b/site/src/assets/Roboto-Regular.woff2 new file mode 100644 index 000000000..1a5370151 Binary files /dev/null and b/site/src/assets/Roboto-Regular.woff2 differ diff --git a/site/src/assets/RobotoMono-Regular.woff2 b/site/src/assets/RobotoMono-Regular.woff2 new file mode 100644 index 000000000..ed384d22f Binary files /dev/null and b/site/src/assets/RobotoMono-Regular.woff2 differ diff --git a/site/src/assets/corner.svg b/site/src/assets/corner.svg new file mode 100644 index 000000000..ba786e975 --- /dev/null +++ b/site/src/assets/corner.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/site/src/assets/firebase-logo.svg b/site/src/assets/firebase-logo.svg new file mode 100644 index 000000000..c2313a7a7 --- /dev/null +++ b/site/src/assets/firebase-logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/site/src/auth/auth.11tydata.json b/site/src/auth/auth.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/auth/auth.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/auth/getting-started.md b/site/src/auth/getting-started.md new file mode 100644 index 000000000..cf3edae22 --- /dev/null +++ b/site/src/auth/getting-started.md @@ -0,0 +1,55 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Auth +--- + +## Using AngularFireAuth + +`AngularFireAuth.user` provides you an `Observable` to monitor your application's authentication State. + +`AngularFireAuth` promise proxies an initialized +`firebase.auth.Auth` instance, allowing you to log users in, out, etc. [See +the Firebase docs for more information on what methods are available.](https://firebase.google.com/docs/reference/js/firebase.auth.Auth) + +**Example app:** + +```ts +import { Component } from '@angular/core'; +import { AngularFireAuth } from '@angular/fire/auth'; +import firebase from 'firebase/app'; + +@Component({ + selector: 'app-root', + template: `{%raw%} +
+

Hello {{ user.displayName }}!

+ +
+ +

Please login.

+ + + {%endraw%}`, +}) +export class AppComponent { + constructor(public auth: AngularFireAuth) { + } + login() { + this.auth.signInWithPopup(new firebase.auth.GoogleAuthProvider()); + } + logout() { + this.auth.signOut(); + } +} +``` + +## UI Libraries + +- Material Design : [ngx-auth-firebaseui](https://github.com/AnthonyNahas/ngx-auth-firebaseui) +- Bootstrap : [@firebaseui/ng-bootstrap](https://github.com/firebaseui/ng-bootstrap) + +## Cordova + +Learn how to [setup Firebase Authentication with Cordova](https://firebase.google.com/docs/auth/web/cordova) in the Firebase Guides. diff --git a/site/src/auth/index.md b/site/src/auth/index.md new file mode 100644 index 000000000..9fc2864fe --- /dev/null +++ b/site/src/auth/index.md @@ -0,0 +1,5 @@ +--- +eleventyNavigation: + key: Auth + order: 3 +--- diff --git a/site/src/auth/route-guards.md b/site/src/auth/route-guards.md new file mode 100644 index 000000000..1c45b8b2a --- /dev/null +++ b/site/src/auth/route-guards.md @@ -0,0 +1,109 @@ +--- +title: Route guards +eleventyNavigation: + key: Route guards + parent: Auth +--- + +## Route users with AngularFire guards + +`AngularFireAuthGuard` provides a prebuilt [`canActivate` Router Guard](https://angular.io/api/router/CanActivate) using `AngularFireAuth`. By default unauthenticated users are not permitted to navigate to protected routes: + +```ts +import { AngularFireAuthGuard } from '@angular/fire/auth-guard'; + +export const routes: Routes = [ + { path: '', component: AppComponent }, + { path: 'items', component: ItemListComponent, canActivate: [AngularFireAuthGuard] }, +] +``` + +## Customizing the behavior + +To customize the behavior of `AngularFireAuthGuard`, you can pass an RXJS pipe through the route data's `authGuardPipe` key. + +The `auth-guard` module provides the following pre-built pipes: + +| Exported pipe | Functionality | +|-|-| +| `loggedIn` | The default pipe, rejects if the user is not authenticated. | +| `isNotAnonymous` | Rejects if the user is anonymous | +| `emailVerified` | Rejects if the user's email is not verified | +| `hasCustomClaim(claim)` | Rejects if the user does not have the specified claim | +| `redirectUnauthorizedTo(redirect)` | Redirect unauthenticated users to a different route | +| `redirectLoggedInTo(redirect)` | Redirect authenticated users to a different route | + +Example use: + +```ts +import { AngularFireAuthGuard, hasCustomClaim, redirectUnauthorizedTo, redirectLoggedInTo } from '@angular/fire/auth-guard'; + +const adminOnly = () => hasCustomClaim('admin'); +const redirectUnauthorizedToLogin = () => redirectUnauthorizedTo(['login']); +const redirectLoggedInToItems = () => redirectLoggedInTo(['items']); +const belongsToAccount = (next) => hasCustomClaim(`account-${next.params.id}`); + +export const routes: Routes = [ + { path: '', component: AppComponent }, + { path: 'login', component: LoginComponent, canActivate: [AngularFireAuthGuard], data: { authGuardPipe: redirectLoggedInToItems }}, + { path: 'items', component: ItemListComponent, canActivate: [AngularFireAuthGuard], data: { authGuardPipe: redirectUnauthorizedToLogin }}, + { path: 'admin', component: AdminComponent, canActivate: [AngularFireAuthGuard], data: { authGuardPipe: adminOnly }}, + { path: 'accounts/:id', component: AdminComponent, canActivate: [AngularFireAuthGuard], data: { authGuardPipe: belongsToAccount }} +]; +``` + +Use the provided `canActivate` helper and spread syntax to make your routes more readable: + +```ts +import { canActivate } from '@angular/fire/auth-guard'; + +export const routes: Routes = [ + { path: '', component: AppComponent }, + { path: 'login', component: LoginComponent, ...canActivate(redirectLoggedInToItems) }, + { path: 'items', component: ItemListComponent, ...canActivate(redirectUnauthorizedToLogin) }, + { path: 'admin', component: AdminComponent, ...canActivate(adminOnly) }, + { path: 'accounts/:id', component: AdminComponent, ...canActivate(belongsToAccount) } +]; +``` + +## Compose your own pipes + +`AngularFireAuthGuard` pipes are RXJS operators which transform an optional User to a boolean or Array (for redirects). You can easily build your own to customize behavior further: + +```ts +import { map } from 'rxjs/operators'; + +// This pipe redirects a user to their "profile edit" page or the "login page" if they're unauthenticated +// { path: 'profile', ...canActivate(redirectToProfileEditOrLogin) } +const redirectToProfileEditOrLogin = () => map(user => user ? ['profiles', user.uid, 'edit'] : ['login']); +``` + +The `auth-guard` modules provides a `customClaims` operator to reduce boiler plate when checking a user's claims: + +```ts +import { pipe } from 'rxjs'; +import { map } from 'rxjs/operators'; +import { customClaims } from '@angular/fire/auth-guard'; + +// This pipe will only allow users with the editor role to access the route +// { path: 'articles/:id/edit', component: ArticleEditComponent, ...canActivate(editorOnly) } +const editorOnly = () => pipe(customClaims, map(claims => claims.role === 'editor')); +``` + +## Using router state + +`AngularFireAuthGuard` will also accept `AuthPipeGenerator`s which generate `AuthPipe`s given the router state: + +```ts +import { pipe } from 'rxjs'; +import { map } from 'rxjs/operators'; +import { customClaims } from '@angular/fire/auth-guard'; + +// Only allow navigation to the route if :userId matches the authenticated user's uid +// { path: 'user/:userId/edit', component: ProfileEditComponent, ...canActivate(onlyAllowSelf) } +const onlyAllowSelf = (next) => map(user => !!user && next.params.userId === user.uid); + +// Only allow navigation to the route if the user has a custom claim matching :accountId +// { path: 'accounts/:accountId/billing', component: BillingDetailsComponent, ...canActivate(accountAdmin) } +const accountAdmin = (next) => pipe(customClaims, map(claims => claims[`account-${next.params.accountId}-role`] === 'admin')); +``` diff --git a/site/src/favicon.ico b/site/src/favicon.ico new file mode 100644 index 000000000..6c4d1e73c Binary files /dev/null and b/site/src/favicon.ico differ diff --git a/site/src/firestore/collections.md b/site/src/firestore/collections.md new file mode 100644 index 000000000..c993d77de --- /dev/null +++ b/site/src/firestore/collections.md @@ -0,0 +1,330 @@ +--- +title: Collections +eleventyNavigation: + key: Collections + parent: Firestore +--- + +## Documents in AngularFirestore + +Cloud Firestore is a NoSQL, document-oriented database. Unlike a SQL database, there are no tables or rows. Instead, you store data in *documents*, which are organized into *collections*. +Each *document* contains a set of key-value pairs. Cloud Firestore is optimized for storing large collections of small documents. + +## Using `AngularFirestoreCollection` + +The `AngularFirestoreCollection` service is a wrapper around the native Firestore SDK's [`CollectionReference`](https://firebase.google.com/docs/reference/js/v8/firebase.firestore.CollectionReference) and [`Query`](hhttps://firebase.google.com/docs/reference/js/v8/firebase.firestore.Query) types. It is a generic service that provides you with a strongly typed set of methods for manipulating and streaming data. This service is designed for use as an `@Injectable()`. + +```ts +import { Component } from '@angular/core'; +import { AngularFirestore, AngularFirestoreCollection } from '@angular/fire/firestore'; +import { Observable } from 'rxjs'; + +export interface Item { name: string; } + +@Component({ + selector: 'app-root', + template: ` +
    +
  • + {{ item.name }} +
    • +
+ ` +}) +export class AppComponent { + private itemsCollection: AngularFirestoreCollection; + items: Observable; + constructor(private afs: AngularFirestore) { + this.itemsCollection = afs.collection('items'); + this.items = this.itemsCollection.valueChanges(); + } + addItem(item: Item) { + this.itemsCollection.add(item); + } +} +``` + +The `AngularFirestoreCollection` is a service you use to create streams of the collection and perform data operations on the underyling collection. + +## The `DocumentChangeAction` type + +With the exception of the `valueChanges()`, each streaming method returns an Observable of `DocumentChangeAction[]`. + +A `DocumentChangeAction` gives you the `type` and `payload` properties. The `type` tells when what `DocumentChangeType` operation occured (`added`, `modified`, `removed`). The `payload` property is a `DocumentChange` which provides you important metadata about the change and a `doc` property which is the `DocumentSnapshot`. + +```ts +interface DocumentChangeAction { + //'added' | 'modified' | 'removed'; + type: DocumentChangeType; + payload: DocumentChange; +} + +interface DocumentChange { + type: DocumentChangeType; + doc: DocumentSnapshot; + oldIndex: number; + newIndex: number; +} + +interface DocumentSnapshot { + exists: boolean; + ref: DocumentReference; + id: string; + metadata: SnapshotMetadata; + data(): DocumentData; + get(fieldPath: string): any; +} +``` + +## Streaming collection data + +There are multiple ways of streaming collection data from Firestore. + +## `valueChanges({ idField?: string })` + +*What is it?* - The current state of your collection. Returns an Observable of data as a synchronized array of JSON objects. All Snapshot metadata is stripped and just the document data is included. Optionally, you can pass an options object with an `idField` key containing a string. If provided, the returned JSON objects will include their document ID mapped to a property with the name provided by `idField`. + +*Why would you use it?* - When you just need a list of data. No document metadata is attached to the resulting array which makes it simple to render to a view. + +*When would you not use it?* - When you need a more complex data structure than an array. + +*Best practices* - Use this method to display data on a page. It's simple but effective. Use `.snapshotChanges()` once your needs become more complex. + +#### Example of persisting a Document Id + +```ts +import { Component } from '@angular/core'; +import { AngularFirestore, AngularFirestoreCollection } from '@angular/fire/firestore'; +import { Observable } from 'rxjs'; + +export interface Item { id: string; name: string; } + +@Component({ + selector: 'app-root', + template: `{%raw%} +
    +
  • + {{ item.name }} +
    • +
+ {%endraw%}` +}) +export class AppComponent { + private itemsCollection: AngularFirestoreCollection; + items: Observable; + constructor(private readonly afs: AngularFirestore) { + this.itemsCollection = afs.collection('items'); + this.items = this.itemsCollection.valueChanges({ idField: 'customID' }); + } + addItem(name: string) { + // Persist a document id + const id = this.afs.createId(); + const item: Item = { id, name }; + this.itemsCollection.doc(id).set(item); + } +} +``` + +### `snapshotChanges()` + +*What is it?* - The current state of your collection. Returns an Observable of data as a synchronized array of `DocumentChangeAction[]`. + +*Why would you use it?* - When you need a list of data but also want to keep around metadata. Metadata provides you the underyling `DocumentReference`, document id, and array index of the single document. Having the document's id around makes it easier to use data manipulation methods. This method gives you more horsepower with other Angular integrations such as ngrx, forms, and animations due to the `type` property. The `type` property on each `DocumentChangeAction` is useful for ngrx reducers, form states, and animation states. + +*When would you not use it?* - When you need a more complex data structure than an array or if you need to process changes as they occur. This array is synchronized with the remote and local changes in Firestore. + +*Best practices* - Use an observable operator to transform your data from `.snapshotChanges()`. Don't return the `DocumentChangeAction[]` to the template. See the example below. + +#### Example + +```ts +import { Component } from '@angular/core'; +import { AngularFirestore, AngularFirestoreCollection } from '@angular/fire/firestore'; +import { Observable } from 'rxjs'; +import { map } from 'rxjs/operators'; + +export interface Shirt { name: string; price: number; } +export interface ShirtId extends Shirt { id: string; } + +@Component({ + selector: 'app-root', + template: `{%raw%} +
    +
  • + {{ shirt.name }} is {{ shirt.price }} +
    • +
+ {%endraw%}` +}) +export class AppComponent { + private shirtCollection: AngularFirestoreCollection; + shirts: Observable; + constructor(private readonly afs: AngularFirestore) { + this.shirtCollection = afs.collection('shirts'); + // .snapshotChanges() returns a DocumentChangeAction[], which contains + // a lot of information about "what happened" with each change. If you want to + // get the data and the id use the map operator. + this.shirts = this.shirtCollection.snapshotChanges().pipe( + map(actions => actions.map(a => { + const data = a.payload.doc.data() as Shirt; + const id = a.payload.doc.id; + return { id, ...data }; + })) + ); + } +} +``` + +### `stateChanges()` + +*What is it?* - Returns an Observable of the most recent changes as a `DocumentChangeAction[]`. + +*Why would you use it?* - The above methods return a synchronized array sorted in query order. `stateChanges()` emits changes as they occur rather than syncing the query order. This works well for ngrx integrations as you can build your own data structure in your reducer methods. + +*When would you not use it?* - When you just need a list of data. This is a more advanced usage of AngularFirestore. + +#### Example + +```ts +import { Component } from '@angular/core'; +import { AngularFirestore, AngularFirestoreCollection } from '@angular/fire/firestore'; +import { Observable } from 'rxjs'; +import { map } from 'rxjs/operators'; + +export interface AccountDeposit { description: string; amount: number; } +export interface AccountDepositId extends AccountDeposit { id: string; } + +@Component({ + selector: 'app-root', + template: `{%raw%} +
    +
  • + {{ deposit.description }} for {{ deposit.amount }} +
    • +
+ {%endraw%}` +}) +export class AppComponent { + private depositCollection: AngularFirestoreCollection; + deposits: Observable; + constructor(private readonly afs: AngularFirestore) { + this.depositCollection = afs.collection('deposits'); + this.deposits = this.depositCollection.stateChanges(['added']).pipe( + map(actions => actions.map(a => { + const data = a.payload.doc.data() as AccountDeposit; + const id = a.payload.doc.id; + return { id, ...data }; + })) + ); + } +} +``` + +### `auditTrail()` + +*What is it?* - Returns an Observable of `DocumentChangeAction[]` as they occur. Similar to `stateChanges()`, but instead it keeps around the trail of events as an array. + +*Why would you use it?* - This method is like `stateChanges()` except it is not ephemeral. It collects each change in an array as they occur. This is useful for ngrx integrations where you need to replay the entire state of an application. This also works as a great debugging tool for all applications. You can simply write `afs.collection('items').auditTrail().subscribe(console.log)` and check the events in the console as they occur. + +*When would you not use it?* - When you just need a list of data. This is a more advanced usage of AngularFirestore. + +#### Example + +```ts +import { Component } from '@angular/core'; +import { AngularFirestore, AngularFirestoreCollection } from '@angular/fire/firestore'; +import { Observable } from 'rxjs'; +import { map } from 'rxjs/operators'; + +export interface AccountLogItem { description: string; amount: number; } +export interface AccountLogItemId extends AccountLogItem { id: string; } + +@Component({ + selector: 'app-root', + template: `{%raw%} +
    +
  • + {{ log.description }} for {{ log.amount }} +
    • +
+ {%endraw%}` +}) +export class AppComponent { + private accountLogCollection: AngularFirestoreCollection; + accountLogs: Observable; + constructor(private readonly afs: AngularFirestore) { + this.accountLogCollection = afs.collection('accountLog'); + this.accountLogs = this.accountLogCollection.auditTrail().pipe( + map(actions => actions.map(a => { + const data = a.payload.doc.data() as AccountLogItem; + const id = a.payload.doc.id; + return { id, ...data }; + })) + ); + } +} +``` + +### Limiting events + +There are three `DocumentChangeType`s in Firestore: `added`, `removed`, and `modified`. Each streaming method listens to all three by default. However, you may only be intrested in one of these events. You can specify which events you'd like to use through the first parameter of each method: + +#### Basic example + +```ts +constructor(private afs: AngularFirestore): { + this.itemsCollection = afs.collection('items'); + this.items = this.itemsCollection.snapshotChanges(['added', 'removed']); +} +``` + +#### Component example + +```ts +import { Component } from '@angular/core'; +import { AngularFirestore, AngularFirestoreCollection } from '@angular/fire/firestore'; +import { Observable } from 'rxjs'; + +@Component({ + selector: 'app-root', + template: `{%raw%} +
    +
  • + {{ item.name }} +
    • +
+ {%endraw%}` +}) +export class AppComponent { + private itemsCollection: AngularFirestoreCollection; + items: Observable; + constructor(private afs: AngularFirestore) { + this.itemsCollection = afs.collection('items'); + this.items = this.itemsCollection.valueChanges(['added', 'removed']); + } +} +``` + +## State based vs. action based + +Each one of these methods falls into two categories: state based and action based. State based methods return the state of your collection "as-is". Whereas action based methods return "what happened" in your collection. + +For example, a user updates the third item in a list. In a state based method like `.valueChanges()` will update the third item in the collection and return an array of JSON data. This is how your state looks. + +## Adding documents to a collection + +To add a new document to a collection with a generated id use the `add()` method. This method uses the type provided by the generic class to validate it's type structure. + +#### Basic example + +```ts +constructor(private afs: AngularFirestore): { + const shirtsCollection = afs.collection('tshirts'); + shirtsCollection.add({ name: 'item', price: 10 }); +} +``` + +## Manipulating individual documents + +To retrieve, update, or delete an individual document you can use the `doc()` method. This method returns an `AngularFirestoreDocument`, which provides methods for streaming, updating, and deleting. [See Using Documents with AngularFirestore for more information on how to use documents](/firestore/documents). + diff --git a/site/src/firestore/documents.md b/site/src/firestore/documents.md new file mode 100644 index 000000000..6639b3eeb --- /dev/null +++ b/site/src/firestore/documents.md @@ -0,0 +1,120 @@ +--- +title: Documents +eleventyNavigation: + key: Documents + parent: Firestore +--- + +## Documents in AngularFirestore + +Cloud Firestore is a NoSQL, document-oriented database. Unlike a SQL database, there are no tables or rows. Instead, you store data in *documents*, which are organized into *collections*. +Each *document* contains a set of key-value pairs. Cloud Firestore is optimized for storing large collections of small documents. + +## Using `AngularFirestoreDocument` + +The `AngularFirestoreDocument` service is a wrapper around the native Firestore SDK's [`DocumentReference` type](https://firebase.google.com/docs/reference/js/firebase.firestore.DocumentReference). It is a generic service that provides you with a strongly typed set of methods for manipulating and streaming data. This service is designed for use as an `@Injectable()`. + + + +```ts +import { Component } from '@angular/core'; +import { AngularFirestore, AngularFirestoreDocument } from '@angular/fire/firestore'; +import { Observable } from 'rxjs'; + +export interface Item { name: string; } + +@Component({ + selector: 'app-root', + template: `{% raw %} +
+ {{ (item | async)?.name }} +
+ {% endraw %}` +}) +export class AppComponent { + private itemDoc: AngularFirestoreDocument; + item: Observable; + constructor(private afs: AngularFirestore) { + this.itemDoc = afs.doc('items/1'); + this.item = this.itemDoc.valueChanges(); + } + update(item: Item) { + this.itemDoc.update(item); + } +} +``` + +## The `DocumentChangeAction` type + +With the exception of the `valueChanges()`, each streaming method returns an Observable of `DocumentChangeAction[]`. + +A `DocumentChangeAction` gives you the `type` and `payload` properties. The `type` tells when what `DocumentChangeType` operation occured (`added`, `modified`, `removed`). The `payload` property is a `DocumentChange` which provides you important metadata about the change and a `doc` property which is the `DocumentSnapshot`. + +```ts +interface DocumentChangeAction { + //'added' | 'modified' | 'removed'; + type: DocumentChangeType; + payload: DocumentChange; +} + +interface DocumentChange { + type: DocumentChangeType; + doc: DocumentSnapshot; + oldIndex: number; + newIndex: number; +} + +interface DocumentSnapshot { + exists: boolean; + ref: DocumentReference; + id: string; + metadata: SnapshotMetadata; + data(): DocumentData; + get(fieldPath: string): any; +} +``` + +## Streaming document data + +There are multiple ways of streaming collection data from Firestore. + +## `valueChanges({ idField?: string })` + +*What is it?* - Returns an Observable of document data. All Snapshot metadata is stripped. This method provides only the data. Optionally, you can pass an options object with an `idField` key containing a string. If provided, the returned object will include its document ID mapped to a property with the name provided by `idField`. + +*Why would you use it?* - When you just need the object data. No document metadata is attached which makes it simple to render to a view. + +*When would you not use it?* - When you need document metadata. + +## `snapshotChanges()` + +*What is it?* - Returns an Observable of data as a `DocumentChangeAction`. + +*Why would you use it?* - When you need the document data but also want to keep around metadata. This metadata provides you the underyling `DocumentReference` and document id. Having the document's id around makes it easier to use data manipulation methods. This method gives you more horsepower with other Angular integrations such as ngrx, forms, and animations due to the `type` property. The `type` property on each `DocumentChangeAction` is useful for ngrx reducers, form states, and animation states. + +*When would you not use it?* - When you simply need to render data to a view and don't want to do any extra processing. + +## Manipulating documents + +AngularFirestore provides methods for setting, updating, and deleting document data. + +- `set(data: T)` - Destructively updates a document's data. +- `update(data: T)` - Non-destructively updates a document's data. +- `delete()` - Deletes an entire document. Does not delete any nested collections. + +## Querying? + +Querying has no effect on documents. Documents are a single object and querying effects a range of multiple documents. If you are looking for querying then you want to use a collection. + +## Retrieving nested collections + +Nesting collections is a great way to structure your data. This allows you to group related data structures together. If you are creating a "Task List" site, you can group "tasks" under a user: `user//tasks`. + +To retrieve a nested collection use the `collection(path: string)` method. + +```ts +constructor(private afs: AngularFirestore) { + this.userDoc = afs.doc('user/david'); + this.tasks = this.userDoc.collection('tasks').valueChanges(); +} +``` diff --git a/site/src/firestore/firestore.11tydata.json b/site/src/firestore/firestore.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/firestore/firestore.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/firestore/index.md b/site/src/firestore/index.md new file mode 100644 index 000000000..647cfb988 --- /dev/null +++ b/site/src/firestore/index.md @@ -0,0 +1,5 @@ +--- +eleventyNavigation: + key: Firestore + order: 2 +--- \ No newline at end of file diff --git a/site/src/functions/functions.11tydata.json b/site/src/functions/functions.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/functions/functions.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/functions/getting-started.md b/site/src/functions/getting-started.md new file mode 100644 index 000000000..2ddf6f632 --- /dev/null +++ b/site/src/functions/getting-started.md @@ -0,0 +1,170 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Functions +--- + +## Using AngularFireFunctions + +The Cloud Functions for Firebase client SDKs let you call functions directly from a Firebase app. To call a function from your app in this way, write and deploy an HTTPS Callable function in Cloud Functions, and then add client logic to call the function from your app. + +## Import the `NgModule` + +Cloud Functions for AngularFire is contained in the `@angular/fire/functions` module namespace. Import the `AngularFireFunctionsModule` in your `NgModule`. This sets up the `AngularFireFunction` service for dependency injection. + +```ts +import { BrowserModule } from '@angular/platform-browser'; +import { NgModule } from '@angular/core'; +import { AppComponent } from './app.component'; +import { AngularFireModule } from '@angular/fire'; +import { AngularFireFunctionsModule } from '@angular/fire/functions'; +import { environment } from '../environments/environment'; + +@NgModule({ + imports: [ + BrowserModule, + AngularFireModule.initializeApp(environment.firebase), + AngularFireFunctionsModule + ], + declarations: [ AppComponent ], + bootstrap: [ AppComponent ] +}) +export class AppModule {} +``` + +## Injecting the `AngularFireFunctions` service + +Once the `AngularFireFunctionsModule` is registered you can inject the `AngularFireFunctions` service. + +```ts +import { Component } from '@angular/core'; +import { AngularFireFunctions } from '@angular/fire/functions'; + +@Component({ + selector: 'app-component', + template: `` +}) +export class AppComponent { + constructor(private fns: AngularFireFunctions) { } +} +``` + +## Creating a callable function + +AngularFireFunctions is super easy. You create a function on the server side and then "call" it by its name with the client library. + +| method | | +| ---------|--------------------| +| `httpCallable(name: string): (data: T) ` | Creates a callable function based on a function name. Returns a function that can create the observable of the http call. | +```ts + +import { Component } from '@angular/core'; +import { AngularFireFunctions } from '@angular/fire/functions'; + +@Component({ + selector: 'app-root', + template: `{ data$ | async }` +}) +export class AppComponent { + constructor(private fns: AngularFireFunctions) { + const callable = fns.httpsCallable('my-fn-name'); + this.data$ = callable({ name: 'some-data' }); + } +} +``` + +Notice that calling `httpsCallable()` does not initiate the request. It creates a function, which when called creates an Observable, subscribe or convert it to a Promise to initiate the request. + +## Configuration via Dependency Injection + +### Functions Region + +Allow configuration of the Function's region by adding `REGION` to the `providers` section of your `NgModule`. The default is `us-central1`. + +```ts +import { NgModule } from '@angular/core'; +import { AngularFireFunctionsModule, REGION } from '@angular/fire/functions'; + +@NgModule({ + imports: [ + ... + AngularFireFunctionsModule, + ... + ], + ... + providers: [ + { provide: REGION, useValue: 'asia-northeast1' } + ] +}) +export class AppModule {} + +``` + +### Cloud Functions emulator + +Point callable Functions to the Cloud Function emulator by adding `USE_EMULATOR` to the `providers` section of your `NgModule`. + +```ts +import { NgModule } from '@angular/core'; +import { AngularFireFunctionsModule, USE_EMULATOR } from '@angular/fire/functions'; + +@NgModule({ + imports: [ + ... + AngularFireFunctionsModule, + ... + ], + ... + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', 5001] } + ] +}) +export class AppModule {} + +``` + +[Learn more about integration with the Firebase Emulator suite on our dedicated guide here](../emulators/emulators.md). + +## Firebase Hosting integration + +If you serve your app using [Firebase Hosting](https://firebase.google.com/docs/hosting/), you can configure Functions to be served from the same domain as your app. This will avoid an extra round-trip per function call due to [CORS preflight request](https://developer.mozilla.org/en-US/docs/Glossary/Preflight_request). This only applies to sites hosted via firebase on `us-central1`. + +To set this up, you first need to update your `hosting` section in `firebase.json` and add one `rewrite` rule per function: + +```json + "hosting": { + "rewrites": [ + { + "source": "/someFunction", + "function": "someFunction" + }, + { + "source": "/anotherFunction", + "function": "anotherFunction" + }, + ... + ] + } +``` + +Deploy your hosting project to the new settings go into effect, finally configure functions origin to point at your app domain: + +```ts +import { NgModule } from '@angular/core'; +import { AngularFireFunctionsModule, ORIGIN, NEW_ORIGIN_BEHAVIOR } from '@angular/fire/functions'; + +@NgModule({ + imports: [ + ... + AngularFireFunctionsModule, + ... + ], + ... + providers: [ + { provide: NEW_ORIGIN_BEHAVIOR, useValue: true }, + { provide: ORIGIN, useValue: 'https://project-name.web.app/' } + ] +}) +export class AppModule {} +``` diff --git a/site/src/functions/index.md b/site/src/functions/index.md new file mode 100644 index 000000000..0cc6ccdac --- /dev/null +++ b/site/src/functions/index.md @@ -0,0 +1,5 @@ +--- +eleventyNavigation: + key: Functions + order: 7 +--- diff --git a/site/src/get-started/deploying.md b/site/src/get-started/deploying.md new file mode 100644 index 000000000..b0e9011b4 --- /dev/null +++ b/site/src/get-started/deploying.md @@ -0,0 +1,150 @@ +--- +title: Deploying +eleventyNavigation: + key: Deploying + parent: Get started +--- + +## Static or Server-side rendered + +In this guide, we'll look at how to use `@angular/fire` to automatically deploy an Angular application to Firebase Hosting or Cloud Functions by using the Angular CLI. + +`@angular/fire` uses Firebase functions to deploy your Angular Universal projects, with server-side rendering enabled. + +**Angular Universal deployments work with `@nguniversal/*` version 9.0.0 and above**. + +## Add `@angular/fire` to your project + +First, you need to add the `@angular/fire` package to your project. In your Angular CLI project run: + +```shell +ng add @angular/fire +``` + +*Note that the command above assumes you have global Angular CLI installed. To install Angular CLI globally run `npm i -g @angular/cli`.* + +First, the command above will check if you have an Angular universal project. It'll do so by looking at your `angular.json` project, looking for a `server` target for the specified project. If it finds one, it'll ask you if you want to deploy the project in a firebase function. + +After that it will trigger the `@angular/fire` `ng-add` schematics. The schematics will open a web browser and guide you through the Firebase authentication flow (if you're not signed in already). After you authenticate, you'll see a prompt to select a Firebase hosting project. + +The schematics will do the following: + +1. Add `@angular/fire` to your list of dependencies +2. Create `firebase.json`, `.firebaserc` files in the root of your workspace. You can use them to configure your firebase hosting deployment. Find more about them [here](https://firebase.google.com/docs/hosting/full-config) +3. Update your workspace file (`angular.json`) by inserting the `deploy` builder + +In the end, your `angular.json` project will look like below: + +```json5 +{ + "$schema": "./node_modules/@angular/cli/lib/config/schema.json", + "version": 1, + "newProjectRoot": "projects", + "projects": { + "sample-app": { + // ... + "deploy": { + "builder": "@angular/fire:deploy", + "options": {} // Here you may find an "ssr": true option if you've + // selected that you want to deploy your Angular universal project + // as a firebase function. + } + } + }, + // ... + "defaultProject": "sample-app" + +} +``` + +If you want to add deployment capabilities to a different project in your workspace, you can run: + +```bash +ng add @angular/fire --project=[PROJECT_NAME] +``` + +## Deploying the project + +As the second step, to deploy your project run: + +```bash +ng deploy --project=[PROJECT_NAME] +``` + +*The `--project` option is optional. Learn more [here](https://angular.io/cli/deploy).* + +The command above will trigger: + +1. Production build of your application +2. Deployment of the produced assets to the firebase hosting project you selected during `ng add` + +If you've specified that you want a server-side rendering enabled deployment in a firebase function, the command will also: + +1. Create a firebase function in `dist`, which directly consumes `main.js` from your server output directory. +2. Create `package.json` for the firebase function with the required dependencies. +3. Deploy the static assets to firebase hosting and your universal server as a Firebase function. + +If you want to preview your Angular Universal project before we deploy it as a Firebase Function you can run: + +``` +ng deploy --preview +``` + +We'll create the function and a `package.json` in your project output directory. This way, you can later run `firebase serve` in your project root so you can test everything before deploying. + +## Customization + +To customize the deployment flow, you can use the configuration files you're already familiar with from `firebase-tools`. You can find more in the [firebase documentation](https://firebase.google.com/docs/hosting/full-config). + +### Configuring Cloud Functions + +Setting `functionsNodeVersion` and `functionsRuntimeOptions` in your `angular.json` allow you to custimze the version of Node.js Cloud Functions is running and run-time settings like timeout, VPC connectors, and memory. + +```json +"deploy": { + "builder": "@angular/fire:deploy", + "options": { + "functionsNodeVersion": 12, + "functionsRuntimeOptions": { + "memory": "2GB", + "timeoutSeconds": 10, + "vpcConnector": "my-vpc-connector", + "vpcConnectorEgressSettings": "PRIVATE_RANGES_ONLY" + } + } +} +``` + +### Working with multiple Firebase Projects + +If you have multiple build targets and deploy targets, it is possible to specify them in your `angular.json` or `workspace.json`. + +It is possible to use either your project name or project alias in `firebaseProject`. The setting provided here is equivalent to passing a project name or alias to `firebase deploy --project projectNameOrAlias`. + +The `buildTarget` simply points to an existing build configuration for your project. Most projects have a default configuration and a production configuration (commonly activated by using the `--prod` flag) but it is possible to specify as many build configurations as needed. + +You may specify a `buildTarget` and `firebaseProject` in your `options` as follows: + +```json +"deploy": { + "builder": "@angular/fire:deploy", + "options": { + "buildTarget": "projectName:build", + "firebaseProject": "developmentProject" + }, + "configurations": { + "production": { + "buildTarget": "projectName:build:production", + "firebaseProject": "productionProject" + } + } +} +``` + +The above configuration specifies the following: + +1. `ng deploy` will deploy the default project with default configuration. +2. `ng deploy projectName` will deploy the specified project with default configuration. +3. `ng deploy projectName --prod` or `ng deploy projectName --configuration='production'` will deploy `projectName` with production build settings to your production environment. + +All of the options are optional. If you do not specify a `buildTarget`, it defaults to a production build (`projectName:build:production`). If you do not specify a `firebaseProject`, it defaults to the first matching deploy target found in your `.firebaserc` (where your projectName is the same as your Firebase deploy target name). The `configurations` section is also optional. diff --git a/site/src/get-started/get-started.11tydata.json b/site/src/get-started/get-started.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/get-started/get-started.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/get-started/index.md b/site/src/get-started/index.md new file mode 100644 index 000000000..0485183af --- /dev/null +++ b/site/src/get-started/index.md @@ -0,0 +1,5 @@ +--- +eleventyNavigation: + key: Get started + order: 1 +--- diff --git a/site/src/get-started/local-development.md b/site/src/get-started/local-development.md new file mode 100644 index 000000000..b9d986a81 --- /dev/null +++ b/site/src/get-started/local-development.md @@ -0,0 +1,135 @@ +--- +title: Local development +eleventyNavigation: + key: Local development + parent: Get started +--- + +## Connect to the Firebase Emulator Suite + +In this guide, we'll look at how to use `@angular/fire` to connect an Angular application with the Firebase Emulator Suite to start prototyping your apps. + +There are four supported emulators, all of them available at the Firebase suite workflow: + +- [Authentication Emulator](https://firebase.google.com/docs/emulator-suite/connect_auth) +- [Realtime Database Emulator](https://firebase.google.com/docs/emulator-suite/connect_rtdb) +- [Cloud Firestore Emulator](https://firebase.google.com/docs/emulator-suite/connect_firestore) +- [Cloud Functions Emulator](https://firebase.google.com/docs/emulator-suite/connect_functions) + +*The Auth Emulator only works with Firebase v8 and above, which is supported by `@angular/fire` 6.1.0 or higher*. + +Before configuring these emulators at the Angular App, be sure to install the ones you need by following the [Install, configure and integrate Local Emulator Suite](https://firebase.google.com/docs/emulator-suite/install_and_configure) documentation. + +Initialize firebase to your project: + +```shell +firebase init +``` + +Then launch the emulator setup wizard: + +```shell +firebase init emulators +``` + +Follow the instructions to download whatever emulator you want to use then checkout that the `firebase.json` file got updated with the default ports per emulator, something like this: + +```json +{ + // Existing firebase configuration ... + // Optional emulator configuration. Default + // values are used if absent. + "emulators": { + "firestore": { + "port": "8080" + }, + "ui": { + "enabled": true, // Default is `true` + "port": 4000 // If unspecified, see CLI log for selected port + }, + "auth": { + "port": "9099" + }, + "functions": { + "port": "5001" + }, + "database": { + "port": "9000" + }, + "pubsub": { + "port": "8085" + } + } +} +``` + +## Import the DI Tokens at your AppModule + +Configuring your app to connect to local emulators is easily done by using dependency injection tokens provided by the library. However, there are slighty changes between 6.0.0 and 6.1.0 in the way it was done. + +Each module (database, firestore, auth, function) provides `USE_EMULATOR` token to configure the emulator `host` and `port` by passing a tuple of `[string, number]` values, which are set by default to `localhost` and the asigned port from your `firebase.json` file. + +Import these tokens at your `app.module.ts` as follow: + +```ts +import { USE_EMULATOR as USE_AUTH_EMULATOR } from '@angular/fire/auth'; +import { USE_EMULATOR as USE_DATABASE_EMULATOR } from '@angular/fire/database'; +import { USE_EMULATOR as USE_FIRESTORE_EMULATOR } from '@angular/fire/firestore'; +import { USE_EMULATOR as USE_FUNCTIONS_EMULATOR } from '@angular/fire/functions'; + +@NgModule({ + // ... Existing configuration + providers: [ + // ... Existing Providers + { provide: USE_AUTH_EMULATOR, useValue: environment.useEmulators ? ['localhost', 9099] : undefined }, + { provide: USE_DATABASE_EMULATOR, useValue: environment.useEmulators ? ['localhost', 9000] : undefined }, + { provide: USE_FIRESTORE_EMULATOR, useValue: environment.useEmulators ? ['localhost', 8080] : undefined }, + { provide: USE_FUNCTIONS_EMULATOR, useValue: environment.useEmulators ? ['localhost', 5001] : undefined }, + ] +}) +export class AppModule { } +``` + +The environment `useEmulators` flag is used to control whenever the app should connect to the emulators, which is usually done in non-production environments. + +Also you can opt-in the new way of setting the Cloud Functions [origin](https://firebase.google.com/docs/functions/locations) in Firebase v8 by using the `NEW_ORIGIN_BEHAVIOR` token in conjuction with the already present `ORIGIN` token. + +```ts +import { isDevMode, NgModule } from '@angular/core'; +import { ORIGIN as FUNCTIONS_ORIGIN, NEW_ORIGIN_BEHAVIOR } from '@angular/fire/functions'; + +@NgModule({ + // ... Existing configuration + providers: [ + // ... Existing Providers + { provide: NEW_ORIGIN_BEHAVIOR, useValue: true }, + { provide: FUNCTIONS_ORIGIN, useFactory: () => isDevMode() ? undefined : location.origin }, + ] +}) +export class AppModule { } +``` + +## Older method (6.0.0) + +With the exception of the Auth Emulator, the old way of setting the `host` and `port` for each emulator was done using a different set of tokens by passing the entire url path as string. + +```ts +import { URL as DATABASE_URL } from '@angular/fire/database'; +import { ORIGIN as FUNCTIONS_ORIGIN } from '@angular/fire/functions'; +import { SETTINGS as FIRESTORE_SETTINGS } from '@angular/fire/firestore'; + +@NgModule({ + // ... Existing configuration + providers: [ + { + provide: DATABASE_URL, + useValue: environment.useEmulators ? `http://localhost:9000?ns=${environment.firebase.projectId}` : undefined + }, + { provide: FIRESTORE_SETTINGS, useValue: environment.useEmulators ? { host: 'localhost:8080', ssl: false } : {} }, + { provide: FUNCTIONS_ORIGIN, useFactory: environment.useEmulators ? 'http://localhost:5001/' : undefined }, + ] +}) +export class AppModule { } +``` + +For older versions, please upgrade your app to latest version to get the advantages of these new features :rocket: diff --git a/site/src/get-started/quick-start.md b/site/src/get-started/quick-start.md new file mode 100644 index 000000000..9fd8a19a6 --- /dev/null +++ b/site/src/get-started/quick-start.md @@ -0,0 +1,212 @@ +--- +title: Quick start +eleventyNavigation: + key: Quick start + parent: Get started +--- + +## Create a new project + +```bash +npm install -g @angular/cli +ng new +cd +``` + +The Angular CLI's `new` command will set up the latest Angular build in a new project structure. + +## Install AngularFire and Firebase + +```bash +ng add @angular/fire +``` + +Now that you have a new project setup, install AngularFire and Firebase from npm. + +## Add Firebase config to environments variable + +Open `/src/environments/environment.ts`, create it if it doesn't exist, and add your Firebase configuration. You can find your project configuration in [the Firebase Console](https://console.firebase.google.com). Click the Gear icon next to Project Overview, in the Your Apps section, create a new app and choose the type Web. Give the app a name and copy the config values provided. + +```ts +export const environment = { + production: false, + firebase: { + apiKey: '', + authDomain: '', + databaseURL: '', + projectId: '', + storageBucket: '', + messagingSenderId: '', + appId: '', + measurementId: '' + } +}; +``` + +## Configuring Firebase in your Angular Application + +### Set up Firebase for `@NgModule` based apps +For applications bootstrapped using `@NgModule`, add the Firebase providers to the imports array of the `@NgModule` decorator metadata. + +In `/src/app/app.module.ts` update the code to:. + +```ts +import { BrowserModule } from '@angular/platform-browser'; +import { NgModule } from '@angular/core'; +import { AppComponent } from './app.component'; +import { initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { environment } from '../environments/environment'; + +@NgModule({ + imports: [ + BrowserModule, + provideFirebaseApp(() => initializeApp(environment.firebase)), + ], + declarations: [ AppComponent ], + bootstrap: [ AppComponent ] +}) +export class AppModule {} +``` +### Set up Firebase for Standalone API based apps +Beginning in [Angular v14](https://blog.angular.io/angular-v14-is-now-available-391a6db736af) applications can be built and bootstrapped using the set of [Standalone APIs](https://angular.io/guide/standalone-components). + +The provider configuration for these applications should be added to the `bootstrapApplication` function in `main.ts`: + +```ts +import { initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { getAuth, provideAuth } from '@angular/fire/auth'; +import { bootstrapApplication } from '@angular/platform-browser'; +import { AppComponent } from './app/app.component'; +import { environment } from './environments/environment'; + + +bootstrapApplication(AppComponent, { + providers: [ + provideFirebaseApp(()=> initializeApp(environment.firebase)) + ], +}).catch(err => console.error(err)); +``` + +### Configuring Firebase features + +After adding the Firbase app providers, you also need to add providers for the each of Firebase features your application needs. + +For example if your application uses both Google Analytics and the Firestore database you would add `provideAnalytics` and `provideFirestore`: + +```ts +// Module based configuration app.module.ts + +import { BrowserModule } from '@angular/platform-browser'; +import { NgModule } from '@angular/core'; +import { AppComponent } from './app.component'; +import { initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { provideAnalytics, getAnalytics } from '@angular/fire/analytics'; +import { provideFirestore, getFirestore } from '@angular/fire/firestore'; +import { environment } from '../environments/environment'; + +@NgModule({ + imports: [ + BrowserModule, + provideFirebaseApp(() => initializeApp(environment.firebase)), + provideAnalytics(()=> getAnalytics()), + provideFirestore(() => getFirestore()), + AngularFireAnalyticsModule, + AngularFirestoreModule + ], + declarations: [ AppComponent ], + bootstrap: [ AppComponent ] +}) +export class AppModule {} +``` + +```ts +// Standalone API based config (main.ts) +import { initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { provideFirestore, getFirestore } from '@angular/fire/firestore' +import { getAuth, provideAuth } from '@angular/fire/auth'; +import { bootstrapApplication } from '@angular/platform-browser'; +import { AppComponent } from './app/app.component'; +import { environment } from './environments/environment'; + + +bootstrapApplication(AppComponent, { + providers: [ + provideFirebaseApp(() => initializeApp(environment.firebase)), + provideAuth(() => getAuth()), + provideFirestore(() => getFirestore()) + ], +}).catch(err => console.error(err)); +``` +## Inject `AngularFirestore` + +Open `/src/app/app.component.ts`, and make sure to modify/delete any tests to get the sample working (tests are still important, you know): + +```ts +import { Component, inject } from '@angular/core'; +import { Firestore } from '@angular/fire/firestore'; + +@Component({ + selector: 'app-root', + templateUrl: 'app.component.html', + styleUrls: ['app.component.css'] +}) +export class AppComponent { + private firestore: AngularFirestore = inject(Firestore) + ... +} +``` + +## Bind a Firestore collection to a list + +In `/src/app/app.component.ts`: + +```ts +import { Component } from '@angular/core'; +import { Firestore, collection } from '@angular/fire/firestore'; +import { Observable } from 'rxjs'; + +@Component({ + selector: 'app-root', + templateUrl: 'app.component.html', + styleUrls: ['app.component.css'] +}) +export class AppComponent { + private firestore: Firestore = inject(Firestore); + items$: Observable; + + constructor() { + const itemsCollectionRef = collection(this.firestore, 'items'); + this.items = collectionData(itemsCollectionRef) as Observable; + } +} +``` + +Open `/src/app/app.component.html`: + +```html +
    +
  • + {{item.name}} +
    • +
+``` + +## Run your app locally + +```bash +ng serve +``` + +Your Angular app will compile and serve locally, visit it we should see an empty list. + +In another tab [start adding data to an `items` collection in Firestore](https://firebase.google.com/docs/firestore/manage-data/add-data). *As we're not authenticating users yet, be sure to start Firestore in **test mode** or allow reading from the `items` collection in Security Rules (`allow read: if true`).* + +Once you've created a `items` collection and are inserting documents, you should see data streaming into your Angular application. + +## Deploy your app + +Finally, we can deploy the application to Firebase hosting: + +```bash +ng deploy +``` \ No newline at end of file diff --git a/site/src/index.md b/site/src/index.md new file mode 100644 index 000000000..f75605062 --- /dev/null +++ b/site/src/index.md @@ -0,0 +1,50 @@ +--- +layout: default.njk +--- + +{% headingone %}AngularFire{% endheadingone %} + +{% subheading %}The official library for Angular and Firebase{% endsubheading %} + +
+
+ {%- linkbutton "/get-started/quick-start" %} + Get started + {%- endlinkbutton %} +
+
+ {%- linkbutton "https://github.com/angular/fire", "secondary", true %} + GitHub + {%- endlinkbutton %} +
+
+ +{% disclaimerprod %} + +## What is AngularFire? + +AngularFire smooths over the rough edges an Angular developer might encounter when implementing the framework-agnostic Firebase JS SDK & aims to provide a more natural developer experience by conforming to Angular conventions. + +### Dependency injection +Provide and Inject Firebase services in your components + +### Zone.js wrappers +Stable zones allow proper functionality of service workers, forms, SSR, and pre-rendering + +### Observable based +Utilize RxJS rather than callbacks for realtime streams + +### NgRx friendly API +Integrate with NgRx using AngularFire's action based APIs. + +### Lazy-loading +AngularFire dynamically imports much of Firebase, reducing time to load your app + +### Deploy schematics +Get your Angular application deployed on Firebase Hosting with a single command + +### Google Analytics +Zero-effort Angular Router awareness in Google Analytics + +### Router Guards +Guard your Angular routes with built-in Firebase Authentication checks diff --git a/site/src/ionic/authentication.md b/site/src/ionic/authentication.md new file mode 100644 index 000000000..a42a946e4 --- /dev/null +++ b/site/src/ionic/authentication.md @@ -0,0 +1,100 @@ +--- +title: Authentication +eleventyNavigation: + key: Authentication + parent: Ionic +--- + +## Setting up Ionic and Firebase Auth + +First start out by installing the needed plugins below. + +``` +ionic cordova plugin add cordova-universal-links-plugin +ionic cordova plugin add cordova-plugin-buildinfo +ionic cordova plugin add cordova-plugin-browsertab +ionic cordova plugin add cordova-plugin-inappbrowser +(for ios) +ionic cordova plugin add cordova-plugin-customurlscheme +``` + +## Add Firebase to your Ionic app + +Follow [this tutorial](https://github.com/angular/angularfire2/blob/master/docs/install-and-setup.md) to make a basic setup for your Ionic project. + +### To set up in an Android app + +Go to [Firebase console](https://console.firebase.google.com/) then click *Add Firebase to your Android app* and follow the setup steps. + +## Set up Firebase Authentication for Cordova + +*This is a summary from the [Firebase instructions](https://firebase.google.com/docs/auth/web/cordova).* + +### Setup Dynamic Link +In the Firebase console, open the *Dynamic Links* section at bottom left panel, setup by their instruction + +Add this to config.xml at root level of project: + +```xml + + + + + + + + + + +``` +Make sure your `` the same with Android app's id you added in Firebase. + +## Add login code + +In `login.service.ts` add this function: + +```ts + +import { AngularFireAuth } from '@angular/fire/auth'; +import firebase from 'firebase/app'; +import AuthProvider = firebase.auth.AuthProvider; + +export class AuthService { + private user: firebase.User; + constructor(public afAuth: AngularFireAuth) { + afAuth.authState.subscribe(user => { + this.user = user; + }); + } + + signInWithFacebook() { + console.log('Sign in with Facebook'); + return this.oauthSignIn(new firebase.auth.FacebookAuthProvider()); + } + + signInWithGoogle() { + console.log('Sign in with Google'); + return this.oauthSignIn(new firebase.auth.GoogleAuthProvider()); + } + + private oauthSignIn(provider: AuthProvider) { + if (!(window).cordova) { + return this.afAuth.auth.signInWithPopup(provider); + } else { + return this.afAuth.auth.signInWithRedirect(provider) + .then(() => { + return this.afAuth.auth.getRedirectResult().then( result => { + // This gives you an Access Token. You can use it to access the associated APIs. + let token = result.credential.accessToken; + // The signed-in user info. + let user = result.user; + console.log(token, user); + }).catch(function(error) { + // Handle Errors here. + alert(error.message); + }); + }); + } + } +} +``` diff --git a/site/src/ionic/getting-started.md b/site/src/ionic/getting-started.md new file mode 100644 index 000000000..a558072c7 --- /dev/null +++ b/site/src/ionic/getting-started.md @@ -0,0 +1,199 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Ionic +--- + +## Setup with Ionic CLI + +Before you start installing AngularFire, make sure you have latest version of Ionic cli installed. To verify run the command `ionic -v` and check your version. The CLI should be at least version 3.0.0 or greater. + +If not, you may need to do the following: + +```bash +# if you have the wrong cli version only +npm uninstall -g ionic +npm cache clean + +# reinstall clean version +npm install -g @ionic/cli +``` + +## Create a new project + +```bash +ionic start +cd +``` + +The Ionic CLI's `start` command will prompt you to pick a starting template, and scaffold out the project for you. + +## Test your Setup + +```bash +ionic serve +``` + +Your default browser should start up and display a working Ionic app. + +## Install AngularFire & Firebase + +```bash +npm install @angular/fire firebase --save +``` + +Now that you have a new project setup, install AngularFire and Firebase from npm. + +### Add Firebase config to environments variable + +Let's create a new file, `src/environment.ts` and start adding our Firebase config: + +```ts +export const firebaseConfig = { + apiKey: '', + authDomain: '', + databaseURL: '', + projectId: '', + storageBucket: '', + messagingSenderId: '' +}; +``` + + +## Add the `AngularFireModule` + +Open `/src/app/app.module.ts`, inject the Firebase providers, and specify your Firebase configuration. This can be found in your project at [the Firebase Console](https://console.firebase.google.com): + +```ts +import { BrowserModule } from '@angular/platform-browser'; +import { NgModule } from '@angular/core'; +import { IonicApp, IonicModule } from 'ionic-angular'; +import { MyApp } from './app.component'; + +import { AngularFireModule } from '@angular/fire'; +import { firebaseConfig } from '../environment'; + +@NgModule({ + declarations: [ MyApp ], + imports: [ + BrowserModule, + IonicModule.forRoot(MyApp), + AngularFireModule.initializeApp(firebaseConfig) + ], + bootstrap: [IonicApp], +}) +export class AppModule {} + +``` + +There will be more or less imports depending on your app. This is just an example setup. + +## Custom FirebaseApp Names +You can optionally provide a custom FirebaseApp name with `initializeApp`. + +```ts +@NgModule({ + declarations: [ MyApp ], + imports: [ + BrowserModule, + IonicModule.forRoot(MyApp), + AngularFireModule.initializeApp(firebaseConfig, 'my-app-name') + ], + bootstrap: [IonicApp], +}) +export class AppModule {} +``` + +## Adding Feature Modules + +If your application was using both Firebase Auth and the Realtime Database you would add the following modules. + +```ts +import { BrowserModule } from '@angular/platform-browser'; +import { NgModule } from '@angular/core'; +import { IonicApp, IonicModule } from 'ionic-angular'; +import { MyApp } from './app.component'; + +import { AngularFireModule } from '@angular/fire'; +import { firebaseConfig } from '../environment'; +import { AngularFireDatabaseModule } from '@angular/fire/database'; +import { AngularFireAuthModule } from '@angular/fire/auth'; + + +@NgModule({ + declarations: [ MyApp ], + imports: [ + BrowserModule, + // imports firebase/app needed for everything + AngularFireModule.initializeApp(firebaseConfig), + // imports firebase/database, only needed for database features + AngularFireDatabaseModule, + // imports firebase/auth, only needed for auth features + AngularFireAuthModule, + IonicModule.forRoot(MyApp), + ], + bootstrap: [IonicApp], +}) + +``` + +### Inject AngularFireDatabase + +Open `/src/pages/home/home.ts`, and start to import `AngularFireDatabase`. + +```ts +import { Component } from '@angular/core'; +import { NavController } from 'ionic-angular'; +import { AngularFireDatabase } from '@angular/fire/database'; +import { Observable } from 'rxjs/Observable'; + +@Component({ + selector: 'page-home', + templateUrl: 'home.html' +}) +export class HomePage { + items: Observable; + constructor( + public db: AngularFireDatabase, + public navCtrl: NavController, + ) {} + +} +``` + +### 8. Bind to a list + +In `/src/pages/home/home.ts`: + +```ts +import { Component } from '@angular/core'; +import { NavController } from 'ionic-angular'; +import { AngularFireDatabase } from '@angular/fire/database'; +import { Observable } from 'rxjs/Observable'; + +@Component({ + selector: 'page-home', + templateUrl: `{%raw%} + + --- + + + + + {{item | json}} + +{%endraw%}` +}) +export class HomePage { + items: Observable; + constructor( + public db: AngularFireDatabase, + public navCtrl: NavController, + ) { + this.items = db.list('list').valueChanges(); + } + +} +``` + diff --git a/site/src/ionic/index.md b/site/src/ionic/index.md new file mode 100644 index 000000000..3bc76eaaf --- /dev/null +++ b/site/src/ionic/index.md @@ -0,0 +1,6 @@ +--- +eleventyNavigation: + key: Ionic + order: 12 +--- + diff --git a/site/src/ionic/ionic.11tydata.json b/site/src/ionic/ionic.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/ionic/ionic.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/js/click-card.js b/site/src/js/click-card.js new file mode 100644 index 000000000..66a2587ac --- /dev/null +++ b/site/src/js/click-card.js @@ -0,0 +1,17 @@ +customElements.define('eap-click-card', class extends HTMLElement { + connectedCallback() { + let down; + let up; + // Enhance to a pointer only if the JavaScript applies + this.style.cursor = 'pointer'; + // Note: This only works for a single link or the first one. + const firstOrOnlyLink = this.querySelector('a'); + this.onmousedown = () => down = +new Date(); + this.onmouseup = () => { + up = +new Date(); + if ((up - down) < 200) { + firstOrOnlyLink.click(); + } + } + } +}); \ No newline at end of file diff --git a/site/src/js/menu-button.js b/site/src/js/menu-button.js new file mode 100644 index 000000000..47018438f --- /dev/null +++ b/site/src/js/menu-button.js @@ -0,0 +1,13 @@ +customElements.define('eap-menu-button', class extends HTMLElement { + connectedCallback() { + const menuId = this.getAttribute('data-menu-id'); + const menuEl = document.getElementById(menuId); + const button = document.createElement('button'); + button.classList.add('fixed', 'w-16', 'h-16', 'text-white', 'rounded-full', 'shadow-lg', 'bottom-6', 'right-6', 'bg-grey-700', 'focus:ring-grey-600' , 'z-50', 'focus:ring-4', 'md:hidden', 'lg:hidden', 'xl:hidden'); + button.textContent = 'đŸ”Ĩ'; + this.appendChild(button); + button.addEventListener('click', clickEvent => { + menuEl.classList.toggle('slideIn'); + }); + } +}); diff --git a/site/src/js/tab-switcher.js b/site/src/js/tab-switcher.js new file mode 100644 index 000000000..5c6a03a68 --- /dev/null +++ b/site/src/js/tab-switcher.js @@ -0,0 +1,25 @@ +customElements.define('eap-tab-switcher', class extends HTMLElement {}); +customElements.define('eap-tab-list', class extends HTMLElement { + connectedCallback() { + this.buttonTabs = this.querySelectorAll('button'); + for(let button of this.buttonTabs) { + button.addEventListener('click', clickEvent => { + const activeButton = this.querySelector('button[aria-selected="true"]'); + const activePanelId = activeButton.dataset.panel; + const panelToDisplayId = button.dataset.panel; + const panelToDisplay = document.querySelector(`#${panelToDisplayId}`); + const activePanel = document.querySelector(`#${activePanelId}`); + if(activeButton.id !== button.id) { + button.setAttribute('aria-selected', true); + activeButton.setAttribute('aria-selected', false); + panelToDisplay.classList.add('block'); + panelToDisplay.classList.remove('hidden'); + activePanel.classList.remove('block'); + activePanel.classList.add('hidden'); + } + }); + } + } +}); +customElements.define('eap-tab-panel-list', class extends HTMLElement {}); +customElements.define('eap-tab-panel', class extends HTMLElement { }); \ No newline at end of file diff --git a/site/src/messaging/getting-started.md b/site/src/messaging/getting-started.md new file mode 100644 index 000000000..b69a5ca80 --- /dev/null +++ b/site/src/messaging/getting-started.md @@ -0,0 +1,234 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Messaging +--- + +## Using AngularFireMessaging + +The FCM JavaScript API lets you receive notification messages in web apps running in browsers that support the Push API. + +## Not readily compatible with the Angular Service Worker + +If you are using the Angular Service Worker, you are not currently able to use AngularFireMessaging out-of-the-box. If you'd like this feature please add your 👍 to [this issue](https://github.com/angular/angular/issues/34352). + +Your alternatives are to use +- [WorkboxJS](https://developers.google.com/web/tools/workbox/){.text-blue .underline} +- Follow the discussion in [this issue](https://github.com/angular/angular/issues/34352){.text-blue .underline} and [here](https://github.com/angular/angularfire/discussions/1923){.text-blue .underline}, manually registering the Angular Service Worker +- The Firebase Messaging Service Worker, which is detailed below + +## Import the `NgModule` + +Push Notifications for AngularFire are contained in the `@angular/fire/messaging` module namespace. Import the `AngularFireMessagingModule` in your `NgModule`. This sets up the `AngularFireMessaging` service for dependency injection. + +```ts +import { BrowserModule } from '@angular/platform-browser'; +import { NgModule } from '@angular/core'; +import { AppComponent } from './app.component'; +import { AngularFireModule } from '@angular/fire'; +import { AngularFireMessagingModule } from '@angular/fire/messaging'; +import { environment } from '../environments/environment'; + +@NgModule({ + imports: [ + BrowserModule, + AngularFireModule.initializeApp(environment.firebase), + AngularFireMessagingModule + ], + declarations: [ AppComponent ], + bootstrap: [ AppComponent ] +}) +export class AppModule {} +``` + +### Setting up the Firebase Messaging Service Worker + +There are two parts to Firebase Messaging, a Service Worker and the DOM API. AngularFireMessaging allows you to request permission, get tokens, delete tokens, and subscribe to messages on the DOM side. To register to receive notifications you need to set up the Service Worker. [The official Firebase documentation for setting up the details exactly how to do that](https://firebase.google.com/docs/cloud-messaging/js/client). + +You can either use the `firebase-messaging-sw.js` file provided in the docs or you can set your own Service Worker to import that script. Make sure to set up your `angular.json` file to copy over the Service Worker file: + +```json + "assets": [ + "assets", + "favicon.ico", + "firebase-messaging-sw.js", + "manifest.json" + ], +``` + +[Warning] Remember update the `firebase-messaging-sw.js` everytime you update the `firebase` in package.json. The missmatch version could lead to unable to receive notification in `foreground`, you can create your `firebase-messaging-sw.js` like this: + +```js +// Give the service worker access to Firebase Messaging. +// Note that you can only use Firebase Messaging here, other Firebase libraries +// are not available in the service worker. +importScripts('https://www.gstatic.com/firebasejs/[the%20number%20of%20version%20matching%20with%20firebase%20in%20package.json]/firebase-app.js'); +importScripts('https://www.gstatic.com/firebasejs/[for%20example:%208.2.6]/firebase-messaging.js'); + +// Initialize the Firebase app in the service worker by passing in the +// messagingSenderId. + +firebase.initializeApp({ + apiKey: '', + authDomain: '', + databaseURL: '', + projectId: '', + storageBucket: '', + messagingSenderId: '' +}); + +// Retrieve an instance of Firebase Messaging so that it can handle background +// messages. +const messaging = firebase.messaging(); +``` + +### Requesting permission + +Once you have the Firebase Messaging Service Worker set up and installed, you need to request permission to send a user notifications. While the browser will popup a UI for you, it is highly recommend to ask the user for permission with a custom UI and only ask when it makes sense. If you blindly ask for permission, you have an extremely high chance of getting denied or blocked. + +```ts +import { Component } from '@angular/core'; +import { AngularFireMessaging } from '@angular/fire/messaging'; + +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private afMessaging: AngularFireMessaging) { } + requestPermission() { + this.afMessaging.requestPermission + .subscribe( + () => { console.log('Permission granted!'); }, + (error) => { console.error(error); }, + ); + } +} +``` + +Once you have the permission of the user, you need their token. You can do this with the `getToken` observable or the `tokenChanges` observable. The `tokenChanges` observable listens for token refreshes whereas the `getToken` observable is a one-time call. + +```ts +import { Component } from '@angular/core'; +import { AngularFireMessaging } from '@angular/fire/messaging'; +import { mergeMapTo } from 'rxjs/operators'; + +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private afMessaging: AngularFireMessaging) { } + requestPermission() { + this.afMessaging.requestPermission + .pipe(mergeMapTo(this.afMessaging.tokenChanges)) + .subscribe( + (token) => { console.log('Permission granted! Save to the server!', token); }, + (error) => { console.error(error); }, + ); + } +} +``` + +Once you have a user's token, you need to save it to the server in order to send them notifications in response to events. Let's say you want to send a push each time a user sends a chat message. Once a user grants permission, you can send the token to the Realtime Database or Cloud Firestore and associate it with a unique id, like a Firebase Auth UID. You can then create a Cloud Function trigger that looks up the user's token when a chat message is created. + +### Shortcutting token requests + +An easier way of requesting permission and getting tokens is with the `requestToken` observable. It combines the two steps above into one observable. + +```ts +import { Component } from '@angular/core'; +import { AngularFireMessaging } from '@angular/fire/messaging'; + +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private afMessaging: AngularFireMessaging) { } + requestPermission() { + this.afMessaging.requestToken + .subscribe( + (token) => { console.log('Permission granted! Save to the server!', token); }, + (error) => { console.error(error); }, + ); + } +} +``` + +The `requestToken` observable uses the `tokenChanges` observable to listen to refreshes. + +### Deleting tokens + +Need to delete a user's token? Not a problem. + +```ts +import { Component } from '@angular/core'; +import { AngularFireMessaging } from '@angular/fire/messaging'; +import { mergeMap } from 'rxjs/operators'; + +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private afMessaging: AngularFireMessaging) { } + deleteToken() { + this.afMessaging.getToken + .pipe(mergeMap(token => this.afMessaging.deleteToken(token))) + .subscribe( + (token) => { console.log('Token deleted!'); }, + ); + } +} +``` + +The code above requests the current user's token and passes it to the `deleteToken()` observable. + +### Subscribing to foreground messages + +Once you have a user's token and they are subscribed, you can listen to messages in the foreground. The Firebase Messaging Service Worker handles background push notifications. + +```ts +import { Component } from '@angular/core'; +import { AngularFireMessaging } from '@angular/fire/messaging'; + +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private afMessaging: AngularFireMessaging) { } + listen() { + this.afMessaging.messages + .subscribe((message) => { console.log(message); }); + } +} +``` + +### Sending notifications + +[Sending a notification](https://firebase.google.com/docs/cloud-messaging/js/first-message) requires a call to a server. You can do this directly with an HTTP call or you can even build a Cloud Function to do this in response to an event. A Cloud Function trigger is ideal because you have trusted access to the database and can securely look up tokens to send to the right user. If you want to send push notifications via HTTP requests you'll need to secure the API call. This is usually done with a Firebase Auth UID. On the server you can verify the UID with the Firebase Admin SDK and allow access to get a user's push id. + +The [Firebase Admin SDK has helper functions for sending notifications](https://firebase.google.com/docs/cloud-messaging/admin/send-messages) to the user and subscribing them to topics, which [simplifies sending grouped messages](https://firebase.google.com/docs/cloud-messaging/admin/manage-topic-subscriptions). \ No newline at end of file diff --git a/site/src/messaging/index.md b/site/src/messaging/index.md new file mode 100644 index 000000000..8bf754c30 --- /dev/null +++ b/site/src/messaging/index.md @@ -0,0 +1,6 @@ +--- +eleventyNavigation: + key: Messaging + order: 8 +--- + diff --git a/site/src/messaging/messaging.11tydata.json b/site/src/messaging/messaging.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/messaging/messaging.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/performance/getting-started.md b/site/src/performance/getting-started.md new file mode 100644 index 000000000..5de106ca2 --- /dev/null +++ b/site/src/performance/getting-started.md @@ -0,0 +1,131 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Performance +--- + +## Automatic page load tracing + +Understand your Angular application's real-world performance with [Firebase Performance Monitoring](https://firebase.google.com/docs/perf-mon). Performance Monitoring automatically provides a trace for **page load** when you add `AngularFirePerformanceModule` into your App Module's imports. + +```ts +import { AngularFireModule } from '@angular/fire'; +import { AngularFirePerformanceModule, PerformanceMonitoringService } from '@angular/fire/performance'; +import { environment } from '../environments/environment'; + +@NgModule({ + imports: [ + BrowserModule, + AngularFireModule.initializeApp(environment.firebase), + AngularFirePerformanceModule, + ... + ], + providers: [ + PerformanceMonitoringService + ], + declarations: [ AppComponent ], + bootstrap: [ AppComponent ] +}) +export class AppModule {} +``` + +The page load trace breaks down into the following default metrics: + +* [First paint traces](https://firebase.google.com/docs/perf-mon/automatic-web#first-paint){.text-blue .underline} — measure the time between when the user navigates to a page and when any visual change happens +* [First contentful paint traces](https://firebase.google.com/docs/perf-mon/automatic-web#contentful-paint){.text-blue .underline} — measure the time between when a user navigates to a page and when meaningful content displays, like an image or text +* [domInteractive traces](https://firebase.google.com/docs/perf-mon/automatic-web#domInteractive){.text-blue .underline} — measure the time between when the user navigates to a page and when the page is considered interactive for the user +* [domContentLoadedEventEnd traces](https://firebase.google.com/docs/perf-mon/automatic-web#domContentLoaded){.text-blue .underline} — measure the time between when the user navigates to a page and when the initial HTML document is completely loaded and parsed +* [loadEventEnd traces](https://firebase.google.com/docs/perf-mon/automatic-web#loadEventEnd){.text-blue .underline} — measure the time between when the user navigates to the page and when the current document's load event completes +* [First input delay traces](https://firebase.google.com/docs/perf-mon/automatic-web#input-delay){.text-blue .underline} — measure the time between when the user interacts with a page and when the browser is able to respond to that input +* *Angular specific traces* - `PerformanceMonitoringService` will measure the time needed for `ApplicationRef.isStable` to be true, an important metric to track if you're concerned about solving Zone.js issues for proper functionality of NGSW and Server Side Rendering + +## Measuring First Input Delay + +First Input Delay (FID) measures the time from when a user first interacts with your site (i.e. when they click a link, tap on a button, or use a custom, JavaScript-powered control) to the time when the browser is actually able to respond to that interaction. [See the article on the Google Developer's Blog for more information on FID.](https://developers.google.com/web/updates/2018/05/first-input-delay) + +In order to track first input delay, you'll want to [polyfill the browser performance API](https://github.com/GoogleChromeLabs/first-input-delay): + +```bash +npm install --save-dev first-input-delay +``` + +Then add `import 'first-input-delay';` to your `src/polyfills.ts`. + +## Manual traces + +You can inject `AngularFirePerformance` to perform manual traces. + +```ts +constructor(private performance: AngularFirePerformance) {} + +// ... + +const trace = await this.performance.trace('some-trace'); +trace.start(); +// Dome something you want to trace +trace.stop(); +``` + +## RxJS operators + +AngularFire provides a number of RxJS operators which wrap the User Timing API. These are picked up by performance monitoring tools such as Chrome Inspector and Firebase Performance Monitoring. + +```ts +import { trace } from '@angular/fire/performance'; + +// ... + +constructor(private performance: AngularFirePerformance, private afs: AngularFirestore) {} + +ngOnInit() { + this.articles = afs.collection('articles') + .collection('articles', ref => ref.orderBy('publishedAt', 'desc')) + .snapshotChanges() + .pipe( + // measure the amount of time between the Observable being subscribed to and first emission (or completion) + trace('getArticles'), + map(articles => ...) + ); +} +``` + +### `trace(name: string)` + +The most basic operator, `trace` will measure the amount of time it takes for your observable to either complete or emit its first value. Beyond the basic trace there are several other operators: + +```ts +traceUntil( + name: string, + test: (T) => Boolean, + options?: { orComplete?: true } +) +``` + +Trace the observable until the first emission that passes the provided test. + +If the `orComplete` option is passed it will complete the trace when the observable completes, even if an emission never passed the provided test. + +```ts +traceWhile( + name: string, + test: (T) => Boolean, + options?: { orComplete?: true } +) +``` + +Starting with an emission that passes the provided test, trace until an emission fails the test. + +If the `orComplete` option is passed it will complete any existing trace when the observable completes. + +### `traceUntilLast(name: string)` + +Trace the observable until completion. + +### `traceUntilFirst(name: string)` + +Traces the observable until the first emission. + +## Configuration via Dependency Injection + +Set `INSTRUMENTATION_ENABLED` or `DATA_COLLECTION_ENABLED` to false disable all automatic and custom traces respectively. diff --git a/site/src/performance/index.md b/site/src/performance/index.md new file mode 100644 index 000000000..7a6ef7fce --- /dev/null +++ b/site/src/performance/index.md @@ -0,0 +1,5 @@ +--- +eleventyNavigation: + key: Performance + order: 10 +--- diff --git a/site/src/performance/performance.11tydata.json b/site/src/performance/performance.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/performance/performance.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/remote-config/getting-started.md b/site/src/remote-config/getting-started.md new file mode 100644 index 000000000..e95d71649 --- /dev/null +++ b/site/src/remote-config/getting-started.md @@ -0,0 +1,132 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Remote Config +--- + +## Getting started with Remote Config (BETA) + +`AngularFireRemoteConfig` dynamically imports the `firebase/remote-config` library on demand, provides convenience observables, pipes, and a promisified version of the [Firebase Remote Config SDK (`firebase.remoteConfig.RemoteConfig`)](https://firebase.google.com/docs/reference/js/firebase.remoteconfig.RemoteConfig). + +## API + +```ts +class AngularFireRemoteConfigModule { } + +interface ConfigTemplate {[key:string]: string|number|boolean} + +type Parameter extends remoteConfig.Value { + key: string, + fetchTimeMillis: number +} + +class AngularFireRemoteConfig { + changes: Observable; + parameters: Observable; + numbers: Observable<{[key:string]: number|undefined}> & {[key:string]: Observable}; + booleans: Observable<{[key:string]: boolean|undefined}> & {[key:string]: Observable}; + strings: Observable<{[key:string]: string|undefined}> & {[key:string]: Observable}; + + // from firebase.remoteConfig() proxy: + activate: () => Promise; + ensureInitialized: () => Promise; + fetch: () => Promise; + fetchAndActivate: () => Promise; + getAll: () => Promise<{[key:string]: remoteConfig.Value}>; + getBoolean: (key:string) => Promise; + getNumber: (key:string) => Promise; + getString: (key:string) => Promise; + getValue: (key:string) => Promise; + setLogLevel: (logLevel: remoteConfig.LogLevel) => Promise; + settings: Promise; + defaultConfig: Promise<{[key: string]: string | number | boolean}>; + fetchTimeMillis: Promise; + lastFetchStatus: Promise; +} + +// Pipes for working with .changes and .parameters +filterRemote: () => MonoTypeOperatorFunction +filterFresh: (interval: number) => MonoTypeOperatorFunction +budget: (interval: number) => MonoTypeOperatorFunction + +// scanToObject is for use with .changes +scanToObject: () => OperatorFunction + +// mapToObject is the same behavior as scanToObject but for use with .parameters +mapToObject: () => OperatorFunction + +SETTINGS = InjectionToken; +DEFAULTS = InjectionToken; +``` + +Using the `SETTINGS` DI Token (*default: {}*) will allow you to [configure Firebase Remote Config](https://firebase.google.com/docs/reference/js/firebase.remoteconfig.Settings.html). + +## Configure default values + +Providing `DEFAULTS ({[key: string]: string | number | boolean})` tells `AngularFireRemoteConfig` to emit the provided defaults first. This allows you to count on Remote Config when the user is offline or in environments that the Remote Config service does not handle (i.e. Server Side Rendering). + +```ts +import { AngularFireRemoteConfigModule, DEFAULTS, SETTINGS } from '@angular/fire/remote-config'; + +@NgModule({ + imports: [ + AngularFireModule.initializeApp(environment.firebase), + AngularFireRemoteConfigModule + ], + providers: [ + { provide: DEFAULTS, useValue: { enableAwesome: true } }, + { + provide: SETTINGS, + useFactory: () => isDevMode() ? { minimumFetchIntervalMillis: 10_000 } : {} + } + ] +}) +export class AppModule { } +... + +constructor(remoteConfig: AngularFireRemoteConfig) { + remoteConfig.changes.pipe( + filterFresh(172_800_000), // ensure we have values from at least 48 hours ago + first(), + // scanToObject when used this way is similar to defaults + // but most importantly smart-casts remote config values and adds type safety + scanToObject({ + enableAwesome: true, + titleBackgroundColor: 'blue', + titleFontSize: 12 + }) + ).subscribe(â€Ļ); + + // all remote config values cast as strings + remoteConfig.strings.subscribe(...) + remoteConfig.booleans.subscribe(...); // as booleans + remoteConfig.numbers.subscribe(...); // as numbers + + // convenience for observing a single string + remoteConfig.strings.titleBackgroundColor.subscribe(...); + remoteConfig.booleans.enableAwesome.subscribe(...); // boolean + remoteConfig.numbers.titleBackgroundColor.subscribe(...); // number + + // however those may emit more than once as the remote config cache fires and gets fresh values + // from the server. You can filter it out of .changes for more control: + remoteConfig.changes.pipe( + filter(param => param.key === 'titleBackgroundColor'), + map(param => param.asString()) + // budget at most 800ms and return the freshest value possible in that time + // our budget pipe is similar to timeout but won't error or abort the pending server fetch + // (it won't emit it, if the deadline is exceeded, but it will have been fetched so can use the + // freshest values on next subscription) + budget(800), + last() + ).subscribe(...) + + // just like .changes, but scanned into an array + remoteConfig.parameters.subscribe(all => ...); + + // or make promisified firebase().remoteConfig() calls direct off AngularFireRemoteConfig + // using our proxy + remoteConfig.getAll().then(all => ...); + remoteConfig.lastFetchStatus.then(status => ...); +} +``` diff --git a/site/src/remote-config/index.md b/site/src/remote-config/index.md new file mode 100644 index 000000000..1334bae3a --- /dev/null +++ b/site/src/remote-config/index.md @@ -0,0 +1,5 @@ +--- +eleventyNavigation: + key: Remote Config + order: 9 +--- diff --git a/site/src/remote-config/remote-config.11tydata.json b/site/src/remote-config/remote-config.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/remote-config/remote-config.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/rtdb/index.md b/site/src/rtdb/index.md new file mode 100644 index 000000000..7cb869514 --- /dev/null +++ b/site/src/rtdb/index.md @@ -0,0 +1,5 @@ +--- +eleventyNavigation: + key: RTDB + order: 4 +--- diff --git a/site/src/rtdb/lists.md b/site/src/rtdb/lists.md new file mode 100644 index 000000000..220c7d7ae --- /dev/null +++ b/site/src/rtdb/lists.md @@ -0,0 +1,252 @@ +--- +title: Lists +eleventyNavigation: + key: Lists + parent: RTDB +--- + +## Retrieving data as lists + +AngularFire synchronizes data as lists using the `AngularFireList` service. The `AngularFireList` service is not created by itself, but through the `AngularFireDatabase` service. The guide below demonstrates how to retrieve, save, and remove data as lists. + +## Injecting the `AngularFireDatabase` service + +*Make sure you have bootstrapped your application for AngularFire. See the Installation guide for bootstrap setup.* + +AngularFireDatabase is a service which can be injected through the constructor of your Angular component or `@Injectable()` service. In the previous step, we modified the `/src/app/app.component.ts` to retrieve data as an object. In this step, let's start with a clean slate. + +Replace your `/src/app/app.component.ts` from previous step to look like below. + +```ts +import { Component } from '@angular/core'; +import { AngularFireDatabase } from '@angular/fire/database'; + +@Component({ + selector: 'app-root', + templateUrl: 'app.component.html', + styleUrls: ['app.component.css'] +}) +export class AppComponent { + constructor(db: AngularFireDatabase) { } +} +``` + +In this section, we're going to modify the `/src/app/app.component.ts` to retrieve data as list, but before that let's look at ways around how to bind to a list. + +## Create a list binding + +Data is retrieved through the `AngularFireDatabase` service. The service is also generic. Provide the singular type and not the array type. + +```ts +const listRef = db.list('items'); +const shirtsRef = db.list('shirts'); +``` + +### Retrieve data + +To get the list in realtime, create a list binding as a property of your component or service. Then in your template, you can use the `async` pipe to unwrap the binding. + +Update `/src/app/app.component.ts` to import `AngularFireList` from `@angular/fire` and iterate through the list once data is retrieved. Also note the change in attribute `templateUrl` to inline `template` below. + +```ts +import { Component } from '@angular/core'; +import { AngularFireDatabase } from '@angular/fire/database'; +import { Observable } from 'rxjs'; + +@Component({ + selector: 'app-root', + template: `{%raw%} +
    +
  • + {{ item | json }} +
    • +
+ {%endraw%}`, +}) +export class AppComponent { + items: Observable; + constructor(db: AngularFireDatabase) { + this.items = db.list('items').valueChanges(); + } +} +``` + +## `AngularFireAction` - Action based API + +AngularFire provides methods that stream data back as redux compatible actions. This gives you extra horsepower when using libraries like Animations, ngrx, and ReactiveForms. + +### `valueChanges()` + +*What is it?* - Returns an Observable of data as a synchronized array of JSON objects. All Snapshot metadata is stripped and just the method provides only the data. + +*Why would you use it?* - When you just need a list of data. No snapshot metadata is attached to the resulting array which makes it simple to render to a view. + +*When would you not use it?* - When you need a more complex data structure than an array or you need the `key` of each snapshot for data manipulation methods. This method assumes you either are saving the `key` for the snapshot data or using a "readonly" approach. + +### `snapshotChanges()` + +*What is it?* - Returns an Observable of data as a synchronized array of `AngularFireAction[]`. + +*Why would you use it?* - When you need a list of data but also want to keep around metadata. Metadata provides you the underyling `DatabaseReference` and snapshot key. Having the snapshot's `key` around makes it easier to use data manipulation methods. This method gives you more horsepower with other Angular integrations such as ngrx, forms, and animations due to the `type` property. The `type` property on each `AngularFireAction` is useful for ngrx reducers, form states, and animation states. + +*When would you not use it?* - When you need a more complex data structure than an array or if you need to process changes as they occur. This array is synchronized with the remote and local changes in the Firebase Database. + +### `stateChanges()` + +*What is it?* - Returns an Observable of the most recent change as an `AngularFireAction`. + +*Why would you use it?* - The above methods return a singular `AngularFireAction` from each child event that occurs. `stateChanges()` emits changes as they occur rather than syncing the query order. This works well for ngrx integrations as you can build your own data structure in your reducer methods. + +*When would you not use it?* - When you just need a list of data. This is a more advanced usage of `AngularFireDatabase`. + +### `auditTrail()` + +*What is it?* - Returns an Observable of `AngularFireAction[]` as they occur. Similar to `stateChanges()`, but instead it keeps around the trail of events as an array. + +*Why would you use it?* - This method is like `stateChanges()` except it is not ephemeral. It collects each change in an array as they occur. This is useful for ngrx integrations where you need to replay the entire state of an application. This also works as a great debugging tool for all applications. You can simple write `db.list('items').auditTrail().subscribe(console.log)` and check the events in the console as they occur. + +*When would you not use it?* - When you just need a list of data. This is a more advanced usage of AngularFireDatabase. + +### Limiting events + +There are four child events: `"child_added"`, `"child_changed"`, `"child_removed"`, and `"child_moved"`. Each streaming method listens to all four by default. However, your site may only be intrested in one of these events. You can specify which events you'd like to use through the first parameter of each method: + +```ts +this.itemsRef = db.list('items'); +this.itemsRef.snapshotChanges(['child_added']) + .subscribe(actions => { + actions.forEach(action => { + console.log(action.type); + console.log(action.key); + console.log(action.payload.val()); + }); + }); +``` + +## API Summary + +The table below highlights some of the common methods on the `AngularFireList`. + +| method | | +| ---------|--------------------| +| `push(value: T)` | Creates a new record on the list, using the Realtime Database's push-ids. | +| `update(keyRefOrSnap: string, value: T)` | Firebase | AFUnwrappedSnapshot, value: Object) | Updates an existing item in the array. Accepts a key, database reference, or an unwrapped snapshot. | +| `remove(key: string?)` | Deletes the item by key. If no parameter is provided, the entire list will be deleted. | + +## Returning promises + +Each data operation method in the table above returns a promise. However, +you should rarely need to use the completion promise to indicate success, +because the realtime database keeps the list in sync. + +The promise can be useful to chain multiple operations, catching possible errors +from security rules denials, or for debugging. + +```ts +const promise = db.list('items').remove(); +promise + .then(_ => console.log('success')) + .catch(err => console.log(err, 'You do not have access!')); +``` + +## Adding new items + +Use the `push()` method to add new items on the list. + +```ts +const itemsRef = db.list('items'); +itemsRef.push({ name: newName }); +``` + +### Replacing items in the list using `set` + +Use the `set()` method to update existing items. + +```ts +const itemsRef = db.list('items'); +// to get a key, check the Example app below +itemsRef.set('key-of-some-data', { size: newSize }); +``` + +Replaces the current value in the database with the new value specified as the parameter. This is called a destructive update, because it deletes everything currently in place and saves the new value. + +## Updating items in the list using `update` + +Use the `update()` method to update existing items. + +```ts +const itemsRef = db.list('items'); +// to get a key, check the Example app below +itemsRef.update('key-of-some-data', { size: newSize }); +``` + +Note that this updates the current value with in the database with the new value specified as the parameter. This is called a non-destructive update, because it only updates the values specified. + +### Removing items from the list +Use the `remove()` method to remove data at the list item's location. + +```ts +const itemsRef = db.list('items'); +// to get a key, check the Example app below +itemsRef.remove('key-of-some-data'); +``` + +## Deleting the entire list + +If you omit the `key` parameter from `.remove()` it deletes the entire list. + +```ts +const itemsRef = db.list('items'); +itemsRef.remove(); +``` + +The following is a complete example of deleting an entire list. + +```ts +import { Component } from '@angular/core'; +import { AngularFireDatabase, AngularFireList } from '@angular/fire/database'; +import { Observable } from 'rxjs'; +import { map } from 'rxjs/operators'; + +@Component({ + selector: 'app-root', + template: ` +
    +
  • + + + +
    • +
+ + + + `, +}) +export class AppComponent { + itemsRef: AngularFireList; + items: Observable; + constructor(db: AngularFireDatabase) { + this.itemsRef = db.list('messages'); + // Use snapshotChanges().map() to store the key + this.items = this.itemsRef.snapshotChanges().pipe( + map(changes => + changes.map(c => ({ key: c.payload.key, ...c.payload.val() })) + ) + ); + } + addItem(newName: string) { + this.itemsRef.push({ text: newName }); + } + updateItem(key: string, newText: string) { + this.itemsRef.update(key, { text: newText }); + } + deleteItem(key: string) { + this.itemsRef.remove(key); + } + deleteEverything() { + this.itemsRef.remove(); + } +} +``` + diff --git a/site/src/rtdb/objects.md b/site/src/rtdb/objects.md new file mode 100644 index 000000000..efd9592bd --- /dev/null +++ b/site/src/rtdb/objects.md @@ -0,0 +1,179 @@ +--- +title: Objects +eleventyNavigation: + key: Objects + parent: RTDB +--- + +## Retrieving data as objects + +The `AngularFireObject` is a service for manipulating and streaming object data. The `AngularFireObject` service is not created by itself, but through the `AngularFireDatabase` service. + +## Injecting the `AngularFireDatabase` service + +*Make sure you have bootstrapped your application for AngularFire. See the Installation guide for bootstrap setup.* + +`AngularFireDatabase` is a service which can be injected through the constructor of your Angular component or `@Injectable()` service. + +If you've followed the earlier step "Installation and Setup" your `/src/app/app.component.ts` should look like below. + +```ts +import { Component } from '@angular/core'; +import { AngularFireDatabase } from '@angular/fire/database'; +import { Observable } from 'rxjs'; + +@Component({ + selector: 'app-root', + templateUrl: 'app.component.html', + styleUrls: ['app.component.css'] +}) +export class AppComponent { + items: Observable; + constructor(db: AngularFireDatabase) { + this.items = db.list('items').valueChanges(); + } +} +``` + +In this section, we're going to modify the `/src/app/app.component.ts` to retrieve data as object. + +## Create an object binding + +```ts +const relative = db.object('item').valueChanges(); +``` + +## Retrieve data + +To get the object in realtime, create an object binding as a property of your component or service. + +Then in your template, you can use the `async` pipe to unwrap the binding. + +```ts +import { Component } from '@angular/core'; +import { AngularFireDatabase } from '@angular/fire/database'; +import { Observable } from 'rxjs'; + +@Component({ + selector: 'app-root', + template: `{%raw%} +

{{ (item | async)?.name }}

+ {%endraw%}`, +}) +export class AppComponent { + item: Observable; + constructor(db: AngularFireDatabase) { + this.item = db.object('item').valueChanges(); + } +} +``` + +## API Summary + +The table below highlights some of the common methods on the `AngularFireObject`. + +| method | | +| ---------|--------------------| +| `set(value: T)` | Replaces the current value in the database with the new value specified as the parameter. This is called a **destructive** update, because it deletes everything currently in place and saves the new value. | +| `update(value: T)` | Updates the current value with in the database with the new value specified as the parameter. This is called a **non-destructive** update, because it only updates the values specified. | +| `remove()` | Deletes all data present at that location. Same as calling `set(null)`. | + +## Returning promises + +Each data operation method in the table above returns a promise. However, +you should rarely need to use the completion promise to indicate success, +because the realtime database keeps the object in sync. + +The promise can be useful to chain multiple operations, catching possible errors from security rules denials, or for debugging. + +```ts +const promise = db.object('item').remove(); +promise + .then(_ => console.log('success')) + .catch(err => console.log(err, 'You dont have access!')); +``` + +## Saving data + +Use the `set()` method for **destructive updates**. + +```ts +const itemRef = db.object('item'); +itemRef.set({ name: 'new name!'}); +``` + +## Updating data + +Use the `update()` method for **non-destructive updates**. + +```ts +const itemRef = db.object('item'); +itemRef.update({ age: newAge }); +``` + +**Only objects are allowed for updates, not primitives**. This is because +using an update with a primitive is the exact same as doing a `.set()` with a primitive. + +## Deleting data + +Use the `remove()` method to remove data at the object's location. + +```ts +const itemRef = db.object('item'); +itemRef.remove(); +``` + +**Example app**: + +```ts +import { Component } from '@angular/core'; +import { AngularFireDatabase, AngularFireObject } from '@angular/fire/database'; +import { Observable } from 'rxjs'; + +@Component({ + selector: 'app-root', + template: `{%raw%} +

{{ item | async | json }}

+ + +
+ + + + {%endraw%}`, +}) +export class AppComponent { + itemRef: AngularFireObject; + item: Observable; + constructor(db: AngularFireDatabase) { + this.itemRef = db.object('item'); + this.item = this.itemRef.valueChanges(); + } + save(newName: string) { + this.itemRef.set({ name: newName }); + } + update(newSize: string) { + this.itemRef.update({ size: newSize }); + } + delete() { + this.itemRef.remove(); + } +} +``` + +## Retrieving the snapshot + +AngularFire `valueChanges()` unwraps the Firebase DataSnapshot by default, but you can get the data as the original snapshot by using the `snapshotChanges()` option. + +```ts +this.itemRef = db.object('item'); +this.itemRef.snapshotChanges().subscribe(action => { + console.log(action.type); + console.log(action.key) + console.log(action.payload.val()) +}); +``` + +## Querying? + +Because `AngularFireObject` synchronizes objects from the realtime database, sorting will have no effect for queries that are not also limited by a range. For example, when paginating you would provide a query with a sort and filter. Both the sort operation and the filter operation affect which subset of the data is returned by the query; however, because the resulting object is simply json, the sort order will not be preseved locally. Hence, for operations that require sorting, you are probably looking for a list. diff --git a/site/src/rtdb/querying.md b/site/src/rtdb/querying.md new file mode 100644 index 000000000..3ba61b55d --- /dev/null +++ b/site/src/rtdb/querying.md @@ -0,0 +1,161 @@ +--- +title: Querying +eleventyNavigation: + key: Querying + parent: RTDB +--- + +## Querying lists + +Lists of data in the Realtime Database can be filtered down using specific querying methods. When these querying methods are combined with RxJS operators you can achieve dynamic querying which re-triggers the query when a source observable changes. This is great for updating queries in response to changes of an input or some other changing value. + +## Creating a query with constant values + +Queries are created by building on the [`firebase.database.Reference`](https://firebase.google.com/docs/reference/js/firebase.database.Reference). + +```ts +db.list('/items', ref => ref.orderByChild('size').equalTo('large')) +``` + +### Query options + +| Method | Purpose | +| ---------|--------------------| +| `orderByChild` | Specify a child to order by. | +| `orderByKey` | Boolean to order by Firebase Database keys. | +| `orderByValue` | Specify a value to order by. | +| ~~`orderByPriority`~~1 | Boolean to order by Firebase Database priority.| +| `equalTo`2 | Limit list to items that contain certain value. | +| `limitToFirst` | Sets the maximum number of items to return from the beginning of the ordered list of results. | +| `limitToLast` | Sets the maximum number of items to return from the end of the ordered list of results. | +| `startAt`2 | Return items greater than or equal to the specified key or value, depending on the order-by method chosen. | +| `endAt`2 | Return items less than or equal to the specified key or value, depending on the order-by method chosen. | + +:::annotations-section + 1 [This is the old way of doing things and is no longer recommended for use](https://youtu.be/3WTQZV5-roY?t=3m). Anything you can achieve with `orderByPriority` you should be doing with `orderByChild`. + + 2 The Firebase SDK supports an optional `key` parameter for [`startAt`](https://firebase.google.com/docs/reference/js/firebase.database.Reference#startAt), [`endAt`](https://firebase.google.com/docs/reference/js/firebase.database.Reference#endAt), and [`equalTo`](https://firebase.google.com/docs/reference/js/firebase.database.Reference#equalTo) when ordering by child, value, or priority. You can specify the `key` parameter using an object literal that contains the `value` and the `key`. For example: `startAt: { value: 'some-value', key: 'some-key' }`. +::: + +To learn more about how sorting and ordering data works in Firebase, check out the Firebase documentation on [working with lists of data](https://firebase.google.com/docs/database/web/lists-of-data#sorting_and_filtering_data). + +## Invalid query combinations + +*Queries can only be ordered by one method.* This means you can only specify +`orderByChild`, `orderByKey`, `orderByPriority`, or `orderByValue`. + +```ts +// WARNING: Do not copy and paste. This will not work! +ref.orderByChild('size').equalTo('large').orderByKey(true) +``` + +You can only use `limitToFirst` or `limitToLast`, but not both in combination. + +```ts +// WARNING: Do not copy and paste. This will not work! +ref.limitToFirst(10).limitToLast(100) +``` + +## Dynamic querying + +To enable dynamic queries one should lean on RxJS Operators like `switchMap`. + +An RxJS Subject is imported below. A Subject is like an Observable, but can multicast to many Observers. Subjects are like EventEmitters: they maintain a registry of many listeners. See, [What is a Subject](http://reactivex.io/rxjs/manual/overview.html#subject) for more information. + +When we call [`switchMap` on the Subject](https://www.learnrxjs.io/operators/transformation/switchmap.html), we can map each value to a new Observable; in this case a database query. + +```ts +const size$ = new Subject(); +const queryObservable = size$.pipe( + switchMap(size => + db.list('/items', ref => ref.orderByChild('size').equalTo(size)).valueChanges() + ) +); + +// subscribe to changes +queryObservable.subscribe(queriedItems => { + console.log(queriedItems); +}); + +// trigger the query +size$.next('large'); + +// re-trigger the query +size$.next('small'); +``` + +The following is an example of dynamic querying. [See this example in action on StackBlitz](https://stackblitz.com/edit/angularfire-db-api-s8ip7m). + +```ts +import { Component } from '@angular/core'; +import { AngularFireDatabase, AngularFireAction } from '@angular/fire/database'; +import { Observable, Subscription, BehaviorSubject } from 'rxjs'; +import { switchMap } from 'rxjs/operators'; + +@Component({ + selector: 'app-root', + template: `{%raw%} +

Firebase widgets!

+
+
    +
  • + {{ item.payload.val().text }} + {{ item.payload.key }} +
    • +
+
No results, try clearing filters
+
+ Loading… +
+

Filter by size

+ + + + + +
+ {%endraw%}`, +}) +export class AppComponent { + items$: Observable[]>; + size$: BehaviorSubject; + + constructor(db: AngularFireDatabase) { + this.size$ = new BehaviorSubject(null); + this.items$ = this.size$.pipe( + switchMap(size => + db.list('/items', ref => + size ? ref.orderByChild('size').equalTo(size) : ref + ).snapshotChanges() + ) + ); + } + filterBy(size: string|null) { + this.size$.next(size); + } +} +``` + +*To run the above example as is, you need to have sample data in you firebase database with the following structure:* + + ```json +{ + "items": { + "a" : { + "size" : "small", + "text" : "small thing" + }, + "b" : { + "size" : "medium", + "text" : "medium sample" + }, + "c" : { + "size" : "large", + "text" : "large widget" + } + } +} + ``` + diff --git a/site/src/rtdb/rtdb.11tydata.json b/site/src/rtdb/rtdb.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/rtdb/rtdb.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/shortcodes/buttons/index.js b/site/src/shortcodes/buttons/index.js new file mode 100644 index 000000000..a4761b1d3 --- /dev/null +++ b/site/src/shortcodes/buttons/index.js @@ -0,0 +1,33 @@ +/** + * Copyright 2020 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 linkButton = { + name: "linkbutton", + type: "addPairedShortcode", + create (content, href, type='primary', external=false) { + const primaryClass = `link-button inline-block shadow-lg bg-blue text-white text-lg uppercase font-bold font-display tracking-wide rounded-lg px-8 py-3 text-center`; + const secondaryClass = `link-button inline-block shadow-lg bg-blue-200 text-black text-lg uppercase font-bold font-display tracking-wide rounded-lg px-8 py-3 text-center`; + const cssClass = type === 'primary' ? primaryClass : secondaryClass; + const externalAttrs = external ? 'rel="noopener" target="blank"' : ''; + return `${content}`; + } +} + +module.exports = { + shortcodes: [ + linkButton, + ] +}; diff --git a/site/src/shortcodes/disclaimerprod/index.js b/site/src/shortcodes/disclaimerprod/index.js new file mode 100644 index 000000000..1fe9f9c81 --- /dev/null +++ b/site/src/shortcodes/disclaimerprod/index.js @@ -0,0 +1,33 @@ +/** + * Copyright 2020 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. + */ + +// Usage: {% disclaimerprod %} +const disclaimerprod = { + name: "disclaimerprod", + type: "addShortcode", + create() { + return `
+

Beta Site!

+

This is a brand new guide site that is in beta. During this time period we'd love to hear your feedback on our GitHub Discussion board. Please let us know what you think of the usability, content, and any ideas for improvement. All contributors are welcome!

+
`; + } +} + +module.exports = { + shortcodes: [ + disclaimerprod + ] +}; diff --git a/site/src/shortcodes/filters/index.js b/site/src/shortcodes/filters/index.js new file mode 100644 index 000000000..98d8916b9 --- /dev/null +++ b/site/src/shortcodes/filters/index.js @@ -0,0 +1,104 @@ +const console = require('console'); +const { resolve } = require('path'); + +const findByName = { + name: "findByName", + type: "addNunjucksFilter", + create(list, name) { + return list.find((item) => item.name === name); + } +}; + +const log = { + name: "log", + type: "addNunjucksFilter", + create(object, logName) { + console.log(logName, object); + return object; + } +}; + +const json = { + name: "json", + type: "addNunjucksFilter", + create(object, spacer = 3) { + let cache = []; + const json = JSON.stringify( + object, + (key, value) => { + if (typeof value === "object" && value !== null) { + if (cache.includes(value)) { + return; + } + cache.push(value); + } + return value; + }, + spacer + ); + cache = null; + return json; + } +}; + +const findPreviousEntry = { + name: "findPreviousEntry", + type: "addNunjucksFilter", + create(children, eleventyNavigation) { + const itemIndex = children.findIndex(entry => entry.key === eleventyNavigation.key); + const previousIndex = itemIndex - 1; + return children[previousIndex]; + } +}; + +const findNextEntry = { + name: "findNextEntry", + type: "addNunjucksFilter", + create(children, eleventyNavigation) { + const itemIndex = children.findIndex(entry => entry.key === eleventyNavigation.key); + const nextIndex = itemIndex + 1; + return children[nextIndex]; + } +}; + +/** + * This filter reads the custom navigation in the global _data/ folder + * and merges it with the eleventyNavigation config. Eleventy Navigation + * works great for parent folders but it's less good for child navigation + * when it comes to "next/prev" routing. This allows us to keep the good + * parts of Eleventy Navigation and have a custom child path routing. + * + * Eventually I'd like to customize Eleventy Navigation to do child routing + * because this is extremely inefficient to loop over nav for every page. It + * doesn't effect this build too bad though. + */ +const mergeNavigation = { + name: "mergeNavigation", + type: "addNunjucksFilter", + create(eleventyNavigation) { + const customNavigation = require(resolve(__dirname, '../../_data/nextprev.json')); + const customKeys = Object.keys(customNavigation); + customKeys.forEach(key => { + const eleventyNavMatch = eleventyNavigation.find(item => item.key === key); + if(eleventyNavMatch != undefined) { + const matchKids = eleventyNavMatch.children; + const newKids = customNavigation[key].children.map(child => { + return matchKids.find(c => c.key === child.key); + }); + eleventyNavigation.find(item => item.key === key).children = newKids; + } + }); + return eleventyNavigation; + } +} + +module.exports = { + shortcodes: [ + findByName, + log, + json, + findPreviousEntry, + findNextEntry, + mergeNavigation, + ], +}; diff --git a/site/src/shortcodes/headings/index.js b/site/src/shortcodes/headings/index.js new file mode 100644 index 000000000..57f1a72e0 --- /dev/null +++ b/site/src/shortcodes/headings/index.js @@ -0,0 +1,40 @@ +/** + * Copyright 2020 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. + */ + +// Usage: {% headingone %} My title! {% endheadingone %} +const headingOne = { + name: "headingone", + type: "addPairedShortcode", + create (content) { + return `

${ content }

` + } +}; + +const subHeading = { + name: "subheading", + type: "addPairedShortcode", + create (content) { + return `
${content}
`; + } +}; + +module.exports = { + shortcodes: [ + headingOne, + subHeading, + ] +}; + diff --git a/site/src/shortcodes/includecode/fetch.js b/site/src/shortcodes/includecode/fetch.js new file mode 100644 index 000000000..d122d5be2 --- /dev/null +++ b/site/src/shortcodes/includecode/fetch.js @@ -0,0 +1,33 @@ +/** + * Copyright 2020 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 fetch = require("node-fetch"); + +function convertToGitHubApiUrl(githubPath) { + const urlPieces = githubPath.split('/'); + const [user, repo] = urlPieces.slice(0, 2); + // TODO(davideast): Don't hardcode main branch + const githubApiUrl = [user, repo, 'master', ...urlPieces.slice(2, urlPieces.length)].join('/'); + return `https://raw.githubusercontent.com/${githubApiUrl}`; +} + +async function fetchCode(githubPath) { + const githubApiUrl = convertToGitHubApiUrl(githubPath); + const response = await fetch(githubApiUrl); + return response.text(); +} + +module.exports = { fetchCode }; diff --git a/site/src/shortcodes/includecode/from-local.js b/site/src/shortcodes/includecode/from-local.js new file mode 100644 index 000000000..9db02271b --- /dev/null +++ b/site/src/shortcodes/includecode/from-local.js @@ -0,0 +1,24 @@ +const { readFile } = require('fs'); +const { resolve } = require('path'); +const { promisify } = require('util'); +const readFileAsync = promisify(readFile); + +function convertGitHubPathToLocal(githubPath) { + return resolve(__dirname, '../../../repo_clones', githubPath); +} + +async function fetchCode(githubPath = '') { + let content = ''; + try { + const localPath = convertGitHubPathToLocal(githubPath); + content = await readFileAsync(localPath, 'utf-8'); + } catch(error) { + console.error(error); + content = 'File not found 😭'; + } + return content; +} + +module.exports = { + fetchCode, +}; diff --git a/site/src/shortcodes/includecode/index.js b/site/src/shortcodes/includecode/index.js new file mode 100644 index 000000000..3d0a6526d --- /dev/null +++ b/site/src/shortcodes/includecode/index.js @@ -0,0 +1,105 @@ +/** + * Copyright 2020 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 { fetchCode } = require('./from-local'); +const { processSnippet } = require('./snippets'); +const prism = require('markdown-it-prism'); +const MarkdownIt = require('markdown-it'); +const md = new MarkdownIt({ html: true }); +md.use(prism); + +function embedInCodeticks(code) { + return '```js\n' + code + '\n```'; +} + +// Usage: {% includecode github_path="firebase/snippets-web/snippets/auth-next/anonymous/auth_anon_sign_in.js" %} +const includecode = { + name: "includecode", + type: "addNunjucksAsyncShortcode", + create({ github_path }) { + return fetchCode(github_path) + .then(processSnippet) + .then(embedInCodeticks) + .then(output => md.render(output)); + } +}; + +// Usage: {% codeswitcher eap_github_path="" current_github_path="" %} +const codeswitcher = { + name: "codeswitcher", + type: "addNunjucksAsyncShortcode", + async create({ eap_github_path, current_github_path }) { + + let eapCode = ''; + if(eap_github_path != undefined && eap_github_path !== '') { + eapCode = await fetchCode(eap_github_path); + eapCode = processSnippet(eapCode); + eapCode = embedInCodeticks(eapCode); + eapCode = md.render(eapCode); + eapCode = eapCode.trim(); + } + + let currentCode = ''; + if(current_github_path != undefined && current_github_path !== '') { + currentCode = await fetchCode(current_github_path); + currentCode = processSnippet(currentCode); + currentCode = embedInCodeticks(currentCode); + currentCode = md.render(currentCode); + eapCode = eapCode.trim(); + } + const eapId = Math.random().toString(36).substring(7); + const currentId = Math.random().toString(36).substring(7); + return /*html*/` + + + + + + ${eapCode} + + +`; + } +}; + +// Usage: {% commonexample title="" eap_github_path="" current_github_path="" %} +const commonexample = { + name: "commonexample", + type: "addNunjucksAsyncShortcode", + async create({ title, eap_github_path, current_github_path, github_path }) { + const isEmpty = value => value == undefined || value === ''; + const isSwitcher = (!isEmpty(eap_github_path) || !isEmpty(github_path)) && !isEmpty(current_github_path); + // TODO(davideast): Enable current_github_path as a single option + const pathToUse = !isEmpty(github_path) ? github_path : eap_github_path; + const codebox = isSwitcher ? + await codeswitcher.create({ eap_github_path: pathToUse, current_github_path }) : + await includecode.create({ github_path: pathToUse }); + return md.render(`### ${title} +${codebox}`); + } +}; + +module.exports = { + shortcodes: [ + includecode, + codeswitcher, + commonexample, + ] +}; diff --git a/site/src/shortcodes/includecode/snippets.js b/site/src/shortcodes/includecode/snippets.js new file mode 100644 index 000000000..476ddf334 --- /dev/null +++ b/site/src/shortcodes/includecode/snippets.js @@ -0,0 +1,73 @@ +// Modified from: https://github.com/firebase/snippets-web/blob/master/scripts/separate-snippets.ts + +// Regex for [START] and [END] snippet tags. +const RE_START_SNIPPET = /\[START\s+([A-Za-z_]+)\s*\]/; +const RE_END_SNIPPET = /\[END\s+([A-Za-z_]+)\s*\]/; + +function isBlank(line) { + return line.trim().length === 0; +} + +/** + * Change all [START foo] and [END foo] to be [START foosuffix] and [END foosuffix] + */ +function removeSectionsFromSnippet(lines/* string[]*/) { + const outputLines = []; + for (const line of lines) { + if (!line.match(RE_START_SNIPPET) && !line.match(RE_END_SNIPPET)) { + outputLines.push(line); + } + } + return outputLines; +} + +/** + * Remove all left-padding so that the least indented line is left-aligned. + */ +function adjustIndentation(lines /*: string[]*/) { + const nonBlankLines = lines.filter((l) => !isBlank(l)); + const indentSizes = nonBlankLines.map((l) => l.length - l.trimLeft().length); + const minIndent = Math.min(...indentSizes); + + const outputLines = []; + for (const line of lines) { + if (isBlank(line)) { + outputLines.push(""); + } else { + outputLines.push(line.substr(minIndent)); + } + } + return outputLines; +} + +/** + * If the first line after leading comments is blank, remove it. + */ +function removeFirstLineAfterComments(lines /*: string[]*/) { + const outputLines = [...lines]; + const firstNonComment = outputLines.findIndex( + (l) => l.startsWith("// [START") + ); + return outputLines.slice(firstNonComment, outputLines.length); +} + +/** + * Turns a series of source lines into a standalone snippet file by running + * a series of transformations. + * + * @param cones the code containing the snippet (including START/END comments) + */ +function processSnippet(code /*: string[]*/) /*: string*/ { + const lines = code.split('\n'); + let outputLines = [...lines]; + + // Perform transformations individually, in order + outputLines = removeFirstLineAfterComments(outputLines); + outputLines = removeSectionsFromSnippet(outputLines); + outputLines = adjustIndentation(outputLines); + + const content = [...outputLines].join("\n"); + return content; +} + +module.exports = { processSnippet }; diff --git a/site/src/shortcodes/includecode/transform.js b/site/src/shortcodes/includecode/transform.js new file mode 100644 index 000000000..f90ac78c2 --- /dev/null +++ b/site/src/shortcodes/includecode/transform.js @@ -0,0 +1,65 @@ +/** + * Copyright 2020 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 { parse } = require("@babel/parser") +const generate = require('@babel/generator').default; +const prettier = require("prettier"); + +function transform(githubCode) { + const parsedAST = parse(githubCode, { + sourceType: "module", + }); + + const isFirst = index => index === 0; + + parsedAST.program.body.forEach((statement, index) => { + + // The first set of lines usually have comments and we + // always want them removed + if(isFirst(index)) { + // Remove all comments before leading statement + if(statement.leadingComments) { + delete statement.leadingComments; + } + } + + // Find any [START] or [END] + if(statement.leadingComments) { + statement.leadingComments = statement.leadingComments.filter(comment => { + return !comment.value.includes('[START') && !comment.value.includes('[END'); + }); + } + + // Remove any trailing comments because they likely should be + // leading comments. Babel guesses where comments go and you can + // find a comment as both trailing and leading. This will likely + // cause problems in the future, but right now it works with the + // code samples we use. + if(statement.trailingComments) { + statement.trailingComments = []; + } + }); + + const { code } = generate({ + type: "Program", + // passing a new copy of the body to avoid + // any reference problems + body: parsedAST.program.body.slice(), + }); + return prettier.format(code, { parser: "babel" }); +} + +module.exports = { transform }; diff --git a/site/src/shortcodes/index.js b/site/src/shortcodes/index.js new file mode 100644 index 000000000..2d019e878 --- /dev/null +++ b/site/src/shortcodes/index.js @@ -0,0 +1,41 @@ +/** + * Copyright 2020 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 { readdirSync, lstatSync } = require('fs'); +const { resolve } = require('path'); + +/** + * This sets up the shortcodes plugin to dynamically register + * any shortcode in this directory, as long as it is is in + * its own directory, exported in an index.js with an exports + * of an array of shortcodes. + * + * Example: + * / shortcodes + * / includecode + * + index.js + * module.exports = { shortcodes: [...] } + */ + +const shortcodes = readdirSync(__dirname) + .map(relativePath => resolve(__dirname, relativePath)) + .filter(absolutePath => lstatSync(absolutePath).isDirectory()) + .map(path => require(path).shortcodes) + .flat(); + +module.exports = { + shortcodes +}; diff --git a/site/src/shortcodes/version/index.js b/site/src/shortcodes/version/index.js new file mode 100644 index 000000000..977491152 --- /dev/null +++ b/site/src/shortcodes/version/index.js @@ -0,0 +1,30 @@ +/** + * Copyright 2020 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. + */ + +// Usage: {% version %} +const version = { + name: "version", + type: "addShortcode", + create () { + return Date.now().toString(); + } +}; + +module.exports = { + shortcodes: [ + version, + ] +}; diff --git a/site/src/storage/getting-started.md b/site/src/storage/getting-started.md new file mode 100644 index 000000000..ec28292ac --- /dev/null +++ b/site/src/storage/getting-started.md @@ -0,0 +1,257 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Storage +--- + + +## Using AngularFireStorage + +Cloud Storage is designed to help you quickly and easily store and serve user-generated content, such as photos and videos. + +## Import the `NgModule` + +Cloud Storage for AngularFire is contained in the `@angular/fire/storage` module namespace. Import the `AngularFireStorageModule` in your `NgModule`. This sets up the `AngularFireStorage` service for dependency injection. + +```ts +import { BrowserModule } from '@angular/platform-browser'; +import { NgModule } from '@angular/core'; +import { AppComponent } from './app.component'; +import { AngularFireModule } from '@angular/fire'; +import { AngularFireStorageModule } from '@angular/fire/storage'; +import { environment } from '../environments/environment'; + +@NgModule({ + imports: [ + BrowserModule, + AngularFireModule.initializeApp(environment.firebase), + AngularFireStorageModule + ], + declarations: [ AppComponent ], + bootstrap: [ AppComponent ] +}) +export class AppModule {} +``` + +The `BUCKET` injection token can be used to customise the storage bucket. + +```ts +import {AngularFireStorageModule, BUCKET } from '@angular/fire/storage'; + +@NgModule({ + providers: [ + { provide: BUCKET, useValue: 'my-bucket-name' } + ], + ... +}) +export class AppModule {} +``` + +## Injecting the AngularFireStorage service + +Once the `AngularFireStorageModule` is registered you can inject the `AngularFireStorage` service. + +```ts +import { Component } from '@angular/core'; +import { AngularFireStorage } from '@angular/fire/storage'; + +@Component({ + selector: 'app-component', + template: `` +}) +export class AppComponent { + constructor(private storage: AngularFireStorage) { } +} +``` + +## Uploading blobs + +There are three options for uploading files. + + +| method | | +| ---------|--------------------| +| `put(data: Blob, metadata?: storage.UploadMetadata): AngularFireUploadTask` | Starts the upload of the blob to the storage reference's path. Returns an `AngularFireUploadTask` for upload monitoring. | +| `putString(data: string, format?: StringFormat, metadata?: UploadMetadata): AngularFireUploadTask` | Updates an existing item in the array. Accepts a key, database reference, or an unwrapped snapshot. | +| `upload(path: string, data: StringFormat, metadata?: UploadMetadata): AngularFireUploadTask` | Upload or update a new file to the storage reference's path. Returns an `AngularFireUploadTask` for upload monitoring. | + +## Uploading blobs with put + +```ts +import { Component } from '@angular/core'; +import { AngularFireStorage } from '@angular/fire/storage'; + +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private storage: AngularFireStorage) { } + uploadFile(event) { + const file = event.target.files[0]; + const filePath = 'name-your-file-path-here'; + const ref = this.storage.ref(filePath); + const task = ref.put(file); + } +} +``` + +## Uploading blobs with putString + +```ts +import { Component } from '@angular/core'; +import { AngularFireStorage } from '@angular/fire/storage'; + +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private storage: AngularFireStorage) { } + uploadFile(event) { + const file = event.target.files[0]; + const filePath = 'name-your-file-path-here'; + const ref = this.storage.ref(filePath); + const task = ref.putString(file); + } +} +``` + +## Uploading files with upload + +```ts +import { Component } from '@angular/core'; +import { AngularFireStorage } from '@angular/fire/storage'; + +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private storage: AngularFireStorage) { } + uploadFile(event) { + const file = event.target.files[0]; + const filePath = 'name-your-file-path-here'; + const task = this.storage.upload(filePath, file); + } +} +``` + +## Monitoring upload percentage + +An `AngularFireUploadTask` has methods for observing upload percentage as well as the final download URL. + +| method | | +| ---------|--------------------| +| `snapshotChanges(): Observable` | Emits the raw `UploadTaskSnapshot` as the file upload progresses. | +| `percentageChanges(): Observable` | Emits the upload completion percentage. | +| `getDownloadURL(): Observable` | Emits the download url when available | + +The method `getDownloadURL()` doesn't rely on the task anymore, hence, in order to get the url we should use the finalize method from RxJS on top of the storage ref. + +```ts +import { finalize } from 'rxjs/operators'; + +@Component({ + selector: 'app-root', + template: `{%raw%} + +
{{ uploadPercent | async }}
+ {{ downloadURL | async }} + {%endraw%}` +}) +export class AppComponent { + uploadPercent: Observable; + downloadURL: Observable; + constructor(private storage: AngularFireStorage) {} + uploadFile(event) { + const file = event.target.files[0]; + const filePath = 'name-your-file-path-here'; + const fileRef = this.storage.ref(filePath); + const task = this.storage.upload(filePath, file); + + // observe percentage changes + this.uploadPercent = task.percentageChanges(); + // get notified when the download URL is available + task.snapshotChanges().pipe( + finalize(() => this.downloadURL = fileRef.getDownloadURL() ) + ) + .subscribe() + } +} +``` + +## Downloading Files + +A convenient pipe exists for simple in page references. + +```ts +@Component({ + selector: 'app-root', + template: `` +}) +export class AppComponent {} +``` + +To download a file you'll need to create a reference and call the `getDownloadURL()` method on an `AngularFireStorageReference`. + +```ts +@Component({ + selector: 'app-root', + template: `` +}) +export class AppComponent { + profileUrl: Observable; + constructor(private storage: AngularFireStorage) { + const ref = this.storage.ref('users/davideast.jpg'); + this.profileUrl = ref.getDownloadURL(); + } +} +``` + +## Managing Metadata + +Cloud Storage for Firebase allows you to upload and download metadata associated with files. This is useful because you can store important metadata and download it without needing to download the entire file. + +### Downloading metadata + +```ts +@Component({ + selector: 'app-root', + template: `{%raw%}
{{ meta | async }}
{%endraw%}` +}) +export class AppComponent { + meta: Observable; + constructor(private storage: AngularFireStorage) { + const ref = this.storage.ref('users/davideast.jpg'); + this.meta = ref.getMetadata(); + } +} +``` + +### Uploading metadata with files + +```ts +@Component({ + selector: 'app-root', + template: ` + + ` +}) +export class AppComponent { + constructor(private storage: AngularFireStorage) {} + uploadFile(event) { + const file = event.target.files[0]; + const filePath = 'name-your-file-path-here'; + const ref = this.storage.ref(filePath); + const task = ref.put(file, { customMetadata: { blah: 'blah' } }); + } +} +``` diff --git a/site/src/storage/index.md b/site/src/storage/index.md new file mode 100644 index 000000000..08ae2d15e --- /dev/null +++ b/site/src/storage/index.md @@ -0,0 +1,6 @@ +--- +eleventyNavigation: + key: Storage + order: 6 +--- + diff --git a/site/src/storage/storage.11tydata.json b/site/src/storage/storage.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/storage/storage.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/site/src/styles/prism.css b/site/src/styles/prism.css new file mode 100644 index 000000000..23874e8ce --- /dev/null +++ b/site/src/styles/prism.css @@ -0,0 +1,187 @@ +/** + * Copyright 2021 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. + */ + +/** + * prism.js custom theme for JavaScript, CSS and HTML + * Based on default theme + */ + + code[class*="language-"] { + padding: 0; +} + +code[class*="language-"], +pre[class*="language-"] { + color: aliceblue; + background: none; + font-size: 14px; + font-family: 'Roboto Mono', monospace; + font-weight: 400; + text-align: left; + white-space: pre; + word-spacing: normal; + word-break: normal; + word-wrap: normal; + line-height: 1.5; + + -moz-tab-size: 4; + -o-tab-size: 4; + tab-size: 4; + + -webkit-hyphens: none; + -moz-hyphens: none; + -ms-hyphens: none; + hyphens: none; +} + +code[class*="language-css"], +pre[class*="language-css"], +code[class*="language-html"], +pre[class*="language-html"] { + color: #d0d2d1 !important; +} + +code[class*="language-html"].token.punctuation, +pre[class*="language-html"].token.punctuation { + color: #4dd0e1 !important; +} + +pre[class*="language-"]::-moz-selection, pre[class*="language-"] ::-moz-selection, +code[class*="language-"]::-moz-selection, code[class*="language-"] ::-moz-selection { + text-shadow: none; + background: hsl(213, 92%, 85%); + opacity: 0.4; +} + +pre[class*="language-"]::selection, pre[class*="language-"] ::selection, +code[class*="language-"]::selection, code[class*="language-"] ::selection { + text-shadow: none; + background: #b3d4fc; + opacity: 0.4; +} + +@media print { + code[class*="language-"], + pre[class*="language-"] { + text-shadow: none; + } +} + +/* Code blocks */ +pre[class*="language-"] { + padding: 1em; + overflow: auto; +} + +:not(pre) > code[class*="language-"], +pre[class*="language-"] { + border-radius: 8px; + background-color: #283142; + margin-bottom: 2rem; + margin-top: 2rem; + /*TODO:(davideast) We have to set the max-width of the codeblock because + it causes the content to break out of the viewport. The "break out" + causes those annoying x axis overflows and scrolling on mobile devices. + Ideally there's a better solution. + */ + max-width:100%; +} + +/* Inline code */ +:not(pre) > code[class*="language-"] { + padding: .1em; + border-radius: .3em; + white-space: normal; +} + +.token.comment, +.token.prolog, +.token.doctype, +.token.cdata { + color: #f06292; +} + +.token.punctuation { + color: aliceblue; +} + +.namespace { + opacity: .7; +} + +.token.function, +.token.property { + color: #4dd0e1; +} + +.token.boolean, +.token.number, +.token.constant, +.token.symbol, +.token.deleted { + color: #9ccc65; +} + +.token.tag, +.token.selector, +.token.string, +.token.char, +.token.builtin, +.token.inserted { + color: #9ccc65; +} + +.token.attr-name, +.token.operator, +.token.entity, +.token.url, +.language-css .token.string, +.style .token.string { + color: #9ccc65; +} + +.token.atrule, +.token.attr-value, +.token.keyword { + color: #4dd0e1; +} + +.token.class-name { + color: #4dd0e1; +} + +.token.regex, +.token.important, +.token.variable { + color: #4dd0e1; +} + +.token.bold { + font-weight: bold; +} +.token.italic { + font-style: italic; +} + +.token.entity { + cursor: help; +} + +eap-tab-panel :not(pre) > code[class*="language-"], +eap-tab-panel pre[class*="language-"] { + padding: 0; + margin: 0; +} diff --git a/site/src/styles/tailwind.config.js b/site/src/styles/tailwind.config.js new file mode 100644 index 000000000..5103d1bb0 --- /dev/null +++ b/site/src/styles/tailwind.config.js @@ -0,0 +1,50 @@ +/** + * Copyright 2021 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. + */ +module.exports = { + purge: [ + "src/**/*.njk", + "src/**/*.md", + "src/**/*.js", + ], + darkMode: false, // or 'media' or 'class' + theme: { + fontFamily: { + body: ['Roboto', 'Arial', 'sans-serif'], + display: ['Google Sans', 'Arial', 'sans-serif'], + mono: ['Roboto Mono', 'monospace'], + }, + extend: { + colors: { + 'black': 'hsl(0 0% 0% / 87%)', + 'blue-200': 'hsl(214 82% 50% / 7%)', + 'blue': 'hsl(214 82% 50%)', + 'navy': '#283142', + 'grey': '#DADCE0', + 'grey-200': '#ECEFF1', + 'grey-300': 'hsl(0 0% 0% / 54%)', + 'grey-600': 'hsl(213 5% 39% / 1)', + 'grey-700': 'hsl(213 5% 19% / 1)', + 'yellow': 'hsl(37 100% 94%)', + 'orange': "#FF8F00", + 'green': '#6CFF38', + } + }, + }, + variants: { + extend: {}, + }, + plugins: [], +} \ No newline at end of file diff --git a/site/src/styles/tailwind.css b/site/src/styles/tailwind.css new file mode 100644 index 000000000..39284b1a0 --- /dev/null +++ b/site/src/styles/tailwind.css @@ -0,0 +1,331 @@ +/** + * Copyright 2021 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 "https://github.com/tailwindcss/base"; + @import "https://github.com/tailwindcss/components"; + @import "https://github.com/tailwindcss/utilities"; + + @font-face { + font-family: 'Google Sans'; + font-style: normal; + font-weight: 400; + src: url('https://github.com/assets/GoogleSans-Regular.woff2') format('woff2'); + } + + @font-face { + font-family: 'Google Sans'; + font-style: normal; + font-weight: 500; + src: url('https://github.com/assets/GoogleSans-Medium.woff2') format('woff2'); + } + + @font-face { + font-family: 'Google Sans'; + font-style: bold; + font-weight: 900; + src: url('https://github.com/assets/GoogleSans-Bold.woff2') format('woff2'); + } + + @font-face { + font-family: 'Roboto'; + font-style: normal; + font-weight: 400; + src: url('https://github.com/assets/Roboto-Regular.woff2') format('woff2'); + } + + @font-face { + font-family: 'Roboto'; + font-style: italic; + font-weight: 400; + src: url('https://github.com/assets/Roboto-Italic.woff2') format('woff2'); + } + + @font-face { + font-family: 'Roboto'; + font-style: bold; + font-weight: 900; + src: url('https://github.com/assets/Roboto-900.woff2') format('woff2'); + } + + @font-face { + font-family: 'Roboto Mono'; + font-style: normal; + font-weight: 400; + src: url('https://github.com/assets/RobotoMono-Regular.woff2') format('woff2'); + } + + body { + background-color: hsl(255 1% 98%); + background-image: url(https://github.com/assets/corner.svg); + background-position: top right; + background-repeat: no-repeat; + width: 100vw; + } + + a[aria-current="page"] { + @apply text-blue; + } + + .docs-content main { + @apply grid min-h-screen; + grid-template-columns:[side] auto 1fr [stack]; + grid-template-rows: [side] 1fr; + column-gap: 8vw; + } + + .docs-content main > aside { + min-width: 32ch; + @apply sticky top-0 z-10 h-screen pl-8 pr-4 overflow-y-scroll; + } + + .docs-content main > article { + max-width: 64ch; + @apply min-h-screen pr-8; + } + + h1, h2, h3, h4, h5, h6 { + @apply font-display; + } + + h1 { + @apply text-5xl font-bold font-display; + } + + .docs-content main > article h2 { + @apply mt-12 mb-4 antialiased font-bold leading-snug text-black; + font-size: 24px; + } + + .docs-content main > article h3 { + @apply mt-8 text-xl; + } + + .docs-content main > article h4 { + @apply mt-2 text-lg leading-snug text-grey-600; + } + + .docs-content main > article p { + @apply mb-6 text-lg; + line-height: 2rem; + } + + /** + Don't go further than direct descendants for code styling + otherwise it will mess with the codeboxes + */ + .docs-content main > article p > code { + @apply p-1 bg-gray-200 rounded-md; + } + + .docs-content article p > b { + @apply font-display; + } + + .docs-content article ol, .docs-content article ul:not(.prevnext-grid) { + list-style-type: initial; + padding: 0 2rem; + margin: 1rem 0; +} + + table a, article p > a:not(.link-button) { + @apply underline text-blue; + } + + .annotations-section p { + @apply text-sm !important; + line-height: 1.35rem !important; + } + + @media (max-width: 775px) { + + .docs-content main { + column-gap: unset; + } + + .docs-content main > article { + @apply w-screen p-2; + } + + .docs-content main > aside, + .docs-content main > article { + grid-area: side; + } + + .docs-content main > aside { + transition: transform 0.25s cubic-bezier(0.445, 0.05, 0.55, 0.95); + transform: translateX(-200%); + } + + .docs-content main > aside.slideIn { + transform: translateX(0); + } + + .landing-container, .landing-faq { + width: 100vw !important; + padding-left: 2rem; + padding-right: 2rem; + } + + } + + @media (max-width: 420px) { + .landing-container h1 { + @apply text-4xl; + } + body.landing-content { + background-image: none; + } + } + + /* Thanks to https://css-tricks.com/responsive-data-tables/ */ + table { + width: 100%; + border-collapse: collapse; + overflow-x: scroll; + overflow-wrap: break-word; + @apply text-sm; + } + /* Zebra striping */ + tr:nth-of-type(odd) { + @apply bg-gray-100; + } + th { + @apply font-bold tracking-wide uppercase font-display; + } + td, th { + @apply p-2 text-left; + } + + @media + only screen and (max-width: 760px), + (min-device-width: 768px) and (max-device-width: 1024px) { + + /* Stack the table */ + table, thead, tbody, th, td, tr { + display: block; + } + + } + + eap-tab-switcher { + @apply block w-full overflow-x-hidden bg-navy rounded-t-md; + } + + .docs-content article eap-tab-switcher { + @apply mb-6; + } + + eap-tab-list { + @apply flex items-center h-16 bg-white border border-solid border-grey rounded-t-md font-display; + } + + eap-tab-list button { + @apply p-4 text-sm font-medium text-gray-600; + } + + eap-tab-list button[aria-selected="true"] { + @apply text-blue; + } + + eap-tab-panel-list { + @apply block p-4 overflow-x-scroll; + } + + eap-tab-panel { + @apply block; + } + + eap-tab-panel pre code { + @apply bg-navy; + } + + eap-tab-panel { + @apply text-white; + } + + .docs-content h3 + pre[class*="language-"], h3 + eap-tab-switcher { + margin-top: .5rem; + } + + eap-click-card { + @apply block; + } + + .landing-container { + width: 84ch; + margin: 0 auto; + } + + .landing-faq { + width: 64ch; + } + + .code-editor { + display: grid; + } + + .code-editor pre[class="language-js"] { + border-radius: 0; + margin: 0; + padding: 2rem; + } + + .code-editor .terminal { + height: 100%; + padding: 1rem; + } + + .code-editor .terminal div { + opacity: 0; + overflow: hidden; + margin: 1rem; + } + + .code-editor .terminal div:nth-child(2) { + animation: fadeIn 400ms cubic-bezier(0.47, 0, 0.745, 0.715) 2.5s forwards; + } + + .code-editor .terminal div:nth-child(3) { + animation: fadeIn 400ms cubic-bezier(0.47, 0, 0.745, 0.715) 4s forwards; + } + + .code-editor .terminal div:nth-child(4) { + animation: fadeIn 400ms cubic-bezier(0.47, 0, 0.745, 0.715) 5.5s forwards; + } + + .code-editor .terminal div:nth-child(5), #btnShowCode { + animation: fadeIn 400ms cubic-bezier(0.47, 0, 0.745, 0.715) 7.5s forwards; + } + + /* Thanks to https://css-tricks.com/snippets/css/typewriter-effect/ */ + .terminal .typewriter { + overflow: hidden; /* Ensures the content is not revealed until the animation */ + white-space: nowrap; /* Keeps the content on a single line */ + margin: 0 auto; /* Gives that scrolling effect as the typing happens */ + letter-spacing: .1em; /* Adjust as needed */ + animation: typing 3.65s steps(40, end) 1s forwards; + } + + /* The typing effect */ + @keyframes typing { + from { opacity:1; width: 0 } + to { width: 100%; opacity:1; } + } + + @keyframes fadeIn { + from { opacity: 0 } + to { opacity: 1; } + } \ No newline at end of file diff --git a/site/src/universal/cloud-functions.md b/site/src/universal/cloud-functions.md new file mode 100644 index 000000000..780edd4a2 --- /dev/null +++ b/site/src/universal/cloud-functions.md @@ -0,0 +1,79 @@ +--- +title: Cloud Functions +eleventyNavigation: + key: Cloud Functions + parent: Universal +--- + +## Deploying on Universal sites on Cloud Functions + +After [setting up your application with Angular Universal as outlined in Getting Started](getting-started.md), you're now ready to build your application for Firebase Hosting & Cloud Functions. + +Cloud Functions for Firebase lets you automatically run backend code in response to events triggered by Firebase features and HTTPS requests. Your code is stored in Google's cloud and runs in a managed environment. There's no need to manage and scale your own servers. [Learn more about Cloud Functions for Firebase](https://firebase.google.com/docs/functions/). + +If you don't already have the Firebase CLI installed, do so: + +```bash +npm i -g firebase-tools +firebase login +``` + +Then inside your project root, setup your Firebase CLI project: + +```bash +firebase init +``` + +Configure whichever features you'd want to manage but make sure to select at least `functions` and `hosting`. Choose Typescript for Cloud Functions and use the default `public` directory for Hosting. + +After you're configured, you should now see a `firebase.json` file in your project root. Let's add the following `rewrites` directive to it: + +```js +{ + // ... + "hosting": { + // ... + "rewrites": [ + { "source": "**", "function": "universal" } + ] + } +} +``` + +This will inform Firebase Hosting that it should proxy all requests to Cloud Functions, if a file isn't already present in the hosting directory. Let's go ahead and modify your `package.json` to build for Cloud Functions: + +```js +"scripts": { + // ... omitted + "build": "ng build && npm run copy:hosting && npm run build:ssr && npm run build:functions", + "copy:hosting": "cp -r ./dist/YOUR_PROJECT_NAME/* ./public && rm ./public/index.html", + "build:functions": "npm run --prefix functions build" +}, +``` + +Change the build script in your `functions/package.json` to the following: + +```js +"scripts": { + // ... omitted + "build": "rm -r ./dist && cp -r ../dist . && tsc", +} +``` + +Finally, add the following to your `functions/src/index.ts`: + +```ts +export const universal = functions.https.onRequest((request, response) => { + require(`${process.cwd()}/dist/YOUR_PROJECT_NAME-webpack/server`).app(request, response); +}); +``` + +We you should now be able to run `npm run build` to build your project for Firebase Hosting and Cloud Functions. + +To test, spin up the emulator with `firebase serve`. Once you've confirmed it's working go ahead and `firebase deploy`. + +## Additional Resources + +- [Universal Starter Template](https://github.com/angular/universal-starter) +- [FireShip: Angular Universal SSR with Firebase](https://fireship.io/lessons/angular-universal-firebase/) + diff --git a/site/src/universal/getting-started.md b/site/src/universal/getting-started.md new file mode 100644 index 000000000..52bfa6536 --- /dev/null +++ b/site/src/universal/getting-started.md @@ -0,0 +1,158 @@ +--- +title: Getting started +eleventyNavigation: + key: Getting started + parent: Universal +--- + +## Getting started with AngularFire and Universal + +Server-side rendering (SSR) is the process of converting a JavaScript app to plain HTML at request-time, allowing search engine crawlers and linkbots to understand page content reliably. + +## Prerequisites + +- `@angular/cli >= v6.0` +- `@angular/fire >= v5.0.0` + +## Generate the Angular Universal Server Module + +First, create a server module with the Angular CLI. + +```bash +ng generate universal --client-project +``` + +## Build a Server with ExpressJS + +[ExpressJS](https://expressjs.com/) is a lightweight web framework that can serve http requests in Node. First, install the dev dependencies: + +```bash +npm install --save-dev @nguniversal/express-engine @nguniversal/module-map-ngfactory-loader express webpack-cli ts-loader ws xhr2 +``` + +Create a file called `server.ts` in the root of you project. + +```ts +// These are important and needed before anything else +import 'zone.js/dist/zone-node'; +import 'reflect-metadata'; + +import { enableProdMode } from '@angular/core'; +import { ngExpressEngine } from '@nguniversal/express-engine'; +import { provideModuleMap } from '@nguniversal/module-map-ngfactory-loader'; + +import * as express from 'express'; +import { join } from 'path'; +import { readFileSync } from 'fs'; + +// Polyfills required for Firebase +(global as any).WebSocket = require('ws'); +(global as any).XMLHttpRequest = require('xhr2'); + +// Faster renders in prod mode +enableProdMode(); + +// Export our express server +export const app = express(); + +const DIST_FOLDER = join(process.cwd(), 'dist'); +const APP_NAME = 'YOUR_PROJECT_NAME'; // TODO: replace me! + +const { AppServerModuleNgFactory, LAZY_MODULE_MAP } = require(`./dist/${APP_NAME}-server/main`); + +// index.html template +const template = readFileSync(join(DIST_FOLDER, APP_NAME, 'index.html')).toString(); + +app.engine('html', ngExpressEngine({ + bootstrap: AppServerModuleNgFactory, + providers: [ + provideModuleMap(LAZY_MODULE_MAP) + ] +})); + +app.set('view engine', 'html'); +app.set('views', join(DIST_FOLDER, APP_NAME)); + +// Serve static files +app.get('*.*', express.static(join(DIST_FOLDER, APP_NAME))); + +// All regular routes use the Universal engine +app.get('*', (req, res) => { + res.render(join(DIST_FOLDER, APP_NAME, 'index.html'), { req }); +}); + +// If we're not in the Cloud Functions environment, spin up a Node server +if (!process.env.FUNCTION_NAME) { + const PORT = process.env.PORT || 4000; + app.listen(PORT, () => { + console.log(`Node server listening on http://localhost:${PORT}`); + }); +} +``` + +## Add a Webpack Config for the Express Server + +Create a new file named `webpack.server.config.js` to bundle the express app from previous step. + + +```js +const path = require('path'); +const webpack = require('webpack'); + +const APP_NAME = 'YOUR_PROJECT_NAME'; // TODO: replace me! + +module.exports = { + entry: { server: './server.ts' }, + resolve: { extensions: ['.js', '.ts'] }, + mode: 'development', + target: 'node', + externals: [ + /* Firebase has some troubles being webpacked when in + in the Node environment, let's skip it. + Note: you may need to exclude other dependencies depending + on your project. */ + /^firebase/ + ], + output: { + // Export a UMD of the webpacked server.ts & deps, for + // rendering in Cloud Functions + path: path.join(__dirname, `dist/${APP_NAME}-webpack`), + library: 'app', + libraryTarget: 'umd', + filename: '[name].js' + }, + module: { + rules: [ + { test: /\.ts$/, loader: 'ts-loader' } + ] + }, + plugins: [ + new webpack.ContextReplacementPlugin( + /(.+)?angular(\\|\/)core(.+)?/, + path.join(__dirname, 'src'), // location of your src + {} // a map of your routes + ), + new webpack.ContextReplacementPlugin( + /(.+)?express(\\|\/)(.+)?/, + path.join(__dirname, 'src'), + {} + ) + ] +} +``` + +## Build Scripts + +Update your `package.json` with the following build scripts, replacing `YOUR_PROJECT_NAME` with the name of your project. + +```js +"scripts": { + // ... omitted + "build": "ng build && npm run build:ssr", + "build:ssr": "ng run YOUR_PROJECT_NAME:server && npm run webpack:ssr", + "webpack:ssr": "webpack --config webpack.server.config.js", + "serve:ssr": "node dist/YOUR_PROJECT_NAME-webpack/server.js" +}, +``` + +Test your app locally by running `npm run build && npm run serve:ssr`. diff --git a/site/src/universal/index.md b/site/src/universal/index.md new file mode 100644 index 000000000..b7d4c6329 --- /dev/null +++ b/site/src/universal/index.md @@ -0,0 +1,5 @@ +--- +eleventyNavigation: + key: Universal + order: 11 +--- diff --git a/site/src/universal/prerendering.md b/site/src/universal/prerendering.md new file mode 100644 index 000000000..60cd4360b --- /dev/null +++ b/site/src/universal/prerendering.md @@ -0,0 +1,80 @@ +--- +title: Prerendering +eleventyNavigation: + key: Prerendering + parent: Universal +--- + +## Prerendering Universal sites + +Prerendering a Universal application allows us to generate the HTML before the user requests it; increasing performance and decreasing cost. Let's configure your application to prerender and staticly serve it's most commonly accessed routes on Firebase Hosting. + +First create a `static.paths.js` in your project root, which lists the URLs you'd want to prerender: + +```js +export default [ + '/', + '/another_path', + '/yet_another_path' +]; +``` + +Install `mkdir-recursive` to make the next step a little easier: + +```bash +npm i --save-dev mkdir-recursive +``` + +Now replace the listener in your `server.ts` with the following: + +```ts +import { readFileSync, writeFileSync, existsSync } from 'fs'; +import { renderModuleFactory } from '@angular/platform-server'; +import { mkdirSync } from 'mkdir-recursive'; + +if (process.env.PRERENDER) { + + const routes = require('./static.paths').default; + Promise.all( + routes.map(route => + renderModuleFactory(AppServerModuleNgFactory, { + document: template, + url: route, + extraProviders: [ + provideModuleMap(LAZY_MODULE_MAP) + ] + }).then(html => [route, html]) + ) + ).then(results => { + results.forEach(([route, html]) => { + const fullPath = join('./public', route); + if (!existsSync(fullPath)) { mkdirSync(fullPath); } + writeFileSync(join(fullPath, 'index.html'), html); + }); + process.exit(); + }); + +} else if (!process.env.FUNCTION_NAME) { + + // If we're not in the Cloud Functions environment, spin up a Node server + const PORT = process.env.PORT || 4000; + app.listen(PORT, () => { + console.log(`Node server listening on http://localhost:${PORT}`); + }); + +} +``` + +Now if the `PRERENDER` environment variable is passed any value, instead of serving your application it will iterate over the paths in `static.paths.js`, render them, and write them to your `public` directory. *You could always make this a seperate script.* + +Finally make some modifications to your `package.json`, to prerender your content when you build: + +```js +"scripts": { + // ... omitted + "build": "ng build && npm run copy:hosting && npm run build:functions && npm run prerender:ssr", + "prerender:ssr": "PRERENDER=1 node dist/YOUR_PROJECT_NAME-webpack/server.js", +}, +``` + +Now when you run `npm run build` the prerendered content should be available in your `/public` directory, ready for deployment on Firebase Hosting. diff --git a/site/src/universal/universal.11tydata.json b/site/src/universal/universal.11tydata.json new file mode 100644 index 000000000..b924da1f3 --- /dev/null +++ b/site/src/universal/universal.11tydata.json @@ -0,0 +1,4 @@ +{ + "layout": "guide.njk", + "tags": "guides" +} diff --git a/src/ai/ai.module.ts b/src/ai/ai.module.ts new file mode 100644 index 000000000..444fd67b3 --- /dev/null +++ b/src/ai/ai.module.ts @@ -0,0 +1,79 @@ +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { AI as FirebaseAI } from 'firebase/ai'; +import { registerVersion } from 'firebase/app'; +import { AI, AIInstances, AI_PROVIDER_NAME } from './ai'; + +export const PROVIDED_AI_INSTANCES = new InjectionToken('angularfire2.ai-instances'); + +export function defaultAIInstanceFactory(provided: FirebaseAI[]|undefined, defaultApp: FirebaseApp) { + const defaultAI = ÉĩgetDefaultInstanceOf(AI_PROVIDER_NAME, provided, defaultApp); + return defaultAI && new AI(defaultAI); +} + +export function AIInstanceFactory(fn: (injector: Injector) => FirebaseAI) { + return (zone: NgZone, injector: Injector) => { + const ai = zone.runOutsideAngular(() => fn(injector)); + return new AI(ai); + }; +} + +const AI_INSTANCES_PROVIDER = { + provide: AIInstances, + deps: [ + [new Optional(), PROVIDED_AI_INSTANCES ], + ] +}; + +const DEFAULT_AI_INSTANCE_PROVIDER = { + provide: AI, + useFactory: defaultAIInstanceFactory, + deps: [ + [new Optional(), PROVIDED_AI_INSTANCES ], + FirebaseApp, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_AI_INSTANCE_PROVIDER, + AI_INSTANCES_PROVIDER, + ] +}) +export class AIModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'ai'); + } +} + +export function provideAI(fn: (injector: Injector) => FirebaseAI, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'ai'); + + return makeEnvironmentProviders([ + DEFAULT_AI_INSTANCE_PROVIDER, + AI_INSTANCES_PROVIDER, + { + provide: PROVIDED_AI_INSTANCES, + useFactory: AIInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + [new Optional(), AppCheckInstances ], + ...deps, + ] + } + ]); +} diff --git a/src/ai/ai.spec.ts b/src/ai/ai.spec.ts new file mode 100644 index 000000000..9b6fc1008 --- /dev/null +++ b/src/ai/ai.spec.ts @@ -0,0 +1,38 @@ +import { TestBed } from '@angular/core/testing'; +import { AI, getAI, provideAI } from '@angular/fire/ai'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +describe('AI', () => { + let app: FirebaseApp; + let ai: AI; + let providedAI: AI; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideAI(() => { + providedAI = getAI(getApp(appName)); + return providedAI; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + ai = TestBed.inject(AI); + }); + + it('should be injectable', () => { + expect(providedAI).toBeTruthy(); + expect(ai).toEqual(providedAI); + expect(ai.app).toEqual(app); + }); + + }); + +}); diff --git a/src/ai/ai.ts b/src/ai/ai.ts new file mode 100644 index 000000000..f0e4ffc86 --- /dev/null +++ b/src/ai/ai.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { AI as FirebaseAI } from 'firebase/ai'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AI extends FirebaseAI {} + +export class AI { + constructor(ai: FirebaseAI) { + return ai; + } +} + +export const AI_PROVIDER_NAME = 'AI'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AIInstances extends Array {} + +export class AIInstances { + constructor() { + return ÉĩgetAllInstancesOf(AI_PROVIDER_NAME); + } +} + +export const AIInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(AI_PROVIDER_NAME))), + distinct(), +); diff --git a/src/ai/firebase.ts b/src/ai/firebase.ts new file mode 100644 index 000000000..4e33d0635 --- /dev/null +++ b/src/ai/firebase.ts @@ -0,0 +1,14 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/ai'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + getAI as _getAI, + getGenerativeModel as _getGenerativeModel, + getImagenModel as _getImagenModel, + getVertexAI as _getVertexAI +} from 'firebase/ai'; + +export const getAI = ÉĩzoneWrap(_getAI, true); +export const getGenerativeModel = ÉĩzoneWrap(_getGenerativeModel, true); +export const getImagenModel = ÉĩzoneWrap(_getImagenModel, true); +export const getVertexAI = ÉĩzoneWrap(_getVertexAI, true); diff --git a/src/ai/ng-package.json b/src/ai/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/ai/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/ai/package.json b/src/ai/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/ai/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/ai/public_api.ts b/src/ai/public_api.ts new file mode 100644 index 000000000..aee859b99 --- /dev/null +++ b/src/ai/public_api.ts @@ -0,0 +1,3 @@ +export { AI, AIInstances, AIInstance$ } from './ai'; +export { provideAI, AIModule } from './ai.module'; +export * from './firebase'; diff --git a/src/analytics/analytics.module.ts b/src/analytics/analytics.module.ts new file mode 100644 index 000000000..f2552ffc5 --- /dev/null +++ b/src/analytics/analytics.module.ts @@ -0,0 +1,88 @@ +import { isPlatformBrowser } from '@angular/common'; +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + PLATFORM_ID, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { Analytics as FirebaseAnalytics } from 'firebase/analytics'; +import { registerVersion } from 'firebase/app'; +import { ANALYTICS_PROVIDER_NAME, Analytics, AnalyticsInstances } from './analytics'; +import { ScreenTrackingService } from './screen-tracking.service'; +import { UserTrackingService } from './user-tracking.service'; + +export const PROVIDED_ANALYTICS_INSTANCES = new InjectionToken('angularfire2.analytics-instances'); + +export function defaultAnalyticsInstanceFactory(provided: FirebaseAnalytics[]|undefined, defaultApp: FirebaseApp, platformId: object) { + if (!isPlatformBrowser(platformId)) { return null; } + const defaultAnalytics = ÉĩgetDefaultInstanceOf(ANALYTICS_PROVIDER_NAME, provided, defaultApp); + return defaultAnalytics && new Analytics(defaultAnalytics); +} + +export function analyticsInstanceFactory(fn: (injector: Injector) => FirebaseAnalytics) { + return (zone: NgZone, injector: Injector, platformId: object) => { + if (!isPlatformBrowser(platformId)) { return null; } + const analytics = zone.runOutsideAngular(() => fn(injector)); + return new Analytics(analytics); + }; +} + +const ANALYTICS_INSTANCES_PROVIDER = { + provide: AnalyticsInstances, + deps: [ + [new Optional(), PROVIDED_ANALYTICS_INSTANCES ], + ] +}; + +const DEFAULT_ANALYTICS_INSTANCE_PROVIDER = { + provide: Analytics, + useFactory: defaultAnalyticsInstanceFactory, + deps: [ + [new Optional(), PROVIDED_ANALYTICS_INSTANCES ], + FirebaseApp, + PLATFORM_ID, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_ANALYTICS_INSTANCE_PROVIDER, + ANALYTICS_INSTANCES_PROVIDER + ] +}) +export class AnalyticsModule { + constructor( + @Optional() _screenTrackingService: ScreenTrackingService, + @Optional() _userTrackingService: UserTrackingService, + ) { + registerVersion('angularfire', VERSION.full, 'analytics'); + } +} + +export function provideAnalytics(fn: (injector: Injector) => FirebaseAnalytics, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'analytics'); + + return makeEnvironmentProviders([ + DEFAULT_ANALYTICS_INSTANCE_PROVIDER, + ANALYTICS_INSTANCES_PROVIDER, + { + provide: PROVIDED_ANALYTICS_INSTANCES, + useFactory: analyticsInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + PLATFORM_ID, + ÉĩAngularFireSchedulers, + FirebaseApps, + ...deps, + ], + }, + ]); +} diff --git a/src/analytics/analytics.spec.ts b/src/analytics/analytics.spec.ts new file mode 100644 index 000000000..f2f6c8c72 --- /dev/null +++ b/src/analytics/analytics.spec.ts @@ -0,0 +1,38 @@ +import { TestBed } from '@angular/core/testing'; +import { Analytics, getAnalytics, provideAnalytics } from '@angular/fire/analytics'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { COMMON_CONFIG_TOO } from '../test-config'; +import { rando } from '../utils'; + +describe('Analytics', () => { + let app: FirebaseApp; + let analytics: Analytics; + let providedAnalytics: Analytics; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG_TOO, appName)), + provideAnalytics(() => { + providedAnalytics = getAnalytics(getApp(appName)); + return providedAnalytics; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + analytics = TestBed.inject(Analytics); + }); + + it('should be injectable', () => { + expect(providedAnalytics).toBeTruthy(); + expect(analytics).toEqual(providedAnalytics); + expect(analytics.app).toEqual(app); + }); + + }); + +}); diff --git a/src/analytics/analytics.ts b/src/analytics/analytics.ts new file mode 100644 index 000000000..3aabbe1a4 --- /dev/null +++ b/src/analytics/analytics.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { Analytics as FirebaseAnalytics } from 'firebase/analytics'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Analytics extends FirebaseAnalytics {} + +export class Analytics { + constructor(analytics: FirebaseAnalytics) { + return analytics; + } +} + +export const ANALYTICS_PROVIDER_NAME = 'analytics'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AnalyticsInstances extends Array {} + +export class AnalyticsInstances { + constructor() { + return ÉĩgetAllInstancesOf(ANALYTICS_PROVIDER_NAME); + } +} + +export const analyticInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(ANALYTICS_PROVIDER_NAME))), + distinct(), +); diff --git a/src/analytics/firebase.ts b/src/analytics/firebase.ts new file mode 100644 index 000000000..2c40e5612 --- /dev/null +++ b/src/analytics/firebase.ts @@ -0,0 +1,30 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/analytics'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + getAnalytics as _getAnalytics, + getGoogleAnalyticsClientId as _getGoogleAnalyticsClientId, + initializeAnalytics as _initializeAnalytics, + isSupported as _isSupported, + logEvent as _logEvent, + setAnalyticsCollectionEnabled as _setAnalyticsCollectionEnabled, + setConsent as _setConsent, + setCurrentScreen as _setCurrentScreen, + setDefaultEventParameters as _setDefaultEventParameters, + setUserId as _setUserId, + setUserProperties as _setUserProperties, + settings as _settings +} from 'firebase/analytics'; + +export const getAnalytics = ÉĩzoneWrap(_getAnalytics, true); +export const getGoogleAnalyticsClientId = ÉĩzoneWrap(_getGoogleAnalyticsClientId, true); +export const initializeAnalytics = ÉĩzoneWrap(_initializeAnalytics, true); +export const isSupported = ÉĩzoneWrap(_isSupported, false); +export const logEvent = ÉĩzoneWrap(_logEvent, false, 2); +export const setAnalyticsCollectionEnabled = ÉĩzoneWrap(_setAnalyticsCollectionEnabled, true, 2); +export const setConsent = ÉĩzoneWrap(_setConsent, true, 2); +export const setCurrentScreen = ÉĩzoneWrap(_setCurrentScreen, true, 2); +export const setDefaultEventParameters = ÉĩzoneWrap(_setDefaultEventParameters, true, 2); +export const setUserId = ÉĩzoneWrap(_setUserId, true, 2); +export const setUserProperties = ÉĩzoneWrap(_setUserProperties, true, 2); +export const settings = ÉĩzoneWrap(_settings, true); diff --git a/src/analytics/ng-package.json b/src/analytics/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/analytics/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/analytics/package.json b/src/analytics/package.json new file mode 100644 index 000000000..5e8aa1496 --- /dev/null +++ b/src/analytics/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} \ No newline at end of file diff --git a/src/analytics/public_api.ts b/src/analytics/public_api.ts new file mode 100644 index 000000000..ed2050781 --- /dev/null +++ b/src/analytics/public_api.ts @@ -0,0 +1,5 @@ +export { Analytics, AnalyticsInstances, analyticInstance$ } from './analytics'; +export { provideAnalytics, AnalyticsModule } from './analytics.module'; +export * from './firebase'; +export * from './screen-tracking.service'; +export * from './user-tracking.service'; diff --git a/src/analytics/screen-tracking.service.ts b/src/analytics/screen-tracking.service.ts new file mode 100644 index 000000000..924832cc1 --- /dev/null +++ b/src/analytics/screen-tracking.service.ts @@ -0,0 +1,180 @@ +import { ComponentFactoryResolver, Injectable, Injector, NgZone, OnDestroy, Optional } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import { Title } from '@angular/platform-browser'; +import { ActivationEnd, Router, ÉĩEmptyOutletComponent } from '@angular/router'; +import { registerVersion } from 'firebase/app'; +import { Observable, Subscription, of } from 'rxjs'; +import { distinctUntilChanged, filter, groupBy, map, mergeMap, pairwise, startWith, switchMap } from 'rxjs/operators'; +import { Analytics } from './analytics'; +import { isSupported, logEvent } from './firebase'; +import { UserTrackingService } from './user-tracking.service'; + +const FIREBASE_EVENT_ORIGIN_KEY = 'firebase_event_origin'; +const FIREBASE_PREVIOUS_SCREEN_CLASS_KEY = 'firebase_previous_class'; +const FIREBASE_PREVIOUS_SCREEN_INSTANCE_ID_KEY = 'firebase_previous_id'; +const FIREBASE_PREVIOUS_SCREEN_NAME_KEY = 'firebase_previous_screen'; +const FIREBASE_SCREEN_CLASS_KEY = 'firebase_screen_class'; +const FIREBASE_SCREEN_INSTANCE_ID_KEY = 'firebase_screen_id'; +const FIREBASE_SCREEN_NAME_KEY = 'firebase_screen'; +const OUTLET_KEY = 'outlet'; +const PAGE_PATH_KEY = 'page_path'; +const PAGE_TITLE_KEY = 'page_title'; +const SCREEN_CLASS_KEY = 'screen_class'; +const SCREEN_NAME_KEY = 'screen_name'; +const SCREEN_VIEW_EVENT = 'screen_view'; +const EVENT_ORIGIN_AUTO = 'auto'; +const SCREEN_INSTANCE_DELIMITER = '#'; + +// this is an INT64 in iOS/Android but use INT32 cause javascript +let nextScreenInstanceID = Math.floor(Math.random() * (2 ** 32 - 1)) - 2 ** 31; + +const knownScreenInstanceIDs: Record = {}; + +const getScreenInstanceID = (params: Record) => { + // unique the screen class against the outlet name + const screenInstanceKey = [ + params[SCREEN_CLASS_KEY], + params[OUTLET_KEY] + ].join(SCREEN_INSTANCE_DELIMITER); + // eslint-disable-next-line no-prototype-builtins + if (knownScreenInstanceIDs.hasOwnProperty(screenInstanceKey)) { + return knownScreenInstanceIDs[screenInstanceKey]; + } else { + const ret = nextScreenInstanceID++; + knownScreenInstanceIDs[screenInstanceKey] = ret; + return ret; + } +}; + +export const ÉĩscreenViewEvent = ( + router: Router, + title: Title|null, + componentFactoryResolver: ComponentFactoryResolver, +): Observable<{ + [SCREEN_NAME_KEY]: string, + [PAGE_PATH_KEY]: string, + [FIREBASE_EVENT_ORIGIN_KEY]: 'auto', + [FIREBASE_SCREEN_NAME_KEY]: string, + [OUTLET_KEY]: string, + [PAGE_TITLE_KEY]?: string, + [SCREEN_CLASS_KEY]: string, + [FIREBASE_SCREEN_CLASS_KEY]: string, + [FIREBASE_SCREEN_INSTANCE_ID_KEY]: number, + [FIREBASE_PREVIOUS_SCREEN_CLASS_KEY]: string, + [FIREBASE_PREVIOUS_SCREEN_NAME_KEY]: string, + [FIREBASE_PREVIOUS_SCREEN_INSTANCE_ID_KEY]: number, +}> => { + const activationEndEvents = router.events.pipe(filter(e => e instanceof ActivationEnd)); + return activationEndEvents.pipe( + switchMap|null>>(activationEnd => { + // router parseUrl is having trouble with outlets when they're empty + // e.g, /asdf/1(bob://sally:asdf), so put another slash in when empty + const urlTree = router.parseUrl(router.url.replace(/(?:\().+(?:\))/g, a => a.replace('://', ':///'))); + const pagePath = urlTree.root.children[activationEnd.snapshot.outlet]?.toString() || ''; + const actualSnapshot = router.routerState.root.children.map(it => it).find(it => it.outlet === activationEnd.snapshot.outlet); + + if (!actualSnapshot) { + return of(null); + } + + let actualDeep = actualSnapshot; + while (actualDeep.firstChild) { + actualDeep = actualDeep.firstChild; + } + const screenName = actualDeep.pathFromRoot.map(s => s.routeConfig?.path).filter(it => it).join('/') || '/'; + + const params = { + [SCREEN_NAME_KEY]: screenName, + [PAGE_PATH_KEY]: `/${pagePath}`, + [FIREBASE_EVENT_ORIGIN_KEY]: EVENT_ORIGIN_AUTO, + [FIREBASE_SCREEN_NAME_KEY]: screenName, + [OUTLET_KEY]: activationEnd.snapshot.outlet + }; + if (title) { + params[PAGE_TITLE_KEY] = title.getTitle(); + } + + let component = actualSnapshot.component; + if (component) { + if (component === ÉĩEmptyOutletComponent) { + let deepSnapshot = activationEnd.snapshot; + // TODO when might there be mutple children, different outlets? explore + while (deepSnapshot.firstChild) { + deepSnapshot = deepSnapshot.firstChild; + } + component = deepSnapshot.component; + } + } else { + component = activationEnd.snapshot.component; + } + + if (typeof component === 'string') { + return of({ ...params, [SCREEN_CLASS_KEY]: component }); + } else if (component) { + const componentFactory = componentFactoryResolver.resolveComponentFactory(component); + return of({ ...params, [SCREEN_CLASS_KEY]: componentFactory.selector }); + } + // lazy loads cause extra activations, ignore + return of(null); + }), + filter(it => !!it), + map(params => ({ + [FIREBASE_SCREEN_CLASS_KEY]: params[SCREEN_CLASS_KEY], + [FIREBASE_SCREEN_INSTANCE_ID_KEY]: getScreenInstanceID(params), + ...params + })), + groupBy(it => it[OUTLET_KEY]), + mergeMap(it => it.pipe( + distinctUntilChanged((a, b) => JSON.stringify(a) === JSON.stringify(b)), + startWith(undefined), + pairwise(), + map(([prior, current]) => + prior ? { + [FIREBASE_PREVIOUS_SCREEN_CLASS_KEY]: prior[SCREEN_CLASS_KEY], + [FIREBASE_PREVIOUS_SCREEN_NAME_KEY]: prior[SCREEN_NAME_KEY], + [FIREBASE_PREVIOUS_SCREEN_INSTANCE_ID_KEY]: prior[FIREBASE_SCREEN_INSTANCE_ID_KEY], + ...current + } : current + ), + )) + ); +}; + +@Injectable() +export class ScreenTrackingService implements OnDestroy { + + private disposable: Subscription | undefined; + + constructor( + @Optional() router: Router, + @Optional() title: Title, + componentFactoryResolver: ComponentFactoryResolver, + zone: NgZone, + @Optional() userTrackingService: UserTrackingService, + injector: Injector, + ) { + registerVersion('angularfire', VERSION.full, 'screen-tracking'); + // The APP_INITIALIZER that is making isSupported() sync for the sake of convenient DI + // may not be done when services are initialized. Guard the functionality by first ensuring + // that the (global) promise has resolved, then get Analytics from the injector. + isSupported().then(() => { + const analytics = injector.get(Analytics); + if (!router || !analytics) { return; } + zone.runOutsideAngular(() => { + this.disposable = ÉĩscreenViewEvent(router, title, componentFactoryResolver).pipe( + switchMap(async params => { + if (userTrackingService) { await userTrackingService.initialized; } + return logEvent(analytics, SCREEN_VIEW_EVENT, params); + }) + ).subscribe(); + }); + }); + } + + ngOnDestroy() { + if (this.disposable) { + this.disposable.unsubscribe(); + } + } + +} diff --git a/src/analytics/user-tracking.service.ts b/src/analytics/user-tracking.service.ts new file mode 100644 index 000000000..ce40b7c14 --- /dev/null +++ b/src/analytics/user-tracking.service.ts @@ -0,0 +1,45 @@ +import { Injectable, Injector, NgZone, OnDestroy } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import { Auth, authState } from '@angular/fire/auth'; +import { registerVersion } from 'firebase/app'; +import { Subscription } from 'rxjs'; +import { Analytics } from './analytics'; +import { isSupported, setUserId } from './firebase'; + +@Injectable() +export class UserTrackingService implements OnDestroy { + + public readonly initialized: Promise; + private disposables: Subscription[] = []; + + constructor( + auth: Auth, + zone: NgZone, + injector: Injector, + ) { + registerVersion('angularfire', VERSION.full, 'user-tracking'); + let resolveInitialized: () => void; + this.initialized = zone.runOutsideAngular(() => new Promise(resolve => { resolveInitialized = resolve; })); + // The APP_INITIALIZER that is making isSupported() sync for the sake of convenient DI + // may not be done when services are initialized. Guard the functionality by first ensuring + // that the (global) promise has resolved, then get Analytics from the injector. + isSupported().then(() => { + const analytics = injector.get(Analytics); + if (analytics) { + this.disposables = [ + // TODO add credential tracking back in + authState(auth).subscribe(user => { + setUserId(analytics, user?.uid); + resolveInitialized(); + }), + ]; + } else { + resolveInitialized(); + } + }); + } + + ngOnDestroy() { + this.disposables.forEach(it => it.unsubscribe()); + } +} diff --git a/src/angularfire2.spec.ts b/src/angularfire2.spec.ts deleted file mode 100644 index 01efa8e47..000000000 --- a/src/angularfire2.spec.ts +++ /dev/null @@ -1,47 +0,0 @@ -import * as firebase from 'firebase/app'; -import { TestBed, inject } from '@angular/core/testing'; -import { ReflectiveInjector, Provider } from '@angular/core'; -import { FirebaseApp, FirebaseAppConfig, AngularFireModule } from './angularfire2'; -import { Subscription } from 'rxjs/Subscription'; -import { COMMON_CONFIG } from './test-config'; - -describe('angularfire', () => { - let subscription:Subscription; - let app: FirebaseApp; - let rootRef: firebase.database.Reference; - let questionsRef: firebase.database.Reference; - let listOfQuestionsRef: firebase.database.Reference; - const APP_NAME = 'super-awesome-test-firebase-app-name'; - - beforeEach(() => { - - TestBed.configureTestingModule({ - imports: [AngularFireModule.initializeApp(COMMON_CONFIG, APP_NAME)] - }); - - inject([FirebaseApp], (_app: FirebaseApp) => { - app = _app; - rootRef = app.database().ref(); - questionsRef = rootRef.child('questions'); - listOfQuestionsRef = rootRef.child('list-of-questions'); - })(); - - }); - - afterEach((done) => { - rootRef.remove() - if(subscription && !subscription.closed) { - subscription.unsubscribe(); - } - app.delete().then(done, done.fail); - }); - - describe('FirebaseApp', () => { - it('should provide a FirebaseApp for the FirebaseApp binding', () => { - expect(typeof app.delete).toBe('function'); - }); - it('should have the provided name', () => { - expect(app.name).toBe(APP_NAME); - }) - }); -}); diff --git a/src/angularfire2.ts b/src/angularfire2.ts deleted file mode 100644 index 2930e86c2..000000000 --- a/src/angularfire2.ts +++ /dev/null @@ -1,30 +0,0 @@ -import * as firebase from 'firebase/app'; -import * as utils from './utils'; -import { FirebaseAppConfigToken, FirebaseApp, _firebaseAppFactory } from './app/index'; -import { FirebaseListFactoryOpts, FirebaseObjectFactoryOpts, FirebaseAppConfig } from './interfaces'; -import { Injectable, InjectionToken, OpaqueToken, NgModule } from '@angular/core'; - -const FirebaseAppName = new InjectionToken('FirebaseAppName'); - -export const FirebaseAppProvider = { - provide: FirebaseApp, - useFactory: _firebaseAppFactory, - deps: [ FirebaseAppConfigToken, FirebaseAppName ] -}; - -@NgModule({ - providers: [ FirebaseAppProvider ], -}) -export class AngularFireModule { - static initializeApp(config: FirebaseAppConfig, appName?: string) { - return { - ngModule: AngularFireModule, - providers: [ - { provide: FirebaseAppConfigToken, useValue: config }, - { provide: FirebaseAppName, useValue: appName } - ] - } - } -} - -export { FirebaseApp, FirebaseAppName, FirebaseAppConfigToken, FirebaseAppConfig }; diff --git a/src/angularfire2_worker_app.ts b/src/angularfire2_worker_app.ts deleted file mode 100644 index fa17337de..000000000 --- a/src/angularfire2_worker_app.ts +++ /dev/null @@ -1,9 +0,0 @@ -import { provide } from '@angular/core'; -import { COMMON_PROVIDERS } from './angularfire2'; -import { AuthBackend } from './auth/index'; -import { WebWorkerFirebaseAuth } from './providers/web_workers/worker/auth'; - -export const WORKER_APP_FIREBASE_PROVIDERS: any[] = [ - COMMON_PROVIDERS, - provide(AuthBackend, {useClass: WebWorkerFirebaseAuth}) -]; diff --git a/src/angularfire2_worker_render.ts b/src/angularfire2_worker_render.ts deleted file mode 100644 index d1c0fa7f2..000000000 --- a/src/angularfire2_worker_render.ts +++ /dev/null @@ -1,17 +0,0 @@ -import { provide } from '@angular/core'; -import { COMMON_PROVIDERS } from './angularfire2'; -import { FirebaseSdkAuthBackend } from './auth/index'; -import { WebWorkerFirebaseAuth } from './providers/web_workers/worker/auth'; -import { FirebaseApp } from './tokens'; -import { MessageBasedFirebaseAuth } from './providers/web_workers/ui/auth'; - -export const WORKER_RENDER_FIREBASE_PROVIDERS: any[] = [ - COMMON_PROVIDERS, - provide(FirebaseSdkAuthBackend, { - useFactory: (app) => new FirebaseSdkAuthBackend(app, true), - deps: [FirebaseApp] - }), - MessageBasedFirebaseAuth -]; - -export {MessageBasedFirebaseAuth} from './providers/web_workers/ui/auth'; diff --git a/src/app-check/app-check.module.ts b/src/app-check/app-check.module.ts new file mode 100644 index 000000000..b68f848bc --- /dev/null +++ b/src/app-check/app-check.module.ts @@ -0,0 +1,88 @@ +import { isPlatformServer } from '@angular/common'; +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + PLATFORM_ID, + isDevMode, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { registerVersion } from 'firebase/app'; +import { AppCheck as FirebaseAppCheck } from 'firebase/app-check'; +import { APP_CHECK_PROVIDER_NAME, AppCheck, AppCheckInstances } from './app-check'; + +export const PROVIDED_APP_CHECK_INSTANCES = new InjectionToken('angularfire2.app-check-instances'); + +export function defaultAppCheckInstanceFactory(provided: FirebaseAppCheck[]|undefined, defaultApp: FirebaseApp) { + const defaultAppCheck = ÉĩgetDefaultInstanceOf(APP_CHECK_PROVIDER_NAME, provided, defaultApp); + return defaultAppCheck && new AppCheck(defaultAppCheck); +} + +const LOCALHOSTS = ['localhost', '0.0.0.0', '127.0.0.1']; +const isLocalhost = typeof window !== 'undefined' && LOCALHOSTS.includes(window.location.hostname); + +export function appCheckInstanceFactory(fn: (injector: Injector) => FirebaseAppCheck) { + return (zone: NgZone, injector: Injector, platformId: unknown) => { + // Node should use admin token provider, browser devmode and localhost should use debug token + if (!isPlatformServer(platformId) && (isDevMode() || isLocalhost)) { + globalThis.FIREBASE_APPCHECK_DEBUG_TOKEN ??= true; + } + const appCheck = zone.runOutsideAngular(() => fn(injector)); + return new AppCheck(appCheck); + }; +} + +const APP_CHECK_INSTANCES_PROVIDER = { + provide: AppCheckInstances, + deps: [ + [new Optional(), PROVIDED_APP_CHECK_INSTANCES ], + ] +}; + +const DEFAULT_APP_CHECK_INSTANCE_PROVIDER = { + provide: AppCheck, + useFactory: defaultAppCheckInstanceFactory, + deps: [ + [new Optional(), PROVIDED_APP_CHECK_INSTANCES ], + FirebaseApp, + PLATFORM_ID, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_APP_CHECK_INSTANCE_PROVIDER, + APP_CHECK_INSTANCES_PROVIDER, + ] +}) +export class AppCheckModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'app-check'); + } +} + +export function provideAppCheck(fn: (injector: Injector) => FirebaseAppCheck, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'app-check'); + return makeEnvironmentProviders([ + DEFAULT_APP_CHECK_INSTANCE_PROVIDER, + APP_CHECK_INSTANCES_PROVIDER, + { + provide: PROVIDED_APP_CHECK_INSTANCES, + useFactory: appCheckInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + PLATFORM_ID, + ÉĩAngularFireSchedulers, + FirebaseApps, + ...deps, + ] + } + ]); +} diff --git a/src/app-check/app-check.spec.ts b/src/app-check/app-check.spec.ts new file mode 100644 index 000000000..b51e91e0e --- /dev/null +++ b/src/app-check/app-check.spec.ts @@ -0,0 +1,39 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Auth, connectAuthEmulator, getAuth, provideAuth } from '@angular/fire/auth'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +describe('Auth', () => { + let app: FirebaseApp; + let auth: Auth; + let providedAuth: Auth; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideAuth(() => { + providedAuth = getAuth(getApp(appName)); + connectAuthEmulator(providedAuth, 'http://localhost:9098/'); + return providedAuth; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + auth = TestBed.inject(Auth); + }); + + it('should be injectable', () => { + expect(auth).toBeTruthy(); + expect(auth).toEqual(providedAuth); + expect(auth.app).toEqual(app); + }); + + }); + +}); diff --git a/src/app-check/app-check.ts b/src/app-check/app-check.ts new file mode 100644 index 000000000..33d6d91fe --- /dev/null +++ b/src/app-check/app-check.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { AppCheck as FirebaseAppCheck } from 'firebase/app-check'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +export const APP_CHECK_PROVIDER_NAME = 'app-check'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AppCheck extends FirebaseAppCheck {} + +export class AppCheck { + constructor(appCheck: FirebaseAppCheck) { + return appCheck; + } +} + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AppCheckInstances extends Array {} + +export class AppCheckInstances { + constructor() { + return ÉĩgetAllInstancesOf(APP_CHECK_PROVIDER_NAME); + } +} + +export const appCheckInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(APP_CHECK_PROVIDER_NAME))), + distinct(), +); diff --git a/src/app-check/firebase.ts b/src/app-check/firebase.ts new file mode 100644 index 000000000..bfaefcc29 --- /dev/null +++ b/src/app-check/firebase.ts @@ -0,0 +1,16 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/app-check'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + getLimitedUseToken as _getLimitedUseToken, + getToken as _getToken, + initializeAppCheck as _initializeAppCheck, + onTokenChanged as _onTokenChanged, + setTokenAutoRefreshEnabled as _setTokenAutoRefreshEnabled +} from 'firebase/app-check'; + +export const getLimitedUseToken = ÉĩzoneWrap(_getLimitedUseToken, true, 2); +export const getToken = ÉĩzoneWrap(_getToken, true); +export const initializeAppCheck = ÉĩzoneWrap(_initializeAppCheck, true); +export const onTokenChanged = ÉĩzoneWrap(_onTokenChanged, true); +export const setTokenAutoRefreshEnabled = ÉĩzoneWrap(_setTokenAutoRefreshEnabled, true); diff --git a/src/app-check/ng-package.json b/src/app-check/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/app-check/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/app-check/package.json b/src/app-check/package.json new file mode 100644 index 000000000..5e8aa1496 --- /dev/null +++ b/src/app-check/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} \ No newline at end of file diff --git a/src/app-check/public_api.ts b/src/app-check/public_api.ts new file mode 100644 index 000000000..bab774cf3 --- /dev/null +++ b/src/app-check/public_api.ts @@ -0,0 +1,3 @@ +export { AppCheck, appCheckInstance$, AppCheckInstances } from './app-check'; +export { provideAppCheck, AppCheckModule } from './app-check.module'; +export * from './firebase'; diff --git a/src/app/app.module.ts b/src/app/app.module.ts new file mode 100644 index 000000000..c7b402c10 --- /dev/null +++ b/src/app/app.module.ts @@ -0,0 +1,94 @@ +import { + EnvironmentProviders, + Inject, + InjectionToken, + Injector, + VERSION as NG_VERSION, + NgModule, + NgZone, + Optional, + PLATFORM_ID, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers } from '@angular/fire'; +import { FirebaseApp as IFirebaseApp, getApp, registerVersion } from 'firebase/app'; +import { FirebaseApp, FirebaseApps } from './app'; + +export function defaultFirebaseAppFactory(provided: FirebaseApp[]|undefined) { + // Use the provided app, if there is only one, otherwise fetch the default app + if (provided && provided.length === 1) { return provided[0]; } + return new FirebaseApp(getApp()); +} + +// With FIREBASE_APPS I wanted to capture the default app instance, if it is initialized by +// the reserved URL; ÉĩPROVIDED_FIREBASE_APPS is not for public consumption and serves to ensure that all +// provideFirebaseApp(...) calls are satisfied before FirebaseApp$ or FirebaseApp is resolved +export const PROVIDED_FIREBASE_APPS = new InjectionToken('angularfire2._apps'); + +// Injecting FirebaseApp will now only inject the default Firebase App +// this allows allows beginners to import /__/firebase/init.js to auto initialize Firebase App +// from the reserved URL. +const DEFAULT_FIREBASE_APP_PROVIDER = { + provide: FirebaseApp, + useFactory: defaultFirebaseAppFactory, + deps: [ + [new Optional(), PROVIDED_FIREBASE_APPS ], + ], +}; + +const FIREBASE_APPS_PROVIDER = { + provide: FirebaseApps, + deps: [ + [new Optional(), PROVIDED_FIREBASE_APPS ], + ], +}; + +export function firebaseAppFactory(fn: (injector: Injector) => IFirebaseApp) { + return (zone: NgZone, injector: Injector) => { + const platformId = injector.get(PLATFORM_ID); + registerVersion('angularfire', VERSION.full, 'core'); + registerVersion('angularfire', VERSION.full, 'app'); + // eslint-disable-next-line @typescript-eslint/no-base-to-string + registerVersion('angular', NG_VERSION.full, platformId.toString()); + + const app = zone.runOutsideAngular(() => fn(injector)); + return new FirebaseApp(app); + }; +} + +@NgModule({ + providers: [ + DEFAULT_FIREBASE_APP_PROVIDER, + FIREBASE_APPS_PROVIDER, + ] +}) +export class FirebaseAppModule { + // eslint-disable-next-line @typescript-eslint/ban-types + constructor(@Inject(PLATFORM_ID) platformId: Object) { + registerVersion('angularfire', VERSION.full, 'core'); + registerVersion('angularfire', VERSION.full, 'app'); + // eslint-disable-next-line @typescript-eslint/no-base-to-string + registerVersion('angular', NG_VERSION.full, platformId.toString()); + } +} + +// Calling initializeApp({ ... }, 'name') multiple times will add more FirebaseApps into the FIREBASE_APPS +// injection scope. This allows developers to more easily work with multiple Firebase Applications. Downside +// is that DI for app name and options doesn't really make sense anymore. +export function provideFirebaseApp(fn: (injector: Injector) => IFirebaseApp, ...deps: any[]): EnvironmentProviders { + return makeEnvironmentProviders([ + DEFAULT_FIREBASE_APP_PROVIDER, + FIREBASE_APPS_PROVIDER, + { + provide: PROVIDED_FIREBASE_APPS, + useFactory: firebaseAppFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + ...deps, + ], + } + ]) +} diff --git a/src/app/app.spec.ts b/src/app/app.spec.ts new file mode 100644 index 000000000..62af613f8 --- /dev/null +++ b/src/app/app.spec.ts @@ -0,0 +1,33 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +describe('FirebaseApp', () => { + let app: FirebaseApp; + let providedApp: FirebaseApp; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => { + providedApp = initializeApp(COMMON_CONFIG, appName); + return providedApp; + }) + ], + }); + app = TestBed.inject(FirebaseApp); + }); + + it('should be injectable', () => { + expect(app).toBeTruthy(); + expect(app).toEqual(providedApp); + }); + + }); + +}); diff --git a/src/app/app.ts b/src/app/app.ts new file mode 100644 index 000000000..0b71e3d54 --- /dev/null +++ b/src/app/app.ts @@ -0,0 +1,39 @@ +import { FirebaseApp as IFirebaseApp, getApps } from 'firebase/app'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// Need to turn the FirebaseApp interface exported by firebase/app into a class +// as types don't work in Angular DI. We want developers to be able to inject FirebaseApp like so +// constructor(app: FirebaseApp) +// the cleanest way to achieve this that I found is to export a new interface and class +// the interface just extends the interface you want to turn into the class. This informs tyepscript +// that the class has all the same methods/properties as the interface you want to extend without +// breaking if Firebase adds/removes APIs in future releases. This was a big problem for @angular/fire +// back when we constructed our own class. Then in the "new class" we just return the FirebaseApp in the +// constructor, this also has the added benefit of Firebase methods taking our DI class without +// casting. E.g, +// constructor(private app: FirebaseApp) { } +// ngOnDestroy() { deleteApp(this.app); } +// +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface FirebaseApp extends IFirebaseApp {} + +export class FirebaseApp { + constructor(app: IFirebaseApp) { + return app; + } +} + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface FirebaseApps extends Array {} + +export class FirebaseApps { + constructor() { + return getApps(); + } +} + +export const firebaseApp$ = timer(0, 300).pipe( + concatMap(() => from(getApps())), + distinct(), +); diff --git a/src/app/firebase.app.module.ts b/src/app/firebase.app.module.ts deleted file mode 100644 index b36135266..000000000 --- a/src/app/firebase.app.module.ts +++ /dev/null @@ -1,28 +0,0 @@ -import { InjectionToken, } from '@angular/core'; -import { FirebaseAppConfig } from '../interfaces'; -import * as firebase from 'firebase/app'; - -export const FirebaseAppConfigToken = new InjectionToken('FirebaseAppConfigToken'); - -export class FirebaseApp implements firebase.app.App { - name: string; - options: {}; - auth: () => firebase.auth.Auth; - database: () => firebase.database.Database; - messaging: () => firebase.messaging.Messaging; - storage: () => firebase.storage.Storage; - delete: () => firebase.Promise; -} - -export function _firebaseAppFactory(config: FirebaseAppConfig, appName?: string): FirebaseApp { - try { - if (appName) { - return firebase.initializeApp(config, appName); - } else { - return firebase.initializeApp(config); - } - } - catch (e) { - return firebase.app(null); - } -} diff --git a/src/app/firebase.ts b/src/app/firebase.ts new file mode 100644 index 000000000..7d9487193 --- /dev/null +++ b/src/app/firebase.ts @@ -0,0 +1,22 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/app'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + deleteApp as _deleteApp, + getApp as _getApp, + getApps as _getApps, + initializeApp as _initializeApp, + initializeServerApp as _initializeServerApp, + onLog as _onLog, + registerVersion as _registerVersion, + setLogLevel as _setLogLevel +} from 'firebase/app'; + +export const deleteApp = ÉĩzoneWrap(_deleteApp, true); +export const getApp = ÉĩzoneWrap(_getApp, true); +export const getApps = ÉĩzoneWrap(_getApps, true); +export const initializeApp = ÉĩzoneWrap(_initializeApp, true); +export const initializeServerApp = ÉĩzoneWrap(_initializeServerApp, true); +export const onLog = ÉĩzoneWrap(_onLog, true); +export const registerVersion = ÉĩzoneWrap(_registerVersion, true); +export const setLogLevel = ÉĩzoneWrap(_setLogLevel, true); diff --git a/src/app/index.ts b/src/app/index.ts deleted file mode 100644 index c71ec6173..000000000 --- a/src/app/index.ts +++ /dev/null @@ -1 +0,0 @@ -export * from './firebase.app.module'; \ No newline at end of file diff --git a/src/app/ng-package.json b/src/app/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/app/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/app/package.json b/src/app/package.json index 65be0782f..5e8aa1496 100644 --- a/src/app/package.json +++ b/src/app/package.json @@ -1 +1,3 @@ -{ "main": "../bundles/angularfire2.umd.js" } \ No newline at end of file +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} \ No newline at end of file diff --git a/src/app/public_api.ts b/src/app/public_api.ts new file mode 100644 index 000000000..e33036709 --- /dev/null +++ b/src/app/public_api.ts @@ -0,0 +1,3 @@ +export { FirebaseApp, FirebaseApps, firebaseApp$ } from './app'; +export { provideFirebaseApp, FirebaseAppModule } from './app.module'; +export * from './firebase'; diff --git a/src/auth-guard/auth-guard.module.ts b/src/auth-guard/auth-guard.module.ts new file mode 100644 index 000000000..3d9480545 --- /dev/null +++ b/src/auth-guard/auth-guard.module.ts @@ -0,0 +1,13 @@ +import { NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import { registerVersion } from 'firebase/app'; +import { AuthGuard } from './auth-guard'; + +@NgModule({ + providers: [ AuthGuard ] +}) +export class AuthGuardModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'auth-guard'); + } +} diff --git a/src/auth-guard/auth-guard.spec.ts b/src/auth-guard/auth-guard.spec.ts new file mode 100644 index 000000000..9c87a3fd3 --- /dev/null +++ b/src/auth-guard/auth-guard.spec.ts @@ -0,0 +1,47 @@ +import { APP_BASE_HREF } from '@angular/common'; +import { TestBed } from '@angular/core/testing'; +import { getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { connectAuthEmulator, getAuth, provideAuth } from '@angular/fire/auth'; +import { AuthGuard, AuthGuardModule } from '@angular/fire/auth-guard'; +import { Router, RouterModule } from '@angular/router'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +class TestComponent { } + +describe('AuthGuard', () => { + let router: Router; + let appName: string; + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + imports: [ + AuthGuardModule, + RouterModule.forRoot([ + { path: 'a', component: TestComponent, canActivate: [AuthGuard] } + ]) + ], + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideAuth(() => { + const auth = getAuth(getApp(appName)); + connectAuthEmulator(auth, 'http://localhost:9098/'); + return auth; + }), + { provide: APP_BASE_HREF, useValue: 'http://localhost:4200/' } + ] + }); + + router = TestBed.inject(Router); + }); + + it('should be injectable', () => { + expect(AuthGuard).toBeTruthy(); + }); + + it('router should be valid', () => { + expect(router).toBeTruthy(); + }); + +}); diff --git a/src/auth-guard/auth-guard.ts b/src/auth-guard/auth-guard.ts new file mode 100644 index 000000000..51cff3550 --- /dev/null +++ b/src/auth-guard/auth-guard.ts @@ -0,0 +1,54 @@ +import { Injectable } from '@angular/core'; +import { Auth, user } from '@angular/fire/auth'; +import { ActivatedRouteSnapshot, CanActivate, Router, RouterStateSnapshot } from '@angular/router'; +import { User } from 'firebase/auth'; +import { Observable, UnaryFunction, of, pipe } from 'rxjs'; +import { map, switchMap, take } from 'rxjs/operators'; + +export type AuthPipeGenerator = (next: ActivatedRouteSnapshot, state: RouterStateSnapshot) => AuthPipe; +export type AuthPipe = UnaryFunction, Observable>; + +export const loggedIn: AuthPipe = map(user => !!user); + +@Injectable({ + providedIn: 'any' +}) +export class AuthGuard implements CanActivate { + + constructor(private router: Router, private auth: Auth) {} + + canActivate = (next: ActivatedRouteSnapshot, state: RouterStateSnapshot) => { + const authPipeFactory = next.data.authGuardPipe as AuthPipeGenerator || (() => loggedIn); + return user(this.auth).pipe( + take(1), + authPipeFactory(next, state), + map(can => { + if (typeof can === 'boolean') { + return can; + } else if (Array.isArray(can)) { + return this.router.createUrlTree(can); + } else { + // TODO(EdricChan03): Add tests + return this.router.parseUrl(can); + } + }) + ); + } + +} + +export const canActivate = (pipe: AuthPipeGenerator) => ({ + canActivate: [ AuthGuard ], data: { authGuardPipe: pipe } +}); + +export const isNotAnonymous: AuthPipe = map(user => !!user && !user.isAnonymous); +export const idTokenResult = switchMap((user: User|null) => user ? user.getIdTokenResult() : of(null)); +export const emailVerified: AuthPipe = map(user => !!user && user.emailVerified); +export const customClaims = pipe(idTokenResult, map(idTokenResult => idTokenResult ? idTokenResult.claims : [])); +export const hasCustomClaim: (claim: string) => AuthPipe = + // eslint-disable-next-line no-prototype-builtins + (claim) => pipe(customClaims, map(claims => claims.hasOwnProperty(claim))); +export const redirectUnauthorizedTo: (redirect: string|any[]) => AuthPipe = + (redirect) => pipe(loggedIn, map(loggedIn => loggedIn || redirect)); +export const redirectLoggedInTo: (redirect: string|any[]) => AuthPipe = + (redirect) => pipe(loggedIn, map(loggedIn => loggedIn && redirect || true)); diff --git a/src/auth-guard/ng-package.json b/src/auth-guard/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/auth-guard/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/auth-guard/package.json b/src/auth-guard/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/auth-guard/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/auth-guard/public_api.ts b/src/auth-guard/public_api.ts new file mode 100644 index 000000000..468fd9657 --- /dev/null +++ b/src/auth-guard/public_api.ts @@ -0,0 +1,2 @@ +export * from './auth-guard'; +export * from './auth-guard.module'; diff --git a/src/auth.ts b/src/auth.ts deleted file mode 100644 index 6980c3154..000000000 --- a/src/auth.ts +++ /dev/null @@ -1,2 +0,0 @@ -export * from './auth/auth'; -export * from './auth/auth.module'; diff --git a/src/auth/auth.module.ts b/src/auth/auth.module.ts index d104f53dd..e20274658 100644 --- a/src/auth/auth.module.ts +++ b/src/auth/auth.module.ts @@ -1,26 +1,78 @@ -import { NgModule, NgZone } from '@angular/core'; -import * as firebase from 'firebase/app'; -import 'firebase/auth'; -import { FirebaseApp } from '../app/index'; -import { AngularFireModule } from '../angularfire2'; -import { AngularFireAuth } from './auth'; +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { registerVersion } from 'firebase/app'; +import { Auth as FirebaseAuth } from 'firebase/auth'; +import { AUTH_PROVIDER_NAME, Auth, AuthInstances } from './auth'; -export function _getAngularFireAuth(app: FirebaseApp) { - return new AngularFireAuth(app); +export const PROVIDED_AUTH_INSTANCES = new InjectionToken('angularfire2.auth-instances'); + +export function defaultAuthInstanceFactory(provided: FirebaseAuth[]|undefined, defaultApp: FirebaseApp) { + const defaultAuth = ÉĩgetDefaultInstanceOf(AUTH_PROVIDER_NAME, provided, defaultApp); + return defaultAuth && new Auth(defaultAuth); +} + +export function authInstanceFactory(fn: (injector: Injector) => FirebaseAuth) { + return (zone: NgZone, injector: Injector) => { + const auth = zone.runOutsideAngular(() => fn(injector)); + return new Auth(auth); + }; } -export const AngularFireAuthProvider = { - provide: AngularFireAuth, - useFactory: _getAngularFireAuth, - deps: [ FirebaseApp ] +const AUTH_INSTANCES_PROVIDER = { + provide: AuthInstances, + deps: [ + [new Optional(), PROVIDED_AUTH_INSTANCES ], + ] }; -export const AUTH_PROVIDERS = [ - AngularFireAuthProvider, -]; +const DEFAULT_AUTH_INSTANCE_PROVIDER = { + provide: Auth, + useFactory: defaultAuthInstanceFactory, + deps: [ + [new Optional(), PROVIDED_AUTH_INSTANCES ], + FirebaseApp, + ] +}; @NgModule({ - imports: [ AngularFireModule ], - providers: [ AUTH_PROVIDERS ] + providers: [ + DEFAULT_AUTH_INSTANCE_PROVIDER, + AUTH_INSTANCES_PROVIDER, + ] }) -export class AngularFireAuthModule { } +export class AuthModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'auth'); + } +} + +export function provideAuth(fn: (injector: Injector) => FirebaseAuth, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'auth'); + return makeEnvironmentProviders([ + DEFAULT_AUTH_INSTANCE_PROVIDER, + AUTH_INSTANCES_PROVIDER, + { + provide: PROVIDED_AUTH_INSTANCES, + useFactory: authInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + [new Optional(), AppCheckInstances ], + ...deps, + ] + } + ]); +} diff --git a/src/auth/auth.spec.ts b/src/auth/auth.spec.ts index 2f5554246..015cd06c9 100644 --- a/src/auth/auth.spec.ts +++ b/src/auth/auth.spec.ts @@ -1,105 +1,39 @@ -import * as firebase from 'firebase/app'; -import { ReflectiveInjector, Provider } from '@angular/core'; -import { Observable } from 'rxjs/Observable' -import { Subject } from 'rxjs/Subject' -import { Observer } from 'rxjs/Observer'; -import { TestBed, inject } from '@angular/core/testing'; -import { _do } from 'rxjs/operator/do'; -import { take } from 'rxjs/operator/take'; -import { skip } from 'rxjs/operator/skip'; -import { FirebaseApp, FirebaseAppConfig, AngularFireModule } from '../angularfire2'; -import { AngularFireAuth } from './auth'; -import { AngularFireAuthModule } from './auth.module'; -import { COMMON_CONFIG } from '../test-config'; - -function authTake(auth: Observable, count: number): Observable { - return take.call(auth, 1); -} - -function authSkip(auth: Observable, count: number): Observable { - return skip.call(auth, 1); -} - -const firebaseUser = { - uid: '12345', - providerData: [{ displayName: 'jeffbcrossyface' }] -}; - -describe('AngularFireAuth', () => { - let app: firebase.app.App; - let authData: any; - let authCb: any; - let afAuth: AngularFireAuth; - let authSpy: jasmine.Spy; - let mockAuthState: Subject; - let fbAuthObserver: Observer; - let windowLocation: any; - - beforeEach(() => { - TestBed.configureTestingModule({ - imports: [ - AngularFireModule.initializeApp(COMMON_CONFIG), - AngularFireAuthModule - ] +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Auth, connectAuthEmulator, getAuth, provideAuth } from '@angular/fire/auth'; +import { COMMON_CONFIG, authEmulatorPort } from '../test-config'; +import { rando } from '../utils'; + +describe('Auth', () => { + let app: FirebaseApp; + let auth: Auth; + let providedAuth: Auth; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideAuth(() => { + providedAuth = getAuth(getApp(appName)); + connectAuthEmulator(providedAuth, `http://localhost:${authEmulatorPort}`, { disableWarnings: true }); + return providedAuth; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + auth = TestBed.inject(Auth); }); - inject([FirebaseApp, AngularFireAuth], (app_: FirebaseApp, _auth: AngularFireAuth) => { - app = app_; - afAuth = _auth; - authData = null; - authCb = null; - })(); - - mockAuthState = new Subject(); - spyOn(afAuth, 'authState').and.returnValue(mockAuthState); - afAuth.authState = mockAuthState; - }); - - afterEach(done => { - app.delete().then(done, done.fail); - }); - describe('Zones', () => { - it('should call operators and subscriber in the same zone as when service was initialized', (done) => { - // Initialize the app outside of the zone, to mimick real life behavior. - let ngZone = Zone.current.fork({ - name: 'ngZone' - }); - ngZone.run(() => { - const subs = afAuth.authState.subscribe(user => { - expect(Zone.current.name).toBe('ngZone'); - done(); - }, done.fail); - mockAuthState.next(firebaseUser); - subs.unsubscribe(); - }); + it('should be injectable', () => { + expect(providedAuth).toBeTruthy(); + expect(auth).toEqual(providedAuth); + expect(auth.app).toEqual(app); }); - }); - - it('should be exist', () => { - expect(afAuth instanceof AngularFireAuth).toBe(true); - }); - it('should have the Firebase Auth instance', () => { - expect(afAuth.auth).toBeDefined(); - }); - - it('should emit auth updates through authState', (done: any) => { - let count = 0; - - // Check that the first value is null and second is the auth user - const subs = afAuth.authState.subscribe(user => { - if (count === 0) { - expect(user).toBe(null); - count = count + 1; - mockAuthState.next(firebaseUser); - } else { - expect(user).toEqual(firebaseUser); - subs.unsubscribe(); - done(); - } - }, done, done.fail); - mockAuthState.next(null); }); }); - diff --git a/src/auth/auth.ts b/src/auth/auth.ts index b81099a2a..27c79cf78 100644 --- a/src/auth/auth.ts +++ b/src/auth/auth.ts @@ -1,45 +1,30 @@ -import * as firebase from 'firebase/app'; -import * as utils from '../utils'; -import 'firebase/auth'; -import { Injectable, NgZone } from '@angular/core'; -import { Auth } from '../interfaces'; -import { Observable } from 'rxjs/Observable'; -import { Observer } from 'rxjs/Observer'; -import { observeOn } from 'rxjs/operator/observeOn'; -import { FirebaseApp } from '../app/index'; +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { Auth as FirebaseAuth } from 'firebase/auth'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; -@Injectable() -export class AngularFireAuth { +export const AUTH_PROVIDER_NAME = 'auth'; - /** - * Firebase Auth instance - */ - auth: firebase.auth.Auth; +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Auth extends FirebaseAuth {} - /** - * Observable of authentication state - */ - authState: Observable; - - constructor(public app: FirebaseApp) { - this.authState = FirebaseAuthStateObservable(app); - this.auth = app.auth(); +export class Auth { + constructor(auth: FirebaseAuth) { + return auth; } - } -/** - * Create an Observable of Firebase authentication state. Each event is called - * within the current zone. - * @param app - Firebase App instance - */ -export function FirebaseAuthStateObservable(app: FirebaseApp): Observable { - const authState = Observable.create((observer: Observer) => { - app.auth().onAuthStateChanged( - (user?: firebase.User) => observer.next(user), - (error: firebase.auth.Error) => observer.error(error), - () => observer.complete() - ); - }); - return observeOn.call(authState, new utils.ZoneScheduler(Zone.current)); +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AuthInstances extends Array {} + +export class AuthInstances { + constructor() { + return ÉĩgetAllInstancesOf(AUTH_PROVIDER_NAME); + } } + +export const authInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(AUTH_PROVIDER_NAME))), + distinct(), +); diff --git a/src/auth/firebase.ts b/src/auth/firebase.ts new file mode 100644 index 000000000..743ca90d8 --- /dev/null +++ b/src/auth/firebase.ts @@ -0,0 +1,112 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/auth'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + applyActionCode as _applyActionCode, + beforeAuthStateChanged as _beforeAuthStateChanged, + checkActionCode as _checkActionCode, + confirmPasswordReset as _confirmPasswordReset, + connectAuthEmulator as _connectAuthEmulator, + createUserWithEmailAndPassword as _createUserWithEmailAndPassword, + deleteUser as _deleteUser, + fetchSignInMethodsForEmail as _fetchSignInMethodsForEmail, + getAdditionalUserInfo as _getAdditionalUserInfo, + getAuth as _getAuth, + getIdToken as _getIdToken, + getIdTokenResult as _getIdTokenResult, + getMultiFactorResolver as _getMultiFactorResolver, + getRedirectResult as _getRedirectResult, + initializeAuth as _initializeAuth, + initializeRecaptchaConfig as _initializeRecaptchaConfig, + isSignInWithEmailLink as _isSignInWithEmailLink, + linkWithCredential as _linkWithCredential, + linkWithPhoneNumber as _linkWithPhoneNumber, + linkWithPopup as _linkWithPopup, + linkWithRedirect as _linkWithRedirect, + onAuthStateChanged as _onAuthStateChanged, + onIdTokenChanged as _onIdTokenChanged, + parseActionCodeURL as _parseActionCodeURL, + reauthenticateWithCredential as _reauthenticateWithCredential, + reauthenticateWithPhoneNumber as _reauthenticateWithPhoneNumber, + reauthenticateWithPopup as _reauthenticateWithPopup, + reauthenticateWithRedirect as _reauthenticateWithRedirect, + reload as _reload, + revokeAccessToken as _revokeAccessToken, + sendEmailVerification as _sendEmailVerification, + sendPasswordResetEmail as _sendPasswordResetEmail, + sendSignInLinkToEmail as _sendSignInLinkToEmail, + setPersistence as _setPersistence, + signInAnonymously as _signInAnonymously, + signInWithCredential as _signInWithCredential, + signInWithCustomToken as _signInWithCustomToken, + signInWithEmailAndPassword as _signInWithEmailAndPassword, + signInWithEmailLink as _signInWithEmailLink, + signInWithPhoneNumber as _signInWithPhoneNumber, + signInWithPopup as _signInWithPopup, + signInWithRedirect as _signInWithRedirect, + signOut as _signOut, + unlink as _unlink, + updateCurrentUser as _updateCurrentUser, + updateEmail as _updateEmail, + updatePassword as _updatePassword, + updatePhoneNumber as _updatePhoneNumber, + updateProfile as _updateProfile, + useDeviceLanguage as _useDeviceLanguage, + validatePassword as _validatePassword, + verifyBeforeUpdateEmail as _verifyBeforeUpdateEmail, + verifyPasswordResetCode as _verifyPasswordResetCode +} from 'firebase/auth'; + +export const applyActionCode = ÉĩzoneWrap(_applyActionCode, true); +export const beforeAuthStateChanged = ÉĩzoneWrap(_beforeAuthStateChanged, true); +export const checkActionCode = ÉĩzoneWrap(_checkActionCode, true); +export const confirmPasswordReset = ÉĩzoneWrap(_confirmPasswordReset, true, 2); +export const connectAuthEmulator = ÉĩzoneWrap(_connectAuthEmulator, true); +export const createUserWithEmailAndPassword = ÉĩzoneWrap(_createUserWithEmailAndPassword, true, 2); +export const deleteUser = ÉĩzoneWrap(_deleteUser, true, 2); +export const fetchSignInMethodsForEmail = ÉĩzoneWrap(_fetchSignInMethodsForEmail, true, 2); +export const getAdditionalUserInfo = ÉĩzoneWrap(_getAdditionalUserInfo, true, 2); +export const getAuth = ÉĩzoneWrap(_getAuth, true); +export const getIdToken = ÉĩzoneWrap(_getIdToken, true); +export const getIdTokenResult = ÉĩzoneWrap(_getIdTokenResult, true); +export const getMultiFactorResolver = ÉĩzoneWrap(_getMultiFactorResolver, true); +export const getRedirectResult = ÉĩzoneWrap(_getRedirectResult, true); +export const initializeAuth = ÉĩzoneWrap(_initializeAuth, true); +export const initializeRecaptchaConfig = ÉĩzoneWrap(_initializeRecaptchaConfig, true); +export const isSignInWithEmailLink = ÉĩzoneWrap(_isSignInWithEmailLink, true); +export const linkWithCredential = ÉĩzoneWrap(_linkWithCredential, true, 2); +export const linkWithPhoneNumber = ÉĩzoneWrap(_linkWithPhoneNumber, true, 2); +export const linkWithPopup = ÉĩzoneWrap(_linkWithPopup, true, 2); +export const linkWithRedirect = ÉĩzoneWrap(_linkWithRedirect, true, 2); +export const onAuthStateChanged = ÉĩzoneWrap(_onAuthStateChanged, true); +export const onIdTokenChanged = ÉĩzoneWrap(_onIdTokenChanged, true); +export const parseActionCodeURL = ÉĩzoneWrap(_parseActionCodeURL, true); +export const reauthenticateWithCredential = ÉĩzoneWrap(_reauthenticateWithCredential, true, 2); +export const reauthenticateWithPhoneNumber = ÉĩzoneWrap(_reauthenticateWithPhoneNumber, true, 2); +export const reauthenticateWithPopup = ÉĩzoneWrap(_reauthenticateWithPopup, true, 2); +export const reauthenticateWithRedirect = ÉĩzoneWrap(_reauthenticateWithRedirect, true, 2); +export const reload = ÉĩzoneWrap(_reload, true, 2); +export const revokeAccessToken = ÉĩzoneWrap(_revokeAccessToken, true, 2); +export const sendEmailVerification = ÉĩzoneWrap(_sendEmailVerification, true, 2); +export const sendPasswordResetEmail = ÉĩzoneWrap(_sendPasswordResetEmail, true, 2); +export const sendSignInLinkToEmail = ÉĩzoneWrap(_sendSignInLinkToEmail, true, 2); +export const setPersistence = ÉĩzoneWrap(_setPersistence, true); +export const signInAnonymously = ÉĩzoneWrap(_signInAnonymously, true, 2); +export const signInWithCredential = ÉĩzoneWrap(_signInWithCredential, true, 2); +export const signInWithCustomToken = ÉĩzoneWrap(_signInWithCustomToken, true, 2); +export const signInWithEmailAndPassword = ÉĩzoneWrap(_signInWithEmailAndPassword, true, 2); +export const signInWithEmailLink = ÉĩzoneWrap(_signInWithEmailLink, true, 2); +export const signInWithPhoneNumber = ÉĩzoneWrap(_signInWithPhoneNumber, true, 2); +export const signInWithPopup = ÉĩzoneWrap(_signInWithPopup, true, 2); +export const signInWithRedirect = ÉĩzoneWrap(_signInWithRedirect, true, 2); +export const signOut = ÉĩzoneWrap(_signOut, true, 2); +export const unlink = ÉĩzoneWrap(_unlink, true, 2); +export const updateCurrentUser = ÉĩzoneWrap(_updateCurrentUser, true, 2); +export const updateEmail = ÉĩzoneWrap(_updateEmail, true, 2); +export const updatePassword = ÉĩzoneWrap(_updatePassword, true, 2); +export const updatePhoneNumber = ÉĩzoneWrap(_updatePhoneNumber, true, 2); +export const updateProfile = ÉĩzoneWrap(_updateProfile, true, 2); +export const useDeviceLanguage = ÉĩzoneWrap(_useDeviceLanguage, true, 2); +export const validatePassword = ÉĩzoneWrap(_validatePassword, true, 2); +export const verifyBeforeUpdateEmail = ÉĩzoneWrap(_verifyBeforeUpdateEmail, true, 2); +export const verifyPasswordResetCode = ÉĩzoneWrap(_verifyPasswordResetCode, true, 2); diff --git a/src/auth/ng-package.json b/src/auth/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/auth/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/auth/package.json b/src/auth/package.json index 65be0782f..5e8aa1496 100644 --- a/src/auth/package.json +++ b/src/auth/package.json @@ -1 +1,3 @@ -{ "main": "../bundles/angularfire2.umd.js" } \ No newline at end of file +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} \ No newline at end of file diff --git a/src/auth/public_api.ts b/src/auth/public_api.ts new file mode 100644 index 000000000..6267eb92a --- /dev/null +++ b/src/auth/public_api.ts @@ -0,0 +1,4 @@ +export { Auth, AuthInstances, authInstance$ } from './auth'; +export { provideAuth, AuthModule } from './auth.module'; +export * from './rxfire'; +export * from './firebase'; diff --git a/src/auth/rxfire.ts b/src/auth/rxfire.ts new file mode 100644 index 000000000..561f853bb --- /dev/null +++ b/src/auth/rxfire.ts @@ -0,0 +1,11 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +import { ÉĩzoneWrap } from '@angular/fire'; +import { + authState as _authState, + idToken as _idToken, + user as _user +} from 'rxfire/auth'; + +export const authState = ÉĩzoneWrap(_authState, true); +export const idToken = ÉĩzoneWrap(_idToken, true); +export const user = ÉĩzoneWrap(_user, true); diff --git a/src/compat/analytics/analytics.module.ts b/src/compat/analytics/analytics.module.ts new file mode 100644 index 000000000..dd9c0d6a1 --- /dev/null +++ b/src/compat/analytics/analytics.module.ts @@ -0,0 +1,23 @@ +import { NgModule, Optional } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFireAnalytics } from './analytics'; +import { ScreenTrackingService } from './screen-tracking.service'; +import { UserTrackingService } from './user-tracking.service'; + +@NgModule({ + providers: [ AngularFireAnalytics ] +}) +export class AngularFireAnalyticsModule { + constructor( + analytics: AngularFireAnalytics, + // eslint-disable-next-line @typescript-eslint/no-unused-vars + @Optional() screenTracking: ScreenTrackingService, + // eslint-disable-next-line @typescript-eslint/no-unused-vars + @Optional() userTracking: UserTrackingService, + ) { + firebase.registerVersion('angularfire', VERSION.full, 'analytics-compat'); + // calling anything on analytics will eagerly load the SDK + analytics.app.then(() => undefined); + } +} diff --git a/src/compat/analytics/analytics.spec.ts b/src/compat/analytics/analytics.spec.ts new file mode 100644 index 000000000..a05a23c5f --- /dev/null +++ b/src/compat/analytics/analytics.spec.ts @@ -0,0 +1,30 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFireAnalytics, AngularFireAnalyticsModule } from '@angular/fire/compat/analytics'; +import { COMMON_CONFIG } from '../../test-config'; +import { rando } from '../../utils'; + + +describe('AngularFireAnalytics', () => { + let analytics: AngularFireAnalytics; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireAnalyticsModule + ] + }); + + analytics = TestBed.inject(AngularFireAnalytics); + }); + + it('should be exist', () => { + expect(analytics instanceof AngularFireAnalytics).toBe(true); + }); + + it('should have the Firebase Functions instance', () => { + expect(analytics.app).toBeDefined(); + }); + +}); diff --git a/src/compat/analytics/analytics.ts b/src/compat/analytics/analytics.ts new file mode 100644 index 000000000..c7c9b22f0 --- /dev/null +++ b/src/compat/analytics/analytics.ts @@ -0,0 +1,162 @@ +import { isPlatformBrowser } from '@angular/common'; +import { Inject, Injectable, InjectionToken, NgZone, Optional, PLATFORM_ID } from '@angular/core'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { ÉĩPromiseProxy, ÉĩapplyMixins, ÉĩcacheInstance, ÉĩlazySDKProxy } from '@angular/fire/compat'; +import { FirebaseApp } from '@angular/fire/compat'; +import { isSupported } from 'firebase/analytics'; +import firebase from 'firebase/compat/app'; +import { EMPTY, of } from 'rxjs'; +import { map, observeOn, shareReplay, switchMap } from 'rxjs/operators'; +import { proxyPolyfillCompat } from './base'; + +export type Config = Record; + +export const COLLECTION_ENABLED = new InjectionToken('angularfire2.analytics.analyticsCollectionEnabled'); +export const APP_VERSION = new InjectionToken('angularfire2.analytics.appVersion'); +export const APP_NAME = new InjectionToken('angularfire2.analytics.appName'); +export const DEBUG_MODE = new InjectionToken('angularfire2.analytics.debugMode'); +export const CONFIG = new InjectionToken('angularfire2.analytics.config'); + +const APP_NAME_KEY = 'app_name'; +const APP_VERSION_KEY = 'app_version'; +const DEBUG_MODE_KEY = 'debug_mode'; +const GTAG_CONFIG_COMMAND = 'config'; +const GTAG_FUNCTION_NAME = 'gtag'; // TODO rename these +const DATA_LAYER_NAME = 'dataLayer'; +const SEND_TO_KEY = 'send_to'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AngularFireAnalytics extends ÉĩPromiseProxy { +} + +@Injectable({ + providedIn: 'any' +}) +export class AngularFireAnalytics { + + private measurementId: string; + private analyticsInitialized = new Promise(() => undefined); + + async updateConfig(config: Config) { + await this.analyticsInitialized; + window[GTAG_FUNCTION_NAME](GTAG_CONFIG_COMMAND, this.measurementId, { ...config, update: true }); + } + + constructor( + app: FirebaseApp, + @Optional() @Inject(COLLECTION_ENABLED) analyticsCollectionEnabled: boolean | null, + @Optional() @Inject(APP_VERSION) providedAppVersion: string | null, + @Optional() @Inject(APP_NAME) providedAppName: string | null, + @Optional() @Inject(DEBUG_MODE) debugModeEnabled: boolean | null, + @Optional() @Inject(CONFIG) providedConfig: Config | null, + // eslint-disable-next-line @typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object, + zone: NgZone, + schedulers: ÉĩAngularFireSchedulers, + ) { + + if (isPlatformBrowser(platformId)) { + + window[DATA_LAYER_NAME] = window[DATA_LAYER_NAME] || []; + + // It turns out we can't rely on the measurementId in the Firebase config JSON + // this identifier is not stable. firebase/analytics does a call to get a fresh value + // falling back on the one in the config. Rather than do that ourselves we should listen + // on our gtag function for a analytics config command + // e.g, ['config', measurementId, { origin: 'firebase', firebase_id }] + const parseMeasurementId = (...args: any[]) => { + if (args[0] === 'config' && args[2].origin === 'firebase') { + this.measurementId = args[1]; + return true; + } else { + return false; + } + }; + + const patchGtag = (fn?: (...args: any[]) => void) => { + window[GTAG_FUNCTION_NAME] = (...args: any[]) => { + if (fn) { + fn(...args); + } + // Inject app_name and app_version into events + // TODO(jamesdaniels): I'm doing this as documented but it's still not + // showing up in the console. Investigate. Guessing it's just part of the + // whole GA4 transition mess. + if (args[0] === 'event' && args[2][SEND_TO_KEY] === this.measurementId) { + if (providedAppName) { + args[2][APP_NAME_KEY] = providedAppName; + } + if (providedAppVersion) { + args[2][APP_VERSION_KEY] = providedAppVersion; + } + } + if (debugModeEnabled && typeof console !== 'undefined') { + // eslint-disable-next-line no-console + console.info(...args); + } + /** + * According to the gtag documentation, this function that defines a custom data layer cannot be + * an arrow function because 'arguments' is not an array. It is actually an object that behaves + * like an array and contains more information then just indexes. Transforming this into arrow function + * caused issue #2505 where analytics no longer sent any data. + */ + (function(..._args: any[]) { + window[DATA_LAYER_NAME].push(arguments); + })(...args); + }; + }; + + // Unclear if we still need to but I was running into config/events I passed + // to gtag before ['js' timestamp] weren't getting parsed, so let's make a promise + // that resolves when firebase/analytics has configured gtag.js that we wait on + // before sending anything + const firebaseAnalyticsAlreadyInitialized = window[DATA_LAYER_NAME].some(parseMeasurementId); + if (firebaseAnalyticsAlreadyInitialized) { + this.analyticsInitialized = Promise.resolve(); + patchGtag(); + } else { + this.analyticsInitialized = new Promise(resolve => { + patchGtag((...args) => { + if (parseMeasurementId(...args)) { + resolve(); + } + }); + }); + } + + if (providedConfig) { + this.updateConfig(providedConfig); + } + if (debugModeEnabled) { + this.updateConfig({ [DEBUG_MODE_KEY]: 1 }); + } + + } else { + + this.analyticsInitialized = Promise.resolve(); + + } + + const analytics = of(undefined).pipe( + observeOn(schedulers.outsideAngular), + switchMap(isSupported), + switchMap(supported => supported ? zone.runOutsideAngular(() => import('firebase/compat/analytics')) : EMPTY), + map(() => { + return ÉĩcacheInstance(`analytics`, 'AngularFireAnalytics', app.name, () => { + const analytics = app.analytics(); + if (analyticsCollectionEnabled === false) { + analytics.setAnalyticsCollectionEnabled(false); + } + return analytics; + }, [app, analyticsCollectionEnabled, providedConfig, debugModeEnabled]); + }), + shareReplay({ bufferSize: 1, refCount: false }) + ); + + return ÉĩlazySDKProxy(this, analytics, zone); + + } + +} + +ÉĩapplyMixins(AngularFireAnalytics, [proxyPolyfillCompat]); diff --git a/src/compat/analytics/base.ts b/src/compat/analytics/base.ts new file mode 100644 index 000000000..2af7d5d77 --- /dev/null +++ b/src/compat/analytics/base.ts @@ -0,0 +1,10 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +// Export a null object with the same keys as firebase/compat/analytics, so Proxy can work with proxy-polyfill in Internet Explorer +export const proxyPolyfillCompat = { + app: null, + logEvent: null, + setCurrentScreen: null, + setUserId: null, + setUserProperties: null, + setAnalyticsCollectionEnabled: null, +}; diff --git a/src/compat/analytics/index.ts b/src/compat/analytics/index.ts new file mode 100644 index 000000000..4aaf8f92e --- /dev/null +++ b/src/compat/analytics/index.ts @@ -0,0 +1 @@ +export * from './public_api'; diff --git a/src/compat/analytics/ng-package.json b/src/compat/analytics/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/analytics/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/analytics/package.json b/src/compat/analytics/package.json new file mode 100644 index 000000000..5eaf9d5f0 --- /dev/null +++ b/src/compat/analytics/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/analytics/public_api.ts b/src/compat/analytics/public_api.ts new file mode 100644 index 000000000..4601131aa --- /dev/null +++ b/src/compat/analytics/public_api.ts @@ -0,0 +1,4 @@ +export * from './analytics'; +export * from './analytics.module'; +export * from './screen-tracking.service'; +export * from './user-tracking.service'; diff --git a/src/compat/analytics/screen-tracking.service.ts b/src/compat/analytics/screen-tracking.service.ts new file mode 100644 index 000000000..5ceec926b --- /dev/null +++ b/src/compat/analytics/screen-tracking.service.ts @@ -0,0 +1,47 @@ +import { ComponentFactoryResolver, Injectable, NgZone, OnDestroy, Optional } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import { ÉĩscreenViewEvent } from '@angular/fire/analytics'; +import { Title } from '@angular/platform-browser'; +import { Router } from '@angular/router'; +import firebase from 'firebase/compat/app'; +import { Subscription } from 'rxjs'; +import { switchMap } from 'rxjs/operators'; +import { AngularFireAnalytics } from './analytics'; +import { UserTrackingService } from './user-tracking.service'; + +const SCREEN_VIEW_EVENT = 'screen_view'; + +@Injectable() +export class ScreenTrackingService implements OnDestroy { + + private disposable: Subscription | undefined; + + constructor( + analytics: AngularFireAnalytics, + @Optional() router: Router, + @Optional() title: Title, + componentFactoryResolver: ComponentFactoryResolver, + zone: NgZone, + @Optional() userTrackingService: UserTrackingService, + ) { + firebase.registerVersion('angularfire', VERSION.full, 'compat-screen-tracking'); + if (!router || !analytics) { return this; } + zone.runOutsideAngular(() => { + this.disposable = ÉĩscreenViewEvent(router, title, componentFactoryResolver).pipe( + switchMap(async params => { + if (userTrackingService) { + await userTrackingService.initialized; + } + return await analytics.logEvent(SCREEN_VIEW_EVENT, params); + }) + ).subscribe(); + }); + } + + ngOnDestroy() { + if (this.disposable) { + this.disposable.unsubscribe(); + } + } + +} diff --git a/src/compat/analytics/user-tracking.service.ts b/src/compat/analytics/user-tracking.service.ts new file mode 100644 index 000000000..ea66b2bd1 --- /dev/null +++ b/src/compat/analytics/user-tracking.service.ts @@ -0,0 +1,51 @@ +import { isPlatformBrowser } from '@angular/common'; +import { Inject, Injectable, NgZone, OnDestroy, PLATFORM_ID } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import { AngularFireAuth } from '@angular/fire/compat/auth'; +import firebase from 'firebase/compat/app'; +import { Subscription } from 'rxjs'; +import { AngularFireAnalytics } from './analytics'; + +@Injectable() +export class UserTrackingService implements OnDestroy { + + initialized: Promise; + private disposables: Subscription[] = []; + + // TODO a user properties injector + constructor( + analytics: AngularFireAnalytics, + // eslint-disable-next-line @typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object, + auth: AngularFireAuth, + zone: NgZone, + ) { + firebase.registerVersion('angularfire', VERSION.full, 'compat-user-tracking'); + if (isPlatformBrowser(platformId)) { + let resolveInitialized; + this.initialized = zone.runOutsideAngular(() => new Promise(resolve => resolveInitialized = resolve)); + this.disposables = [ + auth.authState.subscribe(user => { + analytics.setUserId(user?.uid); + resolveInitialized(); + }), + auth.credential.subscribe(credential => { + if (credential) { + const method = credential.user.isAnonymous ? 'anonymous' : credential.additionalUserInfo.providerId; + if (credential.additionalUserInfo.isNewUser) { + analytics.logEvent('sign_up', { method }); + } + analytics.logEvent('login', { method }); + } + }) + ]; + } else { + this.initialized = Promise.resolve(); + } + + } + + ngOnDestroy() { + this.disposables.forEach(it => it.unsubscribe()); + } +} diff --git a/src/compat/angularfire2.spec.ts b/src/compat/angularfire2.spec.ts new file mode 100644 index 000000000..aa87b16b0 --- /dev/null +++ b/src/compat/angularfire2.spec.ts @@ -0,0 +1,98 @@ +import { CompilerFactory, DoBootstrap, NgModule, PlatformRef } from '@angular/core'; +import { TestBed } from '@angular/core/testing'; +import { ÉĩZoneScheduler } from '@angular/fire'; +import { AngularFireModule, FirebaseApp } from '@angular/fire/compat'; +import { BrowserModule } from '@angular/platform-browser'; +import { TestScheduler } from 'rxjs/testing'; +import { COMMON_CONFIG } from '../../src/test-config'; +import { rando } from '../../src/utils'; + +describe('angularfire', () => { + let app: FirebaseApp; + let defaultPlatform: PlatformRef; + let appName: string; + + beforeEach(() => { + + appName = rando(); + + TestBed.configureTestingModule({ + imports: [AngularFireModule.initializeApp(COMMON_CONFIG, appName)] + }); + + app = TestBed.inject(FirebaseApp); + defaultPlatform = TestBed.inject(PlatformRef); + }); + + describe('ZoneScheduler', () => { + it('should execute the scheduled work inside the specified zone', done => { + const ngZone = Zone.current.fork({ + name: 'ngZone' + }); + const rootZone = Zone.current; + + // Mimic real behavior: Executing in Angular + ngZone.run(() => { + const outsideAngularScheduler = new ÉĩZoneScheduler(rootZone); + outsideAngularScheduler.schedule(() => { + expect(Zone.current.name).not.toEqual('ngZone'); + done(); + }); + }); + }); + + it('should execute nested scheduled work inside the specified zone', done => { + const testScheduler = new TestScheduler(null); + testScheduler.run(helpers => { + const outsideAngularScheduler = new ÉĩZoneScheduler(Zone.current, testScheduler); + + const ngZone = Zone.current.fork({ + name: 'ngZone' + }); + + let callbacksRan = 0; + + // Mimic real behavior: Executing in Angular + ngZone.run(() => { + outsideAngularScheduler.schedule(() => { + callbacksRan++; + expect(Zone.current.name).not.toEqual('ngZone'); + + ngZone.run(() => { + // Sync queueing + outsideAngularScheduler.schedule(() => { + callbacksRan++; + expect(Zone.current.name).not.toEqual('ngZone'); + }); + + // Async (10ms delay) nested scheduling + outsideAngularScheduler.schedule(() => { + callbacksRan++; + expect(Zone.current.name).not.toEqual('ngZone'); + }, 10); + + // Simulate flush from inside angular- + helpers.flush(); + done(); + expect(callbacksRan).toEqual(3); + }); + }); + helpers.flush(); + }); + }); + }); + }); + + describe('FirebaseApp', () => { + + it('should provide a FirebaseApp for the FirebaseApp binding', () => { + expect(typeof app.delete).toBe('function'); + }); + + if (typeof window !== 'undefined') { + it('should have the provided name', () => { + expect(app.name).toBe(appName); + }); + } + }); +}); diff --git a/src/compat/auth-guard/auth-guard.module.ts b/src/compat/auth-guard/auth-guard.module.ts new file mode 100644 index 000000000..42012c6f9 --- /dev/null +++ b/src/compat/auth-guard/auth-guard.module.ts @@ -0,0 +1,13 @@ +import { NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFireAuthGuard } from './auth-guard'; + +@NgModule({ + providers: [ AngularFireAuthGuard ] +}) +export class AngularFireAuthGuardModule { + constructor() { + firebase.registerVersion('angularfire', VERSION.full, 'auth-guard-compat'); + } +} diff --git a/src/compat/auth-guard/auth-guard.spec.ts b/src/compat/auth-guard/auth-guard.spec.ts new file mode 100644 index 000000000..808417461 --- /dev/null +++ b/src/compat/auth-guard/auth-guard.spec.ts @@ -0,0 +1,34 @@ +import { APP_BASE_HREF } from '@angular/common'; +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFireAuthGuard, AngularFireAuthGuardModule } from '@angular/fire/compat/auth-guard'; +import { Router, RouterModule } from '@angular/router'; +import { COMMON_CONFIG } from '../../../src/test-config'; +import { rando } from '../../../src/utils'; + +class TestComponent { } + +describe('AngularFireAuthGuard', () => { + let router: Router; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireAuthGuardModule, + RouterModule.forRoot([ + { path: 'a', component: TestComponent, canActivate: [AngularFireAuthGuard] } + ]) + ], + providers: [ + { provide: APP_BASE_HREF, useValue: 'http://localhost:4200/' } + ] + }); + + router = TestBed.inject(Router); + }); + + it('should be injectable', () => { + expect(router).toBeTruthy(); + }); +}); diff --git a/src/compat/auth-guard/auth-guard.ts b/src/compat/auth-guard/auth-guard.ts new file mode 100644 index 000000000..9be909838 --- /dev/null +++ b/src/compat/auth-guard/auth-guard.ts @@ -0,0 +1,55 @@ +import { Injectable } from '@angular/core'; +import { AngularFireAuth } from '@angular/fire/compat/auth'; +import { ActivatedRouteSnapshot, CanActivate, Router, RouterStateSnapshot } from '@angular/router'; +import firebase from 'firebase/compat/app'; +import { Observable, UnaryFunction, of, pipe } from 'rxjs'; +import { map, switchMap, take } from 'rxjs/operators'; + +export type AuthPipeGenerator = (next: ActivatedRouteSnapshot, state: RouterStateSnapshot) => AuthPipe; +export type AuthPipe = UnaryFunction, Observable>; + +export const loggedIn: AuthPipe = map(user => !!user); + +@Injectable({ + providedIn: 'any' +}) +export class AngularFireAuthGuard implements CanActivate { + + constructor(private router: Router, private auth: AngularFireAuth) {} + + canActivate = (next: ActivatedRouteSnapshot, state: RouterStateSnapshot) => { + const authPipeFactory = next.data.authGuardPipe as AuthPipeGenerator || (() => loggedIn); + return this.auth.user.pipe( + take(1), + authPipeFactory(next, state), + map(can => { + if (typeof can === 'boolean') { + return can; + } else if (Array.isArray(can)) { + return this.router.createUrlTree(can); + } else { + // TODO(EdricChan03): Add tests + return this.router.parseUrl(can); + } + }) + ); + } + +} + +export const canActivate = (pipe: AuthPipeGenerator) => ({ + canActivate: [ AngularFireAuthGuard ], data: { authGuardPipe: pipe } +}); + + +export const isNotAnonymous: AuthPipe = map(user => !!user && !user.isAnonymous); +export const idTokenResult = switchMap((user: firebase.User|null) => user ? user.getIdTokenResult() : of(null)); +export const emailVerified: AuthPipe = map(user => !!user && user.emailVerified); +export const customClaims = pipe(idTokenResult, map(idTokenResult => idTokenResult ? idTokenResult.claims : [])); +export const hasCustomClaim: (claim: string) => AuthPipe = + // eslint-disable-next-line no-prototype-builtins + (claim) => pipe(customClaims, map(claims => claims.hasOwnProperty(claim))); +export const redirectUnauthorizedTo: (redirect: string|any[]) => AuthPipe = + (redirect) => pipe(loggedIn, map(loggedIn => loggedIn || redirect)); +export const redirectLoggedInTo: (redirect: string|any[]) => AuthPipe = + (redirect) => pipe(loggedIn, map(loggedIn => loggedIn && redirect || true)); diff --git a/src/compat/auth-guard/ng-package.json b/src/compat/auth-guard/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/auth-guard/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/auth-guard/package.json b/src/compat/auth-guard/package.json new file mode 100644 index 000000000..5eaf9d5f0 --- /dev/null +++ b/src/compat/auth-guard/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/auth-guard/public_api.ts b/src/compat/auth-guard/public_api.ts new file mode 100644 index 000000000..468fd9657 --- /dev/null +++ b/src/compat/auth-guard/public_api.ts @@ -0,0 +1,2 @@ +export * from './auth-guard'; +export * from './auth-guard.module'; diff --git a/src/compat/auth/auth.module.ts b/src/compat/auth/auth.module.ts new file mode 100644 index 000000000..3cc268eef --- /dev/null +++ b/src/compat/auth/auth.module.ts @@ -0,0 +1,13 @@ +import { NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFireAuth } from './auth'; + +@NgModule({ + providers: [ AngularFireAuth ] +}) +export class AngularFireAuthModule { + constructor() { + firebase.registerVersion('angularfire', VERSION.full, 'auth-compat'); + } +} diff --git a/src/compat/auth/auth.spec.ts b/src/compat/auth/auth.spec.ts new file mode 100644 index 000000000..3cc191666 --- /dev/null +++ b/src/compat/auth/auth.spec.ts @@ -0,0 +1,164 @@ +/* eslint-disable @typescript-eslint/ban-ts-comment */ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule, FIREBASE_APP_NAME, FIREBASE_OPTIONS, FirebaseApp } from '@angular/fire/compat'; +import { AngularFireAuth, AngularFireAuthModule, SETTINGS, USE_EMULATOR } from '@angular/fire/compat/auth'; +import firebase from 'firebase/compat/app'; +import { Observable, Subject } from 'rxjs'; +import { COMMON_CONFIG, authEmulatorPort } from '../../../src/test-config'; +import 'firebase/compat/auth'; +import { rando } from '../../../src/utils'; + +const firebaseUser = { + uid: '12345', + providerData: [{ displayName: 'jeffbcrossyface' }] +} as firebase.User; + +describe('AngularFireAuth', () => { + let afAuth: AngularFireAuth; + let mockAuthState: Subject; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireAuthModule + ], + providers: [ + { provide: SETTINGS, useValue: { appVerificationDisabledForTesting: true } }, + { provide: USE_EMULATOR, useValue: [`http://localhost:${authEmulatorPort}`] }, + ] + }); + + afAuth = TestBed.inject(AngularFireAuth); + + mockAuthState = new Subject(); + // @ts-ignore + spyOn(afAuth, 'authState').and.returnValue(mockAuthState); + // @ts-ignore + spyOn(afAuth, 'idToken').and.returnValue(mockAuthState); + (afAuth as any).authState = mockAuthState as Observable; + (afAuth as any).idToken = mockAuthState as Observable; + }); + + describe('Zones', () => { + it('should call operators and subscriber in the same zone as when service was initialized', (done) => { + // Initialize the app outside of the zone, to mimick real life behavior. + const ngZone = Zone.current.fork({ + name: 'ngZone' + }); + ngZone.run(() => { + const subs = [ + afAuth.authState.subscribe(() => { + expect(Zone.current.name).toBe('ngZone'); + done(); + }, done.fail), + // afAuth.authState.subscribe(() => { + // expect(Zone.current.name).toBe('ngZone'); + // done(); + // }, done.fail) + ]; + mockAuthState.next(firebaseUser); + subs.forEach(s => s.unsubscribe()); + }); + }); + }); + + it('should exist', () => { + expect(afAuth instanceof AngularFireAuth).toBe(true); + }); + + it('should have an initialized Firebase app', () => { + expect(afAuth.app).toBeDefined(); + }); + + it('should have disabled app verification for testing', async () => { + const app = await afAuth.app; + expect(app.auth().settings.appVerificationDisabledForTesting).toBe(true); + }); + + it('should emit auth updates through authState', (done: any) => { + let count = 0; + + // Check that the first value is null and second is the auth user + const subs = afAuth.authState.subscribe({ + next: (user => { + if (count === 0) { + expect(user).toBe(null); + count = count + 1; + mockAuthState.next(firebaseUser); + } else { + expect(user).toEqual(firebaseUser); + subs.unsubscribe(); + done(); + } + }), + error: done, + complete: done.fail + }); + mockAuthState.next(null); + }); + + it('should emit auth updates through idToken', (done: any) => { + let count = 0; + + // Check that the first value is null and second is the auth user + const subs = afAuth.idToken.subscribe({ + next: user => { + if (count === 0) { + expect(user).toBe(null); + count = count + 1; + mockAuthState.next(firebaseUser); + } else { + expect(user as any).toEqual(firebaseUser); + subs.unsubscribe(); + done(); + } + }, + error: done, + complete: done.fail + }); + mockAuthState.next(null); + }); + +}); + +describe('AngularFireAuth with different app', () => { + let app: FirebaseApp; + let afAuth: AngularFireAuth; + let firebaseAppName: string; + + beforeEach(() => { + firebaseAppName = rando(); + + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireAuthModule + ], + providers: [ + { provide: FIREBASE_APP_NAME, useValue: firebaseAppName }, + { provide: FIREBASE_OPTIONS, useValue: COMMON_CONFIG }, + { provide: USE_EMULATOR, useValue: [`http://localhost:${authEmulatorPort}`] }, + ] + }); + app = TestBed.inject(FirebaseApp); + afAuth = TestBed.inject(AngularFireAuth); + }); + + describe('', () => { + + it('should be an AngularFireAuth type', () => { + expect(afAuth instanceof AngularFireAuth).toEqual(true); + }); + + it('should have an initialized Firebase app', () => { + expect(afAuth.app).toBeDefined(); + }); + + it('should have an initialized Firebase app instance member', async () => { + const itsApp = await afAuth.app; + expect(itsApp).toEqual(app); + }); + }); + +}); diff --git a/src/compat/auth/auth.ts b/src/compat/auth/auth.ts new file mode 100644 index 000000000..f3338367b --- /dev/null +++ b/src/compat/auth/auth.ts @@ -0,0 +1,203 @@ +import { isPlatformServer } from '@angular/common'; +import { EnvironmentInjector, Inject, Injectable, InjectionToken, NgZone, Optional, PLATFORM_ID, inject } from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { ÉĩPromiseProxy, ÉĩapplyMixins, ÉĩlazySDKProxy } from '@angular/fire/compat'; +import { FIREBASE_APP_NAME, FIREBASE_OPTIONS, FirebaseApp, ÉĩcacheInstance, ÉĩfirebaseAppFactory } from '@angular/fire/compat'; +import { FirebaseOptions } from 'firebase/app'; +import firebase from 'firebase/compat/app'; +import { Observable, Subject, from, merge, of } from 'rxjs'; +import { filter, first, map, observeOn, shareReplay, subscribeOn, switchMap, switchMapTo } from 'rxjs/operators'; +import { proxyPolyfillCompat } from './base'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AngularFireAuth extends ÉĩPromiseProxy {} + +type UseEmulatorArguments = Parameters; +export const USE_EMULATOR = new InjectionToken('angularfire2.auth.use-emulator'); + +export const SETTINGS = new InjectionToken('angularfire2.auth.settings'); +export const TENANT_ID = new InjectionToken('angularfire2.auth.tenant-id'); +export const LANGUAGE_CODE = new InjectionToken('angularfire2.auth.langugage-code'); +export const USE_DEVICE_LANGUAGE = new InjectionToken('angularfire2.auth.use-device-language'); +export const PERSISTENCE = new InjectionToken('angularfire.auth.persistence'); + +export const ÉĩauthFactory = ( + app: FirebaseApp, zone: NgZone, useEmulator: UseEmulatorArguments|null, + tenantId: string, languageCode: string|null, useDeviceLanguage: boolean|null, + settings: firebase.auth.AuthSettings|null, persistence: string|null, +) => ÉĩcacheInstance(`${app.name}.auth`, 'AngularFireAuth', app.name, () => { + const auth = zone.runOutsideAngular(() => app.auth()); + if (useEmulator) { + auth.useEmulator(...useEmulator); + } + if (tenantId) { + auth.tenantId = tenantId; + } + auth.languageCode = languageCode; + if (useDeviceLanguage) { + auth.useDeviceLanguage(); + } + if (settings) { + for (const [k, v] of Object.entries(settings)) { + auth.settings[k] = v; + } + } + if (persistence) { + auth.setPersistence(persistence); + } + return auth; +}, [useEmulator, tenantId, languageCode, useDeviceLanguage, settings, persistence]); + +@Injectable({ + providedIn: 'any' +}) +export class AngularFireAuth { + + private readonly injector = inject(EnvironmentInjector); + + /** + * Observable of authentication state; as of Firebase 4.0 this is only triggered via sign-in/out + */ + public readonly authState: Observable; + + /** + * Observable of the currently signed-in user's JWT token used to identify the user to a Firebase service (or null). + */ + public readonly idToken: Observable; + + /** + * Observable of the currently signed-in user (or null). + */ + public readonly user: Observable; + + /** + * Observable of the currently signed-in user's IdTokenResult object which contains the ID token JWT string and other + * helper properties for getting different data associated with the token as well as all the decoded payload claims + * (or null). + */ + public readonly idTokenResult: Observable; + + /** + * Observable of the currently signed-in user's credential, or null + */ + public readonly credential: Observable|null>; + + constructor( + @Inject(FIREBASE_OPTIONS) options: FirebaseOptions, + @Optional() @Inject(FIREBASE_APP_NAME) name: string|null|undefined, + // eslint-disable-next-line @typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object, + zone: NgZone, + schedulers: ÉĩAngularFireSchedulers, + @Optional() @Inject(USE_EMULATOR) useEmulator: any, // can't use the tuple here + @Optional() @Inject(SETTINGS) settings: any, // can't use firebase.auth.AuthSettings here + @Optional() @Inject(TENANT_ID) tenantId: string | null, + @Optional() @Inject(LANGUAGE_CODE) languageCode: string | null, + @Optional() @Inject(USE_DEVICE_LANGUAGE) useDeviceLanguage: boolean | null, + @Optional() @Inject(PERSISTENCE) persistence: string | null, + @Optional() _appCheckInstances: AppCheckInstances, + ) { + const logins = new Subject>(); + + const auth = of(undefined).pipe( + observeOn(schedulers.outsideAngular), + switchMap(() => zone.runOutsideAngular(() => import('firebase/compat/auth'))), + map(() => ÉĩfirebaseAppFactory(options, zone, name)), + map(app => ÉĩauthFactory(app, zone, useEmulator, tenantId, languageCode, useDeviceLanguage, settings, persistence)), + shareReplay({ bufferSize: 1, refCount: false }), + ); + + if (isPlatformServer(platformId)) { + + this.authState = this.user = this.idToken = this.idTokenResult = this.credential = of(null); + + } else { + + // HACK, as we're exporting auth.Auth, rather than auth, developers importing firebase.auth + // (e.g, `import { auth } from 'firebase/compat/app'`) are getting an undefined auth object unexpectedly + // as we're completely lazy. Let's eagerly load the Auth SDK here. + // There could potentially be race conditions still... but this greatly decreases the odds while + // we reevaluate the API. + auth.pipe(first()).subscribe(); + + const redirectResult = auth.pipe( + switchMap(auth => auth.getRedirectResult().then(it => it, () => null)), + pendingUntilEvent(this.injector), + shareReplay({ bufferSize: 1, refCount: false }), + ); + + const authStateChanged = auth.pipe( + switchMap(auth => new Observable(sub => + ({ unsubscribe: zone.runOutsideAngular(() => auth.onAuthStateChanged( + next => sub.next(next), + err => sub.error(err), + () => sub.complete() + ))}) + )), + ); + + const idTokenChanged = auth.pipe( + switchMap(auth => new Observable(sub => + ({ unsubscribe: zone.runOutsideAngular(() => auth.onIdTokenChanged( + next => sub.next(next), + err => sub.error(err), + () => sub.complete() + ))}) + )) + ); + + this.authState = redirectResult.pipe( + switchMapTo(authStateChanged), + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + ); + + this.user = redirectResult.pipe( + switchMapTo(idTokenChanged), + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + ); + + this.idToken = this.user.pipe( + switchMap(user => user ? from(user.getIdToken()) : of(null)) + ); + + this.idTokenResult = this.user.pipe( + switchMap(user => user ? from(user.getIdTokenResult()) : of(null)) + ); + + this.credential = merge( + redirectResult, + logins, + // pipe in null authState to make credential zipable, just a weird devexp if + // authState and user go null to still have a credential + this.authState.pipe(filter(it => !it)) + ).pipe( + // handle the { user: { } } when a user is already logged in, rather have null + // TODO handle the type corcersion better + map(credential => credential?.user ? credential as Required : null), + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + ); + + } + + return ÉĩlazySDKProxy(this, auth, zone, { spy: { + apply: (name, _, val) => { + // If they call a signIn or createUser function listen into the promise + // this will give us the user credential, push onto the logins Subject + // to be consumed in .credential + if (name.startsWith('signIn') || name.startsWith('createUser')) { + // TODO fix the types, the trouble is UserCredential has everything optional + val.then((user: firebase.auth.UserCredential) => logins.next(user as any)); + } + } + }}); + + } + +} + +ÉĩapplyMixins(AngularFireAuth, [proxyPolyfillCompat]); diff --git a/src/compat/auth/base.ts b/src/compat/auth/base.ts new file mode 100644 index 000000000..9b1e84b18 --- /dev/null +++ b/src/compat/auth/base.ts @@ -0,0 +1,38 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +// Export a null object with the same keys as firebase/compat/auth, so Proxy can work with proxy-polyfill in Internet Explorer +export const proxyPolyfillCompat = { + name: null, + config: null, + emulatorConfig: null, + app: null, + applyActionCode: null, + checkActionCode: null, + confirmPasswordReset: null, + createUserWithEmailAndPassword: null, + currentUser: null, + fetchSignInMethodsForEmail: null, + isSignInWithEmailLink: null, + getRedirectResult: null, + languageCode: null, + settings: null, + onAuthStateChanged: null, + onIdTokenChanged: null, + sendSignInLinkToEmail: null, + sendPasswordResetEmail: null, + setPersistence: null, + signInAndRetrieveDataWithCredential: null, + signInAnonymously: null, + signInWithCredential: null, + signInWithCustomToken: null, + signInWithEmailAndPassword: null, + signInWithPhoneNumber: null, + signInWithEmailLink: null, + signInWithPopup: null, + signInWithRedirect: null, + signOut: null, + tenantId: null, + updateCurrentUser: null, + useDeviceLanguage: null, + useEmulator: null, + verifyPasswordResetCode: null, +}; diff --git a/src/compat/auth/ng-package.json b/src/compat/auth/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/auth/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/auth/package.json b/src/compat/auth/package.json new file mode 100644 index 000000000..5eaf9d5f0 --- /dev/null +++ b/src/compat/auth/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/auth/public_api.ts b/src/compat/auth/public_api.ts new file mode 100644 index 000000000..9948840d5 --- /dev/null +++ b/src/compat/auth/public_api.ts @@ -0,0 +1,5 @@ + +import 'firebase/compat/auth'; // removed in build process when not UMD + +export * from './auth'; +export * from './auth.module'; diff --git a/src/compat/cache.ts b/src/compat/cache.ts new file mode 100644 index 000000000..108b6beaf --- /dev/null +++ b/src/compat/cache.ts @@ -0,0 +1,35 @@ +import { isDevMode } from '@angular/core'; + +export function ÉĩcacheInstance(cacheKey: any, moduleName: string, appName: string, fn: () => T, deps: any): T { + const [, instance, cachedDeps] = globalThis.ÉĩAngularfireInstanceCache.find((it: any) => it[0] === cacheKey) || []; + if (instance) { + if (!matchDep(deps, cachedDeps)) { + log('error', `${moduleName} was already initialized on the ${appName} Firebase App with different settings.${IS_HMR ? ' You may need to reload as Firebase is not HMR aware.' : ''}`); + log('warn', {is: deps, was: cachedDeps}); + } + return instance; + } else { + const newInstance = fn(); + globalThis.ÉĩAngularfireInstanceCache.push([cacheKey, newInstance, deps]); + return newInstance; + } +} + +function matchDep(a: any, b: any) { + try { + return a.toString() === b.toString(); + } catch (_) { + return a === b; + } +} + +const IS_HMR = typeof module !== 'undefined' && !!(module as any).hot; + +const log = (level: 'log'|'error'|'info'|'warn', ...args: any) => { + if (isDevMode() && typeof console !== 'undefined') { + // eslint-disable-next-line no-console + console[level](...args); + } +}; + +globalThis.ÉĩAngularfireInstanceCache ||= []; diff --git a/src/compat/database/database.module.ts b/src/compat/database/database.module.ts new file mode 100644 index 000000000..3c1d51d32 --- /dev/null +++ b/src/compat/database/database.module.ts @@ -0,0 +1,13 @@ +import { NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFireDatabase } from './database'; + +@NgModule({ + providers: [ AngularFireDatabase ] +}) +export class AngularFireDatabaseModule { + constructor() { + firebase.registerVersion('angularfire', VERSION.full, 'rtdb-compat'); + } +} diff --git a/src/compat/database/database.spec.ts b/src/compat/database/database.spec.ts new file mode 100644 index 000000000..09f3d0990 --- /dev/null +++ b/src/compat/database/database.spec.ts @@ -0,0 +1,113 @@ +import { NgZone } from '@angular/core'; +import { TestBed } from '@angular/core/testing'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { AngularFireModule, FIREBASE_APP_NAME, FIREBASE_OPTIONS, FirebaseApp } from '@angular/fire/compat'; +import { AngularFireDatabase, AngularFireDatabaseModule, USE_EMULATOR } from '@angular/fire/compat/database'; +import 'firebase/compat/database'; +import { COMMON_CONFIG, databaseEmulatorPort } from '../../../src/test-config'; +import { rando } from '../../../src/utils'; + +describe('AngularFireDatabase', () => { + let app: FirebaseApp; + let db: AngularFireDatabase; + let zone: NgZone; + let firebaseAppName: string; + + beforeEach(() => { + firebaseAppName = rando(); + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, firebaseAppName), + AngularFireDatabaseModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', databaseEmulatorPort] } + ] + }); + + app = TestBed.inject(FirebaseApp); + db = TestBed.inject(AngularFireDatabase); + zone = TestBed.inject(NgZone); + }); + + describe('', () => { + + it('should be an AngularFireDatabase type', () => { + expect(db instanceof AngularFireDatabase).toEqual(true); + }); + + it('should have an initialized Firebase app', () => { + expect(db.database.app).toBeDefined(); + }); + + it('should accept a Firebase App in the constructor', (done) => { + const schedulers = TestBed.runInInjectionContext(() => new ÉĩAngularFireSchedulers()); + const database = TestBed.runInInjectionContext(() => new AngularFireDatabase( + app.options, rando(), undefined, {}, zone, schedulers, undefined, undefined, + undefined, undefined, undefined, undefined, undefined, undefined, undefined, + )); + expect(database instanceof AngularFireDatabase).toEqual(true); + // try { database.database.app.delete().then(done, done); } catch(e) { done(); } + done(); + }); + + it('should have an initialized Firebase app instance member', () => { + expect(db.database.app.name).toEqual(firebaseAppName); + }); + + }); + +}); + +describe('AngularFireDatabase w/options', () => { + let db: AngularFireDatabase; + let firebaseAppName: string; + + beforeEach(() => { + firebaseAppName = rando(); + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireDatabaseModule + ], + providers: [ + { provide: FIREBASE_APP_NAME, useValue: firebaseAppName }, + { provide: FIREBASE_OPTIONS, useValue: COMMON_CONFIG }, + { provide: USE_EMULATOR, useValue: ['localhost', databaseEmulatorPort] } + ] + }); + + db = TestBed.inject(AngularFireDatabase); + }); + + describe('', () => { + + it('should be an AngularFireDatabase type', () => { + expect(db instanceof AngularFireDatabase).toEqual(true); + }); + + it('should have an initialized Firebase app', () => { + expect(db.database.app).toBeDefined(); + }); + + it('should have an initialized Firebase app instance member', () => { + expect(db.database.app.name).toEqual(firebaseAppName); + }); + + /* INVESTIGATE database(url) does not seem to be working + + it('database be pointing to the provided DB instance', () => { + expect(db.database.ref().toString()).toEqual(url); + }); + + it('list should be using the provided DB instance', () => { + expect(db.list(query).query.toString()).toEqual(`${url}/${query}`); + }); + + it('object should be using the provided DB instance', () => { + expect(db.object(query).query.toString()).toEqual(`${url}/${query}`); + }); + */ + }); + +}); diff --git a/src/compat/database/database.ts b/src/compat/database/database.ts new file mode 100644 index 000000000..1301b167a --- /dev/null +++ b/src/compat/database/database.ts @@ -0,0 +1,103 @@ +import { EnvironmentInjector, Inject, Injectable, InjectionToken, NgZone, Optional, PLATFORM_ID, inject } from '@angular/core'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { FIREBASE_APP_NAME, FIREBASE_OPTIONS, ÉĩcacheInstance, ÉĩfirebaseAppFactory } from '@angular/fire/compat'; +import { + SETTINGS as AUTH_SETTINGS, + AngularFireAuth, + LANGUAGE_CODE, + PERSISTENCE, + TENANT_ID, + USE_EMULATOR as USE_AUTH_EMULATOR, + USE_DEVICE_LANGUAGE, + ÉĩauthFactory, +} from '@angular/fire/compat/auth'; +import { FirebaseOptions } from 'firebase/app'; +import firebase from 'firebase/compat/app'; +import { AngularFireList, AngularFireObject, DatabaseQuery, PathReference, QueryFn } from './interfaces'; +import { createListReference } from './list/create-reference'; +import { createObjectReference } from './object/create-reference'; +import { getRef } from './utils'; +import 'firebase/compat/auth'; +import 'firebase/compat/database'; + +export const URL = new InjectionToken('angularfire2.realtimeDatabaseURL'); + +type UseEmulatorArguments = Parameters; +export const USE_EMULATOR = new InjectionToken('angularfire2.database.use-emulator'); + +@Injectable({ + providedIn: 'any' +}) +export class AngularFireDatabase { + public readonly database: firebase.database.Database; + private readonly injector = inject(EnvironmentInjector); + + constructor( + @Inject(FIREBASE_OPTIONS) options: FirebaseOptions, + @Optional() @Inject(FIREBASE_APP_NAME) name: string | null | undefined, + @Optional() @Inject(URL) databaseURL: string | null, + // eslint-disable-next-line @typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object, + zone: NgZone, + public schedulers: ÉĩAngularFireSchedulers, + @Optional() @Inject(USE_EMULATOR) _useEmulator: any, // tuple isn't working here + @Optional() auth: AngularFireAuth, + @Optional() @Inject(USE_AUTH_EMULATOR) useAuthEmulator: any, + @Optional() @Inject(AUTH_SETTINGS) authSettings: any, // can't use firebase.auth.AuthSettings here + @Optional() @Inject(TENANT_ID) tenantId: string | null, + @Optional() @Inject(LANGUAGE_CODE) languageCode: string | null, + @Optional() @Inject(USE_DEVICE_LANGUAGE) useDeviceLanguage: boolean | null, + @Optional() @Inject(PERSISTENCE) persistence: string | null, + @Optional() _appCheckInstances: AppCheckInstances, + ) { + + const useEmulator: UseEmulatorArguments | null = _useEmulator; + const app = ÉĩfirebaseAppFactory(options, zone, name); + + if (auth) { + ÉĩauthFactory(app, zone, useAuthEmulator, tenantId, languageCode, useDeviceLanguage, authSettings, persistence); + } + + this.database = ÉĩcacheInstance(`${app.name}.database.${databaseURL}`, 'AngularFireDatabase', app.name, () => { + const database = zone.runOutsideAngular(() => app.database(databaseURL || undefined)); + if (useEmulator) { + database.useEmulator(...useEmulator); + } + return database; + }, [useEmulator]); + } + + list(pathOrRef: PathReference, queryFn?: QueryFn): AngularFireList { + const ref = inject(NgZone).runOutsideAngular(() => getRef(this.database, pathOrRef)); + let query: DatabaseQuery = ref; + if (queryFn) { + query = queryFn(ref); + } + return createListReference(query, this, this.injector); + } + + object(pathOrRef: PathReference): AngularFireObject { + const ref = inject(NgZone).runOutsideAngular(() => getRef(this.database, pathOrRef)); + return createObjectReference(ref, this, this.injector); + } + + createPushId() { + const ref = inject(NgZone).runOutsideAngular(() => this.database.ref()); + return ref.push().key; + } + +} + +export { + PathReference, + DatabaseSnapshot, + ChildEvent, + ListenEvent, + QueryFn, + AngularFireList, + AngularFireObject, + AngularFireAction, + Action, + SnapshotAction +} from './interfaces'; diff --git a/src/compat/database/interfaces.ts b/src/compat/database/interfaces.ts new file mode 100644 index 000000000..461f7bc25 --- /dev/null +++ b/src/compat/database/interfaces.ts @@ -0,0 +1,71 @@ +import firebase from 'firebase/compat/app'; +import { Observable } from 'rxjs'; + +export type FirebaseOperation = string | firebase.database.Reference | firebase.database.DataSnapshot; + +export interface AngularFireList { + query: DatabaseQuery; + valueChanges(events?: ChildEvent[], options?: unknown): Observable; + valueChanges(events?: ChildEvent[], options?: {idField: K}): Observable<(T & {[T in K]?: string})[]>; + snapshotChanges(events?: ChildEvent[]): Observable[]>; + stateChanges(events?: ChildEvent[]): Observable>; + auditTrail(events?: ChildEvent[]): Observable[]>; + update(item: FirebaseOperation, data: Partial): Promise; + set(item: FirebaseOperation, data: T): Promise; + push(data: T): firebase.database.ThenableReference; + remove(item?: FirebaseOperation): Promise; +} + +export interface AngularFireObject { + query: DatabaseQuery; + valueChanges(): Observable; + snapshotChanges(): Observable>; + update(data: Partial): Promise; + set(data: T): Promise; + remove(): Promise; +} + +export interface FirebaseOperationCases { + stringCase: () => Promise; + firebaseCase?: () => Promise; + snapshotCase?: () => Promise; + unwrappedSnapshotCase?: () => Promise; +} + +export type QueryFn = (ref: DatabaseReference) => DatabaseQuery; +export type ChildEvent = 'child_added' | 'child_removed' | 'child_changed' | 'child_moved'; +export type ListenEvent = 'value' | ChildEvent; + +export interface Action { + type: ListenEvent; + payload: T; +} + +export interface AngularFireAction extends Action { + prevKey: string | null | undefined; + key: string | null; +} + +export type SnapshotAction = AngularFireAction>; + +export type Primitive = number | string | boolean; + +export interface DatabaseSnapshotExists extends firebase.database.DataSnapshot { + exists(): true; + val(): T; + forEach(action: (a: DatabaseSnapshot) => boolean): boolean; +} + +export interface DatabaseSnapshotDoesNotExist extends firebase.database.DataSnapshot { + exists(): false; + val(): null; + forEach(action: (a: DatabaseSnapshot) => boolean): boolean; +} + +export type DatabaseSnapshot = DatabaseSnapshotExists | DatabaseSnapshotDoesNotExist; + +export type DatabaseReference = firebase.database.Reference; +export type DatabaseQuery = firebase.database.Query; +export type DataSnapshot = firebase.database.DataSnapshot; +export type QueryReference = DatabaseReference | DatabaseQuery; +export type PathReference = QueryReference | string; diff --git a/src/compat/database/list/audit-trail.spec.ts b/src/compat/database/list/audit-trail.spec.ts new file mode 100644 index 000000000..a462d50cf --- /dev/null +++ b/src/compat/database/list/audit-trail.spec.ts @@ -0,0 +1,58 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFireDatabase, AngularFireDatabaseModule, ChildEvent, USE_EMULATOR, auditTrail } from '@angular/fire/compat/database'; +import firebase from 'firebase/compat/app'; +import { skip } from 'rxjs/operators'; +import { COMMON_CONFIG, databaseEmulatorPort } from '../../../../src/test-config'; +import 'firebase/compat/database'; +import { rando } from '../../../../src/utils'; + +describe('auditTrail', () => { + let db: AngularFireDatabase; + let createRef: (path: string) => firebase.database.Reference; + let batch = {}; + const items = [{ name: 'zero' }, { name: 'one' }, { name: 'two' }].map((item, i) => ({ key: i.toString(), ...item })); + Object.keys(items).forEach((key, i) => { + batch[i] = items[key]; + }); + // make batch immutable to preserve integrity + batch = Object.freeze(batch); + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireDatabaseModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', databaseEmulatorPort] } + ] + }); + + db = TestBed.inject(AngularFireDatabase); + createRef = (path: string) => db.database.ref(path); + }); + + function prepareAuditTrail(opts: { events?: ChildEvent[], skipnumber: number } = { skipnumber: 0 }) { + const { events, skipnumber } = opts; + const aref = createRef(rando()); + aref.set(batch); + const changes = auditTrail(aref, events); + return { + changes: changes.pipe(skip(skipnumber)), + ref: aref + }; + } + + it('should listen to all events by default', (done) => { + + const { changes } = prepareAuditTrail(); + changes.subscribe(actions => { + const data = actions.map(a => a.payload.val()); + expect(data).toEqual(items); + done(); + }); + + }); + +}); diff --git a/src/compat/database/list/audit-trail.ts b/src/compat/database/list/audit-trail.ts new file mode 100644 index 000000000..666a458d7 --- /dev/null +++ b/src/compat/database/list/audit-trail.ts @@ -0,0 +1,62 @@ +import { Observable, SchedulerLike } from 'rxjs'; +import { map, scan, skipWhile, withLatestFrom } from 'rxjs/operators'; +import { AngularFireAction, ChildEvent, DataSnapshot, DatabaseQuery, SnapshotAction } from '../interfaces'; +import { fromRef } from '../observable/fromRef'; +import { stateChanges } from './state-changes'; + + +export function auditTrail(query: DatabaseQuery, events?: ChildEvent[], scheduler?: SchedulerLike): Observable[]> { + const auditTrail$ = stateChanges(query, events) + .pipe( + scan((current, action) => [...current, action], []) + ); + return waitForLoaded(query, auditTrail$, scheduler); +} + +interface LoadedMetadata { + data: AngularFireAction; + lastKeyToLoad: any; +} + +function loadedData(query: DatabaseQuery, scheduler?: SchedulerLike): Observable { + // Create an observable of loaded values to retrieve the + // known dataset. This will allow us to know what key to + // emit the "whole" array at when listening for child events. + return fromRef(query, 'value', 'on', scheduler) + .pipe( + map(data => { + // Store the last key in the data set + let lastKeyToLoad; + // Loop through loaded dataset to find the last key + data.payload.forEach(child => { + lastKeyToLoad = child.key; return false; + }); + // return data set and the current last key loaded + return { data, lastKeyToLoad }; + }) + ); +} + +function waitForLoaded(query: DatabaseQuery, action$: Observable[]>, scheduler?: SchedulerLike) { + const loaded$ = loadedData(query, scheduler); + return loaded$ + .pipe( + withLatestFrom(action$), + // Get the latest values from the "loaded" and "child" datasets + // We can use both datasets to form an array of the latest values. + map(([loaded, actions]) => { + // Store the last key in the data set + const lastKeyToLoad = loaded.lastKeyToLoad; + // Store all child keys loaded at this point + const loadedKeys = actions.map(snap => snap.key); + return { actions, lastKeyToLoad, loadedKeys }; + }), + // This is the magical part, only emit when the last load key + // in the dataset has been loaded by a child event. At this point + // we can assume the dataset is "whole". + skipWhile(meta => meta.loadedKeys.indexOf(meta.lastKeyToLoad) === -1), + // Pluck off the meta data because the user only cares + // to iterate through the snapshots + map(meta => meta.actions) + ); +} diff --git a/src/compat/database/list/changes.spec.ts b/src/compat/database/list/changes.spec.ts new file mode 100644 index 000000000..0dd368a5f --- /dev/null +++ b/src/compat/database/list/changes.spec.ts @@ -0,0 +1,140 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFireDatabase, AngularFireDatabaseModule, USE_EMULATOR, listChanges } from '@angular/fire/compat/database'; +import firebase from 'firebase/compat/app'; +import { skip, take } from 'rxjs/operators'; +import { COMMON_CONFIG, databaseEmulatorPort } from '../../../../src/test-config'; +import 'firebase/compat/database'; +import { rando } from '../../../../src/utils'; + +describe('listChanges', () => { + let db: AngularFireDatabase; + let ref: (path: string) => firebase.database.Reference; + let batch = {}; + const items = [{ name: 'zero' }, { name: 'one' }, { name: 'two' }].map((item, i) => ({ key: i.toString(), ...item })); + Object.keys(items).forEach((key, i) => { + batch[i] = items[key]; + }); + // make batch immutable to preserve integrity + batch = Object.freeze(batch); + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireDatabaseModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', databaseEmulatorPort] } + ] + }); + + db = TestBed.inject(AngularFireDatabase); + ref = (path: string) => db.database.ref(path); + }); + + describe('events', () => { + + it('should stream value at first', (done) => { + const someRef = ref(rando()); + const obs = listChanges(someRef, ['child_added']); + obs.pipe(take(1)).subscribe(changes => { + const data = changes.map(change => change.payload.val()); + expect(data).toEqual(items); + }).add(done); + someRef.set(batch); + }); + + it('should process a new child_added event', done => { + const aref = ref(rando()); + const obs = listChanges(aref, ['child_added']); + obs.pipe(skip(1), take(1)).subscribe(changes => { + const data = changes.map(change => change.payload.val()); + expect(data[3]).toEqual({ name: 'anotha one' }); + }).add(done); + aref.set(batch); + aref.push({ name: 'anotha one' }); + }); + + it('should stream in order events', (done) => { + const aref = ref(rando()); + const obs = listChanges(aref.orderByChild('name'), ['child_added']); + obs.pipe(take(1)).subscribe(changes => { + const names = changes.map(change => change.payload.val().name); + expect(names[0]).toEqual('one'); + expect(names[1]).toEqual('two'); + expect(names[2]).toEqual('zero'); + }).add(done); + aref.set(batch); + }); + + it('should stream in order events w/child_added', (done) => { + const aref = ref(rando()); + const obs = listChanges(aref.orderByChild('name'), ['child_added']); + obs.pipe(skip(1), take(1)).subscribe(changes => { + const names = changes.map(change => change.payload.val().name); + expect(names[0]).toEqual('anotha one'); + expect(names[1]).toEqual('one'); + expect(names[2]).toEqual('two'); + expect(names[3]).toEqual('zero'); + }).add(done); + aref.set(batch); + aref.push({ name: 'anotha one' }); + }); + + it('should stream events filtering', (done) => { + const aref = ref(rando()); + const obs = listChanges(aref.orderByChild('name').equalTo('zero'), ['child_added']); + obs.pipe(skip(1), take(1)).subscribe(changes => { + const names = changes.map(change => change.payload.val().name); + expect(names[0]).toEqual('zero'); + expect(names[1]).toEqual('zero'); + }).add(done); + aref.set(batch); + aref.push({ name: 'zero' }); + }); + + + /* FLAKES? aref.set not fufilling + + it('should process a new child_removed event', done => { + const aref = ref(rando()); + const obs = listChanges(aref, ['child_added','child_removed']); + aref.set(batch).then(() => { + const sub = obs.pipe(skip(1),take(1)).subscribe(changes => { + const data = changes.map(change => change.payload.val()); + expect(data.length).toEqual(items.length - 1); + }).add(done); + aref.child(items[0].key).remove(); + }); + }); + + it('should process a new child_changed event', (done) => { + const aref = ref(rando()); + const obs = listChanges(aref, ['child_added','child_changed']) + aref.set(batch).then(() => { + const sub = obs.pipe(skip(1),take(1)).subscribe(changes => { + const data = changes.map(change => change.payload.val()); + expect(data[1].name).toEqual('lol'); + }).add(done); + aref.child(items[1].key).update({ name: 'lol'}); + }); + }); + + it('should process a new child_moved event', (done) => { + const aref = ref(rando()); + const obs = listChanges(aref, ['child_added','child_moved']) + aref.set(batch).then(() => { + const sub = obs.pipe(skip(1),take(1)).subscribe(changes => { + const data = changes.map(change => change.payload.val()); + // We moved the first item to the last item, so we check that + // the new result is now the last result + expect(data[data.length - 1]).toEqual(items[0]); + }).add(done); + aref.child(items[0].key).setPriority('a', () => {}); + }); + });*/ + + }); + +}); diff --git a/src/compat/database/list/changes.ts b/src/compat/database/list/changes.ts new file mode 100644 index 000000000..c7c5fd904 --- /dev/null +++ b/src/compat/database/list/changes.ts @@ -0,0 +1,89 @@ +import { Observable, SchedulerLike, merge, of } from 'rxjs'; +import { distinctUntilChanged, scan, switchMap } from 'rxjs/operators'; +import { ChildEvent, DatabaseQuery, SnapshotAction } from '../interfaces'; +import { fromRef } from '../observable/fromRef'; +import { isNil } from '../utils'; + + +export function listChanges(ref: DatabaseQuery, events: ChildEvent[], scheduler?: SchedulerLike): Observable[]> { + return fromRef(ref, 'value', 'once', scheduler).pipe( + switchMap(snapshotAction => { + const childEvent$ = [of(snapshotAction)]; + events.forEach(event => childEvent$.push(fromRef(ref, event, 'on', scheduler))); + return merge(...childEvent$).pipe(scan(buildView, [])); + }), + distinctUntilChanged() + ); +} + +function positionFor(changes: SnapshotAction[], key) { + const len = changes.length; + for (let i = 0; i < len; i++) { + if (changes[i].payload.key === key) { + return i; + } + } + return -1; +} + +function positionAfter(changes: SnapshotAction[], prevKey?: string) { + if (isNil(prevKey)) { + return 0; + } else { + const i = positionFor(changes, prevKey); + if (i === -1) { + return changes.length; + } else { + return i + 1; + } + } +} + +function buildView(current, action) { + const { payload, prevKey, key } = action; + const currentKeyPosition = positionFor(current, key); + const afterPreviousKeyPosition = positionAfter(current, prevKey); + switch (action.type) { + case 'value': + if (action.payload?.exists()) { + let prevKey = null; + action.payload.forEach(payload => { + const action = { payload, type: 'value', prevKey, key: payload.key }; + prevKey = payload.key; + current = [...current, action]; + return false; + }); + } + return current; + case 'child_added': + if (currentKeyPosition > -1) { + // check that the previouskey is what we expect, else reorder + const previous = current[currentKeyPosition - 1]; + if ((previous?.key || null) !== prevKey) { + current = current.filter(x => x.payload.key !== payload.key); + current.splice(afterPreviousKeyPosition, 0, action); + } + } else if (prevKey == null) { + return [action, ...current]; + } else { + current = current.slice(); + current.splice(afterPreviousKeyPosition, 0, action); + } + return current; + case 'child_removed': + return current.filter(x => x.payload.key !== payload.key); + case 'child_changed': + return current.map(x => x.payload.key === key ? action : x); + case 'child_moved': + if (currentKeyPosition > -1) { + const data = current.splice(currentKeyPosition, 1)[0]; + current = current.slice(); + current.splice(afterPreviousKeyPosition, 0, data); + return current; + } + return current; + // default will also remove null results + default: + return current; + } +} diff --git a/src/compat/database/list/create-reference.ts b/src/compat/database/list/create-reference.ts new file mode 100644 index 000000000..0da799454 --- /dev/null +++ b/src/compat/database/list/create-reference.ts @@ -0,0 +1,50 @@ +import { Injector, NgZone, inject } from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import type { Observable } from 'rxjs'; +import { map } from 'rxjs/operators'; +import { AngularFireDatabase } from '../database'; +import { AngularFireList, ChildEvent, DatabaseQuery } from '../interfaces'; +import { auditTrail } from './audit-trail'; +import { createDataOperationMethod } from './data-operation'; +import { createRemoveMethod } from './remove'; +import { snapshotChanges } from './snapshot-changes'; +import { stateChanges } from './state-changes'; + +export function createListReference(query: DatabaseQuery, afDatabase: AngularFireDatabase, injector?: Injector): AngularFireList { + const outsideAngularScheduler = afDatabase.schedulers.outsideAngular; + const refInZone = inject(NgZone).run(() => query.ref); + return { + query, + update: createDataOperationMethod(refInZone, 'update'), + set: createDataOperationMethod(refInZone, 'set'), + push: (data: T) => refInZone.push(data), + remove: createRemoveMethod(refInZone), + snapshotChanges(events?: ChildEvent[]) { + return snapshotChanges(query, events, outsideAngularScheduler).pipe(pendingUntilEvent(injector)); + }, + stateChanges(events?: ChildEvent[]) { + return stateChanges(query, events, outsideAngularScheduler).pipe(pendingUntilEvent(injector)); + }, + auditTrail(events?: ChildEvent[]) { + return auditTrail(query, events, outsideAngularScheduler).pipe(pendingUntilEvent(injector)); + }, + valueChanges(events?: ChildEvent[], options?: {idField?: K}): Observable<(T & Record)[]> { + const snapshotChanges$ = snapshotChanges(query, events, outsideAngularScheduler); + return snapshotChanges$.pipe( + map(actions => actions.map(a => { + if (options && options.idField) { + return { + ...a.payload.val() as T, + ...{ + [options.idField]: a.key + } + }; + } else { + return a.payload.val() as T & Record + } + })), + pendingUntilEvent(injector) + ); + } + }; +} diff --git a/src/compat/database/list/data-operation.ts b/src/compat/database/list/data-operation.ts new file mode 100644 index 000000000..16650a8b3 --- /dev/null +++ b/src/compat/database/list/data-operation.ts @@ -0,0 +1,12 @@ +import { DatabaseReference, DatabaseSnapshot, FirebaseOperation } from '../interfaces'; +import { checkOperationCases } from '../utils'; + +export function createDataOperationMethod(ref: DatabaseReference, operation: string) { + return function dataOperation(item: FirebaseOperation, value: T) { + return checkOperationCases(item, { + stringCase: () => ref.child(item as string)[operation](value), + firebaseCase: () => (item as DatabaseReference)[operation](value), + snapshotCase: () => (item as DatabaseSnapshot).ref[operation](value) + }); + }; +} diff --git a/src/compat/database/list/remove.ts b/src/compat/database/list/remove.ts new file mode 100644 index 000000000..45928df86 --- /dev/null +++ b/src/compat/database/list/remove.ts @@ -0,0 +1,15 @@ +import { DatabaseReference, DatabaseSnapshot, FirebaseOperation } from '../interfaces'; +import { checkOperationCases } from '../utils'; + +// TODO(davideast): Find out why TS thinks this returns firebase.Primise +// instead of Promise. +export function createRemoveMethod(ref: DatabaseReference) { + return function remove(item?: FirebaseOperation): any { + if (!item) { return ref.remove(); } + return checkOperationCases(item, { + stringCase: () => ref.child(item as string).remove(), + firebaseCase: () => (item as DatabaseReference).remove(), + snapshotCase: () => (item as DatabaseSnapshot).ref.remove() + }); + }; +} diff --git a/src/compat/database/list/snapshot-changes.spec.ts b/src/compat/database/list/snapshot-changes.spec.ts new file mode 100644 index 000000000..6a82eeda2 --- /dev/null +++ b/src/compat/database/list/snapshot-changes.spec.ts @@ -0,0 +1,135 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFireDatabase, AngularFireDatabaseModule, ChildEvent, USE_EMULATOR, snapshotChanges } from '@angular/fire/compat/database'; +import firebase from 'firebase/compat/app'; +import { BehaviorSubject } from 'rxjs'; +import { skip, switchMap, take } from 'rxjs/operators'; +import { COMMON_CONFIG, databaseEmulatorPort } from '../../../../src/test-config'; +import 'firebase/compat/database'; +import { rando } from '../../../../src/utils'; + +describe('snapshotChanges', () => { + let db: AngularFireDatabase; + let createRef: (path: string) => firebase.database.Reference; + let batch = {}; + const items = [{ name: 'zero' }, { name: 'one' }, { name: 'two' }].map((item, i) => ({ key: i.toString(), ...item })); + Object.keys(items).forEach((key, i) => { + batch[i] = items[key]; + }); + // make batch immutable to preserve integrity + batch = Object.freeze(batch); + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireDatabaseModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', databaseEmulatorPort] } + ] + }); + + db = TestBed.inject(AngularFireDatabase); + createRef = (path: string) => db.database.ref(path); + }); + + function prepareSnapshotChanges(opts: { events?: ChildEvent[], skipnumber: number } = { skipnumber: 0 }) { + const { events, skipnumber } = opts; + const aref = createRef(rando()); + const snapChanges = snapshotChanges(aref, events); + return { + snapChanges: snapChanges.pipe(skip(skipnumber)), + ref: aref + }; + } + + it('should listen to all events by default', (done) => { + const { snapChanges, ref } = prepareSnapshotChanges(); + snapChanges.pipe(take(1)).subscribe(actions => { + const data = actions.map(a => a.payload.val()); + expect(data).toEqual(items); + }).add(done); + ref.set(batch); + }); + + it('should handle multiple subscriptions (hot)', (done) => { + const { snapChanges, ref } = prepareSnapshotChanges(); + const sub = snapChanges.subscribe(() => undefined); + sub.add(done); + snapChanges.pipe(take(1)).subscribe(actions => { + const data = actions.map(a => a.payload.val()); + expect(data).toEqual(items); + }).add(sub); + ref.set(batch); + }); + + it('should handle multiple subscriptions (warm)', done => { + const { snapChanges, ref } = prepareSnapshotChanges(); + snapChanges.pipe(take(1)).subscribe(() => undefined).add(() => { + snapChanges.pipe(take(1)).subscribe(actions => { + const data = actions.map(a => a.payload.val()); + expect(data).toEqual(items); + }).add(done); + }); + ref.set(batch); + }); + + it('should listen to only child_added events', (done) => { + const { snapChanges, ref } = prepareSnapshotChanges({ events: ['child_added'], skipnumber: 0 }); + snapChanges.pipe(take(1)).subscribe(actions => { + const data = actions.map(a => a.payload.val()); + expect(data).toEqual(items); + }).add(done); + ref.set(batch); + }); + + /* FLAKE? set promise not fufilling + it('should listen to only child_added, child_changed events', (done) => { + const { snapChanges, ref } = prepareSnapshotChanges({ + events: ['child_added', 'child_changed'], + skipnumber: 1 + }); + const name = 'ligatures'; + snapChanges.pipe(take(1)).subscribe(actions => { + const data = actions.map(a => a.payload!.val());; + const copy = [...items]; + copy[0].name = name; + expect(data).toEqual(copy); + }).add(done); + ref.set(batch).then(() => { + ref.child(items[0].key).update({ name }) + }); + });*/ + + it('should handle empty sets', done => { + const aref = createRef(rando()); + aref.set({}); + snapshotChanges(aref).pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(0); + }).add(done); + }); + + it('should handle dynamic queries that return empty sets', done => { + let count = 0; + const namefilter$ = new BehaviorSubject(null); + const aref = createRef(rando()); + aref.set(batch); + namefilter$.pipe(switchMap(name => { + const filteredRef = name ? aref.child('name').equalTo(name) : aref; + return snapshotChanges(filteredRef); + }), take(2)).subscribe(data => { + count = count + 1; + // the first time should all be 'added' + if (count === 1) { + expect(Object.keys(data).length).toEqual(3); + namefilter$.next(-1); + } + // on the second round, we should have filtered out everything + if (count === 2) { + expect(Object.keys(data).length).toEqual(0); + } + }).add(done); + }); + +}); diff --git a/src/compat/database/list/snapshot-changes.ts b/src/compat/database/list/snapshot-changes.ts new file mode 100644 index 000000000..a98adf045 --- /dev/null +++ b/src/compat/database/list/snapshot-changes.ts @@ -0,0 +1,13 @@ +import { Observable, SchedulerLike } from 'rxjs'; +import { ChildEvent, DatabaseQuery, SnapshotAction } from '../interfaces'; +import { listChanges } from './changes'; +import { validateEventsArray } from './utils'; + +export function snapshotChanges( + query: DatabaseQuery, + events?: ChildEvent[], + scheduler?: SchedulerLike +): Observable[]> { + events = validateEventsArray(events); + return listChanges(query, events, scheduler); +} diff --git a/src/compat/database/list/state-changes.spec.ts b/src/compat/database/list/state-changes.spec.ts new file mode 100644 index 000000000..86855ac09 --- /dev/null +++ b/src/compat/database/list/state-changes.spec.ts @@ -0,0 +1,58 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFireDatabase, AngularFireDatabaseModule, ChildEvent, USE_EMULATOR, stateChanges } from '@angular/fire/compat/database'; +import firebase from 'firebase/compat/app'; +import { skip } from 'rxjs/operators'; +import { COMMON_CONFIG, databaseEmulatorPort } from '../../../../src/test-config'; +import 'firebase/compat/database'; +import { rando } from '../../../../src/utils'; + +describe('stateChanges', () => { + let db: AngularFireDatabase; + let createRef: (path: string) => firebase.database.Reference; + let batch = {}; + const items = [{ name: 'zero' }, { name: 'one' }, { name: 'two' }].map((item, i) => ({ key: i.toString(), ...item })); + Object.keys(items).forEach((key, i) => { + batch[i] = items[key]; + }); + // make batch immutable to preserve integrity + batch = Object.freeze(batch); + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireDatabaseModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', databaseEmulatorPort] } + ] + }); + + db = TestBed.inject(AngularFireDatabase); + createRef = (path: string) => db.database.ref(path); + }); + + function prepareStateChanges(opts: { events?: ChildEvent[], skipnumber: number } = { skipnumber: 0 }) { + const { events, skipnumber } = opts; + const aref = createRef(rando()); + aref.set(batch); + const changes = stateChanges(aref, events); + return { + changes: changes.pipe(skip(skipnumber)), + ref: aref + }; + } + + it('should listen to all events by default', (done) => { + + const { changes } = prepareStateChanges({ skipnumber: 2 }); + changes.subscribe(action => { + expect(action.key).toEqual('2'); + expect(action.payload.val()).toEqual(items[items.length - 1]); + done(); + }); + + }); + +}); diff --git a/src/compat/database/list/state-changes.ts b/src/compat/database/list/state-changes.ts new file mode 100644 index 000000000..10a4cdffa --- /dev/null +++ b/src/compat/database/list/state-changes.ts @@ -0,0 +1,10 @@ +import { SchedulerLike, merge } from 'rxjs'; +import { ChildEvent, DatabaseQuery } from '../interfaces'; +import { fromRef } from '../observable/fromRef'; +import { validateEventsArray } from './utils'; + +export function stateChanges(query: DatabaseQuery, events?: ChildEvent[], scheduler?: SchedulerLike) { + events = validateEventsArray(events); + const childEvent$ = events.map(event => fromRef(query, event, 'on', scheduler)); + return merge(...childEvent$); +} diff --git a/src/compat/database/list/utils.ts b/src/compat/database/list/utils.ts new file mode 100644 index 000000000..35404600c --- /dev/null +++ b/src/compat/database/list/utils.ts @@ -0,0 +1,8 @@ +import { isNil } from '../utils'; + +export function validateEventsArray(events?: any[]) { + if (isNil(events) || events.length === 0) { + events = ['child_added', 'child_removed', 'child_changed', 'child_moved']; + } + return events; +} diff --git a/src/compat/database/ng-package.json b/src/compat/database/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/database/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/database/object/create-reference.ts b/src/compat/database/object/create-reference.ts new file mode 100644 index 000000000..285f0e90c --- /dev/null +++ b/src/compat/database/object/create-reference.ts @@ -0,0 +1,27 @@ +import { Injector } from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import { map } from 'rxjs/operators'; +import { AngularFireDatabase } from '../database'; +import { AngularFireObject, DatabaseQuery } from '../interfaces'; +import { createObjectSnapshotChanges } from './snapshot-changes'; + +export function createObjectReference(query: DatabaseQuery, afDatabase: AngularFireDatabase, injector?: Injector): AngularFireObject { + return { + query, + snapshotChanges() { + return createObjectSnapshotChanges(query, afDatabase.schedulers.outsideAngular)().pipe( + pendingUntilEvent(injector) + ); + }, + update(data: Partial) { return query.ref.update(data as any) as Promise; }, + set(data: T) { return query.ref.set(data) as Promise; }, + remove() { return query.ref.remove() as Promise; }, + valueChanges() { + const snapshotChanges$ = createObjectSnapshotChanges(query, afDatabase.schedulers.outsideAngular)(); + return snapshotChanges$.pipe( + pendingUntilEvent(injector), + map(action => action.payload.exists() ? action.payload.val() as T : null) + ); + }, + }; +} diff --git a/src/compat/database/object/snapshot-changes.ts b/src/compat/database/object/snapshot-changes.ts new file mode 100644 index 000000000..bff2f90c9 --- /dev/null +++ b/src/compat/database/object/snapshot-changes.ts @@ -0,0 +1,9 @@ +import { Observable, SchedulerLike } from 'rxjs'; +import { DatabaseQuery, SnapshotAction } from '../interfaces'; +import { fromRef } from '../observable/fromRef'; + +export function createObjectSnapshotChanges(query: DatabaseQuery, scheduler?: SchedulerLike) { + return function snapshotChanges(): Observable> { + return fromRef(query, 'value', 'on', scheduler); + }; +} diff --git a/src/compat/database/observable/fromRef.spec.ts b/src/compat/database/observable/fromRef.spec.ts new file mode 100644 index 000000000..c7c37455c --- /dev/null +++ b/src/compat/database/observable/fromRef.spec.ts @@ -0,0 +1,263 @@ +/* eslint-disable @typescript-eslint/unbound-method */ +import { TestBed } from '@angular/core/testing'; +import { ÉĩZoneScheduler } from '@angular/fire'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFireDatabase, AngularFireDatabaseModule, USE_EMULATOR, fromRef } from '@angular/fire/compat/database'; +import firebase from 'firebase/compat/app'; +import { take } from 'rxjs/operators'; +import { TestScheduler } from 'rxjs/testing'; +import { COMMON_CONFIG, databaseEmulatorPort } from '../../../../src/test-config'; +import { rando } from '../../../../src/utils'; + +describe('fromRef', () => { + let db: AngularFireDatabase; + let ref: (path: string) => firebase.database.Reference; + let batch = {}; + const items = [{ name: 'one' }, { name: 'two' }, { name: 'three' }].map(item => ({ key: rando(), ...item })); + Object.keys(items).forEach((key) => { + const itemValue = items[key]; + batch[itemValue.key] = itemValue; + }); + // make batch immutable to preserve integrity + batch = Object.freeze(batch); + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireDatabaseModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', databaseEmulatorPort] } + ] + }); + + db = TestBed.inject(AngularFireDatabase); + ref = (path: string) => db.database.ref(path); + }); + + it('it should be async by default', (done) => { + const itemRef = ref(rando()); + itemRef.set(batch); + const obs = fromRef(itemRef, 'value'); + let count = 0; + expect(count).toEqual(0); + const sub = obs.subscribe(() => { + count = count + 1; + expect(count).toEqual(1); + sub.unsubscribe(); + done(); + }); + expect(count).toEqual(0); + }); + + it('should take a scheduler', done => { + const itemRef = ref(rando()); + itemRef.set(batch); + + const testScheduler = new TestScheduler((actual, expected) => { + expect(actual).toEqual(expected); + }); + spyOn(testScheduler, 'schedule').and.callThrough(); + + const obs = fromRef(itemRef, 'value', 'once', testScheduler); + expect(testScheduler.schedule).not.toHaveBeenCalled(); + + obs.subscribe(() => { + expect(testScheduler.schedule).toHaveBeenCalled(); + // done(); + }, err => { + console.error(err); + expect(false).withContext('Shouldnt error').toEqual(true); + // done(); + }, () => { + expect(testScheduler.schedule).toHaveBeenCalled(); + done(); + }); + testScheduler.flush(); + }); + + it('should schedule completed and error correctly', done => { + const testScheduler = new TestScheduler((actual, expected) => { + expect(actual).toEqual(expected); + }); + spyOn(testScheduler, 'schedule').and.callThrough(); + + // Error + const errorObservable = fromRef({ + once: (event, snap, err) => err() + } as any, + 'value', + 'once', + testScheduler + ); + errorObservable.subscribe(() => { + fail('Should not emit'); + }, () => { + expect(testScheduler.schedule).toHaveBeenCalled(); + }, () => { + fail('Should not complete'); + }); + + testScheduler.flush(); + + // Completed + const itemRef = ref(rando()); + itemRef.set(batch); + + const scheduler = new ÉĩZoneScheduler(Zone.current.fork({ + name: 'ExpectedZone' + })); + const completeObservable = fromRef( + itemRef, + 'value', + 'once', + scheduler + ); + completeObservable.subscribe( + () => undefined, + () => fail('Should not error'), + () => expect(Zone.current.name).toEqual('ExpectedZone') + ); + testScheduler.flush(); + done(); + }); + + + it('it should should handle non-existence', (done) => { + const itemRef = ref(rando()); + itemRef.set({}); + const obs = fromRef(itemRef, 'value'); + obs.pipe(take(1)).subscribe(change => { + expect(change.payload.exists()).toEqual(false); + expect(change.payload.val()).toEqual(null); + }).add(done); + }); + + it('once should complete', (done) => { + const itemRef = ref(rando()); + itemRef.set(batch); + const obs = fromRef(itemRef, 'value', 'once'); + obs.subscribe(() => undefined, () => undefined, done); + }); + + it('it should listen and then unsubscribe', (done) => { + const itemRef = ref(rando()); + itemRef.set(batch); + const obs = fromRef(itemRef, 'value'); + let count = 0; + const sub = obs.subscribe(() => { + count = count + 1; + // hard coding count to one will fail if the unsub + // doesn't actually unsub + expect(count).toEqual(1); + done(); + sub.unsubscribe(); + itemRef.push({ name: 'anotha one' }); + }); + }); + + describe('events', () => { + + it('should stream back a child_added event', done => { + const itemRef = ref(rando()); + itemRef.set(batch); + const obs = fromRef(itemRef, 'child_added'); + let count = 0; + const sub = obs.subscribe(change => { + count = count + 1; + const { type, payload } = change; + expect(type).toEqual('child_added'); + expect(payload.val()).toEqual(batch[payload.key]); + if (count === items.length) { + done(); + sub.unsubscribe(); + expect(sub.closed).toEqual(true); + } + }); + }); + + it('should stream back a child_changed event', done => { + const itemRef = ref(rando()); + itemRef.set(batch); + const obs = fromRef(itemRef, 'child_changed'); + const name = 'look at what you made me do'; + const key = items[0].key; + const sub = obs.subscribe(change => { + const { type, payload } = change; + expect(type).toEqual('child_changed'); + expect(payload.key).toEqual(key); + expect(payload.val()).toEqual({ key, name }); + sub.unsubscribe(); + done(); + }); + itemRef.child(key).update({ name }); + }); + + it('should stream back a child_removed event', done => { + const itemRef = ref(rando()); + itemRef.set(batch); + const obs = fromRef(itemRef, 'child_removed'); + const key = items[0].key; + const name = items[0].name; + const sub = obs.subscribe(change => { + const { type, payload } = change; + expect(type).toEqual('child_removed'); + expect(payload.key).toEqual(key); + expect(payload.val()).toEqual({ key, name }); + sub.unsubscribe(); + done(); + }); + itemRef.child(key).remove(); + }); + + it('should stream back a child_moved event', done => { + const itemRef = ref(rando()); + itemRef.set(batch); + const obs = fromRef(itemRef, 'child_moved'); + const key = items[2].key; + const name = items[2].name; + const sub = obs.subscribe(change => { + const { type, payload } = change; + expect(type).toEqual('child_moved'); + expect(payload.key).toEqual(key); + expect(payload.val()).toEqual({ key, name }); + sub.unsubscribe(); + done(); + }); + itemRef.child(key).setPriority(-100, () => undefined); + }); + + it('should stream back a value event', (done: any) => { + const itemRef = ref(rando()); + itemRef.set(batch); + const obs = fromRef(itemRef, 'value'); + const sub = obs.subscribe(change => { + const { type, payload } = change; + expect(type).toEqual('value'); + expect(payload.val()).toEqual(batch); + done(); + sub.unsubscribe(); + expect(sub.closed).toEqual(true); + }); + }); + + it('should stream back query results', (done: any) => { + const itemRef = ref(rando()); + itemRef.set(batch); + const query = itemRef.orderByChild('name').equalTo(items[0].name); + const obs = fromRef(query, 'value'); + obs.subscribe(change => { + let child = null; + change.payload.forEach(snap => { + child = snap.val(); + return true; + }); + expect(child).toEqual(items[0]); + done(); + }); + }); + + }); + +}); diff --git a/src/compat/database/observable/fromRef.ts b/src/compat/database/observable/fromRef.ts new file mode 100644 index 000000000..81845e86a --- /dev/null +++ b/src/compat/database/observable/fromRef.ts @@ -0,0 +1,61 @@ +import { Observable, SchedulerLike, asyncScheduler } from 'rxjs'; +import { map, share } from 'rxjs/operators'; +import { AngularFireAction, DatabaseQuery, DatabaseSnapshot, ListenEvent } from '../interfaces'; + +interface SnapshotPrevKey { + snapshot: DatabaseSnapshot; + prevKey: string | null | undefined; +} + +/** + * Create an observable from a Database Reference or Database Query. + * @param ref Database Reference + * @param event Listen event type ('value', 'added', 'changed', 'removed', 'moved') + * @param listenType 'on' or 'once' + * @param scheduler - Rxjs scheduler + */ +export function fromRef(ref: DatabaseQuery, + event: ListenEvent, + listenType = 'on', + scheduler: SchedulerLike = asyncScheduler +): Observable>> { + return new Observable>(subscriber => { + let fn: any = null; + fn = ref[listenType](event, (snapshot, prevKey) => { + scheduler.schedule(() => { + subscriber.next({ snapshot, prevKey }); + }); + if (listenType === 'once') { + scheduler.schedule(() => subscriber.complete()); + } + }, err => { + scheduler.schedule(() => subscriber.error(err)); + }); + + if (listenType === 'on') { + return { + unsubscribe() { + if (fn != null) { + ref.off(event, fn); + } + } + }; + } else { + return { + // eslint-disable-next-line @typescript-eslint/no-empty-function + unsubscribe() { + } + }; + } + }).pipe( + map(payload => { + const { snapshot, prevKey } = payload; + let key: string | null = null; + if (snapshot.exists()) { + key = snapshot.key; + } + return { type: event, payload: snapshot, prevKey, key }; + }), + share() + ); +} diff --git a/src/compat/database/package.json b/src/compat/database/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/compat/database/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/database/public_api.ts b/src/compat/database/public_api.ts new file mode 100644 index 000000000..b1f0ab756 --- /dev/null +++ b/src/compat/database/public_api.ts @@ -0,0 +1,8 @@ +export * from './database'; +export * from './list/changes'; +export * from './list/create-reference'; +export * from './list/snapshot-changes'; +export * from './list/state-changes'; +export * from './list/audit-trail'; +export * from './observable/fromRef'; +export * from './database.module'; diff --git a/src/compat/database/utils.spec.ts b/src/compat/database/utils.spec.ts new file mode 100644 index 000000000..7363ddc53 --- /dev/null +++ b/src/compat/database/utils.spec.ts @@ -0,0 +1,26 @@ +import * as utils from './utils'; + +describe('utils', () => { + + describe('isString', () => { + + it('should be able to properly detect a string', () => { + const str = 'oh hai'; + const notStr = 101; + const bool = true; + const nul = null; + const obj = {}; + const fn = () => undefined; + const undef = undefined; + expect(utils.isString(str)).toBe(true); + expect(utils.isString(notStr)).toBe(false); + expect(utils.isString(bool)).toBe(false); + expect(utils.isString(nul)).toBe(false); + expect(utils.isString(obj)).toBe(false); + expect(utils.isString(fn)).toBe(false); + expect(utils.isString(undef)).toBe(false); + }); + + }); + +}); diff --git a/src/compat/database/utils.ts b/src/compat/database/utils.ts new file mode 100644 index 000000000..8a648bb00 --- /dev/null +++ b/src/compat/database/utils.ts @@ -0,0 +1,41 @@ +import firebase from 'firebase/compat/app'; +import { DatabaseReference, FirebaseOperation, FirebaseOperationCases, PathReference } from './interfaces'; + +export function isString(value: any): boolean { + return typeof value === 'string'; +} + +export function isFirebaseDataSnapshot(value: any): boolean { + return typeof value.exportVal === 'function'; +} + +export function isNil(obj: any): boolean { + return obj === undefined || obj === null; +} + +export function isFirebaseRef(value: any): boolean { + return typeof value.set === 'function'; +} + +/** + * Returns a database reference given a Firebase App and an + * absolute or relative path. + * @param database - Firebase Database + * @param pathRef - Database path, relative or absolute + */ +export function getRef(database: firebase.database.Database, pathRef: PathReference): DatabaseReference { + // if a db ref was passed in, just return it + return isFirebaseRef(pathRef) ? pathRef as DatabaseReference + : database.ref(pathRef as string); +} + +export function checkOperationCases(item: FirebaseOperation, cases: FirebaseOperationCases): Promise { + if (isString(item)) { + return cases.stringCase(); + } else if (isFirebaseRef(item)) { + return cases.firebaseCase(); + } else if (isFirebaseDataSnapshot(item)) { + return cases.snapshotCase(); + } + throw new Error(`Expects a string, snapshot, or reference. Got: ${typeof item}`); +} diff --git a/src/compat/firebase.app.module.ts b/src/compat/firebase.app.module.ts new file mode 100644 index 000000000..df20cde0c --- /dev/null +++ b/src/compat/firebase.app.module.ts @@ -0,0 +1,69 @@ +import { + Inject, InjectionToken, ModuleWithProviders, VERSION as NG_VERSION, NgModule, NgZone, Optional, PLATFORM_ID, isDevMode +} from '@angular/core'; +import { VERSION } from '@angular/fire'; +import { FirebaseAppSettings, FirebaseOptions } from 'firebase/app'; +import firebase from 'firebase/compat/app'; +import { FirebaseApp } from './firebase.app'; + +export const FIREBASE_OPTIONS = new InjectionToken('angularfire2.app.options'); +export const FIREBASE_APP_NAME = new InjectionToken('angularfire2.app.name'); + + +export function ÉĩfirebaseAppFactory(options: FirebaseOptions, zone: NgZone, nameOrConfig?: string | FirebaseAppSettings | null) { + const name = typeof nameOrConfig === 'string' && nameOrConfig || '[DEFAULT]'; + const config = typeof nameOrConfig === 'object' && nameOrConfig || {}; + config.name = config.name || name; + // Added any due to some inconsistency between @firebase/app and firebase types + const existingApp = firebase.apps.filter(app => app && app.name === config.name)[0]; + // We support FirebaseConfig, initializeApp's public type only accepts string; need to cast as any + // Could be solved with https://github.com/firebase/firebase-js-sdk/pull/1206 + const app = (existingApp || zone.runOutsideAngular(() => firebase.initializeApp(options, config as any))); + try { + if (JSON.stringify(options) !== JSON.stringify(app.options)) { + const hmr = !!(module as any).hot; + log('error', `${app.name} Firebase App already initialized with different options${hmr ? ', you may need to reload as Firebase is not HMR aware.' : '.'}`); + } + } catch (e) { /* empty */ } + return new FirebaseApp(app); +} + +const log = (level: 'log'|'error'|'info'|'warn', ...args: any) => { + if (isDevMode() && typeof console !== 'undefined') { + // eslint-disable-next-line no-console + console[level](...args); + } +}; + +const FIREBASE_APP_PROVIDER = { + provide: FirebaseApp, + useFactory: ÉĩfirebaseAppFactory, + deps: [ + FIREBASE_OPTIONS, + NgZone, + [new Optional(), FIREBASE_APP_NAME] + ] +}; + +@NgModule({ + providers: [FIREBASE_APP_PROVIDER] +}) +export class AngularFireModule { + static initializeApp(options: FirebaseOptions, nameOrConfig?: string | FirebaseAppSettings): ModuleWithProviders { + return { + ngModule: AngularFireModule, + providers: [ + {provide: FIREBASE_OPTIONS, useValue: options}, + {provide: FIREBASE_APP_NAME, useValue: nameOrConfig} + ] + }; + } + + // eslint-disable-next-line @typescript-eslint/ban-types + constructor(@Inject(PLATFORM_ID) platformId: Object) { + firebase.registerVersion('angularfire', VERSION.full, 'core'); + firebase.registerVersion('angularfire', VERSION.full, 'app-compat'); + // eslint-disable-next-line @typescript-eslint/no-base-to-string + firebase.registerVersion('angular', NG_VERSION.full, platformId.toString()); + } +} diff --git a/src/compat/firebase.app.ts b/src/compat/firebase.app.ts new file mode 100644 index 000000000..3f8f6d6be --- /dev/null +++ b/src/compat/firebase.app.ts @@ -0,0 +1,10 @@ +import firebase from 'firebase/compat/app'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface FirebaseApp extends firebase.app.App {} + +export class FirebaseApp { + constructor(app: firebase.app.App) { + return app; + } +} diff --git a/src/compat/firestore/collection-group/collection-group.spec.ts b/src/compat/firestore/collection-group/collection-group.spec.ts new file mode 100644 index 000000000..3eb30bdf0 --- /dev/null +++ b/src/compat/firestore/collection-group/collection-group.spec.ts @@ -0,0 +1,527 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFirestore, AngularFirestoreCollectionGroup , AngularFirestoreModule, Query, QueryGroupFn, USE_EMULATOR } from '@angular/fire/compat/firestore'; +import { BehaviorSubject } from 'rxjs'; +import { skip, switchMap, take } from 'rxjs/operators'; +import { COMMON_CONFIG, firestoreEmulatorPort } from '../../../test-config'; +import { rando } from '../../../utils'; +import { + FAKE_STOCK_DATA, + Stock, + createRandomStocks, + delayAdd, + delayDelete, + delayUpdate, + randomName +} from '../utils.spec'; +import 'firebase/compat/firestore'; + +async function collectionHarness(afs: AngularFirestore, items: number, queryGroupFn?: QueryGroupFn) { + const randomCollectionName = randomName(afs.firestore); + const ref = TestBed.runInInjectionContext(() => afs.firestore.collection(`${randomCollectionName}`)); + const firestore = afs.firestore; + const collectionGroup = TestBed.runInInjectionContext(() => firestore.collectionGroup(randomCollectionName)) as Query; + const queryFn = queryGroupFn || (ref => ref); + const stocks = new AngularFirestoreCollectionGroup(queryFn(collectionGroup), afs); + const names = await TestBed.runInInjectionContext(() => createRandomStocks(afs.firestore, ref, items)); + return { randomCollectionName, ref, stocks, names }; +} + +describe('AngularFirestoreCollectionGroup', () => { + let afs: AngularFirestore; + + beforeEach(() => { + pending("These are pretty broken, investigate."); + + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFirestoreModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', firestoreEmulatorPort] } + ] + }); + + afs = TestBed.inject(AngularFirestore); + }); + + describe('valueChanges()', () => { + + it('should get unwrapped snapshot', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.valueChanges()).subscribe(data => { + // unsub immediately as we will be deleting data at the bottom + // and that will trigger another subscribe callback and fail + // the test + sub.unsubscribe(); + // We added four things. This should be four. + // This could not be four if the batch failed or + // if the collection state is altered during a test run + expect(data.length).toEqual(ITEMS); + data.forEach(stock => { + // We used the same piece of data so they should all equal + expect(stock).toEqual(FAKE_STOCK_DATA); + }); + done(); + }); + })(); + }); + + it('should handle multiple subscriptions (hot)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.valueChanges()); + const sub = changes.subscribe(() => undefined); + sub.add( + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + sub.unsubscribe(); + done(); + }) + ); + })(); + }); + + it('should handle multiple subscriptions (warm)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.valueChanges()); + changes.pipe(take(1)).subscribe(() => undefined).add(() => { + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + done(); + }) + }); + })(); + }); + + it('should handle dynamic queries that return empty sets', done => { + (async () => { + const ITEMS = 10; + let count = 0; + + const pricefilter$ = new BehaviorSubject(null); + const randomCollectionName = randomName(afs.firestore); + const ref = TestBed.runInInjectionContext(() => afs.firestore.collection(`${randomCollectionName}`)); + await createRandomStocks(afs.firestore, ref, ITEMS); + const sub = pricefilter$.pipe(switchMap(price => { + return TestBed.runInInjectionContext(() => afs.collection(randomCollectionName, ref => price ? ref.where('price', '==', price) : ref).valueChanges()); + })).subscribe(data => { + count = count + 1; + // the first time should all be 'added' + if (count === 1) { + expect(data.length).toEqual(ITEMS); + pricefilter$.next(-1); + } + // on the second round, we should have filtered out everything + if (count === 2) { + expect(data.length).toEqual(0); + sub.unsubscribe(); + done(); + } + }); + })(); + }); + + it('should return the document\'s id along with the data if the idField option is provided.', done => { + (async () => { + const ITEMS = 4; + const DOC_ID = 'docId'; + const { stocks } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.valueChanges({idField: DOC_ID})).subscribe(data => { + const allDocumentsHaveId = data.every(d => d.docId !== undefined); + + expect(allDocumentsHaveId).toBe(true); + sub.unsubscribe(); + done(); + }); + })(); + }); + + }); + + describe('snapshotChanges()', () => { + + it('should listen to all snapshotChanges() by default', done => { + (async () => { + const ITEMS = 10; + let count = 0; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges()).subscribe(data => { + count = count + 1; + // the first time should all be 'added' + if (count === 1) { + // make an update + ref.doc(names[0]).update({ price: 2 }); + } + // on the second round, make sure the array is still the same + // length but the updated item is now modified + if (count === 2) { + expect(data.length).toEqual(ITEMS); + const change = data.filter(x => x.payload.doc.id === names[0])[0]; + expect(change.type).toEqual('modified'); + sub.unsubscribe(); + done(); + } + }); + })(); + }); + + it('should handle multiple subscriptions (hot)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.snapshotChanges()); + const sub = changes.subscribe(() => undefined); + sub.add( + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + sub.unsubscribe(); + done(); + }) + ); + })(); + }); + + it('should handle multiple subscriptions (warm)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.snapshotChanges()); + changes.pipe(take(1)).subscribe(() => undefined).add(() => { + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + done(); + }); + }); + })(); + }); + + it('should update order on queries', done => { + (async () => { + const ITEMS = 10; + let count = 0; + let firstIndex = 0; + const { ref, stocks, names } = + await collectionHarness(afs, ITEMS, ref => ref.orderBy('price', 'desc')); + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges()).subscribe(data => { + count = count + 1; + // the first time should all be 'added' + if (count === 1) { + // make an update + firstIndex = data.filter(d => d.payload.doc.id === names[0])[0].payload.newIndex; + ref.doc(names[0]).update({ price: 2 }); + } + // on the second round, make sure the array is still the same + // length but the updated item is now modified + if (count === 2) { + expect(data.length).toEqual(ITEMS); + const change = data.filter(x => x.payload.doc.id === names[0])[0]; + expect(change.type).toEqual('modified'); + expect(change.payload.oldIndex).toEqual(firstIndex); + sub.unsubscribe(); + done(); + } + }); + })(); + }); + + it('should be able to filter snapshotChanges() types - modified', done => { + pending("TODO(jamesdaniels) find out why this is flaking with SDK v11"); + (async () => { + const ITEMS = 10; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges(['modified'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + const change = data.filter(x => x.payload.doc.id === names[0])[0]; + expect(data.length).toEqual(1); + expect(change.payload.doc.data().price).toEqual(2); + expect(change.type).toEqual('modified'); + done(); + }); + + delayUpdate(ref, names[0], { price: 2 }); + })(); + }); + + it('should be able to filter snapshotChanges() types - added', done => { + (async () => { + const ITEMS = 10; + const harness = await collectionHarness(afs, ITEMS); + const { randomCollectionName, ref, stocks } = harness; + let { names } = harness; + const nextId = ref.doc('a').id; + + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges(['added'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + const change = data.filter(x => x.payload.doc.id === nextId)[0]; + expect(data.length).toEqual(ITEMS + 1); + expect(change.payload.doc.data().price).toEqual(2); + expect(change.type).toEqual('added'); + done(); + }); + + + names = names.concat([nextId]); + // TODO these two add tests are the only one really testing collection-group queries + // should flex more, maybe split the stocks between more than one collection + delayAdd(ref.doc(names[0]).collection(randomCollectionName), nextId, { price: 2 }); + })(); + }); + + it('should be able to filter snapshotChanges() types - added w/same id', done => { + (async () => { + const ITEMS = 10; + const { randomCollectionName, ref, stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges(['added'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + const change = data.filter(x => x.payload.doc.id === names[0])[1]; + expect(data.length).toEqual(ITEMS + 1); + expect(change.payload.doc.data().price).toEqual(3); + expect(change.type).toEqual('added'); + done(); + }); + + delayAdd(ref.doc(names[0]).collection(randomCollectionName), names[0], { price: 3 }); + })(); + }); + + /* TODO(jamesdaniels): revisit this test with metadata changes, need to do some additional skips + it('should be able to filter snapshotChanges() types - added/modified', done => { + (async () => { + const ITEMS = 10; + + const harness = await collectionHarness(afs, ITEMS); + const { ref, stocks } = harness; + let { names } = harness; + + const nextId = ref.doc('a').id; + let count = 0; + + stocks.snapshotChanges(['added', 'modified']).pipe(skip(1), take(2)).subscribe(data => { + count += 1; + if (count === 1) { + const change = data.filter(x => x.payload.doc.id === nextId)[0]; + expect(data.length).toEqual(ITEMS + 1); + expect(change.payload.doc.data().price).toEqual(2); + expect(change.type).toEqual('added'); + delayUpdate(ref, names[0], { price: 2 }); + } + if (count === 2) { + const change = data.filter(x => x.payload.doc.id === names[0])[0]; + expect(data.length).toEqual(ITEMS + 1); + expect(change.payload.doc.data().price).toEqual(2); + expect(change.type).toEqual('modified'); + } + }).add(() => { + deleteThemAll(names, ref) + .then(() => { + done() + }) + .catch(() => { + done.fail() + }); + }); + + names = names.concat([nextId]); + delayAdd(ref, nextId, { price: 2 }); + })(); + }); + */ + + it('should be able to filter snapshotChanges() types - removed', done => { + (async () => { + + const ITEMS = 10; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges(['added', 'removed'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + const change = data.filter(x => x.payload.doc.id === names[0]); + expect(data.length).toEqual(ITEMS - 1); + expect(change.length).toEqual(0); + done(); + }); + + delayDelete(ref, names[0], 400); + })(); + }); + + }); + + describe('stateChanges()', () => { + + it('should get stateChanges() updates', done => { + (async () => { + const ITEMS = 10; + const { stocks } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.stateChanges()).subscribe(data => { + // unsub immediately as we will be deleting data at the bottom + // and that will trigger another subscribe callback and fail + // the test + sub.unsubscribe(); + // We added ten things. This should be ten. + // This could not be ten if the batch failed or + // if the collection state is altered during a test run + expect(data.length).toEqual(ITEMS); + data.forEach(action => { + // We used the same piece of data so they should all equal + expect(action.payload.doc.data()).toEqual(FAKE_STOCK_DATA); + }); + done(); + }); + })(); + }); + + it('should listen to all stateChanges() by default', done => { + (async () => { + const ITEMS = 10; + let count = 0; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + TestBed.runInInjectionContext(() => stocks.stateChanges()).subscribe(data => { + count = count + 1; + if (count === 1) { + ref.doc(names[0]).update({ price: 2 }); + } + if (count === 2) { + expect(data.length).toEqual(1); + expect(data[0].type).toEqual('modified'); + done(); + } + }); + })(); + }); + + it('should handle multiple subscriptions (hot)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.stateChanges()); + const sub = changes.subscribe(() => undefined); + sub.add( + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + sub.unsubscribe(); + done(); + }) + ); + })(); + }); + + it('should handle multiple subscriptions (warm)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.stateChanges()); + changes.pipe(take(1)).subscribe(() => undefined).add(() => { + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + done(); + }); + }); + })(); + }); + + it('should be able to filter stateChanges() types - modified', done => { + pending("TODO(jamesdaniels) find out why this is flaking with SDK v11"); + (async () => { + const ITEMS = 10; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.stateChanges(['modified'])).subscribe(data => { + sub.unsubscribe(); + expect(data.length).toEqual(1); + expect(data[0].payload.doc.data().price).toEqual(2); + expect(data[0].type).toEqual('modified'); + done(); + }); + + delayUpdate(ref, names[0], { price: 2 }); + })(); + }); + + it('should be able to filter stateChanges() types - added', done => { + (async () => { + const ITEMS = 10; + + const { ref, stocks } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.stateChanges(['added'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + expect(data.length).toEqual(1); + expect(data[0].payload.doc.data().price).toEqual(2); + expect(data[0].type).toEqual('added'); + done(); + }); + + const nextId = ref.doc('a').id; + delayAdd(ref, nextId, { price: 2 }); + })(); + }); + + it('should be able to filter stateChanges() types - removed', done => { + (async () => { + const ITEMS = 10; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.stateChanges(['removed'])).subscribe(data => { + sub.unsubscribe(); + expect(data.length).toEqual(1); + expect(data[0].type).toEqual('removed'); + done(); + }); + + delayDelete(ref, names[0], 400); + })(); + }); + }); + + describe('auditTrail()', () => { + it('should listen to all events for auditTrail() by default', done => { + (async () => { + const ITEMS = 10; + let count = 0; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + const sub = TestBed.runInInjectionContext(() => stocks.auditTrail()).subscribe(data => { + count = count + 1; + if (count === 1) { + ref.doc(names[0]).update({ price: 2 }); + } + if (count === 2) { + sub.unsubscribe(); + expect(data.length).toEqual(ITEMS + 1); + expect(data[data.length - 1].type).toEqual('modified'); + done(); + } + }); + })(); + }); + + it('should be able to filter auditTrail() types - removed', done => { + (async () => { + const ITEMS = 10; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.auditTrail(['removed'])).subscribe(data => { + sub.unsubscribe(); + expect(data.length).toEqual(1); + expect(data[0].type).toEqual('removed'); + done(); + }); + + delayDelete(ref, names[0], 400); + })(); + }); + }); + +}); diff --git a/src/compat/firestore/collection-group/collection-group.ts b/src/compat/firestore/collection-group/collection-group.ts new file mode 100644 index 000000000..b1a1a3441 --- /dev/null +++ b/src/compat/firestore/collection-group/collection-group.ts @@ -0,0 +1,117 @@ +import { EnvironmentInjector, inject } from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import firebase from 'firebase/compat/app'; +import { Observable, from } from 'rxjs'; +import { filter, map, scan } from 'rxjs/operators'; +import { docChanges, sortedChanges } from '../collection/changes'; +import { validateEventsArray } from '../collection/collection'; +import { AngularFirestore } from '../firestore'; +import { DocumentChangeAction, DocumentChangeType, DocumentData, Query } from '../interfaces'; +import { fromCollectionRef } from '../observable/fromRef'; + +/** + * AngularFirestoreCollectionGroup service + * + * This class holds a reference to a Firestore Collection Group Query. + * + * This class uses Symbol.observable to transform into Observable using Observable.from(). + * + * This class is rarely used directly and should be created from the AngularFirestore service. + * + * Example: + * + * const collectionGroup = firebase.firestore.collectionGroup('stocks'); + * const query = collectionRef.where('price', '>', '0.01'); + * const fakeStock = new AngularFirestoreCollectionGroup(query, afs); + * + * // Subscribe to changes as snapshots. This provides you data updates as well as delta updates. + * fakeStock.valueChanges().subscribe(value => console.log(value)); + */ +export class AngularFirestoreCollectionGroup { + private readonly injector = inject(EnvironmentInjector); + + /** + * The constructor takes in a CollectionGroupQuery to provide wrapper methods + * for data operations and data streaming. + */ + constructor( + private readonly query: Query, + private readonly afs: AngularFirestore) { } + + /** + * Listen to the latest change in the stream. This method returns changes + * as they occur and they are not sorted by query order. This allows you to construct + * your own data structure. + */ + stateChanges(events?: DocumentChangeType[]): Observable[]> { + if (!events || events.length === 0) { + return docChanges(this.query, this.afs.schedulers.outsideAngular).pipe( + pendingUntilEvent(this.injector) + ); + } + return docChanges(this.query, this.afs.schedulers.outsideAngular) + .pipe( + map(actions => actions.filter(change => events.indexOf(change.type) > -1)), + filter(changes => changes.length > 0), + pendingUntilEvent(this.injector) + ); + } + + /** + * Create a stream of changes as they occur it time. This method is similar to stateChanges() + * but it collects each event in an array over time. + */ + auditTrail(events?: DocumentChangeType[]): Observable[]> { + return this.stateChanges(events).pipe(scan((current, action) => [...current, ...action], [])); + } + + /** + * Create a stream of synchronized changes. This method keeps the local array in sorted + * query order. + */ + snapshotChanges(events?: DocumentChangeType[]): Observable[]> { + const validatedEvents = validateEventsArray(events); + const scheduledSortedChanges$ = sortedChanges(this.query, validatedEvents, this.afs.schedulers.outsideAngular); + return scheduledSortedChanges$.pipe( + pendingUntilEvent(this.injector) + ); + } + + /** + * Listen to all documents in the collection and its possible query as an Observable. + * + * If the `idField` option is provided, document IDs are included and mapped to the + * provided `idField` property name. + */ + valueChanges(): Observable; + // eslint-disable-next-line no-empty-pattern + valueChanges({}): Observable; + valueChanges(options: {idField: K}): Observable<(T & { [T in K]: string })[]>; + valueChanges(options: {idField?: K} = {}): Observable { + const fromCollectionRefScheduled$ = fromCollectionRef(this.query, this.afs.schedulers.outsideAngular); + return fromCollectionRefScheduled$ + .pipe( + map(actions => actions.payload.docs.map(a => { + if (options.idField) { + return { + [options.idField]: a.id, + ...a.data() + } as T & { [T in K]: string }; + } else { + return a.data(); + } + })), + pendingUntilEvent(this.injector) + ); + } + + /** + * Retrieve the results of the query once. + */ + get(options?: firebase.firestore.GetOptions) { + return from(this.query.get(options)).pipe( + pendingUntilEvent(this.injector) + ); + } + +} diff --git a/src/compat/firestore/collection/changes.ts b/src/compat/firestore/collection/changes.ts new file mode 100644 index 000000000..53b1c20c7 --- /dev/null +++ b/src/compat/firestore/collection/changes.ts @@ -0,0 +1,128 @@ +import firebase from 'firebase/compat/app'; +import { Observable, SchedulerLike } from 'rxjs'; +import { distinctUntilChanged, map, pairwise, scan, startWith } from 'rxjs/operators'; +import { Action, DocumentChange, DocumentChangeAction, DocumentChangeType, Query, QuerySnapshot } from '../interfaces'; +import { fromCollectionRef } from '../observable/fromRef'; + + +type ActionTupe = [Action>, Action>] +/** + * Return a stream of document changes on a query. These results are not in sort order but in + * order of occurence. + */ +export function docChanges(query: Query, scheduler?: SchedulerLike): Observable[]> { + return fromCollectionRef(query, scheduler) + .pipe( + startWith>, undefined>(undefined), + pairwise(), + map((actionTuple: ActionTupe) => { + const [priorAction, action] = actionTuple; + const docChanges = action.payload.docChanges(); + const actions = docChanges.map(change => ({ type: change.type, payload: change })); + // the metadata has changed from the prior emission + if (priorAction && JSON.stringify(priorAction.payload.metadata) !== JSON.stringify(action.payload.metadata)) { + // go through all the docs in payload and figure out which ones changed + action.payload.docs.forEach((currentDoc, currentIndex) => { + const docChange = docChanges.find(d => d.doc.ref.isEqual(currentDoc.ref)); + const priorDoc = priorAction?.payload.docs.find(d => d.ref.isEqual(currentDoc.ref)); + if (docChange && JSON.stringify(docChange.doc.metadata) === JSON.stringify(currentDoc.metadata) || + !docChange && priorDoc && JSON.stringify(priorDoc.metadata) === JSON.stringify(currentDoc.metadata)) { + // document doesn't appear to have changed, don't log another action + } else { + // since the actions are processed in order just push onto the array + actions.push({ + type: 'modified', + payload: { + oldIndex: currentIndex, + newIndex: currentIndex, + type: 'modified', + doc: currentDoc + } + }); + } + }); + } + return actions as DocumentChangeAction[]; + }), + ); +} + +/** + * Return a stream of document changes on a query. These results are in sort order. + */ +export function sortedChanges( + query: Query, + events: DocumentChangeType[], + scheduler?: SchedulerLike): Observable[]> { + return docChanges(query, scheduler) + .pipe( + scan((current, changes) => combineChanges(current, changes.map(it => it.payload), events), []), + distinctUntilChanged(), // cut down on unneed change cycles + map(changes => changes.map(c => ({ type: c.type, payload: c } as DocumentChangeAction)))); +} + +/** + * Combines the total result set from the current set of changes from an incoming set + * of changes. + */ +export function combineChanges(current: DocumentChange[], changes: DocumentChange[], events: DocumentChangeType[]) { + changes.forEach(change => { + // skip unwanted change types + if (events.indexOf(change.type) > -1) { + current = combineChange(current, change); + } + }); + return current; +} + +/** + * Splice arguments on top of a sliced array, to break top-level === + * this is useful for change-detection + */ +function sliceAndSplice( + original: T[], + start: number, + deleteCount: number, + ...args: T[] +): T[] { + const returnArray = original.slice(); + returnArray.splice(start, deleteCount, ...args); + return returnArray; +} + +/** + * Creates a new sorted array from a new change. + * Build our own because we allow filtering of action types ('added', 'removed', 'modified') before scanning + * and so we have greater control over change detection (by breaking ===) + */ +export function combineChange(combined: DocumentChange[], change: DocumentChange): DocumentChange[] { + switch (change.type) { + case 'added': + if (combined[change.newIndex]?.doc.ref.isEqual(change.doc.ref)) { + // Not sure why the duplicates are getting fired + } else { + return sliceAndSplice(combined, change.newIndex, 0, change); + } + break; + case 'modified': + if (combined[change.oldIndex] == null || combined[change.oldIndex].doc.ref.isEqual(change.doc.ref)) { + // When an item changes position we first remove it + // and then add it's new position + if (change.oldIndex !== change.newIndex) { + const copiedArray = combined.slice(); + copiedArray.splice(change.oldIndex, 1); + copiedArray.splice(change.newIndex, 0, change); + return copiedArray; + } else { + return sliceAndSplice(combined, change.newIndex, 1, change); + } + } + break; + case 'removed': + if (combined[change.oldIndex]?.doc.ref.isEqual(change.doc.ref)) { + return sliceAndSplice(combined, change.oldIndex, 1); + } + break; + } + return combined; +} diff --git a/src/compat/firestore/collection/collection.spec.ts b/src/compat/firestore/collection/collection.spec.ts new file mode 100644 index 000000000..ee8f173e6 --- /dev/null +++ b/src/compat/firestore/collection/collection.spec.ts @@ -0,0 +1,520 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFirestore, AngularFirestoreCollection, AngularFirestoreModule, CollectionReference, QueryFn, USE_EMULATOR } from '@angular/fire/compat/firestore'; +import { BehaviorSubject } from 'rxjs'; +import { skip, switchMap, take } from 'rxjs/operators'; +import { COMMON_CONFIG, firestoreEmulatorPort } from '../../../test-config'; +import { rando } from '../../../utils'; +import { + FAKE_STOCK_DATA, + Stock, + createRandomStocks, + delayAdd, + delayDelete, + delayUpdate, + randomName +} from '../utils.spec'; + +import 'firebase/compat/firestore'; + +async function collectionHarness(afs: AngularFirestore, items: number, queryFn?: QueryFn) { + const randomCollectionName = randomName(afs.firestore); + const ref = afs.firestore.collection(`${randomCollectionName}`) as CollectionReference; + if (!queryFn) { + queryFn = (ref) => ref; + } + const stocks = new AngularFirestoreCollection(ref, queryFn(ref), afs); + const names = await createRandomStocks(afs.firestore, ref, items); + return { randomCollectionName, ref, stocks, names }; +} + +describe('AngularFirestoreCollection', () => { + + + let afs: AngularFirestore; + + beforeEach(() => { + pending("These are pretty broken, investigate."); + + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFirestoreModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', firestoreEmulatorPort] } + ] + }); + + afs = TestBed.inject(AngularFirestore); + }); + + describe('valueChanges()', () => { + + it('should get unwrapped snapshot', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.valueChanges()).subscribe(data => { + // unsub immediately as we will be deleting data at the bottom + // and that will trigger another subscribe callback and fail + // the test + sub.unsubscribe(); + // We added four things. This should be four. + // This could not be four if the batch failed or + // if the collection state is altered during a test run + expect(data.length).toEqual(ITEMS); + data.forEach(stock => { + // We used the same piece of data so they should all equal + expect(stock).toEqual(FAKE_STOCK_DATA); + }); + done(); + }); + })(); + }); + + /* FLAKE? timing out + it('should optionally map the doc ID to the emitted data object', done => { + const ITEMS = 1; + const { ref, stocks, names } = await collectionHarness(afs, ITEMS); + const idField = 'myCustomID'; + const sub = stocks.valueChanges({idField}).subscribe(data => { + sub.unsubscribe(); + const stock = data[0]; + expect(stock[idField]).toBeDefined(); + expect(stock).toEqual(jasmine.objectContaining(FAKE_STOCK_DATA)); + deleteThemAll(names, ref).then(done).catch(fail); + }) + });*/ + + it('should handle multiple subscriptions (hot)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.valueChanges()); + const sub = changes.subscribe(() => undefined); + sub.add( + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + sub.unsubscribe(); + done(); + }) + ); + })(); + }); + + it('should handle multiple subscriptions (warm)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.valueChanges()); + changes.pipe(take(1)).subscribe(() => undefined).add(() => { + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + done(); + }); + }); + })(); + }); + + it('should handle dynamic queries that return empty sets', done => { + (async () => { + const ITEMS = 10; + let count = 0; + + const pricefilter$ = new BehaviorSubject(null); + const randomCollectionName = randomName(afs.firestore); + const ref = afs.firestore.collection(`${randomCollectionName}`); + await createRandomStocks(afs.firestore, ref, ITEMS); + const sub = pricefilter$.pipe(switchMap(price => { + return TestBed.runInInjectionContext(() => afs.collection(randomCollectionName, ref => price ? ref.where('price', '==', price) : ref).valueChanges()); + })).subscribe(data => { + count = count + 1; + // the first time should all be 'added' + if (count === 1) { + expect(data.length).toEqual(ITEMS); + pricefilter$.next(-1); + } + // on the second round, we should have filtered out everything + if (count === 2) { + expect(data.length).toEqual(0); + sub.unsubscribe(); + done(); + } + }); + })(); + }); + + }); + + describe('snapshotChanges()', () => { + + it('should listen to all snapshotChanges() by default', done => { + (async () => { + const ITEMS = 10; + let count = 0; + const { stocks, names } = await collectionHarness(afs, ITEMS); + const firstName = names[0]; + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges()).subscribe(data => { + count = count + 1; + // the first time should all be 'added' + if (count === 1) { + // make an update + stocks.doc(firstName).update({ price: 2 }); + } + // on the second round, make sure the array is still the same + // length but the updated item is now modified + if (count === 2) { + expect(data.length).toEqual(ITEMS); + const change = data.filter(x => x.payload.doc.id === firstName)[0]; + expect(change.type).toEqual('modified'); + sub.unsubscribe(); + done(); + } + }); + })(); + }); + + it('should handle multiple subscriptions (hot)', done => { + async function setup() { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes$ = TestBed.runInInjectionContext(() => stocks.snapshotChanges()); + const sub = changes$.subscribe(() => undefined); + sub.add( + changes$.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + sub.unsubscribe(); + done(); + }) + ); + } + setup() + }); + + it('should handle multiple subscriptions (warm)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.snapshotChanges()); + changes.pipe(take(1)).subscribe(() => undefined).add(() => { + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + done(); + }); + }); + })(); + }); + + it('should update order on queries', done => { + (async () => { + const ITEMS = 10; + let count = 0; + let firstIndex = 0; + const { stocks, names } = + await collectionHarness(afs, ITEMS, ref => ref.orderBy('price', 'desc')); + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges()).subscribe(data => { + count = count + 1; + // the first time should all be 'added' + if (count === 1) { + // make an update + firstIndex = data.filter(d => d.payload.doc.id === names[0])[0].payload.newIndex; + stocks.doc(names[0]).update({ price: 2 }); + } + // on the second round, make sure the array is still the same + // length but the updated item is now modified + if (count === 2) { + expect(data.length).toEqual(ITEMS); + const change = data.filter(x => x.payload.doc.id === names[0])[0]; + expect(change.type).toEqual('modified'); + expect(change.payload.oldIndex).toEqual(firstIndex); + sub.unsubscribe(); + done(); + } + }); + })(); + }); + + it('should be able to filter snapshotChanges() types - modified', done => { + pending("TODO(jamesdaniels) find out why this is flaking with SDK v11"); + (async () => { + const ITEMS = 10; + const { stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges(['modified'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + const change = data.filter(x => x.payload.doc.id === names[0])[0]; + expect(data.length).toEqual(1); + expect(change.payload.doc.data().price).toEqual(2); + expect(change.type).toEqual('modified'); + done(); + }); + + delayUpdate(stocks, names[0], { price: 2 }); + })(); + }); + + it('should be able to filter snapshotChanges() types - added', done => { + (async () => { + const ITEMS = 10; + const { ref, stocks } = await collectionHarness(afs, ITEMS); + + const nextId = ref.doc('a').id; + + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges(['added'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + const change = data.filter(x => x.payload.doc.id === nextId)[0]; + expect(data.length).toEqual(ITEMS + 1); + expect(change.payload.doc.data().price).toEqual(2); + expect(change.type).toEqual('added'); + done(); + }); + + delayAdd(stocks, nextId, { price: 2 }); + })(); + }); + + /* TODO(jamesdaniels): revisit this now that we have metadata + it('should be able to filter snapshotChanges() types - added/modified', done => { + (async () => { + const ITEMS = 10; + const harness = await collectionHarness(afs, ITEMS); + const { ref, stocks } = harness; + let names = harness.names; + + const nextId = ref.doc('a').id; + let count = 0; + + stocks.snapshotChanges(['added', 'modified']).pipe(skip(1), take(2)).subscribe(data => { + count += 1; + if (count === 1) { + const change = data.filter(x => x.payload.doc.id === nextId)[0]; + expect(data.length).toEqual(ITEMS + 1); + expect(change.payload.doc.data().price).toEqual(2); + expect(change.type).toEqual('added'); + delayUpdate(stocks, names[0], { price: 2 }); + } + if (count === 2) { + const change = data.filter(x => x.payload.doc.id === names[0])[0]; + expect(data.length).toEqual(ITEMS + 1); + expect(change.payload.doc.data().price).toEqual(2); + expect(change.type).toEqual('modified'); + } + }).add(() => { + deleteThemAll(names, ref) + .then(() => { + done() + }) + .catch(() => { + done.fail() + }); + }); + + names = names.concat([nextId]); + delayAdd(stocks, nextId, { price: 2 }); + })(); + }); + */ + + it('should be able to filter snapshotChanges() types - removed', done => { + (async () => { + const ITEMS = 10; + const { stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.snapshotChanges(['added', 'removed'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + const change = data.filter(x => x.payload.doc.id === names[0]); + expect(data.length).toEqual(ITEMS - 1); + expect(change.length).toEqual(0); + done(); + }); + + delayDelete(stocks, names[0], 400); + })(); + }); + + }); + + describe('stateChanges()', () => { + + it('should get stateChanges() updates', done => { + (async () => { + const ITEMS = 10; + const { stocks } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.stateChanges()).subscribe(data => { + // unsub immediately as we will be deleting data at the bottom + // and that will trigger another subscribe callback and fail + // the test + sub.unsubscribe(); + // We added ten things. This should be ten. + // This could not be ten if the batch failed or + // if the collection state is altered during a test run + expect(data.length).toEqual(ITEMS); + data.forEach(action => { + // We used the same piece of data so they should all equal + expect(action.payload.doc.data()).toEqual(FAKE_STOCK_DATA); + }); + done(); + }); + })(); + }); + + it('should listen to all stateChanges() by default', done => { + (async () => { + const ITEMS = 10; + let count = 0; + const { stocks, names } = await collectionHarness(afs, ITEMS); + TestBed.runInInjectionContext(() => stocks.stateChanges()).subscribe(data => { + count = count + 1; + if (count === 1) { + stocks.doc(names[0]).update({ price: 2 }); + } + if (count === 2) { + expect(data.length).toEqual(1); + expect(data[0].type).toEqual('modified'); + done(); + } + }); + })(); + }); + + it('should handle multiple subscriptions (hot)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.stateChanges()); + const sub = changes.subscribe(() => undefined); + sub.add( + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + sub.unsubscribe(); + done(); + }) + ); + })(); + }); + + it('should handle multiple subscriptions (warm)', done => { + (async () => { + const ITEMS = 4; + const { stocks } = await collectionHarness(afs, ITEMS); + const changes = TestBed.runInInjectionContext(() => stocks.stateChanges()); + changes.pipe(take(1)).subscribe(() => undefined).add(() => { + changes.pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(ITEMS); + done(); + }); + }); + })(); + }); + + it('should be able to filter stateChanges() types - modified', done => { + pending("TODO(jamesdaniels) find out why this is flaking with SDK v11"); + (async () => { + const ITEMS = 10; + const { stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.stateChanges(['modified'])).pipe(skip(1), take(1)).subscribe(data => { + sub.unsubscribe(); + expect(data.length).toEqual(1); + expect(data[0].payload.doc.data().price).toEqual(2); + expect(data[0].type).toEqual('modified'); + done(); + }); + + delayUpdate(stocks, names[0], { price: 2 }); + })(); + }); + + it('should be able to filter stateChanges() types - added', done => { + (async () => { + const ITEMS = 10; + + const { ref, stocks } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.stateChanges(['added'])).pipe(skip(1)).subscribe(data => { + sub.unsubscribe(); + expect(data.length).toEqual(1); + expect(data[0].payload.doc.data().price).toEqual(2); + expect(data[0].type).toEqual('added'); + done(); + }); + + const nextId = ref.doc('a').id; + delayAdd(stocks, nextId, { price: 2 }); + })(); + }); + + it('should be able to filter stateChanges() types - removed', done => { + (async () => { + const ITEMS = 10; + const { stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.stateChanges(['removed'])).pipe(skip(1), take(1)).subscribe(data => { + sub.unsubscribe(); + expect(data.length).toEqual(1); + expect(data[0].type).toEqual('removed'); + done(); + }); + + delayDelete(stocks, names[0], 400); + })(); + }); + + it('stateChanges() should emit on empty collection', done => { + TestBed.runInInjectionContext(() => afs.collection('EMPTY_COLLECTION').stateChanges()).pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(0); + done(); + }); + }); + + it('stateChanges() w/filter should emit on empty collection', done => { + TestBed.runInInjectionContext(() => afs.collection('EMPTY_COLLECTION').stateChanges(['added'])).pipe(take(1)).subscribe(data => { + expect(data.length).toEqual(0); + done(); + }); + }); + + }); + + describe('auditTrail()', () => { + it('should listen to all events for auditTrail() by default', done => { + (async () => { + const ITEMS = 10; + let count = 0; + const { stocks, names } = await collectionHarness(afs, ITEMS); + const sub =TestBed.runInInjectionContext(() => stocks.auditTrail()).subscribe(data => { + count = count + 1; + if (count === 1) { + stocks.doc(names[0]).update({ price: 2 }); + } + if (count === 2) { + sub.unsubscribe(); + expect(data.length).toEqual(ITEMS + 1); + expect(data[data.length - 1].type).toEqual('modified'); + done(); + } + }); + })(); + }); + + it('should be able to filter auditTrail() types - removed', done => { + (async () => { + const ITEMS = 10; + const { stocks, names } = await collectionHarness(afs, ITEMS); + + const sub = TestBed.runInInjectionContext(() => stocks.auditTrail(['removed'])).pipe(skip(1), take(1)).subscribe(data => { + sub.unsubscribe(); + expect(data.length).toEqual(1); + expect(data[0].type).toEqual('removed'); + done(); + }); + + delayDelete(stocks, names[0], 400); + })(); + }); + }); + +}); diff --git a/src/compat/firestore/collection/collection.ts b/src/compat/firestore/collection/collection.ts new file mode 100644 index 000000000..0a1d489b8 --- /dev/null +++ b/src/compat/firestore/collection/collection.ts @@ -0,0 +1,158 @@ +import { EnvironmentInjector, inject } from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import firebase from 'firebase/compat/app'; +import { Observable, from } from 'rxjs'; +import { filter, map, pairwise, scan, startWith } from 'rxjs/operators'; +import { AngularFirestoreDocument } from '../document/document'; +import { AngularFirestore } from '../firestore'; +import { CollectionReference, DocumentChangeAction, DocumentChangeType, DocumentData, DocumentReference, Query } from '../interfaces'; +import { fromCollectionRef } from '../observable/fromRef'; +import { docChanges, sortedChanges } from './changes'; + +type DocumentChangeTuple = [DocumentChangeAction[], DocumentChangeAction[]]; + +export function validateEventsArray(events?: DocumentChangeType[]) { + if (!events || events.length === 0) { + events = ['added', 'removed', 'modified']; + } + return events; +} + +/** + * AngularFirestoreCollection service + * + * This class creates a reference to a Firestore Collection. A reference and a query are provided in + * in the constructor. The query can be the unqueried reference if no query is desired.The class + * is generic which gives you type safety for data update methods and data streaming. + * + * This class uses Symbol.observable to transform into Observable using Observable.from(). + * + * This class is rarely used directly and should be created from the AngularFirestore service. + * + * Example: + * + * const collectionRef = firebase.firestore.collection('stocks'); + * const query = collectionRef.where('price', '>', '0.01'); + * const fakeStock = new AngularFirestoreCollection(collectionRef, query); + * + * // NOTE!: the updates are performed on the reference not the query + * await fakeStock.add({ name: 'FAKE', price: 0.01 }); + * + * // Subscribe to changes as snapshots. This provides you data updates as well as delta updates. + * fakeStock.valueChanges().subscribe(value => console.log(value)); + */ +export class AngularFirestoreCollection { + private readonly injector = inject(EnvironmentInjector); + + /** + * The constructor takes in a CollectionReference and Query to provide wrapper methods + * for data operations and data streaming. + * + * Note: Data operation methods are done on the reference not the query. This means + * when you update data it is not updating data to the window of your query unless + * the data fits the criteria of the query. See the AssociatedRefence type for details + * on this implication. + */ + constructor( + public readonly ref: CollectionReference, + private readonly query: Query, + private readonly afs: AngularFirestore) { } + + /** + * Listen to the latest change in the stream. This method returns changes + * as they occur and they are not sorted by query order. This allows you to construct + * your own data structure. + */ + stateChanges(events?: DocumentChangeType[]): Observable[]> { + let source = docChanges(this.query, this.afs.schedulers.outsideAngular); + if (events && events.length > 0) { + source = source.pipe( + map(actions => actions.filter(change => events.indexOf(change.type) > -1)) + ); + } + return source.pipe( + // We want to filter out empty arrays, but always emit at first, so the developer knows + // that the collection has been resolve; even if it's empty + startWith[], undefined>(undefined), + pairwise(), + filter(([prior, current]: DocumentChangeTuple) => current.length > 0 || !prior), + map(([, current]) => current), + pendingUntilEvent(this.injector) + ); + } + + /** + * Create a stream of changes as they occur it time. This method is similar to stateChanges() + * but it collects each event in an array over time. + */ + auditTrail(events?: DocumentChangeType[]): Observable[]> { + return this.stateChanges(events).pipe(scan((current, action) => [...current, ...action], [])); + } + + /** + * Create a stream of synchronized changes. This method keeps the local array in sorted + * query order. + */ + snapshotChanges(events?: DocumentChangeType[]): Observable[]> { + const validatedEvents = validateEventsArray(events); + const scheduledSortedChanges$ = sortedChanges(this.query, validatedEvents, this.afs.schedulers.outsideAngular); + return scheduledSortedChanges$.pipe( + pendingUntilEvent(this.injector) + ); + } + + /** + * Listen to all documents in the collection and its possible query as an Observable. + * + * If the `idField` option is provided, document IDs are included and mapped to the + * provided `idField` property name. + */ + valueChanges(): Observable; + // eslint-disable-next-line no-empty-pattern + valueChanges({}): Observable; + valueChanges(options: {idField: K}): Observable<(T & { [T in K]: string })[]>; + valueChanges(options: {idField?: K} = {}): Observable { + return fromCollectionRef(this.query, this.afs.schedulers.outsideAngular) + .pipe( + map(actions => actions.payload.docs.map(a => { + if (options.idField) { + return { + ...a.data() as any, + ...{ [options.idField]: a.id } + } as T & { [T in K]: string }; + } else { + return a.data(); + } + })), + pendingUntilEvent(this.injector) + ); + } + + /** + * Retrieve the results of the query once. + */ + get(options?: firebase.firestore.GetOptions) { + return from(this.query.get(options)).pipe( + pendingUntilEvent(this.injector) + ); + } + + /** + * Add data to a collection reference. + * + * Note: Data operation methods are done on the reference not the query. This means + * when you update data it is not updating data to the window of your query unless + * the data fits the criteria of the query. + */ + add(data: T): Promise> { + return this.ref.add(data); + } + + /** + * Create a reference to a single document in a collection. + */ + doc(path?: string): AngularFirestoreDocument { + // TODO is there a better way to solve this type issue + return new AngularFirestoreDocument(this.ref.doc(path) as any, this.afs); + } +} diff --git a/src/compat/firestore/document/document.spec.ts b/src/compat/firestore/document/document.spec.ts new file mode 100644 index 000000000..d1ab1b5df --- /dev/null +++ b/src/compat/firestore/document/document.spec.ts @@ -0,0 +1,99 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFirestore, AngularFirestoreDocument, AngularFirestoreModule, DocumentReference, USE_EMULATOR } from '@angular/fire/compat/firestore'; +import firebase from 'firebase/compat/app'; +import { take } from 'rxjs/operators'; +import { COMMON_CONFIG, firestoreEmulatorPort } from '../../../test-config'; +import { rando } from '../../../utils'; +import { FAKE_STOCK_DATA, Stock, randomName } from '../utils.spec'; +import 'firebase/compat/firestore'; + +// TODO(davideast): Investage this flake on Safari. +describe('AngularFirestoreDocument', () => { + let afs: AngularFirestore; + + beforeEach(() => { + pending("These are pretty broken, investigate."); + + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFirestoreModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', firestoreEmulatorPort] } + ] + }); + + afs = TestBed.inject(AngularFirestore); + }); + + describe('valueChanges()', () => { + + it('should get unwrapped snapshot', done => { + (async () => { + const randomCollectionName = TestBed.runInInjectionContext(() => afs.firestore.collection('a').doc().id); + const ref = TestBed.runInInjectionContext(() => afs.firestore.doc(`${randomCollectionName}/FAKE`)) as firebase.firestore.DocumentReference; + const stock = new AngularFirestoreDocument(ref, afs); + await TestBed.runInInjectionContext(() => stock.set(FAKE_STOCK_DATA)); + const obs$ = TestBed.runInInjectionContext(() => stock.valueChanges()); + obs$.pipe(take(1)).subscribe(data => { + expect(data).toEqual(FAKE_STOCK_DATA); + done(); + }); + })(); + }); + + /* TODO(jamesdaniels): test is flaking, look into this + it('should optionally map the doc ID to the emitted data object', done => { + (async () => { + const randomCollectionName = afs.firestore.collection('a').doc().id; + const ref = afs.firestore.doc(`${randomCollectionName}/FAKE`); + const stock = new AngularFirestoreDocument(ref, afs); + await stock.set(FAKE_STOCK_DATA); + const idField = 'myCustomID'; + const obs$ = stock.valueChanges({ idField }); + obs$.pipe(take(1)).subscribe(async data => { + expect(data[idField]).toBeDefined(); + expect(data).toEqual(jasmine.objectContaining(FAKE_STOCK_DATA)); + stock.delete().then(done).catch(done.fail); + }); + })(); + });*/ + + }); + + describe('snapshotChanges()', () => { + + it('should get action updates', done => { + (async () => { + const randomCollectionName = randomName(afs.firestore); + const ref = TestBed.runInInjectionContext(() => afs.firestore.doc(`${randomCollectionName}/FAKE`)) as DocumentReference; + const stock = new AngularFirestoreDocument(ref, afs); + await TestBed.runInInjectionContext(() => stock.set(FAKE_STOCK_DATA)); + const sub = TestBed.runInInjectionContext(() => stock.snapshotChanges()).subscribe(a => { + sub.unsubscribe(); + expect(a.payload.exists).toBeTrue(); + expect(a.payload.data()).toEqual(FAKE_STOCK_DATA); + done(); + }); + })(); + }); + + it('should get unwrapped snapshot', done => { + (async () => { + const randomCollectionName = afs.firestore.collection('a').doc().id; + const ref = TestBed.runInInjectionContext(() => afs.firestore.doc(`${randomCollectionName}/FAKE`)) as DocumentReference; + const stock = new AngularFirestoreDocument(ref, afs); + await TestBed.runInInjectionContext(() => stock.set(FAKE_STOCK_DATA)); + const obs$ = TestBed.runInInjectionContext(() => stock.valueChanges()); + obs$.pipe(take(1)).subscribe(data => { + expect(data).toEqual(FAKE_STOCK_DATA); + done(); + }); + })(); + }); + + }); + +}); diff --git a/src/compat/firestore/document/document.ts b/src/compat/firestore/document/document.ts new file mode 100644 index 000000000..8ffc927d3 --- /dev/null +++ b/src/compat/firestore/document/document.ts @@ -0,0 +1,110 @@ +import { EnvironmentInjector, inject } from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import firebase from 'firebase/compat/app'; +import { Observable, from } from 'rxjs'; +import { map } from 'rxjs/operators'; +import { AngularFirestoreCollection } from '../collection/collection'; +import { AngularFirestore, associateQuery } from '../firestore'; +import { Action, DocumentData, DocumentReference, DocumentSnapshot, QueryFn, SetOptions } from '../interfaces'; +import { fromDocRef } from '../observable/fromRef'; + +/** + * AngularFirestoreDocument service + * + * This class creates a reference to a Firestore Document. A reference is provided in + * in the constructor. The class is generic which gives you type safety for data update + * methods and data streaming. + * + * This class uses Symbol.observable to transform into Observable using Observable.from(). + * + * This class is rarely used directly and should be created from the AngularFirestore service. + * + * Example: + * + * const fakeStock = new AngularFirestoreDocument(doc('stocks/FAKE')); + * await fakeStock.set({ name: 'FAKE', price: 0.01 }); + * fakeStock.valueChanges().map(snap => { + * if(snap.exists) return snap.data(); + * return null; + * }).subscribe(value => console.log(value)); + * // OR! Transform using Observable.from() and the data is unwrapped for you + * Observable.from(fakeStock).subscribe(value => console.log(value)); + */ +export class AngularFirestoreDocument { + private readonly injector = inject(EnvironmentInjector); + + /** + * The constructor takes in a DocumentReference to provide wrapper methods + * for data operations, data streaming, and Symbol.observable. + */ + constructor(public ref: DocumentReference, private afs: AngularFirestore) { } + + /** + * Create or overwrite a single document. + */ + set(data: T, options?: SetOptions): Promise { + return this.ref.set(data, options); + } + + /** + * Update some fields of a document without overwriting the entire document. + */ + update(data: Partial): Promise { + return this.ref.update(data); + } + + /** + * Delete a document. + */ + delete(): Promise { + return this.ref.delete(); + } + + /** + * Create a reference to a sub-collection given a path and an optional query + * function. + */ + collection(path: string, queryFn?: QueryFn): AngularFirestoreCollection { + const collectionRef = this.ref.collection(path) as firebase.firestore.CollectionReference; + const { ref, query } = associateQuery(collectionRef, queryFn); + return new AngularFirestoreCollection(ref, query, this.afs); + } + + /** + * Listen to snapshot updates from the document. + */ + snapshotChanges(): Observable>> { + const scheduledFromDocRef$ = fromDocRef(this.ref, this.afs.schedulers.outsideAngular); + return scheduledFromDocRef$.pipe( + pendingUntilEvent(this.injector) + ); + } + + /** + * Listen to unwrapped snapshot updates from the document. + * + * If the `idField` option is provided, document IDs are included and mapped to the + * provided `idField` property name. + */ + valueChanges(options?: unknown): Observable; + valueChanges(options: { idField: K }): Observable<(T & { [T in K]: string }) | undefined>; + valueChanges(options: { idField?: K } = {}): Observable { + return this.snapshotChanges().pipe( + map(({ payload }) => + options.idField ? { + ...payload.data(), + ...{ [options.idField]: payload.id } + } as T & { [T in K]: string } : payload.data() + ) + ); + } + + /** + * Retrieve the document once. + */ + get(options?: firebase.firestore.GetOptions) { + return from(this.ref.get(options)).pipe( + pendingUntilEvent(this.injector) + ); + } +} diff --git a/src/compat/firestore/firestore.module.ts b/src/compat/firestore/firestore.module.ts new file mode 100644 index 000000000..ec1f916ac --- /dev/null +++ b/src/compat/firestore/firestore.module.ts @@ -0,0 +1,26 @@ +import { ModuleWithProviders, NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFirestore, ENABLE_PERSISTENCE, PERSISTENCE_SETTINGS } from './firestore'; +import { PersistenceSettings } from './interfaces'; + +@NgModule({ + providers: [ AngularFirestore ] +}) +export class AngularFirestoreModule { + constructor() { + firebase.registerVersion('angularfire', VERSION.full, 'fst-compat'); + } + /** + * Attempt to enable persistent storage, if possible + */ + static enablePersistence(persistenceSettings?: PersistenceSettings): ModuleWithProviders { + return { + ngModule: AngularFirestoreModule, + providers: [ + { provide: ENABLE_PERSISTENCE, useValue: true }, + { provide: PERSISTENCE_SETTINGS, useValue: persistenceSettings }, + ] + }; + } +} diff --git a/src/compat/firestore/firestore.spec.ts b/src/compat/firestore/firestore.spec.ts new file mode 100644 index 000000000..70d91e17d --- /dev/null +++ b/src/compat/firestore/firestore.spec.ts @@ -0,0 +1,153 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule, FIREBASE_APP_NAME, FIREBASE_OPTIONS } from '@angular/fire/compat'; +import { AngularFirestore, AngularFirestoreCollection, AngularFirestoreDocument, AngularFirestoreModule, USE_EMULATOR } from '@angular/fire/compat/firestore'; +import { COMMON_CONFIG, firestoreEmulatorPort } from '../../../src/test-config'; +import 'firebase/compat/firestore'; +import { rando } from '../../../src/utils'; + +describe('AngularFirestore', () => { + let afs: AngularFirestore; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFirestoreModule.enablePersistence() + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', firestoreEmulatorPort] } + ] + }); + + afs = TestBed.inject(AngularFirestore); + }); + + it('should be the properly initialized type', () => { + expect(afs instanceof AngularFirestore).toBe(true); + }); + + it('should have an initialized Firebase app', () => { + expect(TestBed.runInInjectionContext(() => afs.firestore.app)).toBeDefined(); + }); + + it('should create an AngularFirestoreDocument from a string path', () => { + const doc = TestBed.runInInjectionContext(() => afs.doc('a/doc')); + expect(doc instanceof AngularFirestoreDocument).toBe(true); + }); + + it('should create an AngularFirestoreDocument from a string path', () => { + const doc = TestBed.runInInjectionContext(() => afs.doc(afs.doc('a/doc').ref)); + expect(doc instanceof AngularFirestoreDocument).toBe(true); + }); + + it('should create an AngularFirestoreCollection from a string path', () => { + const collection = TestBed.runInInjectionContext(() => afs.collection('stuffs')); + expect(collection instanceof AngularFirestoreCollection).toBe(true); + }); + + it('should create an AngularFirestoreCollection from a reference', () => { + const collection = TestBed.runInInjectionContext(() => afs.collection(afs.collection('stuffs').ref)); + expect(collection instanceof AngularFirestoreCollection).toBe(true); + }); + + it('should throw on an invalid document path', () => { + const singleWrapper = () => TestBed.runInInjectionContext(() => afs.doc('collection')); + const tripleWrapper = () => TestBed.runInInjectionContext(() => afs.doc('collection/doc/subcollection')); + expect(singleWrapper).toThrowError(); + expect(tripleWrapper).toThrowError(); + }); + + it('should throw on an invalid collection path', () => { + const singleWrapper = () => TestBed.runInInjectionContext(() => afs.collection('collection/doc')); + const quadWrapper = () => TestBed.runInInjectionContext(() => afs.collection('collection/doc/subcollection/doc')); + expect(singleWrapper).toThrowError(); + expect(quadWrapper).toThrowError(); + }); + + if (typeof window === 'undefined') { + + it('should not enable persistence (Node.js)', (done) => { + TestBed.runInInjectionContext(() => afs.persistenceEnabled$).subscribe(isEnabled => { + expect(isEnabled).toBe(false); + done(); + }); + }); + + } else { + + it('should enable persistence', (done) => { + TestBed.runInInjectionContext(() => afs.persistenceEnabled$).subscribe(isEnabled => { + expect(isEnabled).toBe(true); + done(); + }); + }); + + } + +}); + +describe('AngularFirestore with different app', () => { + let afs: AngularFirestore; + let firebaseAppName: string; + + beforeEach(() => { + firebaseAppName = rando(); + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFirestoreModule + ], + providers: [ + { provide: FIREBASE_APP_NAME, useValue: firebaseAppName }, + { provide: FIREBASE_OPTIONS, useValue: COMMON_CONFIG }, + { provide: USE_EMULATOR, useValue: ['localhost', firestoreEmulatorPort] } + ] + }); + + + afs = TestBed.inject(AngularFirestore); + }); + + describe('', () => { + + it('should be an AngularFirestore type', () => { + expect(afs instanceof AngularFirestore).toEqual(true); + }); + + it('should have an initialized Firebase app', () => { + expect(TestBed.runInInjectionContext(() => afs.firestore.app)).toBeDefined(); + }); + + it('should have an initialized Firebase app instance member', () => { + expect(TestBed.runInInjectionContext(() => afs.firestore.app.name)).toEqual(firebaseAppName); + }); + }); + +}); + + +describe('AngularFirestore without persistance', () => { + let afs: AngularFirestore; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFirestoreModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', firestoreEmulatorPort] } + ] + }); + + afs = TestBed.inject(AngularFirestore); + }); + + it('should not enable persistence', (done) => { + TestBed.runInInjectionContext(() => afs.persistenceEnabled$).subscribe(isEnabled => { + expect(isEnabled).toBe(false); + done(); + }); + }); + +}); diff --git a/src/compat/firestore/firestore.ts b/src/compat/firestore/firestore.ts new file mode 100644 index 000000000..be3388445 --- /dev/null +++ b/src/compat/firestore/firestore.ts @@ -0,0 +1,241 @@ +import { isPlatformServer } from '@angular/common'; +import { Inject, Injectable, InjectionToken, NgZone, Optional, PLATFORM_ID, inject } from '@angular/core'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { FIREBASE_APP_NAME, FIREBASE_OPTIONS, ÉĩcacheInstance, ÉĩfirebaseAppFactory } from '@angular/fire/compat'; +import { + SETTINGS as AUTH_SETTINGS, + AngularFireAuth, + LANGUAGE_CODE, + PERSISTENCE, + TENANT_ID, + USE_EMULATOR as USE_AUTH_EMULATOR, + USE_DEVICE_LANGUAGE, + ÉĩauthFactory, +} from '@angular/fire/compat/auth'; +import { FirebaseOptions } from 'firebase/app'; +import firebase from 'firebase/compat/app'; +import { Observable, from, of } from 'rxjs'; +import { AngularFirestoreCollection } from './collection/collection'; +import { AngularFirestoreCollectionGroup } from './collection-group/collection-group'; +import { AngularFirestoreDocument } from './document/document'; +import { + AssociatedReference, + CollectionReference, + DocumentReference, + PersistenceSettings, + Query, + QueryFn, + QueryGroupFn, + Settings +} from './interfaces'; +import 'firebase/compat/auth'; +import 'firebase/compat/firestore'; + +/** + * The value of this token determines whether or not the firestore will have persistance enabled + */ +export const ENABLE_PERSISTENCE = new InjectionToken('angularfire2.enableFirestorePersistence'); +export const PERSISTENCE_SETTINGS = new InjectionToken('angularfire2.firestore.persistenceSettings'); +export const SETTINGS = new InjectionToken('angularfire2.firestore.settings'); + +type UseEmulatorArguments = Parameters; +export const USE_EMULATOR = new InjectionToken('angularfire2.firestore.use-emulator'); + +/** + * A utility methods for associating a collection reference with + * a query. + * + * @param collectionRef - A collection reference to query + * @param queryFn - The callback to create a query + * + * Example: + * const { query, ref } = associateQuery(docRef.collection('items'), ref => { + * return ref.where('age', '<', 200); + * }); + */ +export function associateQuery(collectionRef: CollectionReference, queryFn = ref => ref): AssociatedReference { + const query = queryFn(collectionRef); + const ref = collectionRef; + return { query, ref }; +} + +/** + * AngularFirestore Service + * + * This service is the main entry point for this feature module. It provides + * an API for creating Collection and Reference services. These services can + * then be used to do data updates and observable streams of the data. + * + * Example: + * + * import { Component } from '@angular/core'; + * import { AngularFirestore, AngularFirestoreCollection, AngularFirestoreDocument } from '@angular/fire/firestore'; + * import { Observable } from 'rxjs/Observable'; + * import { from } from 'rxjs/observable'; + * + * @Component({ + * selector: 'app-my-component', + * template: ` + *

Items for {{ (profile | async)?.name }} + *
    + *
  • {{ item.name }}
    • + *
+ *
+ * + * + *
+ * ` + * }) + * export class MyComponent implements OnInit { + * + * // services for data operations and data streaming + * private readonly itemsRef: AngularFirestoreCollection; + * private readonly profileRef: AngularFirestoreDocument; + * + * // observables for template + * items: Observable; + * profile: Observable; + * + * // inject main service + * constructor(private readonly afs: AngularFirestore) {} + * + * ngOnInit() { + * this.itemsRef = afs.collection('items', ref => ref.where('user', '==', 'davideast').limit(10)); + * this.items = this.itemsRef.valueChanges().map(snap => snap.docs.map(data => doc.data())); + * // this.items = from(this.itemsRef); // you can also do this with no mapping + * + * this.profileRef = afs.doc('users/davideast'); + * this.profile = this.profileRef.valueChanges(); + * } + * + * addItem(name: string) { + * const user = 'davideast'; + * this.itemsRef.add({ name, user }); + * } + * } + */ +@Injectable({ + providedIn: 'any' +}) +export class AngularFirestore { + public readonly firestore: firebase.firestore.Firestore; + public readonly persistenceEnabled$: Observable; + private readonly ngZone = inject(NgZone); + + /** + * Each Feature of AngularFire has a FirebaseApp injected. This way we + * don't rely on the main Firebase App instance and we can create named + * apps and use multiple apps. + */ + constructor( + @Inject(FIREBASE_OPTIONS) options: FirebaseOptions, + @Optional() @Inject(FIREBASE_APP_NAME) name: string | null | undefined, + @Optional() @Inject(ENABLE_PERSISTENCE) shouldEnablePersistence: boolean | null, + @Optional() @Inject(SETTINGS) settings: Settings | null, + // eslint-disable-next-line @typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object, + zone: NgZone, + public schedulers: ÉĩAngularFireSchedulers, + @Optional() @Inject(PERSISTENCE_SETTINGS) persistenceSettings: PersistenceSettings | null, + @Optional() @Inject(USE_EMULATOR) _useEmulator: any, + @Optional() auth: AngularFireAuth, + @Optional() @Inject(USE_AUTH_EMULATOR) useAuthEmulator: any, + @Optional() @Inject(AUTH_SETTINGS) authSettings: any, // can't use firebase.auth.AuthSettings here + @Optional() @Inject(TENANT_ID) tenantId: string | null, + @Optional() @Inject(LANGUAGE_CODE) languageCode: string | null, + @Optional() @Inject(USE_DEVICE_LANGUAGE) useDeviceLanguage: boolean | null, + @Optional() @Inject(PERSISTENCE) persistence: string | null, + @Optional() _appCheckInstances: AppCheckInstances, + ) { + const app = ÉĩfirebaseAppFactory(options, zone, name); + const useEmulator: UseEmulatorArguments | null = _useEmulator; + + if (auth) { + ÉĩauthFactory(app, zone, useAuthEmulator, tenantId, languageCode, useDeviceLanguage, authSettings, persistence); + } + + [this.firestore, this.persistenceEnabled$] = ÉĩcacheInstance(`${app.name}.firestore`, 'AngularFirestore', app.name, () => { + const firestore = zone.runOutsideAngular(() => app.firestore()); + if (settings) { + firestore.settings(settings); + } + if (useEmulator) { + firestore.useEmulator(...useEmulator); + } + + if (shouldEnablePersistence && !isPlatformServer(platformId)) { + // We need to try/catch here because not all enablePersistence() failures are caught + // https://github.com/firebase/firebase-js-sdk/issues/608 + const enablePersistence = () => { + try { + return from(firestore.enablePersistence(persistenceSettings || undefined).then(() => true, () => false)); + } catch (e) { + if (typeof console !== 'undefined') { console.warn(e); } + return of(false); + } + }; + return [firestore, zone.runOutsideAngular(enablePersistence)]; + } else { + return [firestore, of(false)]; + } + + }, [settings, useEmulator, shouldEnablePersistence]); + } + + /** + * Create a reference to a Firestore Collection based on a path or + * CollectionReference and an optional query function to narrow the result + * set. + */ + collection(path: string, queryFn?: QueryFn): AngularFirestoreCollection; + collection(ref: CollectionReference, queryFn?: QueryFn): AngularFirestoreCollection; + collection(pathOrRef: string | CollectionReference, queryFn?: QueryFn): AngularFirestoreCollection { + let collectionRef: CollectionReference; + if (typeof pathOrRef === 'string') { + collectionRef = this.firestore.collection(pathOrRef) as firebase.firestore.CollectionReference; + } else { + collectionRef = pathOrRef; + } + const { ref, query } = associateQuery(collectionRef, queryFn); + const refInZone = this.ngZone.run(() => ref); + return new AngularFirestoreCollection(refInZone, query, this); + } + + /** + * Create a reference to a Firestore Collection Group based on a collectionId + * and an optional query function to narrow the result + * set. + */ + collectionGroup(collectionId: string, queryGroupFn?: QueryGroupFn): AngularFirestoreCollectionGroup { + const queryFn = queryGroupFn || (ref => ref); + const collectionGroup: Query = this.firestore.collectionGroup(collectionId) as firebase.firestore.Query; + return new AngularFirestoreCollectionGroup(queryFn(collectionGroup), this); + } + + /** + * Create a reference to a Firestore Document based on a path or + * DocumentReference. Note that documents are not queryable because they are + * simply objects. However, documents have sub-collections that return a + * Collection reference and can be queried. + */ + doc(path: string): AngularFirestoreDocument; + doc(ref: DocumentReference): AngularFirestoreDocument; + doc(pathOrRef: string | DocumentReference): AngularFirestoreDocument { + let ref: DocumentReference; + if (typeof pathOrRef === 'string') { + ref = this.firestore.doc(pathOrRef) as firebase.firestore.DocumentReference; + } else { + ref = pathOrRef; + } + const refInZone = this.ngZone.run(() => ref); + return new AngularFirestoreDocument(refInZone, this); + } + + /** + * Returns a generated Firestore Document Id. + */ + createId() { + return this.firestore.collection('_').doc().id; + } +} diff --git a/src/compat/firestore/interfaces.ts b/src/compat/firestore/interfaces.ts new file mode 100644 index 000000000..a557a4531 --- /dev/null +++ b/src/compat/firestore/interfaces.ts @@ -0,0 +1,86 @@ +import firebase from 'firebase/compat/app'; +import { Subscriber } from 'rxjs'; + +export type Settings = firebase.firestore.Settings; +export type CollectionReference = firebase.firestore.CollectionReference; +export type DocumentReference = firebase.firestore.DocumentReference; +export type PersistenceSettings = firebase.firestore.PersistenceSettings; +export type DocumentChangeType = firebase.firestore.DocumentChangeType; +export type SnapshotOptions = firebase.firestore.SnapshotOptions; +export type FieldPath = firebase.firestore.FieldPath; +export type Query = firebase.firestore.Query; + +export type SetOptions = firebase.firestore.SetOptions; +export type DocumentData = firebase.firestore.DocumentData; + +export interface DocumentSnapshotExists extends firebase.firestore.DocumentSnapshot { + readonly exists: true; + data(options?: SnapshotOptions): T; +} + +export interface DocumentSnapshotDoesNotExist extends firebase.firestore.DocumentSnapshot { + readonly exists: false; + data(options?: SnapshotOptions): undefined; + get(fieldPath: string | FieldPath, options?: SnapshotOptions): undefined; +} + +export type DocumentSnapshot = DocumentSnapshotExists | DocumentSnapshotDoesNotExist; + +export interface QueryDocumentSnapshot extends firebase.firestore.QueryDocumentSnapshot { + data(options?: SnapshotOptions): T; +} + +export interface QuerySnapshot extends firebase.firestore.QuerySnapshot { + readonly docs: QueryDocumentSnapshot[]; +} + +export interface DocumentChange extends firebase.firestore.DocumentChange { + readonly doc: QueryDocumentSnapshot; +} + +export interface DocumentChangeAction { + type: DocumentChangeType; + payload: DocumentChange; +} + +export interface Action { + type: string; + payload: T; +} + +export interface Reference { + onSnapshot: (options: firebase.firestore.SnapshotListenOptions, sub: Subscriber) => any; +} + +// A convience type for making a query. +// Example: const query = (ref) => ref.where('name', == 'david'); +export type QueryFn = (ref: CollectionReference) => Query; + +export type QueryGroupFn = (query: Query) => Query; + +/** + * A structure that provides an association between a reference + * and a query on that reference. Note: Performing operations + * on the reference can lead to confusing results with complicated + * queries. + * + * Example: + * + * const query = ref.where('type', '==', 'Book'). + * .where('price', '>' 18.00) + * .where('price', '<' 100.00) + * .where('category', '==', 'Fiction') + * .where('publisher', '==', 'BigPublisher') + * + * // This addition would not be a result of the query above + * ref.add({ + * type: 'Magazine', + * price: 4.99, + * category: 'Sports', + * publisher: 'SportsPublisher' + * }); + */ +export interface AssociatedReference { + ref: CollectionReference; + query: Query; +} diff --git a/src/compat/firestore/ng-package.json b/src/compat/firestore/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/firestore/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/firestore/observable/fromRef.ts b/src/compat/firestore/observable/fromRef.ts new file mode 100644 index 000000000..8d7ce4393 --- /dev/null +++ b/src/compat/firestore/observable/fromRef.ts @@ -0,0 +1,48 @@ +import { Observable, SchedulerLike, asyncScheduler } from 'rxjs'; +import { map, pairwise, startWith } from 'rxjs/operators'; +import { Action, DocumentReference, DocumentSnapshot, Query, QuerySnapshot, Reference } from '../interfaces'; + +function _fromRef(ref: Reference, scheduler: SchedulerLike = asyncScheduler): Observable { + return new Observable(subscriber => { + let unsubscribe: () => void; + if (scheduler != null) { + scheduler.schedule(() => { + unsubscribe = ref.onSnapshot({ includeMetadataChanges: true }, subscriber); + }); + } else { + unsubscribe = ref.onSnapshot({ includeMetadataChanges: true }, subscriber); + } + + return () => { + if (unsubscribe != null) { + unsubscribe(); + } + }; + }); +} + +export function fromRef(ref: DocumentReference | Query, scheduler?: SchedulerLike) { + return _fromRef(ref, scheduler); +} + +export function fromDocRef(ref: DocumentReference, scheduler?: SchedulerLike): Observable>> { + return fromRef, T>(ref, scheduler) + .pipe( + startWith, undefined>(undefined), + pairwise(), + map((snapshots: [DocumentSnapshot, DocumentSnapshot]) => { + const [priorPayload, payload] = snapshots; + if (!payload.exists) { + return { payload, type: 'removed' }; + } + if (!priorPayload?.exists) { + return { payload, type: 'added' }; + } + return { payload, type: 'modified' }; + }) + ); +} + +export function fromCollectionRef(ref: Query, scheduler?: SchedulerLike): Observable>> { + return fromRef, T>(ref, scheduler).pipe(map(payload => ({ payload, type: 'query' }))); +} diff --git a/src/compat/firestore/package.json b/src/compat/firestore/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/compat/firestore/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/firestore/public_api.ts b/src/compat/firestore/public_api.ts new file mode 100644 index 000000000..1670f1451 --- /dev/null +++ b/src/compat/firestore/public_api.ts @@ -0,0 +1,8 @@ +export * from './firestore'; +export * from './firestore.module'; +export * from './collection/collection'; +export * from './collection-group/collection-group'; +export * from './document/document'; +export * from './collection/changes'; +export * from './observable/fromRef'; +export * from './interfaces'; diff --git a/src/compat/firestore/utils.spec.ts b/src/compat/firestore/utils.spec.ts new file mode 100644 index 000000000..88842d8a2 --- /dev/null +++ b/src/compat/firestore/utils.spec.ts @@ -0,0 +1,55 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFirestoreCollection } from '@angular/fire/compat/firestore'; +import firebase from 'firebase/compat/app'; + +export interface Stock { + name: string; + price: number; +} + +export const FAKE_STOCK_DATA = { name: 'FAKE', price: 1 }; + +export const randomName = (firestore): string => firestore.collection('a').doc().id; + +export const createRandomStocks = async ( + firestore: firebase.firestore.Firestore, + collectionRef: firebase.firestore.CollectionReference, + numberOfItems +) => { + // Create a batch to update everything at once + const batch = TestBed.runInInjectionContext(() => firestore.batch()); + // Store the random names to delete them later + let names: string[] = []; + Array.from(Array(numberOfItems)).forEach(() => { + const name = randomName(firestore); + TestBed.runInInjectionContext(() => batch.set(collectionRef.doc(name), FAKE_STOCK_DATA)); + names = [...names, name]; + }); + // Create the batch entries + // Commit! + await TestBed.runInInjectionContext(() => batch.commit()); + return names; +}; + +export function deleteThemAll(names, ref) { + const promises = names.map(name => ref.doc(name).delete()); + return Promise.all(promises); +} + +export function delayUpdate(collection: AngularFirestoreCollection|firebase.firestore.CollectionReference, path, data, delay = 250) { + setTimeout(() => { + TestBed.runInInjectionContext(() => collection.doc(path).update(data)); + }, delay); +} + +export function delayAdd(collection: AngularFirestoreCollection|firebase.firestore.CollectionReference, path, data, delay = 250) { + setTimeout(() => { + TestBed.runInInjectionContext(() => collection.doc(path).set(data)); + }, delay); +} + +export function delayDelete(collection: AngularFirestoreCollection|firebase.firestore.CollectionReference, path, delay = 250) { + setTimeout(() => { + TestBed.runInInjectionContext(() => collection.doc(path).delete()); + }, delay); +} diff --git a/src/compat/functions/base.ts b/src/compat/functions/base.ts new file mode 100644 index 000000000..ce221ce8e --- /dev/null +++ b/src/compat/functions/base.ts @@ -0,0 +1,7 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +// Export a null object with the same keys as firebase/compat/functions, so Proxy can work with proxy-polyfill in Internet Explorer +export const proxyPolyfillCompat = { + useEmulator: null, + useFunctionsEmulator: null, + httpsCallable: null, +}; diff --git a/src/compat/functions/functions.module.ts b/src/compat/functions/functions.module.ts new file mode 100644 index 000000000..f6cc15327 --- /dev/null +++ b/src/compat/functions/functions.module.ts @@ -0,0 +1,13 @@ +import { NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFireFunctions } from './functions'; + +@NgModule({ + providers: [ AngularFireFunctions ] +}) +export class AngularFireFunctionsModule { + constructor() { + firebase.registerVersion('angularfire', VERSION.full, 'fn-compat'); + } +} diff --git a/src/compat/functions/functions.spec.ts b/src/compat/functions/functions.spec.ts new file mode 100644 index 000000000..6b2bc892c --- /dev/null +++ b/src/compat/functions/functions.spec.ts @@ -0,0 +1,70 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule, FIREBASE_APP_NAME, FIREBASE_OPTIONS } from '@angular/fire/compat'; +import { AngularFireFunctions, AngularFireFunctionsModule, REGION, USE_EMULATOR } from '@angular/fire/compat/functions'; +import { COMMON_CONFIG } from '../../../src/test-config'; +import 'firebase/compat/functions'; +import { rando } from '../../../src/utils'; + +describe('AngularFireFunctions', () => { + let afFns: AngularFireFunctions; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireFunctionsModule + ], + providers: [ + { provide: USE_EMULATOR, useValue: ['localhost', 9999] }, + { provide: REGION, useValue: 'us-central1' }, + ] + }); + + afFns = TestBed.inject(AngularFireFunctions); + }); + + it('should exist', () => { + expect(afFns instanceof AngularFireFunctions).toBe(true); + }); + + it('should have the Firebase Functions instance', () => { + expect(afFns.useFunctionsEmulator).toBeDefined(); + }); + +}); + +describe('AngularFireFunctions with different app', () => { + let afFns: AngularFireFunctions; + let firebaseAppName: string; + + beforeEach(() => { + firebaseAppName = rando(); + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireFunctionsModule + ], + providers: [ + { provide: FIREBASE_APP_NAME, useValue: firebaseAppName }, + { provide: FIREBASE_OPTIONS, useValue: COMMON_CONFIG }, + { provide: USE_EMULATOR, useValue: ['localhost', 9999] }, + { provide: REGION, useValue: 'us-central1' }, + ] + }); + + afFns = TestBed.inject(AngularFireFunctions); + }); + + describe('', () => { + + it('should be an AngularFireAuth type', () => { + expect(afFns instanceof AngularFireFunctions).toEqual(true); + }); + + it('should have the Firebase Functions instance', () => { + expect(afFns.useFunctionsEmulator).toBeDefined(); + }); + + }); + +}); diff --git a/src/compat/functions/functions.ts b/src/compat/functions/functions.ts new file mode 100644 index 000000000..2b6500188 --- /dev/null +++ b/src/compat/functions/functions.ts @@ -0,0 +1,74 @@ +import { Inject, Injectable, InjectionToken, NgZone, Optional } from '@angular/core'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { ÉĩPromiseProxy, ÉĩapplyMixins, ÉĩlazySDKProxy } from '@angular/fire/compat'; +import { FIREBASE_APP_NAME, FIREBASE_OPTIONS, ÉĩcacheInstance, ÉĩfirebaseAppFactory } from '@angular/fire/compat'; +import { HttpsCallableOptions } from '@firebase/functions-types'; +import { FirebaseOptions } from 'firebase/app'; +import firebase from 'firebase/compat/app'; +import { Observable, from, of } from 'rxjs'; +import { map, observeOn, shareReplay, switchMap } from 'rxjs/operators'; +import { proxyPolyfillCompat } from './base'; + +export const ORIGIN = new InjectionToken('angularfire2.functions.origin'); +export const REGION = new InjectionToken('angularfire2.functions.region'); + +type UseEmulatorArguments = Parameters; +export const USE_EMULATOR = new InjectionToken('angularfire2.functions.use-emulator'); + +// override httpsCallable for compatibility with 5.x +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AngularFireFunctions extends Omit<ÉĩPromiseProxy, 'httpsCallable'> { +} + +@Injectable({ + providedIn: 'any' +}) +export class AngularFireFunctions { + + public readonly httpsCallable: (name: string, options?: HttpsCallableOptions) => (data: T) => Observable; + + constructor( + @Inject(FIREBASE_OPTIONS) options: FirebaseOptions, + @Optional() @Inject(FIREBASE_APP_NAME) name: string | null | undefined, + zone: NgZone, + schedulers: ÉĩAngularFireSchedulers, + @Optional() @Inject(REGION) region: string | null, + @Optional() @Inject(ORIGIN) origin: string | null, + @Optional() @Inject(USE_EMULATOR) _useEmulator: any, // can't use the tuple here + @Optional() _appCheckInstances: AppCheckInstances, + ) { + const useEmulator: UseEmulatorArguments | null = _useEmulator; + + const functions = of(undefined).pipe( + observeOn(schedulers.outsideAngular), + switchMap(() => import('firebase/compat/functions')), + map(() => ÉĩfirebaseAppFactory(options, zone, name)), + map(app => ÉĩcacheInstance(`${app.name}.functions.${region || origin}`, 'AngularFireFunctions', app.name, () => { + let functions: firebase.functions.Functions; + if (region && origin) { + throw new Error('REGION and ORIGIN can\'t be used at the same time.'); + } + functions = app.functions(region || origin || undefined); + if (useEmulator) { + functions.useEmulator(...useEmulator); + } + return functions; + }, [region, origin, useEmulator])), + shareReplay({ bufferSize: 1, refCount: false }) + ); + + this.httpsCallable = (name: string, options?: HttpsCallableOptions) => + (data: T) => from(functions).pipe( + observeOn(schedulers.insideAngular), + switchMap(functions => functions.httpsCallable(name, options)(data)), + map(r => r.data as R) + ); + + return ÉĩlazySDKProxy(this, functions, zone); + + } + +} + +ÉĩapplyMixins(AngularFireFunctions, [proxyPolyfillCompat]); diff --git a/src/compat/functions/ng-package.json b/src/compat/functions/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/functions/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/functions/package.json b/src/compat/functions/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/compat/functions/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/functions/public_api.ts b/src/compat/functions/public_api.ts new file mode 100644 index 000000000..2ce2fab44 --- /dev/null +++ b/src/compat/functions/public_api.ts @@ -0,0 +1,5 @@ + +import 'firebase/compat/functions'; // removed in build process when not UMD + +export * from './functions'; +export * from './functions.module'; diff --git a/src/compat/messaging/base.ts b/src/compat/messaging/base.ts new file mode 100644 index 000000000..fc1c529f6 --- /dev/null +++ b/src/compat/messaging/base.ts @@ -0,0 +1,8 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +// Export a null object with the same keys as firebase/compat/messaging, so Proxy can work with proxy-polyfill in Internet Explorer +export const proxyPolyfillCompat = { + deleteToken: null, + getToken: null, + onMessage: null, + onBackgroundMessage: null, +}; diff --git a/src/compat/messaging/messaging.module.ts b/src/compat/messaging/messaging.module.ts new file mode 100644 index 000000000..6912c4992 --- /dev/null +++ b/src/compat/messaging/messaging.module.ts @@ -0,0 +1,13 @@ +import { NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFireMessaging } from './messaging'; + +@NgModule({ + providers: [ AngularFireMessaging ] +}) +export class AngularFireMessagingModule { + constructor() { + firebase.registerVersion('angularfire', VERSION.full, 'fcm-compat'); + } +} diff --git a/src/compat/messaging/messaging.spec.ts b/src/compat/messaging/messaging.spec.ts new file mode 100644 index 000000000..ddd616d98 --- /dev/null +++ b/src/compat/messaging/messaging.spec.ts @@ -0,0 +1,63 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule, FIREBASE_APP_NAME, FIREBASE_OPTIONS } from '@angular/fire/compat'; +import { AngularFireMessaging, AngularFireMessagingModule } from '@angular/fire/compat/messaging'; +import { COMMON_CONFIG } from '../../../src/test-config'; +import { rando } from '../../../src/utils'; + +describe('AngularFireMessaging', () => { + let afm: AngularFireMessaging; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireMessagingModule + ] + }); + + afm = TestBed.inject(AngularFireMessaging); + }); + + it('should be exist', () => { + expect(afm instanceof AngularFireMessaging).toBe(true); + }); + + it('should have the FCM instance', () => { + expect(afm.deleteToken).toBeDefined(); + }); + +}); + +const FIREBASE_APP_NAME_TOO = (Math.random() + 1).toString(36).substring(7); + +describe('AngularFireMessaging with different app', () => { + let afm: AngularFireMessaging; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireMessagingModule + ], + providers: [ + { provide: FIREBASE_APP_NAME, useValue: FIREBASE_APP_NAME_TOO }, + { provide: FIREBASE_OPTIONS, useValue: COMMON_CONFIG } + ] + }); + + afm = TestBed.inject(AngularFireMessaging); + }); + + describe('', () => { + + it('should be an AngularFireMessaging type', () => { + expect(afm instanceof AngularFireMessaging).toEqual(true); + }); + + it('should have the FCM instance', () => { + expect(afm.deleteToken).toBeDefined(); + }); + + }); + +}); diff --git a/src/compat/messaging/messaging.ts b/src/compat/messaging/messaging.ts new file mode 100644 index 000000000..276191989 --- /dev/null +++ b/src/compat/messaging/messaging.ts @@ -0,0 +1,125 @@ +import { Inject, Injectable, InjectionToken, NgZone, Optional, PLATFORM_ID } from '@angular/core'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { ÉĩPromiseProxy, ÉĩapplyMixins, ÉĩlazySDKProxy } from '@angular/fire/compat'; +import { FIREBASE_APP_NAME, FIREBASE_OPTIONS, ÉĩcacheInstance, ÉĩfirebaseAppFactory } from '@angular/fire/compat'; +import { FirebaseOptions } from 'firebase/app'; +import firebase from 'firebase/compat/app'; +import { isSupported } from 'firebase/messaging'; +import { EMPTY, Observable, concat, of } from 'rxjs'; +import { catchError, defaultIfEmpty, map, mergeMap, observeOn, shareReplay, subscribeOn, switchMap, switchMapTo } from 'rxjs/operators'; +import { proxyPolyfillCompat } from './base'; + +export const VAPID_KEY = new InjectionToken('angularfire2.messaging.vapid-key'); +export const SERVICE_WORKER = new InjectionToken>('angularfire2.messaging.service-worker-registeration'); + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AngularFireMessaging extends Omit<ÉĩPromiseProxy, 'deleteToken' | 'getToken' | 'requestPermission'> { +} + +@Injectable({ + providedIn: 'any' +}) +export class AngularFireMessaging { + + public readonly requestPermission: Observable; + public readonly getToken: Observable; + public readonly tokenChanges: Observable; + public readonly messages: Observable; + public readonly requestToken: Observable; + public readonly deleteToken: (token: string) => Observable; + + constructor( + @Inject(FIREBASE_OPTIONS) options: FirebaseOptions, + @Optional() @Inject(FIREBASE_APP_NAME) name: string | null | undefined, + // eslint-disable-next-line @typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object, + zone: NgZone, + schedulers: ÉĩAngularFireSchedulers, + @Optional() @Inject(VAPID_KEY) vapidKey: string|null, + @Optional() @Inject(SERVICE_WORKER) _serviceWorker: any, + ) { + const serviceWorker: Promise | null = _serviceWorker; + + const messaging = of(undefined).pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + switchMap(isSupported), + switchMap(supported => supported ? import('firebase/compat/messaging') : EMPTY), + map(() => ÉĩfirebaseAppFactory(options, zone, name)), + switchMap(app => ÉĩcacheInstance(`${app.name}.messaging`, 'AngularFireMessaging', app.name, () => { + return of(app.messaging()); + }, [])), + shareReplay({ bufferSize: 1, refCount: false }) + ); + + + this.requestPermission = messaging.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + switchMap(() => Notification.requestPermission()) + ); + + this.getToken = messaging.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + switchMap(async messaging => { + if (Notification.permission === 'granted') { + // eslint-disable-next-line @typescript-eslint/no-misused-promises + const serviceWorkerRegistration = serviceWorker ? await serviceWorker : null; + return await messaging.getToken({ vapidKey, serviceWorkerRegistration }); + } else { + return null; + } + }) + ); + + const notificationPermission$ = new Observable(emitter => { + navigator.permissions.query({ name: 'notifications' }).then(notificationPerm => { + notificationPerm.onchange = () => emitter.next(); + }); + }); + + + const tokenChange$ = messaging.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + switchMapTo(notificationPermission$), + switchMapTo(this.getToken) + ); + + this.tokenChanges = messaging.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + switchMap(() => concat(this.getToken, tokenChange$)) + ); + + + this.messages = messaging.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + switchMap(messaging => new Observable(emitter => + messaging.onMessage(emitter) + )), + ); + + this.requestToken = messaging.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + switchMap(() => this.requestPermission), + catchError(() => of(null)), + mergeMap(() => this.tokenChanges) + ); + + this.deleteToken = () => messaging.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + switchMap(messaging => messaging.deleteToken()), + defaultIfEmpty(false) + ); + + return ÉĩlazySDKProxy(this, messaging, zone); + } + +} + +ÉĩapplyMixins(AngularFireMessaging, [proxyPolyfillCompat]); diff --git a/src/compat/messaging/ng-package.json b/src/compat/messaging/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/messaging/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/messaging/package.json b/src/compat/messaging/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/compat/messaging/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/messaging/public_api.ts b/src/compat/messaging/public_api.ts new file mode 100644 index 000000000..90df6c649 --- /dev/null +++ b/src/compat/messaging/public_api.ts @@ -0,0 +1,2 @@ +export * from './messaging'; +export * from './messaging.module'; diff --git a/src/compat/ng-package.json b/src/compat/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/compat/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/package.json b/src/compat/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/compat/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/performance/base.ts b/src/compat/performance/base.ts new file mode 100644 index 000000000..29e4cf620 --- /dev/null +++ b/src/compat/performance/base.ts @@ -0,0 +1,8 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +// Export a null object with the same keys as firebase/compat/performance, so Proxy can work with proxy-polyfill in Internet Explorer +export const proxyPolyfillCompat = { + app: null, + trace: null, + instrumentationEnabled: null, + dataCollectionEnabled: null, +}; diff --git a/src/compat/performance/ng-package.json b/src/compat/performance/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/performance/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/performance/package.json b/src/compat/performance/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/compat/performance/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/performance/performance.module.ts b/src/compat/performance/performance.module.ts new file mode 100644 index 000000000..5caf2eb97 --- /dev/null +++ b/src/compat/performance/performance.module.ts @@ -0,0 +1,19 @@ +import { NgModule, Optional } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFirePerformance } from './performance'; +import { PerformanceMonitoringService } from './performance.service'; + +@NgModule({ + providers: [ AngularFirePerformance ] +}) +export class AngularFirePerformanceModule { + constructor( + perf: AngularFirePerformance, + @Optional() _: PerformanceMonitoringService + ) { + firebase.registerVersion('angularfire', VERSION.full, 'perf-compat'); + // call anything here to get perf loading + perf.dataCollectionEnabled.then(() => undefined); + } +} diff --git a/src/compat/performance/performance.service.ts b/src/compat/performance/performance.service.ts new file mode 100644 index 000000000..a4d011271 --- /dev/null +++ b/src/compat/performance/performance.service.ts @@ -0,0 +1,30 @@ +import { ApplicationRef, Injectable, OnDestroy } from '@angular/core'; +import { Subscription } from 'rxjs'; +import { first, tap } from 'rxjs/operators'; + +const IS_STABLE_START_MARK = 'Zone'; +const IS_STABLE_END_MARK = '_isStableEnd'; + +@Injectable() +export class PerformanceMonitoringService implements OnDestroy { + + private disposable: Subscription|undefined; + + constructor(appRef: ApplicationRef) { + // eslint-disable-next-line @typescript-eslint/prefer-optional-chain + if (typeof window !== 'undefined' && window.performance?.mark) { + this.disposable = appRef.isStable.pipe( + first(it => it), + tap(() => { + window.performance.mark(IS_STABLE_END_MARK); + window.performance.measure('isStable', IS_STABLE_START_MARK, IS_STABLE_END_MARK); + }) + ).subscribe(); + } + } + + ngOnDestroy() { + if (this.disposable) { this.disposable.unsubscribe(); } + } + +} diff --git a/src/compat/performance/performance.spec.ts b/src/compat/performance/performance.spec.ts new file mode 100644 index 000000000..dcd36d340 --- /dev/null +++ b/src/compat/performance/performance.spec.ts @@ -0,0 +1,29 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule } from '@angular/fire/compat'; +import { AngularFirePerformance, AngularFirePerformanceModule } from '@angular/fire/compat/performance'; +import { COMMON_CONFIG } from '../../../src/test-config'; + +describe('AngularFirePerformance', () => { + let afp: AngularFirePerformance; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + // NOTE: You must use the [DEFAULT] app instance + // for these tests to work. + AngularFireModule.initializeApp(COMMON_CONFIG), + AngularFirePerformanceModule + ] + }); + afp = TestBed.inject(AngularFirePerformance); + }); + + it('should exist', () => { + expect(afp instanceof AngularFirePerformance).toBe(true); + }); + + it('should have the Performance instance', () => { + expect(afp.dataCollectionEnabled).toBeDefined(); + }); + +}); diff --git a/src/compat/performance/performance.ts b/src/compat/performance/performance.ts new file mode 100644 index 000000000..56b5fd12a --- /dev/null +++ b/src/compat/performance/performance.ts @@ -0,0 +1,147 @@ +import { isPlatformBrowser } from '@angular/common'; +import { Inject, Injectable, InjectionToken, NgZone, Optional, PLATFORM_ID } from '@angular/core'; +import { ÉĩPromiseProxy, ÉĩapplyMixins, ÉĩcacheInstance, ÉĩlazySDKProxy } from '@angular/fire/compat'; +import { FirebaseApp } from '@angular/fire/compat'; +import firebase from 'firebase/compat/app'; +import { EMPTY, Observable, Subscription, of } from 'rxjs'; +import { map, shareReplay, switchMap, tap } from 'rxjs/operators'; +import { proxyPolyfillCompat } from './base'; + +export const INSTRUMENTATION_ENABLED = new InjectionToken('angularfire2.performance.instrumentationEnabled'); +export const DATA_COLLECTION_ENABLED = new InjectionToken('angularfire2.performance.dataCollectionEnabled'); + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AngularFirePerformance extends ÉĩPromiseProxy { +} + +@Injectable({ + providedIn: 'any' +}) +export class AngularFirePerformance { + + private readonly performance: Observable; + + constructor( + app: FirebaseApp, + @Optional() @Inject(INSTRUMENTATION_ENABLED) instrumentationEnabled: boolean | null, + @Optional() @Inject(DATA_COLLECTION_ENABLED) dataCollectionEnabled: boolean | null, + private zone: NgZone, + // eslint-disable-next-line @typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object + ) { + + this.performance = of(undefined).pipe( + switchMap(() => isPlatformBrowser(platformId) ? zone.runOutsideAngular(() => import('firebase/compat/performance')) : EMPTY), + map(() => ÉĩcacheInstance(`performance`, 'AngularFirePerformance', app.name, () => { + const performance = zone.runOutsideAngular(() => app.performance()); + if (instrumentationEnabled === false) { + performance.instrumentationEnabled = false; + } + if (dataCollectionEnabled === false) { + performance.dataCollectionEnabled = false; + } + return performance; + }, [instrumentationEnabled, dataCollectionEnabled])), + shareReplay({ bufferSize: 1, refCount: false }) + ); + + return ÉĩlazySDKProxy(this, this.performance, zone); + + } + +} + +const trace$ = (traceId: string) => { + // eslint-disable-next-line @typescript-eslint/prefer-optional-chain + if (typeof window !== 'undefined' && window.performance?.mark) { + const entries = window.performance.getEntriesByName(traceId, 'measure') || []; + const startMarkName = `_${traceId}Start[${entries.length}]`; + const endMarkName = `_${traceId}End[${entries.length}]`; + return new Observable(emitter => { + window.performance.mark(startMarkName); + emitter.next(); + return { + unsubscribe: () => { + window.performance.mark(endMarkName); + window.performance.measure(traceId, startMarkName, endMarkName); + } + }; + }); + } else { + return EMPTY; + } +}; + +export const traceUntil = ( + name: string, + test: (a: T) => boolean, + options?: { orComplete?: boolean } +) => (source$: Observable) => new Observable(subscriber => { + const traceSubscription = trace$(name).subscribe(); + return source$.pipe( + tap( + a => test(a) && traceSubscription.unsubscribe(), + () => undefined, + () => options && options.orComplete && traceSubscription.unsubscribe() + ) + ).subscribe(subscriber); +}); + +export const traceWhile = ( + name: string, + test: (a: T) => boolean, + options?: { orComplete?: boolean } +) => (source$: Observable) => new Observable(subscriber => { + let traceSubscription: Subscription | undefined; + return source$.pipe( + tap( + a => { + if (test(a)) { + traceSubscription = traceSubscription || trace$(name).subscribe(); + } else { + if (traceSubscription) { + traceSubscription.unsubscribe(); + } + + traceSubscription = undefined; + } + }, + () => undefined, + () => options && options.orComplete && traceSubscription && traceSubscription.unsubscribe() + ) + ).subscribe(subscriber); +}); + +export const traceUntilComplete = (name: string) => (source$: Observable) => new Observable(subscriber => { + const traceSubscription = trace$(name).subscribe(); + return source$.pipe( + tap( + () => undefined, + () => undefined, + () => traceSubscription.unsubscribe() + ) + ).subscribe(subscriber); +}); + +export const traceUntilFirst = (name: string) => (source$: Observable) => new Observable(subscriber => { + const traceSubscription = trace$(name).subscribe(); + return source$.pipe( + tap( + () => traceSubscription.unsubscribe(), + () => undefined, + () => undefined ) + ).subscribe(subscriber); +}); + +export const trace = (name: string) => (source$: Observable) => new Observable(subscriber => { + const traceSubscription = trace$(name).subscribe(); + return source$.pipe( + tap( + () => traceSubscription.unsubscribe(), + () => undefined, + () => traceSubscription.unsubscribe() + ) + ).subscribe(subscriber); +}); + +ÉĩapplyMixins(AngularFirePerformance, [proxyPolyfillCompat]); diff --git a/src/compat/performance/public_api.ts b/src/compat/performance/public_api.ts new file mode 100644 index 000000000..b6dc28449 --- /dev/null +++ b/src/compat/performance/public_api.ts @@ -0,0 +1,3 @@ +export * from './performance'; +export * from './performance.module'; +export * from './performance.service'; diff --git a/src/compat/proxy.ts b/src/compat/proxy.ts new file mode 100644 index 000000000..5c1eb50d0 --- /dev/null +++ b/src/compat/proxy.ts @@ -0,0 +1,87 @@ +import { NgZone } from '@angular/core'; +import { Observable } from 'rxjs'; + +type MyFunction = (...args: any[]) => any; +type FunctionPropertyNames = { [K in keyof T]: T[K] extends MyFunction ? K : never }[keyof T]; +type ReturnTypeOrNever = T extends MyFunction ? ReturnType : never; +type ParametersOrNever = T extends MyFunction ? Parameters : never; +type PromiseReturningFunctionPropertyNames = { + [K in FunctionPropertyNames]: ReturnTypeOrNever extends Promise ? K : never +}[FunctionPropertyNames]; +type NonPromiseReturningFunctionPropertyNames = { + [K in FunctionPropertyNames]: ReturnTypeOrNever extends Promise ? never : K +}[FunctionPropertyNames]; +type NonFunctionPropertyNames = { [K in keyof T]: T[K] extends MyFunction ? never : K }[keyof T]; + +export type ÉĩPromiseProxy = { [K in NonFunctionPropertyNames]: Promise } & + { [K in NonPromiseReturningFunctionPropertyNames]: (...args: ParametersOrNever) => Promise> } & + { [K in PromiseReturningFunctionPropertyNames]: T[K] }; + +// DEBUG quick debugger function for inline logging that typescript doesn't complain about +// wrote it for debugging the ÉĩlazySDKProxy, commenting out for now; should consider exposing a +// verbose mode for AngularFire in a future release that uses something like this in multiple places +// usage: () => log('something') || returnValue +// const log = (...args: any[]): false => { console.log(...args); return false } + +// The problem here are things like ngOnDestroy are missing, then triggering the service +// rather than dig too far; I'm capturing these as I go. +const noopFunctions = ['ngOnDestroy']; + +// INVESTIGATE should we make the Proxy revokable and do some cleanup? +// right now it's fairly simple but I'm sure this will grow in complexity +export const ÉĩlazySDKProxy = (klass: any, observable: Observable, zone: NgZone, options: { + spy?: { + get?: ((name: string, it: any) => void), + apply?: ((name: string, args: any[], it: any) => void) + } +} = {}) => { + return new Proxy(klass, { + get: (_, name: string) => zone.runOutsideAngular(() => { + if (klass[name]) { + if (options?.spy?.get) { + options.spy.get(name, klass[name]); + } + return klass[name]; + } + if (noopFunctions.indexOf(name) > -1) { + return () => undefined; + } + const promise = observable.toPromise().then(mod => { + const ret = mod?.[name]; + // TODO move to proper type guards + if (typeof ret === 'function') { + return ret.bind(mod); + } else if (ret?.then) { + return ret.then((res: any) => zone.run(() => res)); + } else { + return zone.run(() => ret); + } + }); + // recurse the proxy + return new Proxy(() => undefined, { + get: (_, name) => promise[name], + // TODO handle callbacks as transparently as I can + apply: (self, _, args) => promise.then(it => { + const res = it?.(...args); + if (options?.spy?.apply) { + options.spy.apply(name, args, res); + } + return res; + }) + } + ); + }) + }); +}; + +export const ÉĩapplyMixins = (derivedCtor: any, constructors: any[]) => { + constructors.forEach((baseCtor) => { + Object.getOwnPropertyNames(baseCtor.prototype || baseCtor).forEach((name) => { + Object.defineProperty( + derivedCtor.prototype, + name, + Object.getOwnPropertyDescriptor(baseCtor.prototype || baseCtor, name) + ); + }); + }); +}; diff --git a/src/compat/public_api.ts b/src/compat/public_api.ts new file mode 100644 index 000000000..3d5ea5ea3 --- /dev/null +++ b/src/compat/public_api.ts @@ -0,0 +1,4 @@ +export * from './proxy'; +export * from './firebase.app'; +export * from './firebase.app.module'; +export * from './cache'; diff --git a/src/compat/remote-config/base.ts b/src/compat/remote-config/base.ts new file mode 100644 index 000000000..376176aa3 --- /dev/null +++ b/src/compat/remote-config/base.ts @@ -0,0 +1,19 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +// Export a null object with the same keys as firebase/compat/remote-config, so Proxy can work with proxy-polyfill in Internet Explorer +export const proxyPolyfillCompat = { + app: null, + settings: null, + defaultConfig: null, + fetchTimeMillis: null, + lastFetchStatus: null, + activate: null, + ensureInitialized: null, + fetch: null, + fetchAndActivate: null, + getAll: null, + getBoolean: null, + getNumber: null, + getString: null, + getValue: null, + setLogLevel: null, +}; diff --git a/src/compat/remote-config/index.ts b/src/compat/remote-config/index.ts new file mode 100644 index 000000000..4aaf8f92e --- /dev/null +++ b/src/compat/remote-config/index.ts @@ -0,0 +1 @@ +export * from './public_api'; diff --git a/src/compat/remote-config/interfaces.ts b/src/compat/remote-config/interfaces.ts new file mode 100644 index 000000000..28927ef5e --- /dev/null +++ b/src/compat/remote-config/interfaces.ts @@ -0,0 +1,3 @@ +import firebase from 'firebase/compat/app'; + +export type Settings = firebase.remoteConfig.Settings; diff --git a/src/compat/remote-config/ng-package.json b/src/compat/remote-config/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/remote-config/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/remote-config/package.json b/src/compat/remote-config/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/compat/remote-config/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/remote-config/public_api.ts b/src/compat/remote-config/public_api.ts new file mode 100644 index 000000000..f3239f665 --- /dev/null +++ b/src/compat/remote-config/public_api.ts @@ -0,0 +1,2 @@ +export * from './remote-config'; +export * from './remote-config.module'; diff --git a/src/compat/remote-config/remote-config.module.ts b/src/compat/remote-config/remote-config.module.ts new file mode 100644 index 000000000..485358dc7 --- /dev/null +++ b/src/compat/remote-config/remote-config.module.ts @@ -0,0 +1,13 @@ +import { NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { AngularFireRemoteConfig } from './remote-config'; + +@NgModule({ + providers: [ AngularFireRemoteConfig ] +}) +export class AngularFireRemoteConfigModule { + constructor() { + firebase.registerVersion('angularfire', VERSION.full, 'rc-compat'); + } +} diff --git a/src/compat/remote-config/remote-config.spec.ts b/src/compat/remote-config/remote-config.spec.ts new file mode 100644 index 000000000..f585379d7 --- /dev/null +++ b/src/compat/remote-config/remote-config.spec.ts @@ -0,0 +1,65 @@ +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule, FIREBASE_APP_NAME, FIREBASE_OPTIONS } from '@angular/fire/compat'; +import { AngularFireRemoteConfig, AngularFireRemoteConfigModule, DEFAULTS, SETTINGS } from '@angular/fire/compat/remote-config'; +import { COMMON_CONFIG } from '../../../src/test-config'; +import { rando } from '../../../src/utils'; + +describe('AngularFireRemoteConfig', () => { + let rc: AngularFireRemoteConfig; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireRemoteConfigModule + ] + }); + + rc = TestBed.inject(AngularFireRemoteConfig); + }); + + it('should be exist', () => { + expect(rc instanceof AngularFireRemoteConfig).toBe(true); + }); + + it('should have the Firebase Functions instance', () => { + expect(rc.getValue).toBeDefined(); + }); + +}); + +const FIREBASE_APP_NAME_TOO = (Math.random() + 1).toString(36).substring(7); + +describe('AngularFireRemoteConfig with different app', () => { + let rc: AngularFireRemoteConfig; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireRemoteConfigModule + ], + providers: [ + { provide: FIREBASE_APP_NAME, useValue: FIREBASE_APP_NAME_TOO }, + { provide: FIREBASE_OPTIONS, useValue: COMMON_CONFIG }, + { provide: SETTINGS, useValue: {} }, + { provide: DEFAULTS, useValue: {} } + ] + }); + + rc = TestBed.inject(AngularFireRemoteConfig); + }); + + describe('', () => { + + it('should be an AngularFireAuth type', () => { + expect(rc instanceof AngularFireRemoteConfig).toEqual(true); + }); + + it('should have the Firebase Functions instance', () => { + expect(rc.getValue).toBeDefined(); + }); + + }); + +}); diff --git a/src/compat/remote-config/remote-config.ts b/src/compat/remote-config/remote-config.ts new file mode 100644 index 000000000..442be66ae --- /dev/null +++ b/src/compat/remote-config/remote-config.ts @@ -0,0 +1,304 @@ +import { EnvironmentInjector, Inject, Injectable, InjectionToken, NgZone, Optional, PLATFORM_ID, inject } from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { ÉĩPromiseProxy, ÉĩapplyMixins, ÉĩlazySDKProxy } from '@angular/fire/compat'; +import { FIREBASE_APP_NAME, FIREBASE_OPTIONS, ÉĩcacheInstance, ÉĩfirebaseAppFactory } from '@angular/fire/compat'; +import { FirebaseOptions } from 'firebase/app'; +import firebase from 'firebase/compat/app'; +import { isSupported } from 'firebase/remote-config'; +import { EMPTY, MonoTypeOperatorFunction, Observable, OperatorFunction, concat, of, pipe } from 'rxjs'; +import { + debounceTime, + distinctUntilChanged, + filter, + groupBy, + map, + mergeMap, + observeOn, + scan, + shareReplay, + startWith, + switchMap, + withLatestFrom +} from 'rxjs/operators'; +import { proxyPolyfillCompat } from './base'; +import { Settings } from './interfaces'; + +export type ConfigTemplate = Record; + +export const SETTINGS = new InjectionToken('angularfire2.remoteConfig.settings'); +export const DEFAULTS = new InjectionToken('angularfire2.remoteConfig.defaultConfig'); + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface AngularFireRemoteConfig extends ÉĩPromiseProxy { +} + +const AS_TO_FN = { strings: 'asString', numbers: 'asNumber', booleans: 'asBoolean' }; +const STATIC_VALUES = { numbers: 0, booleans: false, strings: undefined }; + +// TODO look into the types here, I don't like the anys +const proxyAll = (observable: Observable, as: 'numbers' | 'booleans' | 'strings') => new Proxy( + observable.pipe(mapToObject(as as any)), { + get: (self, name: string) => self[name] || observable.pipe( + map(all => all.find(p => p.key === name)), + map(param => param ? param[AS_TO_FN[as]]() : STATIC_VALUES[as]), + distinctUntilChanged() + ) + } +) as any; + +// TODO export as implements Partial<...> so minor doesn't break us +export class Value implements firebase.remoteConfig.Value { + asBoolean() { + return ['1', 'true', 't', 'y', 'yes', 'on'].indexOf(this._value.toLowerCase()) > -1; + } + + asString() { + return this._value; + } + + asNumber() { + return Number(this._value) || 0; + } + + getSource() { + return this._source; + } + + constructor(public _source: firebase.remoteConfig.ValueSource, public _value: string) { + } +} + +// SEMVER use ConstructorParameters when we can support Typescript 3.6 +export class Parameter extends Value { + constructor(public key: string, public fetchTimeMillis: number, source: firebase.remoteConfig.ValueSource, value: string) { + super(source, value); + } +} + +// If it's a Parameter array, test any, else test the individual Parameter +const filterTest = (fn: (param: Parameter) => boolean) => filter(it => Array.isArray(it) ? it.some(fn) : fn(it)); + +// Allow the user to bypass the default values and wait till they get something from the server, even if it's a cached copy; +// if used in conjuntion with first() it will only fetch RC values from the server if they aren't cached locally +export const filterRemote = () => filterTest(p => p.getSource() === 'remote'); + +// filterFresh allows the developer to effectively set up a maximum cache time +export const filterFresh = (howRecentInMillis: number) => filterTest(p => p.fetchTimeMillis + howRecentInMillis >= new Date().getTime()); + + +// I ditched loading the defaults into RC and a simple map for scan since we already have our own defaults implementation. +// The idea here being that if they have a default that never loads from the server, they will be able to tell via fetchTimeMillis +// on the Parameter. Also if it doesn't come from the server it won't emit again in .changes, due to the distinctUntilChanged, +// which we can simplify to === rather than deep comparison +const scanToParametersArray = ( + remoteConfig: Observable +): OperatorFunction, Parameter[]> => pipe( + withLatestFrom(remoteConfig), + scan((existing, [all, rc]) => { + // SEMVER use "new Set" to unique once we're only targeting es6 + // at the scale we expect remote config to be at, we probably won't see a performance hit from this unoptimized uniqueness + // implementation. + // const allKeys = [...new Set([...existing.map(p => p.key), ...Object.keys(all)])]; + const allKeys = [...existing.map(p => p.key), ...Object.keys(all)].filter((v, i, a) => a.indexOf(v) === i); + return allKeys.map(key => { + const updatedValue = all[key]; + return updatedValue ? new Parameter(key, rc ? rc.fetchTimeMillis : -1, updatedValue.getSource(), updatedValue.asString()) + : existing.find(p => p.key === key); + }); + }, [] as Parameter[]) +); + + +@Injectable({ + providedIn: 'any' +}) +export class AngularFireRemoteConfig { + + readonly changes: Observable; + readonly parameters: Observable; + readonly numbers: Observable> & Record>; + readonly booleans: Observable> & Record>; + readonly strings: Observable> & Record>; + + private readonly injector = inject(EnvironmentInjector); + + constructor( + @Inject(FIREBASE_OPTIONS) options: FirebaseOptions, + @Optional() @Inject(FIREBASE_APP_NAME) name: string | null | undefined, + @Optional() @Inject(SETTINGS) settings: Settings | null, + @Optional() @Inject(DEFAULTS) defaultConfig: ConfigTemplate | null, + private zone: NgZone, + schedulers: ÉĩAngularFireSchedulers, + // eslint-disable-next-line @typescript-eslint/no-unused-vars,@typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object + ) { + const remoteConfig$ = of(undefined).pipe( + observeOn(schedulers.outsideAngular), + switchMap(() => isSupported()), + switchMap(isSupported => isSupported ? import('firebase/compat/remote-config') : EMPTY), + map(() => ÉĩfirebaseAppFactory(options, zone, name)), + map(app => ÉĩcacheInstance(`${app.name}.remote-config`, 'AngularFireRemoteConfig', app.name, () => { + const rc = app.remoteConfig(); + if (settings) { + rc.settings = settings; + } + if (defaultConfig) { + rc.defaultConfig = defaultConfig; + } + return rc; + }, [settings, defaultConfig])), + startWith(undefined), + shareReplay({ bufferSize: 1, refCount: false }) + ) as Observable; + + const loadedRemoteConfig$ = remoteConfig$.pipe( + filter(rc => !!rc) + ); + + const default$: Observable> = of(Object.keys(defaultConfig || {}).reduce( + (c, k) => ({ ...c, [k]: new Value('default', defaultConfig[k].toString()) }), {} + )); + + // we should filter out the defaults we provided to RC, since we have our own implementation + // that gives us a -1 for fetchTimeMillis (so filterFresh can filter them out) + const filterOutDefaults = map, Record>(all => + Object.keys(all) + .filter(key => all[key].getSource() !== 'default') + .reduce((acc, key) => ({ ...acc, [key]: all[key] }), {}) + ); + + const existing$ = loadedRemoteConfig$.pipe( + switchMap(rc => + rc.activate() + .then(() => rc.ensureInitialized()) + .then(() => rc.getAll()) + ), + filterOutDefaults + ); + + const fresh$ = loadedRemoteConfig$.pipe( + switchMap(rc => zone.runOutsideAngular(() => + rc.fetchAndActivate() + .then(() => rc.ensureInitialized()) + .then(() => rc.getAll()) + )), + filterOutDefaults + ); + + this.parameters = concat(default$, existing$, fresh$).pipe( + scanToParametersArray(remoteConfig$), + pendingUntilEvent(this.injector), + shareReplay({ bufferSize: 1, refCount: true }) + ); + + this.changes = this.parameters.pipe( + switchMap(params => of(...params)), + groupBy(param => param.key), + mergeMap(group => group.pipe( + distinctUntilChanged() + )) + ); + + this.strings = proxyAll(this.parameters, 'strings'); + this.booleans = proxyAll(this.parameters, 'booleans'); + this.numbers = proxyAll(this.parameters, 'numbers'); + + return ÉĩlazySDKProxy(this, loadedRemoteConfig$, zone); + } + +} + + +export const budget = (interval: number): MonoTypeOperatorFunction => (source: Observable) => new Observable(observer => { + let timedOut = false; + // TODO use scheduler task rather than settimeout + const timeout = setTimeout(() => { + observer.complete(); + timedOut = true; + }, interval); + return source.subscribe({ + next(val) { + if (!timedOut) { + observer.next(val); + } + }, + error(err) { + if (!timedOut) { + clearTimeout(timeout); + observer.error(err); + } + }, + complete() { + if (!timedOut) { + clearTimeout(timeout); + observer.complete(); + } + } + }); +}); + +const typedMethod = (it: any) => { + switch (typeof it) { + case 'string': + return 'asString'; + case 'boolean': + return 'asBoolean'; + case 'number': + return 'asNumber'; + default: + return 'asString'; + } +}; + + +export function scanToObject(): OperatorFunction>; +export function scanToObject(to: 'numbers'): OperatorFunction>; +export function scanToObject(to: 'booleans'): OperatorFunction>; +// eslint-disable-next-line @typescript-eslint/unified-signatures +export function scanToObject(to: 'strings'): OperatorFunction>; +export function scanToObject(template: T): OperatorFunction>; +export function scanToObject(to: 'numbers' | 'booleans' | 'strings' | T = 'strings') { + return pipe( + // TODO cleanup + scan( + (c, p: Parameter) => ({ + ...c, [p.key]: typeof to === 'object' ? + p[typedMethod(to[p.key])]() : + p[AS_TO_FN[to]]() + }), + typeof to === 'object' ? + to as T & Record : + {} as Record + ), + debounceTime(1), + budget(10), + distinctUntilChanged((a, b) => JSON.stringify(a) === JSON.stringify(b)) + ); +} + +export function mapToObject(): OperatorFunction>; +export function mapToObject(to: 'numbers'): OperatorFunction>; +export function mapToObject(to: 'booleans'): OperatorFunction>; +// eslint-disable-next-line @typescript-eslint/unified-signatures +export function mapToObject(to: 'strings'): OperatorFunction>; +export function mapToObject(template: T): + OperatorFunction>; +export function mapToObject(to: 'numbers' | 'booleans' | 'strings' | T = 'strings') { + return pipe( + // TODO this is getting a little long, cleanup + map((params: Parameter[]) => params.reduce( + (c, p) => ({ + ...c, [p.key]: typeof to === 'object' ? + p[typedMethod(to[p.key])]() : + p[AS_TO_FN[to]]() + }), + typeof to === 'object' ? + to as T & Record : + {} as Record + )), + distinctUntilChanged((a, b) => JSON.stringify(a) === JSON.stringify(b)) + ); +} + +ÉĩapplyMixins(AngularFireRemoteConfig, [proxyPolyfillCompat]); diff --git a/src/compat/storage/interfaces.ts b/src/compat/storage/interfaces.ts new file mode 100644 index 000000000..12b5f5175 --- /dev/null +++ b/src/compat/storage/interfaces.ts @@ -0,0 +1,11 @@ +import firebase from 'firebase/compat/app'; + +export type UploadTask = firebase.storage.UploadTask; +export type UploadTaskSnapshot = firebase.storage.UploadTaskSnapshot; +export type UploadMetadata = firebase.storage.UploadMetadata; + +export type SettableMetadata = firebase.storage.SettableMetadata; +export type Reference = firebase.storage.Reference; +export type StringFormat = firebase.storage.StringFormat; +export type ListResult = firebase.storage.ListResult; +export type ListOptions = firebase.storage.ListOptions; diff --git a/src/compat/storage/ng-package.json b/src/compat/storage/ng-package.json new file mode 100644 index 000000000..e5e5ccdfc --- /dev/null +++ b/src/compat/storage/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/compat/storage/observable/fromTask.ts b/src/compat/storage/observable/fromTask.ts new file mode 100644 index 000000000..85f8a34e5 --- /dev/null +++ b/src/compat/storage/observable/fromTask.ts @@ -0,0 +1,39 @@ +import { Observable } from 'rxjs'; +import { debounceTime } from 'rxjs/operators'; +import { UploadTask, UploadTaskSnapshot } from '../interfaces'; + +// need to import, else the types become import('firebase/compat/app').default.storage.UploadTask +// and it no longer works w/Firebase v7 + +// Things aren't working great, I'm having to put in a lot of work-arounds for what +// appear to be Firebase JS SDK bugs https://github.com/firebase/firebase-js-sdk/issues/4158 +export function fromTask(task: UploadTask) { + return new Observable(subscriber => { + const progress = (snap: UploadTaskSnapshot) => subscriber.next(snap); + const error = e => subscriber.error(e); + const complete = () => subscriber.complete(); + // emit the current snapshot, so they don't have to wait for state_changes + // to fire next... this is stale if the task is no longer running :( + progress(task.snapshot); + const unsub = task.on('state_changed', progress); + // it turns out that neither task snapshot nor 'state_changed' fire the last + // snapshot before completion, the one with status 'success" and 100% progress + // so let's use the promise form of the task for that + task.then(snapshot => { + progress(snapshot); + complete(); + }, e => { + // TODO investigate, again this is stale, we never fire a canceled or error it seems + progress(task.snapshot); + error(e); + }); + // on's type if Function, rather than () => void, need to wrap + return function unsubscribe() { + unsub(); + }; + }).pipe( + // deal with sync emissions from first emitting `task.snapshot`, this makes sure + // that if the task is already finished we don't emit the old running state + debounceTime(0) + ); +} diff --git a/src/compat/storage/package.json b/src/compat/storage/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/compat/storage/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/compat/storage/pipes/storageUrl.pipe.ts b/src/compat/storage/pipes/storageUrl.pipe.ts new file mode 100644 index 000000000..29c7d01d0 --- /dev/null +++ b/src/compat/storage/pipes/storageUrl.pipe.ts @@ -0,0 +1,48 @@ +import { AsyncPipe } from '@angular/common'; +import { ChangeDetectorRef, NgModule, OnDestroy, Optional, Pipe, PipeTransform, TransferState, makeStateKey } from '@angular/core'; +import { Observable, of } from 'rxjs'; +import { tap } from 'rxjs/operators'; +import { AngularFireStorage } from '../storage'; + +/** to be used with in combination with | async */ +@Pipe({ + name: 'getDownloadURL', + pure: false, +}) +export class GetDownloadURLPipe implements PipeTransform, OnDestroy { + + private asyncPipe: AsyncPipe; + private path: string; + private downloadUrl$: Observable; + + constructor( + private storage: AngularFireStorage, + cdr: ChangeDetectorRef, + @Optional() private state: TransferState + ) { + this.asyncPipe = new AsyncPipe(cdr); + } + + transform(path: string) { + if (path !== this.path) { + this.path = path; + const key = makeStateKey(`|getDownloadURL|${path}`); + const existing = this.state?.get(key, undefined); + this.downloadUrl$ = existing ? of(existing) : this.storage.ref(path).getDownloadURL().pipe( + tap(it => this.state?.set(key, it)) + ); + } + return this.asyncPipe.transform(this.downloadUrl$); + } + + ngOnDestroy() { + this.asyncPipe.ngOnDestroy(); + } + +} + +@NgModule({ + imports: [ GetDownloadURLPipe ], + exports: [ GetDownloadURLPipe ], +}) +export class GetDownloadURLPipeModule {} diff --git a/src/compat/storage/public_api.ts b/src/compat/storage/public_api.ts new file mode 100644 index 000000000..460348fa1 --- /dev/null +++ b/src/compat/storage/public_api.ts @@ -0,0 +1,6 @@ +export * from './ref'; +export * from './storage'; +export * from './task'; +export * from './observable/fromTask'; +export * from './storage.module'; +export * from './pipes/storageUrl.pipe'; diff --git a/src/compat/storage/ref.ts b/src/compat/storage/ref.ts new file mode 100644 index 000000000..26bd14749 --- /dev/null +++ b/src/compat/storage/ref.ts @@ -0,0 +1,54 @@ +import { Injector } from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { Observable, from, of } from 'rxjs'; +import { observeOn, switchMap } from 'rxjs/operators'; +import { ListOptions, ListResult, Reference, SettableMetadata, StringFormat, UploadMetadata } from './interfaces'; +import { AngularFireUploadTask, createUploadTask } from './task'; + +export interface AngularFireStorageReference { + getDownloadURL(): Observable; + getMetadata(): Observable; + delete(): Observable; + child(path: string): AngularFireStorageReference; + updateMetadata(meta: SettableMetadata): Observable; + put(data: any, metadata?: UploadMetadata | undefined): AngularFireUploadTask; + putString(data: string, format?: string | undefined, metadata?: UploadMetadata | undefined): AngularFireUploadTask; + list(options?: ListOptions): Observable; + listAll(): Observable; +} + +/** + * Create an AngularFire wrapped Storage Reference. This object + * creates observable methods from promise based methods. + */ +export function createStorageRef( + ref: Reference, + injector?: Injector +): AngularFireStorageReference { + return { + getDownloadURL: () => of(undefined).pipe( + observeOn(injector.get(ÉĩAngularFireSchedulers).outsideAngular), + switchMap(() => ref.getDownloadURL()), + pendingUntilEvent(injector) + ), + getMetadata: () => of(undefined).pipe( + observeOn(injector.get(ÉĩAngularFireSchedulers).outsideAngular), + switchMap(() => ref.getMetadata()), + pendingUntilEvent(injector) + ), + delete: () => from(ref.delete()), + child: (path: string) => createStorageRef(ref.child(path), injector), + updateMetadata: (meta: SettableMetadata) => from(ref.updateMetadata(meta)), + put: (data: any, metadata?: UploadMetadata) => { + const task = ref.put(data, metadata); + return createUploadTask(task); + }, + putString: (data: string, format?: StringFormat, metadata?: UploadMetadata) => { + const task = ref.putString(data, format, metadata); + return createUploadTask(task); + }, + list: (options?: ListOptions) => from(ref.list(options)), + listAll: () => from(ref.listAll()) + }; +} diff --git a/src/compat/storage/storage.module.ts b/src/compat/storage/storage.module.ts new file mode 100644 index 000000000..890c3e394 --- /dev/null +++ b/src/compat/storage/storage.module.ts @@ -0,0 +1,16 @@ +import { NgModule } from '@angular/core'; +import { VERSION } from '@angular/fire'; +import firebase from 'firebase/compat/app'; +import { GetDownloadURLPipeModule } from './pipes/storageUrl.pipe'; +import { AngularFireStorage } from './storage'; + +@NgModule({ + imports: [ GetDownloadURLPipeModule ], + exports: [ GetDownloadURLPipeModule ], + providers: [ AngularFireStorage ] +}) +export class AngularFireStorageModule { + constructor() { + firebase.registerVersion('angularfire', VERSION.full, 'gcs-compat'); + } +} diff --git a/src/compat/storage/storage.spec.ts b/src/compat/storage/storage.spec.ts new file mode 100644 index 000000000..d99c3509e --- /dev/null +++ b/src/compat/storage/storage.spec.ts @@ -0,0 +1,289 @@ +import { ChangeDetectorRef } from '@angular/core'; +import { TestBed } from '@angular/core/testing'; +import { AngularFireModule, FIREBASE_APP_NAME, FIREBASE_OPTIONS } from '@angular/fire/compat'; +import { AngularFireStorage, AngularFireStorageModule, AngularFireUploadTask, BUCKET, USE_EMULATOR, fromTask } from '@angular/fire/compat/storage'; +import firebase from 'firebase/compat/app'; +import { forkJoin } from 'rxjs'; +import { mergeMap, tap } from 'rxjs/operators'; +import { COMMON_CONFIG, storageEmulatorPort } from '../../test-config'; +import { rando } from '../../utils'; +import 'firebase/compat/storage'; + +if (typeof XMLHttpRequest === 'undefined') { + globalThis.XMLHttpRequest = require('xhr2'); +} + +const blobOrBuffer = (data: string, options: unknown) => { + if (typeof Blob === 'undefined') { + return Buffer.from(data, 'utf8'); + } else { + return new Blob([JSON.stringify(data)], options); + } +}; + +describe('AngularFireStorage', () => { + let afStorage: AngularFireStorage; + + beforeEach(() => { + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireStorageModule, + ], + providers: [ + ChangeDetectorRef, + { provide: USE_EMULATOR, useValue: ['localhost', storageEmulatorPort] } + ] + }); + + afStorage = TestBed.inject(AngularFireStorage); + }); + + it('should exist', () => { + expect(afStorage instanceof AngularFireStorage).toBe(true); + }); + + it('should have the Firebase storage instance', () => { + expect(afStorage.storage).toBeDefined(); + }); + + it('should have an initialized Firebase app', () => { + expect(afStorage.storage.app).toBeDefined(); + }); + + describe('upload task', () => { + + it('should upload and delete a file', (done) => { + const data = { angular: 'fire' }; + const blob = blobOrBuffer(JSON.stringify(data), { type: 'application/json' }); + const ref = TestBed.runInInjectionContext(() => afStorage.ref(rando())); + const task = TestBed.runInInjectionContext(() => ref.put(blob)); + let emissionCount = 0; + let lastSnap: firebase.storage.UploadTaskSnapshot; + TestBed.runInInjectionContext(() => task.snapshotChanges()) + .subscribe( + snap => { + lastSnap = snap; + emissionCount++; + expect(snap).toBeDefined(); + }, + done.fail, + () => { + expect(lastSnap.state).toBe('success'); + expect(emissionCount).toBeGreaterThan(0); + ref.delete().subscribe(done, done.fail); + }); + }); + + it('should upload a file and observe the download url', (done) => { + const data = {angular: 'fire'}; + const blob = blobOrBuffer(JSON.stringify(data), {type: 'application/json'}); + const ref = TestBed.runInInjectionContext(() => afStorage.ref(rando())); + TestBed.runInInjectionContext(() => ref.put(blob)).then(() => { + const url$ = TestBed.runInInjectionContext(() => ref.getDownloadURL()); + url$.subscribe( + url => { + expect(url).toBeDefined(); + }, + done.fail, + () => { + ref.delete().subscribe(done, done.fail); + } + ); + }); + }); + + it('should resolve the task as a promise', (done) => { + const data = { angular: 'promise' }; + const blob = blobOrBuffer(JSON.stringify(data), { type: 'application/json' }); + const ref = TestBed.runInInjectionContext(() => afStorage.ref(rando())); + const task: AngularFireUploadTask = TestBed.runInInjectionContext(() => ref.put(blob)); + task.then(snap => { + expect(snap).toBeDefined(); + done(); + }).catch(done.fail); + }); + + it('should cancel the task', (done) => { + const data = { angular: 'promise' }; + const blob = blobOrBuffer(JSON.stringify(data), { type: 'application/json' }); + const ref = TestBed.runInInjectionContext(() => afStorage.ref(rando())); + const task: AngularFireUploadTask = TestBed.runInInjectionContext(() => ref.put(blob)); + let emissionCount = 0; + let lastSnap: firebase.storage.UploadTaskSnapshot; + TestBed.runInInjectionContext(() => task.snapshotChanges()).subscribe(snap => { + emissionCount++; + lastSnap = snap; + if (emissionCount === 1) { + task.cancel(); + } + }, () => { + // TODO investigate, this doesn't appear to work... + // https://github.com/firebase/firebase-js-sdk/issues/4158 + // expect(lastSnap.state).toEqual('canceled'); + expect(emissionCount).toEqual(1); + expect(lastSnap.state).toEqual('running'); + done(); + }, done.fail); + }); + + it('should be able to pause/resume the task', (done) => { + const data = { angular: 'promise' }; + const blob = blobOrBuffer(JSON.stringify(data), { type: 'application/json' }); + const ref = TestBed.runInInjectionContext(() => afStorage.ref(rando())); + const task: AngularFireUploadTask = TestBed.runInInjectionContext(() => ref.put(blob)); + let paused = false; + task.pause(); + TestBed.runInInjectionContext(() => task.snapshotChanges()).subscribe(snap => { + if (snap.state === 'paused') { + paused = true; + task.resume(); + } + }, done.fail, () => { + expect(paused).toBeTruthy(); + done(); + }); + }); + + it('should work with an already finished task', (done) => { + const data = {angular: 'promise'}; + const blob = blobOrBuffer(JSON.stringify(data), {type: 'application/json'}); + const ref = TestBed.runInInjectionContext(() => afStorage.storage.ref(rando())); + const task = TestBed.runInInjectionContext(() => ref.put(blob)); + let emissionCount = 0; + let lastSnap: firebase.storage.UploadTaskSnapshot; + task.then(_snap => { + fromTask(task).subscribe( + snap => { + lastSnap = snap; + emissionCount++; + expect(snap).toBeDefined(); + }, + done.fail, + () => { + expect(lastSnap.state).toBe('success'); + expect(emissionCount).toBe(1); + ref.delete().then(done, done.fail); + }); + }); + }); + + }); + + describe('reference', () => { + + it('it should upload, download, and delete', (done) => { + const data = { angular: 'fire' }; + const blob = blobOrBuffer(JSON.stringify(data), { type: 'application/json' }); + const ref = TestBed.runInInjectionContext(() => afStorage.ref(rando())); + const task = TestBed.runInInjectionContext(() => ref.put(blob)); + // Wait for the upload + forkJoin([TestBed.runInInjectionContext(() => task.snapshotChanges())]) + .pipe( + // get the url download + mergeMap(() => TestBed.runInInjectionContext(() => ref.getDownloadURL())), + // assert the URL + tap(url => expect(url).toBeDefined()), + // Delete the file + mergeMap(() => ref.delete()) + ) + // finish the test + .subscribe(done, done.fail); + }); + + it('should upload, get metadata, and delete', (done) => { + pending("Not sure why this is busted."); + const data = { angular: 'fire' }; + const blob = blobOrBuffer(JSON.stringify(data), { type: 'application/json' }); + const ref = TestBed.runInInjectionContext(() => afStorage.ref(rando())); + const task = TestBed.runInInjectionContext(() => ref.put(blob, { customMetadata: { blah: 'blah' } })); + // Wait for the upload + forkJoin([TestBed.runInInjectionContext(() => task.snapshotChanges())]) + .pipe( + // get the metadata download + mergeMap(() => TestBed.runInInjectionContext(() => ref.getMetadata())), + // assert the URL + tap(meta => expect(meta.customMetadata).toEqual({ blah: 'blah' })), + ) + // finish the test + .subscribe(done, done.fail); + }); + + }); + +}); + +describe('AngularFireStorage w/options', () => { + let afStorage: AngularFireStorage; + let firebaseAppName: string; + let storageBucket: string; + + beforeEach(() => { + firebaseAppName = rando(); + storageBucket = 'angularfire2-test2'; + TestBed.configureTestingModule({ + imports: [ + AngularFireModule.initializeApp(COMMON_CONFIG, rando()), + AngularFireStorageModule + ], + providers: [ + { provide: FIREBASE_APP_NAME, useValue: firebaseAppName }, + { provide: FIREBASE_OPTIONS, useValue: COMMON_CONFIG }, + { provide: BUCKET, useValue: storageBucket }, + { provide: USE_EMULATOR, useValue: ['localhost', storageEmulatorPort] }, + ] + }); + + afStorage = TestBed.inject(AngularFireStorage); + }); + + describe('', () => { + + it('should exist', () => { + expect(afStorage instanceof AngularFireStorage).toBe(true); + }); + + it('should have the Firebase storage instance', () => { + expect(afStorage.storage).toBeDefined(); + }); + + it('should have an initialized Firebase app', () => { + expect(afStorage.storage.app).toBeDefined(); + }); + + it('should be hooked up the right app', () => { + expect(afStorage.storage.app.name).toEqual(firebaseAppName); + }); + + it('storage be pointing towards a different bucket', () => { + expect(afStorage.storage.ref().toString()).toEqual(`gs://${storageBucket}/`); + }); + + // TODO tests for Node? + if (typeof Blob !== 'undefined') { + + it('it should upload, download, and delete', (done) => { + const data = { angular: 'fire' }; + const blob = blobOrBuffer(JSON.stringify(data), { type: 'application/json' }); + const name = rando(); + const ref = TestBed.runInInjectionContext(() => afStorage.ref(name)); + const task = TestBed.runInInjectionContext(() => ref.put(blob)); + // Wait for the upload + forkJoin([TestBed.runInInjectionContext(() => task.snapshotChanges())]) + .pipe( + // get the url download + mergeMap(() => TestBed.runInInjectionContext(() => ref.getDownloadURL())), + // assert the URL + tap(url => expect(url).toMatch(new RegExp(`http:\\/\\/localhost:9199\\/v0\\/b\\/${storageBucket}\\/o\\/${name}`))), + // Delete the file + mergeMap(() => ref.delete()) + ) + // finish the test + .subscribe(done, done.fail); + }); + + } + + }); + +}); diff --git a/src/compat/storage/storage.ts b/src/compat/storage/storage.ts new file mode 100644 index 000000000..57968bb9e --- /dev/null +++ b/src/compat/storage/storage.ts @@ -0,0 +1,76 @@ +import { EnvironmentInjector, Inject, Injectable, InjectionToken, NgZone, Optional, PLATFORM_ID, inject } from '@angular/core'; +import { ÉĩAngularFireSchedulers } from '@angular/fire'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { FIREBASE_APP_NAME, FIREBASE_OPTIONS, ÉĩcacheInstance, ÉĩfirebaseAppFactory } from '@angular/fire/compat'; +import { FirebaseOptions } from 'firebase/app'; +import firebase from 'firebase/compat/app'; +import { UploadMetadata } from './interfaces'; +import { createStorageRef } from './ref'; +import 'firebase/compat/storage'; + +export const BUCKET = new InjectionToken('angularfire2.storageBucket'); +export const MAX_UPLOAD_RETRY_TIME = new InjectionToken('angularfire2.storage.maxUploadRetryTime'); +export const MAX_OPERATION_RETRY_TIME = new InjectionToken('angularfire2.storage.maxOperationRetryTime'); + +type UseEmulatorArguments = Parameters; +export const USE_EMULATOR = new InjectionToken('angularfire2.storage.use-emulator'); + +/** + * AngularFireStorage Service + * + * This service is the main entry point for this feature module. It provides + * an API for uploading and downloading binary files from Cloud Storage for + * Firebase. + */ +@Injectable({ + providedIn: 'any' +}) +export class AngularFireStorage { + public readonly storage: firebase.storage.Storage; + private readonly injector = inject(EnvironmentInjector); + + constructor( + @Inject(FIREBASE_OPTIONS) options: FirebaseOptions, + @Optional() @Inject(FIREBASE_APP_NAME) name: string | null | undefined, + @Optional() @Inject(BUCKET) storageBucket: string | null, + // eslint-disable-next-line @typescript-eslint/ban-types + @Inject(PLATFORM_ID) platformId: Object, + zone: NgZone, + schedulers: ÉĩAngularFireSchedulers, + @Optional() @Inject(MAX_UPLOAD_RETRY_TIME) maxUploadRetryTime: any, + @Optional() @Inject(MAX_OPERATION_RETRY_TIME) maxOperationRetryTime: any, + @Optional() @Inject(USE_EMULATOR) _useEmulator: any, + @Optional() _appCheckInstances: AppCheckInstances, + ) { + const app = ÉĩfirebaseAppFactory(options, zone, name); + this.storage = ÉĩcacheInstance(`${app.name}.storage.${storageBucket}`, 'AngularFireStorage', app.name, () => { + const storage = zone.runOutsideAngular(() => app.storage(storageBucket || undefined)); + const useEmulator = _useEmulator as UseEmulatorArguments|null; + if (useEmulator) { + storage.useEmulator(...useEmulator); + } + if (maxUploadRetryTime) { + storage.setMaxUploadRetryTime(maxUploadRetryTime); + } + if (maxOperationRetryTime) { + storage.setMaxOperationRetryTime(maxOperationRetryTime); + } + return storage; + }, [maxUploadRetryTime, maxOperationRetryTime]); + } + + ref(path: string) { + return createStorageRef(this.storage.ref(path), this.injector); + } + + refFromURL(path: string) { + return createStorageRef(this.storage.refFromURL(path), this.injector); + } + + upload(path: string, data: any, metadata?: UploadMetadata) { + const storageRef = this.storage.ref(path); + const ref = createStorageRef(storageRef, this.injector); + return ref.put(data, metadata); + } + +} diff --git a/src/compat/storage/task.ts b/src/compat/storage/task.ts new file mode 100644 index 000000000..53bba1afc --- /dev/null +++ b/src/compat/storage/task.ts @@ -0,0 +1,39 @@ +import { Observable } from 'rxjs'; +import { map } from 'rxjs/operators'; +import { UploadTask, UploadTaskSnapshot } from './interfaces'; +import { fromTask } from './observable/fromTask'; + +export interface AngularFireUploadTask { + task: UploadTask; + snapshotChanges(): Observable; + percentageChanges(): Observable; + pause(): boolean; + cancel(): boolean; + resume(): boolean; + then( + onFulfilled?: ((a: UploadTaskSnapshot) => any) | null, + onRejected?: ((a: Error) => any) | null + ): Promise; + catch(onRejected: (a: Error) => any): Promise; +} + +/** + * Create an AngularFireUploadTask from a regular UploadTask from the Storage SDK. + * This method creates an observable of the upload and returns on object that provides + * multiple methods for controlling and monitoring the file upload. + */ +export function createUploadTask(task: UploadTask): AngularFireUploadTask { + const inner$ = fromTask(task); + return { + task, + then: task.then.bind(task), + catch: task.catch.bind(task), + pause: task.pause.bind(task), + cancel: task.cancel.bind(task), + resume: task.resume.bind(task), + snapshotChanges: () => inner$, + percentageChanges: () => inner$.pipe( + map(s => s.bytesTransferred / s.totalBytes * 100) + ) + }; +} diff --git a/src/core.ts b/src/core.ts new file mode 100644 index 000000000..e0ad8f7f5 --- /dev/null +++ b/src/core.ts @@ -0,0 +1,43 @@ +import { Version } from '@angular/core'; +import { ComponentContainer } from '@firebase/component'; +import { FirebaseApp, getApps } from 'firebase/app'; + +export const VERSION = new Version('ANGULARFIRE2_VERSION'); + +export const ÉĩisSupportedError = (module: string) => + `The APP_INITIALIZER that is "making" isSupported() sync for the sake of convenient DI has not resolved in this +context. Rather than injecting ${module} in the constructor, first ensure that ${module} is supported by calling +\`await isSupported()\`, then retrieve the instance from the injector manually \`injector.get(${module})\`.`; + +// TODO is there a better way to get at the internal types? +interface FirebaseAppWithContainer extends FirebaseApp { + container: ComponentContainer; +} + +export function ÉĩgetDefaultInstanceOf(identifier: string, provided: T[]|undefined, defaultApp: FirebaseApp): T|undefined { + if (provided) { + // Was provide* only called once? If so grab that + if (provided.length === 1) { return provided[0]; } + const providedUsingDefaultApp = provided.filter((it: any) => it.app === defaultApp); + // Was provide* only called once, using the default app? If so use that + if (providedUsingDefaultApp.length === 1) { return providedUsingDefaultApp[0]; } + } + // Grab the default instance from the defaultApp + const defaultAppWithContainer: FirebaseAppWithContainer = defaultApp as any; + const provider = defaultAppWithContainer.container.getProvider(identifier as never); + return provider.getImmediate({ optional: true }); +} + +export const ÉĩgetAllInstancesOf = (identifier: string, app?: FirebaseApp): T[] => { + const apps = app ? [app] : getApps(); + const instances: any[] = []; + apps.forEach((app: FirebaseAppWithContainer) => { + const provider: any = app.container.getProvider(identifier as never); + provider.instances.forEach((instance: any) => { + if (!instances.includes(instance)) { + instances.push(instance); + } + }); + }); + return instances; +}; diff --git a/src/data-connect/data-connect.module.ts b/src/data-connect/data-connect.module.ts new file mode 100644 index 000000000..980a22e7c --- /dev/null +++ b/src/data-connect/data-connect.module.ts @@ -0,0 +1,74 @@ +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { registerVersion } from 'firebase/app'; +import { DATA_CONNECT_PROVIDER_NAME, DataConnect, DataConnectInstances } from './data-connect'; + +const PROVIDED_DATA_CONNECT_INSTANCES = new InjectionToken('angularfire2.data-connect-instances'); + +export function defaultDataConnectInstanceFactory(provided: DataConnect[]|undefined, defaultApp: FirebaseApp) { + return ÉĩgetDefaultInstanceOf(DATA_CONNECT_PROVIDER_NAME, provided, defaultApp); +} + +export function dataConnectInstanceFactory(fn: (injector: Injector) => DataConnect) { + return (zone: NgZone, injector: Injector) => { + return zone.runOutsideAngular(() => fn(injector)); + }; +} + +const DATA_CONNECT_INSTANCES_PROVIDER = { + provide: DataConnectInstances, + deps: [ + [new Optional(), PROVIDED_DATA_CONNECT_INSTANCES ], + ] +}; + +const DEFAULT_DATA_CONNECT_INSTANCE_PROVIDER = { + provide: DataConnect, + useFactory: defaultDataConnectInstanceFactory, + deps: [ + [new Optional(), PROVIDED_DATA_CONNECT_INSTANCES ], + FirebaseApp, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_DATA_CONNECT_INSTANCE_PROVIDER, + DATA_CONNECT_INSTANCES_PROVIDER, + ] +}) +export class DataConnectModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'fdc'); + } +} + +export function provideDataConnect(fn: (injector: Injector) => DataConnect, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'fdc'); + + return makeEnvironmentProviders([ + DEFAULT_DATA_CONNECT_INSTANCE_PROVIDER, + DATA_CONNECT_INSTANCES_PROVIDER, + { + provide: PROVIDED_DATA_CONNECT_INSTANCES, + useFactory: dataConnectInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + ...deps, + ], + } + ]); +} diff --git a/src/data-connect/data-connect.spec.ts b/src/data-connect/data-connect.spec.ts new file mode 100644 index 000000000..91c7458de --- /dev/null +++ b/src/data-connect/data-connect.spec.ts @@ -0,0 +1,38 @@ +/* +import { TestBed } from '@angular/core/testing'; +import { getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { DataConnect, getDataConnect, provideDataConnect } from '@angular/fire/data-connect'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + + +describe('DataConnect', () => { + let dataConnect: DataConnect; + let providedDataConnect: DataConnect; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideDataConnect(() => { + providedDataConnect = getDataConnect(getApp(appName)); + return providedDataConnect; + }), + ], + }); + dataConnect = TestBed.inject(DataConnect); + }); + + it('should be injectable', () => { + expect(providedDataConnect).toBeTruthy(); + expect(dataConnect).toEqual(providedDataConnect); + }); + + }); + +}); +*/ \ No newline at end of file diff --git a/src/data-connect/data-connect.ts b/src/data-connect/data-connect.ts new file mode 100644 index 000000000..2aa4ff0d0 --- /dev/null +++ b/src/data-connect/data-connect.ts @@ -0,0 +1,22 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { DataConnect } from 'firebase/data-connect'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +export { DataConnect }; + +export const DATA_CONNECT_PROVIDER_NAME = 'data-connect'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface DataConnectInstances extends Array {} + +export class DataConnectInstances { + constructor() { + return ÉĩgetAllInstancesOf(DATA_CONNECT_PROVIDER_NAME); + } +} + +export const dataConnectInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(DATA_CONNECT_PROVIDER_NAME))), + distinct(), +); diff --git a/src/data-connect/firebase.ts b/src/data-connect/firebase.ts new file mode 100644 index 000000000..2597117d8 --- /dev/null +++ b/src/data-connect/firebase.ts @@ -0,0 +1,26 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/data-connect'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + connectDataConnectEmulator as _connectDataConnectEmulator, + executeMutation as _executeMutation, + executeQuery as _executeQuery, + getDataConnect as _getDataConnect, + mutationRef as _mutationRef, + queryRef as _queryRef, + setLogLevel as _setLogLevel, + subscribe as _subscribe, + terminate as _terminate, + toQueryRef as _toQueryRef +} from 'firebase/data-connect'; + +export const connectDataConnectEmulator = ÉĩzoneWrap(_connectDataConnectEmulator, true); +export const executeMutation = ÉĩzoneWrap(_executeMutation, true); +export const executeQuery = ÉĩzoneWrap(_executeQuery, true); +export const getDataConnect = ÉĩzoneWrap(_getDataConnect, true); +export const mutationRef = ÉĩzoneWrap(_mutationRef, true, 2); +export const queryRef = ÉĩzoneWrap(_queryRef, true, 2); +export const setLogLevel = ÉĩzoneWrap(_setLogLevel, true); +export const subscribe = ÉĩzoneWrap(_subscribe, true); +export const terminate = ÉĩzoneWrap(_terminate, true); +export const toQueryRef = ÉĩzoneWrap(_toQueryRef, true, 2); diff --git a/src/data-connect/ng-package.json b/src/data-connect/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/data-connect/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/data-connect/overrides.ts b/src/data-connect/overrides.ts new file mode 100644 index 000000000..79a81fc23 --- /dev/null +++ b/src/data-connect/overrides.ts @@ -0,0 +1,3 @@ +import { isMessagingSupportedFactory } from './is-messaging-supported-factory'; + +export const isSupported = isMessagingSupportedFactory.async; diff --git a/src/data-connect/package.json b/src/data-connect/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/data-connect/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/data-connect/public_api.ts b/src/data-connect/public_api.ts new file mode 100644 index 000000000..6550c0b10 --- /dev/null +++ b/src/data-connect/public_api.ts @@ -0,0 +1,3 @@ +export { DataConnectInstances, DataConnect, dataConnectInstance$ } from './data-connect'; +export { provideDataConnect, DataConnectModule } from './data-connect.module'; +export * from './firebase'; diff --git a/src/database.ts b/src/database.ts deleted file mode 100644 index 9d20c9fa4..000000000 --- a/src/database.ts +++ /dev/null @@ -1,7 +0,0 @@ -export * from './database/database'; -export * from './database/firebase_list_factory'; -export * from './database/firebase_list_observable'; -export * from './database/firebase_object_factory'; -export * from './database/firebase_object_observable'; -export * from './database/query_observable'; -export * from './database/database.module'; diff --git a/src/database/database.module.ts b/src/database/database.module.ts index 181b1df99..7ded9070f 100644 --- a/src/database/database.module.ts +++ b/src/database/database.module.ts @@ -1,25 +1,81 @@ -import { NgModule } from '@angular/core'; -import * as firebase from 'firebase/app'; -import 'firebase/database'; -import { AngularFireModule, FirebaseApp } from '../angularfire2'; -import { AngularFireDatabase } from './database'; +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { AuthInstances } from '@angular/fire/auth'; +import { registerVersion } from 'firebase/app'; +import { Database as FirebaseDatabase } from 'firebase/database'; +import { DATABASE_PROVIDER_NAME, Database, DatabaseInstances } from './database'; -export function _getAngularFireDatabase(app: FirebaseApp) { - return new AngularFireDatabase(app); +export const PROVIDED_DATABASE_INSTANCES = new InjectionToken('angularfire2.database-instances'); + +export function defaultDatabaseInstanceFactory(provided: FirebaseDatabase[]|undefined, defaultApp: FirebaseApp) { + const defaultDatabase = ÉĩgetDefaultInstanceOf(DATABASE_PROVIDER_NAME, provided, defaultApp); + return defaultDatabase && new Database(defaultDatabase); +} + +export function databaseInstanceFactory(fn: (injector: Injector) => FirebaseDatabase) { + return (zone: NgZone, injector: Injector) => { + const database = zone.runOutsideAngular(() => fn(injector)); + return new Database(database); + }; } -export const AngularFireDatabaseProvider = { - provide: AngularFireDatabase, - useFactory: _getAngularFireDatabase, - deps: [ FirebaseApp ] +const DATABASE_INSTANCES_PROVIDER = { + provide: DatabaseInstances, + deps: [ + [new Optional(), PROVIDED_DATABASE_INSTANCES ], + ] }; -export const DATABASE_PROVIDERS = [ - AngularFireDatabaseProvider, -]; +const DEFAULT_DATABASE_INSTANCE_PROVIDER = { + provide: Database, + useFactory: defaultDatabaseInstanceFactory, + deps: [ + [new Optional(), PROVIDED_DATABASE_INSTANCES ], + FirebaseApp, + ] +}; @NgModule({ - imports: [ AngularFireModule ], - providers: [ DATABASE_PROVIDERS ] + providers: [ + DEFAULT_DATABASE_INSTANCE_PROVIDER, + DATABASE_INSTANCES_PROVIDER, + ] }) -export class AngularFireDatabaseModule { } +export class DatabaseModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'rtdb'); + } +} + +export function provideDatabase(fn: (injector: Injector) => FirebaseDatabase, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'rtdb'); + return makeEnvironmentProviders([ + DEFAULT_DATABASE_INSTANCE_PROVIDER, + DATABASE_INSTANCES_PROVIDER, + { + provide: PROVIDED_DATABASE_INSTANCES, + useFactory: databaseInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + // Database+Auth work better if Auth is loaded first + [new Optional(), AuthInstances ], + [new Optional(), AppCheckInstances ], + ...deps, + ] + } + ]); +} diff --git a/src/database/database.spec.ts b/src/database/database.spec.ts new file mode 100644 index 000000000..003464a4f --- /dev/null +++ b/src/database/database.spec.ts @@ -0,0 +1,39 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Database, connectDatabaseEmulator, getDatabase, provideDatabase } from '@angular/fire/database'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +describe('Database', () => { + let app: FirebaseApp; + let database: Database; + let providedDatabase: Database; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideDatabase(() => { + providedDatabase = getDatabase(getApp(appName)); + connectDatabaseEmulator(providedDatabase, 'localhost', 9002); + return providedDatabase; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + database = TestBed.inject(Database); + }); + + it('should be injectable', () => { + expect(providedDatabase).toBeTruthy(); + expect(database).toEqual(providedDatabase); + expect(database.app).toEqual(app); + }); + + }); + +}); diff --git a/src/database/database.ts b/src/database/database.ts index fecf6234c..487968581 100644 --- a/src/database/database.ts +++ b/src/database/database.ts @@ -1,34 +1,30 @@ -import * as firebase from 'firebase/app'; -import 'firebase/database'; -import { Inject, Injectable } from '@angular/core'; -import { FirebaseAppConfigToken, FirebaseAppConfig, FirebaseApp } from '../angularfire2'; -import { FirebaseListFactory } from './firebase_list_factory'; -import { FirebaseListObservable } from './firebase_list_observable'; -import { FirebaseListFactoryOpts, FirebaseObjectFactoryOpts, PathReference } from '../interfaces'; -import { FirebaseObjectFactory } from './firebase_object_factory'; -import { FirebaseObjectObservable } from './firebase_object_observable'; -import * as utils from '../utils'; +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { Database as FirebaseDatabase } from 'firebase/database'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; -@Injectable() -export class AngularFireDatabase { +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Database extends FirebaseDatabase {} - /** - * Firebase Database instance - */ - database: firebase.database.Database; - - constructor(public app: FirebaseApp) { - this.database = app.database(); +export class Database { + constructor(database: FirebaseDatabase) { + return database; } +} - list(pathOrRef: PathReference, opts?:FirebaseListFactoryOpts):FirebaseListObservable { - const ref = utils.getRef(this.app, pathOrRef); - return FirebaseListFactory(ref, opts); - } +export const DATABASE_PROVIDER_NAME = 'database'; - object(pathOrRef: PathReference, opts?:FirebaseObjectFactoryOpts):FirebaseObjectObservable { - const ref = utils.getRef(this.app, pathOrRef); - return FirebaseObjectFactory(ref, opts); - } +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface DatabaseInstances extends Array {} +export class DatabaseInstances { + constructor() { + return ÉĩgetAllInstancesOf(DATABASE_PROVIDER_NAME); + } } + +export const databaseInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(DATABASE_PROVIDER_NAME))), + distinct(), +); diff --git a/src/database/firebase.ts b/src/database/firebase.ts new file mode 100644 index 000000000..738794e8e --- /dev/null +++ b/src/database/firebase.ts @@ -0,0 +1,82 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/database'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + child as _child, + connectDatabaseEmulator as _connectDatabaseEmulator, + enableLogging as _enableLogging, + endAt as _endAt, + endBefore as _endBefore, + equalTo as _equalTo, + forceLongPolling as _forceLongPolling, + forceWebSockets as _forceWebSockets, + get as _get, + getDatabase as _getDatabase, + goOffline as _goOffline, + goOnline as _goOnline, + increment as _increment, + limitToFirst as _limitToFirst, + limitToLast as _limitToLast, + off as _off, + onChildAdded as _onChildAdded, + onChildChanged as _onChildChanged, + onChildMoved as _onChildMoved, + onChildRemoved as _onChildRemoved, + onDisconnect as _onDisconnect, + onValue as _onValue, + orderByChild as _orderByChild, + orderByKey as _orderByKey, + orderByPriority as _orderByPriority, + orderByValue as _orderByValue, + push as _push, + query as _query, + ref as _ref, + refFromURL as _refFromURL, + remove as _remove, + runTransaction as _runTransaction, + set as _set, + setPriority as _setPriority, + setWithPriority as _setWithPriority, + startAfter as _startAfter, + startAt as _startAt, + update as _update +} from 'firebase/database'; + +export const child = ÉĩzoneWrap(_child, true, 2); +export const connectDatabaseEmulator = ÉĩzoneWrap(_connectDatabaseEmulator, true); +export const enableLogging = ÉĩzoneWrap(_enableLogging, true); +export const endAt = ÉĩzoneWrap(_endAt, true, 2); +export const endBefore = ÉĩzoneWrap(_endBefore, true, 2); +export const equalTo = ÉĩzoneWrap(_equalTo, true, 2); +export const forceLongPolling = ÉĩzoneWrap(_forceLongPolling, true); +export const forceWebSockets = ÉĩzoneWrap(_forceWebSockets, true); +export const get = ÉĩzoneWrap(_get, true); +export const getDatabase = ÉĩzoneWrap(_getDatabase, true); +export const goOffline = ÉĩzoneWrap(_goOffline, true); +export const goOnline = ÉĩzoneWrap(_goOnline, true); +export const increment = ÉĩzoneWrap(_increment, true, 2); +export const limitToFirst = ÉĩzoneWrap(_limitToFirst, true, 2); +export const limitToLast = ÉĩzoneWrap(_limitToLast, true, 2); +export const off = ÉĩzoneWrap(_off, true); +export const onChildAdded = ÉĩzoneWrap(_onChildAdded, true); +export const onChildChanged = ÉĩzoneWrap(_onChildChanged, true); +export const onChildMoved = ÉĩzoneWrap(_onChildMoved, true); +export const onChildRemoved = ÉĩzoneWrap(_onChildRemoved, true); +export const onDisconnect = ÉĩzoneWrap(_onDisconnect, true); +export const onValue = ÉĩzoneWrap(_onValue, true); +export const orderByChild = ÉĩzoneWrap(_orderByChild, true, 2); +export const orderByKey = ÉĩzoneWrap(_orderByKey, true, 2); +export const orderByPriority = ÉĩzoneWrap(_orderByPriority, true, 2); +export const orderByValue = ÉĩzoneWrap(_orderByValue, true, 2); +export const push = ÉĩzoneWrap(_push, true, 2); +export const query = ÉĩzoneWrap(_query, true, 2); +export const ref = ÉĩzoneWrap(_ref, true, 2); +export const refFromURL = ÉĩzoneWrap(_refFromURL, true, 2); +export const remove = ÉĩzoneWrap(_remove, true, 2); +export const runTransaction = ÉĩzoneWrap(_runTransaction, true); +export const set = ÉĩzoneWrap(_set, true, 2); +export const setPriority = ÉĩzoneWrap(_setPriority, true, 2); +export const setWithPriority = ÉĩzoneWrap(_setWithPriority, true, 2); +export const startAfter = ÉĩzoneWrap(_startAfter, true, 2); +export const startAt = ÉĩzoneWrap(_startAt, true, 2); +export const update = ÉĩzoneWrap(_update, true, 2); diff --git a/src/database/firebase_list_factory.spec.ts b/src/database/firebase_list_factory.spec.ts deleted file mode 100644 index 1e430bd3c..000000000 --- a/src/database/firebase_list_factory.spec.ts +++ /dev/null @@ -1,910 +0,0 @@ -import * as firebase from 'firebase/app'; -import { AngularFireDatabase } from './database'; -import { AngularFireDatabaseModule } from './database.module'; -import { FirebaseListObservable } from './firebase_list_observable'; -import { FirebaseListFactory, onChildAdded, onChildChanged, onChildRemoved, onChildUpdated } from './firebase_list_factory'; -import { FirebaseObjectFactory } from './firebase_object_factory'; -import { FirebaseApp, FirebaseAppConfig, AngularFireModule} from '../angularfire2'; -import { TestBed, inject } from '@angular/core/testing'; -import * as utils from '../utils'; -import { Query, AFUnwrappedDataSnapshot } from '../interfaces'; -import { Subscription, Observable, Subject } from 'rxjs'; -import { COMMON_CONFIG } from '../test-config'; -import { _do } from 'rxjs/operator/do'; -import { map } from 'rxjs/operator/map'; -import { skip } from 'rxjs/operator/skip'; -import { take } from 'rxjs/operator/take'; -import { toArray } from 'rxjs/operator/toArray'; -import { toPromise } from 'rxjs/operator/toPromise'; - -const questionsPath = 'questions'; - -function queryTest(observable: Observable, subject: Subject, done: any) { - let nexted = false; - skipAndTake(observable, 2) - .subscribe(val => { - if (!nexted) { - subject.next('2'); - } - if (nexted) { - expect(nexted).toBe(true); - done(); - } - nexted = true; - }); - - subject.next('20'); -} - -describe('AngularFireDatabase', () => { - let app: FirebaseApp; - let db: AngularFireDatabase; - - beforeEach(() => { - TestBed.configureTestingModule({ - imports: [ - AngularFireModule.initializeApp(COMMON_CONFIG, '[DEFAULT]'), - AngularFireDatabaseModule - ] - }); - inject([FirebaseApp, AngularFireDatabase], (app_: FirebaseApp, _db: AngularFireDatabase) => { - app = app_; - db = _db; - })(); - }); - - afterEach(done => { - app.delete().then(done, done.fail); - }); - - describe('', () => { - - it('should accept a Firebase db url in the constructor', () => { - expect(db instanceof AngularFireDatabase).toBe(true); - }); - - }); - -}); - -describe('FirebaseListFactory', () => { - - let app: FirebaseApp; - let db: AngularFireDatabase; - - beforeEach(() => { - TestBed.configureTestingModule({ - imports: [ - AngularFireModule.initializeApp(COMMON_CONFIG, '[DEFAULT]'), - AngularFireDatabaseModule - ] - }); - inject([FirebaseApp, AngularFireDatabase], (app_: FirebaseApp, _db: AngularFireDatabase) => { - app = app_; - db = _db; - })(); - }); - - - describe('', () => { - - it('should accept a Firebase db ref in the constructor', () => { - const list = FirebaseListFactory(app.database().ref(`questions`)); - expect(list instanceof FirebaseListObservable).toBe(true); - }); - - }); - - describe('query', () => { - - describe('orderByChild', () => { - /* - orderByChild combinations - ---------------------- - orderByChild("").equalTo() - orderByChild("").startAt() - orderByChild("").startAt().endAt(); - orderByChild("").endAt(); - */ - it('equalTo - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByChild: 'height', - equalTo: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('startAt - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByChild: 'height', - startAt: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('endAt - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByChild: 'height', - endAt: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('should throw an error if limitToLast and limitToFirst are chained', () => { - - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByChild: 'height', - limitToFirst: 10, - limitToLast: 100 - } - }); - expect(observable.subscribe).toThrowError(); - }); - - it('should throw an error if startAt is used with equalTo', () => { - - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByChild: 'height', - equalTo: 10, - startAt: 100 - } - }); - expect(observable.subscribe).toThrowError(); - }); - - it('should throw an error if endAt is used with equalTo', () => { - - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByChild: 'height', - equalTo: 10, - endAt: 100 - } - }); - expect(observable.subscribe).toThrowError(); - }); - - it('should throw an error if startAt and endAt is used with equalTo', () => { - - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByChild: 'height', - equalTo: 10, - endAt: 100, - startAt: 103 - } - }); - expect(observable.subscribe).toThrowError(); - }); - - }); - - describe('orderByValue', () => { - /* - orderByValue combinations - ---------------------- - orderByValue("").equalTo() - orderByValue("").startAt() - orderByValue("").startAt().endAt(); - orderByValue("").endAt(); - */ - it('equalTo - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByValue: true, - equalTo: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('startAt - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByValue: true, - startAt: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('endAt - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByValue: true, - endAt: subject - } - }); - - queryTest(observable, subject, done); - }); - - }); - - describe('orderByKey', () => { - /* - orderByKey combinations - ---------------------- - orderByKey("").equalTo() - orderByKey("").startAt() - orderByKey("").startAt().endAt(); - orderByKey("").endAt(); - */ - it('equalTo - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByKey: true, - equalTo: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('startAt - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByKey: true, - startAt: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('endAt - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByKey: true, - endAt: subject - } - }); - - queryTest(observable, subject, done); - }); - }); - - describe('orderByPriority', () => { - /* - orderByPriority combinations - ---------------------- - orderByPriority("").equalTo() - orderByPriority("").startAt() - orderByPriority("").startAt().endAt(); - orderByPriority("").endAt(); - */ - it('equalTo - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByKey: true, - equalTo: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('startAt - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByKey: true, - startAt: subject - } - }); - - queryTest(observable, subject, done); - }); - - it('endAt - should re-run a query when the observable value has emitted', (done: any) => { - - const subject = new Subject(); - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByKey: true, - endAt: subject - } - }); - - queryTest(observable, subject, done); - }); - }); - - }); - - describe('shape', () => { - - it('should have a a FirebaseListObservable shape when queried', () => { - const observable = FirebaseListFactory(app.database().ref(questionsPath), { - query: { - orderByChild: 'height', - equalTo: '1' - } - }); - - expect(observable.push instanceof Function).toBe(true); - expect(observable.update instanceof Function).toBe(true); - expect(observable.remove instanceof Function).toBe(true); - }); - }); - - describe('methods', () => { - - let toKey; - let val1: any; - let val2: any; - let val3: any; - let questions: FirebaseListObservable; - let questionsSnapshotted: FirebaseListObservable; - let ref: any; - let refSnapshotted: any; - let subscription: Subscription; - - beforeEach((done: any) => { - toKey = (val) => val.key; - val1 = { key: 'key1' }; - val2 = { key: 'key2' }; - val3 = { key: 'key3' }; - app.database().ref().remove(done); - questions = FirebaseListFactory(app.database().ref(`questions`)); - questionsSnapshotted = FirebaseListFactory(app.database().ref(`questionssnapshot`), { preserveSnapshot: true }); - ref = questions.$ref; - refSnapshotted = questionsSnapshotted.$ref; - }); - - - afterEach((done: any) => { - if (subscription && !subscription.closed) { - subscription.unsubscribe(); - } - Promise.all([ref.remove(), refSnapshotted.remove()]).then(done, done.fail); - }); - - - it('should emit only when the initial data set has been loaded', (done: any) => { - questions.$ref.ref.set([{ initial1: true }, { initial2: true }, { initial3: true }, { initial4: true }]) - .then(() => toPromise.call(skipAndTake(questions, 1))) - .then((val: any[]) => { - expect(val.length).toBe(4); - }) - .then(() => { - done(); - }, done.fail); - }); - - - it('should be resistant to non-asynchronous child_added quirks', (done: any) => { - - // If push is called (or set or update, too, I guess) immediately after - // an on or once listener is added, it appears that the on or once - // child_added listeners are invoked immediately - i.e. not - // asynchronously - and the list implementation needs to support that. - - questions.$ref.ref.push({ number: 1 }) - .then(() => { - let calls = []; - questions.$ref.ref.once('child_added', (snap) => calls.push('child_added:' + snap.val().number)); - skipAndTake(questions).subscribe( - (list) => { - expect(calls).toEqual(['child_added:2', 'pushed']); - expect(list.map(i => i.number)).toEqual([1, 2]); - done(); - }, - done.fail - ); - questions.push({ number: 2 }); - calls.push('pushed'); - }) - .catch(done.fail); - }); - - - it('should emit a new value when a child moves', (done: any) => { - let question = skipAndTake(questions, 1, 2) - subscription = _do.call(question, (data: any) => { - expect(data.length).toBe(2); - expect(data[0].push2).toBe(true); - expect(data[1].push1).toBe(true); - }) - .subscribe(() => { - done(); - }, done.fail); - - let child1 = ref.push({ push1: true }, () => { - ref.push({ push2: true }, () => { - child1.setPriority('ZZZZ') - }); - }); - }); - - - it('should emit unwrapped data by default', (done: any) => { - ref.remove(() => { - ref.push({ unwrapped: true }, () => { - subscription = _do.call(skipAndTake(questions, 1), (data: any) => { - expect(data.length).toBe(1); - expect(data[0].unwrapped).toBe(true); - }) - .subscribe(() => { - done(); - }, done.fail); - }); - }); - }); - - - it('should emit snapshots if preserveSnapshot option is true', (done: any) => { - refSnapshotted.push('hello snapshot!', () => { - subscription = _do.call(skipAndTake(questionsSnapshotted, 1),(data: any) => { - expect(data[0].val()).toEqual('hello snapshot!'); - }) - .subscribe(() => { - done(); - }, done.fail); - }); - }); - - - it('should re-emit identical instances of unchanged children', (done: any) => { - - let prev; - - take.call(questions, 2).subscribe( - (list) => { - if (prev) { - expect(list[0]).toBe(prev[0]); - done(); - } else { - prev = list; - questions.push({ name: 'bob' }); - } - }, - done.fail - ); - questions.push({ name: 'alice' }); - }); - - - it('should re-emit identical instances of unchanged children as snapshots', (done: any) => { - - let prev; - - take.call(questionsSnapshotted, 2).subscribe( - (list) => { - if (prev) { - expect(list[0]).toBe(prev[0]); - done(); - } else { - prev = list; - questionsSnapshotted.push({ name: 'bob' }); - } - }, - done.fail - ); - questionsSnapshotted.push({ name: 'alice' }); - }); - - - it('should support null for equalTo queries', (done: any) => { - - questions.$ref.ref.set({ - val1, - val2: Object.assign({}, val2, { extra: true }), - val3: Object.assign({}, val3, { extra: true }), - }) - .then(() => { - - let query = FirebaseListFactory(questions.$ref.ref, { - query: { - orderByChild: "extra", - equalTo: null - } - }); - - take.call(query, 1).subscribe( - (list) => { - expect(list.length).toEqual(1); - expect(list[0].$key).toEqual("val1"); - done(); - }, - done.fail - ); - }); - }); - - - it('should support null for startAt/endAt queries', (done: any) => { - - questions.$ref.ref.set({ - val1, - val2: Object.assign({}, val2, { extra: true }), - val3: Object.assign({}, val3, { extra: true }), - }) - .then(() => { - - let query = FirebaseListFactory(questions.$ref.ref, { - query: { - orderByChild: "extra", - startAt: null, - endAt: null - } - }); - - take.call(query, 1).subscribe( - (list) => { - expect(list.length).toEqual(1); - expect(list[0].$key).toEqual("val1"); - done(); - }, - done.fail - ); - }); - }); - - - it('should call off on all events when disposed', (done: any) => { - const questionRef = app.database().ref().child('questions'); - let firebaseSpy = spyOn(questionRef, 'off').and.callThrough(); - subscription = FirebaseListFactory(questionRef).subscribe(_ => { - expect(firebaseSpy).not.toHaveBeenCalled(); - subscription.unsubscribe(); - expect(firebaseSpy).toHaveBeenCalled(); - done(); - }); - }); - - - describe('onChildAdded', () => { - - it('should add the child after the prevKey', () => { - expect(onChildAdded([val1, val2], val3, toKey, 'key1')).toEqual([val1, val3, val2]); - }); - - - it('should not mutate the input array', () => { - let inputArr = [val1]; - expect(onChildAdded(inputArr, val2, toKey, 'key1')).not.toEqual(inputArr); - }); - }); - - - describe('onChildChanged', () => { - - it('should move the child after the specified prevKey', () => { - expect(onChildChanged([val1, val2], val1, toKey, 'key2')).toEqual([val2, val1]); - }); - - - it('should move the child to the beginning if prevKey is null', () => { - expect( - onChildChanged([val1, val2, val3], val2, toKey, null) - ).toEqual([val2, val1, val3]); - }); - - it('should not duplicate the first item if it is the one that changed', () => { - expect( - onChildChanged([val1, val2, val3], val1, toKey, null) - ).not.toEqual([val1, val1, val2, val3]); - }); - - it('should not mutate the input array', () => { - let inputArr = [val1, val2]; - expect(onChildChanged(inputArr, val1, toKey, 'key2')).not.toEqual(inputArr); - }); - - - it('should update the child', () => { - expect( - onChildUpdated([val1, val2, val3], { key: 'newkey' }, toKey, 'key1').map(v => v.key) - ).toEqual(['key1', 'newkey', 'key3']); - }); - }); - - - describe('onChildRemoved', () => { - - it('should remove the child', () => { - expect( - onChildRemoved([val1, val2, val3], val2, toKey) - ).toEqual([val1, val3]); - }); - }); - - - describe('utils.unwrapMapFn', () => { - let val = { unwrapped: true }; - let snapshot = { - ref: { key: 'key' }, - val: () => val - }; - - it('should return an object value with a $key property', () => { - const unwrapped = utils.unwrapMapFn(snapshot as firebase.database.DataSnapshot); - expect(unwrapped.$key).toEqual(snapshot.ref.key); - }); - - it('should return an object value with a $value property if value is scalar', () => { - const existsFn = () => { return true; } - const unwrappedValue5 = utils.unwrapMapFn(Object.assign(snapshot, { val: () => 5, exists: existsFn }) as firebase.database.DataSnapshot); - const unwrappedValueFalse = utils.unwrapMapFn(Object.assign(snapshot, { val: () => false, exists: existsFn }) as firebase.database.DataSnapshot); - const unwrappedValueLol = utils.unwrapMapFn(Object.assign(snapshot, { val: () => 'lol', exists: existsFn }) as firebase.database.DataSnapshot); - - expect(unwrappedValue5.$key).toEqual('key'); - expect(unwrappedValue5.$value).toEqual(5); - expect(unwrappedValue5.$exists()).toEqual(true); - - expect(unwrappedValueFalse.$key).toEqual('key'); - expect(unwrappedValueFalse.$value).toEqual(false); - expect(unwrappedValueFalse.$exists()).toEqual(true); - - expect(unwrappedValueLol.$key).toEqual('key'); - expect(unwrappedValueLol.$value).toEqual('lol'); - expect(unwrappedValueLol.$exists()).toEqual(true); - }); - }); - - it('should emit values in the observable creation zone', (done: any) => { - Zone.current.fork({ - name: 'newZone' - }) - .run(() => { - // Creating a new observable so that the current zone is captured. - subscription = FirebaseListFactory(app.database().ref(`questions`)) - .filter(d => d - .map(v => v.$value) - .indexOf('in-the-zone') > -1) - .subscribe(data => { - expect(Zone.current.name).toBe('newZone'); - done(); - }); - }); - - ref.remove(() => { - ref.push('in-the-zone'); - }); - }); - - describe('Removing and replacing a child key', () => { - const firstKey = 'index1'; - const middleKey = 'index2'; - const lastKey = 'index3'; - const initialData = { - [firstKey]: true, - [middleKey]: true, - [lastKey]: true, - }; - let keyToRemove: string; - - afterEach((done: any) => { - subscription = questions - .skip(2) - .take(1) - .subscribe((items: any[]) => { - expect(items.length).toBe(3); - done(); - }, done.fail); - questions.$ref.ref.set(initialData) - .then(() => ref.child(keyToRemove).remove()) - .then(() => ref.child(keyToRemove).set(true)); - }); - - it('should work with the first item in the list', () => { - keyToRemove = firstKey; - }); - - it('should work with the middle item in the list', () => { - keyToRemove = middleKey; - }); - - it('should work with the last item in the list', () => { - keyToRemove = lastKey; - }); - }); - - describe('startAt(value, key)', () => { - - it('should support the optional key parameter to startAt', (done) => { - - questions.$ref.ref.set({ - val1: Object.assign({}, val1, { data: 0 }), - val2: Object.assign({}, val2, { data: 0 }), - val3: Object.assign({}, val3, { data: 0 }) - }) - .then(() => { - - let query1 = FirebaseListFactory(app.database().ref(`questions`), { - query: { - orderByChild: 'data', - startAt: { value: 0 } - } - }); - let promise1 = toPromise.call(take.call(query1, 1)); - - let query2 = FirebaseListFactory(app.database().ref(`questions`), { - query: { - orderByChild: 'data', - startAt: { value: 0, key: 'val2' } - } - }); - let promise2 = toPromise.call(take.call(query2, 1)); - - Promise.all([promise1, promise2]).then(([list1, list2]) => { - expect(list1.map(i => i.$key)).toEqual(['val1', 'val2', 'val3']); - expect(list2.map(i => i.$key)).toEqual(['val2', 'val3']); - done(); - }); - }) - .catch(done.fail); - }); - - }); - - describe('equalTo(value, key)', () => { - - it('should support the optional key parameter to equalTo', (done) => { - - questions.$ref.ref.set({ - val1: Object.assign({}, val1, { data: 0 }), - val2: Object.assign({}, val2, { data: 0 }), - val3: Object.assign({}, val3, { data: 0 }) - }) - .then(() => { - - let query1 = FirebaseListFactory(app.database().ref(`questions`), { - query: { - orderByChild: 'data', - equalTo: { value: 0 } - } - }); - let promise1 = toPromise.call(take.call(query1, 1)); - - let query2 = FirebaseListFactory(app.database().ref(`questions`), { - query: { - orderByChild: 'data', - equalTo: { value: 0, key: 'val2' } - } - }); - let promise2 = toPromise.call(take.call(query2, 1)); - - Promise.all([promise1, promise2]).then(([list1, list2]) => { - expect(list1.map(i => i.$key)).toEqual(['val1', 'val2', 'val3']); - expect(list2.map(i => i.$key)).toEqual(['val2']); - done(); - }); - }) - .catch(done.fail); - }); - - }); - - describe('endAt(value, key)', () => { - - it('should support the optional key parameter to endAt', (done) => { - - questions.$ref.ref.set({ - val1: Object.assign({}, val1, { data: 0 }), - val2: Object.assign({}, val2, { data: 0 }), - val3: Object.assign({}, val3, { data: 0 }) - }) - .then(() => { - - let query1 = FirebaseListFactory(app.database().ref(`questions`), { - query: { - orderByChild: 'data', - endAt: { value: 0 } - } - }); - let promise1 = toPromise.call(take.call(query1, 1)); - - let query2 = FirebaseListFactory(app.database().ref(`questions`), { - query: { - orderByChild: 'data', - endAt: { value: 0, key: 'val2' } - } - }); - let promise2 = toPromise.call(take.call(query2, 1)); - - Promise.all([promise1, promise2]).then(([list1, list2]) => { - expect(list1.map(i => i.$key)).toEqual(['val1', 'val2', 'val3']); - expect(list2.map(i => i.$key)).toEqual(['val1', 'val2']); - done(); - }); - }) - .catch(done.fail); - }); - - }); - - describe('observable queries (issue #830)', () => { - - it('should not emit the results of previous queries', (done) => { - - questions.$ref.ref.set({ - key1: { even: false, value: 1 }, - key2: { even: true, value: 2 } - }) - .then(() => { - - let subject = new Subject(); - let query = FirebaseListFactory(app.database().ref(`questions`), { - query: { - orderByChild: 'even', - equalTo: subject - } - }); - - query = map.call(query, (list, index) => { - switch (index) { - case 0: - subject.next(true); - break; - case 1: - questions.$ref.ref.update({ - key3: { even: false, value: 3 }, - key4: { even: true, value: 4 } - }); - break; - default: - break; - } - return list; - }); - query = take.call(query, 3); - query = toArray.call(query); - - toPromise.call(query).then((emits) => { - expect(emits.map(e => e.map(i => i.$key))).toEqual([ - ['key1'], - ['key2'], - ['key2', 'key4'] - ]); - done(); - }); - - subject.next(false); - }) - .catch(done.fail); - }); - - }); - - }); -}); - -function skipAndTake(obs: Observable, takeCount: number = 1, skipCount: number = 0) { - return take.call(skip.call(obs, skipCount), takeCount); -} diff --git a/src/database/firebase_list_factory.ts b/src/database/firebase_list_factory.ts deleted file mode 100644 index d4df06b7a..000000000 --- a/src/database/firebase_list_factory.ts +++ /dev/null @@ -1,242 +0,0 @@ -import * as firebase from 'firebase/app'; -import * as utils from '../utils'; -import 'firebase/database'; -import { AFUnwrappedDataSnapshot } from '../interfaces'; -import { FirebaseListObservable } from './firebase_list_observable'; -import { Observer } from 'rxjs/Observer'; -import { observeOn } from 'rxjs/operator/observeOn'; -import { observeQuery } from './query_observable'; -import { Query, FirebaseListFactoryOpts, DatabaseReference, DatabaseQuery } from '../interfaces'; -import { switchMap } from 'rxjs/operator/switchMap'; -import { map } from 'rxjs/operator/map'; - -export function FirebaseListFactory ( - ref: DatabaseReference, - { preserveSnapshot, query = {} } :FirebaseListFactoryOpts = {}): FirebaseListObservable { - - if (utils.isEmptyObject(query)) { - return firebaseListObservable(ref, { preserveSnapshot }); - } - - const queryObs = observeQuery(query); - return new FirebaseListObservable(ref, subscriber => { - let sub = switchMap.call(map.call(queryObs, query => { - let queried: DatabaseQuery = ref; - // Only apply the populated keys - // apply ordering and available querying options - // eg: ref.orderByChild('height').startAt(3) - // Check orderBy - if (query.orderByChild) { - queried = queried.orderByChild(query.orderByChild); - } else if (query.orderByKey) { - queried = queried.orderByKey(); - } else if (query.orderByPriority) { - queried = queried.orderByPriority(); - } else if (query.orderByValue) { - queried = queried.orderByValue(); - } - - // check equalTo - if (utils.hasKey(query, "equalTo")) { - if (utils.hasKey(query.equalTo, "value")) { - queried = queried.equalTo(query.equalTo.value, query.equalTo.key); - } else { - queried = queried.equalTo(query.equalTo); - } - - if (utils.hasKey(query, "startAt") || utils.hasKey(query, "endAt")) { - throw new Error('Query Error: Cannot use startAt or endAt with equalTo.'); - } - - // apply limitTos - if (!utils.isNil(query.limitToFirst)) { - queried = queried.limitToFirst(query.limitToFirst); - } - - if (!utils.isNil(query.limitToLast)) { - queried = queried.limitToLast(query.limitToLast); - } - - return queried; - } - - // check startAt - if (utils.hasKey(query, "startAt")) { - if (utils.hasKey(query.startAt, "value")) { - queried = queried.startAt(query.startAt.value, query.startAt.key); - } else { - queried = queried.startAt(query.startAt); - } - } - - if (utils.hasKey(query, "endAt")) { - if (utils.hasKey(query.endAt, "value")) { - queried = queried.endAt(query.endAt.value, query.endAt.key); - } else { - queried = queried.endAt(query.endAt); - } - } - - if (!utils.isNil(query.limitToFirst) && query.limitToLast) { - throw new Error('Query Error: Cannot use limitToFirst with limitToLast.'); - } - - // apply limitTos - if (!utils.isNil(query.limitToFirst)) { - queried = queried.limitToFirst(query.limitToFirst); - } - - if (!utils.isNil(query.limitToLast)) { - queried = queried.limitToLast(query.limitToLast); - } - - return queried; - }), (queryRef: firebase.database.Reference, ix: number) => { - return firebaseListObservable(queryRef, { preserveSnapshot }); - }) - .subscribe(subscriber); - - return () => sub.unsubscribe(); - }); -} - -/** - * Creates a FirebaseListObservable from a reference or query. Options can be provided as a second - * parameter. This function understands the nuances of the Firebase SDK event ordering and other - * quirks. This function takes into account that not all .on() callbacks are guaranteed to be - * asynchonous. It creates a initial array from a promise of ref.once('value'), and then starts - * listening to child events. When the initial array is loaded, the observable starts emitting values. - */ -function firebaseListObservable(ref: firebase.database.Reference | DatabaseQuery, {preserveSnapshot}: FirebaseListFactoryOpts = {}): FirebaseListObservable { - - const toValue = preserveSnapshot ? (snapshot => snapshot) : utils.unwrapMapFn; - const toKey = preserveSnapshot ? (value => value.key) : (value => value.$key); - - const listObs = new FirebaseListObservable(ref, (obs: Observer) => { - - // Keep track of callback handles for calling ref.off(event, handle) - const handles = []; - let hasLoaded = false; - let lastLoadedKey: string = null; - let array = []; - - // The list children are always added to, removed from and changed within - // the array using the child_added/removed/changed events. The value event - // is only used to determine when the initial load is complete. - - ref.once('value', (snap: any) => { - if (snap.exists()) { - snap.forEach((child: any) => { - lastLoadedKey = child.key; - }); - if (array.find((child: any) => toKey(child) === lastLoadedKey)) { - hasLoaded = true; - obs.next(array); - } - } else { - hasLoaded = true; - obs.next(array); - } - }, err => { - if (err) { obs.error(err); obs.complete(); } - }); - - const addFn = ref.on('child_added', (child: any, prevKey: string) => { - array = onChildAdded(array, toValue(child), toKey, prevKey); - if (hasLoaded) { - obs.next(array); - } else if (child.key === lastLoadedKey) { - hasLoaded = true; - obs.next(array); - } - }, err => { - if (err) { obs.error(err); obs.complete(); } - }); - handles.push({ event: 'child_added', handle: addFn }); - - let remFn = ref.on('child_removed', (child: any) => { - array = onChildRemoved(array, toValue(child), toKey); - if (hasLoaded) { - obs.next(array); - } - }, err => { - if (err) { obs.error(err); obs.complete(); } - }); - handles.push({ event: 'child_removed', handle: remFn }); - - let chgFn = ref.on('child_changed', (child: any, prevKey: string) => { - array = onChildChanged(array, toValue(child), toKey, prevKey); - if (hasLoaded) { - obs.next(array); - } - }, err => { - if (err) { obs.error(err); obs.complete(); } - }); - handles.push({ event: 'child_changed', handle: chgFn }); - - return () => { - // Loop through callback handles and dispose of each event with handle - // The Firebase SDK requires the reference, event name, and callback to - // properly unsubscribe, otherwise it can affect other subscriptions. - handles.forEach(item => { - ref.off(item.event, item.handle); - }); - }; - - }); - - // TODO: should be in the subscription zone instead - return observeOn.call(listObs, new utils.ZoneScheduler(Zone.current)); -} - -export function onChildAdded(arr:any[], child:any, toKey:(element:any)=>string, prevKey:string): any[] { - if (!arr.length) { - return [child]; - } - return arr.reduce((accumulator:firebase.database.DataSnapshot[], curr:firebase.database.DataSnapshot, i:number) => { - if (!prevKey && i===0) { - accumulator.push(child); - } - accumulator.push(curr); - if (prevKey && prevKey === toKey(curr)) { - accumulator.push(child); - } - return accumulator; - }, []); -} - -export function onChildChanged(arr:any[], child:any, toKey:(element:any)=>string, prevKey:string): any[] { - const childKey = toKey(child); - return arr.reduce((accumulator:any[], val:any, i:number) => { - const valKey = toKey(val); - if (!prevKey && i==0) { - accumulator.push(child); - if (valKey !== childKey) { - accumulator.push(val); - } - } else if(valKey === prevKey) { - accumulator.push(val); - accumulator.push(child); - } else if (valKey !== childKey) { - accumulator.push(val); - } - return accumulator; - }, []); -} - -export function onChildRemoved(arr:any[], child:any, toKey:(element:any)=>string): any[] { - let childKey = toKey(child); - return arr.filter(c => toKey(c) !== childKey); -} - -export function onChildUpdated(arr:any[], child:any, toKey:(element:any)=>string, prevKey:string): any[] { - return arr.map((v, i, arr) => { - if(!prevKey && !i) { - return child; - } else if (i > 0 && toKey(arr[i-1]) === prevKey) { - return child; - } else { - return v; - } - }); -} diff --git a/src/database/firebase_list_observable.spec.ts b/src/database/firebase_list_observable.spec.ts deleted file mode 100644 index fde98baca..000000000 --- a/src/database/firebase_list_observable.spec.ts +++ /dev/null @@ -1,228 +0,0 @@ -import { AngularFireDatabase } from './database'; -import { AngularFireDatabaseModule } from './database.module'; -import { FirebaseListObservable } from './firebase_list_observable'; -import { FirebaseObjectFactory } from './firebase_object_factory'; -import { Observer } from 'rxjs/Observer'; -import { map } from 'rxjs/operator/map'; -import * as firebase from 'firebase/app'; -import { unwrapMapFn } from '../utils'; -import { FirebaseApp, FirebaseAppConfig, AngularFireModule} from '../angularfire2'; -import { TestBed, inject } from '@angular/core/testing'; -import { COMMON_CONFIG } from '../test-config'; - -describe('FirebaseListObservable', () => { - let O: FirebaseListObservable; - let ref: firebase.database.Reference; - let app: firebase.app.App; - let db: AngularFireDatabase; - - beforeEach(() => { - TestBed.configureTestingModule({ - imports: [ - AngularFireModule.initializeApp(COMMON_CONFIG), - AngularFireDatabaseModule - ] - }); - inject([FirebaseApp, AngularFireDatabase], (_app: firebase.app.App, _db: AngularFireDatabase) => { - app = _app; - db = _db; - ref = firebase.database().ref(); - O = new FirebaseListObservable(ref, (observer:Observer) => { - }); - })(); - }); - - afterEach(done => { - app.delete().then(done, done.fail); - ref.off(); - ref.remove(done); - }); - - it('should return an instance of FirebaseObservable when calling operators', () => { - O = new FirebaseListObservable(ref, (observer:Observer) => { - }); - expect(map.call(O, noop) instanceof FirebaseListObservable).toBe(true); - }); - - describe('$ref', () => { - it('should match the database path passed in the constructor', () => { - expect(O.$ref.toString()).toEqual(ref.toString()); - }); - }); - - describe('push', () => { - it('should throw an exception if pushed when not subscribed', () => { - O = new FirebaseListObservable(null, (observer:Observer) => {}); - - expect(() => { - O.push('foo'); - }).toThrowError('No ref specified for this Observable!') - }); - - it('should resolve returned thenable when successful', (done:any) => { - O.push('foo').then(done, done.fail); - }); - }); - - describe('remove', () => { - let orphan = { orphan: true }; - let child:firebase.database.Reference; - - beforeEach(() => { - child = ref.push(orphan); - }); - - it('should remove the item from the Firebase db when given the key', (done:any) => { - let childAddedSpy = jasmine.createSpy('childAdded'); - - ref.on('child_added', childAddedSpy); - O.remove(child.key) - .then(() => (ref).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(childAddedSpy.calls.argsFor(0)[0].val()).toEqual(orphan); - expect(data.val()).toBeNull(); - ref.off(); - }) - .then(done, done.fail); - }); - - - it('should remove the item from the Firebase db when given the reference', (done:any) => { - let childAddedSpy = jasmine.createSpy('childAdded'); - - ref.on('child_added', childAddedSpy); - - O.remove(child) - .then(() => (ref).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(childAddedSpy.calls.argsFor(0)[0].val()).toEqual(orphan); - expect(data.val()).toBeNull(); - ref.off(); - }) - .then(done, done.fail); - }); - - - it('should remove the item from the Firebase db when given the snapshot', (done:any) => { - ref.on('child_added', (data:firebase.database.DataSnapshot) => { - expect(data.val()).toEqual(orphan); - O.remove(data) - .then(() => (ref).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(data.val()).toBeNull(); - ref.off(); - }) - .then(done, done.fail); - }); - }); - - - it('should remove the item from the Firebase db when given the unwrapped snapshot', (done:any) => { - ref.on('child_added', (data:firebase.database.DataSnapshot) => { - expect(data.val()).toEqual(orphan); - O.remove(unwrapMapFn(data)) - .then(() => (ref).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(data.val()).toBeNull(); - ref.off(); - }) - .then(done, done.fail); - }); - }); - - it('should remove the whole list if no item is added', () => { - O.remove() - .then(() => (ref).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(data.val()).toBe(null); - }); - }); - - - it('should throw an exception if input is not supported', () => { - let input = ({lol:true}); - expect(() => O.remove(input)).toThrowError(`Method requires a key, snapshot, reference, or unwrapped snapshot. Got: ${typeof input}`); - }) - }); - - describe('update', () => { - let orphan = { orphan: true }; - let child:firebase.database.Reference; - - beforeEach(() => { - child = ref.push(orphan); - }); - - it('should update the item from the Firebase db when given the key', (done:any) => { - let childChangedSpy = jasmine.createSpy('childChanged'); - const orphanChange = { changed: true } - ref.on('child_changed', childChangedSpy); - O.update(child.key, orphanChange) - .then(() => (ref).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(childChangedSpy.calls.argsFor(0)[0].val()).toEqual({ - orphan: true, - changed: true - }); - - ref.off(); - }) - .then(done, done.fail); - }); - - it('should update the item from the Firebase db when given the reference', (done:any) => { - let childChangedSpy = jasmine.createSpy('childChanged'); - const orphanChange = { changed: true } - ref.on('child_changed', childChangedSpy); - O.update(child.ref, orphanChange) - .then(() => (ref).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(childChangedSpy.calls.argsFor(0)[0].val()).toEqual({ - orphan: true, - changed: true - }); - - ref.off(); - }) - .then(done, done.fail); - }); - - it('should update the item from the Firebase db when given the snapshot', (done:any) => { - let childChangedSpy = jasmine.createSpy('childChanged'); - const orphanChange = { changed: true } - ref.on('child_changed', childChangedSpy); - O.update(child, orphanChange) - .then(() => (ref).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(childChangedSpy.calls.argsFor(0)[0].val()).toEqual({ - orphan: true, - changed: true - }); - - ref.off(); - }) - .then(done, done.fail); - }); - - it('should update the item from the Firebase db when given the unwrapped snapshot', (done:any) => { - const orphanChange = { changed: true } - ref.on('child_added', (data:firebase.database.DataSnapshot) => { - expect(data.val()).toEqual(orphan); - O.update(unwrapMapFn(data), orphanChange) - .then(() => (child).once('value')) - .then((data:firebase.database.DataSnapshot) => { - expect(data.val()).toEqual({ - orphan: true, - changed: true - }); - ref.off(); - }) - .then(done, done.fail); - }); - }); - - }); - -}); - -function noop() {} diff --git a/src/database/firebase_list_observable.ts b/src/database/firebase_list_observable.ts deleted file mode 100644 index 90668ff39..000000000 --- a/src/database/firebase_list_observable.ts +++ /dev/null @@ -1,66 +0,0 @@ -import { Observable } from 'rxjs/Observable'; -import { Operator } from 'rxjs/Operator'; -import { Subscriber } from 'rxjs/Subscriber'; -import { Subscription } from 'rxjs/Subscription'; -import * as firebase from 'firebase/app'; -import 'firebase/database'; -import * as utils from '../utils'; -import { AFUnwrappedDataSnapshot, FirebaseOperationCases, QueryReference, DatabaseSnapshot, DatabaseReference } from '../interfaces'; - -export type FirebaseOperation = string | firebase.database.Reference | firebase.database.DataSnapshot | AFUnwrappedDataSnapshot; - -export class FirebaseListObservable extends Observable { - constructor(public $ref: QueryReference, subscribe?: (subscriber: Subscriber) => Subscription | Function | void) { - super(subscribe); - } - lift(operator: Operator): Observable { - const observable = new FirebaseListObservable(this.$ref); - observable.source = this; - observable.operator = operator; - observable.$ref = this.$ref; - return observable; - } - - push(val:any):firebase.database.ThenableReference { - if(!this.$ref) { - throw new Error('No ref specified for this Observable!'); - } - return this.$ref.ref.push(val); - } - - update(item: FirebaseOperation, value: Object): firebase.Promise { - return this._checkOperationCases(item, { - stringCase: () => this.$ref.ref.child(item).update(value), - firebaseCase: () => (item).update(value), - snapshotCase: () => (item).ref.update(value), - unwrappedSnapshotCase: () => this.$ref.ref.child((item).$key).update(value) - }); - } - - remove(item?:FirebaseOperation): firebase.Promise { - // if no item parameter is provided, remove the whole list - if (!item) { - return this.$ref.ref.remove(); - } - return this._checkOperationCases(item, { - stringCase: () => this.$ref.ref.child(item).remove(), - firebaseCase: () => (item).remove(), - snapshotCase: () => (item).ref.remove(), - unwrappedSnapshotCase: () => this.$ref.ref.child((item).$key).remove() - }); - } - - _checkOperationCases(item: FirebaseOperation, cases: FirebaseOperationCases) : firebase.Promise { - if (utils.isString(item)) { - return cases.stringCase(); - } else if (utils.isFirebaseRef(item)) { - return cases.firebaseCase(); - } else if (utils.isFirebaseDataSnapshot(item)) { - return cases.snapshotCase(); - } else if (utils.isAFUnwrappedSnapshot(item)) { - return cases.unwrappedSnapshotCase() - } - throw new Error(`Method requires a key, snapshot, reference, or unwrapped snapshot. Got: ${typeof item}`); - } - -} diff --git a/src/database/firebase_object_factory.spec.ts b/src/database/firebase_object_factory.spec.ts deleted file mode 100644 index d03a90e0f..000000000 --- a/src/database/firebase_object_factory.spec.ts +++ /dev/null @@ -1,150 +0,0 @@ -import * as firebase from 'firebase/app'; -import { Subscription } from 'rxjs'; -import { AngularFireDatabase } from './database'; -import { AngularFireDatabaseModule } from './database.module'; -import { FirebaseObjectObservable } from './firebase_object_observable'; -import { FirebaseObjectFactory } from './firebase_object_factory'; -import { TestBed, inject } from '@angular/core/testing'; -import { FirebaseApp, FirebaseAppConfig, AngularFireModule } from '../angularfire2'; -import { COMMON_CONFIG } from '../test-config'; - -describe('FirebaseObjectFactory', () => { - let i = 0; - let ref: firebase.database.Reference; - let observable: FirebaseObjectObservable; - let subscription: Subscription; - let nextSpy: jasmine.Spy; - let app: firebase.app.App; - let db: AngularFireDatabase; - - beforeEach(() => { - TestBed.configureTestingModule({ - imports: [ - AngularFireModule.initializeApp(COMMON_CONFIG, '[DEFAULT]'), - AngularFireDatabaseModule - ] - }); - inject([FirebaseApp, AngularFireDatabase], (app_: FirebaseApp, _db: AngularFireDatabase) => { - app = app_; - db = _db; - })(); - }); - - afterEach(done => { - app.delete().then(done, done.fail); - }); - - describe('', () => { - - it('should accept a Firebase db ref in the constructor', () => { - const object = FirebaseObjectFactory(app.database().ref().child(`questions`)); - expect(object instanceof FirebaseObjectObservable).toBe(true); - }); - - }); - - describe('methods', () => { - - beforeEach((done: any) => { - i = Date.now(); - ref = app.database().ref().child(`questions/${i}`); - nextSpy = nextSpy = jasmine.createSpy('next'); - observable = FirebaseObjectFactory(app.database().ref(`questions/${i}`)); - ref.remove(done); - }); - - afterEach(() => { - if (subscription && !subscription.closed) { - subscription.unsubscribe(); - } - }); - - - it('should emit a null value if no value is present when subscribed', (done: any) => { - subscription = observable.subscribe(unwrapped => { - const expectedObject = { $key: (observable).$ref.key, $value: null }; - expect(unwrapped.$key).toEqual(expectedObject.$key); - expect(unwrapped.$value).toEqual(expectedObject.$value); - expect(unwrapped.$exists()).toEqual(false); - done(); - }); - }); - - - it('should emit unwrapped data by default', (done: any) => { - const fixtureData = { data: 'bar' }; - ref.set(fixtureData, () => { - subscription = observable.subscribe(unwrapped => { - if (!unwrapped) return; - expect(unwrapped.$key).toEqual(ref.key); - expect(unwrapped).toEqual(fixtureData); - expect(unwrapped.$exists()).toEqual(true); - done(); - }); - }); - }); - - it('should emit unwrapped data with $ properties for primitive values', (done: any) => { - ref.set('fiiiireeee', () => { - subscription = observable.subscribe(val => { - if (!val) return; - expect(val.$key).toEqual(ref.key); - expect(val.$value).toEqual('fiiiireeee'); - expect(val.$exists()).toEqual(true); - done(); - }); - }); - }); - - it('should emit null for $ properties for primitive values', (done: any) => { - subscription = observable.subscribe(val => { - if (!val) return; - expect(val.$key).toEqual(ref.key); - expect(val.$value).toEqual(null); - expect(val.$exists()).toEqual(false); - done(); - }); - }); - - it('should emit snapshots if preserveSnapshot option is true', (done: any) => { - observable = FirebaseObjectFactory(app.database().ref(`questions/${i}`), { preserveSnapshot: true }); - ref.remove(() => { - ref.set('preserved snapshot!', () => { - subscription = observable.subscribe(data => { - expect(data.val()).toEqual('preserved snapshot!'); - done(); - }); - }); - }) - }); - - - it('should call off on all events when disposed', () => { - const dbRef = app.database().ref(); - let firebaseSpy = spyOn(dbRef, 'off'); - subscription = FirebaseObjectFactory(dbRef).subscribe(); - expect(firebaseSpy).not.toHaveBeenCalled(); - subscription.unsubscribe(); - expect(firebaseSpy).toHaveBeenCalled(); - }); - - it('should emit values in the observable creation zone', (done: any) => { - Zone.current.fork({ - name: 'newZone' - }) - .run(() => { - // Creating a new observable so that the current zone is captured. - subscription = FirebaseObjectFactory(app.database().ref(`questions/${i}`)) - .filter(d => d.$value === 'in-the-zone') - .subscribe(data => { - expect(Zone.current.name).toBe('newZone'); - done(); - }); - }); - - ref.remove(() => { - ref.set('in-the-zone'); - }); - }); - }); -}); diff --git a/src/database/firebase_object_factory.ts b/src/database/firebase_object_factory.ts deleted file mode 100644 index fb716c061..000000000 --- a/src/database/firebase_object_factory.ts +++ /dev/null @@ -1,25 +0,0 @@ -import { FirebaseObjectObservable } from './firebase_object_observable'; -import { Observer } from 'rxjs/Observer'; -import { observeOn } from 'rxjs/operator/observeOn'; -import * as firebase from 'firebase/app'; -import 'firebase/database'; -import * as utils from '../utils'; -import { FirebaseObjectFactoryOpts, DatabaseReference } from '../interfaces'; - -export function FirebaseObjectFactory ( - ref: DatabaseReference, - { preserveSnapshot }: FirebaseObjectFactoryOpts = {}): FirebaseObjectObservable { - - const objectObservable = new FirebaseObjectObservable((obs: Observer) => { - let fn = ref.on('value', (snapshot: firebase.database.DataSnapshot) => { - obs.next(preserveSnapshot ? snapshot : utils.unwrapMapFn(snapshot)) - }, err => { - if (err) { obs.error(err); obs.complete(); } - }); - - return () => ref.off('value', fn); - }, ref); - - // TODO: should be in the subscription zone instead - return observeOn.call(objectObservable, new utils.ZoneScheduler(Zone.current)); -} diff --git a/src/database/firebase_object_observable.spec.ts b/src/database/firebase_object_observable.spec.ts deleted file mode 100644 index ed8ef037a..000000000 --- a/src/database/firebase_object_observable.spec.ts +++ /dev/null @@ -1,135 +0,0 @@ -import { TestBed, inject } from '@angular/core/testing'; -import { FirebaseApp, FirebaseAppConfig, AngularFireModule } from '../angularfire2'; -import { COMMON_CONFIG } from '../test-config'; -import { AngularFireDatabase } from './database'; -import { AngularFireDatabaseModule } from './database.module'; -import { FirebaseObjectObservable } from './firebase_object_observable'; -import { Observer } from 'rxjs/Observer'; -import { map } from 'rxjs/operator/map'; -import * as firebase from 'firebase/app'; - -describe('FirebaseObjectObservable', () => { - - let O: FirebaseObjectObservable; - let ref: firebase.database.Reference; - let app: firebase.app.App; - let db: AngularFireDatabase; - - beforeEach(() => { - TestBed.configureTestingModule({ - imports: [ - AngularFireModule.initializeApp(COMMON_CONFIG), - AngularFireDatabaseModule - ] - }); - inject([FirebaseApp, AngularFireDatabase], (_app: firebase.app.App, _db: AngularFireDatabase) => { - app = _app; - db = _db; - ref = firebase.database().ref(); - O = new FirebaseObjectObservable((observer: Observer) => { - }, ref); - })(); - }); - - afterEach(done => { - ref.off(); - ref.remove(); - app.delete().then(done, done.fail); - }); - - it('should return an instance of FirebaseObservable when calling operators', () => { - let O = new FirebaseObjectObservable((observer: Observer) => { }); - expect(map.call(O, noop) instanceof FirebaseObjectObservable).toBe(true); - }); - - describe('$ref', () => { - it('should match the database path passed in the constructor', () => { - expect(O.$ref.toString()).toEqual(ref.toString()); - }); - }); - - describe('set', () => { - - it('should call set on the underlying ref', (done: any) => { - let setSpy = spyOn(ref, 'set'); - - O.subscribe(); - O.set(1); - expect(setSpy).toHaveBeenCalledWith(1); - done(); - }); - - it('should throw an exception if set when not subscribed', () => { - O = new FirebaseObjectObservable((observer: Observer) => { }); - - expect(() => { - O.set('foo'); - }).toThrowError('No ref specified for this Observable!') - }); - - it('should accept any type of value without compilation error', () => { - O.set('foo'); - }); - - - it('should resolve returned thenable when successful', (done: any) => { - O.set('foo').then(done, done.fail); - }); - - }); - - describe('update', () => { - const updateObject = { hot: 'firebae' }; - it('should call update on the underlying ref', () => { - let updateSpy = spyOn(ref, 'update'); - - O.subscribe(); - O.update(updateObject); - expect(updateSpy).toHaveBeenCalledWith(updateObject); - }); - - it('should throw an exception if updated when not subscribed', () => { - O = new FirebaseObjectObservable((observer: Observer) => { }); - - expect(() => { - O.update(updateObject); - }).toThrowError('No ref specified for this Observable!') - }); - - it('should accept any type of value without compilation error', () => { - O.update(updateObject); - }); - - it('should resolve returned thenable when successful', (done: any) => { - O.update(updateObject).then(done, done.fail); - }); - - }); - - describe('remove', () => { - - it('should call remove on the underlying ref', () => { - let removeSpy = spyOn(ref, 'remove'); - - O.subscribe(); - O.remove(); - expect(removeSpy).toHaveBeenCalledWith(); - }); - - it('should throw an exception if removed when not subscribed', () => { - O = new FirebaseObjectObservable((observer: Observer) => { }); - - expect(() => { - O.remove(); - }).toThrowError('No ref specified for this Observable!') - }); - - it('should resolve returned thenable when successful', (done: any) => { - O.remove().then(done, done.fail); - }); - - }); - -}); - -function noop() { } diff --git a/src/database/firebase_object_observable.ts b/src/database/firebase_object_observable.ts deleted file mode 100644 index 6c06e528c..000000000 --- a/src/database/firebase_object_observable.ts +++ /dev/null @@ -1,37 +0,0 @@ -import { Observable } from 'rxjs/Observable'; -import { Operator } from 'rxjs/Operator'; -import { Subscriber } from 'rxjs/Subscriber'; -import { Subscription } from 'rxjs/Subscription'; -import * as firebase from 'firebase/app'; -import 'firebase/database'; - -export class FirebaseObjectObservable extends Observable { - constructor(subscribe?: (subscriber: Subscriber) => Subscription | Function | void, public $ref?:firebase.database.Reference) { - super(subscribe); - } - lift(operator: Operator): Observable { - const observable = new FirebaseObjectObservable(); - observable.source = this; - observable.operator = operator; - observable.$ref = this.$ref; - return observable; - } - set(value: any): firebase.Promise { - if(!this.$ref) { - throw new Error('No ref specified for this Observable!'); - } - return this.$ref.set(value); - } - update(value: Object): firebase.Promise { - if(!this.$ref) { - throw new Error('No ref specified for this Observable!'); - } - return this.$ref.update(value); - } - remove(): firebase.Promise { - if(!this.$ref) { - throw new Error('No ref specified for this Observable!'); - } - return this.$ref.remove(); - } -} diff --git a/src/database/ng-package.json b/src/database/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/database/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/database/package.json b/src/database/package.json index 65be0782f..8dce418a5 100644 --- a/src/database/package.json +++ b/src/database/package.json @@ -1 +1,3 @@ -{ "main": "../bundles/angularfire2.umd.js" } \ No newline at end of file +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/database/public_api.ts b/src/database/public_api.ts new file mode 100644 index 000000000..61543a242 --- /dev/null +++ b/src/database/public_api.ts @@ -0,0 +1,4 @@ +export { Database, DatabaseInstances, databaseInstance$ } from './database'; +export { provideDatabase, DatabaseModule } from './database.module'; +export * from './rxfire'; +export * from './firebase'; diff --git a/src/database/query_observable.spec.ts b/src/database/query_observable.spec.ts deleted file mode 100644 index 716a0a527..000000000 --- a/src/database/query_observable.spec.ts +++ /dev/null @@ -1,541 +0,0 @@ -import { Observable } from 'rxjs/Observable'; -import { Observer } from 'rxjs/Observer'; -import { Subject } from 'rxjs/Subject'; -import { Query, ScalarQuery } from '../interfaces'; -import { getOrderObservables, observeQuery } from './query_observable'; - -function scalarQueryTest(query: ScalarQuery, done: any) { - const queryObservable = observeQuery(query); - queryObservable.subscribe(result => { - expect(result).toEqual(query); - done(); - }); -} - -function observableQueryTest(query: Query, nextProp: any, done: any) { - const queryObservable = observeQuery(query); - const toMerge: any = {}; - queryObservable.subscribe(result => { - const merged = Object.assign(query, toMerge); - expect(result).toEqual(merged); - done(); - }); - Object.keys(nextProp).forEach(prop => { - query[prop].next(nextProp[prop]); - toMerge[prop] = nextProp[prop]; - }); -} - -describe('observeQuery', () => { - const resultQuery = { orderByKey: true, startAt: null, endAt: null, equalTo: null }; - - it('should return an observable', () => { - expect(observeQuery({}) instanceof Observable).toBe(true); - }); - - it('should immediately emit a query object if passed a POJO with only scalar values', () => { - let nextSpy = jasmine.createSpy('next'); - let completeSpy = jasmine.createSpy('complete'); - let query = { orderByChild: 'height', equalTo: 10 }; - let obs = observeQuery(query, false); - obs.subscribe(nextSpy, null, completeSpy); - expect(nextSpy).toHaveBeenCalledWith({ - orderByChild: 'height', - equalTo: 10 - }); - }); - - - it('should return null if called with no query', () => { - let nextSpy = jasmine.createSpy('next'); - let completeSpy = jasmine.createSpy('complete'); - let query:any = null; - let obs = observeQuery(query, false); - obs.subscribe(nextSpy, null, completeSpy); - expect(nextSpy).toHaveBeenCalledWith(null); - expect(completeSpy).toHaveBeenCalled(); - }); - - - it('should emit an updated query if an attached observable emits new value', () => { - let nextSpy = jasmine.createSpy('next'); - let completeSpy = jasmine.createSpy('complete'); - let query = { - orderByKey: new Subject() - }; - let obs = observeQuery(query, false); - let noOrderyQuery = { orderByKey: false }; - obs.subscribe(nextSpy, null, completeSpy); - query.orderByKey.next(true); - expect(nextSpy).toHaveBeenCalledWith({ orderByKey: true}); - nextSpy.calls.reset(); - expect(completeSpy).not.toHaveBeenCalled(); - query.orderByKey.next(false); - expect(nextSpy).toHaveBeenCalledWith(noOrderyQuery); - }); - - - it('should omit a key from the query if its observable emits null', () => { - let nextSpy = jasmine.createSpy('next'); - let completeSpy = jasmine.createSpy('complete'); - let query = { - orderByKey: new Subject() - }; - let obs = observeQuery(query, false); - obs.subscribe(nextSpy, null, completeSpy); - query.orderByKey.next(true); - expect(nextSpy).toHaveBeenCalledWith({ orderByKey: true }); - nextSpy.calls.reset(); - query.orderByKey.next(null); - expect(nextSpy).toHaveBeenCalledWith({}); - }); - - - it('should omit only the orderBy type of the last emitted orderBy observable', () => { - let nextSpy = jasmine.createSpy('next'); - let query = { - orderByKey: new Subject(), - orderByPriority: new Subject(), - orderByValue: new Subject(), - orderByChild: new Subject() - }; - let obs = observeQuery(query, false); - obs.subscribe(nextSpy); - query.orderByChild.next('height'); - expect(nextSpy).toHaveBeenCalledWith({ - orderByChild: 'height' - }); - nextSpy.calls.reset(); - query.orderByKey.next(true); - expect(nextSpy).toHaveBeenCalledWith({ - orderByKey: true - }); - nextSpy.calls.reset(); - query.orderByValue.next(true); - expect(nextSpy).toHaveBeenCalledWith({ - orderByValue: true - }); - nextSpy.calls.reset(); - query.orderByChild.next('foo'); - expect(nextSpy).toHaveBeenCalledWith({ - orderByChild: 'foo' - }); - }); -}); - - -describe('getOrderObservables', () => { - it('should be subscribable event if no observables found for orderby', () => { - let nextSpy = jasmine.createSpy('next'); - let obs = getOrderObservables({}); - obs.subscribe(nextSpy); - expect(nextSpy).toHaveBeenCalledWith(null); - }); -}); - - -describe('query combinations', () => { - - describe('orderByChild', () => { - /* - orderByChild combinations - ---------------------- - orderByChild("").equalTo() - orderByChild("").startAt() - orderByChild("").startAt().endAt(); - orderByChild("").endAt(); - */ - it('should build an equalTo query with scalar values', (done: any) => { - scalarQueryTest({ - orderByChild: 'height', - equalTo: 94 - }, done); - }); - - it('should build an equalTo query with an observable', (done: any) => { - const query = { - orderByChild: 'height', - equalTo: new Subject() - }; - observableQueryTest(query, { equalTo: 92 }, done); - }); - - it('should build a startAt query with scalar values', (done: any) => { - scalarQueryTest({ - orderByChild: 'height', - startAt: 94 - }, done); - }); - - it('should build a startAt query with an observable', (done: any) => { - const query = { - orderByChild: 'height', - startAt: new Subject() - }; - observableQueryTest(query, { startAt: 92 }, done); - }); - - it('should build a endAt query with scalar values', (done: any) => { - scalarQueryTest({ - orderByChild: 'height', - endAt: 94 - }, done); - }); - - it('should build a endAt query with an observable', (done: any) => { - const query = { - orderByChild: 'height', - endAt: new Subject() - }; - observableQueryTest(query, { endAt: 92 }, done); - }); - - it('should build a startAt().endAt() query with scalar values', (done: any) => { - scalarQueryTest({ - orderByChild: 'height', - startAt: 32, - endAt: 94 - }, done); - }); - - it('should build a startAt().endAt() query with an observable', (done: any) => { - const query = { - orderByChild: 'height', - endAt: new Subject(), - startAt: new Subject() - }; - observableQueryTest(query, { startAt: 32, endAt: 92 }, done); - }); - - }) - - describe('orderByKey', () => { - /* - orderByKey combinations - ---------------------- - orderByKey("").equalTo() - orderByKey("").startAt() - orderByKey("").startAt().endAt(); - orderByKey("").endAt(); - */ - it('should build an equalTo query with scalar values', (done: any) => { - scalarQueryTest({ - orderByKey: true, - equalTo: 94 - }, done); - }); - - it('should build an equalTo query with an observable', (done: any) => { - const query = { - orderByKey: true, - equalTo: new Subject() - }; - observableQueryTest(query, { equalTo: 92 }, done); - }); - - it('should build a startAt query with scalar values', (done: any) => { - scalarQueryTest({ - orderByKey: true, - startAt: 94 - }, done); - }); - - it('should build a startAt query with an observable', (done: any) => { - const query = { - orderByKey: true, - startAt: new Subject() - }; - observableQueryTest(query, { startAt: 92 }, done); - }); - - it('should build a endAt query with scalar values', (done: any) => { - scalarQueryTest({ - orderByKey: true, - endAt: 94 - }, done); - }); - - it('should build a endAt query with an observable', (done: any) => { - const query = { - orderByKey: true, - endAt: new Subject() - }; - observableQueryTest(query, { endAt: 92 }, done); - }); - - it('should build a startAt().endAt() query with scalar values', (done: any) => { - scalarQueryTest({ - orderByKey: true, - startAt: 32, - endAt: 94 - }, done); - }); - - it('should build a startAt().endAt() query with an observable', (done: any) => { - const query = { - orderByKey: true, - endAt: new Subject(), - startAt: new Subject() - }; - observableQueryTest(query, { startAt: 32, endAt: 92 }, done); - }); - - }); - - describe('orderByValue', () => { - /* - orderByValue combinations - ---------------------- - orderByValue("").equalTo() - orderByValue("").startAt() - orderByValue("").startAt().endAt(); - orderByValue("").endAt(); - */ - it('should build an equalTo query with scalar values', (done: any) => { - scalarQueryTest({ - orderByValue: true, - equalTo: 21 - }, done); - }); - - it('should build an equalTo query with an observable', (done: any) => { - const query = { - orderByValue: true, - equalTo: new Subject() - }; - observableQueryTest(query, { equalTo: 43 }, done); - }); - - it('should build a startAt query with scalar values', (done: any) => { - scalarQueryTest({ - orderByValue: true, - startAt: 25 - }, done); - }); - - it('should build a startAt query with an observable', (done: any) => { - const query = { - orderByValue: true, - startAt: new Subject() - }; - observableQueryTest(query, { startAt: 11 }, done); - }); - - it('should build a endAt query with scalar values', (done: any) => { - scalarQueryTest({ - orderByValue: true, - endAt: 94 - }, done); - }); - - it('should build a endAt query with an observable', (done: any) => { - const query = { - orderByValue: true, - endAt: new Subject() - }; - observableQueryTest(query, { endAt: 43 }, done); - }); - - it('should build a startAt().endAt() query with scalar values', (done: any) => { - scalarQueryTest({ - orderByValue: true, - startAt: 32, - endAt: 94 - }, done); - }); - - it('should build a startAt().endAt() query with an observable', (done: any) => { - const query = { - orderByValue: true, - endAt: new Subject(), - startAt: new Subject() - }; - observableQueryTest(query, { startAt: 7, endAt: 12 }, done); - }); - - }); - - describe('orderByPriority', () => { - /* - orderByPriority combinations - ---------------------- - orderByPriority("").equalTo() - orderByPriority("").startAt() - orderByPriority("").startAt().endAt(); - orderByPriority("").endAt(); - */ - it('should build an equalTo query with scalar values', (done: any) => { - scalarQueryTest({ - orderByPriority: true, - equalTo: 21 - }, done); - }); - - it('should build an equalTo query with an observable', (done: any) => { - const query = { - orderByPriority: true, - equalTo: new Subject() - }; - observableQueryTest(query, { equalTo: 43 }, done); - }); - - it('should build a startAt query with scalar values', (done: any) => { - scalarQueryTest({ - orderByPriority: true, - startAt: 25 - }, done); - }); - - it('should build a startAt query with an observable', (done: any) => { - const query = { - orderByPriority: true, - startAt: new Subject() - }; - observableQueryTest(query, { startAt: 11 }, done); - }); - - it('should build a endAt query with scalar values', (done: any) => { - scalarQueryTest({ - orderByPriority: true, - endAt: 94 - }, done); - }); - - it('should build a endAt query with an observable', (done: any) => { - const query = { - orderByPriority: true, - endAt: new Subject() - }; - observableQueryTest(query, { endAt: 43 }, done); - }); - - it('should build a startAt().endAt() query with scalar values', (done: any) => { - scalarQueryTest({ - orderByPriority: true, - startAt: 32, - endAt: 94 - }, done); - }); - - it('should build a startAt().endAt() query with an observable', (done: any) => { - const query = { - orderByPriority: true, - endAt: new Subject(), - startAt: new Subject() - }; - observableQueryTest(query, { startAt: 7, endAt: 12 }, done); - }); - - }); - -}); - - -describe('null values', () => { - - it('should build an equalTo() query with a null scalar value', (done: any) => { - scalarQueryTest({ - orderByChild: 'height', - equalTo: null - }, done); - }); - - it('should build a startAt() query with a null scalar value', (done: any) => { - scalarQueryTest({ - orderByChild: 'height', - startAt: null - }, done); - }); - - it('should build an endAt() query with a null scalar value', (done: any) => { - scalarQueryTest({ - orderByChild: 'height', - endAt: null - }, done); - }); - - it('should build an equalTo() query with a null observable value', (done: any) => { - const query = { - orderByChild: 'height', - equalTo: new Subject() - }; - observableQueryTest(query, { equalTo: null }, done); - }); - - it('should build a startAt() query with a null observable value', (done: any) => { - const query = { - orderByChild: 'height', - startAt: new Subject() - }; - observableQueryTest(query, { startAt: null }, done); - }); - - it('should build an endAt() query with a null observable value', (done: any) => { - const query = { - orderByChild: 'height', - endAt: new Subject() - }; - observableQueryTest(query, { endAt: null }, done); - }); - -}); - -describe('audited queries', () => { - - it('should immediately emit if not audited', () => { - let nextSpy = jasmine.createSpy('next'); - let query = { orderByChild: 'height', startAt: new Subject(), endAt: new Subject() }; - let obs = observeQuery(query, false); - obs.subscribe(nextSpy); - query.startAt.next(5); - expect(nextSpy).not.toHaveBeenCalled(); - query.endAt.next(10); - expect(nextSpy).toHaveBeenCalledWith({ - orderByChild: 'height', - startAt: 5, - endAt: 10 - }); - query.startAt.next(10); - expect(nextSpy).toHaveBeenCalledWith({ - orderByChild: 'height', - startAt: 10, - endAt: 10 - }); - query.endAt.next(15); - expect(nextSpy).toHaveBeenCalledWith({ - orderByChild: 'height', - startAt: 10, - endAt: 15 - }); - }); - - it('should emit the last query (in the event loop) if audited', (done: any) => { - let emits = 0; - let query = { orderByChild: 'height', startAt: new Subject(), endAt: new Subject() }; - let obs = observeQuery(query, true); - obs.subscribe(result => { - switch (++emits) { - case 1: - expect(result).toEqual({ - orderByChild: 'height', - startAt: 5, - endAt: 10 - }); - query.startAt.next(10); - query.endAt.next(15); - break; - case 2: - expect(result).toEqual({ - orderByChild: 'height', - startAt: 10, - endAt: 15 - }); - done(); - break; - } - }); - query.startAt.next(5); - query.endAt.next(10); - }); - -}); diff --git a/src/database/query_observable.ts b/src/database/query_observable.ts deleted file mode 100644 index ae0a47ce2..000000000 --- a/src/database/query_observable.ts +++ /dev/null @@ -1,190 +0,0 @@ -import { Observable } from 'rxjs/Observable'; -import { of as observableOf } from 'rxjs/observable/of'; -import { Operator } from 'rxjs/Operator'; -import { Observer } from 'rxjs/Observer'; -import { combineLatest } from 'rxjs/operator/combineLatest'; -import { merge } from 'rxjs/operator/merge'; -import { map } from 'rxjs/operator/map'; -import { auditTime } from 'rxjs/operator/auditTime'; -import { Query, ScalarQuery, OrderByOptions, OrderBySelection, LimitToOptions, LimitToSelection, Primitive } from '../interfaces'; -import { hasKey, isNil } from '../utils'; - -export function observeQuery(query: Query, audit: boolean = true): Observable { - if (isNil(query)) { - return observableOf(null); - } - - return Observable.create((observer: Observer) => { - - let combined = combineLatest.call( - getOrderObservables(query), - getStartAtObservable(query), - getEndAtObservable(query), - getEqualToObservable(query), - getLimitToObservables(query) - ); - if (audit) { - combined = auditTime.call(combined, 0); - } - combined - .subscribe(([orderBy, startAt, endAt, equalTo, limitTo] - : [OrderBySelection, Primitive, Primitive, Primitive, LimitToSelection]) => { - - let serializedOrder: any = {}; - if (!isNil(orderBy) && !isNil(orderBy.value)) { - switch (orderBy.key) { - case OrderByOptions.Key: - serializedOrder = { orderByKey: orderBy.value }; - break; - case OrderByOptions.Priority: - serializedOrder = { orderByPriority: orderBy.value }; - break; - case OrderByOptions.Value: - serializedOrder = { orderByValue: orderBy.value }; - break; - case OrderByOptions.Child: - serializedOrder = { orderByChild: orderBy.value }; - break; - } - } - - if (!isNil(limitTo) && !isNil(limitTo.value)) { - switch (limitTo.key) { - case LimitToOptions.First: - serializedOrder.limitToFirst = limitTo.value; - break; - case LimitToOptions.Last: { - serializedOrder.limitToLast = limitTo.value; - break; - } - } - } - - if (startAt !== undefined) { - serializedOrder.startAt = startAt; - } - - if (endAt !== undefined) { - serializedOrder.endAt = endAt; - } - - if (equalTo !== undefined) { - serializedOrder.equalTo = equalTo; - } - - observer.next(serializedOrder); - }); - }); -} - -export function getOrderObservables(query: Query): Observable { - var observables = ['orderByChild', 'orderByKey', 'orderByValue', 'orderByPriority'] - .map((key: string, option: OrderByOptions) => { - return ({ key, option }) - }) - .filter(({key, option}: { key: string, option: OrderByOptions }) => { - return !isNil(query[key]); - }) - .map(({key, option}) => mapToOrderBySelection(query[key], option)); - - if (observables.length === 1) { - return observables[0]; - } else if (observables.length > 1) { - return merge.apply(observables[0], observables.slice(1)); - } else { - return new Observable(subscriber => { - subscriber.next(null); - }); - } -} - -export function getLimitToObservables(query: Query): Observable { - var observables = ['limitToFirst', 'limitToLast'] - .map((key: string, option: LimitToOptions) => ({ key, option })) - .filter(({key, option}: { key: string, option: LimitToOptions }) => !isNil(query[key])) - .map(({key, option}) => mapToLimitToSelection(query[key], option)); - - if (observables.length === 1) { - return observables[0]; - } else if (observables.length > 1) { - const mergedObs = merge.apply(observables[0], observables.slice(1)); - return mergedObs; - } else { - return new Observable(subscriber => { - subscriber.next(null); - }); - } -} - -export function getStartAtObservable(query: Query): Observable { - if (query.startAt instanceof Observable) { - return query.startAt; - } else if (hasKey(query, 'startAt')) { - return new Observable(subscriber => { - subscriber.next(query.startAt); - }); - } else { - return new Observable(subscriber => { - subscriber.next(undefined); - }); - } -} - -export function getEndAtObservable(query: Query): Observable { - if (query.endAt instanceof Observable) { - return query.endAt; - } else if (hasKey(query, 'endAt')) { - return new Observable(subscriber => { - subscriber.next(query.endAt); - }); - } else { - return new Observable(subscriber => { - subscriber.next(undefined); - }); - } -} - -export function getEqualToObservable(query: Query): Observable { - if (query.equalTo instanceof Observable) { - return query.equalTo; - } else if (hasKey(query, 'equalTo')) { - return new Observable(subscriber => { - subscriber.next(query.equalTo); - }); - } else { - return new Observable(subscriber => { - subscriber.next(undefined); - }); - } -} - - -function mapToOrderBySelection(value: Observable | boolean | string, key: OrderByOptions): Observable { - if (value instanceof Observable) { - return map - .call(value, (value: boolean): OrderBySelection => { - return ({ value, key }); - }); - } else { - return new Observable(subscriber => { - subscriber.next({ key, value }); - }); - } - -} - -function mapToLimitToSelection(value: Observable | number, key: LimitToOptions): Observable { - if (value instanceof Observable) { - return map - .call(value, (value: number): LimitToSelection => ({ value, key })); - } else { - return new Observable(subscriber => { - subscriber.next({ key, value }); - }); - } -} - -function hasObservableProperties(query: Query): boolean { - if (query.orderByKey instanceof Observable) return true; - return false; -} diff --git a/src/database/rxfire.ts b/src/database/rxfire.ts new file mode 100644 index 000000000..b34588af7 --- /dev/null +++ b/src/database/rxfire.ts @@ -0,0 +1,26 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +import { ÉĩzoneWrap } from '@angular/fire'; +import { + auditTrail as _auditTrail, + changeToData as _changeToData, + fromRef as _fromRef, + list as _list, + listVal as _listVal, + object as _object, + objectVal as _objectVal, + stateChanges as _stateChanges +} from 'rxfire/database'; + +export { + ListenEvent, + ListenerMethods +} from 'rxfire/database'; + +export const auditTrail = ÉĩzoneWrap(_auditTrail, true); +export const changeToData = ÉĩzoneWrap(_changeToData, true); +export const fromRef = ÉĩzoneWrap(_fromRef, true); +export const list = ÉĩzoneWrap(_list, true); +export const listVal = ÉĩzoneWrap(_listVal, true); +export const object = ÉĩzoneWrap(_object, true); +export const objectVal = ÉĩzoneWrap(_objectVal, true); +export const stateChanges = ÉĩzoneWrap(_stateChanges, true); diff --git a/src/firestore/firebase.ts b/src/firestore/firebase.ts new file mode 100644 index 000000000..74de8fc69 --- /dev/null +++ b/src/firestore/firebase.ts @@ -0,0 +1,122 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/firestore'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + addDoc as _addDoc, + aggregateFieldEqual as _aggregateFieldEqual, + aggregateQuerySnapshotEqual as _aggregateQuerySnapshotEqual, + and as _and, + clearIndexedDbPersistence as _clearIndexedDbPersistence, + collection as _collection, + collectionGroup as _collectionGroup, + connectFirestoreEmulator as _connectFirestoreEmulator, + deleteAllPersistentCacheIndexes as _deleteAllPersistentCacheIndexes, + deleteDoc as _deleteDoc, + deleteField as _deleteField, + disableNetwork as _disableNetwork, + disablePersistentCacheIndexAutoCreation as _disablePersistentCacheIndexAutoCreation, + doc as _doc, + documentId as _documentId, + enableIndexedDbPersistence as _enableIndexedDbPersistence, + enableMultiTabIndexedDbPersistence as _enableMultiTabIndexedDbPersistence, + enableNetwork as _enableNetwork, + enablePersistentCacheIndexAutoCreation as _enablePersistentCacheIndexAutoCreation, + endAt as _endAt, + endBefore as _endBefore, + getAggregateFromServer as _getAggregateFromServer, + getCountFromServer as _getCountFromServer, + getDoc as _getDoc, + getDocFromCache as _getDocFromCache, + getDocFromServer as _getDocFromServer, + getDocs as _getDocs, + getDocsFromCache as _getDocsFromCache, + getDocsFromServer as _getDocsFromServer, + getFirestore as _getFirestore, + getPersistentCacheIndexManager as _getPersistentCacheIndexManager, + increment as _increment, + initializeFirestore as _initializeFirestore, + limit as _limit, + limitToLast as _limitToLast, + loadBundle as _loadBundle, + namedQuery as _namedQuery, + onSnapshot as _onSnapshot, + onSnapshotsInSync as _onSnapshotsInSync, + or as _or, + orderBy as _orderBy, + query as _query, + queryEqual as _queryEqual, + refEqual as _refEqual, + runTransaction as _runTransaction, + setDoc as _setDoc, + setIndexConfiguration as _setIndexConfiguration, + setLogLevel as _setLogLevel, + snapshotEqual as _snapshotEqual, + startAfter as _startAfter, + startAt as _startAt, + sum as _sum, + terminate as _terminate, + updateDoc as _updateDoc, + vector as _vector, + waitForPendingWrites as _waitForPendingWrites, + where as _where, + writeBatch as _writeBatch +} from 'firebase/firestore'; + +export const addDoc = ÉĩzoneWrap(_addDoc, true, 2); +export const aggregateFieldEqual = ÉĩzoneWrap(_aggregateFieldEqual, true, 2); +export const aggregateQuerySnapshotEqual = ÉĩzoneWrap(_aggregateQuerySnapshotEqual, true, 2); +export const and = ÉĩzoneWrap(_and, true, 2); +export const clearIndexedDbPersistence = ÉĩzoneWrap(_clearIndexedDbPersistence, true); +export const collection = ÉĩzoneWrap(_collection, true, 2); +export const collectionGroup = ÉĩzoneWrap(_collectionGroup, true, 2); +export const connectFirestoreEmulator = ÉĩzoneWrap(_connectFirestoreEmulator, true); +export const deleteAllPersistentCacheIndexes = ÉĩzoneWrap(_deleteAllPersistentCacheIndexes, true); +export const deleteDoc = ÉĩzoneWrap(_deleteDoc, true, 2); +export const deleteField = ÉĩzoneWrap(_deleteField, true, 2); +export const disableNetwork = ÉĩzoneWrap(_disableNetwork, true); +export const disablePersistentCacheIndexAutoCreation = ÉĩzoneWrap(_disablePersistentCacheIndexAutoCreation, true); +export const doc = ÉĩzoneWrap(_doc, true, 2); +export const documentId = ÉĩzoneWrap(_documentId, true, 2); +export const enableIndexedDbPersistence = ÉĩzoneWrap(_enableIndexedDbPersistence, true); +export const enableMultiTabIndexedDbPersistence = ÉĩzoneWrap(_enableMultiTabIndexedDbPersistence, true); +export const enableNetwork = ÉĩzoneWrap(_enableNetwork, true); +export const enablePersistentCacheIndexAutoCreation = ÉĩzoneWrap(_enablePersistentCacheIndexAutoCreation, true); +export const endAt = ÉĩzoneWrap(_endAt, true, 2); +export const endBefore = ÉĩzoneWrap(_endBefore, true, 2); +export const getAggregateFromServer = ÉĩzoneWrap(_getAggregateFromServer, true); +export const getCountFromServer = ÉĩzoneWrap(_getCountFromServer, true); +export const getDoc = ÉĩzoneWrap(_getDoc, true); +export const getDocFromCache = ÉĩzoneWrap(_getDocFromCache, true); +export const getDocFromServer = ÉĩzoneWrap(_getDocFromServer, true); +export const getDocs = ÉĩzoneWrap(_getDocs, true); +export const getDocsFromCache = ÉĩzoneWrap(_getDocsFromCache, true); +export const getDocsFromServer = ÉĩzoneWrap(_getDocsFromServer, true); +export const getFirestore = ÉĩzoneWrap(_getFirestore, true); +export const getPersistentCacheIndexManager = ÉĩzoneWrap(_getPersistentCacheIndexManager, true); +export const increment = ÉĩzoneWrap(_increment, true, 2); +export const initializeFirestore = ÉĩzoneWrap(_initializeFirestore, true); +export const limit = ÉĩzoneWrap(_limit, true, 2); +export const limitToLast = ÉĩzoneWrap(_limitToLast, true, 2); +export const loadBundle = ÉĩzoneWrap(_loadBundle, true); +export const namedQuery = ÉĩzoneWrap(_namedQuery, true, 2); +export const onSnapshot = ÉĩzoneWrap(_onSnapshot, true); +export const onSnapshotsInSync = ÉĩzoneWrap(_onSnapshotsInSync, true); +export const or = ÉĩzoneWrap(_or, true, 2); +export const orderBy = ÉĩzoneWrap(_orderBy, true, 2); +export const query = ÉĩzoneWrap(_query, true, 2); +export const queryEqual = ÉĩzoneWrap(_queryEqual, true, 2); +export const refEqual = ÉĩzoneWrap(_refEqual, true, 2); +export const runTransaction = ÉĩzoneWrap(_runTransaction, true); +export const setDoc = ÉĩzoneWrap(_setDoc, true, 2); +export const setIndexConfiguration = ÉĩzoneWrap(_setIndexConfiguration, true); +export const setLogLevel = ÉĩzoneWrap(_setLogLevel, true); +export const snapshotEqual = ÉĩzoneWrap(_snapshotEqual, true, 2); +export const startAfter = ÉĩzoneWrap(_startAfter, true, 2); +export const startAt = ÉĩzoneWrap(_startAt, true, 2); +export const sum = ÉĩzoneWrap(_sum, true, 2); +export const terminate = ÉĩzoneWrap(_terminate, true); +export const updateDoc = ÉĩzoneWrap(_updateDoc, true, 2); +export const vector = ÉĩzoneWrap(_vector, true, 2); +export const waitForPendingWrites = ÉĩzoneWrap(_waitForPendingWrites, true); +export const where = ÉĩzoneWrap(_where, true, 2); +export const writeBatch = ÉĩzoneWrap(_writeBatch, true, 2); diff --git a/src/firestore/firestore.module.ts b/src/firestore/firestore.module.ts new file mode 100644 index 000000000..4946af42e --- /dev/null +++ b/src/firestore/firestore.module.ts @@ -0,0 +1,82 @@ +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { AuthInstances } from '@angular/fire/auth'; +import { registerVersion } from 'firebase/app'; +import { Firestore as FirebaseFirestore } from 'firebase/firestore'; +import { FIRESTORE_PROVIDER_NAME, Firestore, FirestoreInstances } from './firestore'; + +export const PROVIDED_FIRESTORE_INSTANCES = new InjectionToken('angularfire2.firestore-instances'); + +export function defaultFirestoreInstanceFactory(provided: FirebaseFirestore[]|undefined, defaultApp: FirebaseApp) { + const defaultFirestore = ÉĩgetDefaultInstanceOf(FIRESTORE_PROVIDER_NAME, provided, defaultApp); + return defaultFirestore && new Firestore(defaultFirestore); +} + +export function firestoreInstanceFactory(fn: (injector: Injector) => FirebaseFirestore) { + return (zone: NgZone, injector: Injector) => { + const firestore = zone.runOutsideAngular(() => fn(injector)); + return new Firestore(firestore); + }; +} + +const FIRESTORE_INSTANCES_PROVIDER = { + provide: FirestoreInstances, + deps: [ + [new Optional(), PROVIDED_FIRESTORE_INSTANCES ], + ] +}; + +const DEFAULT_FIRESTORE_INSTANCE_PROVIDER = { + provide: Firestore, + useFactory: defaultFirestoreInstanceFactory, + deps: [ + [new Optional(), PROVIDED_FIRESTORE_INSTANCES ], + FirebaseApp, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_FIRESTORE_INSTANCE_PROVIDER, + FIRESTORE_INSTANCES_PROVIDER, + ] +}) +export class FirestoreModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'fst'); + } +} + +export function provideFirestore(fn: (injector: Injector) => FirebaseFirestore, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'fst'); + + return makeEnvironmentProviders([ + DEFAULT_FIRESTORE_INSTANCE_PROVIDER, + FIRESTORE_INSTANCES_PROVIDER, + { + provide: PROVIDED_FIRESTORE_INSTANCES, + useFactory: firestoreInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + // Firestore+Auth work better if Auth is loaded first + [new Optional(), AuthInstances ], + [new Optional(), AppCheckInstances ], + ...deps, + ] + } + ]); +} diff --git a/src/firestore/firestore.spec.ts b/src/firestore/firestore.spec.ts new file mode 100644 index 000000000..71d452968 --- /dev/null +++ b/src/firestore/firestore.spec.ts @@ -0,0 +1,39 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Firestore, connectFirestoreEmulator, getFirestore, provideFirestore } from '@angular/fire/firestore'; +import { COMMON_CONFIG, firestoreEmulatorPort } from '../test-config'; +import { rando } from '../utils'; + +describe('Firestore', () => { + let app: FirebaseApp; + let firestore: Firestore; + let providedFirestore: Firestore; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideFirestore(() => { + providedFirestore = getFirestore(getApp(appName)); + connectFirestoreEmulator(providedFirestore, 'localhost', firestoreEmulatorPort); + return providedFirestore; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + firestore = TestBed.inject(Firestore); + }); + + it('should be injectable', () => { + expect(providedFirestore).toBeTruthy(); + expect(firestore).toEqual(providedFirestore); + expect(firestore.app).toEqual(app); + }); + + }); + +}); diff --git a/src/firestore/firestore.ts b/src/firestore/firestore.ts new file mode 100644 index 000000000..4e3b2d10e --- /dev/null +++ b/src/firestore/firestore.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { Firestore as FirebaseFirestore } from 'firebase/firestore'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Firestore extends FirebaseFirestore {} + +export class Firestore { + constructor(firestore: FirebaseFirestore) { + return firestore; + } +} + +export const FIRESTORE_PROVIDER_NAME = 'firestore'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface FirestoreInstances extends Array {} + +export class FirestoreInstances { + constructor() { + return ÉĩgetAllInstancesOf(FIRESTORE_PROVIDER_NAME); + } +} + +export const firestoreInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(FIRESTORE_PROVIDER_NAME))), + distinct(), +); diff --git a/src/firestore/lite/firebase.ts b/src/firestore/lite/firebase.ts new file mode 100644 index 000000000..47ef25367 --- /dev/null +++ b/src/firestore/lite/firebase.ts @@ -0,0 +1,84 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/firestore/lite'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + addDoc as _addDoc, + aggregateFieldEqual as _aggregateFieldEqual, + aggregateQuerySnapshotEqual as _aggregateQuerySnapshotEqual, + and as _and, + collection as _collection, + collectionGroup as _collectionGroup, + connectFirestoreEmulator as _connectFirestoreEmulator, + deleteDoc as _deleteDoc, + deleteField as _deleteField, + doc as _doc, + documentId as _documentId, + endAt as _endAt, + endBefore as _endBefore, + getAggregate as _getAggregate, + getCount as _getCount, + getDoc as _getDoc, + getDocs as _getDocs, + getFirestore as _getFirestore, + increment as _increment, + initializeFirestore as _initializeFirestore, + limit as _limit, + limitToLast as _limitToLast, + or as _or, + orderBy as _orderBy, + query as _query, + queryEqual as _queryEqual, + refEqual as _refEqual, + runTransaction as _runTransaction, + setDoc as _setDoc, + setLogLevel as _setLogLevel, + snapshotEqual as _snapshotEqual, + startAfter as _startAfter, + startAt as _startAt, + sum as _sum, + terminate as _terminate, + updateDoc as _updateDoc, + vector as _vector, + where as _where, + writeBatch as _writeBatch +} from 'firebase/firestore/lite'; + +export const addDoc = ÉĩzoneWrap(_addDoc, true, 2); +export const aggregateFieldEqual = ÉĩzoneWrap(_aggregateFieldEqual, true, 2); +export const aggregateQuerySnapshotEqual = ÉĩzoneWrap(_aggregateQuerySnapshotEqual, true, 2); +export const and = ÉĩzoneWrap(_and, true, 2); +export const collection = ÉĩzoneWrap(_collection, true, 2); +export const collectionGroup = ÉĩzoneWrap(_collectionGroup, true, 2); +export const connectFirestoreEmulator = ÉĩzoneWrap(_connectFirestoreEmulator, true); +export const deleteDoc = ÉĩzoneWrap(_deleteDoc, true, 2); +export const deleteField = ÉĩzoneWrap(_deleteField, true, 2); +export const doc = ÉĩzoneWrap(_doc, true, 2); +export const documentId = ÉĩzoneWrap(_documentId, true, 2); +export const endAt = ÉĩzoneWrap(_endAt, true, 2); +export const endBefore = ÉĩzoneWrap(_endBefore, true, 2); +export const getAggregate = ÉĩzoneWrap(_getAggregate, true); +export const getCount = ÉĩzoneWrap(_getCount, true); +export const getDoc = ÉĩzoneWrap(_getDoc, true); +export const getDocs = ÉĩzoneWrap(_getDocs, true); +export const getFirestore = ÉĩzoneWrap(_getFirestore, true); +export const increment = ÉĩzoneWrap(_increment, true, 2); +export const initializeFirestore = ÉĩzoneWrap(_initializeFirestore, true); +export const limit = ÉĩzoneWrap(_limit, true, 2); +export const limitToLast = ÉĩzoneWrap(_limitToLast, true, 2); +export const or = ÉĩzoneWrap(_or, true, 2); +export const orderBy = ÉĩzoneWrap(_orderBy, true, 2); +export const query = ÉĩzoneWrap(_query, true, 2); +export const queryEqual = ÉĩzoneWrap(_queryEqual, true, 2); +export const refEqual = ÉĩzoneWrap(_refEqual, true, 2); +export const runTransaction = ÉĩzoneWrap(_runTransaction, true); +export const setDoc = ÉĩzoneWrap(_setDoc, true, 2); +export const setLogLevel = ÉĩzoneWrap(_setLogLevel, true); +export const snapshotEqual = ÉĩzoneWrap(_snapshotEqual, true, 2); +export const startAfter = ÉĩzoneWrap(_startAfter, true, 2); +export const startAt = ÉĩzoneWrap(_startAt, true, 2); +export const sum = ÉĩzoneWrap(_sum, true, 2); +export const terminate = ÉĩzoneWrap(_terminate, true); +export const updateDoc = ÉĩzoneWrap(_updateDoc, true, 2); +export const vector = ÉĩzoneWrap(_vector, true, 2); +export const where = ÉĩzoneWrap(_where, true, 2); +export const writeBatch = ÉĩzoneWrap(_writeBatch, true, 2); diff --git a/src/firestore/lite/lite.module.ts b/src/firestore/lite/lite.module.ts new file mode 100644 index 000000000..f72409b93 --- /dev/null +++ b/src/firestore/lite/lite.module.ts @@ -0,0 +1,82 @@ +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { AppCheckInstances} from "@angular/fire/app-check"; +import { AuthInstances } from '@angular/fire/auth'; +import { registerVersion } from 'firebase/app'; +import { Firestore as FirebaseFirestore } from 'firebase/firestore/lite'; +import { FIRESTORE_PROVIDER_NAME, Firestore, FirestoreInstances } from './lite'; + +export const PROVIDED_FIRESTORE_INSTANCES = new InjectionToken('angularfire2.firestore-lite-instances'); + +export function defaultFirestoreInstanceFactory(provided: FirebaseFirestore[]|undefined, defaultApp: FirebaseApp) { + const defaultFirestore = ÉĩgetDefaultInstanceOf(FIRESTORE_PROVIDER_NAME, provided, defaultApp); + return defaultFirestore && new Firestore(defaultFirestore); +} + +export function firestoreInstanceFactory(fn: (injector: Injector) => FirebaseFirestore) { + return (zone: NgZone, injector: Injector) => { + const firestore = zone.runOutsideAngular(() => fn(injector)); + return new Firestore(firestore); + }; +} + +const FIRESTORE_INSTANCES_PROVIDER = { + provide: FirestoreInstances, + deps: [ + [new Optional(), PROVIDED_FIRESTORE_INSTANCES ], + ] +}; + +const DEFAULT_FIRESTORE_INSTANCE_PROVIDER = { + provide: Firestore, + useFactory: defaultFirestoreInstanceFactory, + deps: [ + [new Optional(), PROVIDED_FIRESTORE_INSTANCES ], + FirebaseApp, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_FIRESTORE_INSTANCE_PROVIDER, + FIRESTORE_INSTANCES_PROVIDER, + ] +}) +export class FirestoreModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'lite'); + } +} + +export function provideFirestore(fn: (injector: Injector) => FirebaseFirestore, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'lite'); + + return makeEnvironmentProviders([ + DEFAULT_FIRESTORE_INSTANCE_PROVIDER, + FIRESTORE_INSTANCES_PROVIDER, + { + provide: PROVIDED_FIRESTORE_INSTANCES, + useFactory: firestoreInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + // Firestore+Auth work better if Auth is loaded first + [new Optional(), AuthInstances ], + [new Optional(), AppCheckInstances ], + ...deps, + ] + } + ]); +} diff --git a/src/firestore/lite/lite.spec.ts b/src/firestore/lite/lite.spec.ts new file mode 100644 index 000000000..83cbb54f7 --- /dev/null +++ b/src/firestore/lite/lite.spec.ts @@ -0,0 +1,39 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Firestore, connectFirestoreEmulator, getFirestore, provideFirestore } from '@angular/fire/firestore/lite'; +import { COMMON_CONFIG, firestoreEmulatorPort } from '../../test-config'; +import { rando } from '../../utils'; + +describe('Firestore-lite', () => { + let app: FirebaseApp; + let firestore: Firestore; + let providedFirestore: Firestore; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideFirestore(() => { + providedFirestore = getFirestore(getApp(appName)); + connectFirestoreEmulator(providedFirestore, 'localhost', firestoreEmulatorPort); + return providedFirestore; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + firestore = TestBed.inject(Firestore); + }); + + it('should be injectable', () => { + expect(providedFirestore).toBeTruthy(); + expect(firestore).toEqual(providedFirestore); + expect(firestore.app).toEqual(app); + }); + + }); + +}); diff --git a/src/firestore/lite/lite.ts b/src/firestore/lite/lite.ts new file mode 100644 index 000000000..838be5b5b --- /dev/null +++ b/src/firestore/lite/lite.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { Firestore as FirebaseFirestore } from 'firebase/firestore/lite'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Firestore extends FirebaseFirestore {} + +export class Firestore { + constructor(firestore: FirebaseFirestore) { + return firestore; + } +} + +export const FIRESTORE_PROVIDER_NAME = 'firestore/lite'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface FirestoreInstances extends Array {} + +export class FirestoreInstances { + constructor() { + return ÉĩgetAllInstancesOf(FIRESTORE_PROVIDER_NAME); + } +} + +export const firestoreInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(FIRESTORE_PROVIDER_NAME))), + distinct(), +); diff --git a/src/firestore/lite/ng-package.json b/src/firestore/lite/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/firestore/lite/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/firestore/lite/package.json b/src/firestore/lite/package.json new file mode 100644 index 000000000..5eaf9d5f0 --- /dev/null +++ b/src/firestore/lite/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/firestore/lite/public_api.ts b/src/firestore/lite/public_api.ts new file mode 100644 index 000000000..6c4ad149f --- /dev/null +++ b/src/firestore/lite/public_api.ts @@ -0,0 +1,4 @@ +export { Firestore, FirestoreInstances, firestoreInstance$ } from './lite'; +export { FirestoreModule, provideFirestore } from './lite.module'; +export * from './rxfire'; +export * from './firebase'; diff --git a/src/firestore/lite/rxfire.ts b/src/firestore/lite/rxfire.ts new file mode 100644 index 000000000..8e1d5e2b5 --- /dev/null +++ b/src/firestore/lite/rxfire.ts @@ -0,0 +1,21 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +import { ÉĩzoneWrap } from '@angular/fire'; +import { + collection as _collection, + collectionCount as _collectionCount, + collectionCountSnap as _collectionCountSnap, + collectionData as _collectionData, + doc as _doc, + docData as _docData, + fromRef as _fromRef, + snapToData as _snapToData +} from 'rxfire/firestore/lite'; + +export const collectionSnapshots = ÉĩzoneWrap(_collection, true); +export const collectionCount = ÉĩzoneWrap(_collectionCount, true); +export const collectionCountSnap = ÉĩzoneWrap(_collectionCountSnap, true); +export const collectionData = ÉĩzoneWrap(_collectionData, true); +export const docSnapshots = ÉĩzoneWrap(_doc, true); +export const docData = ÉĩzoneWrap(_docData, true); +export const fromRef = ÉĩzoneWrap(_fromRef, true); +export const snapToData = ÉĩzoneWrap(_snapToData, true); diff --git a/src/firestore/ng-package.json b/src/firestore/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/firestore/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/firestore/package.json b/src/firestore/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/firestore/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/firestore/public_api.ts b/src/firestore/public_api.ts new file mode 100644 index 000000000..7eb680749 --- /dev/null +++ b/src/firestore/public_api.ts @@ -0,0 +1,4 @@ +export { Firestore, FirestoreInstances, firestoreInstance$ } from './firestore'; +export { provideFirestore, FirestoreModule } from './firestore.module'; +export * from './rxfire'; +export * from './firebase'; diff --git a/src/firestore/rxfire.ts b/src/firestore/rxfire.ts new file mode 100644 index 000000000..6b2eb8e92 --- /dev/null +++ b/src/firestore/rxfire.ts @@ -0,0 +1,27 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +import { ÉĩzoneWrap } from '@angular/fire'; +import { + auditTrail as _auditTrail, + collection as _collection, + collectionChanges as _collectionChanges, + collectionCount as _collectionCount, + collectionCountSnap as _collectionCountSnap, + collectionData as _collectionData, + doc as _doc, + docData as _docData, + fromRef as _fromRef, + snapToData as _snapToData, + sortedChanges as _sortedChanges +} from 'rxfire/firestore'; + +export const auditTrail = ÉĩzoneWrap(_auditTrail, true); +export const collectionSnapshots = ÉĩzoneWrap(_collection, true); +export const collectionChanges = ÉĩzoneWrap(_collectionChanges, true); +export const collectionCount = ÉĩzoneWrap(_collectionCount, true); +export const collectionCountSnap = ÉĩzoneWrap(_collectionCountSnap, true); +export const collectionData = ÉĩzoneWrap(_collectionData, true); +export const docSnapshots = ÉĩzoneWrap(_doc, true); +export const docData = ÉĩzoneWrap(_docData, true); +export const fromRef = ÉĩzoneWrap(_fromRef, true); +export const snapToData = ÉĩzoneWrap(_snapToData, true); +export const sortedChanges = ÉĩzoneWrap(_sortedChanges, true); diff --git a/src/functions/firebase.ts b/src/functions/firebase.ts new file mode 100644 index 000000000..204f60574 --- /dev/null +++ b/src/functions/firebase.ts @@ -0,0 +1,14 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/functions'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + connectFunctionsEmulator as _connectFunctionsEmulator, + getFunctions as _getFunctions, + httpsCallable as _httpsCallable, + httpsCallableFromURL as _httpsCallableFromURL +} from 'firebase/functions'; + +export const connectFunctionsEmulator = ÉĩzoneWrap(_connectFunctionsEmulator, true); +export const getFunctions = ÉĩzoneWrap(_getFunctions, true); +export const httpsCallable = ÉĩzoneWrap(_httpsCallable, true); +export const httpsCallableFromURL = ÉĩzoneWrap(_httpsCallableFromURL, true); diff --git a/src/functions/functions.module.ts b/src/functions/functions.module.ts new file mode 100644 index 000000000..90e0c4331 --- /dev/null +++ b/src/functions/functions.module.ts @@ -0,0 +1,82 @@ +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { AuthInstances } from '@angular/fire/auth'; +import { registerVersion } from 'firebase/app'; +import { Functions as FirebaseFunctions } from 'firebase/functions'; +import { FUNCTIONS_PROVIDER_NAME, Functions, FunctionsInstances } from './functions'; + +export const PROVIDED_FUNCTIONS_INSTANCES = new InjectionToken('angularfire2.functions-instances'); + +export function defaultFunctionsInstanceFactory(provided: FirebaseFunctions[]|undefined, defaultApp: FirebaseApp) { + const defaultAuth = ÉĩgetDefaultInstanceOf(FUNCTIONS_PROVIDER_NAME, provided, defaultApp); + return defaultAuth && new Functions(defaultAuth); +} + +export function functionsInstanceFactory(fn: (injector: Injector) => FirebaseFunctions) { + return (zone: NgZone, injector: Injector) => { + const functions = zone.runOutsideAngular(() => fn(injector)); + return new Functions(functions); + }; +} + +const FUNCTIONS_INSTANCES_PROVIDER = { + provide: FunctionsInstances, + deps: [ + [new Optional(), PROVIDED_FUNCTIONS_INSTANCES ], + ] +}; + +const DEFAULT_FUNCTIONS_INSTANCE_PROVIDER = { + provide: Functions, + useFactory: defaultFunctionsInstanceFactory, + deps: [ + [new Optional(), PROVIDED_FUNCTIONS_INSTANCES ], + FirebaseApp, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_FUNCTIONS_INSTANCE_PROVIDER, + FUNCTIONS_INSTANCES_PROVIDER, + ] +}) +export class FunctionsModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'fn'); + } +} + +export function provideFunctions(fn: (injector: Injector) => FirebaseFunctions, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'fn'); + + return makeEnvironmentProviders([ + DEFAULT_FUNCTIONS_INSTANCE_PROVIDER, + FUNCTIONS_INSTANCES_PROVIDER, + { + provide: PROVIDED_FUNCTIONS_INSTANCES, + useFactory: functionsInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + // Defensively load Auth first, if provided + [new Optional(), AuthInstances ], + [new Optional(), AppCheckInstances ], + ...deps, + ] + } + ]); +} diff --git a/src/functions/functions.spec.ts b/src/functions/functions.spec.ts new file mode 100644 index 000000000..8a06d2c6c --- /dev/null +++ b/src/functions/functions.spec.ts @@ -0,0 +1,39 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Functions, connectFunctionsEmulator, getFunctions, provideFunctions } from '@angular/fire/functions'; +import { COMMON_CONFIG, functionsEmulatorPort } from '../test-config'; +import { rando } from '../utils'; + +describe('Functions', () => { + let app: FirebaseApp; + let functions: Functions; + let providedFunctions: Functions; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideFunctions(() => { + providedFunctions = getFunctions(getApp(appName)); + connectFunctionsEmulator(providedFunctions, 'localhost', functionsEmulatorPort); + return providedFunctions; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + functions = TestBed.inject(Functions); + }); + + it('should be injectable', () => { + expect(providedFunctions).toBeTruthy(); + expect(functions).toEqual(providedFunctions); + expect(functions.app).toEqual(app); + }); + + }); + +}); diff --git a/src/functions/functions.ts b/src/functions/functions.ts new file mode 100644 index 000000000..861114fa0 --- /dev/null +++ b/src/functions/functions.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { Functions as FirebaseFunctions } from 'firebase/functions'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Functions extends FirebaseFunctions {} + +export class Functions { + constructor(functions: FirebaseFunctions) { + return functions; + } +} + +export const FUNCTIONS_PROVIDER_NAME = 'functions'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface FunctionsInstances extends Array {} + +export class FunctionsInstances { + constructor() { + return ÉĩgetAllInstancesOf(FUNCTIONS_PROVIDER_NAME); + } +} + +export const functionInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(FUNCTIONS_PROVIDER_NAME))), + distinct(), +); diff --git a/src/functions/ng-package.json b/src/functions/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/functions/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/functions/package.json b/src/functions/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/functions/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/functions/public_api.ts b/src/functions/public_api.ts new file mode 100644 index 000000000..0ae0209af --- /dev/null +++ b/src/functions/public_api.ts @@ -0,0 +1,4 @@ +export { provideFunctions, FunctionsModule } from './functions.module'; +export { Functions, FunctionsInstances, functionInstance$ } from './functions'; +export * from './rxfire'; +export * from './firebase'; diff --git a/src/functions/rxfire.ts b/src/functions/rxfire.ts new file mode 100644 index 000000000..3c6c2f7bd --- /dev/null +++ b/src/functions/rxfire.ts @@ -0,0 +1,7 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +import { ÉĩzoneWrap } from '@angular/fire'; +import { + httpsCallable as _httpsCallable +} from 'rxfire/functions'; + +export const httpsCallableData = ÉĩzoneWrap(_httpsCallable, true); diff --git a/src/index.ts b/src/index.ts deleted file mode 100644 index d0e702904..000000000 --- a/src/index.ts +++ /dev/null @@ -1 +0,0 @@ -export * from './angularfire2'; diff --git a/src/interfaces.ts b/src/interfaces.ts deleted file mode 100644 index 436b3e078..000000000 --- a/src/interfaces.ts +++ /dev/null @@ -1,98 +0,0 @@ -import * as firebase from 'firebase/app'; -import { Observable } from 'rxjs/Observable'; - -export interface FirebaseAppConfig { - apiKey?: string; - authDomain?: string; - databaseURL?: string; - storageBucket?: string; - messagingSenderId?: string; - projectId?: string; -} - -export interface FirebaseOperationCases { - stringCase: () => firebase.Promise; - firebaseCase?: () => firebase.Promise; - snapshotCase?: () => firebase.Promise; - unwrappedSnapshotCase?: () => firebase.Promise; -} - -export interface AFUnwrappedDataSnapshot { - $key: string; - $value?: string | number | boolean; - $exists: () => boolean; -} - -export interface Query { - [key: string]: any; - orderByKey?: boolean | Observable; - orderByPriority?: boolean | Observable; - orderByChild?: string | Observable; - orderByValue?: boolean | Observable; - equalTo?: any | Observable; - startAt?: any | Observable; - endAt?: any | Observable; - limitToFirst?: number | Observable; - limitToLast?: number | Observable; -} - -export interface ScalarQuery { - [key: string]: any; - orderByKey?: boolean; - orderByPriority?: boolean; - orderByChild?: string; - orderByValue?: boolean; - equalTo?: any; - startAt?: any; - endAt?: any; - limitToFirst?: number; - limitToLast?: number; -} - -export interface OrderBySelection { - key: OrderByOptions; - value: boolean | string; -} - -export interface LimitToSelection { - key: LimitToOptions; - value: number; -} - -export interface FirebaseListFactoryOpts { - preserveSnapshot?: boolean; - query?: Query; -} - - -export interface FirebaseObjectFactoryOpts { - preserveSnapshot?: boolean; -} - - -export enum OrderByOptions { - Child, - Key, - Value, - Priority -} - -export enum LimitToOptions { - First, - Last -} - -export enum QueryOptions { - EqualTo, - StartAt, - EndAt -} - -export type Primitive = number | string | boolean; - -export type DatabaseSnapshot = firebase.database.DataSnapshot; -export type DatabaseReference = firebase.database.Reference; -export type DatabaseQuery = firebase.database.Query; -export type QueryReference = DatabaseReference | DatabaseQuery; -export type PathReference = QueryReference | string; -export type Auth = firebase.auth.Auth; \ No newline at end of file diff --git a/src/messaging/firebase.ts b/src/messaging/firebase.ts new file mode 100644 index 000000000..69e76baca --- /dev/null +++ b/src/messaging/firebase.ts @@ -0,0 +1,16 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/messaging'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + deleteToken as _deleteToken, + getMessaging as _getMessaging, + getToken as _getToken, + isSupported as _isSupported, + onMessage as _onMessage +} from 'firebase/messaging'; + +export const deleteToken = ÉĩzoneWrap(_deleteToken, true, 2); +export const getMessaging = ÉĩzoneWrap(_getMessaging, true); +export const getToken = ÉĩzoneWrap(_getToken, true); +export const isSupported = ÉĩzoneWrap(_isSupported, false); +export const onMessage = ÉĩzoneWrap(_onMessage, false); diff --git a/src/messaging/messaging.module.ts b/src/messaging/messaging.module.ts new file mode 100644 index 000000000..0942e053a --- /dev/null +++ b/src/messaging/messaging.module.ts @@ -0,0 +1,83 @@ +import { isPlatformServer } from '@angular/common'; +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + PLATFORM_ID, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { registerVersion } from 'firebase/app'; +import { Messaging as FirebaseMessaging } from 'firebase/messaging'; +import { MESSAGING_PROVIDER_NAME, Messaging, MessagingInstances } from './messaging'; + +const PROVIDED_MESSAGING_INSTANCES = new InjectionToken('angularfire2.messaging-instances'); + +export function defaultMessagingInstanceFactory(provided: FirebaseMessaging[]|undefined, defaultApp: FirebaseApp, platformId: object) { + if (isPlatformServer(platformId)) { return null; } + const defaultMessaging = ÉĩgetDefaultInstanceOf(MESSAGING_PROVIDER_NAME, provided, defaultApp); + return defaultMessaging && new Messaging(defaultMessaging); +} + +export function messagingInstanceFactory(fn: (injector: Injector) => FirebaseMessaging) { + return (zone: NgZone, injector: Injector, platformId: object) => { + if (isPlatformServer(platformId)) { return null; } + const messaging = zone.runOutsideAngular(() => fn(injector)); + return new Messaging(messaging); + }; +} + +const MESSAGING_INSTANCES_PROVIDER = { + provide: MessagingInstances, + deps: [ + [new Optional(), PROVIDED_MESSAGING_INSTANCES ], + ] +}; + +const DEFAULT_MESSAGING_INSTANCE_PROVIDER = { + provide: Messaging, + useFactory: defaultMessagingInstanceFactory, + deps: [ + [new Optional(), PROVIDED_MESSAGING_INSTANCES ], + FirebaseApp, + PLATFORM_ID, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_MESSAGING_INSTANCE_PROVIDER, + MESSAGING_INSTANCES_PROVIDER, + ] +}) +export class MessagingModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'fcm'); + } +} + +export function provideMessaging(fn: (injector: Injector) => FirebaseMessaging, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'fcm'); + + return makeEnvironmentProviders([ + DEFAULT_MESSAGING_INSTANCE_PROVIDER, + MESSAGING_INSTANCES_PROVIDER, + { + provide: PROVIDED_MESSAGING_INSTANCES, + useFactory: messagingInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + PLATFORM_ID, + ÉĩAngularFireSchedulers, + FirebaseApps, + ...deps, + ], + } + ]); +} diff --git a/src/messaging/messaging.spec.ts b/src/messaging/messaging.spec.ts new file mode 100644 index 000000000..5a48de626 --- /dev/null +++ b/src/messaging/messaging.spec.ts @@ -0,0 +1,41 @@ +import { TestBed } from '@angular/core/testing'; +import { getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Messaging, getMessaging, isSupported, provideMessaging } from '@angular/fire/messaging'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +describe('Messaging', () => { + let messaging: Messaging; + let providedMessaging: Messaging; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideMessaging(() => { + providedMessaging = getMessaging(getApp(appName)); + return providedMessaging; + }), + ], + }); + messaging = TestBed.inject(Messaging); + }); + + it('should be injectable', async () => { + const supported = await TestBed.runInInjectionContext(isSupported); + if (supported) { + expect(providedMessaging).toBeTruthy(); + expect(messaging).toEqual(providedMessaging); + } else { + expect(providedMessaging).toBeUndefined(); + expect(messaging).toBeNull(); + } + }); + + }); + +}); diff --git a/src/messaging/messaging.ts b/src/messaging/messaging.ts new file mode 100644 index 000000000..f33566dcf --- /dev/null +++ b/src/messaging/messaging.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { Messaging as FirebaseMessaging } from 'firebase/messaging'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Messaging extends FirebaseMessaging {} + +export class Messaging { + constructor(messaging: FirebaseMessaging) { + return messaging; + } +} + +export const MESSAGING_PROVIDER_NAME = 'messaging'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface MessagingInstances extends Array {} + +export class MessagingInstances { + constructor() { + return ÉĩgetAllInstancesOf(MESSAGING_PROVIDER_NAME); + } +} + +export const messagingInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(MESSAGING_PROVIDER_NAME))), + distinct(), +); diff --git a/src/messaging/ng-package.json b/src/messaging/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/messaging/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/messaging/package.json b/src/messaging/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/messaging/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/messaging/public_api.ts b/src/messaging/public_api.ts new file mode 100644 index 000000000..f0dd1128b --- /dev/null +++ b/src/messaging/public_api.ts @@ -0,0 +1,3 @@ +export { MessagingInstances, Messaging, messagingInstance$ } from './messaging'; +export { provideMessaging, MessagingModule } from './messaging.module'; +export * from './firebase'; diff --git a/src/ng-package.json b/src/ng-package.json new file mode 100644 index 000000000..f47a73dac --- /dev/null +++ b/src/ng-package.json @@ -0,0 +1,15 @@ +{ + "$schema": "./node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + }, + "dest": "../dist/packages-dist", + "allowedNonPeerDependencies": [ + "@angular-devkit/schematics", "@schematics/angular", + "fuzzy", "inquirer-autocomplete-prompt", + "open", "jsonc-parser", "ora", "winston", + "triple-beam", "@schematics/angular", "node-fetch", + "semver", "inquirer", "fs-extra", + "firebase", "rxfire" + ] +} diff --git a/src/package.json b/src/package.json new file mode 100644 index 000000000..4f0bc9082 --- /dev/null +++ b/src/package.json @@ -0,0 +1,48 @@ +{ + "$schema": "../node_modules/ng-packagr/package.schema.json", + "name": "@angular/fire", + "version": "ANGULARFIRE2_VERSION", + "description": "Angular + Firebase = ❤ī¸", + "schematics": "./schematics/collection.json", + "builders": "./schematics/builders.json", + "keywords": [ + "angular", + "firebase", + "rxjs", + "angularfire", + "angularfire2" + ], + "repository": { + "type": "git", + "url": "git+https://github.com/angular/angularfire.git" + }, + "bugs": { + "url": "https://github.com/angular/angularfire/issues" + }, + "homepage": "https://github.com/angular/angularfire#readme", + "author": "angular,firebase", + "license": "MIT", + "peerDependencies": { + "@angular/common": "^20.0.0", + "@angular/core": "^20.0.0", + "@angular/platform-browser": "^20.0.0", + "@angular/platform-browser-dynamic": "^20.0.0", + "@angular/platform-server": "^20.0.0", + "rxjs": "~7.8.0", + "firebase-tools": "^14.0.0" + }, + "peerDependenciesMeta": { + "firebase-tools": { "optional": true }, + "@angular/platform-server": { "optional": true } + }, + "dependencies": { + "firebase": "^11.8.0", + "rxfire": "^6.1.0", + "@angular-devkit/schematics": "^20.0.0", + "@schematics/angular": "^20.0.0", + "tslib": "^2.3.0" + }, + "ng-update": { + "migrations": "./schematics/migration.json" + } +} diff --git a/src/performance/firebase.ts b/src/performance/firebase.ts new file mode 100644 index 000000000..4f4b57011 --- /dev/null +++ b/src/performance/firebase.ts @@ -0,0 +1,12 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/performance'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + getPerformance as _getPerformance, + initializePerformance as _initializePerformance, + trace as _trace +} from 'firebase/performance'; + +export const getPerformance = ÉĩzoneWrap(_getPerformance, true); +export const initializePerformance = ÉĩzoneWrap(_initializePerformance, true); +export const trace = ÉĩzoneWrap(_trace, true, 2); diff --git a/src/performance/ng-package.json b/src/performance/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/performance/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/performance/package.json b/src/performance/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/performance/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/performance/performance.module.ts b/src/performance/performance.module.ts new file mode 100644 index 000000000..9a08c520f --- /dev/null +++ b/src/performance/performance.module.ts @@ -0,0 +1,91 @@ +import { isPlatformBrowser } from '@angular/common'; +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + PLATFORM_ID, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { registerVersion } from 'firebase/app'; +import { FirebasePerformance } from 'firebase/performance'; +import { PERFORMANCE_PROVIDER_NAME, Performance, PerformanceInstances } from './performance'; + +export const PROVIDED_PERFORMANCE_INSTANCES = new InjectionToken('angularfire2.performance-instances'); + +export function defaultPerformanceInstanceFactory( + provided: FirebasePerformance[]|undefined, + defaultApp: FirebaseApp, + // eslint-disable-next-line @typescript-eslint/ban-types + platform: Object +) { + if (!isPlatformBrowser(platform)) { return null; } + const defaultPerformance = ÉĩgetDefaultInstanceOf(PERFORMANCE_PROVIDER_NAME, provided, defaultApp); + return defaultPerformance && new Performance(defaultPerformance); +} + +export function performanceInstanceFactory(fn: (injector: Injector) => FirebasePerformance) { + // eslint-disable-next-line @typescript-eslint/ban-types + return (zone: NgZone, platform: Object, injector: Injector) => { + if (!isPlatformBrowser(platform)) { return null; } + const performance = zone.runOutsideAngular(() => fn(injector)); + return new Performance(performance); + }; +} + +const PERFORMANCE_INSTANCES_PROVIDER = { + provide: PerformanceInstances, + deps: [ + [new Optional(), PROVIDED_PERFORMANCE_INSTANCES ], + ] +}; + +const DEFAULT_PERFORMANCE_INSTANCE_PROVIDER = { + provide: Performance, + useFactory: defaultPerformanceInstanceFactory, + deps: [ + [new Optional(), PROVIDED_PERFORMANCE_INSTANCES ], + FirebaseApp, + PLATFORM_ID, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_PERFORMANCE_INSTANCE_PROVIDER, + PERFORMANCE_INSTANCES_PROVIDER, + ] +}) +export class PerformanceModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'perf'); + } +} + +export function providePerformance( + fn: (injector: Injector) => FirebasePerformance, ...deps: any[] +): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'perf'); + + return makeEnvironmentProviders([ + DEFAULT_PERFORMANCE_INSTANCE_PROVIDER, + PERFORMANCE_INSTANCES_PROVIDER, + { + provide: PROVIDED_PERFORMANCE_INSTANCES, + useFactory: performanceInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + PLATFORM_ID, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + ...deps, + ] + } + ]); +} diff --git a/src/performance/performance.spec.ts b/src/performance/performance.spec.ts new file mode 100644 index 000000000..e8264d941 --- /dev/null +++ b/src/performance/performance.spec.ts @@ -0,0 +1,35 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Performance, getPerformance, providePerformance } from '@angular/fire/performance'; +import { COMMON_CONFIG } from '../test-config'; + +describe('Performance', () => { + let app: FirebaseApp; + let performance: Performance; + let providedPerformance: Performance; + + describe('single injection', () => { + + beforeEach(() => { + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG)), + providePerformance(() => { + providedPerformance = getPerformance(); + return providedPerformance; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + performance = TestBed.inject(Performance); + }); + + it('should be injectable', () => { + expect(providedPerformance).toBeTruthy(); + expect(performance).toEqual(providedPerformance); + expect(performance.app).toEqual(app); + }); + + }); + +}); diff --git a/src/performance/performance.ts b/src/performance/performance.ts new file mode 100644 index 000000000..ac6044386 --- /dev/null +++ b/src/performance/performance.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { FirebasePerformance } from 'firebase/performance'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Performance extends FirebasePerformance {} + +export class Performance { + constructor(performance: FirebasePerformance) { + return performance; + } +} + +export const PERFORMANCE_PROVIDER_NAME = 'performance'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface PerformanceInstances extends Array {} + +export class PerformanceInstances { + constructor() { + return ÉĩgetAllInstancesOf(PERFORMANCE_PROVIDER_NAME); + } +} + +export const performanceInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(PERFORMANCE_PROVIDER_NAME))), + distinct(), +); diff --git a/src/performance/public_api.ts b/src/performance/public_api.ts new file mode 100644 index 000000000..b0698ba0a --- /dev/null +++ b/src/performance/public_api.ts @@ -0,0 +1,4 @@ +export { Performance, PerformanceInstances, performanceInstance$ } from './performance'; +export { providePerformance, PerformanceModule } from './performance.module'; +export * from './rxfire'; +export * from './firebase'; diff --git a/src/performance/rxfire.ts b/src/performance/rxfire.ts new file mode 100644 index 000000000..b81aa9f95 --- /dev/null +++ b/src/performance/rxfire.ts @@ -0,0 +1,13 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +import { ÉĩzoneWrap } from '@angular/fire'; +import { + traceUntil as _traceUntil, + traceUntilComplete as _traceUntilComplete, + traceUntilFirst as _traceUntilFirst, + traceWhile as _traceWhile +} from 'rxfire/performance'; + +export const traceUntil = ÉĩzoneWrap(_traceUntil, true); +export const traceUntilComplete = ÉĩzoneWrap(_traceUntilComplete, true); +export const traceUntilFirst = ÉĩzoneWrap(_traceUntilFirst, true); +export const traceWhile = ÉĩzoneWrap(_traceWhile, true); diff --git a/src/public_api.ts b/src/public_api.ts new file mode 100644 index 000000000..e54a8df63 --- /dev/null +++ b/src/public_api.ts @@ -0,0 +1,2 @@ +export * from './core'; +export * from './zones'; diff --git a/src/remote-config/firebase.ts b/src/remote-config/firebase.ts new file mode 100644 index 000000000..376afaedb --- /dev/null +++ b/src/remote-config/firebase.ts @@ -0,0 +1,32 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/remote-config'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + activate as _activate, + ensureInitialized as _ensureInitialized, + fetchAndActivate as _fetchAndActivate, + fetchConfig as _fetchConfig, + getAll as _getAll, + getBoolean as _getBoolean, + getNumber as _getNumber, + getRemoteConfig as _getRemoteConfig, + getString as _getString, + getValue as _getValue, + isSupported as _isSupported, + setCustomSignals as _setCustomSignals, + setLogLevel as _setLogLevel +} from 'firebase/remote-config'; + +export const activate = ÉĩzoneWrap(_activate, true); +export const ensureInitialized = ÉĩzoneWrap(_ensureInitialized, true); +export const fetchAndActivate = ÉĩzoneWrap(_fetchAndActivate, true); +export const fetchConfig = ÉĩzoneWrap(_fetchConfig, true); +export const getAll = ÉĩzoneWrap(_getAll, true); +export const getBoolean = ÉĩzoneWrap(_getBoolean, true); +export const getNumber = ÉĩzoneWrap(_getNumber, true); +export const getRemoteConfig = ÉĩzoneWrap(_getRemoteConfig, true); +export const getString = ÉĩzoneWrap(_getString, true); +export const getValue = ÉĩzoneWrap(_getValue, true); +export const isSupported = ÉĩzoneWrap(_isSupported, true); +export const setCustomSignals = ÉĩzoneWrap(_setCustomSignals, true); +export const setLogLevel = ÉĩzoneWrap(_setLogLevel, true); diff --git a/src/remote-config/ng-package.json b/src/remote-config/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/remote-config/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/remote-config/package.json b/src/remote-config/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/remote-config/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/remote-config/public_api.ts b/src/remote-config/public_api.ts new file mode 100644 index 000000000..fd4c1896a --- /dev/null +++ b/src/remote-config/public_api.ts @@ -0,0 +1,4 @@ +export { RemoteConfigInstances, RemoteConfig, remoteConfigInstance$ } from './remote-config'; +export { provideRemoteConfig, RemoteConfigModule } from './remote-config.module'; +export * from './rxfire'; +export * from './firebase'; diff --git a/src/remote-config/remote-config.module.ts b/src/remote-config/remote-config.module.ts new file mode 100644 index 000000000..866b505e0 --- /dev/null +++ b/src/remote-config/remote-config.module.ts @@ -0,0 +1,89 @@ +import { isPlatformServer } from '@angular/common'; +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + PLATFORM_ID, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { registerVersion } from 'firebase/app'; +import { RemoteConfig as FirebaseRemoteConfig } from 'firebase/remote-config'; +import { REMOTE_CONFIG_PROVIDER_NAME, RemoteConfig, RemoteConfigInstances } from './remote-config'; + +export const PROVIDED_REMOTE_CONFIG_INSTANCES = new InjectionToken('angularfire2.remote-config-instances'); + +export function defaultRemoteConfigInstanceFactory( + provided: FirebaseRemoteConfig[]|undefined, + defaultApp: FirebaseApp, + platformId: object, +) { + if (isPlatformServer(platformId)) { return null; } + const defaultRemoteConfig = ÉĩgetDefaultInstanceOf(REMOTE_CONFIG_PROVIDER_NAME, provided, defaultApp); + return defaultRemoteConfig && new RemoteConfig(defaultRemoteConfig); +} + +export function remoteConfigInstanceFactory(fn: (injector: Injector) => FirebaseRemoteConfig) { + return (zone: NgZone, injector: Injector, platformId: object) => { + if (isPlatformServer(platformId)) { return null; } + const remoteConfig = zone.runOutsideAngular(() => fn(injector)); + return new RemoteConfig(remoteConfig); + }; +} + +const REMOTE_CONFIG_INSTANCES_PROVIDER = { + provide: RemoteConfigInstances, + deps: [ + [new Optional(), PROVIDED_REMOTE_CONFIG_INSTANCES ], + ] +}; + +const DEFAULT_REMOTE_CONFIG_INSTANCE_PROVIDER = { + provide: RemoteConfig, + useFactory: defaultRemoteConfigInstanceFactory, + deps: [ + [new Optional(), PROVIDED_REMOTE_CONFIG_INSTANCES ], + FirebaseApp, + PLATFORM_ID, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_REMOTE_CONFIG_INSTANCE_PROVIDER, + REMOTE_CONFIG_INSTANCES_PROVIDER, + ] +}) +export class RemoteConfigModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'rc'); + } +} + +export function provideRemoteConfig( + fn: (injector: Injector) => FirebaseRemoteConfig, ...deps: any[] +): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'rc'); + + return makeEnvironmentProviders([ + DEFAULT_REMOTE_CONFIG_INSTANCE_PROVIDER, + REMOTE_CONFIG_INSTANCES_PROVIDER, + { + provide: PROVIDED_REMOTE_CONFIG_INSTANCES, + useFactory: remoteConfigInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + PLATFORM_ID, + ÉĩAngularFireSchedulers, + FirebaseApps, + ...deps, + ] + } + ]); +} diff --git a/src/remote-config/remote-config.spec.ts b/src/remote-config/remote-config.spec.ts new file mode 100644 index 000000000..fc2842062 --- /dev/null +++ b/src/remote-config/remote-config.spec.ts @@ -0,0 +1,38 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { RemoteConfig, getRemoteConfig, provideRemoteConfig } from '@angular/fire/remote-config'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +describe('RemoteConfig', () => { + let app: FirebaseApp; + let remoteConfig: RemoteConfig; + let providedRemoteConfig: RemoteConfig; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideRemoteConfig(() => { + providedRemoteConfig = getRemoteConfig(getApp(appName)); + return providedRemoteConfig; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + remoteConfig = TestBed.inject(RemoteConfig); + }); + + it('should be injectable', () => { + expect(providedRemoteConfig).toBeTruthy(); + expect(remoteConfig).toEqual(providedRemoteConfig); + expect(remoteConfig.app).toEqual(app); + }); + + }); + +}); diff --git a/src/remote-config/remote-config.ts b/src/remote-config/remote-config.ts new file mode 100644 index 000000000..91731da55 --- /dev/null +++ b/src/remote-config/remote-config.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { RemoteConfig as FirebaseRemoteConfig } from 'firebase/remote-config'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface RemoteConfig extends FirebaseRemoteConfig {} + +export class RemoteConfig { + constructor(remoteConfig: FirebaseRemoteConfig) { + return remoteConfig; + } +} + +export const REMOTE_CONFIG_PROVIDER_NAME = 'remote-config'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface RemoteConfigInstances extends Array {} + +export class RemoteConfigInstances { + constructor() { + return ÉĩgetAllInstancesOf(REMOTE_CONFIG_PROVIDER_NAME); + } +} + +export const remoteConfigInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(REMOTE_CONFIG_PROVIDER_NAME))), + distinct(), +); diff --git a/src/remote-config/rxfire.ts b/src/remote-config/rxfire.ts new file mode 100644 index 000000000..450c624e1 --- /dev/null +++ b/src/remote-config/rxfire.ts @@ -0,0 +1,15 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +import { ÉĩzoneWrap } from '@angular/fire'; +import { + getAll as _getAll, + getBoolean as _getBoolean, + getNumber as _getNumber, + getString as _getString, + getValue as _getValue +} from 'rxfire/remote-config'; + +export const getAllChanges = ÉĩzoneWrap(_getAll, true); +export const getBooleanChanges = ÉĩzoneWrap(_getBoolean, true); +export const getNumberChanges = ÉĩzoneWrap(_getNumber, true); +export const getStringChanges = ÉĩzoneWrap(_getString, true); +export const getValueChanges = ÉĩzoneWrap(_getValue, true); diff --git a/src/schematics/add/index.ts b/src/schematics/add/index.ts new file mode 100644 index 000000000..150be7c40 --- /dev/null +++ b/src/schematics/add/index.ts @@ -0,0 +1,16 @@ +import { SchematicContext, Tree } from '@angular-devkit/schematics'; +import { NodePackageInstallTask, RunSchematicTask } from '@angular-devkit/schematics/tasks'; +import { addDependencies } from '../common'; +import { DeployOptions } from '../interfaces'; +import { peerDependencies } from '../versions.json'; + +export const ngAdd = (options: DeployOptions) => (tree: Tree, context: SchematicContext) => { + addDependencies( + tree, + peerDependencies, + context + ); + const npmInstallTaskId = context.addTask(new NodePackageInstallTask()); + context.addTask(new RunSchematicTask('ng-add-setup-project', options), [npmInstallTaskId]); + return tree; +}; diff --git a/src/schematics/add/schema.json b/src/schematics/add/schema.json new file mode 100644 index 000000000..5b1ce2c4f --- /dev/null +++ b/src/schematics/add/schema.json @@ -0,0 +1,16 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema", + "$id": "angular-fire-ng-add", + "title": "AngularFire ng-add", + "type": "object", + "properties": { + "project": { + "type": "string", + "description": "The name of the project.", + "$default": { + "$source": "projectName" + } + } + }, + "required": [] + } diff --git a/src/schematics/builders.json b/src/schematics/builders.json new file mode 100644 index 000000000..0ca9a3307 --- /dev/null +++ b/src/schematics/builders.json @@ -0,0 +1,10 @@ +{ + "$schema": "../../node_modules/@angular-devkit/schematics/collection-schema.json", + "builders": { + "deploy": { + "implementation": "./deploy/builder", + "schema": "./deploy/schema.json", + "description": "Deploy builder" + } + } +} \ No newline at end of file diff --git a/src/schematics/collection.json b/src/schematics/collection.json new file mode 100644 index 000000000..be353c37d --- /dev/null +++ b/src/schematics/collection.json @@ -0,0 +1,15 @@ +{ + "$schema": "../../node_modules/@angular-devkit/schematics/collection-schema.json", + "schematics": { + "ng-add": { + "description": "Add firebase deploy schematic", + "factory": "./add#ngAdd", + "schema": "./add/schema.json" + }, + "ng-add-setup-project": { + "description": "Setup ng deploy", + "factory": "./setup#ngAddSetupProject", + "schema": "./setup/schema.json" + } + } +} diff --git a/src/schematics/common.ts b/src/schematics/common.ts new file mode 100644 index 000000000..83833c287 --- /dev/null +++ b/src/schematics/common.ts @@ -0,0 +1,67 @@ +import { SchematicContext, SchematicsException, Tree } from '@angular-devkit/schematics'; +import { intersects as semverIntersects } from 'semver'; +import { FirebaseHostingSite } from './interfaces'; + +export const shortSiteName = (site?: FirebaseHostingSite) => site?.name?.split('/').pop(); + +export const stringifyFormatted = (obj: any) => JSON.stringify(obj, null, 2); + +export const overwriteIfExists = ( + tree: Tree, + path: string, + content: string +) => { + if (tree.exists(path)) { + tree.overwrite(path, content); + } else { + tree.create(path, content); + } +}; + +export function safeReadJSON(path: string, tree: Tree) { + try { + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + return JSON.parse(tree.read(path)!.toString()); + } catch (e) { + throw new SchematicsException(`Error when parsing ${path}: ${e.message}`); + } +} + +export const addDependencies = ( + host: Tree, + deps: Record, + context: SchematicContext +) => { + const packageJson = + host.exists('package.json') && safeReadJSON('package.json', host); + + if (packageJson === undefined) { + throw new SchematicsException('Could not locate package.json'); + } + + packageJson.devDependencies ??= {}; + packageJson.dependencies ??= {}; + + Object.keys(deps).forEach(depName => { + const dep = deps[depName]; + const existingDeps = dep.dev ? packageJson.devDependencies : packageJson.dependencies; + const existingVersion = existingDeps[depName]; + if (existingVersion) { + try { + if (!semverIntersects(existingVersion, dep.version)) { + context.logger.warn(`⚠ī¸ The ${depName} devDependency specified in your package.json (${existingVersion}) does not fulfill AngularFire's dependency (${dep.version})`); + // TODO offer to fix + } + } catch (e) { + if (existingVersion !== dep.version) { + context.logger.warn(`⚠ī¸ The ${depName} devDependency specified in your package.json (${existingVersion}) does not fulfill AngularFire's dependency (${dep.version})`); + // TODO offer to fix + } + } + } else { + existingDeps[depName] = dep.version; + } + }); + + overwriteIfExists(host, 'package.json', stringifyFormatted(packageJson)); +}; diff --git a/src/schematics/deploy/actions.jasmine.ts b/src/schematics/deploy/actions.jasmine.ts new file mode 100644 index 000000000..abae2e375 --- /dev/null +++ b/src/schematics/deploy/actions.jasmine.ts @@ -0,0 +1,302 @@ +/* eslint-disable @typescript-eslint/no-empty-function */ +import { join } from 'path'; +import { BuilderContext, BuilderRun, ScheduleOptions, Target } from '@angular-devkit/architect'; +import { JsonObject, logging } from '@angular-devkit/core'; +import { BuildTarget, FSHost, FirebaseDeployConfig, FirebaseTools } from '../interfaces'; +import deploy, { deployToFunction } from './actions' +import 'jasmine'; + +let context: BuilderContext; +let firebaseMock: FirebaseTools; +let fsHost: FSHost; + +const FIREBASE_PROJECT = 'ikachu-aa3ef'; +const PROJECT = 'pirojok-project'; +const STATIC_BUILD_TARGET: BuildTarget = { + name: `${PROJECT}:build:production` +}; + +const FIREBASE_TOKEN = 'kkasllkascnkjnskjsdcskdckskdksdkjc'; + +const SERVER_BUILD_TARGET: BuildTarget = { + name: `${PROJECT}:server:production` +}; + +const login = () => Promise.resolve({ user: { email: 'foo@bar.baz' }}); +login.list = () => Promise.resolve([{ user: { email: 'foo@bar.baz' }}]); +login.add = () => Promise.resolve([{ user: { email: 'foo@bar.baz' }}]); +login.use = () => Promise.resolve('foo@bar.baz'); + +const workspaceRoot = join('home', 'user'); + +const initMocks = () => { + fsHost = { + moveSync(_: string, __: string) { + }, + renameSync(_: string, __: string) { + }, + writeFileSync(_: string, __: string) { + }, + copySync(_: string, __: string) { + }, + removeSync(_: string) { + }, + existsSync(_: string) { + return false; + }, + }; + + firebaseMock = { + login, + projects: { + list: () => Promise.resolve([]), + create: () => Promise.reject(), + }, + apps: { + list: () => Promise.resolve([]), + create: () => Promise.reject(), + sdkconfig: () => Promise.resolve({ fileName: '_', fileContents: '', sdkConfig: {}, }), + }, + hosting: { + sites: { + list: () => Promise.resolve({sites: []}), + create: () => Promise.reject(), + } + }, + init() { + return Promise.resolve() + }, + deploy: (_: FirebaseDeployConfig) => Promise.resolve(), + use: () => Promise.resolve(), + logger: { + add: () => { }, + logger: { + add: () => { } + } + }, + cli: { version: () => '9.0.0' }, + serve: () => Promise.resolve() + }; + + context = ({ + target: { + configuration: 'production', + project: PROJECT, + target: 'foo' + }, + builder: { + builderName: 'mock', + description: 'mock', + optionSchema: false + }, + currentDirectory: 'cwd', + id: 1, + logger: new logging.NullLogger() as any, + workspaceRoot: 'cwd', + getTargetOptions: (target: Target) => { + if (target.target === 'build') { + return { outputPath: 'dist/browser' }; + } else if (target.target === 'server') { + return { outputPath: 'dist/server' }; + } + }, + reportProgress: (_: number, __?: number, ___?: string) => { + }, + reportStatus: (_: string) => { + }, + reportRunning: () => { + }, + scheduleBuilder: (_: string, __?: JsonObject, ___?: ScheduleOptions) => Promise.resolve({} as BuilderRun), + scheduleTarget: (_: Target, __?: JsonObject, ___?: ScheduleOptions) => Promise.resolve({} as BuilderRun) + } as any); +}; + +describe('Deploy Angular apps', () => { + beforeEach(() => initMocks()); + + it('should call login', async () => { + const spy = spyOn(firebaseMock, 'login').and.resolveTo({ email: 'foo@bar.baz' }); + await deploy( + firebaseMock, context, STATIC_BUILD_TARGET, undefined, + undefined, undefined, { projectId: FIREBASE_PROJECT, preview: false } + ); + expect(spy).toHaveBeenCalled(); + }); + + it('should not call login', async () => { + const spy = spyOn(firebaseMock, 'login'); + await deploy(firebaseMock, context, STATIC_BUILD_TARGET, undefined, undefined, undefined, { preview: false }, FIREBASE_TOKEN); + expect(spy).not.toHaveBeenCalled(); + }); + + it('should invoke the builder', async () => { + const spy = spyOn(context, 'scheduleTarget').and.callThrough(); + await deploy(firebaseMock, context, STATIC_BUILD_TARGET, undefined, undefined, undefined, { preview: false }); + expect(spy).toHaveBeenCalled(); + expect(spy).toHaveBeenCalledWith({ + target: 'build', + configuration: 'production', + project: PROJECT + }, undefined); + }); + + it('should allow the buildTarget to be specified', async () => { + const buildTarget = { + name: `${PROJECT}:prerender`, + options: {} + }; + const spy = spyOn(context, 'scheduleTarget').and.callThrough(); + await deploy(firebaseMock, context, buildTarget, undefined, undefined, undefined, { preview: false }); + expect(spy).toHaveBeenCalled(); + expect(spy).toHaveBeenCalledWith({ target: 'prerender', project: PROJECT }, {}); + }); + + it('should invoke firebase.deploy', async () => { + const spy = spyOn(firebaseMock, 'deploy').and.callThrough(); + await deploy(firebaseMock, context, STATIC_BUILD_TARGET, undefined, undefined, undefined, { preview: false }, FIREBASE_TOKEN); + expect(spy).toHaveBeenCalled(); + expect(spy).toHaveBeenCalledWith({ + cwd: 'cwd', + only: 'hosting:' + PROJECT, + token: FIREBASE_TOKEN, + nonInteractive: true, + projectRoot: 'cwd', + }); + }); + + describe('error handling', () => { + it('throws if there is no firebase project', async () => { + try { + await deploy(firebaseMock, context, STATIC_BUILD_TARGET, undefined, undefined, undefined, { preview: false }); + } catch (e) { + expect(e.message).toMatch(/Cannot find firebase project/); + } + }); + + it('throws if there is no target project', async () => { + context.target = undefined; + try { + await deploy(firebaseMock, context, STATIC_BUILD_TARGET, undefined, undefined, undefined, { preview: false }); + } catch (e) { + expect(e.message).toMatch(/Cannot execute the build target/); + } + }); + }); +}); + +describe('universal deployment', () => { + beforeEach(() => initMocks()); + + it('should create a firebase function', async () => { + const spy = spyOn(fsHost, 'writeFileSync'); + await deployToFunction( + firebaseMock, + context, + workspaceRoot, + STATIC_BUILD_TARGET, + SERVER_BUILD_TARGET, + { preview: false }, + undefined, + fsHost + ); + + expect(spy).toHaveBeenCalledTimes(2); + + const packageArgs = spy.calls.argsFor(0); + const functionArgs = spy.calls.argsFor(1); + + expect(packageArgs[0]).toBe(join(workspaceRoot, 'dist', 'package.json')); + expect(functionArgs[0]).toBe(join(workspaceRoot, 'dist', 'index.js')); + }); + + it('should create a firebase function (new)', async () => { + const spy = spyOn(fsHost, 'writeFileSync'); + await deployToFunction( + firebaseMock, + context, + workspaceRoot, + STATIC_BUILD_TARGET, + SERVER_BUILD_TARGET, + { preview: false, outputPath: join('dist', 'functions') }, + undefined, + fsHost + ); + + expect(spy).toHaveBeenCalledTimes(2); + + const packageArgs = spy.calls.argsFor(0); + const functionArgs = spy.calls.argsFor(1); + + expect(packageArgs[0]).toBe(join(workspaceRoot, 'dist', 'functions', 'package.json')); + expect(functionArgs[0]).toBe(join(workspaceRoot, 'dist', 'functions', 'index.js')); + }); + + it('should rename the index.html file in the nested dist', async () => { + const spy = spyOn(fsHost, 'renameSync'); + await deployToFunction( + firebaseMock, + context, + workspaceRoot, + STATIC_BUILD_TARGET, + SERVER_BUILD_TARGET, + { preview: false }, + undefined, + fsHost + ); + + expect(spy).toHaveBeenCalledTimes(1); + + const packageArgs = spy.calls.argsFor(0); + + expect(packageArgs).toEqual([ + join(workspaceRoot, 'dist', 'dist', 'browser', 'index.html'), + join(workspaceRoot, 'dist', 'dist', 'browser', 'index.original.html') + ]); + }); + + it('should rename the index.html file in the nested dist (new)', async () => { + const spy = spyOn(fsHost, 'renameSync'); + await deployToFunction( + firebaseMock, + context, + workspaceRoot, + STATIC_BUILD_TARGET, + SERVER_BUILD_TARGET, + { preview: false, outputPath: join('dist', 'functions') }, + undefined, + fsHost + ); + + expect(spy).toHaveBeenCalledTimes(1); + + const packageArgs = spy.calls.argsFor(0); + + expect(packageArgs).toEqual([ + join(workspaceRoot, 'dist', 'functions', 'dist', 'browser', 'index.html'), + join(workspaceRoot, 'dist', 'functions', 'dist', 'browser', 'index.original.html') + ]); + }); + + it('should invoke firebase.deploy', async () => { + const spy = spyOn(firebaseMock, 'deploy'); + await deployToFunction( + firebaseMock, + context, + workspaceRoot, + STATIC_BUILD_TARGET, + SERVER_BUILD_TARGET, + { preview: false }, + undefined, + fsHost + ); + + expect(spy).toHaveBeenCalledTimes(1); + }); + + /* TODO figure out how to stub the prompt + it('should not deploy if the command is invoked with --preview', async () => { + const spy = spyOn(firebaseMock, 'deploy'); + await deployToFunction(firebaseMock, context, '/home/user', projectTargets, true, fsHost); + expect(spy).not.toHaveBeenCalled(); + });*/ +}); diff --git a/src/schematics/deploy/actions.ts b/src/schematics/deploy/actions.ts new file mode 100644 index 000000000..a4556124a --- /dev/null +++ b/src/schematics/deploy/actions.ts @@ -0,0 +1,508 @@ +import { SpawnOptionsWithoutStdio, execSync, spawn } from 'child_process'; +import { existsSync, readFileSync, renameSync, writeFileSync } from 'fs'; +import { dirname, join } from 'path'; +import { BuilderContext, targetFromTargetString } from '@angular-devkit/architect'; +import { SchematicsException } from '@angular-devkit/schematics'; +import { copySync, removeSync } from 'fs-extra'; +import * as inquirer from 'inquirer'; +import open from 'open'; +import { satisfies } from 'semver'; +import tripleBeam from 'triple-beam'; +import * as winston from 'winston'; +import { BuildTarget, CloudRunOptions, DeployBuilderSchema, FSHost, FirebaseTools } from '../interfaces'; +import { firebaseFunctionsDependencies } from '../versions.json'; +import { DEFAULT_FUNCTION_NAME, defaultFunction, defaultPackage, dockerfile, functionGen2 } from './functions-templates'; + +const DEFAULT_EMULATOR_PORT = 5000; +const DEFAULT_EMULATOR_HOST = 'localhost'; + +const DEFAULT_CLOUD_RUN_OPTIONS: Partial = { + memory: '1Gi', + timeout: 60, + maxInstances: 'default', + maxConcurrency: 'default', // TODO tune concurrency for cloud run + angular + minInstances: 'default', + cpus: 1, +}; + +const spawnAsync = async ( + command: string, + options?: SpawnOptionsWithoutStdio +) => + new Promise((resolve, reject) => { + const [spawnCommand, ...args] = command.split(/\s+/); + const spawnProcess = spawn(spawnCommand, args, options); + const chunks: Buffer[] = []; + const errorChunks: Buffer[] = []; + spawnProcess.stdout.on('data', (data) => { + process.stdout.write(data.toString()); + chunks.push(data); + }); + spawnProcess.stderr.on('data', (data) => { + process.stderr.write(data.toString()); + errorChunks.push(data); + }); + spawnProcess.on('error', (error) => { + reject(error); + }); + spawnProcess.on('close', (code) => { + if (code === 1) { + reject(Buffer.concat(errorChunks).toString()); + return; + } + resolve(Buffer.concat(chunks)); + }); + }); + +export type DeployBuilderOptions = DeployBuilderSchema & Record; + +const escapeRegExp = (str: string) => str.replace(/[-[\]/{}()*+?.\\^$|]/g, '\\$&'); + +const moveSync = (src: string, dest: string) => { + copySync(src, dest); + removeSync(src); +}; + +const deployToHosting = async ( + firebaseTools: FirebaseTools, + context: BuilderContext, + workspaceRoot: string, + options: DeployBuilderOptions, + firebaseToken?: string, +) => { + + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + const siteTarget = options.target ?? context.target!.project; + + if (options.preview) { + + await firebaseTools.serve({ + port: DEFAULT_EMULATOR_PORT, + host: DEFAULT_EMULATOR_HOST, + only: `hosting:${siteTarget}`, + nonInteractive: true, + projectRoot: workspaceRoot, + }); + + const { deployProject } = await inquirer.prompt({ + type: 'confirm', + name: 'deployProject', + message: 'Would you like to deploy your application to Firebase Hosting?' + }) as { deployProject: boolean }; + + if (!deployProject) { return; } + + process.env.FIREBASE_FRAMEWORKS_SKIP_BUILD = 'true'; + + } + + return await firebaseTools.deploy({ + only: `hosting:${siteTarget}`, + cwd: workspaceRoot, + token: firebaseToken, + nonInteractive: true, + projectRoot: workspaceRoot, + }); + +}; + +const defaultFsHost: FSHost = { + moveSync, + writeFileSync, + renameSync, + copySync, + removeSync, + existsSync, +}; + +const findPackageVersion = (packageManager: string, name: string) => { + const match = execSync(`${packageManager} list ${name}`).toString().match(`[^|s]${escapeRegExp(name)}[@| ][^s]+(s.+)?$`); + return match ? match[0].split(new RegExp(`${escapeRegExp(name)}[@| ]`))[1].split(/\s/)[0] : null; +}; + +const getPackageJson = (context: BuilderContext, workspaceRoot: string, options: DeployBuilderOptions, main?: string) => { + const dependencies: Record = {}; + const devDependencies: Record = {}; + if (options.ssr !== 'cloud-run') { + Object.keys(firebaseFunctionsDependencies).forEach(name => { + const { version, dev } = firebaseFunctionsDependencies[name]; + (dev ? devDependencies : dependencies)[name] = version; + }); + } + if (existsSync(join(workspaceRoot, 'angular.json'))) { + const angularJson = JSON.parse(readFileSync(join(workspaceRoot, 'angular.json')).toString()); + const packageManager = angularJson.cli?.packageManager ?? 'npm'; + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + const server = angularJson.projects[context.target!.project].architect.server; + const externalDependencies = server?.options?.externalDependencies || []; + const bundleDependencies = server?.options?.bundleDependencies ?? true; + if (bundleDependencies) { + externalDependencies.forEach(externalDependency => { + const packageVersion = findPackageVersion(packageManager, externalDependency); + if (packageVersion) { dependencies[externalDependency] = packageVersion; } + }); + } else { + if (existsSync(join(workspaceRoot, 'package.json'))) { + const packageJson = JSON.parse(readFileSync(join(workspaceRoot, 'package.json')).toString()); + Object.keys(packageJson.dependencies).forEach((dependency: string) => { + dependencies[dependency] = packageJson.dependencies[dependency]; + }); + } // TODO should we throw? + } + } + // TODO should we throw? + return defaultPackage(dependencies, devDependencies, options, main); +}; + +export const deployToFunction = async ( + firebaseTools: FirebaseTools, + context: BuilderContext, + workspaceRoot: string, + staticBuildTarget: BuildTarget, + serverBuildTarget: BuildTarget, + options: DeployBuilderOptions, + firebaseToken?: string, + fsHost: FSHost = defaultFsHost +) => { + + const staticBuildOptions = await context.getTargetOptions(targetFromTargetString(staticBuildTarget.name)); + if (!staticBuildOptions.outputPath || typeof staticBuildOptions.outputPath !== 'string') { + throw new Error( + `Cannot read the output path option of the Angular project '${staticBuildTarget.name}' in angular.json` + ); + } + + const serverBuildOptions = await context.getTargetOptions(targetFromTargetString(serverBuildTarget.name)); + if (!serverBuildOptions.outputPath || typeof serverBuildOptions.outputPath !== 'string') { + throw new Error( + `Cannot read the output path option of the Angular project '${serverBuildTarget.name}' in angular.json` + ); + } + + const staticOut = join(workspaceRoot, staticBuildOptions.outputPath); + const serverOut = join(workspaceRoot, serverBuildOptions.outputPath); + + const functionsOut = options.outputPath ? join(workspaceRoot, options.outputPath) : dirname(serverOut); + const functionName = options.functionName || DEFAULT_FUNCTION_NAME; + + const newStaticOut = join(functionsOut, staticBuildOptions.outputPath); + const newServerOut = join(functionsOut, serverBuildOptions.outputPath); + + // New behavior vs. old + if (options.outputPath) { + fsHost.removeSync(functionsOut); + fsHost.copySync(staticOut, newStaticOut); + fsHost.copySync(serverOut, newServerOut); + } else { + fsHost.moveSync(staticOut, newStaticOut); + fsHost.moveSync(serverOut, newServerOut); + } + + const packageJson = getPackageJson(context, workspaceRoot, options); + const nodeVersion = packageJson.engines.node; + + if (!satisfies(process.versions.node, nodeVersion.toString())) { + context.logger.warn( + `⚠ī¸ Your Node.js version (${process.versions.node}) does not match the Firebase Functions runtime (${nodeVersion}).` + ); + } + + const functionsPackageJsonPath = join(functionsOut, 'package.json'); + fsHost.writeFileSync( + functionsPackageJsonPath, + JSON.stringify(packageJson, null, 2) + ); + + if (options.CF3v2) { + fsHost.writeFileSync( + join(functionsOut, 'index.js'), + functionGen2(serverBuildOptions.outputPath, options, functionName) + ); + } else { + fsHost.writeFileSync( + join(functionsOut, 'index.js'), + defaultFunction(serverBuildOptions.outputPath, options, functionName) + ); + } + + if (!options.prerender) { + try { + fsHost.renameSync( + join(newStaticOut, 'index.html'), + join(newStaticOut, 'index.original.html') + ); + } catch (e) { /* empty */ } + } + + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + const siteTarget = options.target ?? context.target!.project; + + if (fsHost.existsSync(functionsPackageJsonPath)) { + execSync(`npm --prefix ${functionsOut} install`); + } else { + console.error(`No package.json exists at ${functionsOut}`); + } + + if (options.preview) { + + await firebaseTools.serve({ + port: DEFAULT_EMULATOR_PORT, + host: DEFAULT_EMULATOR_HOST, + targets: [`hosting:${siteTarget}`, `functions:${functionName}`], + nonInteractive: true, + projectRoot: workspaceRoot, + }); + + const { deployProject } = await inquirer.prompt({ + type: 'confirm', + name: 'deployProject', + message: 'Would you like to deploy your application to Firebase Hosting & Cloud Functions?' + }) as { deployProject: boolean }; + + if (!deployProject) { return; } + } + + return await firebaseTools.deploy({ + only: `hosting:${siteTarget},functions:${functionName}`, + cwd: workspaceRoot, + token: firebaseToken, + nonInteractive: true, + projectRoot: workspaceRoot, + }); + +}; + + +export const deployToCloudRun = async ( + firebaseTools: FirebaseTools, + context: BuilderContext, + workspaceRoot: string, + staticBuildTarget: BuildTarget, + serverBuildTarget: BuildTarget, + options: DeployBuilderOptions, + firebaseToken?: string, + fsHost: FSHost = defaultFsHost +) => { + + const staticBuildOptions = await context.getTargetOptions(targetFromTargetString(staticBuildTarget.name)); + if (!staticBuildOptions.outputPath || typeof staticBuildOptions.outputPath !== 'string') { + throw new Error( + `Cannot read the output path option of the Angular project '${staticBuildTarget.name}' in angular.json` + ); + } + + const serverBuildOptions = await context.getTargetOptions(targetFromTargetString(serverBuildTarget.name)); + if (!serverBuildOptions.outputPath || typeof serverBuildOptions.outputPath !== 'string') { + throw new Error( + `Cannot read the output path option of the Angular project '${serverBuildTarget.name}' in angular.json` + ); + } + + const staticOut = join(workspaceRoot, staticBuildOptions.outputPath); + const serverOut = join(workspaceRoot, serverBuildOptions.outputPath); + + const cloudRunOut = options.outputPath ? join(workspaceRoot, options.outputPath) : join(dirname(serverOut), 'run'); + const serviceId = options.functionName || DEFAULT_FUNCTION_NAME; + + const newStaticOut = join(cloudRunOut, staticBuildOptions.outputPath); + const newServerOut = join(cloudRunOut, serverBuildOptions.outputPath); + + // This is needed because in the server output there's a hardcoded dependency on $cwd/dist/browser, + // This assumes that we've deployed our application dist directory and we're running the server + // in the parent directory. To have this precondition, we move dist/browser to dist/dist/browser + // since the firebase function runs the server from dist. + fsHost.removeSync(cloudRunOut); + fsHost.copySync(staticOut, newStaticOut); + fsHost.copySync(serverOut, newServerOut); + + const packageJson = getPackageJson(context, workspaceRoot, options, join(serverBuildOptions.outputPath, 'main.js')); + const nodeVersion = packageJson.engines.node; + + if (!satisfies(process.versions.node, nodeVersion.toString())) { + context.logger.warn( + `⚠ī¸ Your Node.js version (${process.versions.node}) does not match the Cloud Run runtime (${nodeVersion}).` + ); + } + + fsHost.writeFileSync( + join(cloudRunOut, 'package.json'), + JSON.stringify(packageJson, null, 2), + ); + + fsHost.writeFileSync( + join(cloudRunOut, 'Dockerfile'), + dockerfile(options) + ); + + if (!options.prerender) { + try { + fsHost.renameSync( + join(newStaticOut, 'index.html'), + join(newStaticOut, 'index.original.html') + ); + } catch (e) { /* empty */ } + } + + if (options.preview) { + throw new SchematicsException('Cloud Run preview not supported.'); + } + + const deployArguments: any[] = []; + const cloudRunOptions = options.cloudRunOptions || {}; + Object.entries(DEFAULT_CLOUD_RUN_OPTIONS).forEach(([k, v]) => { + cloudRunOptions[k] ||= v; + }); + // lean on the schema for validation (rather than sanitize) + if (cloudRunOptions.cpus) { deployArguments.push('--cpu', cloudRunOptions.cpus); } + if (cloudRunOptions.maxConcurrency) { deployArguments.push('--concurrency', cloudRunOptions.maxConcurrency); } + if (cloudRunOptions.maxInstances) { deployArguments.push('--max-instances', cloudRunOptions.maxInstances); } + if (cloudRunOptions.memory) { deployArguments.push('--memory', cloudRunOptions.memory); } + if (cloudRunOptions.minInstances) { deployArguments.push('--min-instances', cloudRunOptions.minInstances); } + if (cloudRunOptions.timeout) { deployArguments.push('--timeout', cloudRunOptions.timeout); } + if (cloudRunOptions.vpcConnector) { deployArguments.push('--vpc-connector', cloudRunOptions.vpcConnector); } + + // TODO validate serviceId, firebaseProject, and vpcConnector both to limit errors and opp for injection + + context.logger.info(`đŸ“Ļ Deploying to Cloud Run`); + await spawnAsync(`gcloud builds submit ${cloudRunOut} --tag gcr.io/${options.firebaseProject}/${serviceId} --project ${options.firebaseProject} --quiet`); + await spawnAsync(`gcloud run deploy ${serviceId} --image gcr.io/${options.firebaseProject}/${serviceId} --project ${options.firebaseProject} ${deployArguments.join(' ')} --platform managed --allow-unauthenticated --region=${options.region} --quiet`); + + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + const siteTarget = options.target ?? context.target!.project; + + // TODO deploy cloud run + return await firebaseTools.deploy({ + only: `hosting:${siteTarget}`, + cwd: workspaceRoot, + token: firebaseToken, + nonInteractive: true, + projectRoot: workspaceRoot, + }); +}; + +export default async function deploy( + firebaseTools: FirebaseTools, + context: BuilderContext, + staticBuildTarget: BuildTarget, + serverBuildTarget: BuildTarget | undefined, + prerenderBuildTarget: BuildTarget | undefined, + firebaseProject: string, + options: DeployBuilderOptions, + firebaseToken?: string, +) { + const legacyNgDeploy = !options.version || options.version < 2; + + if (!firebaseToken && !process.env.GOOGLE_APPLICATION_CREDENTIALS) { + await firebaseTools.login(); + const user = await firebaseTools.login({ projectRoot: context.workspaceRoot }); + console.log(`Logged into Firebase as ${user.email}.`); + } + + if (!firebaseToken && process.env.GOOGLE_APPLICATION_CREDENTIALS) { + await spawnAsync(`gcloud auth activate-service-account --key-file ${process.env.GOOGLE_APPLICATION_CREDENTIALS}`); + console.log(`Using Google Application Credentials.`); + } + + if (legacyNgDeploy) { + console.error(`Legacy ng-deploy Firebase is deprecated. +Please migrate to Firebase Hosting's integration with Angular https://firebase.google.com/docs/hosting/frameworks/angular +or the new Firebase App Hosting product https://firebase.google.com/docs/app-hosting`); + } + + if (prerenderBuildTarget) { + const run = await context.scheduleTarget( + targetFromTargetString(prerenderBuildTarget.name), + prerenderBuildTarget.options + ); + await run.result; + + } else { + + if (!context.target) { + throw new Error('Cannot execute the build target'); + } + + context.logger.info(`đŸ“Ļ Building "${context.target.project}"`); + + const builders = [ + context.scheduleTarget( + targetFromTargetString(staticBuildTarget.name), + staticBuildTarget.options + ).then(run => run.result) + ]; + + if (serverBuildTarget) { + builders.push(context.scheduleTarget( + targetFromTargetString(serverBuildTarget.name), + serverBuildTarget.options + ).then(run => run.result)); + } + + await Promise.all(builders); + } + + + try { + await firebaseTools.use(firebaseProject, { + project: firebaseProject, + projectRoot: context.workspaceRoot, + }); + } catch (e) { + throw new Error(`Cannot select firebase project '${firebaseProject}'`); + } + + options.firebaseProject = firebaseProject; + + const logger = new winston.transports.Console({ + level: 'info', + format: winston.format.printf((info) => { + const emulator = info[tripleBeam.SPLAT as any]?.[1]?.metadata?.emulator; + const text = info[tripleBeam.SPLAT as any]?.[0]; + if (text?.replace) { + // eslint-disable-next-line no-control-regex + const plainText = text.replace(/\x1B\[([0-9]{1,2}(;[0-9]{1,2})?)?[mGK]/g, ''); + if (emulator?.name === 'hosting' && plainText.startsWith('Local server: ')) { + open(plainText.split(': ')[1]); + } + } + return [info.message, ...(info[tripleBeam.SPLAT as any] || []) as any] + .filter((chunk) => typeof chunk === 'string') + .join(' '); + }) + }); + + firebaseTools.logger.logger.add(logger); + + if (legacyNgDeploy && serverBuildTarget) { + if (options.ssr === 'cloud-run') { + await deployToCloudRun( + firebaseTools, + context, + context.workspaceRoot, + staticBuildTarget, + serverBuildTarget, + options, + firebaseToken, + ); + } else { + await deployToFunction( + firebaseTools, + context, + context.workspaceRoot, + staticBuildTarget, + serverBuildTarget, + options, + firebaseToken, + ); + } + } else { + await deployToHosting( + firebaseTools, + context, + context.workspaceRoot, + options, + firebaseToken, + ); + } + +} diff --git a/src/schematics/deploy/builder.ts b/src/schematics/deploy/builder.ts new file mode 100644 index 000000000..e36d6c43e --- /dev/null +++ b/src/schematics/deploy/builder.ts @@ -0,0 +1,72 @@ +import { BuilderContext, BuilderOutput, createBuilder } from '@angular-devkit/architect'; +import { getFirebaseTools } from '../firebaseTools'; +import { BuildTarget } from '../interfaces'; +import { getFirebaseProjectNameFromFs } from '../utils'; +import deploy, { DeployBuilderOptions } from './actions'; + +// Call the createBuilder() function to create a builder. This mirrors +// createJobHandler() but add typings specific to Architect Builders. +export default createBuilder( + async (options: DeployBuilderOptions, context: BuilderContext): Promise => { + if (!context.target) { + throw new Error('Cannot deploy the application without a target'); + } + + const [defaultFirebaseProject, defulatFirebaseHostingSite] = getFirebaseProjectNameFromFs( + context.workspaceRoot, + context.target.project + ); + + const firebaseProject = options.firebaseProject || defaultFirebaseProject; + if (!firebaseProject) { + throw new Error('Cannot determine the Firebase Project from your angular.json or .firebaserc'); + } + if (firebaseProject !== defaultFirebaseProject) { + throw new Error('The Firebase Project specified by your angular.json or .firebaserc is in conflict'); + } + + const firebaseHostingSite = options.firebaseHostingSite || defulatFirebaseHostingSite; + if (!firebaseHostingSite) { + throw new Error(`Cannot determine the Firebase Hosting Site from your angular.json or .firebaserc`); + } + if (firebaseHostingSite !== defulatFirebaseHostingSite) { + throw new Error('The Firebase Hosting Site specified by your angular.json or .firebaserc is in conflict'); + } + + const staticBuildTarget = { name: options.browserTarget || options.buildTarget || `${context.target.project}:build:production` }; + + let prerenderBuildTarget: BuildTarget | undefined; + if (options.prerender) { + prerenderBuildTarget = { + name: options.prerenderTarget || `${context.target.project}:prerender:production` + }; + } + + let serverBuildTarget: BuildTarget | undefined; + if (options.ssr) { + serverBuildTarget = { + name: options.serverTarget || options.universalBuildTarget || `${context.target.project}:server:production` + }; + } + + try { + process.env.FIREBASE_DEPLOY_AGENT = 'angularfire'; + await deploy( + (await getFirebaseTools()), + context, + staticBuildTarget, + serverBuildTarget, + prerenderBuildTarget, + firebaseProject, + options, + process.env.FIREBASE_TOKEN, + ); + } catch (e) { + console.error('Error when trying to deploy: '); + console.error(e.message); + return { success: false }; + } + + return { success: true }; + } +); diff --git a/src/schematics/deploy/functions-templates.ts b/src/schematics/deploy/functions-templates.ts new file mode 100644 index 000000000..4005675c9 --- /dev/null +++ b/src/schematics/deploy/functions-templates.ts @@ -0,0 +1,76 @@ +import { DeployBuilderOptions } from './actions'; + +export const DEFAULT_NODE_VERSION = 14; +export const DEFAULT_FUNCTION_NAME = 'ssr'; + +const DEFAULT_FUNCTION_REGION = 'us-central1'; + +const DEFAULT_RUNTIME_OPTIONS = { + timeoutSeconds: 60, + memory: '1GB' +}; + +export const defaultPackage = ( + dependencies: Record, + devDependencies: Record, + options: DeployBuilderOptions, + main?: string, +) => ({ + name: 'functions', + description: 'Angular Universal Application', + main: main ?? 'index.js', + scripts: { + start: main ? `node ${main}` : 'firebase functions:shell', + }, + engines: { + node: (options.functionsNodeVersion || DEFAULT_NODE_VERSION).toString() + }, + dependencies, + devDependencies, + private: true +}); + +export const defaultFunction = ( + path: string, + options: DeployBuilderOptions, + functionName: string|undefined, +) => `const functions = require('firebase-functions'); + +// Increase readability in Cloud Logging +require("firebase-functions/lib/logger/compat"); + +const expressApp = require('./${path}/main').app(); + +exports.${functionName || DEFAULT_FUNCTION_NAME} = functions + .region('${options.region || DEFAULT_FUNCTION_REGION}') + .runWith(${JSON.stringify(options.functionsRuntimeOptions || DEFAULT_RUNTIME_OPTIONS)}) + .https + .onRequest(expressApp); +`; + +export const functionGen2 = ( + path: string, + options: DeployBuilderOptions, + functionName: string|undefined, +) => `const { onRequest } = require('firebase-functions/v2/https'); + +// Increase readability in Cloud Logging +require("firebase-functions/lib/logger/compat"); + +const expressApp = require('./${path}/main').app(); + +exports.${functionName || DEFAULT_FUNCTION_NAME} = onRequest(${JSON.stringify({ + region: options.region || DEFAULT_FUNCTION_REGION, + ...(options.functionsRuntimeOptions || DEFAULT_RUNTIME_OPTIONS) +})}, expressApp); +`; + +export const dockerfile = ( + options: DeployBuilderOptions, +) => `FROM node:${options.functionsNodeVersion || DEFAULT_NODE_VERSION}-slim +WORKDIR /usr/src/app +COPY package*.json ./ +RUN npm install --only=production +COPY . ./ +CMD [ "npm", "start" ] +`; diff --git a/src/schematics/deploy/schema.json b/src/schematics/deploy/schema.json new file mode 100644 index 000000000..6335d3a8d --- /dev/null +++ b/src/schematics/deploy/schema.json @@ -0,0 +1,119 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema", + "$id": "FirebaseDeploySchema", + "title": "Firebase Deploy", + "description": "Ng Deploy target options for Firebase.", + "properties": { + "buildTarget": { + "type": "string", + "description": "Target to build.", + "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$" + }, + "browserTarget": { + "type": "string", + "description": "Target to build.", + "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$" + }, + "prerenderTarget": { + "type": "string", + "description": "Target to build.", + "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$" + }, + "serverTarget": { + "type": "string", + "description": "Target to build.", + "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$" + }, + "universalBuildTarget": { + "type": "string", + "description": "Target to build.", + "pattern": "^[^:\\s]+:[^:\\s]+(:[^\\s]+)?$" + }, + "ssr": { + "oneOf": [{ "type": "boolean" }, { "type": "string" }], + "description": "Should we attempt to deploy the function to Cloud Functions (true or 'cloud-functions') / Cloud Run ('cloud-run') or just Hosting (false)" + }, + "prerender": { + "type": "boolean", + "description": "Prerender before deploy?" + }, + "firebaseProject": { + "type": "string", + "description": "The Firebase project name or project alias to use when deploying" + }, + "target": { + "type": "string", + "description": "The Firebase hosting target in firebase.json for multi-site" + }, + "firebaseHostingSite": { + "type": "string", + "description": "The Firebase Hosting site to deploy to" + }, + "functionName": { + "type": "string", + "description": "The name of the Cloud Function or Cloud Run serviceId to deploy SSR to" + }, + "functionsNodeVersion": { + "oneOf": [{ "type": "number" }, { "type": "string" }], + "description": "Version of Node.js to run Cloud Functions / Run on" + }, + "CF3v2": { + "type": "boolean", + "description": "Generation of the Functions product to run on" + }, + "region": { + "type": "string", + "description": "The region to deploy Cloud Functions or Cloud Run to" + }, + "outputPath": { + "type": "string", + "description": "Where to output the deploy artifacts" + }, + "functionsRuntimeOptions": { + "type": "object", + "description": "Runtime options for Cloud Functions, if deploying to Cloud Functions" + }, + "preview": { + "type": "boolean", + "description": "Do not deploy the application, just set up the Firebase Function in the project output directory. Can be used for testing the Firebase Function with `firebase serve`." + }, + "cloudRunOptions": { + "type": "object", + "description": "Options passed to Cloud Run, if deploying to Cloud Run.", + "properties": { + "cpus": { + "type": "number", + "description": "Set a CPU limit in Kubernetes cpu units." + }, + "maxConcurrency": { + "oneOf": [{ "type": "number" }, { "type": "string" }], + "pattern": "^(\\d+|default)$", + "description": "Set the maximum number of concurrent requests allowed per container instance. If concurrency is unspecified, any number of concurrent requests are allowed. To unset this field, provide the special value default." + }, + "maxInstances": { + "oneOf": [{ "type": "number" }, { "type": "string" }], + "pattern": "^(\\d+|default)$", + "description": "The maximum number of container instances of the Service to run. Use 'default' to unset the limit and use the platform default." + }, + "memory": { + "type": "string", + "pattern": "^\\d+(G|M)i$", + "description": "Set a memory limit. Ex: 1Gi, 512Mi." + }, + "minInstances": { + "oneOf": [{ "type": "number" }, { "type": "string" }], + "pattern": "^(\\d+|default)$", + "description": "The minimum number of container instances of the Service to run or 'default' to remove any minimum." + }, + "timeout": { + "type": "number", + "description": "Set the maximum request execution time (timeout) in seconds." + }, + "vpcConnector": { + "type": "string", + "description": "Set a VPC connector for this resource." + } + } + } + } +} diff --git a/src/schematics/firebaseTools.ts b/src/schematics/firebaseTools.ts new file mode 100644 index 000000000..2d8c394b1 --- /dev/null +++ b/src/schematics/firebaseTools.ts @@ -0,0 +1,52 @@ +/* eslint-disable @typescript-eslint/no-var-requires */ +import { execSync, spawn } from 'child_process'; +import ora from 'ora'; +import { compare as semverCompare } from 'semver'; +import { FirebaseTools } from './interfaces'; + +declare global { + var firebaseTools: FirebaseTools|undefined; +} + +export const getFirebaseTools = () => globalThis.firebaseTools ? + Promise.resolve(globalThis.firebaseTools) : + new Promise((resolve, reject) => { + process.env.FIREBASE_CLI_EXPERIMENTS ||= 'webframeworks'; + try { + resolve(require('firebase-tools')); + } catch (e) { + try { + const root = execSync('npm root --location=global').toString().trim(); + resolve(require(`${root}/firebase-tools`)); + } catch (e) { + const spinner = ora({ + text: `Installing firebase-tools...`, + // Workaround for https://github.com/sindresorhus/ora/issues/136. + discardStdin: process.platform !== 'win32', + }).start(); + spawn('npm', ['i', '--location=global', 'firebase-tools'], { + stdio: 'pipe', + shell: true, + }).on('close', (code) => { + if (code === 0) { + spinner.succeed('firebase-tools installed globally.'); + spinner.stop(); + const root = execSync('npm root -g').toString().trim(); + resolve(require(`${root}/firebase-tools`)); + } else { + spinner.fail('Package install failed.'); + reject(); + } + }); + } + } + }).then(firebaseTools => { + globalThis.firebaseTools = firebaseTools; + const version = firebaseTools.cli.version(); + console.log(`Using firebase-tools version ${version}`); + if (semverCompare(version, '14.0.0') === -1) { + console.error('firebase-tools version 13.0.0+ is required, please upgrade and run again'); + return Promise.reject(); + } + return firebaseTools; + }); diff --git a/src/schematics/interfaces.ts b/src/schematics/interfaces.ts new file mode 100644 index 000000000..a21df2168 --- /dev/null +++ b/src/schematics/interfaces.ts @@ -0,0 +1,267 @@ +import type { HttpsOptions } from 'firebase-functions/https'; + +export const enum FEATURES { + Authentication, + Analytics, + AppCheck, + Database, + DataConnect, + Functions, + Messaging, + Performance, + Firestore, + Storage, + RemoteConfig, + VertexAI, +} + +export const featureOptions = [ + { name: 'Authentication', value: FEATURES.Authentication }, + { name: 'Google Analytics', value: FEATURES.Analytics }, + { name: 'App Check', value: FEATURES.AppCheck }, + { name: 'Firestore', value: FEATURES.Firestore }, + { name: 'Realtime Database', value: FEATURES.Database }, + { name: 'Data Connect', value: FEATURES.DataConnect }, + { name: 'Cloud Functions (callable)', value: FEATURES.Functions }, + { name: 'Cloud Messaging', value: FEATURES.Messaging }, + { name: 'Performance Monitoring', value: FEATURES.Performance }, + { name: 'Cloud Storage', value: FEATURES.Storage }, + { name: 'Remote Config', value: FEATURES.RemoteConfig }, + { name: 'Vertex AI', value: FEATURES.VertexAI }, +]; + +export const enum PROJECT_TYPE { Static, CloudFunctions, CloudRun, WebFrameworks } + +export interface NgAddOptions { + firebaseProject: string; + project?: string; +} + +export interface NgAddNormalizedOptions { + project: string; + firebaseProject: FirebaseProject; + firebaseApp: FirebaseApp|undefined; + firebaseHostingSite: FirebaseHostingSite|undefined; + sdkConfig: Record|undefined; + buildTarget: [string,string]|undefined; + serveTarget: [string,string]|undefined; + ssrRegion: string|undefined; +} + +export interface DeployOptions { + project?: string; +} + +export interface FirebaseProject { + projectId: string; + projectNumber: string; + displayName: string; + name: string; + resources: Record; + state: string; +} + +export interface FirebaseDeployConfig { + cwd: string; + only?: string; + token?: string; + [key: string]: any; +} + +export interface FirebaseApp { + name: string; + displayName: string; + platform: string; + appId: string; + namespace: string; +} + +export interface FirebaseHostingSite { + name: string; + defaultUrl: string; + type: string; + appId: string|undefined; +} + +export interface FirebaseSDKConfig { + fileName: string; + fileContents: string; + sdkConfig: Record; +} + +export interface FirebaseTools { + projects: { + list(options: any): Promise; + create(projectId: string|undefined, options: any): Promise; + }; + + apps: { + list(platform: string|undefined, options: any): Promise; + create(platform: string, displayName: string|undefined, options: any): Promise; + sdkconfig(type: string, projectId: string, options: any): Promise; + }; + + hosting: { + sites: { + list(options: any): Promise<{ sites: FirebaseHostingSite[]}>; + create(siteId: string, options: any): Promise; + } + }; + + logger: { + // firebase-tools v8 + add: (...args: any[]) => any + // firebase-tools v9 + logger: { + add: (...args: any[]) => any; + } + }; + + cli: { + version(): string; + }; + + login: { + list(): Promise<{user: Record}[] | { users: undefined }>; + add(): Promise>; + use(email: string, options?: unknown): Promise; + } & ((options?: unknown) => Promise>); + + deploy(config: FirebaseDeployConfig): Promise; + + serve(options: any): Promise; + + use(options: any, lol: any): Promise; + + init(feature: string, options: any): Promise; +} + +export interface FirebaseHostingRewrite { + source: string; + destination?: string; + function?: string; +} + +export interface FirebaseHostingConfig { + public?: string; + ignore?: string[]; + target?: string; + rewrites?: FirebaseHostingRewrite[]; +} + +export type FirebaseFunctionsConfig = Record; + +export interface DataConnectConfig { + source?: string; +} + +export interface FirebaseJSON { + hosting?: FirebaseHostingConfig[] | FirebaseHostingConfig; + functions?: FirebaseFunctionsConfig; + dataconnect?: DataConnectConfig; +} + +export interface FirebaseRcTarget { + hosting: Record; +} + +export interface FirebaseRc { + targets?: Record; + projects?: Record; +} + +export interface DeployBuilderSchema { + buildTarget?: string; + browserTarget?: string; + firebaseProject?: string; + firebaseHostingSite?: string; + preview?: boolean; + target?: boolean; + universalBuildTarget?: string; + serverTarget?: string; + prerenderTarget?: string; + ssr?: boolean | string; + region?: string; + prerender?: boolean; + functionName?: string; + functionsNodeVersion?: number|string; + functionsRuntimeOptions?: HttpsOptions; + cloudRunOptions?: Partial; + outputPath?: string; + CF3v2?: boolean; + version?: number; +} + +export interface CloudRunOptions { + cpus: number; + maxConcurrency: number | 'default'; + maxInstances: number | 'default'; + memory: string; + minInstances: number | 'default'; + timeout: number; + vpcConnector: string; +} + +export interface BuildTarget { + name: string; + options?: Record; +} + +export interface FSHost { + moveSync(src: string, dest: string): void; + writeFileSync(src: string, data: string): void; + renameSync(src: string, dest: string): void; + copySync(src: string, dest: string): void; + removeSync(src: string): void; + existsSync(src: string): boolean; +} + +export interface WorkspaceProject { + root: string; + sourceRoot?: string; + projectType?: string; + architect?: Record, + configurations?: Record>, + defaultConfiguration?: string, + }>; +} + +export interface Workspace { + defaultProject?: string; + projects: Record; +} + +export interface ConnectorConfig { + location: string; + connector: string; + service: string; +} +export interface ConnectorYaml { + connectorId: string; + generate?: { + javascriptSdk?: { + package: string; + outputDir: string; + packageJsonDir?: string; + angular?: boolean; + } + } +} +export interface DataConnectYaml { + location: string; + serviceId: string; + connectorDirs: string[]; +} +export interface DataConnectConnectorConfig { + connectorYaml: ConnectorYaml; + connectorConfig?: ConnectorConfig; + angular?: boolean; + package?: string; +} + +export interface PackageJson { + dependencies: Record; + devDependencies: Record; +} diff --git a/src/schematics/migration.json b/src/schematics/migration.json new file mode 100644 index 000000000..453d5a9e3 --- /dev/null +++ b/src/schematics/migration.json @@ -0,0 +1,15 @@ +{ + "$schema": "../../node_modules/@angular-devkit/schematics/collection-schema.json", + "schematics": { + "migration-v7": { + "version": "7.0.0", + "description": "Update @angular/fire to v7", + "factory": "./update/v7#ngUpdate" + }, + "ng-post-upgate": { + "description": "Print out results after ng-update", + "factory": "./update#ngPostUpdate", + "private": true + } + } +} \ No newline at end of file diff --git a/src/schematics/setup/index.ts b/src/schematics/setup/index.ts new file mode 100644 index 000000000..06e29f789 --- /dev/null +++ b/src/schematics/setup/index.ts @@ -0,0 +1,138 @@ +import { readFileSync, writeFileSync } from 'fs'; +import { join } from 'path'; +import { asWindowsPath, normalize } from '@angular-devkit/core'; +import { SchematicContext, Tree, chain } from '@angular-devkit/schematics'; +import { addRootProvider } from '@schematics/angular/utility'; +import { getFirebaseTools } from '../firebaseTools'; +import { + DataConnectConnectorConfig, + DeployOptions, FEATURES, FirebaseApp, FirebaseJSON, FirebaseProject, +} from '../interfaces'; +import { + addIgnoreFiles, + featureToRules, + getFirebaseProjectNameFromHost, + getProject, + parseDataConnectConfig, + setupTanstackDependencies, +} from '../utils'; +import { appPrompt, featuresPrompt, projectPrompt, userPrompt } from './prompts'; + +export interface SetupConfig extends DeployOptions { + firebaseProject: FirebaseProject, + firebaseApp?: FirebaseApp, + sdkConfig?: Record, + firebaseJsonConfig?: FirebaseJSON; + dataConnectConfig?: DataConnectConnectorConfig | null; + firebaseJsonPath: string; +} + +export const setupProject = + (tree: Tree, context: SchematicContext, features: FEATURES[], config: SetupConfig) => { + const { projectName } = getProject(config, tree); + + addIgnoreFiles(tree); + + if (features.length) { + return chain([ + addRootProvider(projectName, ({code, external}) => { + external('initializeApp', '@angular/fire/app'); + return code`${external('provideFirebaseApp', '@angular/fire/app')}(() => initializeApp(${ + config.sdkConfig ? `{ ${Object.entries(config.sdkConfig).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join(", ")} }` : "" + }))`; + }), + ...featureToRules(features, projectName, config.dataConnectConfig), + ]); + } +}; + +export const ngAddSetupProject = ( + options: DeployOptions +) => async (host: Tree, context: SchematicContext) => { + + // TODO is there a public API for this? + let projectRoot: string = (host as any)._backend._root; + if (process.platform.startsWith('win32')) { projectRoot = asWindowsPath(normalize(projectRoot)); } + + const features = await featuresPrompt(); + + if (features.length > 0) { + + const firebaseTools = await getFirebaseTools(); + + // Add the firebase files if they don't exist already so login.use works + if (!host.exists('/firebase.json')) { writeFileSync(join(projectRoot, 'firebase.json'), '{}'); } + + let firebaseJson: FirebaseJSON = JSON.parse( + readFileSync(join(projectRoot, "firebase.json")).toString() + ); + + const user = await userPrompt({ projectRoot }); + const defaultUser = await firebaseTools.login(options); + if (user.email !== defaultUser?.email) { + await firebaseTools.login.use(user.email, { projectRoot }); + } + + const { projectName: ngProjectName } = getProject(options, host); + + const [ defaultProjectName ] = getFirebaseProjectNameFromHost(host, ngProjectName); + + const firebaseProject = await projectPrompt(defaultProjectName, { projectRoot, account: user.email }); + + let firebaseApp: FirebaseApp|undefined; + let sdkConfig: Record|undefined; + + const setupConfig: SetupConfig = { + ...options, firebaseProject, firebaseApp, sdkConfig, + firebaseJsonConfig: firebaseJson, + firebaseJsonPath: projectRoot + }; + if (features.length) { + + firebaseApp = await appPrompt(firebaseProject, undefined, { projectRoot }); + + const result = await firebaseTools.apps.sdkconfig('web', firebaseApp.appId, { nonInteractive: true, projectRoot }); + sdkConfig = result.sdkConfig; + delete sdkConfig.locationId; + setupConfig.sdkConfig = sdkConfig; + setupConfig.firebaseApp = firebaseApp; + // set up data connect locally if data connect hasn't already been initialized. + if(features.includes(FEATURES.DataConnect)) { + if (!firebaseJson.dataconnect) { + try { + await firebaseTools.init("dataconnect", { + projectRoot, + project: firebaseProject.projectId, + }); + // Update firebaseJson values to include newly added dataconnect field in firebase.json. + firebaseJson = JSON.parse( + readFileSync(join(projectRoot, "firebase.json")).toString() + ); + setupConfig.firebaseJsonConfig = firebaseJson; + } catch (e) { + console.error(e); + } + } + let dataConnectConfig = parseDataConnectConfig(setupConfig); + if(!dataConnectConfig?.connectorYaml.generate?.javascriptSdk) { + await firebaseTools.init("dataconnect:sdk", { + projectRoot, + project: firebaseProject.projectId, + }); + } + // Parse through sdk again + dataConnectConfig = parseDataConnectConfig(setupConfig); + if(dataConnectConfig?.angular) { + context.logger.info('Generated Angular SDK Enabled.'); + } else { + context.logger.info('Generated Angular SDK Disabled. Please add `angular: true` to your connector.yaml'); + } + setupTanstackDependencies(host, context); + setupConfig.dataConnectConfig = dataConnectConfig; + } + + } + + return setupProject(host, context, features, setupConfig); + } +}; diff --git a/src/schematics/setup/prompts.ts b/src/schematics/setup/prompts.ts new file mode 100644 index 000000000..1bc8a85ca --- /dev/null +++ b/src/schematics/setup/prompts.ts @@ -0,0 +1,175 @@ +import { spawnSync } from 'child_process'; +import * as fuzzy from 'fuzzy'; +import * as inquirer from 'inquirer'; +import { getFirebaseTools } from '../firebaseTools'; +import { FEATURES, FirebaseApp, FirebaseProject, featureOptions } from '../interfaces'; +import { shortAppId } from '../utils'; + +// eslint-disable-next-line @typescript-eslint/no-var-requires +inquirer.registerPrompt('autocomplete', require('inquirer-autocomplete-prompt')); + +const NEW_OPTION = '~~angularfire-new~~'; + +// `fuzzy` passes either the original list of projects or an internal object +// which contains the project as a property. +const isProject = (elem: FirebaseProject | fuzzy.FilterResult): elem is FirebaseProject => { + return (elem as { original: FirebaseProject }).original === undefined; +}; + +const isApp = (elem: FirebaseApp | fuzzy.FilterResult): elem is FirebaseApp => { + return (elem as { original: FirebaseApp }).original === undefined; +}; + +export const searchProjects = (projects: FirebaseProject[]) => + // eslint-disable-next-line @typescript-eslint/require-await + async (_: any, input: string) => { + projects.unshift({ + projectId: NEW_OPTION, + displayName: '[CREATE NEW PROJECT]' + } as any); + return fuzzy.filter(input, projects, { + extract(el) { + return `${el.projectId} ${el.displayName}`; + } + }).map((result) => { + let original: FirebaseProject; + if (isProject(result)) { + original = result; + } else { + original = result.original; + } + return { + name: original.displayName, + title: original.displayName, + value: original.projectId + }; + }); + }; + +export const searchApps = (apps: FirebaseApp[]) => + // eslint-disable-next-line @typescript-eslint/require-await + async (_: any, input: string) => { + apps.unshift({ + appId: NEW_OPTION, + displayName: '[CREATE NEW APP]', + } as any); + return fuzzy.filter(input, apps, { + extract(el: FirebaseApp) { + return el.displayName; + } + }).map((result) => { + let original: FirebaseApp; + if (isApp(result)) { + original = result; + } else { + original = result.original; + } + return { + name: original.displayName, + title: original.displayName, + value: shortAppId(original), + }; + }); + }; + +type Prompt = (questions: { name: K, source: (...args) => + Promise<{ value: U }[]>, default?: U | ((o: U[]) => U | Promise), [key: string]: any }) => + Promise<{[T in K]: U }>; + +const autocomplete: Prompt = (questions) => inquirer.prompt(questions); + + +export const featuresPrompt = async (): Promise => { + const { features } = await inquirer.prompt({ + type: 'checkbox', + name: 'features', + choices: featureOptions, + message: 'What features would you like to setup?', + default: [], + }) as { features: FEATURES[] }; + return features; +}; + +export const userPrompt = async (options: { projectRoot: string }): Promise> => { + const firebaseTools = await getFirebaseTools(); + let loginList = await firebaseTools.login.list(); + if (!Array.isArray(loginList) || loginList.length === 0) { + spawnSync('firebase login', { shell: true, cwd: options.projectRoot, stdio: 'inherit' }); + return await firebaseTools.login(options); + } else { + const defaultUser = await firebaseTools.login(options); + const choices = loginList.map(({user}) => ({ name: user.email, value: user })); + const newChoice = { name: '[Login in with another account]', value: NEW_OPTION }; + const { user } = await inquirer.prompt({ + type: 'list', + name: 'user', + choices: [newChoice].concat(choices as any), // TODO types + message: 'Which Firebase account would you like to use?', + default: choices.find(it => it.value.email === defaultUser.email)?.value, + }) as any; + if (user === NEW_OPTION) { + spawnSync('firebase login:add', { shell: true, cwd: options.projectRoot, stdio: 'inherit' }); + loginList = await firebaseTools.login.list(); + if (!Array.isArray(loginList)) { + throw new Error("firebase login:list did not respond as expected"); + } + const priorEmails = choices.map(it => it.name); + const newLogin = loginList.find(it => !priorEmails.includes(it.user.email)); + if (!newLogin) { + throw new Error("Did not find a new user."); + } + return newLogin.user; + } + return user; + } +}; + +export const projectPrompt = async (defaultProject: string|undefined, options: unknown) => { + const firebaseTools = await getFirebaseTools(); + const projects = await firebaseTools.projects.list(options); + const { projectId } = await autocomplete({ + type: 'autocomplete', + name: 'projectId', + source: searchProjects(projects), + message: 'Please select a project:', + default: defaultProject, + }); + if (projectId === NEW_OPTION) { + const { projectId } = await inquirer.prompt({ + type: 'input', + name: 'projectId', + message: `Please specify a unique project id (cannot be modified afterward) [6-30 characters]:`, + }) as { projectId: string }; + const { displayName } = await inquirer.prompt({ + type: 'input', + name: 'displayName', + message: 'What would you like to call your project?', + default: projectId, + }) as { displayName: string }; + return await firebaseTools.projects.create(projectId, { account: (options as any).account, displayName, nonInteractive: true }); + } + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + return (projects).find(it => it.projectId === projectId)!; +}; + +export const appPrompt = async ({ projectId: project }: FirebaseProject, defaultAppId: string|undefined, options: any) => { + const firebaseTools = await getFirebaseTools(); + const apps = await firebaseTools.apps.list('web', { ...options, project }); + const { appId } = await autocomplete({ + type: 'autocomplete', + name: 'appId', + source: searchApps(apps), + message: 'Please select an app:', + default: defaultAppId, + }); + if (appId === NEW_OPTION) { + const { displayName } = await inquirer.prompt({ + type: 'input', + name: 'displayName', + message: 'What would you like to call your app?', + }) as { displayName: string }; + return await firebaseTools.apps.create('web', displayName, { ...options, nonInteractive: true, project }); + } + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + return (apps).find(it => shortAppId(it) === appId)!; +}; diff --git a/src/schematics/setup/schema.json b/src/schematics/setup/schema.json new file mode 100644 index 000000000..5b1ce2c4f --- /dev/null +++ b/src/schematics/setup/schema.json @@ -0,0 +1,16 @@ +{ + "$schema": "http://json-schema.org/draft-07/schema", + "$id": "angular-fire-ng-add", + "title": "AngularFire ng-add", + "type": "object", + "properties": { + "project": { + "type": "string", + "description": "The name of the project.", + "$default": { + "$source": "projectName" + } + } + }, + "required": [] + } diff --git a/src/schematics/tsconfig.json b/src/schematics/tsconfig.json new file mode 100644 index 000000000..ea6375bea --- /dev/null +++ b/src/schematics/tsconfig.json @@ -0,0 +1,32 @@ +{ + "compilerOptions": { + "rootDir": ".", + "sourceMap": false, + "inlineSources": false, + "declaration": false, + "removeComments": true, + "strictNullChecks": true, + "resolveJsonModule": true, + "esModuleInterop": true, + "lib": [ + "es2015", + "dom", + "es2015.promise", + "es2015.collection", + "es2015.iterable" + ], + "skipLibCheck": true, + "moduleResolution": "node", + "target": "es2018", + "module": "commonjs", + "outDir": "../../dist/packages-dist/schematics" + }, + "files": [ + "update/index.ts", + "deploy/actions.ts", + "deploy/builder.ts", + "add/index.ts", + "setup/index.ts", + "update/v7/index.ts", + ] +} \ No newline at end of file diff --git a/src/schematics/update/index.ts b/src/schematics/update/index.ts new file mode 100644 index 000000000..7b57b5ab4 --- /dev/null +++ b/src/schematics/update/index.ts @@ -0,0 +1,8 @@ +import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics'; + +export const ngPostUpdate = (): Rule => ( + host: Tree, + _context: SchematicContext +) => { + return host; +}; diff --git a/src/schematics/update/v7/index.ts b/src/schematics/update/v7/index.ts new file mode 100644 index 000000000..a8fd5c56f --- /dev/null +++ b/src/schematics/update/v7/index.ts @@ -0,0 +1,87 @@ +import { join } from 'path'; +import { Rule, SchematicContext, SchematicsException, Tree } from '@angular-devkit/schematics'; +import { NodePackageInstallTask } from '@angular-devkit/schematics/tasks'; +import { overwriteIfExists, safeReadJSON, stringifyFormatted } from '../../common'; +import { firebaseFunctionsDependencies, peerDependencies } from '../../versions.json'; + +const IMPORT_REGEX = /(?import|export)\s+(?:(?[\w,{}\s*]+)\s+from)?\s*(?:(?["'])?(?[@\w\s\\/.-]+)\3?)\s*(?[;\n])/g; +interface ImportRegexMatch { + key: string; + alias: string; + ref: string; + quote: string; + term: string; +} + +export const ngUpdate = (): Rule => ( + host: Tree, + context: SchematicContext +) => { + const packageJson = host.exists('package.json') && safeReadJSON('package.json', host); + + if (packageJson === undefined) { + throw new SchematicsException('Could not locate package.json'); + } + + Object.keys(peerDependencies).forEach(depName => { + const dep = peerDependencies[depName]; + if (dep) { + packageJson[dep.dev ? 'devDependencies' : 'dependencies'][depName] = dep.version; + } + }); + + // TODO test if it's a SSR project in the JSON + Object.keys(firebaseFunctionsDependencies).forEach(depName => { + const dep = firebaseFunctionsDependencies[depName]; + if (dep.dev && packageJson.devDependencies[depName]) { + packageJson.devDependencies[depName] = dep.version; + } else if (packageJson.dependencies[depName]) { + packageJson.dependencies[depName] = dep.version; + } + }); + + overwriteIfExists(host, 'package.json', stringifyFormatted(packageJson)); + context.addTask(new NodePackageInstallTask()); + + const angularJson = host.exists('angular.json') && safeReadJSON('angular.json', host); + if (packageJson === undefined) { + throw new SchematicsException('Could not locate angular.json'); + } + + // TODO investigate if this is correct in Windows + const srcRoots: string[] = Object.values(angularJson.projects).map((it: any) => + join(...['/', it.root, it.sourceRoot].filter(it => !!it)) + ); + + host.visit(filePath => { + if ( + !filePath.endsWith('.ts') || + filePath.endsWith('.d.ts') || + !srcRoots.find(root => filePath.startsWith(root)) + ) { + return; + } + const content = host.read(filePath)?.toString(); + if (!content) { + return; + } + const newContent = content.replace(IMPORT_REGEX, (substring, ...args) => { + const { alias, key, ref, quote, term }: ImportRegexMatch = args.pop(); + if (ref.startsWith('@angular/fire') && !ref.startsWith('@angular/fire/compat')) { + return `${key} ${alias} from ${quote}${ref.replace('@angular/fire', '@angular/fire/compat')}${quote}${term}`; + } + if (ref.startsWith('firebase') && !ref.startsWith('firebase/compat')) { + return `${key} ${alias} from ${quote}${ref.replace('firebase', 'firebase/compat')}${quote}${term}`; + } + if (ref.startsWith('@firebase')) { + return `${key} ${alias} from ${quote}${ref.replace('@firebase', 'firebase')}${quote}${term}`; + } + return substring; + }); + if (content !== newContent) { + overwriteIfExists(host, filePath, newContent); + } + }); + + return host; +}; diff --git a/src/schematics/utils.ts b/src/schematics/utils.ts new file mode 100644 index 000000000..b42afb07c --- /dev/null +++ b/src/schematics/utils.ts @@ -0,0 +1,400 @@ +import { readFileSync } from "fs"; +import { join } from "path"; +import { + Rule, + SchematicContext, + SchematicsException, + Tree, + chain, +} from "@angular-devkit/schematics"; +import { NodePackageInstallTask } from "@angular-devkit/schematics/tasks"; +import { addRootProvider } from "@schematics/angular/utility"; +import { parse } from "yaml"; +import { overwriteIfExists, safeReadJSON, stringifyFormatted } from "./common"; +import { + ConnectorConfig, + ConnectorYaml, + DataConnectConnectorConfig, + DataConnectYaml, + DeployOptions, + FEATURES, + FirebaseApp, + FirebaseRc, + PackageJson, + Workspace, +} from "./interfaces"; +import { SetupConfig } from "./setup"; + +export const shortAppId = (app?: FirebaseApp) => app?.appId?.split("/").pop(); + +export function getWorkspace(host: Tree): { + path: string; + workspace: Workspace; +} { + const path = "/angular.json"; + + const configBuffer = path && host.read(path); + if (!configBuffer) { + throw new SchematicsException(`Could not find angular.json`); + } + + // eslint-disable-next-line @typescript-eslint/no-var-requires + const { parse } = require("jsonc-parser"); + + const workspace = parse(configBuffer.toString()) as Workspace | undefined; + if (!workspace) { + throw new SchematicsException("Could not parse angular.json"); + } + + return { + path, + workspace, + }; +} + +export const getProject = (options: DeployOptions, host: Tree) => { + const { workspace } = getWorkspace(host); + const projectName = options.project || workspace.defaultProject; + + if (!projectName) { + throw new SchematicsException( + "No Angular project selected and no default project in the workspace" + ); + } + + const project = workspace.projects[projectName]; + if (!project) { + throw new SchematicsException( + "The specified Angular project is not defined in this workspace" + ); + } + + if (project.projectType !== "application") { + throw new SchematicsException( + `Deploy requires an Angular project type of "application" in angular.json` + ); + } + + return { project, projectName }; +}; + +export function getFirebaseProjectNameFromHost( + host: Tree, + target: string +): [string | undefined, string | undefined] { + const buffer = host.read("/.firebaserc"); + if (!buffer) { + return [undefined, undefined]; + } + const rc: FirebaseRc = JSON.parse(buffer.toString()); + return projectFromRc(rc, target); +} + +export function getFirebaseProjectNameFromFs( + root: string, + target: string +): [string | undefined, string | undefined] { + const path = join(root, ".firebaserc"); + try { + const buffer = readFileSync(path); + const rc: FirebaseRc = JSON.parse(buffer.toString()); + return projectFromRc(rc, target); + } catch (e) { + return [undefined, undefined]; + } +} + +const projectFromRc = ( + rc: FirebaseRc, + target: string +): [string | undefined, string | undefined] => { + const defaultProject = rc.projects?.default; + const project = Object.keys(rc.targets || {}).find( + (project) => !!rc.targets?.[project]?.hosting?.[target] + ); + const site = project && rc.targets?.[project]?.hosting?.[target]?.[0]; + return [project || defaultProject, site]; +}; + +// TODO rewrite using typescript +export function addFixesToServer(host: Tree) { + const serverPath = `/server.ts`; + + if (!host.exists(serverPath)) { + return host; + } + + const text = host.read(serverPath); + if (text === null) { + throw new SchematicsException(`File ${serverPath} does not exist.`); + } + const sourceText = text.toString("utf-8"); + const addZonePatch = !sourceText.includes( + "import 'zone.js/dist/zone-patch-rxjs';" + ); + + if (addZonePatch) { + overwriteIfExists( + host, + serverPath, + sourceText.replace( + "import 'zone.js/dist/zone-node';", + `import 'zone.js/dist/zone-node'; +${addZonePatch ? "import 'zone.js/dist/zone-patch-rxjs';" : ""}` + ) + ); + } + + return host; +} + +export function featureToRules( + features: FEATURES[], + projectName: string, + dataConnectConfig?: DataConnectConnectorConfig | null +) { + return features + .map((feature) => { + switch (feature) { + case FEATURES.AppCheck: + // TODO make this smarter in Angular Universal + return addRootProvider(projectName, ({ code, external }) => { + external("initializeAppCheck", "@angular/fire/app-check"); + external("ReCaptchaEnterpriseProvider", "@angular/fire/app-check"); + return code`${external( + "provideAppCheck", + "@angular/fire/app-check" + )}(() => { + // TODO get a reCAPTCHA Enterprise here https://console.cloud.google.com/security/recaptcha?project=_ + const provider = new ReCaptchaEnterpriseProvider(/* reCAPTCHA Enterprise site key */); + return initializeAppCheck(undefined, { provider, isTokenAutoRefreshEnabled: true }); +})`; + }); + case FEATURES.Analytics: + return chain([ + addRootProvider(projectName, ({ code, external }) => { + external("getAnalytics", "@angular/fire/analytics"); + return code`${external( + "provideAnalytics", + "@angular/fire/analytics" + )}(() => getAnalytics())`; + }), + // TODO if using Angular router + addRootProvider(projectName, ({ code, external }) => { + return code`${external( + "ScreenTrackingService", + "@angular/fire/analytics" + )}`; + }), + ...(features.includes(FEATURES.Authentication) + ? [ + addRootProvider(projectName, ({ code, external }) => { + return code`${external( + "UserTrackingService", + "@angular/fire/analytics" + )}`; + }), + ] + : []), + ]); + case FEATURES.Authentication: + return addRootProvider(projectName, ({ code, external }) => { + external("getAuth", "@angular/fire/auth"); + return code`${external( + "provideAuth", + "@angular/fire/auth" + )}(() => getAuth())`; + }); + case FEATURES.Database: + return addRootProvider(projectName, ({ code, external }) => { + external("getDatabase", "@angular/fire/database"); + return code`${external( + "provideDatabase", + "@angular/fire/database" + )}(() => getDatabase())`; + }); + case FEATURES.DataConnect: + return addRootProvider(projectName, ({ code, external }) => { + external("getDataConnect", "@angular/fire/data-connect"); + let configAsStr = "{}"; + + const config = dataConnectConfig; + let angularConfig: undefined | string; + if (config) { + if (config.package) { + configAsStr = external("connectorConfig", config.package); + } else { + configAsStr = `{${Object.keys(config.connectorConfig as ConnectorConfig).map( + (key) => `${key}: "${(config.connectorConfig as ConnectorConfig)[key]}"` + ).join(',')}}`; + } + if (config.angular) { + angularConfig = `, ${external( + "provideTanStackQuery", + "@tanstack/angular-query-experimental" + )}(new ${external( + "QueryClient", + "@tanstack/angular-query-experimental" + )}())`; + } + } + return code`${external( + "provideDataConnect", + "@angular/fire/data-connect" + )}(() => getDataConnect(${configAsStr}))${angularConfig ?? ""}`; + }); + case FEATURES.Firestore: + return addRootProvider(projectName, ({ code, external }) => { + external("getFirestore", "@angular/fire/firestore"); + return code`${external( + "provideFirestore", + "@angular/fire/firestore" + )}(() => getFirestore())`; + }); + case FEATURES.Functions: + return addRootProvider(projectName, ({ code, external }) => { + external("getFunctions", "@angular/fire/functions"); + return code`${external( + "provideFunctions", + "@angular/fire/functions" + )}(() => getFunctions())`; + }); + case FEATURES.Messaging: + // TODO add the service worker + return addRootProvider(projectName, ({ code, external }) => { + external("getMessaging", "@angular/fire/messaging"); + return code`${external( + "provideMessaging", + "@angular/fire/messaging" + )}(() => getMessaging())`; + }); + case FEATURES.Performance: + return addRootProvider(projectName, ({ code, external }) => { + external("getPerformance", "@angular/fire/performance"); + return code`${external( + "providePerformance", + "@angular/fire/performance" + )}(() => getPerformance())`; + }); + case FEATURES.Storage: + return addRootProvider(projectName, ({ code, external }) => { + external("getStorage", "@angular/fire/storage"); + return code`${external( + "provideStorage", + "@angular/fire/storage" + )}(() => getStorage())`; + }); + case FEATURES.RemoteConfig: + // TODO consider downloading the defaults + return addRootProvider(projectName, ({ code, external }) => { + external("getRemoteConfig", "@angular/fire/remote-config"); + return code`${external( + "provideRemoteConfig", + "@angular/fire/remote-config" + )}(() => getRemoteConfig())`; + }); + case FEATURES.VertexAI: + return addRootProvider(projectName, ({ code, external }) => { + external("getVertexAI", "@angular/fire/vertexai"); + return code`${external( + "provideVertexAI", + "@angular/fire/vertexai" + )}(() => getVertexAI())`; + }); + default: + return undefined; + } + }) + .filter((it): it is Rule => !!it); +} + +export const addIgnoreFiles = (host: Tree) => { + const path = "/.gitignore"; + if (!host.exists(path)) { + return host; + } + + const buffer = host.read(path); + if (!buffer) { + return host; + } + + const content = buffer.toString(); + if (!content.includes("# Firebase")) { + overwriteIfExists( + host, + path, + content.concat(` +# Firebase +.firebase +*-debug.log +.runtimeconfig.json +`) + ); + } + + return host; +}; + +export function parseDataConnectConfig( + config: SetupConfig +): DataConnectConnectorConfig | null { + if (!config.firebaseJsonConfig) { + throw new Error("No firebase json"); + } + if (!config.firebaseJsonConfig.dataconnect?.source) { + throw new Error( + "Couldn't find data connect configuration. Running `firebase init dataconnect`" + ); + } + const dataConnectFolder = join( + config.firebaseJsonPath, + config.firebaseJsonConfig.dataconnect?.source + ); + const sourcePath = join(dataConnectFolder, "dataconnect.yaml"); + try { + const fileAsStr = readFileSync(sourcePath).toString(); + const dataConnectYaml: DataConnectYaml = parse(fileAsStr); + const connectorPath = join( + dataConnectFolder, + dataConnectYaml.connectorDirs[0], + "connector.yaml" + ); + const connectorAsStr = readFileSync(connectorPath).toString(); + const connectorJson: ConnectorYaml = parse(connectorAsStr); + if (!connectorJson?.generate?.javascriptSdk) { + return { connectorYaml: connectorJson }; + } + return { + connectorYaml: connectorJson, + connectorConfig: { + connector: connectorJson.connectorId, + location: dataConnectYaml.location, + service: dataConnectYaml.serviceId, + }, + package: connectorJson.generate.javascriptSdk.package, + angular: connectorJson.generate.javascriptSdk.angular, + }; + } catch (e) { + console.error("Couldn't parse dataconnect.yaml", e); + return null; + } +} + +export function setupTanstackDependencies( + host: Tree, + context: SchematicContext +) { + const packageJson: PackageJson = safeReadJSON("package.json", host); + const tanstackFirebasePackage = "@tanstack-query-firebase/angular"; + if ( + !packageJson.dependencies[tanstackFirebasePackage] && + !packageJson.devDependencies[tanstackFirebasePackage] + ) { + packageJson.dependencies[tanstackFirebasePackage] = + "^1.0.0"; + packageJson.dependencies["@tanstack/angular-query-experimental"] = "5.66.4"; + overwriteIfExists(host, "package.json", stringifyFormatted(packageJson)); + context.addTask(new NodePackageInstallTask()); + } +} diff --git a/src/schematics/versions.json b/src/schematics/versions.json new file mode 100644 index 000000000..9477d49a4 --- /dev/null +++ b/src/schematics/versions.json @@ -0,0 +1,8 @@ +{ + "peerDependencies": { + }, + "firebaseFunctionsDependencies": { + "firebase-admin": { "dev": false, "version": "0.0.0" }, + "firebase-functions": { "dev": false, "version": "0.0.0" } + } +} diff --git a/src/storage/firebase.ts b/src/storage/firebase.ts new file mode 100644 index 000000000..3ad53a491 --- /dev/null +++ b/src/storage/firebase.ts @@ -0,0 +1,36 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/storage'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + connectStorageEmulator as _connectStorageEmulator, + deleteObject as _deleteObject, + getBlob as _getBlob, + getBytes as _getBytes, + getDownloadURL as _getDownloadURL, + getMetadata as _getMetadata, + getStorage as _getStorage, + getStream as _getStream, + list as _list, + listAll as _listAll, + ref as _ref, + updateMetadata as _updateMetadata, + uploadBytes as _uploadBytes, + uploadBytesResumable as _uploadBytesResumable, + uploadString as _uploadString +} from 'firebase/storage'; + +export const connectStorageEmulator = ÉĩzoneWrap(_connectStorageEmulator, true); +export const deleteObject = ÉĩzoneWrap(_deleteObject, true, 2); +export const getBlob = ÉĩzoneWrap(_getBlob, true); +export const getBytes = ÉĩzoneWrap(_getBytes, true); +export const getDownloadURL = ÉĩzoneWrap(_getDownloadURL, true); +export const getMetadata = ÉĩzoneWrap(_getMetadata, true); +export const getStorage = ÉĩzoneWrap(_getStorage, true); +export const getStream = ÉĩzoneWrap(_getStream, true); +export const list = ÉĩzoneWrap(_list, true); +export const listAll = ÉĩzoneWrap(_listAll, true); +export const ref = ÉĩzoneWrap(_ref, true, 2); +export const updateMetadata = ÉĩzoneWrap(_updateMetadata, true, 2); +export const uploadBytes = ÉĩzoneWrap(_uploadBytes, true); +export const uploadBytesResumable = ÉĩzoneWrap(_uploadBytesResumable, true); +export const uploadString = ÉĩzoneWrap(_uploadString, true); diff --git a/src/storage/ng-package.json b/src/storage/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/storage/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/storage/package.json b/src/storage/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/storage/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/storage/public_api.ts b/src/storage/public_api.ts new file mode 100644 index 000000000..e75f18503 --- /dev/null +++ b/src/storage/public_api.ts @@ -0,0 +1,4 @@ +export { Storage, StorageInstances, storageInstance$ } from './storage'; +export { provideStorage, StorageModule } from './storage.module'; +export * from './rxfire'; +export * from './firebase'; diff --git a/src/storage/rxfire.ts b/src/storage/rxfire.ts new file mode 100644 index 000000000..a4ef73dd4 --- /dev/null +++ b/src/storage/rxfire.ts @@ -0,0 +1,9 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +import { ÉĩzoneWrap } from '@angular/fire'; +import { + fromTask as _fromTask, + percentage as _percentage +} from 'rxfire/storage'; + +export const fromTask = ÉĩzoneWrap(_fromTask, true); +export const percentage = ÉĩzoneWrap(_percentage, true); diff --git a/src/storage/storage.module.ts b/src/storage/storage.module.ts new file mode 100644 index 000000000..0d15e2aca --- /dev/null +++ b/src/storage/storage.module.ts @@ -0,0 +1,82 @@ +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { AuthInstances } from '@angular/fire/auth'; +import { registerVersion } from 'firebase/app'; +import { FirebaseStorage } from 'firebase/storage'; +import { STORAGE_PROVIDER_NAME, Storage, StorageInstances } from './storage'; + +export const PROVIDED_STORAGE_INSTANCES = new InjectionToken('angularfire2.storage-instances'); + +export function defaultStorageInstanceFactory(provided: FirebaseStorage[]|undefined, defaultApp: FirebaseApp) { + const defaultStorage = ÉĩgetDefaultInstanceOf(STORAGE_PROVIDER_NAME, provided, defaultApp); + return defaultStorage && new Storage(defaultStorage); +} + +export function storageInstanceFactory(fn: (injector: Injector) => FirebaseStorage) { + return (zone: NgZone, injector: Injector) => { + const storage = zone.runOutsideAngular(() => fn(injector)); + return new Storage(storage); + }; +} + +const STORAGE_INSTANCES_PROVIDER = { + provide: StorageInstances, + deps: [ + [new Optional(), PROVIDED_STORAGE_INSTANCES ], + ] +}; + +const DEFAULT_STORAGE_INSTANCE_PROVIDER = { + provide: Storage, + useFactory: defaultStorageInstanceFactory, + deps: [ + [new Optional(), PROVIDED_STORAGE_INSTANCES ], + FirebaseApp, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_STORAGE_INSTANCE_PROVIDER, + STORAGE_INSTANCES_PROVIDER, + ] +}) +export class StorageModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'gcs'); + } +} + +export function provideStorage(fn: (injector: Injector) => FirebaseStorage, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'gcs'); + + return makeEnvironmentProviders([ + DEFAULT_STORAGE_INSTANCE_PROVIDER, + STORAGE_INSTANCES_PROVIDER, + { + provide: PROVIDED_STORAGE_INSTANCES, + useFactory: storageInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + // Defensively load Auth first, if provided + [new Optional(), AuthInstances ], + [new Optional(), AppCheckInstances ], + ...deps, + ] + } + ]); +} diff --git a/src/storage/storage.spec.ts b/src/storage/storage.spec.ts new file mode 100644 index 000000000..b60331e8a --- /dev/null +++ b/src/storage/storage.spec.ts @@ -0,0 +1,39 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { Storage, connectStorageEmulator, getStorage, provideStorage } from '@angular/fire/storage'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +describe('Storage', () => { + let app: FirebaseApp; + let storage: Storage; + let providedStorage: Storage; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideStorage(() => { + providedStorage = getStorage(getApp(appName)); + connectStorageEmulator(providedStorage, 'localhost', 9199); + return providedStorage; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + storage = TestBed.inject(Storage); + }); + + it('should be injectable', () => { + expect(providedStorage).toBeTruthy(); + expect(storage).toEqual(providedStorage); + expect(storage.app).toEqual(app); + }); + + }); + +}); diff --git a/src/storage/storage.ts b/src/storage/storage.ts new file mode 100644 index 000000000..f24cd6bd1 --- /dev/null +++ b/src/storage/storage.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { FirebaseStorage } from 'firebase/storage'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface Storage extends FirebaseStorage {} + +export class Storage { + constructor(auth: FirebaseStorage) { + return auth; + } +} + +export const STORAGE_PROVIDER_NAME = 'storage'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface StorageInstances extends Array {} + +export class StorageInstances { + constructor() { + return ÉĩgetAllInstancesOf(STORAGE_PROVIDER_NAME); + } +} + +export const storageInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(STORAGE_PROVIDER_NAME))), + distinct(), +); diff --git a/src/test-config.ts b/src/test-config.ts index 4b69c98dd..cbebd784e 100644 --- a/src/test-config.ts +++ b/src/test-config.ts @@ -1,7 +1,39 @@ - export const COMMON_CONFIG = { - apiKey: "AIzaSyBVSy3YpkVGiKXbbxeK0qBnu3-MNZ9UIjA", - authDomain: "angularfire2-test.firebaseapp.com", - databaseURL: "https://angularfire2-test.firebaseio.com/", - storageBucket: "angularfire2-test.appspot.com", + apiKey: 'AIzaSyBVSy3YpkVGiKXbbxeK0qBnu3-MNZ9UIjA', + authDomain: 'angularfire2-test.firebaseapp.com', + databaseURL: 'https://angularfire2-test.firebaseio.com/', + projectId: 'angularfire2-test', + storageBucket: 'angularfire2-test.appspot.com', + messagingSenderId: '920323787688', + appId: '1:920323787688:web:2253a0e5eb5b9a8b', + databaseName: 'angularfire2-test', + measurementId: 'G-W20QDV5CZP' +}; + +export const COMMON_CONFIG_TOO = { + apiKey: 'AIzaSyBVSy3YpkVGiKXbbxeK0qBnu3-MNZ9UIjA', + authDomain: 'angularfire2-test.firebaseapp.com', + databaseURL: 'https://angularfire2-test.firebaseio.com/', + projectId: 'angularfire2-test', + storageBucket: 'angularfire2-test.appspot.com', + messagingSenderId: '920323787688', + appId: '1:920323787688:web:2253a0e5eb5b9a8d', + databaseName: 'angularfire2-test', + measurementId: 'G-W20QDV5CZZ' }; + +declare global { + interface Window { + __karma__ : { + config: { + args: any[] + } + }; + } +} + +export const firestoreEmulatorPort: number = window.__karma__.config.args.find((it) => it[0] === "FIRESTORE_EMULATOR_PORT")[1]; +export const storageEmulatorPort: number = window.__karma__.config.args.find((it) => it[0] === "STORAGE_EMULATOR_PORT")[1]; +export const authEmulatorPort: number = window.__karma__.config.args.find((it) => it[0] === "AUTH_EMULATOR_PORT")[1]; +export const databaseEmulatorPort: number = window.__karma__.config.args.find((it) => it[0] === "DATABASE_EMULATOR_PORT")[1]; +export const functionsEmulatorPort: number = window.__karma__.config.args.find((it) => it[0] === "FUNCTIONS_EMULATOR_PORT")[1]; diff --git a/src/test-root.ts b/src/test-root.ts deleted file mode 100644 index 1f2053f93..000000000 --- a/src/test-root.ts +++ /dev/null @@ -1,8 +0,0 @@ -import './angularfire2.spec'; -import './database/firebase_list_factory.spec'; -import './database/firebase_object_factory.spec'; -import './database/firebase_list_observable.spec'; -import './database/firebase_object_observable.spec'; -import './database/query_observable.spec'; -import './auth/auth.spec'; - diff --git a/src/test.ts b/src/test.ts new file mode 100644 index 000000000..e1b0e6633 --- /dev/null +++ b/src/test.ts @@ -0,0 +1,21 @@ +// This file is required by karma.conf.js and loads recursively all the .spec and framework files + +import 'zone.js/dist/zone'; +import 'zone.js/dist/zone-testing'; +import 'zone.js/dist/task-tracking'; + +import { getTestBed } from '@angular/core/testing'; +import { BrowserDynamicTestingModule, platformBrowserDynamicTesting } from '@angular/platform-browser-dynamic/testing'; + +declare const require: any; + +// First, initialize the Angular testing environment. +getTestBed().initTestEnvironment( + BrowserDynamicTestingModule, + platformBrowserDynamicTesting() +); +// Then we find all the tests. +const context = require.context('./', true, /^\.\/.+\.spec\.ts$/); + +// And load the modules. +context.keys().map(context); diff --git a/src/utils.ts b/src/utils.ts index 26814e407..5d4aee26a 100644 --- a/src/utils.ts +++ b/src/utils.ts @@ -1,136 +1,3 @@ -import * as firebase from 'firebase/app'; -import { Subscription } from 'rxjs/Subscription'; -import { Scheduler } from 'rxjs/Scheduler'; -import { queue } from 'rxjs/scheduler/queue'; -import { AFUnwrappedDataSnapshot, PathReference, DatabaseReference } from './interfaces'; -import { FirebaseApp } from './app/index'; +const randomString = () => (Math.random() + 1).toString(36).split('.')[1]; -const REGEX_ABSOLUTE_URL = /^[a-z]+:\/\/.*/; - -export function isNil(obj: any): boolean { - return obj === undefined || obj === null; -} - -export function hasKey(obj: Object, key: string): boolean { - return obj && obj[key] !== undefined; -} - -export function isString(value: any): boolean { - return typeof value === 'string'; -} - -export function isFirebaseRef(value: any): boolean { - return typeof value.set === 'function'; -} - -export function isFirebaseDataSnapshot(value: any): boolean { - return typeof value.exportVal === 'function'; -} - -export function isAFUnwrappedSnapshot(value: any): boolean { - return typeof value.$key === 'string'; -} - -export function isFirebaseQuery(value: any): boolean { - return typeof value.orderByChild === 'function'; -} - -export function isEmptyObject(obj: Object): boolean { - if (isNil(obj)) { return false; } - return Object.keys(obj).length === 0 && JSON.stringify(obj) === JSON.stringify({}); -} - -export interface CheckUrlRef { - isUrl: () => any; - isRef: () => any; - isQuery?: () => any; -} - -/** - * Unwraps the data returned in the DataSnapshot. Exposes the DataSnapshot key and exists methods through the $key and $exists properties respectively. If the value is primitive, it is unwrapped using a $value property. The $ properies mean they cannot be saved in the Database as those characters are invalid. - * @param {DataSnapshot} snapshot - The snapshot to unwrap - * @return AFUnwrappedDataSnapshot - * @example - * unwrapMapFn(snapshot) => { name: 'David', $key: 'david', $exists: Function } - */ -export function unwrapMapFn (snapshot:firebase.database.DataSnapshot): AFUnwrappedDataSnapshot { - var unwrapped = !isNil(snapshot.val()) ? snapshot.val() : { $value: null }; - if ((/string|number|boolean/).test(typeof unwrapped)) { - unwrapped = { - $value: unwrapped - }; - } - Object.defineProperty(unwrapped, '$key', { - value: snapshot.ref.key, - enumerable: false - }); - Object.defineProperty(unwrapped, '$exists', { - value: () => { - return snapshot.exists(); - }, - enumerable: false - }); - return unwrapped; -} - -export function stripTrailingSlash(value: string): string { - // Is the last char a / - if (value.substring(value.length - 1, value.length) === '/') { - return value.substring(0, value.length - 1); - } else { - return value; - } -} - -function getAbsUrl(root: string, url:string) { - if (!(/^[a-z]+:\/\/.*/.test(url))) { - // Provided url is relative. - // Strip any leading slash - url = root + '/' + stripLeadingSlash(url); - } - return url; -} - -export function stripLeadingSlash(value: string): string { - // Is the last char a / - if (value.substring(0, 1) === '/') { - return value.substring(1, value.length); - } else { - return value; - } -} - -export function isAbsoluteUrl(url: string) { - return REGEX_ABSOLUTE_URL.test(url); -} - -/** - * Returns a database reference given a Firebase App and an - * absolute or relative path. - * @param app - Firebase App - * @param path - Database path, relative or absolute - */ -export function getRef(app: FirebaseApp, pathRef: PathReference): DatabaseReference { - // if a db ref was passed in, just return it - if(isFirebaseRef(pathRef)) { - return pathRef as DatabaseReference; - } - - const path = pathRef as string; - if(isAbsoluteUrl(pathRef)) { - return app.database().refFromURL(path); - } - return app.database().ref(path); -} - -/** - * TODO: remove this scheduler once Rx has a more robust story for working - * with zones. - */ -export class ZoneScheduler { - constructor(public zone: Zone) {} - - schedule(...args): Subscription { - return this.zone.run(() => queue.schedule.apply(queue, args)); - } -} +export const rando = () => [randomString(), randomString(), randomString()].join(''); diff --git a/src/vertexai/firebase.ts b/src/vertexai/firebase.ts new file mode 100644 index 000000000..9c24d52b9 --- /dev/null +++ b/src/vertexai/firebase.ts @@ -0,0 +1,14 @@ +// DO NOT MODIFY, this file is autogenerated by tools/build.ts +export * from 'firebase/vertexai'; +import { ÉĩzoneWrap } from '@angular/fire'; +import { + getAI as _getAI, + getGenerativeModel as _getGenerativeModel, + getImagenModel as _getImagenModel, + getVertexAI as _getVertexAI +} from 'firebase/vertexai'; + +export const getAI = ÉĩzoneWrap(_getAI, true); +export const getGenerativeModel = ÉĩzoneWrap(_getGenerativeModel, true); +export const getImagenModel = ÉĩzoneWrap(_getImagenModel, true); +export const getVertexAI = ÉĩzoneWrap(_getVertexAI, true); diff --git a/src/vertexai/ng-package.json b/src/vertexai/ng-package.json new file mode 100644 index 000000000..d3032da35 --- /dev/null +++ b/src/vertexai/ng-package.json @@ -0,0 +1,6 @@ +{ + "$schema": "../../node_modules/ng-packagr/ng-package.schema.json", + "lib": { + "entryFile": "public_api.ts" + } +} diff --git a/src/vertexai/package.json b/src/vertexai/package.json new file mode 100644 index 000000000..8dce418a5 --- /dev/null +++ b/src/vertexai/package.json @@ -0,0 +1,3 @@ +{ + "$schema": "../../node_modules/ng-packagr/package.schema.json" +} diff --git a/src/vertexai/public_api.ts b/src/vertexai/public_api.ts new file mode 100644 index 000000000..ab750d9af --- /dev/null +++ b/src/vertexai/public_api.ts @@ -0,0 +1,3 @@ +export { VertexAI, VertexAIInstances, vertexAIInstance$ } from './vertexai'; +export { provideVertexAI, VertexAIModule } from './vertexai.module'; +export * from './firebase'; diff --git a/src/vertexai/vertexai.module.ts b/src/vertexai/vertexai.module.ts new file mode 100644 index 000000000..c13b9c56b --- /dev/null +++ b/src/vertexai/vertexai.module.ts @@ -0,0 +1,79 @@ +import { + EnvironmentProviders, + InjectionToken, + Injector, + NgModule, + NgZone, + Optional, + makeEnvironmentProviders, +} from '@angular/core'; +import { VERSION, ÉĩAngularFireSchedulers, ÉĩgetDefaultInstanceOf } from '@angular/fire'; +import { FirebaseApp, FirebaseApps } from '@angular/fire/app'; +import { AppCheckInstances } from '@angular/fire/app-check'; +import { registerVersion } from 'firebase/app'; +import { VertexAI as FirebaseVertexAI } from 'firebase/vertexai'; +import { VERTEX_AI_PROVIDER_NAME, VertexAI, VertexAIInstances } from './vertexai'; + +export const PROVIDED_VERTEX_AI_INSTANCES = new InjectionToken('angularfire2.vertexai-instances'); + +export function defaultVertexAIInstanceFactory(provided: FirebaseVertexAI[]|undefined, defaultApp: FirebaseApp) { + const defaultVertexAI = ÉĩgetDefaultInstanceOf(VERTEX_AI_PROVIDER_NAME, provided, defaultApp); + return defaultVertexAI && new VertexAI(defaultVertexAI); +} + +export function vertexAIInstanceFactory(fn: (injector: Injector) => FirebaseVertexAI) { + return (zone: NgZone, injector: Injector) => { + const vertexAI = zone.runOutsideAngular(() => fn(injector)); + return new VertexAI(vertexAI); + }; +} + +const VERTEX_AI_INSTANCES_PROVIDER = { + provide: VertexAIInstances, + deps: [ + [new Optional(), PROVIDED_VERTEX_AI_INSTANCES ], + ] +}; + +const DEFAULT_VERTEX_AI_INSTANCE_PROVIDER = { + provide: VertexAI, + useFactory: defaultVertexAIInstanceFactory, + deps: [ + [new Optional(), PROVIDED_VERTEX_AI_INSTANCES ], + FirebaseApp, + ] +}; + +@NgModule({ + providers: [ + DEFAULT_VERTEX_AI_INSTANCE_PROVIDER, + VERTEX_AI_INSTANCES_PROVIDER, + ] +}) +export class VertexAIModule { + constructor() { + registerVersion('angularfire', VERSION.full, 'vertexai'); + } +} + +export function provideVertexAI(fn: (injector: Injector) => FirebaseVertexAI, ...deps: any[]): EnvironmentProviders { + registerVersion('angularfire', VERSION.full, 'vertexai'); + + return makeEnvironmentProviders([ + DEFAULT_VERTEX_AI_INSTANCE_PROVIDER, + VERTEX_AI_INSTANCES_PROVIDER, + { + provide: PROVIDED_VERTEX_AI_INSTANCES, + useFactory: vertexAIInstanceFactory(fn), + multi: true, + deps: [ + NgZone, + Injector, + ÉĩAngularFireSchedulers, + FirebaseApps, + [new Optional(), AppCheckInstances ], + ...deps, + ] + } + ]); +} diff --git a/src/vertexai/vertexai.spec.ts b/src/vertexai/vertexai.spec.ts new file mode 100644 index 000000000..5c182ba49 --- /dev/null +++ b/src/vertexai/vertexai.spec.ts @@ -0,0 +1,38 @@ +import { TestBed } from '@angular/core/testing'; +import { FirebaseApp, getApp, initializeApp, provideFirebaseApp } from '@angular/fire/app'; +import { VertexAI, getVertexAI, provideVertexAI } from '@angular/fire/vertexai'; +import { COMMON_CONFIG } from '../test-config'; +import { rando } from '../utils'; + +describe('VertexAI', () => { + let app: FirebaseApp; + let vertexAI: VertexAI; + let providedVertexAI: VertexAI; + let appName: string; + + describe('single injection', () => { + + beforeEach(() => { + appName = rando(); + TestBed.configureTestingModule({ + providers: [ + provideFirebaseApp(() => initializeApp(COMMON_CONFIG, appName)), + provideVertexAI(() => { + providedVertexAI = getVertexAI(getApp(appName)); + return providedVertexAI; + }), + ], + }); + app = TestBed.inject(FirebaseApp); + vertexAI = TestBed.inject(VertexAI); + }); + + it('should be injectable', () => { + expect(providedVertexAI).toBeTruthy(); + expect(vertexAI).toEqual(providedVertexAI); + expect(vertexAI.app).toEqual(app); + }); + + }); + +}); diff --git a/src/vertexai/vertexai.ts b/src/vertexai/vertexai.ts new file mode 100644 index 000000000..c550f366b --- /dev/null +++ b/src/vertexai/vertexai.ts @@ -0,0 +1,30 @@ +import { ÉĩgetAllInstancesOf } from '@angular/fire'; +import { VertexAI as FirebaseVertexAI } from 'firebase/vertexai'; +import { from, timer } from 'rxjs'; +import { concatMap, distinct } from 'rxjs/operators'; + +// see notes in core/firebase.app.module.ts for why we're building the class like this +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface VertexAI extends FirebaseVertexAI {} + +export class VertexAI { + constructor(vertexai: FirebaseVertexAI) { + return vertexai; + } +} + +export const VERTEX_AI_PROVIDER_NAME = 'vertexai'; + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface VertexAIInstances extends Array {} + +export class VertexAIInstances { + constructor() { + return ÉĩgetAllInstancesOf(VERTEX_AI_PROVIDER_NAME); + } +} + +export const vertexAIInstance$ = timer(0, 300).pipe( + concatMap(() => from(ÉĩgetAllInstancesOf(VERTEX_AI_PROVIDER_NAME))), + distinct(), +); diff --git a/src/zones.ts b/src/zones.ts new file mode 100644 index 000000000..dc0f7262d --- /dev/null +++ b/src/zones.ts @@ -0,0 +1,193 @@ +/* eslint-disable @typescript-eslint/ban-ts-comment */ +import { + EnvironmentInjector, + Injectable, + NgZone, + PendingTasks, + inject, + isDevMode, + runInInjectionContext +} from '@angular/core'; +import { pendingUntilEvent } from '@angular/core/rxjs-interop'; +import { + Observable, + SchedulerAction, + SchedulerLike, + Subscription, + asyncScheduler, + queueScheduler +} from 'rxjs'; +import { observeOn, subscribeOn } from 'rxjs/operators'; + +declare const Zone: {current: unknown} | undefined; + +export enum LogLevel { + "SILENT" = 0, + "WARN" = 1, + "VERBOSE" = 2, +} + + +var currentLogLevel = (isDevMode() && typeof Zone !== "undefined") ? LogLevel.WARN : LogLevel.SILENT; + +export const setLogLevel = (logLevel: LogLevel) => currentLogLevel = logLevel; + +/** + * Schedules tasks so that they are invoked inside the Zone that is passed in the constructor. + */ +export class ÉĩZoneScheduler implements SchedulerLike { + constructor(private zone: any, private delegate: any = queueScheduler) { + } + + now() { + return this.delegate.now(); + } + + schedule(work: (this: SchedulerAction, state?: any) => void, delay?: number, state?: any): Subscription { + const targetZone = this.zone; + // Wrap the specified work function to make sure that if nested scheduling takes place the + // work is executed in the correct zone + const workInZone = function(this: SchedulerAction, state: any) { + if (targetZone) { + targetZone.runGuarded(() => { + work.apply(this, [state]); + }); + } else { + work.apply(this, [state]); + } + }; + + // Scheduling itself needs to be run in zone to ensure setInterval calls for async scheduling are done + // inside the correct zone. This scheduler needs to schedule asynchronously always to ensure that + // firebase emissions are never synchronous. Specifying a delay causes issues with the queueScheduler delegate. + return this.delegate.schedule(workInZone, delay, state); + } +} + +@Injectable({ + providedIn: 'root', +}) +export class ÉĩAngularFireSchedulers { + public readonly outsideAngular: ÉĩZoneScheduler; + public readonly insideAngular: ÉĩZoneScheduler; + + constructor() { + const ngZone = inject(NgZone); + this.outsideAngular = ngZone.runOutsideAngular( + () => new ÉĩZoneScheduler(typeof Zone === 'undefined' ? undefined : Zone.current) + ); + this.insideAngular = ngZone.run( + () => new ÉĩZoneScheduler( + typeof Zone === 'undefined' ? undefined : Zone.current, + asyncScheduler + ) + ); + } +} + +var alreadyWarned = false; +function warnOutsideInjectionContext(original: any, logLevel: LogLevel) { + if (!alreadyWarned && (currentLogLevel > LogLevel.SILENT || isDevMode())) { + alreadyWarned = true; + console.warn("Calling Firebase APIs outside of an Injection context may destabilize your application leading to subtle change-detection and hydration bugs. Find more at https://github.com/angular/angularfire/blob/main/docs/zones.md"); + } + if (currentLogLevel >= logLevel) { + console.warn(`Firebase API called outside injection context: ${original.name}`); + } +} + +function runOutsideAngular(fn: (...args: any[]) => T): T { + const ngZone = inject(NgZone, { optional: true }); + if (!ngZone) {return fn();} + return ngZone.runOutsideAngular(() => fn()); +} + +function run(fn: (...args: any[]) => T): T { + const ngZone = inject(NgZone, { optional: true }); + if (!ngZone) {return fn();} + return ngZone.run(() => fn()); +} + +const zoneWrapFn = ( + it: (...args: any[]) => any, + taskDone: VoidFunction | undefined, + injector: EnvironmentInjector, +) => { + return (...args: any[]) => { + if (taskDone) { + setTimeout(taskDone, 0); + } + return runInInjectionContext(injector, () => run(() => it.apply(this, args))); + }; +}; + +export const ÉĩzoneWrap = (it: T, blockUntilFirst: boolean, logLevel?: LogLevel): T => { + logLevel ||= blockUntilFirst ? LogLevel.WARN : LogLevel.VERBOSE; + // function() is needed for the arguments object + return function () { + let taskDone: VoidFunction | undefined; + const _arguments = arguments; + let schedulers: ÉĩAngularFireSchedulers; + let pendingTasks: PendingTasks; + let injector: EnvironmentInjector; + try { + schedulers = inject(ÉĩAngularFireSchedulers); + pendingTasks = inject(PendingTasks); + injector = inject(EnvironmentInjector); + } catch(e) { + warnOutsideInjectionContext(it, logLevel); + return (it as any).apply(this, _arguments); + } + // if this is a callback function, e.g, onSnapshot, we should create a pending task and complete it + // only once one of the callback functions is tripped. + for (let i = 0; i < arguments.length; i++) { + if (typeof _arguments[i] === 'function') { + if (blockUntilFirst) { + taskDone ||= run(() => pendingTasks.add()); + } + // TODO create a microtask to track callback functions + _arguments[i] = zoneWrapFn(_arguments[i], taskDone, injector); + } + } + const ret = runOutsideAngular(() => (it as any).apply(this, _arguments)); + if (!blockUntilFirst) { + if (ret instanceof Observable) { + return ret.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + ); + } else { + return run(() => ret); + } + } + if (ret instanceof Observable) { + return ret.pipe( + subscribeOn(schedulers.outsideAngular), + observeOn(schedulers.insideAngular), + pendingUntilEvent(injector), + ); + } else if (ret instanceof Promise) { + // eslint-disable-next-line @typescript-eslint/no-misused-promises + return run( + () => { + const removeTask = pendingTasks.add(); + return new Promise((resolve, reject) => { + ret.then( + (it) => runInInjectionContext(injector, () => run(() => resolve(it))), + (reason) => runInInjectionContext(injector, () => run(() => reject(reason))) + ).finally(removeTask); + }); + }); + } else if (typeof ret === 'function' && taskDone) { + // Handle unsubscribe + // function() is needed for the arguments object + return function () { + setTimeout(taskDone, 0); + return ret.apply(this, arguments); + }; + } else { + // TODO how do we handle storage uploads in Zone? and other stuff with cancel() etc? + return run(() => ret); + } + } as any; +}; diff --git a/test/database.rules.json b/test/database.rules.json new file mode 100644 index 000000000..8e595f8dd --- /dev/null +++ b/test/database.rules.json @@ -0,0 +1,10 @@ +{ + "rules": { + ".read": true, + ".write": true, + ".indexOn": [ + "height", + ".value" + ] + } +} diff --git a/test/e2e/auth/firebase_auth_example.spec.ts b/test/e2e/auth/firebase_auth_example.spec.ts deleted file mode 100644 index 697515112..000000000 --- a/test/e2e/auth/firebase_auth_example.spec.ts +++ /dev/null @@ -1,14 +0,0 @@ -import { waitForElement } from '../shared'; - -describe('FirebaseList', () => { - it('should login anonymously', () => { - browser.get('auth/index.html'); - waitForElement('#is-anonymous'); - var isAnonymous = $('#is-anonymous'); - expect(isAnonymous.getText()).toBe(''); - var login = $('#login-anonymous'); - login.click(); - browser.sleep(1000); - expect(isAnonymous.getText()).toBe('true'); - }); -}); diff --git a/test/e2e/auth/firebase_auth_example.ts b/test/e2e/auth/firebase_auth_example.ts deleted file mode 100644 index eda3e7782..000000000 --- a/test/e2e/auth/firebase_auth_example.ts +++ /dev/null @@ -1,164 +0,0 @@ -import {Component, enableProdMode, Inject, provide} from '@angular/core'; -import {bootstrap} from '@angular/platform-browser-dynamic'; -import { - AuthMethods, - AuthProviders, - AngularFire, - FIREBASE_PROVIDERS, - FirebaseListObservable, - FirebaseAuthState, - FirebaseApp -} from '../../../dist/angularfire2'; - -declare var Zone: any; - -enableProdMode(); - -// TODO fix imports and tsconfig -// import { COMMON_CONFIG } from 'angularfire2/test-config'; - -import 'rxjs/add/operator/do'; - -const COMMON_CONFIG = { - apiKey: "AIzaSyBVSy3YpkVGiKXbbxeK0qBnu3-MNZ9UIjA", - authDomain: "angularfire2-test.firebaseapp.com", - databaseURL: "https://angularfire2-test.firebaseio.com/", - storageBucket: "angularfire2-test.appspot.com" -}; - -@Component({ - template: ` - -

-
-

Anonymous Login

- - -

- Is Anonymous? - - {{ user?.anonymous }} - -

-
-
-

OAuth Login

- - -

OAuth Provider

- - -

- - -

- -

- -

-
- -
-

Create User

- - - -
- -
-

Email and Password Login

- - - -
- -
-

Custom Token Login

- - -
- -
- -
-

Provider Data

- {{ user?.providerData && user.providerData[0] | json }} - Not Logged In -
- -
-

User

- (Empty object is equivalent to null). - {{ user || {} | json }} -
- `, - selector: 'app' -}) -class App { - user: FirebaseAuthState; - questions: FirebaseListObservable; - constructor(public af: AngularFire) { - af.auth - .do(v => console.log('onAuth', v)) - .map(u => { - return Object.assign({}, u, { - auth: null // makes easier to convert to json - }) - }) - .subscribe(user => { - console.log('zone', Zone.current.name); - this.user = user - }); - } - - signInAnonymously() { - this.af.auth.login({ - method: AuthMethods.Anonymous - }) - .then((user) => console.log(`Anonymous Login Success:`, user)) - .catch(e => console.error(`Anonymous Login Failure:`, e)); - } - - signInWithOAuth(redirect: boolean, provider: string) { - this.af.auth.login({ - method: redirect ? AuthMethods.Redirect : AuthMethods.Popup, - provider: (AuthProviders)[provider] - }) - .then((user) => console.log(`${provider} Login Success:`, user)) - .catch(e => console.error(`${provider} Login Failure:`, e)); - } - - createUser(email: string, password: string) { - this.af.auth.createUser({ email, password }) - .then((user) => console.log(`Create User Success:`, user)) - .catch(e => console.error(`Create User Failure:`, e)); - } - - loginUser(email: string, password: string) { - this.af.auth.login({ email, password }, { - method: AuthMethods.Password, - provider: AuthProviders.Password - }) - .then((user) => console.log(`Password Login Success:`, user)) - .catch(e => console.error(`Password Login Failure:`, e)); - } - - signInWithCustomToken(token: string) { - // TODO: this.af.auth.login({ token }); - } -} - -bootstrap(App, [ - FIREBASE_PROVIDERS, - defaultFirebase(COMMON_CONFIG)]).then(() => { - console.log('bootstrap success'); - }, (e:any) => { - console.error('bootstrap failed', e); - }); diff --git a/test/e2e/auth/index.html b/test/e2e/auth/index.html deleted file mode 100644 index 01929560e..000000000 --- a/test/e2e/auth/index.html +++ /dev/null @@ -1,14 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/test/e2e/firebase_list/firebase_list_example.spec.js b/test/e2e/firebase_list/firebase_list_example.spec.js deleted file mode 100644 index 71937c595..000000000 --- a/test/e2e/firebase_list/firebase_list_example.spec.js +++ /dev/null @@ -1,21 +0,0 @@ -/* global protractor */ -/* global $ */ -/* global element */ -/* global browser */ -function waitForElement(selector) { - var EC = (protractor).ExpectedConditions; - // Waits for the element with id 'abc' to be present on the dom. - browser.wait(EC.presenceOf($(selector)), 20000); -} - -describe('FirebaseList', () => { - it('should render', () => { - browser.get('firebase_list/index.html'); - waitForElement('app'); - var app = $('app'); - browser.sleep(500); - expect(app.getText()).toBe(`Hello -why? -how?`); - }); -}); \ No newline at end of file diff --git a/test/e2e/firebase_list/firebase_list_example.spec.ts b/test/e2e/firebase_list/firebase_list_example.spec.ts deleted file mode 100644 index 82e348584..000000000 --- a/test/e2e/firebase_list/firebase_list_example.spec.ts +++ /dev/null @@ -1,13 +0,0 @@ -import { waitForElement } from '../shared'; - -describe('FirebaseList', () => { - it('should render', () => { - browser.get('firebase_list/index.html'); - waitForElement('app'); - var app = $('app'); - browser.sleep(500); - expect(app.getText()).toBe(`Hello -why? -how?`); - }); -}); \ No newline at end of file diff --git a/test/e2e/firebase_list/firebase_list_example.ts b/test/e2e/firebase_list/firebase_list_example.ts deleted file mode 100644 index d299de6ea..000000000 --- a/test/e2e/firebase_list/firebase_list_example.ts +++ /dev/null @@ -1,49 +0,0 @@ -import {Component, enableProdMode, Inject, provide} from '@angular/core'; -import {bootstrap} from '@angular/platform-browser-dynamic'; -import { - defaultFirebase, - AngularFire, - FIREBASE_PROVIDERS, - FirebaseListObservable, - FirebaseApp -} from '../../../dist/angularfire2'; - -enableProdMode(); - -// TODO fix imports and tsconfig -// import { COMMON_CONFIG } from '../../../src/test-config'; - -const COMMON_CONFIG = { - apiKey: "AIzaSyBVSy3YpkVGiKXbbxeK0qBnu3-MNZ9UIjA", - authDomain: "angularfire2-test.firebaseapp.com", - databaseURL: "https://angularfire2-test.firebaseio.com/", - storageBucket: "angularfire2-test.appspot.com", -}; - -@Component({ - template: ` -

Hello

-
- {{question.question}} -
- `, - selector: 'app' -}) -class App { - questions:FirebaseListObservable; - constructor(public af:AngularFire, @Inject(FirebaseApp) app: firebase.app.App) { - var ref = app.database().ref(); - ref.remove(); - this.questions = af.database.list('/questions'); - this.questions.push({question: 'why?'}); - this.questions.push({question: 'how?'}); - } -} - -bootstrap(App, [ - FIREBASE_PROVIDERS, - defaultFirebase(COMMON_CONFIG)]).then(() => { - console.log('bootstrap success'); - }, (e:any) => { - console.error('bootstrap failed', e); - }); diff --git a/test/e2e/firebase_list/index.html b/test/e2e/firebase_list/index.html deleted file mode 100644 index d574734a4..000000000 --- a/test/e2e/firebase_list/index.html +++ /dev/null @@ -1,14 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/test/e2e/firebase_object/firebase_object_example.spec.js b/test/e2e/firebase_object/firebase_object_example.spec.js deleted file mode 100644 index 4f060af91..000000000 --- a/test/e2e/firebase_object/firebase_object_example.spec.js +++ /dev/null @@ -1,20 +0,0 @@ -/* global protractor */ -/* global $ */ -/* global element */ -/* global browser */ -function waitForElement(selector) { - var EC = (protractor).ExpectedConditions; - // Waits for the element with id 'abc' to be present on the dom. - browser.wait(EC.presenceOf($(selector)), 20000); -} - -describe('FirebaseObject', () => { - it('should render', () => { - browser.get('firebase_object/index.html'); - waitForElement('app'); - var app = $('app'); - browser.sleep(500); - expect(app.getText()).toBe(`Question -how to firebase?`); - }); -}); \ No newline at end of file diff --git a/test/e2e/firebase_object/firebase_object_example.spec.ts b/test/e2e/firebase_object/firebase_object_example.spec.ts deleted file mode 100644 index 28a01f5e8..000000000 --- a/test/e2e/firebase_object/firebase_object_example.spec.ts +++ /dev/null @@ -1,12 +0,0 @@ -import { waitForElement } from '../shared'; - -describe('FirebaseObject', () => { - it('should render', () => { - browser.get('firebase_object/index.html'); - waitForElement('app'); - var app = $('app'); - browser.sleep(500); - expect(app.getText()).toBe(`Question -how to firebase?`); - }); -}); \ No newline at end of file diff --git a/test/e2e/firebase_object/firebase_object_example.ts b/test/e2e/firebase_object/firebase_object_example.ts deleted file mode 100644 index 69c3d9652..000000000 --- a/test/e2e/firebase_object/firebase_object_example.ts +++ /dev/null @@ -1,51 +0,0 @@ -import {Component, enableProdMode, Inject, provide} from '@angular/core'; -import {bootstrap} from '@angular/platform-browser-dynamic'; -import { - defaultFirebase, - AngularFire, - FIREBASE_PROVIDERS, - FirebaseObjectObservable, - FirebaseApp -} from '../../../dist/angularfire2'; - -// TODO fix imports and tsconfig -// import { COMMON_CONFIG } from '../../../src/test-config'; - -const COMMON_CONFIG = { - apiKey: "AIzaSyBVSy3YpkVGiKXbbxeK0qBnu3-MNZ9UIjA", - authDomain: "angularfire2-test.firebaseapp.com", - databaseURL: "https://angularfire2-test.firebaseio.com/", - storageBucket: "angularfire2-test.appspot.com", -}; - - -enableProdMode(); - -@Component({ - template: ` -

- Question -

- {{ (question | async).title }} - `, - selector: 'app' -}) -class App { - question:FirebaseObjectObservable; - constructor(public af:AngularFire, @Inject(FirebaseApp) app: firebase.app.App) { - var ref = app.database().ref(); - ref.remove(); - this.question = af.database.object('/questions/1'); - ref.child('/questions/1').set({title: 'how to firebase?'}); - } -} - -bootstrap(App, [ - defaultFirebase(COMMON_CONFIG), - FIREBASE_PROVIDERS -]) - .then(() => { - console.log('bootstrap success'); - }, (e:any) => { - console.error('bootstrap failed', e); - }); diff --git a/test/e2e/firebase_object/index.html b/test/e2e/firebase_object/index.html deleted file mode 100644 index 98542d1b0..000000000 --- a/test/e2e/firebase_object/index.html +++ /dev/null @@ -1,14 +0,0 @@ - - - - - - - - - - - - \ No newline at end of file diff --git a/test/e2e/shared.ts b/test/e2e/shared.ts deleted file mode 100644 index 24e3bf06a..000000000 --- a/test/e2e/shared.ts +++ /dev/null @@ -1,5 +0,0 @@ -export function waitForElement(selector: string) { - var EC = (protractor).ExpectedConditions; - // Waits for the element with id 'abc' to be present on the dom. - browser.wait(EC.presenceOf($(selector)), 20000); -} \ No newline at end of file diff --git a/test/e2e/system.config.ts b/test/e2e/system.config.ts deleted file mode 100644 index cb8ae128e..000000000 --- a/test/e2e/system.config.ts +++ /dev/null @@ -1,45 +0,0 @@ -declare var System: any; - -System.config({ - defaultExtension: 'js', - map: { - 'firebase': '/node_modules/firebase/firebase.js', - 'angularfire2': '/dist', - 'typescript': '/node_modules/typescript/lib/typescript.js', - '@angular': '/node_modules/@angular', - 'rxjs': '/node_modules/rxjs', - 'test': '/dist-test/' - }, - packages: { - 'test': { - defaultExtension: 'js' - }, - 'rxjs': { - defaultExtension: 'js', - }, - '@angular/core': { - main: 'index.js', - defaultExtension: 'js' - }, - '@angular/common': { - main: 'index.js', - defaultExtension: 'js' - }, - '@angular/compiler': { - main: 'index.js', - defaultExtension: 'js' - }, - '@angular/platform-browser': { - main: 'index.js', - defaultExtension: 'js' - }, - '@angular/platform-browser-dynamic': { - main: 'index.js', - defaultExtension: 'js' - }, - 'angularfire2': { - main: 'angularfire2.js', - defaultExtension: 'js' - } - } -}); diff --git a/test/firestore.indexes.json b/test/firestore.indexes.json new file mode 100644 index 000000000..415027e5d --- /dev/null +++ b/test/firestore.indexes.json @@ -0,0 +1,4 @@ +{ + "indexes": [], + "fieldOverrides": [] +} diff --git a/test/firestore.rules b/test/firestore.rules new file mode 100644 index 000000000..8b7eb0cbf --- /dev/null +++ b/test/firestore.rules @@ -0,0 +1,7 @@ +service cloud.firestore { + match /databases/{database}/documents { + match /{document=**} { + allow read, write: if true; + } + } +} \ No newline at end of file diff --git a/test/functions/.gitignore b/test/functions/.gitignore new file mode 100644 index 000000000..9be0f014f --- /dev/null +++ b/test/functions/.gitignore @@ -0,0 +1,10 @@ +# Compiled JavaScript files +lib/**/*.js +lib/**/*.js.map + +# TypeScript v1 declaration files +typings/ + +# Node.js dependency directory +node_modules/ +*.local \ No newline at end of file diff --git a/test/functions/package-lock.json b/test/functions/package-lock.json new file mode 100644 index 000000000..efcd8b57b --- /dev/null +++ b/test/functions/package-lock.json @@ -0,0 +1,6293 @@ +{ + "name": "functions", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "functions", + "dependencies": { + "firebase-admin": "^12.6.0", + "firebase-functions": "^6.0.1" + }, + "devDependencies": { + "firebase-functions-test": "^3.1.0", + "typescript": "^4.9.0" + }, + "engines": { + "node": "18" + } + }, + "node_modules/@ampproject/remapping": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz", + "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==", + "dev": true, + "license": "Apache-2.0", + "peer": true, + "dependencies": { + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.24" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/code-frame": { + "version": "7.26.2", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.26.2.tgz", + "integrity": "sha512-RJlIHRueQgwWitWgF8OdFYGZX328Ax5BCemNGlqHfplnRT9ESi8JkFlvaVYbS+UubVY6dpv87Fs2u5M29iNFVQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-validator-identifier": "^7.25.9", + "js-tokens": "^4.0.0", + "picocolors": "^1.0.0" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/compat-data": { + "version": "7.26.3", + "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.26.3.tgz", + "integrity": "sha512-nHIxvKPniQXpmQLb0vhY3VaFb3S0YrTAwpOWJZh1wn3oJPjJk9Asva204PsBdmAE8vpzfHudT8DB0scYvy9q0g==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/core": { + "version": "7.26.0", + "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.26.0.tgz", + "integrity": "sha512-i1SLeK+DzNnQ3LL/CswPCa/E5u4lh1k6IAEphON8F+cXt0t9euTshDru0q7/IqMa1PMPz5RnHuHscF8/ZJsStg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@ampproject/remapping": "^2.2.0", + "@babel/code-frame": "^7.26.0", + "@babel/generator": "^7.26.0", + "@babel/helper-compilation-targets": "^7.25.9", + "@babel/helper-module-transforms": "^7.26.0", + "@babel/helpers": "^7.26.0", + "@babel/parser": "^7.26.0", + "@babel/template": "^7.25.9", + "@babel/traverse": "^7.25.9", + "@babel/types": "^7.26.0", + "convert-source-map": "^2.0.0", + "debug": "^4.1.0", + "gensync": "^1.0.0-beta.2", + "json5": "^2.2.3", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/babel" + } + }, + "node_modules/@babel/core/node_modules/debug": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/@babel/core/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/@babel/generator": { + "version": "7.26.3", + "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.26.3.tgz", + "integrity": "sha512-6FF/urZvD0sTeO7k6/B15pMLC4CHUv1426lzr3N01aHJTl046uCAh9LXW/fzeXXjPNCJ6iABW5XaWOsIZB93aQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/parser": "^7.26.3", + "@babel/types": "^7.26.3", + "@jridgewell/gen-mapping": "^0.3.5", + "@jridgewell/trace-mapping": "^0.3.25", + "jsesc": "^3.0.2" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-compilation-targets": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.25.9.tgz", + "integrity": "sha512-j9Db8Suy6yV/VHa4qzrj9yZfZxhLWQdVnRlXxmKLYlhWUVB1sB2G5sxuWYXk/whHD9iW76PmNzxZ4UCnTQTVEQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/compat-data": "^7.25.9", + "@babel/helper-validator-option": "^7.25.9", + "browserslist": "^4.24.0", + "lru-cache": "^5.1.1", + "semver": "^6.3.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-imports": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.25.9.tgz", + "integrity": "sha512-tnUA4RsrmflIM6W6RFTLFSXITtl0wKjgpnLgXyowocVPrbYrLUXSBXDgTs8BlbmIzIdlBySRQjINYs2BAkiLtw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/traverse": "^7.25.9", + "@babel/types": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-module-transforms": { + "version": "7.26.0", + "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.26.0.tgz", + "integrity": "sha512-xO+xu6B5K2czEnQye6BHA7DolFFmS3LB7stHZFaOLb1pAwO1HWLS8fXA+eh0A2yIvltPVmx3eNNDBJA2SLHXFw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-module-imports": "^7.25.9", + "@babel/helper-validator-identifier": "^7.25.9", + "@babel/traverse": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/@babel/helper-plugin-utils": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.25.9.tgz", + "integrity": "sha512-kSMlyUVdWe25rEsRGviIgOWnoT/nfABVWlqt9N19/dIPWViAOW2s9wznP5tURbs/IDuNk4gPy3YdYRgH3uxhBw==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.25.9.tgz", + "integrity": "sha512-4A/SCr/2KLd5jrtOMFzaKjVtAei3+2r/NChoBNoZ3EyP/+GlhoaEGoWOZUmFmoITP7zOJyHIMm+DYRd8o3PvHA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.25.9.tgz", + "integrity": "sha512-Ed61U6XJc3CVRfkERJWDz4dJwKe7iLmmJsbOGu9wSloNSFttHV0I8g6UAgb7qnK5ly5bGLPd4oXZlxCdANBOWQ==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-option": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.25.9.tgz", + "integrity": "sha512-e/zv1co8pp55dNdEcCynfj9X7nyUKUXoUEwfXqaZt0omVOmDe9oOTdKStH4GmAw6zxMFs50ZayuMfHDKlO7Tfw==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helpers": { + "version": "7.26.0", + "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.26.0.tgz", + "integrity": "sha512-tbhNuIxNcVb21pInl3ZSjksLCvgdZy9KwJ8brv993QtIVKJBBkYXz4q4ZbAv31GdnC+R90np23L5FbEBlthAEw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/template": "^7.25.9", + "@babel/types": "^7.26.0" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.26.3", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.26.3.tgz", + "integrity": "sha512-WJ/CvmY8Mea8iDXo6a7RK2wbmJITT5fN3BEkRuFlxVyNx8jOKIIhmC4fSkTcPcf8JyavbBwIe6OpiCOBXt/IcA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/types": "^7.26.3" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/plugin-syntax-async-generators": { + "version": "7.8.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz", + "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-bigint": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-bigint/-/plugin-syntax-bigint-7.8.3.tgz", + "integrity": "sha512-wnTnFlG+YxQm3vDxpGE57Pj0srRU4sHE/mDkt1qv2YJJSeUAec2ma4WLUnUPeKjyrfntVwe/N6dCXpU+zL3Npg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-class-properties": { + "version": "7.12.13", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz", + "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.12.13" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-class-static-block": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz", + "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-attributes": { + "version": "7.26.0", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.26.0.tgz", + "integrity": "sha512-e2dttdsJ1ZTpi3B9UYGLw41hifAubg19AtCu/2I/F1QNVclOBr1dYpTdmdyZ84Xiz43BS/tCUkMAZNLv12Pi+A==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-import-meta": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz", + "integrity": "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-json-strings": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz", + "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-jsx": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.25.9.tgz", + "integrity": "sha512-ld6oezHQMZsZfp6pWtbjaNDF2tiiCYYDqQszHt5VV437lewP9aSi2Of99CK0D0XB21k7FLgnLcmQKyKzynfeAA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-logical-assignment-operators": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz", + "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-nullish-coalescing-operator": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz", + "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-numeric-separator": { + "version": "7.10.4", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz", + "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.10.4" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-object-rest-spread": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz", + "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-optional-catch-binding": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz", + "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-optional-chaining": { + "version": "7.8.3", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz", + "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.8.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-private-property-in-object": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz", + "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-top-level-await": { + "version": "7.14.5", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz", + "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.14.5" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/plugin-syntax-typescript": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.25.9.tgz", + "integrity": "sha512-hjMgRy5hb8uJJjUcdWunWVcoi9bGpJp8p5Ol1229PoN6aytsLwNMgmdftO23wnCLMfVmTwZDWMPNq/D1SY60JQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0-0" + } + }, + "node_modules/@babel/template": { + "version": "7.25.9", + "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.25.9.tgz", + "integrity": "sha512-9DGttpmPvIxBb/2uwpVo3dqJ+O6RooAFOS+lB+xDqoE2PVCE8nfoHMdZLpfCQRLwvohzXISPZcgxt80xLfsuwg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/code-frame": "^7.25.9", + "@babel/parser": "^7.25.9", + "@babel/types": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse": { + "version": "7.26.4", + "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.26.4.tgz", + "integrity": "sha512-fH+b7Y4p3yqvApJALCPJcwb0/XaOSgtK4pzV6WVjPR5GLFQBRI7pfoX2V2iM48NXvX07NUxxm1Vw98YjqTcU5w==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/code-frame": "^7.26.2", + "@babel/generator": "^7.26.3", + "@babel/parser": "^7.26.3", + "@babel/template": "^7.25.9", + "@babel/types": "^7.26.3", + "debug": "^4.3.1", + "globals": "^11.1.0" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/traverse/node_modules/debug": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/@babel/traverse/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/@babel/types": { + "version": "7.26.3", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.26.3.tgz", + "integrity": "sha512-vN5p+1kl59GVKMvTHt55NzzmYVxprfJD+ql7U9NFIfKCBkYE55LYtS+WtPlaYOyzydrKI8Nezd+aZextrd+FMA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/helper-string-parser": "^7.25.9", + "@babel/helper-validator-identifier": "^7.25.9" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@bcoe/v8-coverage": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/@bcoe/v8-coverage/-/v8-coverage-0.2.3.tgz", + "integrity": "sha512-0hYQ8SB4Db5zvZB4axdMHGwEaQjkZzFjQiN9LVYvIFB2nSUHW9tYpxWriPrWDASIxiaXax83REcLxuSdnGPZtw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/@fastify/busboy": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@fastify/busboy/-/busboy-3.1.0.tgz", + "integrity": "sha512-yHmUtGwEbW6HsKpPqT140/L6GpHtquHogRLgtanJFep3UAfDkE0fQfC49U+F9irCAoJVlv3M7VSp4rrtO4LnfA==", + "license": "MIT" + }, + "node_modules/@firebase/app-check-interop-types": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@firebase/app-check-interop-types/-/app-check-interop-types-0.3.2.tgz", + "integrity": "sha512-LMs47Vinv2HBMZi49C09dJxp0QT5LwDzFaVGf/+ITHe3BlIhUiLNttkATSXplc89A2lAaeTqjgqVkiRfUGyQiQ==", + "license": "Apache-2.0" + }, + "node_modules/@firebase/app-types": { + "version": "0.9.2", + "resolved": "https://registry.npmjs.org/@firebase/app-types/-/app-types-0.9.2.tgz", + "integrity": "sha512-oMEZ1TDlBz479lmABwWsWjzHwheQKiAgnuKxE0pz0IXCVx7/rtlkx1fQ6GfgK24WCrxDKMplZrT50Kh04iMbXQ==", + "license": "Apache-2.0" + }, + "node_modules/@firebase/auth-interop-types": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/@firebase/auth-interop-types/-/auth-interop-types-0.2.3.tgz", + "integrity": "sha512-Fc9wuJGgxoxQeavybiuwgyi+0rssr76b+nHpj+eGhXFYAdudMWyfBHvFL/I5fEHniUM/UQdFzi9VXJK2iZF7FQ==", + "license": "Apache-2.0" + }, + "node_modules/@firebase/component": { + "version": "0.6.9", + "resolved": "https://registry.npmjs.org/@firebase/component/-/component-0.6.9.tgz", + "integrity": "sha512-gm8EUEJE/fEac86AvHn8Z/QW8BvR56TBw3hMW0O838J/1mThYQXAIQBgUv75EqlCZfdawpWLrKt1uXvp9ciK3Q==", + "license": "Apache-2.0", + "dependencies": { + "@firebase/util": "1.10.0", + "tslib": "^2.1.0" + } + }, + "node_modules/@firebase/database": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@firebase/database/-/database-1.0.8.tgz", + "integrity": "sha512-dzXALZeBI1U5TXt6619cv0+tgEhJiwlUtQ55WNZY7vGAjv7Q1QioV969iYwt1AQQ0ovHnEW0YW9TiBfefLvErg==", + "license": "Apache-2.0", + "dependencies": { + "@firebase/app-check-interop-types": "0.3.2", + "@firebase/auth-interop-types": "0.2.3", + "@firebase/component": "0.6.9", + "@firebase/logger": "0.4.2", + "@firebase/util": "1.10.0", + "faye-websocket": "0.11.4", + "tslib": "^2.1.0" + } + }, + "node_modules/@firebase/database-compat": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@firebase/database-compat/-/database-compat-1.0.8.tgz", + "integrity": "sha512-OpeWZoPE3sGIRPBKYnW9wLad25RaWbGyk7fFQe4xnJQKRzlynWeFBSRRAoLE2Old01WXwskUiucNqUUVlFsceg==", + "license": "Apache-2.0", + "dependencies": { + "@firebase/component": "0.6.9", + "@firebase/database": "1.0.8", + "@firebase/database-types": "1.0.5", + "@firebase/logger": "0.4.2", + "@firebase/util": "1.10.0", + "tslib": "^2.1.0" + } + }, + "node_modules/@firebase/database-types": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/@firebase/database-types/-/database-types-1.0.5.tgz", + "integrity": "sha512-fTlqCNwFYyq/C6W7AJ5OCuq5CeZuBEsEwptnVxlNPkWCo5cTTyukzAHRSO/jaQcItz33FfYrrFk1SJofcu2AaQ==", + "license": "Apache-2.0", + "dependencies": { + "@firebase/app-types": "0.9.2", + "@firebase/util": "1.10.0" + } + }, + "node_modules/@firebase/logger": { + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@firebase/logger/-/logger-0.4.2.tgz", + "integrity": "sha512-Q1VuA5M1Gjqrwom6I6NUU4lQXdo9IAQieXlujeHZWvRt1b7qQ0KwBaNAjgxG27jgF9/mUwsNmO8ptBCGVYhB0A==", + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.1.0" + } + }, + "node_modules/@firebase/util": { + "version": "1.10.0", + "resolved": "https://registry.npmjs.org/@firebase/util/-/util-1.10.0.tgz", + "integrity": "sha512-xKtx4A668icQqoANRxyDLBLz51TAbDP9KRfpbKGxiCAW346d0BeJe5vN6/hKxxmWwnZ0mautyv39JxviwwQMOQ==", + "license": "Apache-2.0", + "dependencies": { + "tslib": "^2.1.0" + } + }, + "node_modules/@google-cloud/firestore": { + "version": "7.11.0", + "resolved": "https://registry.npmjs.org/@google-cloud/firestore/-/firestore-7.11.0.tgz", + "integrity": "sha512-88uZ+jLsp1aVMj7gh3EKYH1aulTAMFAp8sH/v5a9w8q8iqSG27RiWLoxSAFr/XocZ9hGiWH1kEnBw+zl3xAgNA==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@opentelemetry/api": "^1.3.0", + "fast-deep-equal": "^3.1.1", + "functional-red-black-tree": "^1.0.1", + "google-gax": "^4.3.3", + "protobufjs": "^7.2.6" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@google-cloud/paginator": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/@google-cloud/paginator/-/paginator-5.0.2.tgz", + "integrity": "sha512-DJS3s0OVH4zFDB1PzjxAsHqJT6sKVbRwwML0ZBP9PbU7Yebtu/7SWMRzvO2J3nUi9pRNITCfu4LJeooM2w4pjg==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "arrify": "^2.0.0", + "extend": "^3.0.2" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@google-cloud/projectify": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/@google-cloud/projectify/-/projectify-4.0.0.tgz", + "integrity": "sha512-MmaX6HeSvyPbWGwFq7mXdo0uQZLGBYCwziiLIGq5JVX+/bdI3SAq6bP98trV5eTWfLuvsMcIC1YJOF2vfteLFA==", + "license": "Apache-2.0", + "optional": true, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@google-cloud/promisify": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/@google-cloud/promisify/-/promisify-4.0.0.tgz", + "integrity": "sha512-Orxzlfb9c67A15cq2JQEyVc7wEsmFBmHjZWZYQMUyJ1qivXyMwdyNOs9odi79hze+2zqdTtu1E19IM/FtqZ10g==", + "license": "Apache-2.0", + "optional": true, + "engines": { + "node": ">=14" + } + }, + "node_modules/@google-cloud/storage": { + "version": "7.14.0", + "resolved": "https://registry.npmjs.org/@google-cloud/storage/-/storage-7.14.0.tgz", + "integrity": "sha512-H41bPL2cMfSi4EEnFzKvg7XSb7T67ocSXrmF7MPjfgFB0L6CKGzfIYJheAZi1iqXjz6XaCT1OBf6HCG5vDBTOQ==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@google-cloud/paginator": "^5.0.0", + "@google-cloud/projectify": "^4.0.0", + "@google-cloud/promisify": "^4.0.0", + "abort-controller": "^3.0.0", + "async-retry": "^1.3.3", + "duplexify": "^4.1.3", + "fast-xml-parser": "^4.4.1", + "gaxios": "^6.0.2", + "google-auth-library": "^9.6.3", + "html-entities": "^2.5.2", + "mime": "^3.0.0", + "p-limit": "^3.0.1", + "retry-request": "^7.0.0", + "teeny-request": "^9.0.0", + "uuid": "^8.0.0" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/@google-cloud/storage/node_modules/uuid": { + "version": "8.3.2", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz", + "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==", + "license": "MIT", + "optional": true, + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/@grpc/grpc-js": { + "version": "1.12.4", + "resolved": "https://registry.npmjs.org/@grpc/grpc-js/-/grpc-js-1.12.4.tgz", + "integrity": "sha512-NBhrxEWnFh0FxeA0d//YP95lRFsSx2TNLEUQg4/W+5f/BMxcCjgOOIT24iD+ZB/tZw057j44DaIxja7w4XMrhg==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@grpc/proto-loader": "^0.7.13", + "@js-sdsl/ordered-map": "^4.4.2" + }, + "engines": { + "node": ">=12.10.0" + } + }, + "node_modules/@grpc/proto-loader": { + "version": "0.7.13", + "resolved": "https://registry.npmjs.org/@grpc/proto-loader/-/proto-loader-0.7.13.tgz", + "integrity": "sha512-AiXO/bfe9bmxBjxxtYxFAXGZvMaN5s8kO+jBHAJCON8rJoB5YS/D6X7ZNc6XQkuHNmyl4CYaMI1fJ/Gn27RGGw==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "lodash.camelcase": "^4.3.0", + "long": "^5.0.0", + "protobufjs": "^7.2.5", + "yargs": "^17.7.2" + }, + "bin": { + "proto-loader-gen-types": "build/bin/proto-loader-gen-types.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/@istanbuljs/load-nyc-config": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@istanbuljs/load-nyc-config/-/load-nyc-config-1.1.0.tgz", + "integrity": "sha512-VjeHSlIzpv/NyD3N0YuHfXOPDIixcA1q2ZV98wsMqcYlPmv2n3Yb2lYP9XMElnaFVXg5A7YLTeLu6V84uQDjmQ==", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "camelcase": "^5.3.1", + "find-up": "^4.1.0", + "get-package-type": "^0.1.0", + "js-yaml": "^3.13.1", + "resolve-from": "^5.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/@istanbuljs/schema": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.3.tgz", + "integrity": "sha512-ZXRY4jNvVgSVQ8DL3LTcakaAtXwTVUxE81hslsyD2AtoXW/wVob10HkOJ1X/pAlcI7D+2YoZKg5do8G/w6RYgA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/@jest/console": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/console/-/console-29.7.0.tgz", + "integrity": "sha512-5Ni4CU7XHQi32IJ398EEP4RrB8eV09sXP2ROqD4bksHrnTree52PsxvX8tpL8LvTZ3pFzXyPbNQReSN41CAhOg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "jest-message-util": "^29.7.0", + "jest-util": "^29.7.0", + "slash": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/core": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/core/-/core-29.7.0.tgz", + "integrity": "sha512-n7aeXWKMnGtDA48y8TLWJPJmLmmZ642Ceo78cYWEpiD7FzDgmNDV/GCVRorPABdXLJZ/9wzzgZAlHjXjxDHGsg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/console": "^29.7.0", + "@jest/reporters": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "ansi-escapes": "^4.2.1", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "exit": "^0.1.2", + "graceful-fs": "^4.2.9", + "jest-changed-files": "^29.7.0", + "jest-config": "^29.7.0", + "jest-haste-map": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-regex-util": "^29.6.3", + "jest-resolve": "^29.7.0", + "jest-resolve-dependencies": "^29.7.0", + "jest-runner": "^29.7.0", + "jest-runtime": "^29.7.0", + "jest-snapshot": "^29.7.0", + "jest-util": "^29.7.0", + "jest-validate": "^29.7.0", + "jest-watcher": "^29.7.0", + "micromatch": "^4.0.4", + "pretty-format": "^29.7.0", + "slash": "^3.0.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/@jest/environment": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/environment/-/environment-29.7.0.tgz", + "integrity": "sha512-aQIfHDq33ExsN4jP1NWGXhxgQ/wixs60gDiKO+XVMd8Mn0NWPWgc34ZQDTb2jKaUWQ7MuwoitXAsN2XVXNMpAw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/fake-timers": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "jest-mock": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/expect": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/expect/-/expect-29.7.0.tgz", + "integrity": "sha512-8uMeAMycttpva3P1lBHB8VciS9V0XAr3GymPpipdyQXbBcuhkLQOSe8E/p92RyAdToS6ZD1tFkX+CkhoECE0dQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "expect": "^29.7.0", + "jest-snapshot": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/expect-utils": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/expect-utils/-/expect-utils-29.7.0.tgz", + "integrity": "sha512-GlsNBWiFQFCVi9QVSx7f5AgMeLxe9YCCs5PuP2O2LdjDAA8Jh9eX7lA1Jq/xdXw3Wb3hyvlFNfZIfcRetSzYcA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "jest-get-type": "^29.6.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/fake-timers": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/fake-timers/-/fake-timers-29.7.0.tgz", + "integrity": "sha512-q4DH1Ha4TTFPdxLsqDXK1d3+ioSL7yL5oCMJZgDYm6i+6CygW5E5xVr/D1HdsGxjt1ZWSfUAs9OxSB/BNelWrQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/types": "^29.6.3", + "@sinonjs/fake-timers": "^10.0.2", + "@types/node": "*", + "jest-message-util": "^29.7.0", + "jest-mock": "^29.7.0", + "jest-util": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/globals": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/globals/-/globals-29.7.0.tgz", + "integrity": "sha512-mpiz3dutLbkW2MNFubUGUEVLkTGiqW6yLVTA+JbP6fI6J5iL9Y0Nlg8k95pcF8ctKwCS7WVxteBs29hhfAotzQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/environment": "^29.7.0", + "@jest/expect": "^29.7.0", + "@jest/types": "^29.6.3", + "jest-mock": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/reporters": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/reporters/-/reporters-29.7.0.tgz", + "integrity": "sha512-DApq0KJbJOEzAFYjHADNNxAE3KbhxQB1y5Kplb5Waqw6zVbuWatSnMjE5gs8FUgEPmNsnZA3NCWl9NG0ia04Pg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@bcoe/v8-coverage": "^0.2.3", + "@jest/console": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "@jridgewell/trace-mapping": "^0.3.18", + "@types/node": "*", + "chalk": "^4.0.0", + "collect-v8-coverage": "^1.0.0", + "exit": "^0.1.2", + "glob": "^7.1.3", + "graceful-fs": "^4.2.9", + "istanbul-lib-coverage": "^3.0.0", + "istanbul-lib-instrument": "^6.0.0", + "istanbul-lib-report": "^3.0.0", + "istanbul-lib-source-maps": "^4.0.0", + "istanbul-reports": "^3.1.3", + "jest-message-util": "^29.7.0", + "jest-util": "^29.7.0", + "jest-worker": "^29.7.0", + "slash": "^3.0.0", + "string-length": "^4.0.1", + "strip-ansi": "^6.0.0", + "v8-to-istanbul": "^9.0.1" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/@jest/schemas": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz", + "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@sinclair/typebox": "^0.27.8" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/source-map": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/@jest/source-map/-/source-map-29.6.3.tgz", + "integrity": "sha512-MHjT95QuipcPrpLM+8JMSzFx6eHp5Bm+4XeFDJlwsvVBjmKNiIAvasGK2fxz2WbGRlnvqehFbh07MMa7n3YJnw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jridgewell/trace-mapping": "^0.3.18", + "callsites": "^3.0.0", + "graceful-fs": "^4.2.9" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/test-result": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/test-result/-/test-result-29.7.0.tgz", + "integrity": "sha512-Fdx+tv6x1zlkJPcWXmMDAG2HBnaR9XPSd5aDWQVsfrZmLVT3lU1cwyxLgRmXR9yrq4NBoEm9BMsfgFzTQAbJYA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/console": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/istanbul-lib-coverage": "^2.0.0", + "collect-v8-coverage": "^1.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/test-sequencer": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/test-sequencer/-/test-sequencer-29.7.0.tgz", + "integrity": "sha512-GQwJ5WZVrKnOJuiYiAF52UNUJXgTZx1NHjFSEB0qEMmSZKAkdMoIzw/Cj6x6NF4AvV23AUqDpFzQkN/eYCYTxw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/test-result": "^29.7.0", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^29.7.0", + "slash": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/transform": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/@jest/transform/-/transform-29.7.0.tgz", + "integrity": "sha512-ok/BTPFzFKVMwO5eOHRrvnBVHdRy9IrsrW1GpMaQ9MCnilNLXQKmAX8s1YXDFaai9xJpac2ySzV0YeRRECr2Vw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/core": "^7.11.6", + "@jest/types": "^29.6.3", + "@jridgewell/trace-mapping": "^0.3.18", + "babel-plugin-istanbul": "^6.1.1", + "chalk": "^4.0.0", + "convert-source-map": "^2.0.0", + "fast-json-stable-stringify": "^2.1.0", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^29.7.0", + "jest-regex-util": "^29.6.3", + "jest-util": "^29.7.0", + "micromatch": "^4.0.4", + "pirates": "^4.0.4", + "slash": "^3.0.0", + "write-file-atomic": "^4.0.2" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jest/types": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/@jest/types/-/types-29.6.3.tgz", + "integrity": "sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/schemas": "^29.6.3", + "@types/istanbul-lib-coverage": "^2.0.0", + "@types/istanbul-reports": "^3.0.0", + "@types/node": "*", + "@types/yargs": "^17.0.8", + "chalk": "^4.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/@jridgewell/gen-mapping": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz", + "integrity": "sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jridgewell/set-array": "^1.2.1", + "@jridgewell/sourcemap-codec": "^1.4.10", + "@jridgewell/trace-mapping": "^0.3.24" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/set-array": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.2.1.tgz", + "integrity": "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz", + "integrity": "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.25", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz", + "integrity": "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jridgewell/resolve-uri": "^3.1.0", + "@jridgewell/sourcemap-codec": "^1.4.14" + } + }, + "node_modules/@js-sdsl/ordered-map": { + "version": "4.4.2", + "resolved": "https://registry.npmjs.org/@js-sdsl/ordered-map/-/ordered-map-4.4.2.tgz", + "integrity": "sha512-iUKgm52T8HOE/makSxjqoWhe95ZJA1/G1sYsGev2JDKUSS14KAgg1LHb+Ba+IPow0xflbnSkOsZcO08C7w1gYw==", + "license": "MIT", + "optional": true, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/js-sdsl" + } + }, + "node_modules/@opentelemetry/api": { + "version": "1.9.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.0.tgz", + "integrity": "sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg==", + "license": "Apache-2.0", + "optional": true, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/@protobufjs/aspromise": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@protobufjs/aspromise/-/aspromise-1.1.2.tgz", + "integrity": "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==", + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/base64": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@protobufjs/base64/-/base64-1.1.2.tgz", + "integrity": "sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==", + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/codegen": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.4.tgz", + "integrity": "sha512-YyFaikqM5sH0ziFZCN3xDC7zeGaB/d0IUb9CATugHWbd1FRFwWwt4ld4OYMPWu5a3Xe01mGAULCdqhMlPl29Jg==", + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/eventemitter": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@protobufjs/eventemitter/-/eventemitter-1.1.0.tgz", + "integrity": "sha512-j9ednRT81vYJ9OfVuXG6ERSTdEL1xVsNgqpkxMsbIabzSo3goCjDIveeGv5d03om39ML71RdmrGNjG5SReBP/Q==", + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/fetch": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.0.tgz", + "integrity": "sha512-lljVXpqXebpsijW71PZaCYeIcE5on1w5DlQy5WH6GLbFryLUrBD4932W/E2BSpfRJWseIL4v/KPgBFxDOIdKpQ==", + "license": "BSD-3-Clause", + "dependencies": { + "@protobufjs/aspromise": "^1.1.1", + "@protobufjs/inquire": "^1.1.0" + } + }, + "node_modules/@protobufjs/float": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/@protobufjs/float/-/float-1.0.2.tgz", + "integrity": "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==", + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/inquire": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.0.tgz", + "integrity": "sha512-kdSefcPdruJiFMVSbn801t4vFK7KB/5gd2fYvrxhuJYg8ILrmn9SKSX2tZdV6V+ksulWqS7aXjBcRXl3wHoD9Q==", + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/path": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@protobufjs/path/-/path-1.1.2.tgz", + "integrity": "sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA==", + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/pool": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@protobufjs/pool/-/pool-1.1.0.tgz", + "integrity": "sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==", + "license": "BSD-3-Clause" + }, + "node_modules/@protobufjs/utf8": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.0.tgz", + "integrity": "sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==", + "license": "BSD-3-Clause" + }, + "node_modules/@sinclair/typebox": { + "version": "0.27.8", + "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz", + "integrity": "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/@sinonjs/commons": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-3.0.1.tgz", + "integrity": "sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "type-detect": "4.0.8" + } + }, + "node_modules/@sinonjs/fake-timers": { + "version": "10.3.0", + "resolved": "https://registry.npmjs.org/@sinonjs/fake-timers/-/fake-timers-10.3.0.tgz", + "integrity": "sha512-V4BG07kuYSUkTCSBHG8G8TNhM+F19jXFWnQtzj+we8DrkpSBCee9Z3Ms8yiGer/dlmhe35/Xdgyo3/0rQKg7YA==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "@sinonjs/commons": "^3.0.0" + } + }, + "node_modules/@tootallnate/once": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/@tootallnate/once/-/once-2.0.0.tgz", + "integrity": "sha512-XCuKFP5PS55gnMVu3dty8KPatLqUoy/ZYzDzAGCQ8JNFCkLXzmI7vNHCR+XpbZaMWQK/vQubr7PkYq8g470J/A==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">= 10" + } + }, + "node_modules/@types/babel__core": { + "version": "7.20.5", + "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz", + "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/parser": "^7.20.7", + "@babel/types": "^7.20.7", + "@types/babel__generator": "*", + "@types/babel__template": "*", + "@types/babel__traverse": "*" + } + }, + "node_modules/@types/babel__generator": { + "version": "7.6.8", + "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.6.8.tgz", + "integrity": "sha512-ASsj+tpEDsEiFr1arWrlN6V3mdfjRMZt6LtK/Vp/kreFLnr5QH5+DhvD5nINYZXzwJvXeGq+05iUXcAzVrqWtw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__template": { + "version": "7.4.4", + "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz", + "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/parser": "^7.1.0", + "@babel/types": "^7.0.0" + } + }, + "node_modules/@types/babel__traverse": { + "version": "7.20.6", + "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.20.6.tgz", + "integrity": "sha512-r1bzfrm0tomOI8g1SzvCaQHo6Lcv6zu0EA+W2kHrt8dyrHQxGzBBL4kdkzIS+jBMV+EYcMAEAqXqYaLJq5rOZg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/types": "^7.20.7" + } + }, + "node_modules/@types/body-parser": { + "version": "1.19.5", + "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.5.tgz", + "integrity": "sha512-fB3Zu92ucau0iQ0JMCFQE7b/dv8Ot07NI3KaZIkIUNXq82k4eBAqUaneXfleGY9JWskeS9y+u0nXMyspcuQrCg==", + "license": "MIT", + "dependencies": { + "@types/connect": "*", + "@types/node": "*" + } + }, + "node_modules/@types/caseless": { + "version": "0.12.5", + "resolved": "https://registry.npmjs.org/@types/caseless/-/caseless-0.12.5.tgz", + "integrity": "sha512-hWtVTC2q7hc7xZ/RLbxapMvDMgUnDvKvMOpKal4DrMyfGBUfB1oKaZlIRr6mJL+If3bAP6sV/QneGzF6tJjZDg==", + "license": "MIT", + "optional": true + }, + "node_modules/@types/connect": { + "version": "3.4.38", + "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz", + "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/cors": { + "version": "2.8.17", + "resolved": "https://registry.npmjs.org/@types/cors/-/cors-2.8.17.tgz", + "integrity": "sha512-8CGDvrBj1zgo2qE+oS3pOCyYNqCPryMWY2bGfwA0dcfopWGgxs+78df0Rs3rc9THP4JkOhLsAa+15VdpAqkcUA==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/express": { + "version": "4.17.21", + "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.21.tgz", + "integrity": "sha512-ejlPM315qwLpaQlQDTjPdsUFSc6ZsP4AN6AlWnogPjQ7CVi7PYF3YVz+CY3jE2pwYf7E/7HlDAN0rV2GxTG0HQ==", + "license": "MIT", + "dependencies": { + "@types/body-parser": "*", + "@types/express-serve-static-core": "^4.17.33", + "@types/qs": "*", + "@types/serve-static": "*" + } + }, + "node_modules/@types/express-serve-static-core": { + "version": "4.19.6", + "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.19.6.tgz", + "integrity": "sha512-N4LZ2xG7DatVqhCZzOGb1Yi5lMbXSZcmdLDe9EzSndPV2HpWYWzRbaerl2n27irrm94EPpprqa8KpskPT085+A==", + "license": "MIT", + "dependencies": { + "@types/node": "*", + "@types/qs": "*", + "@types/range-parser": "*", + "@types/send": "*" + } + }, + "node_modules/@types/graceful-fs": { + "version": "4.1.9", + "resolved": "https://registry.npmjs.org/@types/graceful-fs/-/graceful-fs-4.1.9.tgz", + "integrity": "sha512-olP3sd1qOEe5dXTSaFvQG+02VdRXcdytWLAZsAq1PecU8uqQAhkrnbli7DagjtXKW/Bl7YJbUsa8MPcuc8LHEQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/http-errors": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.4.tgz", + "integrity": "sha512-D0CFMMtydbJAegzOyHjtiKPLlvnm3iTZyZRSZoLq2mRhDdmLfIWOCYPfQJ4cu2erKghU++QvjcUjp/5h7hESpA==", + "license": "MIT" + }, + "node_modules/@types/istanbul-lib-coverage": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.6.tgz", + "integrity": "sha512-2QF/t/auWm0lsy8XtKVPG19v3sSOQlJe/YHZgfjb/KBBHOGSV+J2q/S671rcq9uTBrLAXmZpqJiaQbMT+zNU1w==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/@types/istanbul-lib-report": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.3.tgz", + "integrity": "sha512-NQn7AHQnk/RSLOxrBbGyJM/aVQ+pjj5HCgasFxc0K/KhoATfQ/47AyUl15I2yBUpihjmas+a+VJBOqecrFH+uA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@types/istanbul-lib-coverage": "*" + } + }, + "node_modules/@types/istanbul-reports": { + "version": "3.0.4", + "resolved": "https://registry.npmjs.org/@types/istanbul-reports/-/istanbul-reports-3.0.4.tgz", + "integrity": "sha512-pk2B1NWalF9toCRu6gjBzR69syFjP4Od8WRAX+0mmf9lAjCRicLOWc+ZrxZHx/0XRjotgkF9t6iaMJ+aXcOdZQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@types/istanbul-lib-report": "*" + } + }, + "node_modules/@types/jsonwebtoken": { + "version": "9.0.7", + "resolved": "https://registry.npmjs.org/@types/jsonwebtoken/-/jsonwebtoken-9.0.7.tgz", + "integrity": "sha512-ugo316mmTYBl2g81zDFnZ7cfxlut3o+/EQdaP7J8QN2kY6lJ22hmQYCK5EHcJHbrW+dkCGSCPgbG8JtYj6qSrg==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/lodash": { + "version": "4.17.13", + "resolved": "https://registry.npmjs.org/@types/lodash/-/lodash-4.17.13.tgz", + "integrity": "sha512-lfx+dftrEZcdBPczf9d0Qv0x+j/rfNCMuC6OcfXmO8gkfeNAY88PgKUbvG56whcN23gc27yenwF6oJZXGFpYxg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/long": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/@types/long/-/long-4.0.2.tgz", + "integrity": "sha512-MqTGEo5bj5t157U6fA/BiDynNkn0YknVdh48CMPkTSpFTVmvao5UQmm7uEF6xBEo7qIMAlY/JSleYaE6VOdpaA==", + "license": "MIT", + "optional": true + }, + "node_modules/@types/mime": { + "version": "1.3.5", + "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.5.tgz", + "integrity": "sha512-/pyBZWSLD2n0dcHE3hq8s8ZvcETHtEuF+3E7XVt0Ig2nvsVQXdghHVcEkIWjy9A0wKfTn97a/PSDYohKIlnP/w==", + "license": "MIT" + }, + "node_modules/@types/node": { + "version": "22.10.1", + "resolved": "https://registry.npmjs.org/@types/node/-/node-22.10.1.tgz", + "integrity": "sha512-qKgsUwfHZV2WCWLAnVP1JqnpE6Im6h3Y0+fYgMTasNQ7V++CBX5OT1as0g0f+OyubbFqhf6XVNIsmN4IIhEgGQ==", + "license": "MIT", + "dependencies": { + "undici-types": "~6.20.0" + } + }, + "node_modules/@types/qs": { + "version": "6.9.17", + "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.17.tgz", + "integrity": "sha512-rX4/bPcfmvxHDv0XjfJELTTr+iB+tn032nPILqHm5wbthUUUuVtNGGqzhya9XUxjTP8Fpr0qYgSZZKxGY++svQ==", + "license": "MIT" + }, + "node_modules/@types/range-parser": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz", + "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==", + "license": "MIT" + }, + "node_modules/@types/request": { + "version": "2.48.12", + "resolved": "https://registry.npmjs.org/@types/request/-/request-2.48.12.tgz", + "integrity": "sha512-G3sY+NpsA9jnwm0ixhAFQSJ3Q9JkpLZpJbI3GMv0mIAT0y3mRabYeINzal5WOChIiaTEGQYlHOKgkaM9EisWHw==", + "license": "MIT", + "optional": true, + "dependencies": { + "@types/caseless": "*", + "@types/node": "*", + "@types/tough-cookie": "*", + "form-data": "^2.5.0" + } + }, + "node_modules/@types/send": { + "version": "0.17.4", + "resolved": "https://registry.npmjs.org/@types/send/-/send-0.17.4.tgz", + "integrity": "sha512-x2EM6TJOybec7c52BX0ZspPodMsQUd5L6PRwOunVyVUhXiBSKf3AezDL8Dgvgt5o0UfKNfuA0eMLr2wLT4AiBA==", + "license": "MIT", + "dependencies": { + "@types/mime": "^1", + "@types/node": "*" + } + }, + "node_modules/@types/serve-static": { + "version": "1.15.7", + "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.15.7.tgz", + "integrity": "sha512-W8Ym+h8nhuRwaKPaDw34QUkwsGi6Rc4yYqvKFo5rm2FUEhCFbzVWrxXUxuKK8TASjWsysJY0nsmNCGhCOIsrOw==", + "license": "MIT", + "dependencies": { + "@types/http-errors": "*", + "@types/node": "*", + "@types/send": "*" + } + }, + "node_modules/@types/stack-utils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/@types/stack-utils/-/stack-utils-2.0.3.tgz", + "integrity": "sha512-9aEbYZ3TbYMznPdcdr3SmIrLXwC/AKZXQeCf9Pgao5CKb8CyHuEX5jzWPTkvregvhRJHcpRO6BFoGW9ycaOkYw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/@types/tough-cookie": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/@types/tough-cookie/-/tough-cookie-4.0.5.tgz", + "integrity": "sha512-/Ad8+nIOV7Rl++6f1BdKxFSMgmoqEoYbHRpPcx3JEfv8VRsQe9Z4mCXeJBzxs7mbHY/XOZZuXlRNfhpVPbs6ZA==", + "license": "MIT", + "optional": true + }, + "node_modules/@types/yargs": { + "version": "17.0.33", + "resolved": "https://registry.npmjs.org/@types/yargs/-/yargs-17.0.33.tgz", + "integrity": "sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@types/yargs-parser": "*" + } + }, + "node_modules/@types/yargs-parser": { + "version": "21.0.3", + "resolved": "https://registry.npmjs.org/@types/yargs-parser/-/yargs-parser-21.0.3.tgz", + "integrity": "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/abort-controller": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/abort-controller/-/abort-controller-3.0.0.tgz", + "integrity": "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==", + "license": "MIT", + "optional": true, + "dependencies": { + "event-target-shim": "^5.0.0" + }, + "engines": { + "node": ">=6.5" + } + }, + "node_modules/accepts": { + "version": "1.3.8", + "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz", + "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==", + "license": "MIT", + "dependencies": { + "mime-types": "~2.1.34", + "negotiator": "0.6.3" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/agent-base": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.3.tgz", + "integrity": "sha512-jRR5wdylq8CkOe6hei19GGZnxM6rBGwFl3Bg0YItGDimvjGtAvdZk4Pu6Cl4u4Igsws4a1fd1Vq3ezrhn4KmFw==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">= 14" + } + }, + "node_modules/ansi-escapes": { + "version": "4.3.2", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz", + "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "type-fest": "^0.21.3" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/anymatch": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", + "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/argparse": { + "version": "1.0.10", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz", + "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "sprintf-js": "~1.0.2" + } + }, + "node_modules/array-flatten": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz", + "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==", + "license": "MIT" + }, + "node_modules/arrify": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/arrify/-/arrify-2.0.1.tgz", + "integrity": "sha512-3duEwti880xqi4eAMN8AyR4a0ByT90zoYdLlevfrvU43vb0YZwZVfxOgxWrLXXXpyugL0hNZc9G6BiB5B3nUug==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/async-retry": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/async-retry/-/async-retry-1.3.3.tgz", + "integrity": "sha512-wfr/jstw9xNi/0teMHrRW7dsz3Lt5ARhYNZ2ewpadnhaIp5mbALhOAP+EAdsC7t4Z6wqsDVv9+W6gm1Dk9mEyw==", + "license": "MIT", + "optional": true, + "dependencies": { + "retry": "0.13.1" + } + }, + "node_modules/asynckit": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "license": "MIT", + "optional": true + }, + "node_modules/babel-jest": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/babel-jest/-/babel-jest-29.7.0.tgz", + "integrity": "sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/transform": "^29.7.0", + "@types/babel__core": "^7.1.14", + "babel-plugin-istanbul": "^6.1.1", + "babel-preset-jest": "^29.6.3", + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "slash": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "@babel/core": "^7.8.0" + } + }, + "node_modules/babel-plugin-istanbul": { + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/babel-plugin-istanbul/-/babel-plugin-istanbul-6.1.1.tgz", + "integrity": "sha512-Y1IQok9821cC9onCx5otgFfRm7Lm+I+wwxOx738M/WLPZ9Q42m4IG5W0FNX8WLL2gYMZo3JkuXIH2DOpWM+qwA==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "@babel/helper-plugin-utils": "^7.0.0", + "@istanbuljs/load-nyc-config": "^1.0.0", + "@istanbuljs/schema": "^0.1.2", + "istanbul-lib-instrument": "^5.0.4", + "test-exclude": "^6.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-plugin-istanbul/node_modules/istanbul-lib-instrument": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-5.2.1.tgz", + "integrity": "sha512-pzqtp31nLv/XFOzXGuvhCb8qhjmTVo5vjVk19XE4CRlSWz0KoeJ3bw9XsA7nOp9YBf4qHjwBxkDzKcME/J29Yg==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "@babel/core": "^7.12.3", + "@babel/parser": "^7.14.7", + "@istanbuljs/schema": "^0.1.2", + "istanbul-lib-coverage": "^3.2.0", + "semver": "^6.3.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/babel-plugin-jest-hoist": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/babel-plugin-jest-hoist/-/babel-plugin-jest-hoist-29.6.3.tgz", + "integrity": "sha512-ESAc/RJvGTFEzRwOTT4+lNDk/GNHMkKbNzsvT0qKRfDyyYTskxB5rnU2njIDYVxXCBHHEI1c0YwHob3WaYujOg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/template": "^7.3.3", + "@babel/types": "^7.3.3", + "@types/babel__core": "^7.1.14", + "@types/babel__traverse": "^7.0.6" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/babel-preset-current-node-syntax": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/babel-preset-current-node-syntax/-/babel-preset-current-node-syntax-1.1.0.tgz", + "integrity": "sha512-ldYss8SbBlWva1bs28q78Ju5Zq1F+8BrqBZZ0VFhLBvhh6lCpC2o3gDJi/5DRLs9FgYZCnmPYIVFU4lRXCkyUw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/plugin-syntax-async-generators": "^7.8.4", + "@babel/plugin-syntax-bigint": "^7.8.3", + "@babel/plugin-syntax-class-properties": "^7.12.13", + "@babel/plugin-syntax-class-static-block": "^7.14.5", + "@babel/plugin-syntax-import-attributes": "^7.24.7", + "@babel/plugin-syntax-import-meta": "^7.10.4", + "@babel/plugin-syntax-json-strings": "^7.8.3", + "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4", + "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3", + "@babel/plugin-syntax-numeric-separator": "^7.10.4", + "@babel/plugin-syntax-object-rest-spread": "^7.8.3", + "@babel/plugin-syntax-optional-catch-binding": "^7.8.3", + "@babel/plugin-syntax-optional-chaining": "^7.8.3", + "@babel/plugin-syntax-private-property-in-object": "^7.14.5", + "@babel/plugin-syntax-top-level-await": "^7.14.5" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/babel-preset-jest": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/babel-preset-jest/-/babel-preset-jest-29.6.3.tgz", + "integrity": "sha512-0B3bhxR6snWXJZtR/RliHTDPRgn1sNHOR0yVtq/IiQFyuOVjFS+wuio/R4gSNkyYmKmJB4wGZv2NZanmKmTnNA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "babel-plugin-jest-hoist": "^29.6.3", + "babel-preset-current-node-syntax": "^1.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "@babel/core": "^7.0.0" + } + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "optional": true + }, + "node_modules/bignumber.js": { + "version": "9.1.2", + "resolved": "https://registry.npmjs.org/bignumber.js/-/bignumber.js-9.1.2.tgz", + "integrity": "sha512-2/mKyZH9K85bzOEfhXDBFZTGd1CTs+5IHpeFQo9luiBG7hghdC851Pj2WAhb6E3R6b9tZj/XKhbg4fum+Kepug==", + "license": "MIT", + "optional": true, + "engines": { + "node": "*" + } + }, + "node_modules/body-parser": { + "version": "1.20.3", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz", + "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==", + "license": "MIT", + "dependencies": { + "bytes": "3.1.2", + "content-type": "~1.0.5", + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "on-finished": "2.4.1", + "qs": "6.13.0", + "raw-body": "2.5.2", + "type-is": "~1.6.18", + "unpipe": "1.0.0" + }, + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/brace-expansion": { + "version": "1.1.11", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz", + "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/browserslist": { + "version": "4.24.2", + "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.24.2.tgz", + "integrity": "sha512-ZIc+Q62revdMcqC6aChtW4jz3My3klmCO1fEmINZY/8J3EpBg5/A/D0AKmBveUh6pgoeycoMkVMko84tuYS+Gg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "caniuse-lite": "^1.0.30001669", + "electron-to-chromium": "^1.5.41", + "node-releases": "^2.0.18", + "update-browserslist-db": "^1.1.1" + }, + "bin": { + "browserslist": "cli.js" + }, + "engines": { + "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7" + } + }, + "node_modules/bser": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/bser/-/bser-2.1.1.tgz", + "integrity": "sha512-gQxTNE/GAfIIrmHLUE3oJyp5FO6HRBfhjnw4/wMmA63ZGDJnWBmgY/lyQBpnDUkGmAhbSe39tx2d/iTOAfglwQ==", + "dev": true, + "license": "Apache-2.0", + "peer": true, + "dependencies": { + "node-int64": "^0.4.0" + } + }, + "node_modules/buffer-equal-constant-time": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz", + "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==", + "license": "BSD-3-Clause" + }, + "node_modules/buffer-from": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", + "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/bytes": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz", + "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/call-bind": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz", + "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.0", + "es-define-property": "^1.0.0", + "get-intrinsic": "^1.2.4", + "set-function-length": "^1.2.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.1.tgz", + "integrity": "sha512-BhYE+WDaywFg2TBWYNXAE+8B1ATnThNBqXHP5nQu0jWJdVvY2hvkpyB3qOmtmDePiS5/BDQ8wASEWGMWRG148g==", + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/camelcase": { + "version": "5.3.1", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz", + "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/caniuse-lite": { + "version": "1.0.30001687", + "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001687.tgz", + "integrity": "sha512-0S/FDhf4ZiqrTUiQ39dKeUjYRjkv7lOZU1Dgif2rIqrTzX/1wV2hfKu9TOm1IHkdSijfLswxTFzl/cvir+SLSQ==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/caniuse-lite" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "CC-BY-4.0", + "peer": true + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/char-regex": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/char-regex/-/char-regex-1.0.2.tgz", + "integrity": "sha512-kWWXztvZ5SBQV+eRgKFeh8q5sLuZY2+8WUIzlxWVTg+oGwY14qylx1KbKzHd8P6ZYkAg0xyIDU9JMHhyJMZ1jw==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=10" + } + }, + "node_modules/ci-info": { + "version": "3.9.0", + "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-3.9.0.tgz", + "integrity": "sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/sibiraj-s" + } + ], + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/cjs-module-lexer": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-1.4.1.tgz", + "integrity": "sha512-cuSVIHi9/9E/+821Qjdvngor+xpnlwnuwIyZOaLmHBVdXL+gP+I6QQB9VkO7RI77YIcTV+S1W9AreJ5eN63JBA==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/cliui": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz", + "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", + "devOptional": true, + "license": "ISC", + "dependencies": { + "string-width": "^4.2.0", + "strip-ansi": "^6.0.1", + "wrap-ansi": "^7.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/co": { + "version": "4.6.0", + "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz", + "integrity": "sha512-QVb0dM5HvG+uaxitm8wONl7jltx8dqhfU33DcqtOZcLSVIKSDDLDi7+0LbAKiyI8hD9u42m2YxXSkMGWThaecQ==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "iojs": ">= 1.0.0", + "node": ">= 0.12.0" + } + }, + "node_modules/collect-v8-coverage": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/collect-v8-coverage/-/collect-v8-coverage-1.0.2.tgz", + "integrity": "sha512-lHl4d5/ONEbLlJvaJNtsF/Lz+WvB07u2ycqTYbdrq7UypDXailES4valYb2eWiJFxZlVmpGekfqoxQhzyFdT4Q==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/combined-stream": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", + "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", + "license": "MIT", + "optional": true, + "dependencies": { + "delayed-stream": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/content-disposition": { + "version": "0.5.4", + "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz", + "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==", + "license": "MIT", + "dependencies": { + "safe-buffer": "5.2.1" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/content-type": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz", + "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/convert-source-map": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", + "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/cookie": { + "version": "0.7.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.1.tgz", + "integrity": "sha512-6DnInpx7SJ2AK3+CTUE/ZM0vWTUboZCegxhC2xiIydHR9jNuTAASBrfEpHhiGOZw/nX51bHt6YQl8jsGo4y/0w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/cookie-signature": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz", + "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==", + "license": "MIT" + }, + "node_modules/cors": { + "version": "2.8.5", + "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.5.tgz", + "integrity": "sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g==", + "license": "MIT", + "dependencies": { + "object-assign": "^4", + "vary": "^1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/create-jest": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/create-jest/-/create-jest-29.7.0.tgz", + "integrity": "sha512-Adz2bdH0Vq3F53KEMJOoftQFutWCukm6J24wbPWRO4k1kMY7gS7ds/uoJkNuV8wDCtWWnuwGcJwpWcih+zEW1Q==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/types": "^29.6.3", + "chalk": "^4.0.0", + "exit": "^0.1.2", + "graceful-fs": "^4.2.9", + "jest-config": "^29.7.0", + "jest-util": "^29.7.0", + "prompts": "^2.0.1" + }, + "bin": { + "create-jest": "bin/create-jest.js" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/debug": { + "version": "2.6.9", + "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz", + "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==", + "license": "MIT", + "dependencies": { + "ms": "2.0.0" + } + }, + "node_modules/dedent": { + "version": "1.5.3", + "resolved": "https://registry.npmjs.org/dedent/-/dedent-1.5.3.tgz", + "integrity": "sha512-NHQtfOOW68WD8lgypbLA5oT+Bt0xXJhiYvoR6SmmNXZfpzOGXwdKWmcwG8N7PwVVWV3eF/68nmD9BaJSsTBhyQ==", + "dev": true, + "license": "MIT", + "peer": true, + "peerDependencies": { + "babel-plugin-macros": "^3.1.0" + }, + "peerDependenciesMeta": { + "babel-plugin-macros": { + "optional": true + } + } + }, + "node_modules/deepmerge": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/deepmerge/-/deepmerge-4.3.1.tgz", + "integrity": "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/define-data-property": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz", + "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==", + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0", + "es-errors": "^1.3.0", + "gopd": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/delayed-stream": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", + "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/depd": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz", + "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/destroy": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz", + "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==", + "license": "MIT", + "engines": { + "node": ">= 0.8", + "npm": "1.2.8000 || >= 1.4.16" + } + }, + "node_modules/detect-newline": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/detect-newline/-/detect-newline-3.1.0.tgz", + "integrity": "sha512-TLz+x/vEXm/Y7P7wn1EJFNLxYpUD4TgMosxY6fAVJUnJMbupHBOncxyWUG9OpTaH9EBD7uFI5LfEgmMOc54DsA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/diff-sequences": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz", + "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.0.tgz", + "integrity": "sha512-9+Sj30DIu+4KvHqMfLUGLFYL2PkURSYMVXJyXe92nFRvlYq5hBjLEhblKB+vkd/WVlUYMWigiY07T91Fkk0+4A==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.0", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/duplexify": { + "version": "4.1.3", + "resolved": "https://registry.npmjs.org/duplexify/-/duplexify-4.1.3.tgz", + "integrity": "sha512-M3BmBhwJRZsSx38lZyhE53Csddgzl5R7xGJNk7CVddZD6CcmwMCH8J+7AprIrQKH7TonKxaCjcv27Qmf+sQ+oA==", + "license": "MIT", + "optional": true, + "dependencies": { + "end-of-stream": "^1.4.1", + "inherits": "^2.0.3", + "readable-stream": "^3.1.1", + "stream-shift": "^1.0.2" + } + }, + "node_modules/ecdsa-sig-formatter": { + "version": "1.0.11", + "resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz", + "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==", + "license": "Apache-2.0", + "dependencies": { + "safe-buffer": "^5.0.1" + } + }, + "node_modules/ee-first": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz", + "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==", + "license": "MIT" + }, + "node_modules/electron-to-chromium": { + "version": "1.5.72", + "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.72.tgz", + "integrity": "sha512-ZpSAUOZ2Izby7qnZluSrAlGgGQzucmFbN0n64dYzocYxnxV5ufurpj3VgEe4cUp7ir9LmeLxNYo8bVnlM8bQHw==", + "dev": true, + "license": "ISC", + "peer": true + }, + "node_modules/emittery": { + "version": "0.13.1", + "resolved": "https://registry.npmjs.org/emittery/-/emittery-0.13.1.tgz", + "integrity": "sha512-DeWwawk6r5yR9jFgnDKYt4sLS0LmHJJi3ZOnb5/JdbYwj3nW+FxQnHIjhBKz8YLC7oRNPVM9NQ47I3CVx34eqQ==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sindresorhus/emittery?sponsor=1" + } + }, + "node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "devOptional": true, + "license": "MIT" + }, + "node_modules/encodeurl": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz", + "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/end-of-stream": { + "version": "1.4.4", + "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.4.tgz", + "integrity": "sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q==", + "license": "MIT", + "optional": true, + "dependencies": { + "once": "^1.4.0" + } + }, + "node_modules/error-ex": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz", + "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "is-arrayish": "^0.2.1" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/escape-html": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", + "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==", + "license": "MIT" + }, + "node_modules/escape-string-regexp": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-2.0.0.tgz", + "integrity": "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/esprima": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", + "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", + "dev": true, + "license": "BSD-2-Clause", + "peer": true, + "bin": { + "esparse": "bin/esparse.js", + "esvalidate": "bin/esvalidate.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/etag": { + "version": "1.8.1", + "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", + "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/event-target-shim": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/event-target-shim/-/event-target-shim-5.0.1.tgz", + "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/execa": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz", + "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "cross-spawn": "^7.0.3", + "get-stream": "^6.0.0", + "human-signals": "^2.1.0", + "is-stream": "^2.0.0", + "merge-stream": "^2.0.0", + "npm-run-path": "^4.0.1", + "onetime": "^5.1.2", + "signal-exit": "^3.0.3", + "strip-final-newline": "^2.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sindresorhus/execa?sponsor=1" + } + }, + "node_modules/exit": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz", + "integrity": "sha512-Zk/eNKV2zbjpKzrsQ+n1G6poVbErQxJ0LBOJXaKZ1EViLzH+hrLu9cdXI4zw9dBQJslwBEpbQ2P1oS7nDxs6jQ==", + "dev": true, + "peer": true, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/expect": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/expect/-/expect-29.7.0.tgz", + "integrity": "sha512-2Zks0hf1VLFYI1kbh0I5jP3KHHyCHpkfyHBzsSXRFgl/Bg9mWYfMW8oD+PdMPlEwy5HNsR9JutYy6pMeOh61nw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/expect-utils": "^29.7.0", + "jest-get-type": "^29.6.3", + "jest-matcher-utils": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-util": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/express": { + "version": "4.21.2", + "resolved": "https://registry.npmjs.org/express/-/express-4.21.2.tgz", + "integrity": "sha512-28HqgMZAmih1Czt9ny7qr6ek2qddF4FclbMzwhCREB6OFfH+rXAnuNCwo1/wFvrtbgsQDb4kSbX9de9lFbrXnA==", + "license": "MIT", + "dependencies": { + "accepts": "~1.3.8", + "array-flatten": "1.1.1", + "body-parser": "1.20.3", + "content-disposition": "0.5.4", + "content-type": "~1.0.4", + "cookie": "0.7.1", + "cookie-signature": "1.0.6", + "debug": "2.6.9", + "depd": "2.0.0", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "finalhandler": "1.3.1", + "fresh": "0.5.2", + "http-errors": "2.0.0", + "merge-descriptors": "1.0.3", + "methods": "~1.1.2", + "on-finished": "2.4.1", + "parseurl": "~1.3.3", + "path-to-regexp": "0.1.12", + "proxy-addr": "~2.0.7", + "qs": "6.13.0", + "range-parser": "~1.2.1", + "safe-buffer": "5.2.1", + "send": "0.19.0", + "serve-static": "1.16.2", + "setprototypeof": "1.2.0", + "statuses": "2.0.1", + "type-is": "~1.6.18", + "utils-merge": "1.0.1", + "vary": "~1.1.2" + }, + "engines": { + "node": ">= 0.10.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/extend": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", + "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==", + "license": "MIT", + "optional": true + }, + "node_modules/farmhash-modern": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/farmhash-modern/-/farmhash-modern-1.1.0.tgz", + "integrity": "sha512-6ypT4XfgqJk/F3Yuv4SX26I3doUjt0GTG4a+JgWxXQpxXzTBq8fPUeGHfcYMMDPHJHm3yPOSjaeBwBGAHWXCdA==", + "license": "MIT", + "engines": { + "node": ">=18.0.0" + } + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "license": "MIT", + "optional": true + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/fast-xml-parser": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-4.5.0.tgz", + "integrity": "sha512-/PlTQCI96+fZMAOLMZK4CWG1ItCbfZ/0jx7UIJFChPNrx7tcEgerUgWbeieCM9MfHInUDyK8DWYZ+YrywDJuTg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + }, + { + "type": "paypal", + "url": "https://paypal.me/naturalintelligence" + } + ], + "license": "MIT", + "optional": true, + "dependencies": { + "strnum": "^1.0.5" + }, + "bin": { + "fxparser": "src/cli/cli.js" + } + }, + "node_modules/faye-websocket": { + "version": "0.11.4", + "resolved": "https://registry.npmjs.org/faye-websocket/-/faye-websocket-0.11.4.tgz", + "integrity": "sha512-CzbClwlXAuiRQAlUyfqPgvPoNKTckTPGfwZV4ZdAhVcP2lh9KUxJg2b5GkE7XbjKQ3YJnQ9z6D9ntLAlB+tP8g==", + "license": "Apache-2.0", + "dependencies": { + "websocket-driver": ">=0.5.1" + }, + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/fb-watchman": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/fb-watchman/-/fb-watchman-2.0.2.tgz", + "integrity": "sha512-p5161BqbuCaSnB8jIbzQHOlpgsPmK5rJVDfDKO91Axs5NC1uu3HRQm6wt9cd9/+GtQQIO53JdGXXoyDpTAsgYA==", + "dev": true, + "license": "Apache-2.0", + "peer": true, + "dependencies": { + "bser": "2.1.1" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/finalhandler": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz", + "integrity": "sha512-6BN9trH7bp3qvnrRyzsBz+g3lZxTNZTbVO2EV1CS0WIcDbawYVdYvGflME/9QP0h0pYlCDBCTjYa9nZzMDpyxQ==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "on-finished": "2.4.1", + "parseurl": "~1.3.3", + "statuses": "2.0.1", + "unpipe": "~1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/find-up": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz", + "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "locate-path": "^5.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/firebase-admin": { + "version": "12.7.0", + "resolved": "https://registry.npmjs.org/firebase-admin/-/firebase-admin-12.7.0.tgz", + "integrity": "sha512-raFIrOyTqREbyXsNkSHyciQLfv8AUZazehPaQS1lZBSCDYW74FYXU0nQZa3qHI4K+hawohlDbywZ4+qce9YNxA==", + "license": "Apache-2.0", + "dependencies": { + "@fastify/busboy": "^3.0.0", + "@firebase/database-compat": "1.0.8", + "@firebase/database-types": "1.0.5", + "@types/node": "^22.0.1", + "farmhash-modern": "^1.1.0", + "jsonwebtoken": "^9.0.0", + "jwks-rsa": "^3.1.0", + "node-forge": "^1.3.1", + "uuid": "^10.0.0" + }, + "engines": { + "node": ">=14" + }, + "optionalDependencies": { + "@google-cloud/firestore": "^7.7.0", + "@google-cloud/storage": "^7.7.0" + } + }, + "node_modules/firebase-functions": { + "version": "6.1.2", + "resolved": "https://registry.npmjs.org/firebase-functions/-/firebase-functions-6.1.2.tgz", + "integrity": "sha512-1ZKLLOs4YhpzfWOZo0wsqNBusy9113GUfRs89BF6yOlmkxlcJxdJzZEs/ygWeXVJKquZhW2K1Gm10Gir4RJxGQ==", + "license": "MIT", + "dependencies": { + "@types/cors": "^2.8.5", + "@types/express": "^4.17.21", + "cors": "^2.8.5", + "express": "^4.21.0", + "protobufjs": "^7.2.2" + }, + "bin": { + "firebase-functions": "lib/bin/firebase-functions.js" + }, + "engines": { + "node": ">=14.10.0" + }, + "peerDependencies": { + "firebase-admin": "^11.10.0 || ^12.0.0 || ^13.0.0" + } + }, + "node_modules/firebase-functions-test": { + "version": "3.3.0", + "resolved": "https://registry.npmjs.org/firebase-functions-test/-/firebase-functions-test-3.3.0.tgz", + "integrity": "sha512-X+OOA34MGrsTimFXTDnWT0psAqnmBkJ85bGCoLMwjgei5Prfkqh3bv5QASnXC/cmIVBSF2Qw9uW1+mF/t3kFlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/lodash": "^4.14.104", + "lodash": "^4.17.5", + "ts-deepmerge": "^2.0.1" + }, + "engines": { + "node": ">=14.0.0" + }, + "peerDependencies": { + "firebase-admin": "^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0 || ^12.0.0", + "firebase-functions": ">=4.9.0", + "jest": ">=28.0.0" + } + }, + "node_modules/form-data": { + "version": "2.5.2", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.5.2.tgz", + "integrity": "sha512-GgwY0PS7DbXqajuGf4OYlsrIu3zgxD6Vvql43IBhm6MahqA5SK/7mwhtNj2AdH2z35YR34ujJ7BN+3fFC3jP5Q==", + "license": "MIT", + "optional": true, + "dependencies": { + "asynckit": "^0.4.0", + "combined-stream": "^1.0.6", + "mime-types": "^2.1.12", + "safe-buffer": "^5.2.1" + }, + "engines": { + "node": ">= 0.12" + } + }, + "node_modules/forwarded": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz", + "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fresh": { + "version": "0.5.2", + "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz", + "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/fs.realpath": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", + "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", + "dev": true, + "license": "ISC", + "peer": true + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "peer": true, + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/functional-red-black-tree": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/functional-red-black-tree/-/functional-red-black-tree-1.0.1.tgz", + "integrity": "sha512-dsKNQNdj6xA3T+QlADDA7mOSlX0qiMINjn0cgr+eGHGsbSHzTabcIogz2+p/iqP1Xs6EP/sS2SbqH+brGTbq0g==", + "license": "MIT", + "optional": true + }, + "node_modules/gaxios": { + "version": "6.7.1", + "resolved": "https://registry.npmjs.org/gaxios/-/gaxios-6.7.1.tgz", + "integrity": "sha512-LDODD4TMYx7XXdpwxAVRAIAuB0bzv0s+ywFonY46k126qzQHT9ygyoa9tncmOiQmmDrik65UYsEkv3lbfqQ3yQ==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "extend": "^3.0.2", + "https-proxy-agent": "^7.0.1", + "is-stream": "^2.0.0", + "node-fetch": "^2.6.9", + "uuid": "^9.0.1" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/gaxios/node_modules/uuid": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-9.0.1.tgz", + "integrity": "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==", + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], + "license": "MIT", + "optional": true, + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/gcp-metadata": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/gcp-metadata/-/gcp-metadata-6.1.0.tgz", + "integrity": "sha512-Jh/AIwwgaxan+7ZUUmRLCjtchyDiqh4KjBJ5tW3plBZb5iL/BPcso8A5DlzeD9qlw0duCamnNdpFjxwaT0KyKg==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "gaxios": "^6.0.0", + "json-bigint": "^1.0.0" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/gensync": { + "version": "1.0.0-beta.2", + "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz", + "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "devOptional": true, + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "node_modules/get-intrinsic": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.5.tgz", + "integrity": "sha512-Y4+pKa7XeRUPWFNvOOYHkRYrfzW07oraURSvjDmRVOJ748OrVmeXtpE4+GCEHncjCjkTxPNRt8kEbxDhsn6VTg==", + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.0", + "dunder-proto": "^1.0.0", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "function-bind": "^1.1.2", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-package-type": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/get-package-type/-/get-package-type-0.1.0.tgz", + "integrity": "sha512-pjzuKtY64GYfWizNAJ0fr9VqttZkNiK2iS430LtIHzjBEr6bX8Am2zm4sW4Ro5wjWW5cAlRL1qAMTcXbjNAO2Q==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/get-stream": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz", + "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Glob versions prior to v9 are no longer supported", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/globals": { + "version": "11.12.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz", + "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=4" + } + }, + "node_modules/google-auth-library": { + "version": "9.15.0", + "resolved": "https://registry.npmjs.org/google-auth-library/-/google-auth-library-9.15.0.tgz", + "integrity": "sha512-7ccSEJFDFO7exFbO6NRyC+xH8/mZ1GZGG2xxx9iHxZWcjUjJpjWxIMw3cofAKcueZ6DATiukmmprD7yavQHOyQ==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "base64-js": "^1.3.0", + "ecdsa-sig-formatter": "^1.0.11", + "gaxios": "^6.1.1", + "gcp-metadata": "^6.1.0", + "gtoken": "^7.0.0", + "jws": "^4.0.0" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/google-gax": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/google-gax/-/google-gax-4.4.1.tgz", + "integrity": "sha512-Phyp9fMfA00J3sZbJxbbB4jC55b7DBjE3F6poyL3wKMEBVKA79q6BGuHcTiM28yOzVql0NDbRL8MLLh8Iwk9Dg==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@grpc/grpc-js": "^1.10.9", + "@grpc/proto-loader": "^0.7.13", + "@types/long": "^4.0.0", + "abort-controller": "^3.0.0", + "duplexify": "^4.0.0", + "google-auth-library": "^9.3.0", + "node-fetch": "^2.7.0", + "object-hash": "^3.0.0", + "proto3-json-serializer": "^2.0.2", + "protobufjs": "^7.3.2", + "retry-request": "^7.0.0", + "uuid": "^9.0.1" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/google-gax/node_modules/uuid": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-9.0.1.tgz", + "integrity": "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==", + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], + "license": "MIT", + "optional": true, + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "dev": true, + "license": "ISC", + "peer": true + }, + "node_modules/gtoken": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/gtoken/-/gtoken-7.1.0.tgz", + "integrity": "sha512-pCcEwRi+TKpMlxAQObHDQ56KawURgyAf6jtIY046fJ5tIv3zDe/LEIubckAO8fj6JnAxLdmWkUfNyulQ2iKdEw==", + "license": "MIT", + "optional": true, + "dependencies": { + "gaxios": "^6.0.0", + "jws": "^4.0.0" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/has-property-descriptors": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz", + "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==", + "license": "MIT", + "dependencies": { + "es-define-property": "^1.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", + "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/html-entities": { + "version": "2.5.2", + "resolved": "https://registry.npmjs.org/html-entities/-/html-entities-2.5.2.tgz", + "integrity": "sha512-K//PSRMQk4FZ78Kyau+mZurHn3FH0Vwr+H36eE0rPbeYkRRi9YxceYPhuN60UwWorxyKHhqoAJl2OFKa4BVtaA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/mdevils" + }, + { + "type": "patreon", + "url": "https://patreon.com/mdevils" + } + ], + "license": "MIT", + "optional": true + }, + "node_modules/html-escaper": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz", + "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/http-errors": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz", + "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==", + "license": "MIT", + "dependencies": { + "depd": "2.0.0", + "inherits": "2.0.4", + "setprototypeof": "1.2.0", + "statuses": "2.0.1", + "toidentifier": "1.0.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/http-parser-js": { + "version": "0.5.8", + "resolved": "https://registry.npmjs.org/http-parser-js/-/http-parser-js-0.5.8.tgz", + "integrity": "sha512-SGeBX54F94Wgu5RH3X5jsDtf4eHyRogWX1XGT3b4HuW3tQPM4AaBzoUji/4AAJNXCEOWZ5O0DgZmJw1947gD5Q==", + "license": "MIT" + }, + "node_modules/http-proxy-agent": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-5.0.0.tgz", + "integrity": "sha512-n2hY8YdoRE1i7r6M0w9DIw5GgZN0G25P8zLCRQ8rjXtTU3vsNFBI/vWK/UIeE6g5MUUz6avwAPXmL6Fy9D/90w==", + "license": "MIT", + "optional": true, + "dependencies": { + "@tootallnate/once": "2", + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/http-proxy-agent/node_modules/agent-base": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz", + "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "debug": "4" + }, + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/http-proxy-agent/node_modules/debug": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "license": "MIT", + "optional": true, + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/http-proxy-agent/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT", + "optional": true + }, + "node_modules/https-proxy-agent": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", + "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", + "license": "MIT", + "optional": true, + "dependencies": { + "agent-base": "^7.1.2", + "debug": "4" + }, + "engines": { + "node": ">= 14" + } + }, + "node_modules/https-proxy-agent/node_modules/debug": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "license": "MIT", + "optional": true, + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/https-proxy-agent/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT", + "optional": true + }, + "node_modules/human-signals": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz", + "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==", + "dev": true, + "license": "Apache-2.0", + "peer": true, + "engines": { + "node": ">=10.17.0" + } + }, + "node_modules/iconv-lite": { + "version": "0.4.24", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", + "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==", + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/import-local": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz", + "integrity": "sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "pkg-dir": "^4.2.0", + "resolve-cwd": "^3.0.0" + }, + "bin": { + "import-local-fixture": "fixtures/cli.js" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/inflight": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", + "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", + "deprecated": "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.", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "once": "^1.3.0", + "wrappy": "1" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC" + }, + "node_modules/ipaddr.js": { + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz", + "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==", + "license": "MIT", + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/is-arrayish": { + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz", + "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/is-core-module": { + "version": "2.15.1", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.15.1.tgz", + "integrity": "sha512-z0vtXSwucUJtANQWldhbtbt7BnL0vxiFjIdDLAatwhDYty2bad6s+rijD6Ri4YuYJubLzIJLUidCh09e1djEVQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "hasown": "^2.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/is-generator-fn": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/is-generator-fn/-/is-generator-fn-2.1.0.tgz", + "integrity": "sha512-cTIB4yPYL/Grw0EaSzASzg6bBy9gqCofvWN8okThAYIxKJZC+udlRAmGbM0XLeniEJSs8uEgHPGuHSe1XsOLSQ==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-stream": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz", + "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC", + "peer": true + }, + "node_modules/istanbul-lib-coverage": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/istanbul-lib-coverage/-/istanbul-lib-coverage-3.2.2.tgz", + "integrity": "sha512-O8dpsF+r0WV/8MNRKfnmrtCWhuKjxrq2w+jpzBL5UZKTi2LeVWnWOmWRxFlesJONmc+wLAGvKQZEOanko0LFTg==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/istanbul-lib-instrument": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/istanbul-lib-instrument/-/istanbul-lib-instrument-6.0.3.tgz", + "integrity": "sha512-Vtgk7L/R2JHyyGW07spoFlB8/lpjiOLTjMdms6AFMraYt3BaJauod/NGrfnVG/y4Ix1JEuMRPDPEj2ua+zz1/Q==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "@babel/core": "^7.23.9", + "@babel/parser": "^7.23.9", + "@istanbuljs/schema": "^0.1.3", + "istanbul-lib-coverage": "^3.2.0", + "semver": "^7.5.4" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-lib-instrument/node_modules/semver": { + "version": "7.6.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", + "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "dev": true, + "license": "ISC", + "peer": true, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-lib-report": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz", + "integrity": "sha512-GCfE1mtsHGOELCU8e/Z7YWzpmybrx/+dSTfLrvY8qRmaY6zXTKWn6WQIjaAFw069icm6GVMNkgu0NzI4iPZUNw==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "istanbul-lib-coverage": "^3.0.0", + "make-dir": "^4.0.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-lib-source-maps": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/istanbul-lib-source-maps/-/istanbul-lib-source-maps-4.0.1.tgz", + "integrity": "sha512-n3s8EwkdFIJCG3BPKBYvskgXGoy88ARzvegkitk60NxRdwltLOTaH7CUiMRXvwYorl0Q712iEjcWB+fK/MrWVw==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "debug": "^4.1.1", + "istanbul-lib-coverage": "^3.0.0", + "source-map": "^0.6.1" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/istanbul-lib-source-maps/node_modules/debug": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/istanbul-lib-source-maps/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/istanbul-reports": { + "version": "3.1.7", + "resolved": "https://registry.npmjs.org/istanbul-reports/-/istanbul-reports-3.1.7.tgz", + "integrity": "sha512-BewmUXImeuRk2YY0PVbxgKAysvhRPUQE0h5QRM++nVWyubKGV0l8qQ5op8+B2DOmwSe63Jivj0BjkPQVf8fP5g==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "html-escaper": "^2.0.0", + "istanbul-lib-report": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/jest": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest/-/jest-29.7.0.tgz", + "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/core": "^29.7.0", + "@jest/types": "^29.6.3", + "import-local": "^3.0.2", + "jest-cli": "^29.7.0" + }, + "bin": { + "jest": "bin/jest.js" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/jest-changed-files": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-changed-files/-/jest-changed-files-29.7.0.tgz", + "integrity": "sha512-fEArFiwf1BpQ+4bXSprcDc3/x4HSzL4al2tozwVpDFpsxALjLYdyiIK4e5Vz66GQJIbXJ82+35PtysofptNX2w==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "execa": "^5.0.0", + "jest-util": "^29.7.0", + "p-limit": "^3.1.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-circus": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-circus/-/jest-circus-29.7.0.tgz", + "integrity": "sha512-3E1nCMgipcTkCocFwM90XXQab9bS+GMsjdpmPrlelaxwD93Ad8iVEjX/vvHPdLPnFf+L40u+5+iutRdA1N9myw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/environment": "^29.7.0", + "@jest/expect": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "co": "^4.6.0", + "dedent": "^1.0.0", + "is-generator-fn": "^2.0.0", + "jest-each": "^29.7.0", + "jest-matcher-utils": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-runtime": "^29.7.0", + "jest-snapshot": "^29.7.0", + "jest-util": "^29.7.0", + "p-limit": "^3.1.0", + "pretty-format": "^29.7.0", + "pure-rand": "^6.0.0", + "slash": "^3.0.0", + "stack-utils": "^2.0.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-cli": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-cli/-/jest-cli-29.7.0.tgz", + "integrity": "sha512-OVVobw2IubN/GSYsxETi+gOe7Ka59EFMR/twOU3Jb2GnKKeMGJB5SGUUrEz3SFVmJASUdZUzy83sLNNQ2gZslg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/core": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/types": "^29.6.3", + "chalk": "^4.0.0", + "create-jest": "^29.7.0", + "exit": "^0.1.2", + "import-local": "^3.0.2", + "jest-config": "^29.7.0", + "jest-util": "^29.7.0", + "jest-validate": "^29.7.0", + "yargs": "^17.3.1" + }, + "bin": { + "jest": "bin/jest.js" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "node-notifier": "^8.0.1 || ^9.0.0 || ^10.0.0" + }, + "peerDependenciesMeta": { + "node-notifier": { + "optional": true + } + } + }, + "node_modules/jest-config": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-config/-/jest-config-29.7.0.tgz", + "integrity": "sha512-uXbpfeQ7R6TZBqI3/TxCU4q4ttk3u0PJeC+E0zbfSoSjq6bJ7buBPxzQPL0ifrkY4DNu4JUdk0ImlBUYi840eQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/core": "^7.11.6", + "@jest/test-sequencer": "^29.7.0", + "@jest/types": "^29.6.3", + "babel-jest": "^29.7.0", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "deepmerge": "^4.2.2", + "glob": "^7.1.3", + "graceful-fs": "^4.2.9", + "jest-circus": "^29.7.0", + "jest-environment-node": "^29.7.0", + "jest-get-type": "^29.6.3", + "jest-regex-util": "^29.6.3", + "jest-resolve": "^29.7.0", + "jest-runner": "^29.7.0", + "jest-util": "^29.7.0", + "jest-validate": "^29.7.0", + "micromatch": "^4.0.4", + "parse-json": "^5.2.0", + "pretty-format": "^29.7.0", + "slash": "^3.0.0", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "peerDependencies": { + "@types/node": "*", + "ts-node": ">=9.0.0" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "ts-node": { + "optional": true + } + } + }, + "node_modules/jest-diff": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz", + "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "chalk": "^4.0.0", + "diff-sequences": "^29.6.3", + "jest-get-type": "^29.6.3", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-docblock": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-docblock/-/jest-docblock-29.7.0.tgz", + "integrity": "sha512-q617Auw3A612guyaFgsbFeYpNP5t2aoUNLwBUbc/0kD1R4t9ixDbyFTHd1nok4epoVFpr7PmeWHrhvuV3XaJ4g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "detect-newline": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-each": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-each/-/jest-each-29.7.0.tgz", + "integrity": "sha512-gns+Er14+ZrEoC5fhOfYCY1LOHHr0TI+rQUHZS8Ttw2l7gl+80eHc/gFf2Ktkw0+SIACDTeWvpFcv3B04VembQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/types": "^29.6.3", + "chalk": "^4.0.0", + "jest-get-type": "^29.6.3", + "jest-util": "^29.7.0", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-environment-node": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-environment-node/-/jest-environment-node-29.7.0.tgz", + "integrity": "sha512-DOSwCRqXirTOyheM+4d5YZOrWcdu0LNZ87ewUoywbcb2XR4wKgqiG8vNeYwhjFMbEkfju7wx2GYH0P2gevGvFw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/environment": "^29.7.0", + "@jest/fake-timers": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "jest-mock": "^29.7.0", + "jest-util": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-get-type": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz", + "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-haste-map": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-haste-map/-/jest-haste-map-29.7.0.tgz", + "integrity": "sha512-fP8u2pyfqx0K1rGn1R9pyE0/KTn+G7PxktWidOBTqFPLYX0b9ksaMFkhK5vrS3DVun09pckLdlx90QthlW7AmA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/types": "^29.6.3", + "@types/graceful-fs": "^4.1.3", + "@types/node": "*", + "anymatch": "^3.0.3", + "fb-watchman": "^2.0.0", + "graceful-fs": "^4.2.9", + "jest-regex-util": "^29.6.3", + "jest-util": "^29.7.0", + "jest-worker": "^29.7.0", + "micromatch": "^4.0.4", + "walker": "^1.0.8" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + }, + "optionalDependencies": { + "fsevents": "^2.3.2" + } + }, + "node_modules/jest-leak-detector": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-leak-detector/-/jest-leak-detector-29.7.0.tgz", + "integrity": "sha512-kYA8IJcSYtST2BY9I+SMC32nDpBT3J2NvWJx8+JCuCdl/CR1I4EKUJROiP8XtCcxqgTTBGJNdbB1A8XRKbTetw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "jest-get-type": "^29.6.3", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-matcher-utils": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz", + "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "chalk": "^4.0.0", + "jest-diff": "^29.7.0", + "jest-get-type": "^29.6.3", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-message-util": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-message-util/-/jest-message-util-29.7.0.tgz", + "integrity": "sha512-GBEV4GRADeP+qtB2+6u61stea8mGcOT4mCtrYISZwfu9/ISHFJ/5zOMXYbpBE9RsS5+Gb63DW4FgmnKJ79Kf6w==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/code-frame": "^7.12.13", + "@jest/types": "^29.6.3", + "@types/stack-utils": "^2.0.0", + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "micromatch": "^4.0.4", + "pretty-format": "^29.7.0", + "slash": "^3.0.0", + "stack-utils": "^2.0.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-mock": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-mock/-/jest-mock-29.7.0.tgz", + "integrity": "sha512-ITOMZn+UkYS4ZFh83xYAOzWStloNzJFO2s8DWrE4lhtGD+AorgnbkiKERe4wQVBydIGPx059g6riW5Btp6Llnw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/types": "^29.6.3", + "@types/node": "*", + "jest-util": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-pnp-resolver": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/jest-pnp-resolver/-/jest-pnp-resolver-1.2.3.tgz", + "integrity": "sha512-+3NpwQEnRoIBtx4fyhblQDPgJI0H1IEIkX7ShLUjPGA7TtUTvI1oiKi3SR4oBR0hQhQR80l4WAe5RrXBwWMA8w==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + }, + "peerDependencies": { + "jest-resolve": "*" + }, + "peerDependenciesMeta": { + "jest-resolve": { + "optional": true + } + } + }, + "node_modules/jest-regex-util": { + "version": "29.6.3", + "resolved": "https://registry.npmjs.org/jest-regex-util/-/jest-regex-util-29.6.3.tgz", + "integrity": "sha512-KJJBsRCyyLNWCNBOvZyRDnAIfUiRJ8v+hOBQYGn8gDyF3UegwiP4gwRR3/SDa42g1YbVycTidUF3rKjyLFDWbg==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-resolve": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-resolve/-/jest-resolve-29.7.0.tgz", + "integrity": "sha512-IOVhZSrg+UvVAshDSDtHyFCCBUl/Q3AAJv8iZ6ZjnZ74xzvwuzLXid9IIIPgTnY62SJjfuupMKZsZQRsCvxEgA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "chalk": "^4.0.0", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^29.7.0", + "jest-pnp-resolver": "^1.2.2", + "jest-util": "^29.7.0", + "jest-validate": "^29.7.0", + "resolve": "^1.20.0", + "resolve.exports": "^2.0.0", + "slash": "^3.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-resolve-dependencies": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-resolve-dependencies/-/jest-resolve-dependencies-29.7.0.tgz", + "integrity": "sha512-un0zD/6qxJ+S0et7WxeI3H5XSe9lTBBR7bOHCHXkKR6luG5mwDDlIzVQ0V5cZCuoTgEdcdwzTghYkTWfubi+nA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "jest-regex-util": "^29.6.3", + "jest-snapshot": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-runner": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-runner/-/jest-runner-29.7.0.tgz", + "integrity": "sha512-fsc4N6cPCAahybGBfTRcq5wFR6fpLznMg47sY5aDpsoejOcVYFb07AHuSnR0liMcPTgBsA3ZJL6kFOjPdoNipQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/console": "^29.7.0", + "@jest/environment": "^29.7.0", + "@jest/test-result": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "emittery": "^0.13.1", + "graceful-fs": "^4.2.9", + "jest-docblock": "^29.7.0", + "jest-environment-node": "^29.7.0", + "jest-haste-map": "^29.7.0", + "jest-leak-detector": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-resolve": "^29.7.0", + "jest-runtime": "^29.7.0", + "jest-util": "^29.7.0", + "jest-watcher": "^29.7.0", + "jest-worker": "^29.7.0", + "p-limit": "^3.1.0", + "source-map-support": "0.5.13" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-runtime": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-runtime/-/jest-runtime-29.7.0.tgz", + "integrity": "sha512-gUnLjgwdGqW7B4LvOIkbKs9WGbn+QLqRQQ9juC6HndeDiezIwhDP+mhMwHWCEcfQ5RUXa6OPnFF8BJh5xegwwQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/environment": "^29.7.0", + "@jest/fake-timers": "^29.7.0", + "@jest/globals": "^29.7.0", + "@jest/source-map": "^29.6.3", + "@jest/test-result": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "cjs-module-lexer": "^1.0.0", + "collect-v8-coverage": "^1.0.0", + "glob": "^7.1.3", + "graceful-fs": "^4.2.9", + "jest-haste-map": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-mock": "^29.7.0", + "jest-regex-util": "^29.6.3", + "jest-resolve": "^29.7.0", + "jest-snapshot": "^29.7.0", + "jest-util": "^29.7.0", + "slash": "^3.0.0", + "strip-bom": "^4.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-snapshot": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-snapshot/-/jest-snapshot-29.7.0.tgz", + "integrity": "sha512-Rm0BMWtxBcioHr1/OX5YCP8Uov4riHvKPknOGs804Zg9JGZgmIBkbtlxJC/7Z4msKYVbIJtfU+tKb8xlYNfdkw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/core": "^7.11.6", + "@babel/generator": "^7.7.2", + "@babel/plugin-syntax-jsx": "^7.7.2", + "@babel/plugin-syntax-typescript": "^7.7.2", + "@babel/types": "^7.3.3", + "@jest/expect-utils": "^29.7.0", + "@jest/transform": "^29.7.0", + "@jest/types": "^29.6.3", + "babel-preset-current-node-syntax": "^1.0.0", + "chalk": "^4.0.0", + "expect": "^29.7.0", + "graceful-fs": "^4.2.9", + "jest-diff": "^29.7.0", + "jest-get-type": "^29.6.3", + "jest-matcher-utils": "^29.7.0", + "jest-message-util": "^29.7.0", + "jest-util": "^29.7.0", + "natural-compare": "^1.4.0", + "pretty-format": "^29.7.0", + "semver": "^7.5.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-snapshot/node_modules/semver": { + "version": "7.6.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", + "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "dev": true, + "license": "ISC", + "peer": true, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/jest-util": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-util/-/jest-util-29.7.0.tgz", + "integrity": "sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/types": "^29.6.3", + "@types/node": "*", + "chalk": "^4.0.0", + "ci-info": "^3.2.0", + "graceful-fs": "^4.2.9", + "picomatch": "^2.2.3" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-validate": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-validate/-/jest-validate-29.7.0.tgz", + "integrity": "sha512-ZB7wHqaRGVw/9hST/OuFUReG7M8vKeq0/J2egIGLdvjHCmYqGARhzXmtgi+gVeZ5uXFF219aOc3Ls2yLg27tkw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/types": "^29.6.3", + "camelcase": "^6.2.0", + "chalk": "^4.0.0", + "jest-get-type": "^29.6.3", + "leven": "^3.1.0", + "pretty-format": "^29.7.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-validate/node_modules/camelcase": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz", + "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/jest-watcher": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-watcher/-/jest-watcher-29.7.0.tgz", + "integrity": "sha512-49Fg7WXkU3Vl2h6LbLtMQ/HyB6rXSIX7SqvBLQmssRBGN9I0PNvPmAmCWSOY6SOvrjhI/F7/bGAv9RtnsPA03g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/test-result": "^29.7.0", + "@jest/types": "^29.6.3", + "@types/node": "*", + "ansi-escapes": "^4.2.1", + "chalk": "^4.0.0", + "emittery": "^0.13.1", + "jest-util": "^29.7.0", + "string-length": "^4.0.1" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-worker": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-29.7.0.tgz", + "integrity": "sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@types/node": "*", + "jest-util": "^29.7.0", + "merge-stream": "^2.0.0", + "supports-color": "^8.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/jest-worker/node_modules/supports-color": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz", + "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/jose": { + "version": "4.15.9", + "resolved": "https://registry.npmjs.org/jose/-/jose-4.15.9.tgz", + "integrity": "sha512-1vUQX+IdDMVPj4k8kOxgUqlcK518yluMuGZwqlr44FS1ppZB/5GWh4rZG89erpOBOJjU/OBsnCVFfapsRz6nEA==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/panva" + } + }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/js-yaml": { + "version": "3.14.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz", + "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "argparse": "^1.0.7", + "esprima": "^4.0.0" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/jsesc": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.0.2.tgz", + "integrity": "sha512-xKqzzWXDttJuOcawBt4KnKHHIf5oQ/Cxax+0PWFG+DFDgHNAdi+TXECADI+RYiFUMmx8792xsMbbgXj4CwnP4g==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "jsesc": "bin/jsesc" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/json-bigint": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-bigint/-/json-bigint-1.0.0.tgz", + "integrity": "sha512-SiPv/8VpZuWbvLSMtTDU8hEfrZWg/mH/nV/b4o0CYbSxu1UIQPLdwKOCIyLQX+VIPO5vrLX3i8qtqFyhdPSUSQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "bignumber.js": "^9.0.0" + } + }, + "node_modules/json-parse-even-better-errors": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", + "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/json5": { + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz", + "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==", + "dev": true, + "license": "MIT", + "peer": true, + "bin": { + "json5": "lib/cli.js" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/jsonwebtoken": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.2.tgz", + "integrity": "sha512-PRp66vJ865SSqOlgqS8hujT5U4AOgMfhrwYIuIhfKaoSCZcirrmASQr8CX7cUg+RMih+hgznrjp99o+W4pJLHQ==", + "license": "MIT", + "dependencies": { + "jws": "^3.2.2", + "lodash.includes": "^4.3.0", + "lodash.isboolean": "^3.0.3", + "lodash.isinteger": "^4.0.4", + "lodash.isnumber": "^3.0.3", + "lodash.isplainobject": "^4.0.6", + "lodash.isstring": "^4.0.1", + "lodash.once": "^4.0.0", + "ms": "^2.1.1", + "semver": "^7.5.4" + }, + "engines": { + "node": ">=12", + "npm": ">=6" + } + }, + "node_modules/jsonwebtoken/node_modules/jwa": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/jwa/-/jwa-1.4.1.tgz", + "integrity": "sha512-qiLX/xhEEFKUAJ6FiBMbes3w9ATzyk5W7Hvzpa/SLYdxNtng+gcurvrI7TbACjIXlsJyr05/S1oUhZrc63evQA==", + "license": "MIT", + "dependencies": { + "buffer-equal-constant-time": "1.0.1", + "ecdsa-sig-formatter": "1.0.11", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/jsonwebtoken/node_modules/jws": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/jws/-/jws-3.2.2.tgz", + "integrity": "sha512-YHlZCB6lMTllWDtSPHz/ZXTsi8S00usEV6v1tjq8tOUZzw7DpSDWVXjXDre6ed1w/pd495ODpHZYSdkRTsa0HA==", + "license": "MIT", + "dependencies": { + "jwa": "^1.4.1", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/jsonwebtoken/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/jsonwebtoken/node_modules/semver": { + "version": "7.6.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", + "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/jwa": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.0.tgz", + "integrity": "sha512-jrZ2Qx916EA+fq9cEAeCROWPTfCwi1IVHqT2tapuqLEVVDKFDENFw1oL+MwrTvH6msKxsd1YTDVw6uKEcsrLEA==", + "license": "MIT", + "optional": true, + "dependencies": { + "buffer-equal-constant-time": "1.0.1", + "ecdsa-sig-formatter": "1.0.11", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/jwks-rsa": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/jwks-rsa/-/jwks-rsa-3.1.0.tgz", + "integrity": "sha512-v7nqlfezb9YfHHzYII3ef2a2j1XnGeSE/bK3WfumaYCqONAIstJbrEGapz4kadScZzEt7zYCN7bucj8C0Mv/Rg==", + "license": "MIT", + "dependencies": { + "@types/express": "^4.17.17", + "@types/jsonwebtoken": "^9.0.2", + "debug": "^4.3.4", + "jose": "^4.14.6", + "limiter": "^1.1.5", + "lru-memoizer": "^2.2.0" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/jwks-rsa/node_modules/debug": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/jwks-rsa/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/jws": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/jws/-/jws-4.0.0.tgz", + "integrity": "sha512-KDncfTmOZoOMTFG4mBlG0qUIOlc03fmzH+ru6RgYVZhPkyiy/92Owlt/8UEN+a4TXR1FQetfIpJE8ApdvdVxTg==", + "license": "MIT", + "optional": true, + "dependencies": { + "jwa": "^2.0.0", + "safe-buffer": "^5.0.1" + } + }, + "node_modules/kleur": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", + "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/leven": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", + "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/limiter": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/limiter/-/limiter-1.1.5.tgz", + "integrity": "sha512-FWWMIEOxz3GwUI4Ts/IvgVy6LPvoMPgjMdQ185nN6psJyBJ4yOpzqm695/h5umdLJg2vW3GR5iG11MAkR2AzJA==" + }, + "node_modules/lines-and-columns": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz", + "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/locate-path": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz", + "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "p-locate": "^4.1.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/lodash": { + "version": "4.17.21", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", + "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", + "dev": true, + "license": "MIT" + }, + "node_modules/lodash.camelcase": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/lodash.camelcase/-/lodash.camelcase-4.3.0.tgz", + "integrity": "sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==", + "license": "MIT", + "optional": true + }, + "node_modules/lodash.clonedeep": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/lodash.clonedeep/-/lodash.clonedeep-4.5.0.tgz", + "integrity": "sha512-H5ZhCF25riFd9uB5UCkVKo61m3S/xZk1x4wA6yp/L3RFP6Z/eHH1ymQcGLo7J3GMPfm0V/7m1tryHuGVxpqEBQ==", + "license": "MIT" + }, + "node_modules/lodash.includes": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz", + "integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==", + "license": "MIT" + }, + "node_modules/lodash.isboolean": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz", + "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==", + "license": "MIT" + }, + "node_modules/lodash.isinteger": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz", + "integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==", + "license": "MIT" + }, + "node_modules/lodash.isnumber": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz", + "integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==", + "license": "MIT" + }, + "node_modules/lodash.isplainobject": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz", + "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==", + "license": "MIT" + }, + "node_modules/lodash.isstring": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz", + "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==", + "license": "MIT" + }, + "node_modules/lodash.once": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz", + "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==", + "license": "MIT" + }, + "node_modules/long": { + "version": "5.2.3", + "resolved": "https://registry.npmjs.org/long/-/long-5.2.3.tgz", + "integrity": "sha512-lcHwpNoggQTObv5apGNCTdJrO69eHOZMi4BNC+rTLER8iHAqGrUVeLh/irVIM7zTw2bOXA8T6uNPeujwOLg/2Q==", + "license": "Apache-2.0" + }, + "node_modules/lru-cache": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz", + "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "yallist": "^3.0.2" + } + }, + "node_modules/lru-memoizer": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/lru-memoizer/-/lru-memoizer-2.3.0.tgz", + "integrity": "sha512-GXn7gyHAMhO13WSKrIiNfztwxodVsP8IoZ3XfrJV4yH2x0/OeTO/FIaAHTY5YekdGgW94njfuKmyyt1E0mR6Ug==", + "license": "MIT", + "dependencies": { + "lodash.clonedeep": "^4.5.0", + "lru-cache": "6.0.0" + } + }, + "node_modules/lru-memoizer/node_modules/lru-cache": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", + "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", + "license": "ISC", + "dependencies": { + "yallist": "^4.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/lru-memoizer/node_modules/yallist": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", + "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==", + "license": "ISC" + }, + "node_modules/make-dir": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-4.0.0.tgz", + "integrity": "sha512-hXdUTZYIVOt1Ex//jAQi+wTZZpUpwBj/0QsOzqegb3rGMMeJiSEu5xLHnYfBrRV4RH2+OCSOO95Is/7x1WJ4bw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "semver": "^7.5.3" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/make-dir/node_modules/semver": { + "version": "7.6.3", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.6.3.tgz", + "integrity": "sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==", + "dev": true, + "license": "ISC", + "peer": true, + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/makeerror": { + "version": "1.0.12", + "resolved": "https://registry.npmjs.org/makeerror/-/makeerror-1.0.12.tgz", + "integrity": "sha512-JmqCvUhmt43madlpFzG4BQzG2Z3m6tvQDNKdClZnO3VbIudJYmxsT0FNJMeiB2+JTSlTQTSbU8QdesVmwJcmLg==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "dependencies": { + "tmpl": "1.0.5" + } + }, + "node_modules/media-typer": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz", + "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/merge-descriptors": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz", + "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/merge-stream": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz", + "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/methods": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", + "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/mime": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-3.0.0.tgz", + "integrity": "sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A==", + "license": "MIT", + "optional": true, + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=10.0.0" + } + }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mime-types": { + "version": "2.1.35", + "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", + "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", + "dependencies": { + "mime-db": "1.52.0" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/mimic-fn": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", + "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/minimatch": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", + "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/ms": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", + "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", + "license": "MIT" + }, + "node_modules/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/negotiator": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", + "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/node-fetch": { + "version": "2.7.0", + "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz", + "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==", + "license": "MIT", + "optional": true, + "dependencies": { + "whatwg-url": "^5.0.0" + }, + "engines": { + "node": "4.x || >=6.0.0" + }, + "peerDependencies": { + "encoding": "^0.1.0" + }, + "peerDependenciesMeta": { + "encoding": { + "optional": true + } + } + }, + "node_modules/node-forge": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/node-forge/-/node-forge-1.3.1.tgz", + "integrity": "sha512-dPEtOeMvF9VMcYV/1Wb8CPoVAXtp6MKMlcbAt4ddqmGqUJ6fQZFXkNZNkNlfevtNkGtaSoXf/vNNNSvgrdXwtA==", + "license": "(BSD-3-Clause OR GPL-2.0)", + "engines": { + "node": ">= 6.13.0" + } + }, + "node_modules/node-int64": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz", + "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/node-releases": { + "version": "2.0.19", + "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.19.tgz", + "integrity": "sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/npm-run-path": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz", + "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "path-key": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/object-assign": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", + "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/object-hash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz", + "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">= 6" + } + }, + "node_modules/object-inspect": { + "version": "1.13.3", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.3.tgz", + "integrity": "sha512-kDCGIbxkDSXE3euJZZXzc6to7fCrKHNI/hSRQnRuQ+BWjFNzZwiFF8fj/6o2t2G9/jTj8PSIYTfCLelLZEeRpA==", + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/on-finished": { + "version": "2.4.1", + "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz", + "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==", + "license": "MIT", + "dependencies": { + "ee-first": "1.1.1" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/once": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", + "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", + "devOptional": true, + "license": "ISC", + "dependencies": { + "wrappy": "1" + } + }, + "node_modules/onetime": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz", + "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "mimic-fn": "^2.1.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz", + "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "p-limit": "^2.2.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/p-locate/node_modules/p-limit": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz", + "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "p-try": "^2.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-try": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz", + "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/parse-json": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz", + "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@babel/code-frame": "^7.0.0", + "error-ex": "^1.3.1", + "json-parse-even-better-errors": "^2.3.0", + "lines-and-columns": "^1.1.6" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parseurl": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz", + "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/path-is-absolute": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", + "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/path-parse": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", + "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/path-to-regexp": { + "version": "0.1.12", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz", + "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==", + "license": "MIT" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC", + "peer": true + }, + "node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pirates": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.6.tgz", + "integrity": "sha512-saLsH7WeYYPiD25LDuLRRY/i+6HaPYr6G1OUlN39otzkSTxKnubR9RTxS3/Kk50s1g2JTgFwWQDQyplC5/SHZg==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">= 6" + } + }, + "node_modules/pkg-dir": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz", + "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "find-up": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/pretty-format": { + "version": "29.7.0", + "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz", + "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "@jest/schemas": "^29.6.3", + "ansi-styles": "^5.0.0", + "react-is": "^18.0.0" + }, + "engines": { + "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + } + }, + "node_modules/pretty-format/node_modules/ansi-styles": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", + "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/prompts": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", + "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "kleur": "^3.0.3", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/proto3-json-serializer": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/proto3-json-serializer/-/proto3-json-serializer-2.0.2.tgz", + "integrity": "sha512-SAzp/O4Yh02jGdRc+uIrGoe87dkN/XtwxfZ4ZyafJHymd79ozp5VG5nyZ7ygqPM5+cpLDjjGnYFUkngonyDPOQ==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "protobufjs": "^7.2.5" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/protobufjs": { + "version": "7.4.0", + "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.4.0.tgz", + "integrity": "sha512-mRUWCc3KUU4w1jU8sGxICXH/gNS94DvI1gxqDvBzhj1JpcsimQkYiOJfwsPUykUI5ZaspFbSgmBLER8IrQ3tqw==", + "hasInstallScript": true, + "license": "BSD-3-Clause", + "dependencies": { + "@protobufjs/aspromise": "^1.1.2", + "@protobufjs/base64": "^1.1.2", + "@protobufjs/codegen": "^2.0.4", + "@protobufjs/eventemitter": "^1.1.0", + "@protobufjs/fetch": "^1.1.0", + "@protobufjs/float": "^1.0.2", + "@protobufjs/inquire": "^1.1.0", + "@protobufjs/path": "^1.1.2", + "@protobufjs/pool": "^1.1.0", + "@protobufjs/utf8": "^1.1.0", + "@types/node": ">=13.7.0", + "long": "^5.0.0" + }, + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/proxy-addr": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz", + "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==", + "license": "MIT", + "dependencies": { + "forwarded": "0.2.0", + "ipaddr.js": "1.9.1" + }, + "engines": { + "node": ">= 0.10" + } + }, + "node_modules/pure-rand": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/pure-rand/-/pure-rand-6.1.0.tgz", + "integrity": "sha512-bVWawvoZoBYpp6yIoQtQXHZjmz35RSVHnUOTefl8Vcjr8snTPY1wnpSPMWekcFwbxI6gtmT7rSYPFvz71ldiOA==", + "dev": true, + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/dubzzz" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fast-check" + } + ], + "license": "MIT", + "peer": true + }, + "node_modules/qs": { + "version": "6.13.0", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz", + "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==", + "license": "BSD-3-Clause", + "dependencies": { + "side-channel": "^1.0.6" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/range-parser": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", + "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/raw-body": { + "version": "2.5.2", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz", + "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==", + "license": "MIT", + "dependencies": { + "bytes": "3.1.2", + "http-errors": "2.0.0", + "iconv-lite": "0.4.24", + "unpipe": "1.0.0" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/react-is": { + "version": "18.3.1", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz", + "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/readable-stream": { + "version": "3.6.2", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", + "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", + "license": "MIT", + "optional": true, + "dependencies": { + "inherits": "^2.0.3", + "string_decoder": "^1.1.1", + "util-deprecate": "^1.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/resolve": { + "version": "1.22.8", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.8.tgz", + "integrity": "sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "is-core-module": "^2.13.0", + "path-parse": "^1.0.7", + "supports-preserve-symlinks-flag": "^1.0.0" + }, + "bin": { + "resolve": "bin/resolve" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/resolve-cwd": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz", + "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "resolve-from": "^5.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/resolve.exports": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/resolve.exports/-/resolve.exports-2.0.3.tgz", + "integrity": "sha512-OcXjMsGdhL4XnbShKpAcSqPMzQoYkYyhbEaeSko47MjRP9NfEQMhZkXL1DoFlt9LWQn4YttrdnV6X2OiyzBi+A==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=10" + } + }, + "node_modules/retry": { + "version": "0.13.1", + "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz", + "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==", + "license": "MIT", + "optional": true, + "engines": { + "node": ">= 4" + } + }, + "node_modules/retry-request": { + "version": "7.0.2", + "resolved": "https://registry.npmjs.org/retry-request/-/retry-request-7.0.2.tgz", + "integrity": "sha512-dUOvLMJ0/JJYEn8NrpOaGNE7X3vpI5XlZS/u0ANjqtcZVKnIxP7IgCFwrKTxENw29emmwug53awKtaMm4i9g5w==", + "license": "MIT", + "optional": true, + "dependencies": { + "@types/request": "^2.48.8", + "extend": "^3.0.2", + "teeny-request": "^9.0.0" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "license": "MIT" + }, + "node_modules/semver": { + "version": "6.3.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz", + "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==", + "dev": true, + "license": "ISC", + "peer": true, + "bin": { + "semver": "bin/semver.js" + } + }, + "node_modules/send": { + "version": "0.19.0", + "resolved": "https://registry.npmjs.org/send/-/send-0.19.0.tgz", + "integrity": "sha512-dW41u5VfLXu8SJh5bwRmyYUbAoSB3c9uQh6L8h/KtsFREPWpbX1lrljJo186Jc4nmci/sGUZ9a0a0J2zgfq2hw==", + "license": "MIT", + "dependencies": { + "debug": "2.6.9", + "depd": "2.0.0", + "destroy": "1.2.0", + "encodeurl": "~1.0.2", + "escape-html": "~1.0.3", + "etag": "~1.8.1", + "fresh": "0.5.2", + "http-errors": "2.0.0", + "mime": "1.6.0", + "ms": "2.1.3", + "on-finished": "2.4.1", + "range-parser": "~1.2.1", + "statuses": "2.0.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/send/node_modules/encodeurl": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz", + "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/send/node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/send/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/serve-static": { + "version": "1.16.2", + "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.2.tgz", + "integrity": "sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==", + "license": "MIT", + "dependencies": { + "encodeurl": "~2.0.0", + "escape-html": "~1.0.3", + "parseurl": "~1.3.3", + "send": "0.19.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/set-function-length": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz", + "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==", + "license": "MIT", + "dependencies": { + "define-data-property": "^1.1.4", + "es-errors": "^1.3.0", + "function-bind": "^1.1.2", + "get-intrinsic": "^1.2.4", + "gopd": "^1.0.1", + "has-property-descriptors": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/setprototypeof": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz", + "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==", + "license": "ISC" + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/side-channel": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.6.tgz", + "integrity": "sha512-fDW/EZ6Q9RiO8eFG8Hj+7u/oW+XrPTIChwCOM2+th2A6OblDtYYIpve9m+KvI9Z4C9qSEXlaGR6bTEYHReuglA==", + "license": "MIT", + "dependencies": { + "call-bind": "^1.0.7", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.4", + "object-inspect": "^1.13.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/signal-exit": { + "version": "3.0.7", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", + "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", + "dev": true, + "license": "ISC", + "peer": true + }, + "node_modules/sisteransi": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", + "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", + "dev": true, + "license": "MIT", + "peer": true + }, + "node_modules/slash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", + "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/source-map": { + "version": "0.6.1", + "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", + "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/source-map-support": { + "version": "0.5.13", + "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.13.tgz", + "integrity": "sha512-SHSKFHadjVA5oR4PPqhtAVdcBWwRYVd6g6cAXnIbRiIwc2EhPrTuKUBdSLvlEKyIP3GCf89fltvcZiP9MMFA1w==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "buffer-from": "^1.0.0", + "source-map": "^0.6.0" + } + }, + "node_modules/sprintf-js": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz", + "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true + }, + "node_modules/stack-utils": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/stack-utils/-/stack-utils-2.0.6.tgz", + "integrity": "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "escape-string-regexp": "^2.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/statuses": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz", + "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/stream-events": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/stream-events/-/stream-events-1.0.5.tgz", + "integrity": "sha512-E1GUzBSgvct8Jsb3v2X15pjzN1tYebtbLaMg+eBOUOAxgbLoSbT2NS91ckc5lJD1KfLjId+jXJRgo0qnV5Nerg==", + "license": "MIT", + "optional": true, + "dependencies": { + "stubs": "^3.0.0" + } + }, + "node_modules/stream-shift": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/stream-shift/-/stream-shift-1.0.3.tgz", + "integrity": "sha512-76ORR0DO1o1hlKwTbi/DM3EXWGf3ZJYO8cXX5RJwnul2DEg2oyoZyjLNoQM8WsvZiFKCRfC1O0J7iCvie3RZmQ==", + "license": "MIT", + "optional": true + }, + "node_modules/string_decoder": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", + "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", + "license": "MIT", + "optional": true, + "dependencies": { + "safe-buffer": "~5.2.0" + } + }, + "node_modules/string-length": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/string-length/-/string-length-4.0.2.tgz", + "integrity": "sha512-+l6rNN5fYHNhZZy41RXsYptCjA2Igmq4EG7kZAYFQI1E1VTXarr6ZPXBg6eq7Y6eK4FEhY6AJlyuFIb/v/S0VQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "char-regex": "^1.0.2", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-bom": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-4.0.0.tgz", + "integrity": "sha512-3xurFv5tEgii33Zi8Jtp55wEIILR9eh34FAW00PZf+JnSsTmV/ioewSgQl97JHvgjoRGwPShsWm+IdrxB35d0w==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-final-newline": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz", + "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=6" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/strnum": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-1.0.5.tgz", + "integrity": "sha512-J8bbNyKKXl5qYcR36TIO8W3mVGVHrmmxsd5PAItGkmyzwJvybiw2IVq5nqd0i4LSNSkB/sx9VHllbfFdr9k1JA==", + "license": "MIT", + "optional": true + }, + "node_modules/stubs": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/stubs/-/stubs-3.0.0.tgz", + "integrity": "sha512-PdHt7hHUJKxvTCgbKX9C1V/ftOcjJQgz8BZwNfV5c4B6dcGqlpelTbJ999jBGZ2jYiPAwcX5dP6oBwVlBlUbxw==", + "license": "MIT", + "optional": true + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/supports-preserve-symlinks-flag": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", + "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/teeny-request": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/teeny-request/-/teeny-request-9.0.0.tgz", + "integrity": "sha512-resvxdc6Mgb7YEThw6G6bExlXKkv6+YbuzGg9xuXxSgxJF7Ozs+o8Y9+2R3sArdWdW8nOokoQb1yrpFB0pQK2g==", + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "http-proxy-agent": "^5.0.0", + "https-proxy-agent": "^5.0.0", + "node-fetch": "^2.6.9", + "stream-events": "^1.0.5", + "uuid": "^9.0.0" + }, + "engines": { + "node": ">=14" + } + }, + "node_modules/teeny-request/node_modules/agent-base": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz", + "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "debug": "4" + }, + "engines": { + "node": ">= 6.0.0" + } + }, + "node_modules/teeny-request/node_modules/debug": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz", + "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==", + "license": "MIT", + "optional": true, + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/teeny-request/node_modules/https-proxy-agent": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz", + "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==", + "license": "MIT", + "optional": true, + "dependencies": { + "agent-base": "6", + "debug": "4" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/teeny-request/node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT", + "optional": true + }, + "node_modules/teeny-request/node_modules/uuid": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-9.0.1.tgz", + "integrity": "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==", + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], + "license": "MIT", + "optional": true, + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/test-exclude": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/test-exclude/-/test-exclude-6.0.0.tgz", + "integrity": "sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "@istanbuljs/schema": "^0.1.2", + "glob": "^7.1.4", + "minimatch": "^3.0.4" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/tmpl": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/tmpl/-/tmpl-1.0.5.tgz", + "integrity": "sha512-3f0uOEAQwIqGuWW2MVzYg8fV/QNnc/IpuJNG837rLuczAaLVHslWHZQj4IGiEl5Hs3kkbhwL9Ab7Hrsmuj+Smw==", + "dev": true, + "license": "BSD-3-Clause", + "peer": true + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "peer": true, + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/toidentifier": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz", + "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==", + "license": "MIT", + "engines": { + "node": ">=0.6" + } + }, + "node_modules/tr46": { + "version": "0.0.3", + "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", + "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==", + "license": "MIT", + "optional": true + }, + "node_modules/ts-deepmerge": { + "version": "2.0.7", + "resolved": "https://registry.npmjs.org/ts-deepmerge/-/ts-deepmerge-2.0.7.tgz", + "integrity": "sha512-3phiGcxPSSR47RBubQxPoZ+pqXsEsozLo4G4AlSrsMKTFg9TA3l+3he5BqpUi9wiuDbaHWXH/amlzQ49uEdXtg==", + "dev": true, + "license": "ISC" + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "license": "0BSD" + }, + "node_modules/type-detect": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz", + "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==", + "dev": true, + "license": "MIT", + "peer": true, + "engines": { + "node": ">=4" + } + }, + "node_modules/type-fest": { + "version": "0.21.3", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz", + "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "peer": true, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/type-is": { + "version": "1.6.18", + "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", + "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==", + "license": "MIT", + "dependencies": { + "media-typer": "0.3.0", + "mime-types": "~2.1.24" + }, + "engines": { + "node": ">= 0.6" + } + }, + "node_modules/typescript": { + "version": "4.9.5", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-4.9.5.tgz", + "integrity": "sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=4.2.0" + } + }, + "node_modules/undici-types": { + "version": "6.20.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.20.0.tgz", + "integrity": "sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg==", + "license": "MIT" + }, + "node_modules/unpipe": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz", + "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/update-browserslist-db": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.1.tgz", + "integrity": "sha512-R8UzCaa9Az+38REPiJ1tXlImTJXlVfgHZsglwBD/k6nj76ctsH1E3q4doGrukiLQd3sGQYu56r5+lo5r94l29A==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/browserslist" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/browserslist" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "peer": true, + "dependencies": { + "escalade": "^3.2.0", + "picocolors": "^1.1.0" + }, + "bin": { + "update-browserslist-db": "cli.js" + }, + "peerDependencies": { + "browserslist": ">= 4.21.0" + } + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "license": "MIT", + "optional": true + }, + "node_modules/utils-merge": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz", + "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==", + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/uuid": { + "version": "10.0.0", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-10.0.0.tgz", + "integrity": "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ==", + "funding": [ + "https://github.com/sponsors/broofa", + "https://github.com/sponsors/ctavan" + ], + "license": "MIT", + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/v8-to-istanbul": { + "version": "9.3.0", + "resolved": "https://registry.npmjs.org/v8-to-istanbul/-/v8-to-istanbul-9.3.0.tgz", + "integrity": "sha512-kiGUalWN+rgBJ/1OHZsBtU4rXZOfj/7rKQxULKlIzwzQSvMJUUNgPwJEEh7gU6xEVxC0ahoOBvN2YI8GH6FNgA==", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "@jridgewell/trace-mapping": "^0.3.12", + "@types/istanbul-lib-coverage": "^2.0.1", + "convert-source-map": "^2.0.0" + }, + "engines": { + "node": ">=10.12.0" + } + }, + "node_modules/vary": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz", + "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/walker": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/walker/-/walker-1.0.8.tgz", + "integrity": "sha512-ts/8E8l5b7kY0vlWLewOkDXMmPdLcVV4GmOQLyxuSswIJsweeFZtAsMF7k1Nszz+TYBQrlYRmzOnr398y1JemQ==", + "dev": true, + "license": "Apache-2.0", + "peer": true, + "dependencies": { + "makeerror": "1.0.12" + } + }, + "node_modules/webidl-conversions": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz", + "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==", + "license": "BSD-2-Clause", + "optional": true + }, + "node_modules/websocket-driver": { + "version": "0.7.4", + "resolved": "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.7.4.tgz", + "integrity": "sha512-b17KeDIQVjvb0ssuSDF2cYXSg2iztliJ4B9WdsuB6J952qCPKmnVq4DyW5motImXHDC1cBT/1UezrJVsKw5zjg==", + "license": "Apache-2.0", + "dependencies": { + "http-parser-js": ">=0.5.1", + "safe-buffer": ">=5.1.0", + "websocket-extensions": ">=0.1.1" + }, + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/websocket-extensions": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/websocket-extensions/-/websocket-extensions-0.1.4.tgz", + "integrity": "sha512-OqedPIGOfsDlo31UNwYbCFMSaO9m9G/0faIHj5/dZFDMFqPTcx6UwqyOy3COEaEOg/9VsGIpdqn62W5KhoKSpg==", + "license": "Apache-2.0", + "engines": { + "node": ">=0.8.0" + } + }, + "node_modules/whatwg-url": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz", + "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==", + "license": "MIT", + "optional": true, + "dependencies": { + "tr46": "~0.0.3", + "webidl-conversions": "^3.0.0" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/wrap-ansi": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrappy": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", + "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", + "devOptional": true, + "license": "ISC" + }, + "node_modules/write-file-atomic": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-4.0.2.tgz", + "integrity": "sha512-7KxauUdBmSdWnmpaGFg+ppNjKF8uNLry8LyzjauQDOVONfFLNKrKvQOxZ/VuTIcS/gge/YNahf5RIIQWTSarlg==", + "dev": true, + "license": "ISC", + "peer": true, + "dependencies": { + "imurmurhash": "^0.1.4", + "signal-exit": "^3.0.7" + }, + "engines": { + "node": "^12.13.0 || ^14.15.0 || >=16.0.0" + } + }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "devOptional": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yallist": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz", + "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==", + "dev": true, + "license": "ISC", + "peer": true + }, + "node_modules/yargs": { + "version": "17.7.2", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz", + "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==", + "devOptional": true, + "license": "MIT", + "dependencies": { + "cliui": "^8.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "require-directory": "^2.1.1", + "string-width": "^4.2.3", + "y18n": "^5.0.5", + "yargs-parser": "^21.1.1" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/yargs-parser": { + "version": "21.1.1", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", + "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==", + "devOptional": true, + "license": "ISC", + "engines": { + "node": ">=12" + } + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + } + } +} diff --git a/test/functions/package.json b/test/functions/package.json new file mode 100644 index 000000000..dd7606251 --- /dev/null +++ b/test/functions/package.json @@ -0,0 +1,25 @@ +{ + "name": "functions", + "scripts": { + "build": "tsc", + "build:watch": "tsc --watch", + "serve": "npm run build && firebase emulators:start --only functions", + "shell": "npm run build && firebase functions:shell", + "start": "npm run shell", + "deploy": "firebase deploy --only functions", + "logs": "firebase functions:log" + }, + "engines": { + "node": "18" + }, + "main": "lib/index.js", + "dependencies": { + "firebase-admin": "^12.6.0", + "firebase-functions": "^6.0.1" + }, + "devDependencies": { + "typescript": "^4.9.0", + "firebase-functions-test": "^3.1.0" + }, + "private": true +} \ No newline at end of file diff --git a/test/functions/src/index.ts b/test/functions/src/index.ts new file mode 100644 index 000000000..9a1d18e3d --- /dev/null +++ b/test/functions/src/index.ts @@ -0,0 +1,5 @@ +import { onCall } from "firebase-functions/v2/https"; + +export const foo = onCall(() => { + return { bar: "baz" }; +}); diff --git a/test/functions/tsconfig.json b/test/functions/tsconfig.json new file mode 100644 index 000000000..7ce05d039 --- /dev/null +++ b/test/functions/tsconfig.json @@ -0,0 +1,15 @@ +{ + "compilerOptions": { + "module": "commonjs", + "noImplicitReturns": true, + "noUnusedLocals": true, + "outDir": "lib", + "sourceMap": true, + "strict": true, + "target": "es2017" + }, + "compileOnSave": true, + "include": [ + "src" + ] +} diff --git a/test/storage.rules b/test/storage.rules new file mode 100644 index 000000000..a7db6961c --- /dev/null +++ b/test/storage.rules @@ -0,0 +1,8 @@ +rules_version = '2'; +service firebase.storage { + match /b/{bucket}/o { + match /{allPaths=**} { + allow read, write: if true; + } + } +} diff --git a/test/tsconfig.json b/test/tsconfig.json deleted file mode 100644 index d7011d1f3..000000000 --- a/test/tsconfig.json +++ /dev/null @@ -1,14 +0,0 @@ -{ - "compilerOptions": { - "experimentalDecorators": true, - "emitDecoratorMetadata": true, - "module": "commonjs", - "target": "es5", - "noImplicitAny": true, - "sourceMap": true, - "declaration": true, - "removeComments": true, - "rootDir": ".", - "outDir": "../dist-test" - } -} diff --git a/test/typings-test/index.ts b/test/typings-test/index.ts deleted file mode 100644 index e69de29bb..000000000 diff --git a/test/typings-test/package.sample.json b/test/typings-test/package.sample.json deleted file mode 100644 index efbf7183d..000000000 --- a/test/typings-test/package.sample.json +++ /dev/null @@ -1,17 +0,0 @@ -{ - "name": "typings-test", - "version": "1.0.0", - "private": true, - "dependencies": { - "angularfire2": "file:{{ANGULARFIRE_VERSION}}", - "firebase": "{{FIREBASE_VERSION}}", - "@angular/common": "{{ANGULAR_VERSION}}", - "@angular/compiler": "{{ANGULAR_VERSION}}", - "@angular/core": "{{ANGULAR_VERSION}}", - "@angular/platform-browser": "{{ANGULAR_VERSION}}", - "@angular/platform-browser-dynamic": "{{ANGULAR_VERSION}}", - "zone.js": "{{ZONE_VERSION}}", - "rxjs": "{{RXJS_VERSION}}", - "typescript": "{{TYPESCRIPT_VERSION}}" - } -} diff --git a/test/typings-test/tsconfig.json b/test/typings-test/tsconfig.json deleted file mode 100644 index 645b6421c..000000000 --- a/test/typings-test/tsconfig.json +++ /dev/null @@ -1,17 +0,0 @@ -{ - "compilerOptions": { - "emitDecoratorMetadata": true, - "experimentalDecorators": true, - "lib": ["es6", "dom"], - "module": "es6", - "target": "es5", - "moduleResolution": "node", - "noImplicitAny": true, - "skipLibCheck": false, - "skipDefaultLibCheck": false, - "noEmit": true - }, - "files": [ - "index.ts" - ] -} diff --git a/test/typings.d.ts b/test/typings.d.ts deleted file mode 100644 index b1db1096c..000000000 --- a/test/typings.d.ts +++ /dev/null @@ -1,2 +0,0 @@ -/// -/// diff --git a/tools/build.sh b/tools/build.sh new file mode 100755 index 000000000..7dd2d6cdb --- /dev/null +++ b/tools/build.sh @@ -0,0 +1,21 @@ +SHORT_SHA=$(git rev-parse --short $GITHUB_SHA) +TAG_TEST="^refs/tags/.+$" +LATEST_TEST="^[^-]*$" + +if [[ $GITHUB_REF =~ $TAG_TEST ]]; then + OVERRIDE_VERSION=${GITHUB_REF/refs\/tags\//} + if [[ $OVERRIDE_VERSION =~ $LATEST_TEST ]]; then + NPM_TAG=latest + else + NPM_TAG=next + fi; +else + OVERRIDE_VERSION=$(node -e "console.log(require('./package.json').version)")-canary.$SHORT_SHA + NPM_TAG=canary +fi; + +npm --no-git-tag-version --allow-same-version -f version $OVERRIDE_VERSION + +npm run build && + echo "npm publish . --tag $NPM_TAG" > ./dist/packages-dist/publish.sh && + chmod +x ./dist/packages-dist/publish.sh diff --git a/tools/build.ts b/tools/build.ts new file mode 100644 index 000000000..c947ad765 --- /dev/null +++ b/tools/build.ts @@ -0,0 +1,358 @@ +import { spawn } from 'cross-spawn'; +import { copy, writeFile } from 'fs-extra'; +import { join } from 'path'; +import { keys as tsKeys } from 'ts-transformer-keys'; +import * as esbuild from "esbuild"; + +enum LogLevel { + "WARN" = 1, + "VERBOSE" = 2, +}; + +interface OverrideOptions { + exportName?: string; + zoneWrap?: boolean; + blockUntilFirst?: boolean; + override?: boolean; + logLevel?: LogLevel; +} + +const firestoreOverrides = { + addDoc: { logLevel: LogLevel.VERBOSE }, + aggregateFieldEqual: { logLevel: LogLevel.VERBOSE }, + aggregateQuerySnapshotEqual: { logLevel: LogLevel.VERBOSE }, + and: { logLevel: LogLevel.VERBOSE }, + arrayRemove: null, + arrayUnion: null, + average: null, + collection: { logLevel: LogLevel.VERBOSE }, + collectionGroup: { logLevel: LogLevel.VERBOSE }, + count: null, + deleteDoc: { logLevel: LogLevel.VERBOSE }, + deleteField: { logLevel: LogLevel.VERBOSE }, + doc: { logLevel: LogLevel.VERBOSE }, + documentId: { logLevel: LogLevel.VERBOSE }, + endAt: { logLevel: LogLevel.VERBOSE }, + endBefore: { logLevel: LogLevel.VERBOSE }, + increment: { logLevel: LogLevel.VERBOSE }, + limit: { logLevel: LogLevel.VERBOSE }, + limitToLast: { logLevel: LogLevel.VERBOSE }, + memoryEagerGarbageCollector: null, + memoryLocalCache: null, + memoryLruGarbageCollector: null, + namedQuery: { logLevel: LogLevel.VERBOSE }, + or: { logLevel: LogLevel.VERBOSE }, + orderBy: { logLevel: LogLevel.VERBOSE }, + persistentLocalCache: null, + persistentMultipleTabManager: null, + persistentSingleTabManager: null, + query: { logLevel: LogLevel.VERBOSE }, + queryEqual: { logLevel: LogLevel.VERBOSE }, + refEqual: { logLevel: LogLevel.VERBOSE }, + serverTimestamp: null, + setDoc: { logLevel: LogLevel.VERBOSE }, + snapshotEqual: { logLevel: LogLevel.VERBOSE }, + startAfter: { logLevel: LogLevel.VERBOSE }, + startAt: { logLevel: LogLevel.VERBOSE }, + sum: { logLevel: LogLevel.VERBOSE }, + updateDoc: { logLevel: LogLevel.VERBOSE }, + vector: { logLevel: LogLevel.VERBOSE }, + where: { logLevel: LogLevel.VERBOSE }, + writeBatch: { logLevel: LogLevel.VERBOSE }, +}; + +function zoneWrapExports() { + const reexport = async ( + module: string, + name: string, + path: string, + exports: string[], + overrides: Record = {} + ) => { + const imported = await import(path); + const toBeExported: [string, string, boolean][] = exports.sort(). + filter(it => !it.startsWith('_') && overrides[it] !== null && overrides[it]?.override !== true). + map(importName => { + const zoneWrap = typeof imported[importName] === 'function' && + // eslint-disable-next-line @typescript-eslint/prefer-string-starts-ends-with + (overrides[importName]?.zoneWrap ?? importName[0] !== importName[0].toUpperCase()); + const exportName = overrides[importName]?.exportName ?? importName; + return [importName, exportName, zoneWrap]; + }); + const zoneWrapped = toBeExported.filter(([, , zoneWrap]) => zoneWrap); + const rawExport = toBeExported.filter(([, , zoneWrap]) => !zoneWrap); + const overridden = Object.keys(overrides).filter(key => overrides[key]?.override); + const isFirebaseSDK = path.startsWith('firebase/'); + const hasZoneWrappedFns = zoneWrapped.length > 0; + const hasRawExportedFns = rawExport.length > 0; + const hasOverridedFns = overridden.length > 0; + const zoneWrappedImports = zoneWrapped.map(([importName]) => `${importName} as _${importName}`).join(',\n '); + const rawExportedFns = rawExport.map(([importName, exportName]) => + `${importName}${exportName === importName ? '' : `as ${exportName}`}`).join(',\n '); + const overriddenFns = overridden.join(',\n '); + const exportedZoneWrappedFns = zoneWrapped.map(([importName, exportName]) => + `export const ${exportName} = ÉĩzoneWrap(_${importName}, ${overrides[importName]?.blockUntilFirst ?? true}${overrides[importName]?.logLevel ? `, ${overrides[importName].logLevel}` : ""});`) + .join('\n'); + const filePath = join(process.cwd(), 'src', `${module}/${name}.ts`); + // TODO(davideast): Create a builder pattern for this file for readability + const fileOutput = `// DO NOT MODIFY, this file is autogenerated by tools/build.ts +${isFirebaseSDK ? `export * from '${path}';\n` : ''}${hasZoneWrappedFns ? `import { ÉĩzoneWrap } from '@angular/fire'; +import { + ${zoneWrappedImports} +} from '${path}'; +` : ''}${!isFirebaseSDK && hasRawExportedFns ? ` +export { + ${rawExportedFns} +} from '${path}'; +` : ''}${hasOverridedFns ? ` +export { + ${overriddenFns} +} from './overrides'; +` : ''} +${exportedZoneWrappedFns} +`; + await writeFile(filePath, fileOutput); + }; + return Promise.all([ + reexport('ai', 'firebase', 'firebase/ai', tsKeys()), + reexport('analytics', 'firebase', 'firebase/analytics', tsKeys(), { + isSupported: { blockUntilFirst: false }, + logEvent: { blockUntilFirst: false, logLevel: LogLevel.VERBOSE }, + setAnalyticsCollectionEnabled: { logLevel: LogLevel.VERBOSE }, + setConsent: { logLevel: LogLevel.VERBOSE }, + setCurrentScreen: { logLevel: LogLevel.VERBOSE }, + setDefaultEventParameters: { logLevel: LogLevel.VERBOSE }, + setUserId: { logLevel: LogLevel.VERBOSE }, + setUserProperties: { logLevel: LogLevel.VERBOSE }, + }), + reexport('app', 'firebase', 'firebase/app', tsKeys()), + reexport('app-check', 'firebase', 'firebase/app-check', tsKeys(), { + getLimitedUseToken: { logLevel: LogLevel.VERBOSE }, + }), + reexport('auth', 'rxfire', 'rxfire/auth', tsKeys()), + reexport('auth', 'firebase', 'firebase/auth', tsKeys(), { + debugErrorMap: null, + inMemoryPersistence: null, + browserLocalPersistence: null, + browserSessionPersistence: null, + indexedDBLocalPersistence: null, + prodErrorMap: null, + multiFactor: null, + linkWithCredential: { logLevel: LogLevel.VERBOSE }, + linkWithPhoneNumber: { logLevel: LogLevel.VERBOSE }, + linkWithPopup: { logLevel: LogLevel.VERBOSE }, + linkWithRedirect: { logLevel: LogLevel.VERBOSE }, + signInAnonymously: { logLevel: LogLevel.VERBOSE }, + signInWithCredential: { logLevel: LogLevel.VERBOSE }, + signInWithCustomToken: { logLevel: LogLevel.VERBOSE }, + signInWithEmailAndPassword: { logLevel: LogLevel.VERBOSE }, + signInWithEmailLink: { logLevel: LogLevel.VERBOSE }, + signInWithPhoneNumber: { logLevel: LogLevel.VERBOSE }, + signInWithPopup: { logLevel: LogLevel.VERBOSE }, + signInWithRedirect: { logLevel: LogLevel.VERBOSE }, + signOut: { logLevel: LogLevel.VERBOSE }, + confirmPasswordReset: { logLevel: LogLevel.VERBOSE }, + deleteUser: { logLevel: LogLevel.VERBOSE }, + createUserWithEmailAndPassword: { logLevel: LogLevel.VERBOSE }, + fetchSignInMethodsForEmail: { logLevel: LogLevel.VERBOSE }, + getAdditionalUserInfo: { logLevel: LogLevel.VERBOSE }, + reauthenticateWithCredential: { logLevel: LogLevel.VERBOSE }, + reauthenticateWithPhoneNumber: { logLevel: LogLevel.VERBOSE }, + reauthenticateWithPopup: { logLevel: LogLevel.VERBOSE }, + reauthenticateWithRedirect: { logLevel: LogLevel.VERBOSE }, + reload : { logLevel: LogLevel.VERBOSE }, + revokeAccessToken: { logLevel: LogLevel.VERBOSE }, + sendEmailVerification: { logLevel: LogLevel.VERBOSE }, + sendPasswordResetEmail: { logLevel: LogLevel.VERBOSE }, + sendSignInLinkToEmail: { logLevel: LogLevel.VERBOSE }, + unlink: { logLevel: LogLevel.VERBOSE }, + updateCurrentUser: { logLevel: LogLevel.VERBOSE }, + updateEmail: { logLevel: LogLevel.VERBOSE }, + updatePassword: { logLevel: LogLevel.VERBOSE }, + updatePhoneNumber: { logLevel: LogLevel.VERBOSE }, + updateProfile: { logLevel: LogLevel.VERBOSE }, + useDeviceLanguage: { logLevel: LogLevel.VERBOSE }, + validatePassword: { logLevel: LogLevel.VERBOSE }, + verifyBeforeUpdateEmail: { logLevel: LogLevel.VERBOSE }, + verifyPasswordResetCode: { logLevel: LogLevel.VERBOSE }, + }), + reexport('database', 'rxfire', 'rxfire/database', tsKeys()), + reexport('database', 'firebase', 'firebase/database', tsKeys(), { + child: { logLevel: LogLevel.VERBOSE }, + endAt: { logLevel: LogLevel.VERBOSE }, + endBefore: { logLevel: LogLevel.VERBOSE }, + equalTo: { logLevel: LogLevel.VERBOSE }, + increment: { logLevel: LogLevel.VERBOSE }, + limitToFirst: { logLevel: LogLevel.VERBOSE }, + limitToLast: { logLevel: LogLevel.VERBOSE }, + orderByChild: { logLevel: LogLevel.VERBOSE }, + orderByKey: { logLevel: LogLevel.VERBOSE }, + orderByPriority: { logLevel: LogLevel.VERBOSE }, + orderByValue: { logLevel: LogLevel.VERBOSE }, + push: { logLevel: LogLevel.VERBOSE }, + query: { logLevel: LogLevel.VERBOSE }, + ref: { logLevel: LogLevel.VERBOSE }, + refFromURL: { logLevel: LogLevel.VERBOSE }, + remove: { logLevel: LogLevel.VERBOSE }, + serverTimestamp: null, + set: { logLevel: LogLevel.VERBOSE }, + setPriority: { logLevel: LogLevel.VERBOSE }, + setWithPriority: { logLevel: LogLevel.VERBOSE }, + startAfter: { logLevel: LogLevel.VERBOSE }, + startAt: { logLevel: LogLevel.VERBOSE }, + update: { logLevel: LogLevel.VERBOSE }, + }), + reexport('data-connect', 'firebase', 'firebase/data-connect', tsKeys(), { + mutationRef: { logLevel: LogLevel.VERBOSE }, + queryRef: { logLevel: LogLevel.VERBOSE }, + toQueryRef: { logLevel: LogLevel.VERBOSE }, + }), + reexport('firestore', 'rxfire', 'rxfire/firestore', tsKeys(), { + doc: { exportName: 'docSnapshots' }, + collection: { exportName: 'collectionSnapshots' }, + }), + reexport('firestore', 'firebase', 'firebase/firestore', tsKeys(), firestoreOverrides), + reexport('functions', 'rxfire', 'rxfire/functions', ["httpsCallable"], { + httpsCallable: { exportName: 'httpsCallableData' }, + }), + reexport('functions', 'firebase', 'firebase/functions', tsKeys()), + reexport('messaging', 'firebase', 'firebase/messaging', tsKeys(), { + isSupported: { blockUntilFirst: false }, + onMessage: { blockUntilFirst: false }, + deleteToken: { logLevel: LogLevel.VERBOSE }, + }), + reexport('remote-config', 'rxfire', 'rxfire/remote-config', tsKeys(), { + isSupported: { blockUntilFirst: false }, + getValue: { exportName: 'getValueChanges' }, + getString: { exportName: 'getStringChanges' }, + getNumber: { exportName: 'getNumberChanges' }, + getBoolean: { exportName: 'getBooleanChanges' }, + getAll: { exportName: 'getAllChanges' }, + }), + reexport('remote-config', 'firebase', 'firebase/remote-config', tsKeys()), + reexport('storage', 'rxfire', 'rxfire/storage', tsKeys(), { + getDownloadURL: null, + getMetadata: null, + uploadBytesResumable: null, + uploadString: null, + }), + reexport('storage', 'firebase', 'firebase/storage', tsKeys(), { + deleteObject: { logLevel: LogLevel.VERBOSE }, + ref: { logLevel: LogLevel.VERBOSE }, + updateMetadata: { logLevel: LogLevel.VERBOSE }, + }), + reexport('performance', 'rxfire', 'rxfire/performance', tsKeys(), { + getPerformance$: null, + trace: null, + }), + reexport('performance', 'firebase', 'firebase/performance', tsKeys(), { + trace: { logLevel: LogLevel.VERBOSE }, + }), + reexport('firestore/lite', 'rxfire', 'rxfire/firestore/lite', tsKeys(), { + doc: { exportName: 'docSnapshots' }, + collection: { exportName: 'collectionSnapshots' }, + }), + reexport('firestore/lite', 'firebase', 'firebase/firestore/lite', tsKeys(), firestoreOverrides), + reexport('vertexai', 'firebase', 'firebase/vertexai', tsKeys()), + ]); +} + +const src = (...args: string[]) => join(process.cwd(), 'src', ...args); +const dest = (...args: string[]) => join(process.cwd(), 'dist', 'packages-dist', ...args); + +const rootPackage = import(join(process.cwd(), 'package.json')); + +async function replacePackageCoreVersion() { + const root = await rootPackage; + // eslint-disable-next-line @typescript-eslint/no-var-requires + const replace = require('replace-in-file'); + const files = dest('package.json'); + return replace({ + files, + from: 'ANGULARFIRE2_VERSION', + to: root.version + }); +} + +async function replaceSchematicVersions() { + const root = await rootPackage; + const packagesPath = dest('schematics', 'versions.json'); + const dependencies = await import(packagesPath); + Object.keys(dependencies.peerDependencies).forEach(name => { + dependencies.peerDependencies[name].version = root.dependencies[name] || root.devDependencies[name]; + }); + Object.keys(dependencies.firebaseFunctionsDependencies).forEach(name => { + dependencies.firebaseFunctionsDependencies[name].version = root.dependencies[name] || root.devDependencies[name]; + }); + return writeFile(packagesPath, JSON.stringify(dependencies, null, 2)); +} + +function spawnPromise(command: string, args: string[]) { + return new Promise((resolve, reject) => spawn(command, args, { stdio: 'inherit' }).on('close', code => { + if (code === 0) { + resolve() + } else { + reject('Build failed.'); + } + }) + .on('error', reject)); +} + +async function compileSchematics() { + await esbuild.build({ + entryPoints: [ + src('schematics', "update", "index.ts"), + src('schematics', "deploy", "actions.ts"), + src('schematics', "deploy", "builder.ts"), + src('schematics', "add", "index.ts"), + src('schematics', "setup", "index.ts"), + src('schematics', "update", "v7", "index.ts"), + ], + format: "cjs", + // turns out schematics don't support ESM, need to use webpack or shim these + // format: "esm", + // splitting: true, + // outExtension: {".js": ".mjs"}, + bundle: true, + minify: true, + platform: "node", + target: "es2016", + external: [ + "@angular-devkit/schematics", + "@angular-devkit/architect", + "@angular-devkit/core", + "rxjs", + "@schematics/angular", + "jsonc-parser", + "firebase-tools" + ], + outdir: dest('schematics'), + }); + await Promise.all([ + copy(src('schematics', 'versions.json'), dest('schematics', 'versions.json')), + copy(src('schematics', 'builders.json'), dest('schematics', 'builders.json')), + copy(src('schematics', 'collection.json'), dest('schematics', 'collection.json')), + copy(src('schematics', 'migration.json'), dest('schematics', 'migration.json')), + copy(src('schematics', 'deploy', 'schema.json'), dest('schematics', 'deploy', 'schema.json')), + copy(src('schematics', 'add', 'schema.json'), dest('schematics', 'add', 'schema.json')), + copy(src('schematics', 'setup', 'schema.json'), dest('schematics', 'setup', 'schema.json')), + ]); + await replaceSchematicVersions(); +} + +async function buildLibrary() { + await zoneWrapExports(); + await spawnPromise('npx', ['ng', 'build']); + await Promise.all([ + copy(join(process.cwd(), '.npmignore'), dest('.npmignore')), + copy(join(process.cwd(), 'README.md'), dest('README.md')), + copy(join(process.cwd(), 'docs'), dest('docs')), + compileSchematics(), + replacePackageCoreVersion(), + ]); +} + +buildLibrary().catch(err => { + console.error(err); + process.exit(1); +}) diff --git a/tools/jasmine.ts b/tools/jasmine.ts new file mode 100644 index 000000000..721f9106b --- /dev/null +++ b/tools/jasmine.ts @@ -0,0 +1,25 @@ +// @ts-ignore +import Jasmine from 'jasmine'; + +import 'reflect-metadata'; +import 'zone.js'; + +import { getTestBed } from '@angular/core/testing'; +import { platformServerTesting, ServerTestingModule } from '@angular/platform-server/testing'; + +// First, initialize the Angular testing environment. +getTestBed().initTestEnvironment( + ServerTestingModule, + platformServerTesting() +); + +const tests = new Jasmine({}); +tests.loadConfig({ + spec_dir: '.', + spec_files: [ + 'dist/out-tsc/jasmine/**/*.jasmine.js', + 'dist/out-tsc/jasmine/**/*.spec.js', + ] +}); + +tests.execute(); diff --git a/tools/rewrite-published-package.js b/tools/rewrite-published-package.js deleted file mode 100644 index 428269314..000000000 --- a/tools/rewrite-published-package.js +++ /dev/null @@ -1,24 +0,0 @@ -/** - * Rewrite the package.json that gets published to npm. - * * Change main to point to angularfire.js instead of dist/angularfire.js - * * Change angular2 to be a peer dependency - */ -var fs = require('fs'); -var srcPackage = require('../package.json'); - -delete srcPackage.scripts; - -var peerDependencies = Object.assign({}, srcPackage.dependencies); - -delete srcPackage.dependencies; - -var outPackage = Object.assign({}, srcPackage, { peerDependencies }); - -fs.writeFileSync('./dist/package.json', JSON.stringify(outPackage, null, 2)); - -// It's also necessary to copy any deep-path package.json files. -// See https://github.com/angular/angularfire2/issues/880 - -['app', 'auth', 'database'].forEach(dir => { - fs.writeFileSync(`./dist/${dir}/package.json`, fs.readFileSync(`./src/${dir}/package.json`)); -}); diff --git a/tools/run-typings-test.js b/tools/run-typings-test.js deleted file mode 100644 index c6084676b..000000000 --- a/tools/run-typings-test.js +++ /dev/null @@ -1,77 +0,0 @@ -/** - * This file uses the test project at test/typings-test to validate - * that AngularFire typings don't produce errors in user code. - * - * 1. Create a temp directory to copy the test project - * 2. Create a package.json based on test-project/package.sample.json, - * using versions from the project's root package.json. - * 3. NPM install inside the temporary project directory - * 4. Run TSC against the project's local tsconfig.json and local node_modules - * 5. - */ -const fs = require('fs'); -const path = require('path'); -const ncp = require('ncp'); -const rimraf = require('rimraf'); -const child_process = require('child_process'); -const pathToTestSrcFolder = path.resolve(__dirname, '../test/typings-test/'); -const binaryPath = path.resolve(__dirname, '../node_modules/.bin') -const rootPackage = require(path.resolve(__dirname, '../package.json')); - -const startingCwd = process.cwd(); - -const pathToTestFolder = fs.mkdtempSync('/tmp/typings-test-'); - -process.chdir(pathToTestFolder) - -ncp(pathToTestSrcFolder, pathToTestFolder, () => { - const samplePackage = require(`${pathToTestFolder}/package.sample.json`); - - fs.writeFileSync(`${pathToTestFolder}/package.json`, JSON.stringify(samplePackage, null, 2) - .replace('{{ANGULARFIRE_VERSION}}', path.resolve(__dirname, '../dist')) - .replace('{{FIREBASE_VERSION}}', rootPackage.dependencies.firebase) - .replace('{{RXJS_VERSION}}', rootPackage.dependencies.rxjs) - .replace('{{ZONE_VERSION}}', rootPackage.devDependencies['zone.js']) - .replace('{{TYPESCRIPT_VERSION}}', rootPackage.devDependencies.typescript) - .replace(/\{\{ANGULAR_VERSION\}\}/g, rootPackage.dependencies['@angular/core'])); - - spawnIt('npm', ['install']) - .then(_ => spawnIt(`${pathToTestFolder}/node_modules/.bin/tsc`, ['--version'])) - .then(_ => new Promise((res, rej) => { - child_process.exec(`${pathToTestFolder}/node_modules/.bin/tsc --diagnostics -p ${pathToTestFolder}/tsconfig.json`, (err, stdout, stderr) => { - console.log(stdout); - if (err) { - rej(1); - } else { - res(); - } - }); - })) - .catch(_ => { - // resolve with exit code 1 - return Promise.resolve(1) - }) - .then(cleanup) - .then(code => process.exit(code || 0)); -}) - -function spawnIt(program, args) { - console.log('-----------------------------------'); - console.log(program, (args && args.join(' ')) || ''); - console.log('-----------------------------------'); - return new Promise((res, rej) => { - child_process.spawn(program, args, { - cwd: pathToTestFolder, - stdio: 'inherit' - }) - .on('close', (code) => { - if (code) return rej(code); - res(); - }) - }); -} - -function cleanup (val) { - rimraf.sync(pathToTestFolder); - return val; -} diff --git a/tsconfig.base.json b/tsconfig.base.json new file mode 100644 index 000000000..094a37ba9 --- /dev/null +++ b/tsconfig.base.json @@ -0,0 +1,29 @@ +{ + "compileOnSave": false, + "compilerOptions": { + "allowSyntheticDefaultImports": true, + "baseUrl": "./", + "outDir": "./dist", + "sourceMap": true, + "declaration": false, + "downlevelIteration": true, + "emitDecoratorMetadata": true, + "experimentalDecorators": true, + "module": "esnext", + "moduleResolution": "node", + "importHelpers": true, + "target": "es2020", + "skipLibCheck": true, + "typeRoots": [ + "node_modules/@types" + ], + "lib": [ + "es2018", + "dom" + ], + "paths": { + "@angular/fire": ["dist/packages-dist"], + "@angular/fire/*": ["dist/packages-dist/*"] + } + } + } diff --git a/tsconfig.build.json b/tsconfig.build.json new file mode 100644 index 000000000..f9f1e42f4 --- /dev/null +++ b/tsconfig.build.json @@ -0,0 +1,16 @@ +{ + "files": [ + "tools/build.ts" + ], + "compilerOptions": { + "outDir": "tools", + "skipLibCheck": true, + "lib": ["es2019", "dom"], + "module": "commonjs", + "target": "ES2020", + "plugins": [ + { "transform": "ts-transformer-keys/transformer" } + ], + "baseUrl": "./" + } +} \ No newline at end of file diff --git a/tsconfig.jasmine.json b/tsconfig.jasmine.json new file mode 100644 index 000000000..49cf3de0a --- /dev/null +++ b/tsconfig.jasmine.json @@ -0,0 +1,23 @@ +{ + "extends": "./tsconfig.base.json", + "compilerOptions": { + "outDir": "dist/out-tsc/jasmine", + "module": "commonjs", + "target": "es2015", + "allowJs": true, + "resolveJsonModule": true, + "esModuleInterop": true, + "types": [ + "jasmine", + "node" + ] + }, + "include": [ + "tools/jasmine.ts", + "src/**/*.jasmine.ts", + // Not sure what is wrong here, but since upgrading karma it's fallen apart + // "src/**/*.spec.ts", + "src/**/*.d.ts", + "node_modules/zone.js/zone.d.ts" + ] + } diff --git a/tsconfig.json b/tsconfig.json index b501cc6d1..2e77c7fb3 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -1,31 +1,24 @@ { + "extends": "./tsconfig.base.json", "compilerOptions": { - "experimentalDecorators": true, - "emitDecoratorMetadata": true, - "module": "es2015", - "target": "es5", - "noImplicitAny": false, - "outDir": "dist", - "rootDir": "src", - "sourceMap": true, - "inlineSources": true, + "outDir": "dist/out-tsc/lib", + "target": "es2015", "declaration": true, - "removeComments": true, - "lib": [ - "es2015", - "dom" + "inlineSources": true, + "declarationMap": false, + "types": [ + "node" ], - "skipLibCheck": true, - "moduleResolution": "node" + "lib": [ + "dom", + "es2018" + ] }, - "files": [ - "src/test-root.ts", - "src/auth.ts", - "src/database.ts", - "node_modules/zone.js/dist/zone.js.d.ts" - ], "angularCompilerOptions": { - "skipTemplateCodegen": true, - "strictMetadataEmit": true - } + "compilationMode": "partial" + }, + "exclude": [ + "src/test.ts", + "src/**/*.spec.ts" + ] } diff --git a/tsconfig.publish.es6.json b/tsconfig.publish.es6.json deleted file mode 100644 index cc9de2092..000000000 --- a/tsconfig.publish.es6.json +++ /dev/null @@ -1,31 +0,0 @@ -{ - "compilerOptions": { - "experimentalDecorators": true, - "emitDecoratorMetadata": true, - "module": "es2015", - "target": "es5", - "noImplicitAny": false, - "outDir": "dist", - "rootDir": "src", - "sourceMap": true, - "inlineSources": true, - "declaration": true, - "removeComments": true, - "lib": [ - "es2015", - "dom" - ], - "skipLibCheck": true, - "moduleResolution": "node" - }, - "files": [ - "src/index.ts", - "src/auth.ts", - "src/database.ts", - "node_modules/zone.js/dist/zone.js.d.ts" - ], - "angularCompilerOptions": { - "skipTemplateCodegen": true, - "strictMetadataEmit": true - } -} diff --git a/tsconfig.spec.json b/tsconfig.spec.json new file mode 100644 index 000000000..ece5ab4f5 --- /dev/null +++ b/tsconfig.spec.json @@ -0,0 +1,19 @@ +{ + "extends": "./tsconfig.base.json", + "compilerOptions": { + "outDir": "dist/out-tsc/spec", + "types": [ + "jasmine", + "node" + ] + }, + "files": [ + "src/test.ts" + ], + "include": [ + "src/**/*.spec.ts", + "src/**/*.d.ts", + "node_modules/zone.js/zone.d.ts" + ] + } + \ No newline at end of file diff --git a/typedoc.json b/typedoc.json new file mode 100644 index 000000000..b35aa55cd --- /dev/null +++ b/typedoc.json @@ -0,0 +1,11 @@ +{ + "tsconfig": "./tsconfig.json", + "ignoreCompilerErrors": true, + "mode": "modules", + "excludeExternals": true, + "excludeNotExported": true, + "excludePrivate": true, + "excludeProtected": true, + "includeDeclarations": true, + "disableOutputCheck": true +} \ No newline at end of file diff --git a/yarn.lock b/yarn.lock deleted file mode 100644 index 0ae5a8224..000000000 --- a/yarn.lock +++ /dev/null @@ -1,4943 +0,0 @@ -# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY. -# yarn lockfile v1 -"@angular/common@^2.0.0": - version "2.1.2" - resolved "https://registry.npmjs.org/@angular/common/-/common-2.1.2.tgz#5c5b37c21d6e573def1670f43962c262bc9be82e" - -"@angular/compiler-cli@^2.0.0": - version "2.1.2" - resolved "https://registry.npmjs.org/@angular/compiler-cli/-/compiler-cli-2.1.2.tgz#9c34433af2183f294b9c63a035c785e002edc792" - dependencies: - "@angular/tsc-wrapped" "^0.3.0" - minimist "^1.2.0" - reflect-metadata "^0.1.2" - -"@angular/compiler@^2.0.0": - version "2.1.2" - resolved "https://registry.npmjs.org/@angular/compiler/-/compiler-2.1.2.tgz#bd2a6c558de5350bdd43aa8e8de757943ac01d2a" - -"@angular/core@^2.0.0": - version "2.1.2" - resolved "https://registry.npmjs.org/@angular/core/-/core-2.1.2.tgz#ce39521643f3d97bc5923d5a7aa76604e973dac8" - -"@angular/platform-browser-dynamic@^2.0.0": - version "2.1.2" - resolved "https://registry.npmjs.org/@angular/platform-browser-dynamic/-/platform-browser-dynamic-2.1.2.tgz#3d51b494cfe0a29354c8c1f28369883679982af4" - -"@angular/platform-browser@^2.0.0": - version "2.1.2" - resolved "https://registry.npmjs.org/@angular/platform-browser/-/platform-browser-2.1.2.tgz#1f07c3a5668ac2381a7324f9001521deede159bc" - -"@angular/platform-server@^2.0.0-rc.5": - version "2.1.2" - resolved "https://registry.npmjs.org/@angular/platform-server/-/platform-server-2.1.2.tgz#31345f76a055713d418cf4c525f6a1915638500b" - dependencies: - parse5 "^2.2.1" - -"@angular/tsc-wrapped@^0.3.0": - version "0.3.0" - resolved "https://registry.npmjs.org/@angular/tsc-wrapped/-/tsc-wrapped-0.3.0.tgz#98cdeb5c38d145b187c0ad0397a8d98b217f33f2" - dependencies: - tsickle "^0.1.7" - -"@types/form-data@0.0.*": - version "0.0.32" - resolved "https://registry.npmjs.org/@types/form-data/-/form-data-0.0.32.tgz#218134515d38929524ff562ba1c6ce93981f3a45" - -"@types/jasmine@^2.5.36": - version "2.5.36" - resolved "https://registry.npmjs.org/@types/jasmine/-/jasmine-2.5.36.tgz#6d804b79a57e9380d766a2680e9362c17d9556d2" - -"@types/node@6.0.*": - version "6.0.46" - resolved "https://registry.npmjs.org/@types/node/-/node-6.0.46.tgz#8d9e48572831f05b11cc4c793754d43437219d62" - -"@types/request@0.0.30": - version "0.0.30" - resolved "https://registry.npmjs.org/@types/request/-/request-0.0.30.tgz#18208841a0cf6538eff5e306bfa92e86c8c8acae" - dependencies: - "@types/form-data" "0.0.*" - "@types/node" "6.0.*" - -abbrev@1: - version "1.0.9" - resolved "https://registry.npmjs.org/abbrev/-/abbrev-1.0.9.tgz#91b4792588a7738c25f35dd6f63752a2f8776135" - -accepts@1.3.3: - version "1.3.3" - resolved "https://registry.npmjs.org/accepts/-/accepts-1.3.3.tgz#c3ca7434938648c3e0d9c1e328dd68b622c284ca" - dependencies: - mime-types "~2.1.11" - negotiator "0.6.1" - -add-stream@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/add-stream/-/add-stream-1.0.0.tgz#6a7990437ca736d5e1288db92bd3266d5f5cb2aa" - -adm-zip@0.4.4: - version "0.4.4" - resolved "https://registry.npmjs.org/adm-zip/-/adm-zip-0.4.4.tgz#a61ed5ae6905c3aea58b3a657d25033091052736" - -after@0.8.1: - version "0.8.1" - resolved "https://registry.npmjs.org/after/-/after-0.8.1.tgz#ab5d4fb883f596816d3515f8f791c0af486dd627" - -agent-base@2: - version "2.0.1" - resolved "https://registry.npmjs.org/agent-base/-/agent-base-2.0.1.tgz#bd8f9e86a8eb221fffa07bd14befd55df142815e" - dependencies: - extend "~3.0.0" - semver "~5.0.1" - -align-text@^0.1.1, align-text@^0.1.3: - version "0.1.4" - resolved "https://registry.npmjs.org/align-text/-/align-text-0.1.4.tgz#0cd90a561093f35d0a99256c22b7069433fad117" - dependencies: - kind-of "^3.0.2" - longest "^1.0.1" - repeat-string "^1.5.2" - -amdefine@>=0.0.4: - version "1.0.0" - resolved "https://registry.npmjs.org/amdefine/-/amdefine-1.0.0.tgz#fd17474700cb5cc9c2b709f0be9d23ce3c198c33" - -ansi-align@^1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/ansi-align/-/ansi-align-1.1.0.tgz#2f0c1658829739add5ebb15e6b0c6e3423f016ba" - dependencies: - string-width "^1.0.1" - -ansi-escapes@^1.0.0: - version "1.4.0" - resolved "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-1.4.0.tgz#d3a8a83b319aa67793662b13e761c7911422306e" - -ansi-regex@^0.2.0, ansi-regex@^0.2.1: - version "0.2.1" - resolved "https://registry.npmjs.org/ansi-regex/-/ansi-regex-0.2.1.tgz#0d8e946967a3d8143f93e24e298525fc1b2235f9" - -ansi-regex@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/ansi-regex/-/ansi-regex-2.0.0.tgz#c5061b6e0ef8a81775e50f5d66151bf6bf371107" - -ansi-styles@^1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/ansi-styles/-/ansi-styles-1.1.0.tgz#eaecbf66cd706882760b2f4691582b8f55d7a7de" - -ansi-styles@^2.2.1: - version "2.2.1" - resolved "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz#b432dd3358b634cf75e1e4664368240533c1ddbe" - -any-promise@^1.0.0, any-promise@^1.1.0, any-promise@^1.3.0: - version "1.3.0" - resolved "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz#abc6afeedcea52e809cdc0376aed3ce39635d17f" - -anymatch@^1.3.0: - version "1.3.0" - resolved "https://registry.npmjs.org/anymatch/-/anymatch-1.3.0.tgz#a3e52fa39168c825ff57b0248126ce5a8ff95507" - dependencies: - arrify "^1.0.0" - micromatch "^2.1.5" - -aproba@^1.0.3: - version "1.0.4" - resolved "https://registry.npmjs.org/aproba/-/aproba-1.0.4.tgz#2713680775e7614c8ba186c065d4e2e52d1072c0" - -archy@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/archy/-/archy-1.0.0.tgz#f9c8c13757cc1dd7bc379ac77b2c62a5c2868c40" - -are-we-there-yet@~1.1.2: - version "1.1.2" - resolved "https://registry.npmjs.org/are-we-there-yet/-/are-we-there-yet-1.1.2.tgz#80e470e95a084794fe1899262c5667c6e88de1b3" - dependencies: - delegates "^1.0.0" - readable-stream "^2.0.0 || ^1.1.13" - -argparse@^1.0.7: - version "1.0.9" - resolved "https://registry.npmjs.org/argparse/-/argparse-1.0.9.tgz#73d83bc263f86e97f8cc4f6bae1b0e90a7d22c86" - dependencies: - sprintf-js "~1.0.2" - -arr-diff@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/arr-diff/-/arr-diff-2.0.0.tgz#8f3b827f955a8bd669697e4a4256ac3ceae356cf" - dependencies: - arr-flatten "^1.0.1" - -arr-flatten@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/arr-flatten/-/arr-flatten-1.0.1.tgz#e5ffe54d45e19f32f216e91eb99c8ce892bb604b" - -array-differ@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/array-differ/-/array-differ-1.0.0.tgz#eff52e3758249d33be402b8bb8e564bb2b5d4031" - -array-find-index@^1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/array-find-index/-/array-find-index-1.0.2.tgz#df010aa1287e164bbda6f9723b0a96a1ec4187a1" - -array-ify@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/array-ify/-/array-ify-1.0.0.tgz#9e528762b4a9066ad163a6962a364418e9626ece" - -array-slice@^0.2.3: - version "0.2.3" - resolved "https://registry.npmjs.org/array-slice/-/array-slice-0.2.3.tgz#dd3cfb80ed7973a75117cdac69b0b99ec86186f5" - -array-uniq@^1.0.2: - version "1.0.3" - resolved "https://registry.npmjs.org/array-uniq/-/array-uniq-1.0.3.tgz#af6ac877a25cc7f74e058894753858dfdb24fdb6" - -array-unique@^0.2.1: - version "0.2.1" - resolved "https://registry.npmjs.org/array-unique/-/array-unique-0.2.1.tgz#a1d97ccafcbc2625cc70fadceb36a50c58b01a53" - -arraybuffer.slice@0.0.6: - version "0.0.6" - resolved "https://registry.npmjs.org/arraybuffer.slice/-/arraybuffer.slice-0.0.6.tgz#f33b2159f0532a3f3107a272c0ccfbd1ad2979ca" - -arrify@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/arrify/-/arrify-1.0.1.tgz#898508da2226f380df904728456849c1501a4b0d" - -asn1@~0.2.3: - version "0.2.3" - resolved "https://registry.npmjs.org/asn1/-/asn1-0.2.3.tgz#dac8787713c9966849fc8180777ebe9c1ddf3b86" - -asn1@0.1.11: - version "0.1.11" - resolved "https://registry.npmjs.org/asn1/-/asn1-0.1.11.tgz#559be18376d08a4ec4dbe80877d27818639b2df7" - -assert-plus@^0.1.5: - version "0.1.5" - resolved "https://registry.npmjs.org/assert-plus/-/assert-plus-0.1.5.tgz#ee74009413002d84cec7219c6ac811812e723160" - -assert-plus@^0.2.0: - version "0.2.0" - resolved "https://registry.npmjs.org/assert-plus/-/assert-plus-0.2.0.tgz#d74e1b87e7affc0db8aadb7021f3fe48101ab234" - -assert-plus@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/assert-plus/-/assert-plus-1.0.0.tgz#f12e0f3c5d77b0b1cdd9146942e4e96c1e4dd525" - -assertion-error@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/assertion-error/-/assertion-error-1.0.2.tgz#13ca515d86206da0bac66e834dd397d87581094c" - -assertion-error@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/assertion-error/-/assertion-error-1.0.0.tgz#c7f85438fdd466bc7ca16ab90c81513797a5d23b" - -async-each@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/async-each/-/async-each-1.0.1.tgz#19d386a1d9edc6e7c1c85d388aedbcc56d33602d" - -async@^1.4.0: - version "1.5.2" - resolved "https://registry.npmjs.org/async/-/async-1.5.2.tgz#ec6a61ae56480c0c3cb241c95618e20892f9672a" - -async@~0.2.6, async@0.2.x: - version "0.2.10" - resolved "https://registry.npmjs.org/async/-/async-0.2.10.tgz#b6bbe0b0674b9d719708ca38de8c237cb526c3d1" - -async@~0.9.0: - version "0.9.2" - resolved "https://registry.npmjs.org/async/-/async-0.9.2.tgz#aea74d5e61c1f899613bf64bda66d4c78f2fd17d" - -async@0.9.0: - version "0.9.0" - resolved "https://registry.npmjs.org/async/-/async-0.9.0.tgz#ac3613b1da9bed1b47510bb4651b8931e47146c7" - -asynckit@^0.4.0: - version "0.4.0" - resolved "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz#c79ed97f7f34cb8f2ba1bc9790bcc366474b4b79" - -aws-sign2@~0.5.0: - version "0.5.0" - resolved "https://registry.npmjs.org/aws-sign2/-/aws-sign2-0.5.0.tgz#c57103f7a17fc037f02d7c2e64b602ea223f7d63" - -aws-sign2@~0.6.0: - version "0.6.0" - resolved "https://registry.npmjs.org/aws-sign2/-/aws-sign2-0.6.0.tgz#14342dd38dbcc94d0e5b87d763cd63612c0e794f" - -aws4@^1.2.1: - version "1.5.0" - resolved "https://registry.npmjs.org/aws4/-/aws4-1.5.0.tgz#0a29ffb79c31c9e712eeb087e8e7a64b4a56d755" - -babel-code-frame@^6.16.0: - version "6.16.0" - resolved "https://registry.npmjs.org/babel-code-frame/-/babel-code-frame-6.16.0.tgz#f90e60da0862909d3ce098733b5d3987c97cb8de" - dependencies: - chalk "^1.1.0" - esutils "^2.0.2" - js-tokens "^2.0.0" - -babel-core@^6.18.0, babel-core@^6.9.0: - version "6.18.0" - resolved "https://registry.npmjs.org/babel-core/-/babel-core-6.18.0.tgz#bb5ce9bc0a956e6e94e2f12d597abb3b0b330deb" - dependencies: - babel-code-frame "^6.16.0" - babel-generator "^6.18.0" - babel-helpers "^6.16.0" - babel-messages "^6.8.0" - babel-register "^6.18.0" - babel-runtime "^6.9.1" - babel-template "^6.16.0" - babel-traverse "^6.18.0" - babel-types "^6.18.0" - babylon "^6.11.0" - convert-source-map "^1.1.0" - debug "^2.1.1" - json5 "^0.5.0" - lodash "^4.2.0" - minimatch "^3.0.2" - path-is-absolute "^1.0.0" - private "^0.1.6" - slash "^1.0.0" - source-map "^0.5.0" - -babel-generator@^6.18.0: - version "6.18.0" - resolved "https://registry.npmjs.org/babel-generator/-/babel-generator-6.18.0.tgz#e4f104cb3063996d9850556a45aae4a022060a07" - dependencies: - babel-messages "^6.8.0" - babel-runtime "^6.9.0" - babel-types "^6.18.0" - detect-indent "^4.0.0" - jsesc "^1.3.0" - lodash "^4.2.0" - source-map "^0.5.0" - -babel-helper-hoist-variables@^6.18.0: - version "6.18.0" - resolved "https://registry.npmjs.org/babel-helper-hoist-variables/-/babel-helper-hoist-variables-6.18.0.tgz#a835b5ab8b46d6de9babefae4d98ea41e866b82a" - dependencies: - babel-runtime "^6.0.0" - babel-types "^6.18.0" - -babel-helpers@^6.16.0: - version "6.16.0" - resolved "https://registry.npmjs.org/babel-helpers/-/babel-helpers-6.16.0.tgz#1095ec10d99279460553e67eb3eee9973d3867e3" - dependencies: - babel-runtime "^6.0.0" - babel-template "^6.16.0" - -babel-messages@^6.8.0: - version "6.8.0" - resolved "https://registry.npmjs.org/babel-messages/-/babel-messages-6.8.0.tgz#bf504736ca967e6d65ef0adb5a2a5f947c8e0eb9" - dependencies: - babel-runtime "^6.0.0" - -babel-plugin-transform-cjs-system-require@^0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/babel-plugin-transform-cjs-system-require/-/babel-plugin-transform-cjs-system-require-0.1.1.tgz#ffef26d31bc270e82bdbbd437db2777e85162a29" - -babel-plugin-transform-cjs-system-wrapper@^0.2.1: - version "0.2.1" - resolved "https://registry.npmjs.org/babel-plugin-transform-cjs-system-wrapper/-/babel-plugin-transform-cjs-system-wrapper-0.2.1.tgz#e855078877b56d4d1b92b9f91b37f599db0200e3" - dependencies: - babel-plugin-transform-cjs-system-require "^0.1.1" - babel-template "^6.9.0" - -babel-plugin-transform-es2015-modules-systemjs@^6.6.5: - version "6.18.0" - resolved "https://registry.npmjs.org/babel-plugin-transform-es2015-modules-systemjs/-/babel-plugin-transform-es2015-modules-systemjs-6.18.0.tgz#f09294707163edae4d3b3e8bfacecd01d920b7ad" - dependencies: - babel-helper-hoist-variables "^6.18.0" - babel-runtime "^6.11.6" - babel-template "^6.14.0" - -babel-plugin-transform-global-system-wrapper@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/babel-plugin-transform-global-system-wrapper/-/babel-plugin-transform-global-system-wrapper-0.0.1.tgz#afb469cec0e04689b9fe7e8b1fd280fc94a6d8f2" - dependencies: - babel-template "^6.9.0" - -babel-plugin-transform-system-register@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/babel-plugin-transform-system-register/-/babel-plugin-transform-system-register-0.0.1.tgz#9dff40390c2763ac518f0b2ad7c5ea4f65a5be25" - -babel-register@^6.18.0: - version "6.18.0" - resolved "https://registry.npmjs.org/babel-register/-/babel-register-6.18.0.tgz#892e2e03865078dd90ad2c715111ec4449b32a68" - dependencies: - babel-core "^6.18.0" - babel-runtime "^6.11.6" - core-js "^2.4.0" - home-or-tmp "^2.0.0" - lodash "^4.2.0" - mkdirp "^0.5.1" - source-map-support "^0.4.2" - -babel-runtime@^6.0.0, babel-runtime@^6.11.6, babel-runtime@^6.9.0, babel-runtime@^6.9.1: - version "6.18.0" - resolved "https://registry.npmjs.org/babel-runtime/-/babel-runtime-6.18.0.tgz#0f4177ffd98492ef13b9f823e9994a02584c9078" - dependencies: - core-js "^2.4.0" - regenerator-runtime "^0.9.5" - -babel-template@^6.14.0, babel-template@^6.16.0, babel-template@^6.9.0: - version "6.16.0" - resolved "https://registry.npmjs.org/babel-template/-/babel-template-6.16.0.tgz#e149dd1a9f03a35f817ddbc4d0481988e7ebc8ca" - dependencies: - babel-runtime "^6.9.0" - babel-traverse "^6.16.0" - babel-types "^6.16.0" - babylon "^6.11.0" - lodash "^4.2.0" - -babel-traverse@^6.16.0, babel-traverse@^6.18.0: - version "6.18.0" - resolved "https://registry.npmjs.org/babel-traverse/-/babel-traverse-6.18.0.tgz#5aeaa980baed2a07c8c47329cd90c3b90c80f05e" - dependencies: - babel-code-frame "^6.16.0" - babel-messages "^6.8.0" - babel-runtime "^6.9.0" - babel-types "^6.18.0" - babylon "^6.11.0" - debug "^2.2.0" - globals "^9.0.0" - invariant "^2.2.0" - lodash "^4.2.0" - -babel-types@^6.16.0, babel-types@^6.18.0: - version "6.18.0" - resolved "https://registry.npmjs.org/babel-types/-/babel-types-6.18.0.tgz#1f7d5a73474c59eb9151b2417bbff4e4fce7c3f8" - dependencies: - babel-runtime "^6.9.1" - esutils "^2.0.2" - lodash "^4.2.0" - to-fast-properties "^1.0.1" - -babylon@^6.11.0: - version "6.13.1" - resolved "https://registry.npmjs.org/babylon/-/babylon-6.13.1.tgz#adca350e088f0467647157652bafead6ddb8dfdb" - -backo2@1.0.2: - version "1.0.2" - resolved "https://registry.npmjs.org/backo2/-/backo2-1.0.2.tgz#31ab1ac8b129363463e35b3ebb69f4dfcfba7947" - -balanced-match@^0.4.1: - version "0.4.2" - resolved "https://registry.npmjs.org/balanced-match/-/balanced-match-0.4.2.tgz#cb3f3e3c732dc0f01ee70b403f302e61d7709838" - -base64-arraybuffer@0.1.5: - version "0.1.5" - resolved "https://registry.npmjs.org/base64-arraybuffer/-/base64-arraybuffer-0.1.5.tgz#73926771923b5a19747ad666aa5cd4bf9c6e9ce8" - -base64-url@^1.2.1: - version "1.3.3" - resolved "https://registry.npmjs.org/base64-url/-/base64-url-1.3.3.tgz#f8b6c537f09a4fc58c99cb86e0b0e9c61461a20f" - -base64id@0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/base64id/-/base64id-0.1.0.tgz#02ce0fdeee0cef4f40080e1e73e834f0b1bfce3f" - -base64url@~1.0.4: - version "1.0.6" - resolved "https://registry.npmjs.org/base64url/-/base64url-1.0.6.tgz#d64d375d68a7c640d912e2358d170dca5bb54681" - dependencies: - concat-stream "~1.4.7" - meow "~2.0.0" - -batch@^0.5.3: - version "0.5.3" - resolved "https://registry.npmjs.org/batch/-/batch-0.5.3.tgz#3f3414f380321743bfc1042f9a83ff1d5824d464" - -bcrypt-pbkdf@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/bcrypt-pbkdf/-/bcrypt-pbkdf-1.0.0.tgz#3ca76b85241c7170bf7d9703e7b9aa74630040d4" - dependencies: - tweetnacl "^0.14.3" - -beeper@^1.0.0: - version "1.1.0" - resolved "https://registry.npmjs.org/beeper/-/beeper-1.1.0.tgz#9ee6fc1ce7f54feaace7ce73588b056037866a2c" - -benchmark@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/benchmark/-/benchmark-1.0.0.tgz#2f1e2fa4c359f11122aa183082218e957e390c73" - -better-assert@~1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/better-assert/-/better-assert-1.0.2.tgz#40866b9e1b9e0b55b481894311e68faffaebc522" - dependencies: - callsite "1.0.0" - -binary-extensions@^1.0.0: - version "1.7.0" - resolved "https://registry.npmjs.org/binary-extensions/-/binary-extensions-1.7.0.tgz#6c1610db163abfb34edfe42fa423343a1e01185d" - -bindings@1.2.x: - version "1.2.1" - resolved "https://registry.npmjs.org/bindings/-/bindings-1.2.1.tgz#14ad6113812d2d37d72e67b4cacb4bb726505f11" - -bl@^0.9.3, bl@~0.9.0: - version "0.9.5" - resolved "https://registry.npmjs.org/bl/-/bl-0.9.5.tgz#c06b797af085ea00bc527afc8efcf11de2232054" - dependencies: - readable-stream "~1.0.26" - -blob@0.0.4: - version "0.0.4" - resolved "https://registry.npmjs.org/blob/-/blob-0.0.4.tgz#bcf13052ca54463f30f9fc7e95b9a47630a94921" - -block-stream@*: - version "0.0.9" - resolved "https://registry.npmjs.org/block-stream/-/block-stream-0.0.9.tgz#13ebfe778a03205cfe03751481ebb4b3300c126a" - dependencies: - inherits "~2.0.0" - -bluebird@^2.9.27, bluebird@^2.9.30: - version "2.11.0" - resolved "https://registry.npmjs.org/bluebird/-/bluebird-2.11.0.tgz#534b9033c022c9579c56ba3b3e5a5caafbb650e1" - -bluebird@^3.1.1, bluebird@^3.3.4: - version "3.4.6" - resolved "https://registry.npmjs.org/bluebird/-/bluebird-3.4.6.tgz#01da8d821d87813d158967e743d5fe6c62cf8c0f" - -bluebird@~1.2.4: - version "1.2.4" - resolved "https://registry.npmjs.org/bluebird/-/bluebird-1.2.4.tgz#5985ec23cb6ff1a5834cc6447b3c5ef010fd321a" - -bluebird@2.9.6: - version "2.9.6" - resolved "https://registry.npmjs.org/bluebird/-/bluebird-2.9.6.tgz#1fc3a6b1685267dc121b5ec89b32ce069d81ab7d" - -body-parser@^1.12.4: - version "1.15.2" - resolved "https://registry.npmjs.org/body-parser/-/body-parser-1.15.2.tgz#d7578cf4f1d11d5f6ea804cef35dc7a7ff6dae67" - dependencies: - bytes "2.4.0" - content-type "~1.0.2" - debug "~2.2.0" - depd "~1.1.0" - http-errors "~1.5.0" - iconv-lite "0.4.13" - on-finished "~2.3.0" - qs "6.2.0" - raw-body "~2.1.7" - type-is "~1.6.13" - -boom@2.x.x: - version "2.10.1" - resolved "https://registry.npmjs.org/boom/-/boom-2.10.1.tgz#39c8918ceff5799f83f9492a848f625add0c766f" - dependencies: - hoek "2.x.x" - -boxen@^0.6.0: - version "0.6.0" - resolved "https://registry.npmjs.org/boxen/-/boxen-0.6.0.tgz#8364d4248ac34ff0ef1b2f2bf49a6c60ce0d81b6" - dependencies: - ansi-align "^1.1.0" - camelcase "^2.1.0" - chalk "^1.1.1" - cli-boxes "^1.0.0" - filled-array "^1.0.0" - object-assign "^4.0.1" - repeating "^2.0.0" - string-width "^1.0.1" - widest-line "^1.0.0" - -brace-expansion@^1.0.0: - version "1.1.6" - resolved "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.6.tgz#7197d7eaa9b87e648390ea61fc66c84427420df9" - dependencies: - balanced-match "^0.4.1" - concat-map "0.0.1" - -braces@^0.1.2: - version "0.1.5" - resolved "https://registry.npmjs.org/braces/-/braces-0.1.5.tgz#c085711085291d8b75fdd74eab0f8597280711e6" - dependencies: - expand-range "^0.1.0" - -braces@^1.8.2: - version "1.8.5" - resolved "https://registry.npmjs.org/braces/-/braces-1.8.5.tgz#ba77962e12dff969d6b76711e914b737857bf6a7" - dependencies: - expand-range "^1.8.1" - preserve "^0.2.0" - repeat-element "^1.1.2" - -buffer-equal-constant-time@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz#f8e71132f7ffe6e01a5c9697a4c6f3e48d5cc819" - -buffer-shims@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/buffer-shims/-/buffer-shims-1.0.0.tgz#9978ce317388c649ad8793028c3477ef044a8b51" - -bufferutil@1.2.x: - version "1.2.1" - resolved "https://registry.npmjs.org/bufferutil/-/bufferutil-1.2.1.tgz#37be5d36e1e06492221e68d474b1ac58e510cbd7" - dependencies: - bindings "1.2.x" - nan "^2.0.5" - -builtin-modules@^1.0.0: - version "1.1.1" - resolved "https://registry.npmjs.org/builtin-modules/-/builtin-modules-1.1.1.tgz#270f076c5a72c02f5b65a47df94c5fe3a278892f" - -bytes@2.4.0: - version "2.4.0" - resolved "https://registry.npmjs.org/bytes/-/bytes-2.4.0.tgz#7d97196f9d5baf7f6935e25985549edd2a6c2339" - -callsite@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/callsite/-/callsite-1.0.0.tgz#280398e5d664bd74038b6f0905153e6e8af1bc20" - -camelcase-keys@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-1.0.0.tgz#bd1a11bf9b31a1ce493493a930de1a0baf4ad7ec" - dependencies: - camelcase "^1.0.1" - map-obj "^1.0.0" - -camelcase-keys@^2.0.0: - version "2.1.0" - resolved "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz#308beeaffdf28119051efa1d932213c91b8f92e7" - dependencies: - camelcase "^2.0.0" - map-obj "^1.0.0" - -camelcase@^1.0.1, camelcase@^1.0.2: - version "1.2.1" - resolved "https://registry.npmjs.org/camelcase/-/camelcase-1.2.1.tgz#9bb5304d2e0b56698b2c758b08a3eaa9daa58a39" - -camelcase@^2.0.0, camelcase@^2.1.0: - version "2.1.1" - resolved "https://registry.npmjs.org/camelcase/-/camelcase-2.1.1.tgz#7c1d16d679a1bbe59ca02cacecfb011e201f5a1f" - -capture-stack-trace@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/capture-stack-trace/-/capture-stack-trace-1.0.0.tgz#4a6fa07399c26bba47f0b2496b4d0fb408c5550d" - -caseless@~0.10.0: - version "0.10.0" - resolved "https://registry.npmjs.org/caseless/-/caseless-0.10.0.tgz#ed6b2719adcd1fd18f58dc081c0f1a5b43963909" - -caseless@~0.11.0: - version "0.11.0" - resolved "https://registry.npmjs.org/caseless/-/caseless-0.11.0.tgz#715b96ea9841593cc33067923f5ec60ebda4f7d7" - -center-align@^0.1.1: - version "0.1.3" - resolved "https://registry.npmjs.org/center-align/-/center-align-0.1.3.tgz#aa0d32629b6ee972200411cbd4461c907bc2b7ad" - dependencies: - align-text "^0.1.3" - lazy-cache "^1.0.3" - -chalk@^0.5.1, chalk@0.5.1: - version "0.5.1" - resolved "https://registry.npmjs.org/chalk/-/chalk-0.5.1.tgz#663b3a648b68b55d04690d49167aa837858f2174" - dependencies: - ansi-styles "^1.1.0" - escape-string-regexp "^1.0.0" - has-ansi "^0.1.0" - strip-ansi "^0.3.0" - supports-color "^0.2.0" - -chalk@^1.0.0, chalk@^1.1.0, chalk@^1.1.1, chalk@1.1.3: - version "1.1.3" - resolved "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz#a8115c55e4a702fe4d150abd3872822a7e09fc98" - dependencies: - ansi-styles "^2.2.1" - escape-string-regexp "^1.0.2" - has-ansi "^2.0.0" - strip-ansi "^3.0.0" - supports-color "^2.0.0" - -chokidar@^1.4.1: - version "1.6.1" - resolved "https://registry.npmjs.org/chokidar/-/chokidar-1.6.1.tgz#2f4447ab5e96e50fb3d789fd90d4c72e0e4c70c2" - dependencies: - anymatch "^1.3.0" - async-each "^1.0.0" - glob-parent "^2.0.0" - inherits "^2.0.1" - is-binary-path "^1.0.0" - is-glob "^2.0.0" - path-is-absolute "^1.0.0" - readdirp "^2.0.0" - optionalDependencies: - fsevents "^1.0.0" - -cli-boxes@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/cli-boxes/-/cli-boxes-1.0.0.tgz#4fa917c3e59c94a004cd61f8ee509da651687143" - -cli-cursor@^1.0.2: - version "1.0.2" - resolved "https://registry.npmjs.org/cli-cursor/-/cli-cursor-1.0.2.tgz#64da3f7d56a54412e59794bd62dc35295e8f2987" - dependencies: - restore-cursor "^1.0.1" - -cli-table@^0.3.1: - version "0.3.1" - resolved "https://registry.npmjs.org/cli-table/-/cli-table-0.3.1.tgz#f53b05266a8b1a0b934b3d0821e6e2dc5914ae23" - dependencies: - colors "1.0.3" - -cli-truncate@^0.2.1: - version "0.2.1" - resolved "https://registry.npmjs.org/cli-truncate/-/cli-truncate-0.2.1.tgz#9f15cfbb0705005369216c626ac7d05ab90dd574" - dependencies: - slice-ansi "0.0.4" - string-width "^1.0.1" - -cli@^0.11.1: - version "0.11.3" - resolved "https://registry.npmjs.org/cli/-/cli-0.11.3.tgz#7b0cd3de990e452925667c0dbaffdc9f7f2a9a15" - dependencies: - exit "0.1.2" - glob "^7.0.5" - -cliui@^2.1.0: - version "2.1.0" - resolved "https://registry.npmjs.org/cliui/-/cliui-2.1.0.tgz#4b475760ff80264c762c3a1719032e91c7fea0d1" - dependencies: - center-align "^0.1.1" - right-align "^0.1.1" - wordwrap "0.0.2" - -clone-stats@^0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/clone-stats/-/clone-stats-0.0.1.tgz#b88f94a82cf38b8791d58046ea4029ad88ca99d1" - -clone@^0.2.0: - version "0.2.0" - resolved "https://registry.npmjs.org/clone/-/clone-0.2.0.tgz#c6126a90ad4f72dbf5acdb243cc37724fe93fc1f" - -clone@^1.0.0, clone@^1.0.2: - version "1.0.2" - resolved "https://registry.npmjs.org/clone/-/clone-1.0.2.tgz#260b7a99ebb1edfe247538175f783243cb19d149" - -code-point-at@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/code-point-at/-/code-point-at-1.0.1.tgz#1104cd34f9b5b45d3eba88f1babc1924e1ce35fb" - dependencies: - number-is-nan "^1.0.0" - -colors@^1.0.3, colors@^1.1.0: - version "1.1.2" - resolved "https://registry.npmjs.org/colors/-/colors-1.1.2.tgz#168a4701756b6a7f51a12ce0c97bfa28c084ed63" - -colors@1.0.3: - version "1.0.3" - resolved "https://registry.npmjs.org/colors/-/colors-1.0.3.tgz#0433f44d809680fdeb60ed260f1b0c262e82a40b" - -columnify@^1.5.2: - version "1.5.4" - resolved "https://registry.npmjs.org/columnify/-/columnify-1.5.4.tgz#4737ddf1c7b69a8a7c340570782e947eec8e78bb" - dependencies: - strip-ansi "^3.0.0" - wcwidth "^1.0.0" - -combined-stream@^1.0.5, combined-stream@~1.0.1, combined-stream@~1.0.5: - version "1.0.5" - resolved "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.5.tgz#938370a57b4a51dea2c77c15d5c5fdf895164009" - dependencies: - delayed-stream "~1.0.0" - -combined-stream@~0.0.4: - version "0.0.7" - resolved "https://registry.npmjs.org/combined-stream/-/combined-stream-0.0.7.tgz#0137e657baa5a7541c57ac37ac5fc07d73b4dc1f" - dependencies: - delayed-stream "0.0.5" - -commander@^2.8.1, commander@^2.9.0, commander@2.9.x: - version "2.9.0" - resolved "https://registry.npmjs.org/commander/-/commander-2.9.0.tgz#9c99094176e12240cb22d6c5146098400fe0f7d4" - dependencies: - graceful-readlink ">= 1.0.0" - -commander@2.6, commander@2.6.0: - version "2.6.0" - resolved "https://registry.npmjs.org/commander/-/commander-2.6.0.tgz#9df7e52fb2a0cb0fb89058ee80c3104225f37e1d" - -compare-func@^1.3.1: - version "1.3.2" - resolved "https://registry.npmjs.org/compare-func/-/compare-func-1.3.2.tgz#99dd0ba457e1f9bc722b12c08ec33eeab31fa648" - dependencies: - array-ify "^1.0.0" - dot-prop "^3.0.0" - -component-bind@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/component-bind/-/component-bind-1.0.0.tgz#00c608ab7dcd93897c0009651b1d3a8e1e73bbd1" - -component-emitter@1.1.2: - version "1.1.2" - resolved "https://registry.npmjs.org/component-emitter/-/component-emitter-1.1.2.tgz#296594f2753daa63996d2af08d15a95116c9aec3" - -component-emitter@1.2.0: - version "1.2.0" - resolved "https://registry.npmjs.org/component-emitter/-/component-emitter-1.2.0.tgz#ccd113a86388d06482d03de3fc7df98526ba8efe" - -component-inherit@0.0.3: - version "0.0.3" - resolved "https://registry.npmjs.org/component-inherit/-/component-inherit-0.0.3.tgz#645fc4adf58b72b649d5cae65135619db26ff143" - -concat-map@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz#d8a96bd77fd68df7793a73036a3ba0d5405d477b" - -concat-stream@^1.4.7: - version "1.5.2" - resolved "https://registry.npmjs.org/concat-stream/-/concat-stream-1.5.2.tgz#708978624d856af41a5a741defdd261da752c266" - dependencies: - inherits "~2.0.1" - readable-stream "~2.0.0" - typedarray "~0.0.5" - -concat-stream@~1.4.7: - version "1.4.10" - resolved "https://registry.npmjs.org/concat-stream/-/concat-stream-1.4.10.tgz#acc3bbf5602cb8cc980c6ac840fa7d8603e3ef36" - dependencies: - inherits "~2.0.1" - readable-stream "~1.1.9" - typedarray "~0.0.5" - -concurrently@^2.2.0: - version "2.2.0" - resolved "https://registry.npmjs.org/concurrently/-/concurrently-2.2.0.tgz#bad248e0bb129fb1621768903a6311d45d56895a" - dependencies: - bluebird "2.9.6" - chalk "0.5.1" - commander "2.6.0" - cross-spawn "^0.2.9" - lodash "^4.5.1" - moment "^2.11.2" - rx "2.3.24" - -configstore@^0.3.1: - version "0.3.2" - resolved "https://registry.npmjs.org/configstore/-/configstore-0.3.2.tgz#25e4c16c3768abf75c5a65bc61761f495055b459" - dependencies: - graceful-fs "^3.0.1" - js-yaml "^3.1.0" - mkdirp "^0.5.0" - object-assign "^2.0.0" - osenv "^0.1.0" - user-home "^1.0.0" - uuid "^2.0.1" - xdg-basedir "^1.0.0" - -configstore@^2.0.0: - version "2.1.0" - resolved "https://registry.npmjs.org/configstore/-/configstore-2.1.0.tgz#737a3a7036e9886102aa6099e47bb33ab1aba1a1" - dependencies: - dot-prop "^3.0.0" - graceful-fs "^4.1.2" - mkdirp "^0.5.0" - object-assign "^4.0.1" - os-tmpdir "^1.0.0" - osenv "^0.1.0" - uuid "^2.0.1" - write-file-atomic "^1.1.2" - xdg-basedir "^2.0.0" - -connect@^3.3.5: - version "3.5.0" - resolved "https://registry.npmjs.org/connect/-/connect-3.5.0.tgz#b357525a0b4c1f50599cd983e1d9efeea9677198" - dependencies: - debug "~2.2.0" - finalhandler "0.5.0" - parseurl "~1.3.1" - utils-merge "1.0.0" - -console-control-strings@^1.0.0, console-control-strings@~1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/console-control-strings/-/console-control-strings-1.1.0.tgz#3d7cf4464db6446ea644bf4b39507f9851008e8e" - -content-type@~1.0.2: - version "1.0.2" - resolved "https://registry.npmjs.org/content-type/-/content-type-1.0.2.tgz#b7d113aee7a8dd27bd21133c4dc2529df1721eed" - -conventional-changelog-angular@^1.0.0: - version "1.3.0" - resolved "https://registry.npmjs.org/conventional-changelog-angular/-/conventional-changelog-angular-1.3.0.tgz#3f64185978aa13ab0954c9e46a78969fd59c6801" - dependencies: - compare-func "^1.3.1" - github-url-from-git "^1.4.0" - q "^1.4.1" - -conventional-changelog-atom@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/conventional-changelog-atom/-/conventional-changelog-atom-0.1.0.tgz#67a47c66a42b2f8909ef1587c9989ae1de730b92" - dependencies: - q "^1.4.1" - -conventional-changelog-cli@^1.2.0: - version "1.2.0" - resolved "https://registry.npmjs.org/conventional-changelog-cli/-/conventional-changelog-cli-1.2.0.tgz#c4929dcdb5d5ba9aa1840418e6b4674691193f5d" - dependencies: - add-stream "^1.0.0" - conventional-changelog "^1.1.0" - lodash "^4.1.0" - meow "^3.7.0" - tempfile "^1.1.1" - -conventional-changelog-codemirror@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/conventional-changelog-codemirror/-/conventional-changelog-codemirror-0.1.0.tgz#7577a591dbf9b538e7a150a7ee62f65a2872b334" - dependencies: - q "^1.4.1" - -conventional-changelog-core@^1.3.0: - version "1.5.0" - resolved "https://registry.npmjs.org/conventional-changelog-core/-/conventional-changelog-core-1.5.0.tgz#72b17509535a23d7c6cb70ad4384f74247748013" - dependencies: - conventional-changelog-writer "^1.1.0" - conventional-commits-parser "^1.0.0" - dateformat "^1.0.12" - get-pkg-repo "^1.0.0" - git-raw-commits "^1.1.0" - git-remote-origin-url "^2.0.0" - git-semver-tags "^1.1.0" - lodash "^4.0.0" - normalize-package-data "^2.3.5" - q "^1.4.1" - read-pkg "^1.1.0" - read-pkg-up "^1.0.1" - through2 "^2.0.0" - -conventional-changelog-ember@^0.2.0: - version "0.2.2" - resolved "https://registry.npmjs.org/conventional-changelog-ember/-/conventional-changelog-ember-0.2.2.tgz#bad70a891386bc3046484a8f4f1e5aa2dc0ad208" - dependencies: - q "^1.4.1" - -conventional-changelog-eslint@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/conventional-changelog-eslint/-/conventional-changelog-eslint-0.1.0.tgz#a52411e999e0501ce500b856b0a643d0330907e2" - dependencies: - q "^1.4.1" - -conventional-changelog-express@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/conventional-changelog-express/-/conventional-changelog-express-0.1.0.tgz#55c6c841c811962036c037bdbd964a54ae310fce" - dependencies: - q "^1.4.1" - -conventional-changelog-jquery@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/conventional-changelog-jquery/-/conventional-changelog-jquery-0.1.0.tgz#0208397162e3846986e71273b6c79c5b5f80f510" - dependencies: - q "^1.4.1" - -conventional-changelog-jscs@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/conventional-changelog-jscs/-/conventional-changelog-jscs-0.1.0.tgz#0479eb443cc7d72c58bf0bcf0ef1d444a92f0e5c" - dependencies: - q "^1.4.1" - -conventional-changelog-jshint@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/conventional-changelog-jshint/-/conventional-changelog-jshint-0.1.0.tgz#00cab8e9a3317487abd94c4d84671342918d2a07" - dependencies: - compare-func "^1.3.1" - q "^1.4.1" - -conventional-changelog-writer@^1.1.0: - version "1.4.1" - resolved "https://registry.npmjs.org/conventional-changelog-writer/-/conventional-changelog-writer-1.4.1.tgz#3f4cb4d003ebb56989d30d345893b52a43639c8e" - dependencies: - compare-func "^1.3.1" - conventional-commits-filter "^1.0.0" - dateformat "^1.0.11" - handlebars "^4.0.2" - json-stringify-safe "^5.0.1" - lodash "^4.0.0" - meow "^3.3.0" - semver "^5.0.1" - split "^1.0.0" - through2 "^2.0.0" - -conventional-changelog@^1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/conventional-changelog/-/conventional-changelog-1.1.0.tgz#8ae3fb59feb74bbee0a25833ee1f83dad4a07874" - dependencies: - conventional-changelog-angular "^1.0.0" - conventional-changelog-atom "^0.1.0" - conventional-changelog-codemirror "^0.1.0" - conventional-changelog-core "^1.3.0" - conventional-changelog-ember "^0.2.0" - conventional-changelog-eslint "^0.1.0" - conventional-changelog-express "^0.1.0" - conventional-changelog-jquery "^0.1.0" - conventional-changelog-jscs "^0.1.0" - conventional-changelog-jshint "^0.1.0" - -conventional-commits-filter@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/conventional-commits-filter/-/conventional-commits-filter-1.0.0.tgz#6fc2a659372bc3f2339cf9ffff7e1b0344b93039" - dependencies: - is-subset "^0.1.1" - modify-values "^1.0.0" - -conventional-commits-parser@^1.0.0: - version "1.3.0" - resolved "https://registry.npmjs.org/conventional-commits-parser/-/conventional-commits-parser-1.3.0.tgz#e327b53194e1a7ad5dc63479ee9099a52b024865" - dependencies: - is-text-path "^1.0.0" - JSONStream "^1.0.4" - lodash "^4.2.1" - meow "^3.3.0" - split2 "^2.0.0" - through2 "^2.0.0" - trim-off-newlines "^1.0.0" - -convert-source-map@^1.1.0, convert-source-map@^1.1.1: - version "1.3.0" - resolved "https://registry.npmjs.org/convert-source-map/-/convert-source-map-1.3.0.tgz#e9f3e9c6e2728efc2676696a70eb382f73106a67" - -core-js@^2.1.0, core-js@^2.4.0: - version "2.4.1" - resolved "https://registry.npmjs.org/core-js/-/core-js-2.4.1.tgz#4de911e667b0eae9124e34254b53aea6fc618d3e" - -core-util-is@~1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz#b5fd54220aa2bc5ab57aab7140c940754503c1a7" - -corser@~2.0.0: - version "2.0.1" - resolved "https://registry.npmjs.org/corser/-/corser-2.0.1.tgz#8eda252ecaab5840dcd975ceb90d9370c819ff87" - -create-error-class@^3.0.1: - version "3.0.2" - resolved "https://registry.npmjs.org/create-error-class/-/create-error-class-3.0.2.tgz#06be7abef947a3f14a30fd610671d401bca8b7b6" - dependencies: - capture-stack-trace "^1.0.0" - -cross-spawn@^0.2.9: - version "0.2.9" - resolved "https://registry.npmjs.org/cross-spawn/-/cross-spawn-0.2.9.tgz#bd67f96c07efb6303b7fe94c1e979f88478e0a39" - dependencies: - lru-cache "^2.5.0" - -cryptiles@2.x.x: - version "2.0.5" - resolved "https://registry.npmjs.org/cryptiles/-/cryptiles-2.0.5.tgz#3bdfecdc608147c1c67202fa291e7dca59eaa3b8" - dependencies: - boom "2.x.x" - -ctype@0.5.3: - version "0.5.3" - resolved "https://registry.npmjs.org/ctype/-/ctype-0.5.3.tgz#82c18c2461f74114ef16c135224ad0b9144ca12f" - -currently-unhandled@^0.4.1: - version "0.4.1" - resolved "https://registry.npmjs.org/currently-unhandled/-/currently-unhandled-0.4.1.tgz#988df33feab191ef799a61369dd76c17adf957ea" - dependencies: - array-find-index "^1.0.1" - -custom-event@~1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/custom-event/-/custom-event-1.0.1.tgz#5d02a46850adf1b4a317946a3928fccb5bfd0425" - -d@^0.1.1, d@~0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/d/-/d-0.1.1.tgz#da184c535d18d8ee7ba2aa229b914009fae11309" - dependencies: - es5-ext "~0.10.2" - -d@1: - version "1.0.0" - resolved "https://registry.npmjs.org/d/-/d-1.0.0.tgz#754bb5bfe55451da69a58b94d45f4c5b0462d58f" - dependencies: - es5-ext "^0.10.9" - -dargs@^4.0.1: - version "4.1.0" - resolved "https://registry.npmjs.org/dargs/-/dargs-4.1.0.tgz#03a9dbb4b5c2f139bf14ae53f0b8a2a6a86f4e17" - dependencies: - number-is-nan "^1.0.0" - -dashdash@^1.12.0: - version "1.14.0" - resolved "https://registry.npmjs.org/dashdash/-/dashdash-1.14.0.tgz#29e486c5418bf0f356034a993d51686a33e84141" - dependencies: - assert-plus "^1.0.0" - -data-uri-to-buffer@0.0.4: - version "0.0.4" - resolved "https://registry.npmjs.org/data-uri-to-buffer/-/data-uri-to-buffer-0.0.4.tgz#46e13ab9da8e309745c8d01ce547213ebdb2fe3f" - -dateformat@^1.0.11, dateformat@^1.0.12: - version "1.0.12" - resolved "https://registry.npmjs.org/dateformat/-/dateformat-1.0.12.tgz#9f124b67594c937ff706932e4a642cca8dbbfee9" - dependencies: - get-stdin "^4.0.1" - meow "^3.3.0" - -debug@^2.1.1, debug@^2.2.0, debug@~2.2.0, debug@2, debug@2.2.0: - version "2.2.0" - resolved "https://registry.npmjs.org/debug/-/debug-2.2.0.tgz#f87057e995b1a1f6ae6a4960664137bc56f039da" - dependencies: - ms "0.7.1" - -debug@0.7.4: - version "0.7.4" - resolved "https://registry.npmjs.org/debug/-/debug-0.7.4.tgz#06e1ea8082c2cb14e39806e22e2f6f757f92af39" - -decamelize@^1.0.0, decamelize@^1.1.2: - version "1.2.0" - resolved "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz#f6534d15148269b20352e7bee26f501f9a191290" - -deep-extend@~0.4.0: - version "0.4.1" - resolved "https://registry.npmjs.org/deep-extend/-/deep-extend-0.4.1.tgz#efe4113d08085f4e6f9687759810f807469e2253" - -deep-freeze@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/deep-freeze/-/deep-freeze-0.0.1.tgz#3a0b0005de18672819dfd38cd31f91179c893e84" - -defaults@^1.0.0, defaults@^1.0.3: - version "1.0.3" - resolved "https://registry.npmjs.org/defaults/-/defaults-1.0.3.tgz#c656051e9817d9ff08ed881477f3fe4019f3ef7d" - dependencies: - clone "^1.0.2" - -definition-header@~0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/definition-header/-/definition-header-0.1.0.tgz#01445ff4ca663114cbf2c5a1131f13bb544eb5dd" - dependencies: - joi "^4.0.0" - joi-assert "0.0.3" - parsimmon "^0.5.0" - xregexp "~2.0.0" - -delayed-stream@~1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz#df3ae199acadfb7d440aaae0b29e2272b24ec619" - -delayed-stream@0.0.5: - version "0.0.5" - resolved "https://registry.npmjs.org/delayed-stream/-/delayed-stream-0.0.5.tgz#d4b1f43a93e8296dfe02694f4680bc37a313c73f" - -delegates@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/delegates/-/delegates-1.0.0.tgz#84c6e159b81904fdca59a0ef44cd870d31250f9a" - -depd@~1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/depd/-/depd-1.1.0.tgz#e1bd82c6aab6ced965b97b88b17ed3e528ca18c3" - -deprecated@^0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/deprecated/-/deprecated-0.0.1.tgz#f9c9af5464afa1e7a971458a8bdef2aa94d5bb19" - -detect-file@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/detect-file/-/detect-file-0.1.0.tgz#4935dedfd9488648e006b0129566e9386711ea63" - dependencies: - fs-exists-sync "^0.1.0" - -detect-indent@^0.2.0: - version "0.2.0" - resolved "https://registry.npmjs.org/detect-indent/-/detect-indent-0.2.0.tgz#042914498979ac2d9f3c73e4ff3e6877d3bc92b6" - dependencies: - get-stdin "^0.1.0" - minimist "^0.1.0" - -detect-indent@^4.0.0: - version "4.0.0" - resolved "https://registry.npmjs.org/detect-indent/-/detect-indent-4.0.0.tgz#f76d064352cdf43a1cb6ce619c4ee3a9475de208" - dependencies: - repeating "^2.0.0" - -di@^0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/di/-/di-0.0.1.tgz#806649326ceaa7caa3306d75d985ea2748ba913c" - -diff@^1.4.0: - version "1.4.0" - resolved "https://registry.npmjs.org/diff/-/diff-1.4.0.tgz#7f28d2eb9ee7b15a97efd89ce63dcfdaa3ccbabf" - -dom-serialize@^2.2.0: - version "2.2.1" - resolved "https://registry.npmjs.org/dom-serialize/-/dom-serialize-2.2.1.tgz#562ae8999f44be5ea3076f5419dcd59eb43ac95b" - dependencies: - custom-event "~1.0.0" - ent "~2.2.0" - extend "^3.0.0" - void-elements "^2.0.0" - -dom-storage@2.0.2: - version "2.0.2" - resolved "https://registry.npmjs.org/dom-storage/-/dom-storage-2.0.2.tgz#ed17cbf68abd10e0aef8182713e297c5e4b500b0" - -dot-prop@^3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/dot-prop/-/dot-prop-3.0.0.tgz#1b708af094a49c9a0e7dbcad790aba539dac1177" - dependencies: - is-obj "^1.0.0" - -duplexer@~0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/duplexer/-/duplexer-0.1.1.tgz#ace6ff808c1ce66b57d1ebf97977acb02334cfc1" - -duplexer2@^0.1.4: - version "0.1.4" - resolved "https://registry.npmjs.org/duplexer2/-/duplexer2-0.1.4.tgz#8b12dab878c0d69e3e7891051662a32fc6bddcc1" - dependencies: - readable-stream "^2.0.2" - -duplexer2@0.0.2: - version "0.0.2" - resolved "https://registry.npmjs.org/duplexer2/-/duplexer2-0.0.2.tgz#c614dcf67e2fb14995a91711e5a617e8a60a31db" - dependencies: - readable-stream "~1.1.9" - -duplexify@^3.2.0: - version "3.5.0" - resolved "https://registry.npmjs.org/duplexify/-/duplexify-3.5.0.tgz#1aa773002e1578457e9d9d4a50b0ccaaebcbd604" - dependencies: - end-of-stream "1.0.0" - inherits "^2.0.1" - readable-stream "^2.0.0" - stream-shift "^1.0.0" - -ecc-jsbn@~0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/ecc-jsbn/-/ecc-jsbn-0.1.1.tgz#0fc73a9ed5f0d53c38193398523ef7e543777505" - dependencies: - jsbn "~0.1.0" - -ecdsa-sig-formatter@^1.0.0: - version "1.0.7" - resolved "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.7.tgz#3137e976a1d6232517e2513e04e32f79bcbdf126" - dependencies: - base64-url "^1.2.1" - -ecstatic@~0.7.0: - version "0.7.6" - resolved "https://registry.npmjs.org/ecstatic/-/ecstatic-0.7.6.tgz#cba2aabea46b8cd97f0160859713b70d28e6a022" - dependencies: - he "^0.5.0" - mime "^1.2.11" - minimist "^1.1.0" - url-join "0.0.1" - -ee-first@1.1.1: - version "1.1.1" - resolved "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz#590c61156b0ae2f4f0255732a158b266bc56b21d" - -elegant-spinner@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/elegant-spinner/-/elegant-spinner-1.0.1.tgz#db043521c95d7e303fd8f345bedc3349cfb0729e" - -end-of-stream@~0.1.5: - version "0.1.5" - resolved "https://registry.npmjs.org/end-of-stream/-/end-of-stream-0.1.5.tgz#8e177206c3c80837d85632e8b9359dfe8b2f6eaf" - dependencies: - once "~1.3.0" - -end-of-stream@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.0.0.tgz#d4596e702734a93e40e9af864319eabd99ff2f0e" - dependencies: - once "~1.3.0" - -engine.io-client@1.7.2: - version "1.7.2" - resolved "https://registry.npmjs.org/engine.io-client/-/engine.io-client-1.7.2.tgz#12f01d3d9d676908a86339cee067ff799a585c3d" - dependencies: - component-emitter "1.1.2" - component-inherit "0.0.3" - debug "2.2.0" - engine.io-parser "1.3.1" - has-cors "1.1.0" - indexof "0.0.1" - parsejson "0.0.1" - parseqs "0.0.2" - parseuri "0.0.4" - ws "1.1.1" - xmlhttprequest-ssl "1.5.1" - yeast "0.1.2" - -engine.io-parser@1.3.1: - version "1.3.1" - resolved "https://registry.npmjs.org/engine.io-parser/-/engine.io-parser-1.3.1.tgz#9554f1ae33107d6fbd170ca5466d2f833f6a07cf" - dependencies: - after "0.8.1" - arraybuffer.slice "0.0.6" - base64-arraybuffer "0.1.5" - blob "0.0.4" - has-binary "0.1.6" - wtf-8 "1.0.0" - -engine.io@1.7.2: - version "1.7.2" - resolved "https://registry.npmjs.org/engine.io/-/engine.io-1.7.2.tgz#877c14fa0486f8b664d46a8101bf74feef2e4e46" - dependencies: - accepts "1.3.3" - base64id "0.1.0" - debug "2.2.0" - engine.io-parser "1.3.1" - ws "1.1.1" - -ent@~2.2.0: - version "2.2.0" - resolved "https://registry.npmjs.org/ent/-/ent-2.2.0.tgz#e964219325a21d05f44466a2f686ed6ce5f5dd1d" - -error-ex@^1.2.0: - version "1.3.0" - resolved "https://registry.npmjs.org/error-ex/-/error-ex-1.3.0.tgz#e67b43f3e82c96ea3a584ffee0b9fc3325d802d9" - dependencies: - is-arrayish "^0.2.1" - -es5-ext@^0.10.12, es5-ext@^0.10.7, es5-ext@^0.10.9, es5-ext@~0.10.11, es5-ext@~0.10.2: - version "0.10.12" - resolved "https://registry.npmjs.org/es5-ext/-/es5-ext-0.10.12.tgz#aa84641d4db76b62abba5e45fd805ecbab140047" - dependencies: - es6-iterator "2" - es6-symbol "~3.1" - -es6-iterator@2: - version "2.0.0" - resolved "https://registry.npmjs.org/es6-iterator/-/es6-iterator-2.0.0.tgz#bd968567d61635e33c0b80727613c9cb4b096bac" - dependencies: - d "^0.1.1" - es5-ext "^0.10.7" - es6-symbol "3" - -es6-module-loader@^0.17.10: - version "0.17.11" - resolved "https://registry.npmjs.org/es6-module-loader/-/es6-module-loader-0.17.11.tgz#094f042e3b4d3086bcfd17380affabdfc99f35d7" - dependencies: - when "^3.7.2" - -es6-shim@^0.35.0: - version "0.35.1" - resolved "https://registry.npmjs.org/es6-shim/-/es6-shim-0.35.1.tgz#a23524009005b031ab4a352ac196dfdfd1144ab7" - -es6-symbol@~3.1, es6-symbol@3: - version "3.1.0" - resolved "https://registry.npmjs.org/es6-symbol/-/es6-symbol-3.1.0.tgz#94481c655e7a7cad82eba832d97d5433496d7ffa" - dependencies: - d "~0.1.1" - es5-ext "~0.10.11" - -es6-template-strings@^2.0.0: - version "2.0.1" - resolved "https://registry.npmjs.org/es6-template-strings/-/es6-template-strings-2.0.1.tgz#b166c6a62562f478bb7775f6ca96103a599b4b2c" - dependencies: - es5-ext "^0.10.12" - esniff "^1.1" - -escape-html@~1.0.3: - version "1.0.3" - resolved "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz#0258eae4d3d0c0974de1c169188ef0051d1d1988" - -escape-string-regexp@^1.0.0, escape-string-regexp@^1.0.2: - version "1.0.5" - resolved "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz#1b61c0562190a8dff6ae3bb2cf0200ca130b86d4" - -esniff@^1.1: - version "1.1.0" - resolved "https://registry.npmjs.org/esniff/-/esniff-1.1.0.tgz#c66849229f91464dede2e0d40201ed6abf65f2ac" - dependencies: - d "1" - es5-ext "^0.10.12" - -esprima@^1.2.2: - version "1.2.5" - resolved "https://registry.npmjs.org/esprima/-/esprima-1.2.5.tgz#0993502feaf668138325756f30f9a51feeec11e9" - -esprima@^2.6.0: - version "2.7.3" - resolved "https://registry.npmjs.org/esprima/-/esprima-2.7.3.tgz#96e3b70d5779f6ad49cd032673d1c312767ba581" - -esutils@^2.0.2: - version "2.0.2" - resolved "https://registry.npmjs.org/esutils/-/esutils-2.0.2.tgz#0abf4f1caa5bcb1f7a9d8acc6dea4faaa04bac9b" - -event-stream@~3.1.5: - version "3.1.7" - resolved "https://registry.npmjs.org/event-stream/-/event-stream-3.1.7.tgz#b4c540012d0fe1498420f3d8946008db6393c37a" - dependencies: - duplexer "~0.1.1" - from "~0" - map-stream "~0.1.0" - pause-stream "0.0.11" - split "0.2" - stream-combiner "~0.0.4" - through "~2.3.1" - -eventemitter3@1.x.x: - version "1.2.0" - resolved "https://registry.npmjs.org/eventemitter3/-/eventemitter3-1.2.0.tgz#1c86991d816ad1e504750e73874224ecf3bec508" - -exit-hook@^1.0.0: - version "1.1.1" - resolved "https://registry.npmjs.org/exit-hook/-/exit-hook-1.1.1.tgz#f05ca233b48c05d54fff07765df8507e95c02ff8" - -exit@^0.1.2, exit@~0.1.2, exit@0.1.2: - version "0.1.2" - resolved "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz#0632638f8d877cc82107d30a0fff1a17cba1cd0c" - -expand-braces@^0.1.1: - version "0.1.2" - resolved "https://registry.npmjs.org/expand-braces/-/expand-braces-0.1.2.tgz#488b1d1d2451cb3d3a6b192cfc030f44c5855fea" - dependencies: - array-slice "^0.2.3" - array-unique "^0.2.1" - braces "^0.1.2" - -expand-brackets@^0.1.4: - version "0.1.5" - resolved "https://registry.npmjs.org/expand-brackets/-/expand-brackets-0.1.5.tgz#df07284e342a807cd733ac5af72411e581d1177b" - dependencies: - is-posix-bracket "^0.1.0" - -expand-range@^0.1.0: - version "0.1.1" - resolved "https://registry.npmjs.org/expand-range/-/expand-range-0.1.1.tgz#4cb8eda0993ca56fa4f41fc42f3cbb4ccadff044" - dependencies: - is-number "^0.1.1" - repeat-string "^0.2.2" - -expand-range@^1.8.1: - version "1.8.2" - resolved "https://registry.npmjs.org/expand-range/-/expand-range-1.8.2.tgz#a299effd335fe2721ebae8e257ec79644fc85337" - dependencies: - fill-range "^2.1.0" - -expand-tilde@^1.2.1, expand-tilde@^1.2.2: - version "1.2.2" - resolved "https://registry.npmjs.org/expand-tilde/-/expand-tilde-1.2.2.tgz#0b81eba897e5a3d31d1c3d102f8f01441e559449" - dependencies: - os-homedir "^1.0.1" - -extend-shallow@^2.0.1: - version "2.0.1" - resolved "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz#51af7d614ad9a9f610ea1bafbb989d6b1c56890f" - dependencies: - is-extendable "^0.1.0" - -extend@^2.0.0: - version "2.0.1" - resolved "https://registry.npmjs.org/extend/-/extend-2.0.1.tgz#1ee8010689e7395ff9448241c98652bc759a8260" - -extend@^3.0.0, extend@~3.0.0, extend@3: - version "3.0.0" - resolved "https://registry.npmjs.org/extend/-/extend-3.0.0.tgz#5a474353b9f3353ddd8176dfd37b91c83a46f1d4" - -extglob@^0.3.1: - version "0.3.2" - resolved "https://registry.npmjs.org/extglob/-/extglob-0.3.2.tgz#2e18ff3d2f49ab2765cec9023f011daa8d8349a1" - dependencies: - is-extglob "^1.0.0" - -extsprintf@1.0.2: - version "1.0.2" - resolved "https://registry.npmjs.org/extsprintf/-/extsprintf-1.0.2.tgz#e1080e0658e300b06294990cc70e1502235fd550" - -extsprintf@1.0.3: - version "1.0.3" - resolved "https://registry.npmjs.org/extsprintf/-/extsprintf-1.0.3.tgz#3310ca8ced5205e5234766b0b2744ea5b2788d67" - -fancy-log@^1.1.0: - version "1.2.0" - resolved "https://registry.npmjs.org/fancy-log/-/fancy-log-1.2.0.tgz#d5a51b53e9ab22ca07d558f2b67ae55fdb5fcbd8" - dependencies: - chalk "^1.1.1" - time-stamp "^1.0.0" - -faye-websocket@0.9.3: - version "0.9.3" - resolved "https://registry.npmjs.org/faye-websocket/-/faye-websocket-0.9.3.tgz#482a505b0df0ae626b969866d3bd740cdb962e83" - dependencies: - websocket-driver ">=0.5.1" - -filename-regex@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/filename-regex/-/filename-regex-2.0.0.tgz#996e3e80479b98b9897f15a8a58b3d084e926775" - -fill-range@^2.1.0: - version "2.2.3" - resolved "https://registry.npmjs.org/fill-range/-/fill-range-2.2.3.tgz#50b77dfd7e469bc7492470963699fe7a8485a723" - dependencies: - is-number "^2.1.0" - isobject "^2.0.0" - randomatic "^1.1.3" - repeat-element "^1.1.2" - repeat-string "^1.5.2" - -filled-array@^1.0.0: - version "1.1.0" - resolved "https://registry.npmjs.org/filled-array/-/filled-array-1.1.0.tgz#c3c4f6c663b923459a9aa29912d2d031f1507f84" - -finalhandler@0.5.0: - version "0.5.0" - resolved "https://registry.npmjs.org/finalhandler/-/finalhandler-0.5.0.tgz#e9508abece9b6dba871a6942a1d7911b91911ac7" - dependencies: - debug "~2.2.0" - escape-html "~1.0.3" - on-finished "~2.3.0" - statuses "~1.3.0" - unpipe "~1.0.0" - -find-index@^0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/find-index/-/find-index-0.1.1.tgz#675d358b2ca3892d795a1ab47232f8b6e2e0dde4" - -find-up@^1.0.0: - version "1.1.2" - resolved "https://registry.npmjs.org/find-up/-/find-up-1.1.2.tgz#6b2e9822b1a2ce0a60ab64d610eccad53cb24d0f" - dependencies: - path-exists "^2.0.0" - pinkie-promise "^2.0.0" - -findup-sync@^0.4.2: - version "0.4.3" - resolved "https://registry.npmjs.org/findup-sync/-/findup-sync-0.4.3.tgz#40043929e7bc60adf0b7f4827c4c6e75a0deca12" - dependencies: - detect-file "^0.1.0" - is-glob "^2.0.1" - micromatch "^2.3.7" - resolve-dir "^0.1.0" - -fined@^1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/fined/-/fined-1.0.2.tgz#5b28424b760d7598960b7ef8480dff8ad3660e97" - dependencies: - expand-tilde "^1.2.1" - lodash.assignwith "^4.0.7" - lodash.isempty "^4.2.1" - lodash.isplainobject "^4.0.4" - lodash.isstring "^4.0.1" - lodash.pick "^4.2.1" - parse-filepath "^1.0.1" - -firebase-copy@0.2.0: - version "0.2.0" - resolved "https://registry.npmjs.org/firebase-copy/-/firebase-copy-0.2.0.tgz#448d281bd42f1ce06315cdbe99feb6a0829ce61d" - dependencies: - resolve "^1.1.6" - -firebase-server@^0.5.2: - version "0.5.4" - resolved "https://registry.npmjs.org/firebase-server/-/firebase-server-0.5.4.tgz#09e1211287a908427166e913a8dfd7690c21e5bd" - dependencies: - cli "^0.11.1" - debug "^2.2.0" - firebase-copy "0.2.0" - jwt-simple "^0.3.1" - lodash "3.10.1" - native-or-bluebird "1.2.0" - targaryen "2.0.0" - ws "0.8.1" - -firebase@^3.0.0: - version "3.6.1" - resolved "https://registry.yarnpkg.com/firebase/-/firebase-3.6.1.tgz#bcd7fe28f9eb75c8ecbefba9b4763b0800995229" - dependencies: - dom-storage "2.0.2" - faye-websocket "0.9.3" - jsonwebtoken "5.7.0" - rsvp "3.2.1" - xmlhttprequest "1.8.0" - -first-chunk-stream@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/first-chunk-stream/-/first-chunk-stream-1.0.0.tgz#59bfb50cd905f60d7c394cd3d9acaab4e6ad934e" - -flagged-respawn@^0.3.2: - version "0.3.2" - resolved "https://registry.npmjs.org/flagged-respawn/-/flagged-respawn-0.3.2.tgz#ff191eddcd7088a675b2610fffc976be9b8074b5" - -for-in@^0.1.5: - version "0.1.6" - resolved "https://registry.npmjs.org/for-in/-/for-in-0.1.6.tgz#c9f96e89bfad18a545af5ec3ed352a1d9e5b4dc8" - -for-own@^0.1.4: - version "0.1.4" - resolved "https://registry.npmjs.org/for-own/-/for-own-0.1.4.tgz#0149b41a39088c7515f51ebe1c1386d45f935072" - dependencies: - for-in "^0.1.5" - -foreach@^2.0.4: - version "2.0.5" - resolved "https://registry.npmjs.org/foreach/-/foreach-2.0.5.tgz#0bee005018aeb260d0a3af3ae658dd0136ec1b99" - -forever-agent@~0.6.0, forever-agent@~0.6.1: - version "0.6.1" - resolved "https://registry.npmjs.org/forever-agent/-/forever-agent-0.6.1.tgz#fbc71f0c41adeb37f96c577ad1ed42d8fdacca91" - -form-data@^2.0.0, form-data@~2.1.1: - version "2.1.1" - resolved "https://registry.npmjs.org/form-data/-/form-data-2.1.1.tgz#4adf0342e1a79afa1e84c8c320a9ffc82392a1f3" - dependencies: - asynckit "^0.4.0" - combined-stream "^1.0.5" - mime-types "^2.1.12" - -form-data@~0.2.0: - version "0.2.0" - resolved "https://registry.npmjs.org/form-data/-/form-data-0.2.0.tgz#26f8bc26da6440e299cbdcfb69035c4f77a6e466" - dependencies: - async "~0.9.0" - combined-stream "~0.0.4" - mime-types "~2.0.3" - -from@~0: - version "0.1.3" - resolved "https://registry.npmjs.org/from/-/from-0.1.3.tgz#ef63ac2062ac32acf7862e0d40b44b896f22f3bc" - -fs-access@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/fs-access/-/fs-access-1.0.1.tgz#d6a87f262271cefebec30c553407fb995da8777a" - dependencies: - null-check "^1.0.0" - -fs-exists-sync@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/fs-exists-sync/-/fs-exists-sync-0.1.0.tgz#982d6893af918e72d08dec9e8673ff2b5a8d6add" - -fs-extra@^0.26.2: - version "0.26.7" - resolved "https://registry.npmjs.org/fs-extra/-/fs-extra-0.26.7.tgz#9ae1fdd94897798edab76d0918cf42d0c3184fa9" - dependencies: - graceful-fs "^4.1.2" - jsonfile "^2.1.0" - klaw "^1.0.0" - path-is-absolute "^1.0.0" - rimraf "^2.2.8" - -fs.realpath@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz#1504ad2523158caa40db4a2787cb01411994ea4f" - -fsevents@^1.0.0: - version "1.0.14" - resolved "https://registry.npmjs.org/fsevents/-/fsevents-1.0.14.tgz#558e8cc38643d8ef40fe45158486d0d25758eee4" - dependencies: - nan "^2.3.0" - node-pre-gyp "^0.6.29" - -fstream-ignore@~1.0.5: - version "1.0.5" - resolved "https://registry.npmjs.org/fstream-ignore/-/fstream-ignore-1.0.5.tgz#9c31dae34767018fe1d249b24dada67d092da105" - dependencies: - fstream "^1.0.0" - inherits "2" - minimatch "^3.0.0" - -fstream@^1.0.0, fstream@^1.0.2, fstream@~1.0.10: - version "1.0.10" - resolved "https://registry.npmjs.org/fstream/-/fstream-1.0.10.tgz#604e8a92fe26ffd9f6fae30399d4984e1ab22822" - dependencies: - graceful-fs "^4.1.2" - inherits "~2.0.0" - mkdirp ">=0.5 0" - rimraf "2" - -function-bind@^1.0.2: - version "1.1.0" - resolved "https://registry.npmjs.org/function-bind/-/function-bind-1.1.0.tgz#16176714c801798e4e8f2cf7f7529467bb4a5771" - -gauge@~2.6.0: - version "2.6.0" - resolved "https://registry.npmjs.org/gauge/-/gauge-2.6.0.tgz#d35301ad18e96902b4751dcbbe40f4218b942a46" - dependencies: - aproba "^1.0.3" - console-control-strings "^1.0.0" - has-color "^0.1.7" - has-unicode "^2.0.0" - object-assign "^4.1.0" - signal-exit "^3.0.0" - string-width "^1.0.1" - strip-ansi "^3.0.1" - wide-align "^1.1.0" - -gaze@^0.5.1: - version "0.5.2" - resolved "https://registry.npmjs.org/gaze/-/gaze-0.5.2.tgz#40b709537d24d1d45767db5a908689dfe69ac44f" - dependencies: - globule "~0.1.0" - -generate-function@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/generate-function/-/generate-function-2.0.0.tgz#6858fe7c0969b7d4e9093337647ac79f60dfbe74" - -generate-object-property@^1.1.0: - version "1.2.0" - resolved "https://registry.npmjs.org/generate-object-property/-/generate-object-property-1.2.0.tgz#9c0e1c40308ce804f4783618b937fa88f99d50d0" - dependencies: - is-property "^1.0.0" - -get-pkg-repo@^1.0.0: - version "1.3.0" - resolved "https://registry.npmjs.org/get-pkg-repo/-/get-pkg-repo-1.3.0.tgz#43c6b4c048b75dd604fc5388edecde557f6335df" - dependencies: - hosted-git-info "^2.1.4" - meow "^3.3.0" - normalize-package-data "^2.3.0" - parse-github-repo-url "^1.3.0" - through2 "^2.0.0" - -get-stdin@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/get-stdin/-/get-stdin-0.1.0.tgz#5998af24aafc802d15c82c685657eeb8b10d4a91" - -get-stdin@^4.0.1: - version "4.0.1" - resolved "https://registry.npmjs.org/get-stdin/-/get-stdin-4.0.1.tgz#b968c6b0a04384324902e8bf1a5df32579a450fe" - -getpass@^0.1.1: - version "0.1.6" - resolved "https://registry.npmjs.org/getpass/-/getpass-0.1.6.tgz#283ffd9fc1256840875311c1b60e8c40187110e6" - dependencies: - assert-plus "^1.0.0" - -git-raw-commits@^1.1.0: - version "1.1.2" - resolved "https://registry.npmjs.org/git-raw-commits/-/git-raw-commits-1.1.2.tgz#a12d8492aeba2881802d700825ed81c9f39e6f2f" - dependencies: - dargs "^4.0.1" - lodash.template "^4.0.2" - meow "^3.3.0" - split2 "^2.0.0" - through2 "^2.0.0" - -git-remote-origin-url@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/git-remote-origin-url/-/git-remote-origin-url-2.0.0.tgz#5282659dae2107145a11126112ad3216ec5fa65f" - dependencies: - gitconfiglocal "^1.0.0" - pify "^2.3.0" - -git-semver-tags@^1.1.0: - version "1.1.2" - resolved "https://registry.npmjs.org/git-semver-tags/-/git-semver-tags-1.1.2.tgz#aecf9b1b2447a6b548d48647f53edba0acad879f" - dependencies: - meow "^3.3.0" - semver "^5.0.1" - -gitconfiglocal@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/gitconfiglocal/-/gitconfiglocal-1.0.0.tgz#41d045f3851a5ea88f03f24ca1c6178114464b9b" - dependencies: - ini "^1.3.2" - -github-url-from-git@^1.4.0: - version "1.4.0" - resolved "https://registry.npmjs.org/github-url-from-git/-/github-url-from-git-1.4.0.tgz#285e6b520819001bde128674704379e4ff03e0de" - -glob-base@^0.3.0: - version "0.3.0" - resolved "https://registry.npmjs.org/glob-base/-/glob-base-0.3.0.tgz#dbb164f6221b1c0b1ccf82aea328b497df0ea3c4" - dependencies: - glob-parent "^2.0.0" - is-glob "^2.0.0" - -glob-parent@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/glob-parent/-/glob-parent-2.0.0.tgz#81383d72db054fcccf5336daa902f182f6edbb28" - dependencies: - is-glob "^2.0.0" - -glob-parent@^3.0.0: - version "3.0.1" - resolved "https://registry.npmjs.org/glob-parent/-/glob-parent-3.0.1.tgz#60021327cc963ddc3b5f085764f500479ecd82ff" - dependencies: - is-glob "^3.1.0" - path-dirname "^1.0.0" - -glob-stream@^3.1.5: - version "3.1.18" - resolved "https://registry.npmjs.org/glob-stream/-/glob-stream-3.1.18.tgz#9170a5f12b790306fdfe598f313f8f7954fd143b" - dependencies: - glob "^4.3.1" - glob2base "^0.0.12" - minimatch "^2.0.1" - ordered-read-streams "^0.1.0" - through2 "^0.6.1" - unique-stream "^1.0.0" - -glob-stream@^5.3.2: - version "5.3.5" - resolved "https://registry.npmjs.org/glob-stream/-/glob-stream-5.3.5.tgz#a55665a9a8ccdc41915a87c701e32d4e016fad22" - dependencies: - extend "^3.0.0" - glob "^5.0.3" - glob-parent "^3.0.0" - micromatch "^2.3.7" - ordered-read-streams "^0.3.0" - through2 "^0.6.0" - to-absolute-glob "^0.1.1" - unique-stream "^2.0.2" - -glob-watcher@^0.0.6: - version "0.0.6" - resolved "https://registry.npmjs.org/glob-watcher/-/glob-watcher-0.0.6.tgz#b95b4a8df74b39c83298b0c05c978b4d9a3b710b" - dependencies: - gaze "^0.5.1" - -glob@^3.2.11, glob@~3.2: - version "3.2.11" - resolved "https://registry.npmjs.org/glob/-/glob-3.2.11.tgz#4a973f635b9190f715d10987d5c00fd2815ebe3d" - dependencies: - inherits "2" - minimatch "0.3" - -glob@^4.0.6, glob@^4.3.1: - version "4.5.3" - resolved "https://registry.npmjs.org/glob/-/glob-4.5.3.tgz#c6cb73d3226c1efef04de3c56d012f03377ee15f" - dependencies: - inflight "^1.0.4" - inherits "2" - minimatch "^2.0.1" - once "^1.3.0" - -glob@^5.0.3, glob@5.0.x: - version "5.0.15" - resolved "https://registry.npmjs.org/glob/-/glob-5.0.15.tgz#1bc936b9e02f4a603fcc222ecf7633d30b8b93b1" - dependencies: - inflight "^1.0.4" - inherits "2" - minimatch "2 || 3" - once "^1.3.0" - path-is-absolute "^1.0.0" - -glob@^7.0.0, glob@^7.0.3, glob@^7.0.5, glob@^7.0.6: - version "7.1.1" - resolved "https://registry.npmjs.org/glob/-/glob-7.1.1.tgz#805211df04faaf1c63a3600306cdf5ade50b2ec8" - dependencies: - fs.realpath "^1.0.0" - inflight "^1.0.4" - inherits "2" - minimatch "^3.0.2" - once "^1.3.0" - path-is-absolute "^1.0.0" - -glob@~3.1.21: - version "3.1.21" - resolved "https://registry.npmjs.org/glob/-/glob-3.1.21.tgz#d29e0a055dea5138f4d07ed40e8982e83c2066cd" - dependencies: - graceful-fs "~1.2.0" - inherits "1" - minimatch "~0.2.11" - -glob@4.3: - version "4.3.5" - resolved "https://registry.npmjs.org/glob/-/glob-4.3.5.tgz#80fbb08ca540f238acce5d11d1e9bc41e75173d3" - dependencies: - inflight "^1.0.4" - inherits "2" - minimatch "^2.0.1" - once "^1.3.0" - -glob2base@^0.0.12: - version "0.0.12" - resolved "https://registry.npmjs.org/glob2base/-/glob2base-0.0.12.tgz#9d419b3e28f12e83a362164a277055922c9c0d56" - dependencies: - find-index "^0.1.1" - -global-modules@^0.2.3: - version "0.2.3" - resolved "https://registry.npmjs.org/global-modules/-/global-modules-0.2.3.tgz#ea5a3bed42c6d6ce995a4f8a1269b5dae223828d" - dependencies: - global-prefix "^0.1.4" - is-windows "^0.2.0" - -global-prefix@^0.1.4: - version "0.1.4" - resolved "https://registry.npmjs.org/global-prefix/-/global-prefix-0.1.4.tgz#05158db1cde2dd491b455e290eb3ab8bfc45c6e1" - dependencies: - ini "^1.3.4" - is-windows "^0.2.0" - osenv "^0.1.3" - which "^1.2.10" - -globals@^9.0.0: - version "9.12.0" - resolved "https://registry.npmjs.org/globals/-/globals-9.12.0.tgz#992ce90828c3a55fa8f16fada177adb64664cf9d" - -globule@~0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/globule/-/globule-0.1.0.tgz#d9c8edde1da79d125a151b79533b978676346ae5" - dependencies: - glob "~3.1.21" - lodash "~1.0.1" - minimatch "~0.2.11" - -glogg@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/glogg/-/glogg-1.0.0.tgz#7fe0f199f57ac906cf512feead8f90ee4a284fc5" - dependencies: - sparkles "^1.0.0" - -got@^3.2.0: - version "3.3.1" - resolved "https://registry.npmjs.org/got/-/got-3.3.1.tgz#e5d0ed4af55fc3eef4d56007769d98192bcb2eca" - dependencies: - duplexify "^3.2.0" - infinity-agent "^2.0.0" - is-redirect "^1.0.0" - is-stream "^1.0.0" - lowercase-keys "^1.0.0" - nested-error-stacks "^1.0.0" - object-assign "^3.0.0" - prepend-http "^1.0.0" - read-all-stream "^3.0.0" - timed-out "^2.0.0" - -got@^5.0.0: - version "5.6.0" - resolved "https://registry.npmjs.org/got/-/got-5.6.0.tgz#bb1d7ee163b78082bbc8eb836f3f395004ea6fbf" - dependencies: - create-error-class "^3.0.1" - duplexer2 "^0.1.4" - is-plain-obj "^1.0.0" - is-redirect "^1.0.0" - is-retry-allowed "^1.0.0" - is-stream "^1.0.0" - lowercase-keys "^1.0.0" - node-status-codes "^1.0.0" - object-assign "^4.0.1" - parse-json "^2.1.0" - pinkie-promise "^2.0.0" - read-all-stream "^3.0.0" - readable-stream "^2.0.5" - timed-out "^2.0.0" - unzip-response "^1.0.0" - url-parse-lax "^1.0.0" - -graceful-fs@^3.0.0, graceful-fs@^3.0.1: - version "3.0.11" - resolved "https://registry.npmjs.org/graceful-fs/-/graceful-fs-3.0.11.tgz#7613c778a1afea62f25c630a086d7f3acbbdd818" - dependencies: - natives "^1.1.0" - -graceful-fs@^4.0.0, graceful-fs@^4.1.2, graceful-fs@^4.1.6, graceful-fs@^4.1.9: - version "4.1.9" - resolved "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.1.9.tgz#baacba37d19d11f9d146d3578bc99958c3787e29" - -graceful-fs@~1.2.0: - version "1.2.3" - resolved "https://registry.npmjs.org/graceful-fs/-/graceful-fs-1.2.3.tgz#15a4806a57547cb2d2dbf27f42e89a8c3451b364" - -"graceful-readlink@>= 1.0.0": - version "1.0.1" - resolved "https://registry.npmjs.org/graceful-readlink/-/graceful-readlink-1.0.1.tgz#4cafad76bc62f02fa039b2f94e9a3dd3a391a725" - -gulp-jasmine@^2.2.1: - version "2.4.2" - resolved "https://registry.npmjs.org/gulp-jasmine/-/gulp-jasmine-2.4.2.tgz#5a7f47e27370c3619ac0a2a442be399671409db3" - dependencies: - arrify "^1.0.0" - gulp-util "^3.0.0" - jasmine "^2.3.0" - jasmine-terminal-reporter "^1.0.0" - through2 "^2.0.0" - -gulp-sourcemaps@1.6.0: - version "1.6.0" - resolved "https://registry.npmjs.org/gulp-sourcemaps/-/gulp-sourcemaps-1.6.0.tgz#b86ff349d801ceb56e1d9e7dc7bbcb4b7dee600c" - dependencies: - convert-source-map "^1.1.1" - graceful-fs "^4.1.2" - strip-bom "^2.0.0" - through2 "^2.0.0" - vinyl "^1.0.0" - -gulp-typescript@^2.10.0: - version "2.14.1" - resolved "https://registry.npmjs.org/gulp-typescript/-/gulp-typescript-2.14.1.tgz#bc00edf2ee71f09bda53fd1d0b873b571371d4de" - dependencies: - gulp-util "~3.0.7" - source-map "~0.5.3" - through2 "~2.0.1" - typescript "1.8.10" - vinyl-fs "~2.4.3" - -gulp-util@^3.0.0, gulp-util@~3.0.7: - version "3.0.7" - resolved "https://registry.npmjs.org/gulp-util/-/gulp-util-3.0.7.tgz#78925c4b8f8b49005ac01a011c557e6218941cbb" - dependencies: - array-differ "^1.0.0" - array-uniq "^1.0.2" - beeper "^1.0.0" - chalk "^1.0.0" - dateformat "^1.0.11" - fancy-log "^1.1.0" - gulplog "^1.0.0" - has-gulplog "^0.1.0" - lodash._reescape "^3.0.0" - lodash._reevaluate "^3.0.0" - lodash._reinterpolate "^3.0.0" - lodash.template "^3.0.0" - minimist "^1.1.0" - multipipe "^0.1.2" - object-assign "^3.0.0" - replace-ext "0.0.1" - through2 "^2.0.0" - vinyl "^0.5.0" - -gulp@^3.9.0: - version "3.9.1" - resolved "https://registry.npmjs.org/gulp/-/gulp-3.9.1.tgz#571ce45928dd40af6514fc4011866016c13845b4" - dependencies: - archy "^1.0.0" - chalk "^1.0.0" - deprecated "^0.0.1" - gulp-util "^3.0.0" - interpret "^1.0.0" - liftoff "^2.1.0" - minimist "^1.1.0" - orchestrator "^0.3.0" - pretty-hrtime "^1.0.0" - semver "^4.1.0" - tildify "^1.0.0" - v8flags "^2.0.2" - vinyl-fs "^0.3.0" - -gulplog@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/gulplog/-/gulplog-1.0.0.tgz#e28c4d45d05ecbbed818363ce8f9c5926229ffe5" - dependencies: - glogg "^1.0.0" - -handlebars@^4.0.2, handlebars@4.0.5: - version "4.0.5" - resolved "https://registry.npmjs.org/handlebars/-/handlebars-4.0.5.tgz#92c6ed6bb164110c50d4d8d0fbddc70806c6f8e7" - dependencies: - async "^1.4.0" - optimist "^0.6.1" - source-map "^0.4.4" - optionalDependencies: - uglify-js "^2.6" - -har-validator@^1.6.1: - version "1.8.0" - resolved "https://registry.npmjs.org/har-validator/-/har-validator-1.8.0.tgz#d83842b0eb4c435960aeb108a067a3aa94c0eeb2" - dependencies: - bluebird "^2.9.30" - chalk "^1.0.0" - commander "^2.8.1" - is-my-json-valid "^2.12.0" - -har-validator@~2.0.6: - version "2.0.6" - resolved "https://registry.npmjs.org/har-validator/-/har-validator-2.0.6.tgz#cdcbc08188265ad119b6a5a7c8ab70eecfb5d27d" - dependencies: - chalk "^1.1.1" - commander "^2.9.0" - is-my-json-valid "^2.12.4" - pinkie-promise "^2.0.0" - -has-ansi@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/has-ansi/-/has-ansi-0.1.0.tgz#84f265aae8c0e6a88a12d7022894b7568894c62e" - dependencies: - ansi-regex "^0.2.0" - -has-ansi@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/has-ansi/-/has-ansi-2.0.0.tgz#34f5049ce1ecdf2b0649af3ef24e45ed35416d91" - dependencies: - ansi-regex "^2.0.0" - -has-binary@0.1.6: - version "0.1.6" - resolved "https://registry.npmjs.org/has-binary/-/has-binary-0.1.6.tgz#25326f39cfa4f616ad8787894e3af2cfbc7b6e10" - dependencies: - isarray "0.0.1" - -has-binary@0.1.7: - version "0.1.7" - resolved "https://registry.npmjs.org/has-binary/-/has-binary-0.1.7.tgz#68e61eb16210c9545a0a5cce06a873912fe1e68c" - dependencies: - isarray "0.0.1" - -has-color@^0.1.7: - version "0.1.7" - resolved "https://registry.npmjs.org/has-color/-/has-color-0.1.7.tgz#67144a5260c34fc3cca677d041daf52fe7b78b2f" - -has-cors@1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/has-cors/-/has-cors-1.1.0.tgz#5e474793f7ea9843d1bb99c23eef49ff126fff39" - -has-gulplog@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/has-gulplog/-/has-gulplog-0.1.0.tgz#6414c82913697da51590397dafb12f22967811ce" - dependencies: - sparkles "^1.0.0" - -has-unicode@^2.0.0, has-unicode@^2.0.1: - version "2.0.1" - resolved "https://registry.npmjs.org/has-unicode/-/has-unicode-2.0.1.tgz#e0e6fe6a28cf51138855e086d1691e771de2a8b9" - -has@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/has/-/has-1.0.1.tgz#8461733f538b0837c9361e39a9ab9e9704dc2f28" - dependencies: - function-bind "^1.0.2" - -hawk@~2.3.0: - version "2.3.1" - resolved "https://registry.npmjs.org/hawk/-/hawk-2.3.1.tgz#1e731ce39447fa1d0f6d707f7bceebec0fd1ec1f" - dependencies: - boom "2.x.x" - cryptiles "2.x.x" - hoek "2.x.x" - sntp "1.x.x" - -hawk@~3.1.3: - version "3.1.3" - resolved "https://registry.npmjs.org/hawk/-/hawk-3.1.3.tgz#078444bd7c1640b0fe540d2c9b73d59678e8e1c4" - dependencies: - boom "2.x.x" - cryptiles "2.x.x" - hoek "2.x.x" - sntp "1.x.x" - -he@^0.5.0: - version "0.5.0" - resolved "https://registry.npmjs.org/he/-/he-0.5.0.tgz#2c05ffaef90b68e860f3fd2b54ef580989277ee2" - -highlight.js@^9.0.0: - version "9.7.0" - resolved "https://registry.npmjs.org/highlight.js/-/highlight.js-9.7.0.tgz#e7a926bf3079c65b2ae50314878e456a009b4aac" - -hoek@^2.2.x, hoek@2.x.x: - version "2.16.3" - resolved "https://registry.npmjs.org/hoek/-/hoek-2.16.3.tgz#20bb7403d3cea398e91dc4710a8ff1b8274a25ed" - -home-or-tmp@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/home-or-tmp/-/home-or-tmp-2.0.0.tgz#e36c3f2d2cae7d746a857e38d18d5f32a7882db8" - dependencies: - os-homedir "^1.0.0" - os-tmpdir "^1.0.1" - -hosted-git-info@^2.1.4: - version "2.1.5" - resolved "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.1.5.tgz#0ba81d90da2e25ab34a332e6ec77936e1598118b" - -http-errors@~1.5.0: - version "1.5.0" - resolved "https://registry.npmjs.org/http-errors/-/http-errors-1.5.0.tgz#b1cb3d8260fd8e2386cad3189045943372d48211" - dependencies: - inherits "2.0.1" - setprototypeof "1.0.1" - statuses ">= 1.3.0 < 2" - -http-proxy-agent@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-1.0.0.tgz#cc1ce38e453bf984a0f7702d2dd59c73d081284a" - dependencies: - agent-base "2" - debug "2" - extend "3" - -http-proxy@^1.13.0, http-proxy@^1.8.1: - version "1.15.2" - resolved "https://registry.npmjs.org/http-proxy/-/http-proxy-1.15.2.tgz#642fdcaffe52d3448d2bda3b0079e9409064da31" - dependencies: - eventemitter3 "1.x.x" - requires-port "1.x.x" - -http-server@^0.8.5: - version "0.8.5" - resolved "https://registry.npmjs.org/http-server/-/http-server-0.8.5.tgz#bbf27c9f09499e51a1fe1f979a6f39a45a04f2fb" - dependencies: - colors "1.0.3" - corser "~2.0.0" - ecstatic "~0.7.0" - http-proxy "^1.8.1" - opener "~1.4.0" - optimist "0.6.x" - portfinder "0.4.x" - union "~0.4.3" - -http-signature@~0.11.0: - version "0.11.0" - resolved "https://registry.npmjs.org/http-signature/-/http-signature-0.11.0.tgz#1796cf67a001ad5cd6849dca0991485f09089fe6" - dependencies: - asn1 "0.1.11" - assert-plus "^0.1.5" - ctype "0.5.3" - -http-signature@~1.1.0: - version "1.1.1" - resolved "https://registry.npmjs.org/http-signature/-/http-signature-1.1.1.tgz#df72e267066cd0ac67fb76adf8e134a8fbcf91bf" - dependencies: - assert-plus "^0.2.0" - jsprim "^1.2.2" - sshpk "^1.7.0" - -https-proxy-agent@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-1.0.0.tgz#35f7da6c48ce4ddbfa264891ac593ee5ff8671e6" - dependencies: - agent-base "2" - debug "2" - extend "3" - -iconv-lite@0.4.13: - version "0.4.13" - resolved "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.13.tgz#1f88aba4ab0b1508e8312acc39345f36e992e2f2" - -imurmurhash@^0.1.4: - version "0.1.4" - resolved "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz#9218b9b2b928a238b13dc4fb6b6d576f231453ea" - -indent-string@^1.1.0: - version "1.2.2" - resolved "https://registry.npmjs.org/indent-string/-/indent-string-1.2.2.tgz#db99bcc583eb6abbb1e48dcbb1999a986041cb6b" - dependencies: - get-stdin "^4.0.1" - minimist "^1.1.0" - repeating "^1.1.0" - -indent-string@^2.1.0: - version "2.1.0" - resolved "https://registry.npmjs.org/indent-string/-/indent-string-2.1.0.tgz#8e2d48348742121b4a8218b7a137e9a52049dc80" - dependencies: - repeating "^2.0.0" - -indexof@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/indexof/-/indexof-0.0.1.tgz#82dc336d232b9062179d05ab3293a66059fd435d" - -infinity-agent@^2.0.0: - version "2.0.3" - resolved "https://registry.npmjs.org/infinity-agent/-/infinity-agent-2.0.3.tgz#45e0e2ff7a9eb030b27d62b74b3744b7a7ac4216" - -inflight@^1.0.4: - version "1.0.6" - resolved "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz#49bd6331d7d02d0c09bc910a1075ba8165b56df9" - dependencies: - once "^1.3.0" - wrappy "1" - -inherits@^2.0.1, inherits@~2.0.0, inherits@~2.0.1, inherits@2: - version "2.0.3" - resolved "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz#633c2c83e3da42a502f52466022480f4208261de" - -inherits@1: - version "1.0.2" - resolved "https://registry.npmjs.org/inherits/-/inherits-1.0.2.tgz#ca4309dadee6b54cc0b8d247e8d7c7a0975bdc9b" - -inherits@2.0.1: - version "2.0.1" - resolved "https://registry.npmjs.org/inherits/-/inherits-2.0.1.tgz#b17d08d326b4423e568eff719f91b0b1cbdf69f1" - -ini@^1.3.2, ini@^1.3.4, ini@~1.3.0: - version "1.3.4" - resolved "https://registry.npmjs.org/ini/-/ini-1.3.4.tgz#0537cb79daf59b59a1a517dff706c86ec039162e" - -interpret@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/interpret/-/interpret-1.0.1.tgz#d579fb7f693b858004947af39fa0db49f795602c" - -invariant@^2.2.0: - version "2.2.1" - resolved "https://registry.npmjs.org/invariant/-/invariant-2.2.1.tgz#b097010547668c7e337028ebe816ebe36c8a8d54" - dependencies: - loose-envify "^1.0.0" - -is-absolute@^0.2.3: - version "0.2.6" - resolved "https://registry.npmjs.org/is-absolute/-/is-absolute-0.2.6.tgz#20de69f3db942ef2d87b9c2da36f172235b1b5eb" - dependencies: - is-relative "^0.2.1" - is-windows "^0.2.0" - -is-arrayish@^0.2.1: - version "0.2.1" - resolved "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz#77c99840527aa8ecb1a8ba697b80645a7a926a9d" - -is-binary-path@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/is-binary-path/-/is-binary-path-1.0.1.tgz#75f16642b480f187a711c814161fd3a4a7655898" - dependencies: - binary-extensions "^1.0.0" - -is-buffer@^1.0.2: - version "1.1.4" - resolved "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.4.tgz#cfc86ccd5dc5a52fa80489111c6920c457e2d98b" - -is-builtin-module@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/is-builtin-module/-/is-builtin-module-1.0.0.tgz#540572d34f7ac3119f8f76c30cbc1b1e037affbe" - dependencies: - builtin-modules "^1.0.0" - -is-dotfile@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/is-dotfile/-/is-dotfile-1.0.2.tgz#2c132383f39199f8edc268ca01b9b007d205cc4d" - -is-equal-shallow@^0.1.3: - version "0.1.3" - resolved "https://registry.npmjs.org/is-equal-shallow/-/is-equal-shallow-0.1.3.tgz#2238098fc221de0bcfa5d9eac4c45d638aa1c534" - dependencies: - is-primitive "^2.0.0" - -is-extendable@^0.1.0, is-extendable@^0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz#62b110e289a471418e3ec36a617d472e301dfc89" - -is-extglob@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/is-extglob/-/is-extglob-1.0.0.tgz#ac468177c4943405a092fc8f29760c6ffc6206c0" - -is-extglob@^2.1.0: - version "2.1.0" - resolved "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.0.tgz#33411a482b046bf95e6b0cb27ee2711af4cf15ad" - -is-finite@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/is-finite/-/is-finite-1.0.2.tgz#cc6677695602be550ef11e8b4aa6305342b6d0aa" - dependencies: - number-is-nan "^1.0.0" - -is-fullwidth-code-point@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-1.0.0.tgz#ef9e31386f031a7f0d643af82fde50c457ef00cb" - dependencies: - number-is-nan "^1.0.0" - -is-glob@^2.0.0, is-glob@^2.0.1: - version "2.0.1" - resolved "https://registry.npmjs.org/is-glob/-/is-glob-2.0.1.tgz#d096f926a3ded5600f3fdfd91198cb0888c2d863" - dependencies: - is-extglob "^1.0.0" - -is-glob@^3.1.0: - version "3.1.0" - resolved "https://registry.npmjs.org/is-glob/-/is-glob-3.1.0.tgz#7ba5ae24217804ac70707b96922567486cc3e84a" - dependencies: - is-extglob "^2.1.0" - -is-my-json-valid@^2.12.0, is-my-json-valid@^2.12.4: - version "2.15.0" - resolved "https://registry.npmjs.org/is-my-json-valid/-/is-my-json-valid-2.15.0.tgz#936edda3ca3c211fd98f3b2d3e08da43f7b2915b" - dependencies: - generate-function "^2.0.0" - generate-object-property "^1.1.0" - jsonpointer "^4.0.0" - xtend "^4.0.0" - -is-npm@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/is-npm/-/is-npm-1.0.0.tgz#f2fb63a65e4905b406c86072765a1a4dc793b9f4" - -is-number@^0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/is-number/-/is-number-0.1.1.tgz#69a7af116963d47206ec9bd9b48a14216f1e3806" - -is-number@^2.0.2, is-number@^2.1.0: - version "2.1.0" - resolved "https://registry.npmjs.org/is-number/-/is-number-2.1.0.tgz#01fcbbb393463a548f2f466cce16dece49db908f" - dependencies: - kind-of "^3.0.2" - -is-obj@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/is-obj/-/is-obj-1.0.1.tgz#3e4729ac1f5fde025cd7d83a896dab9f4f67db0f" - -is-plain-obj@^1.0.0: - version "1.1.0" - resolved "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-1.1.0.tgz#71a50c8429dfca773c92a390a4a03b39fcd51d3e" - -is-posix-bracket@^0.1.0: - version "0.1.1" - resolved "https://registry.npmjs.org/is-posix-bracket/-/is-posix-bracket-0.1.1.tgz#3334dc79774368e92f016e6fbc0a88f5cd6e6bc4" - -is-primitive@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/is-primitive/-/is-primitive-2.0.0.tgz#207bab91638499c07b2adf240a41a87210034575" - -is-property@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/is-property/-/is-property-1.0.2.tgz#57fe1c4e48474edd65b09911f26b1cd4095dda84" - -is-redirect@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/is-redirect/-/is-redirect-1.0.0.tgz#1d03dded53bd8db0f30c26e4f95d36fc7c87dc24" - -is-relative@^0.2.1: - version "0.2.1" - resolved "https://registry.npmjs.org/is-relative/-/is-relative-0.2.1.tgz#d27f4c7d516d175fb610db84bbeef23c3bc97aa5" - dependencies: - is-unc-path "^0.1.1" - -is-retry-allowed@^1.0.0: - version "1.1.0" - resolved "https://registry.npmjs.org/is-retry-allowed/-/is-retry-allowed-1.1.0.tgz#11a060568b67339444033d0125a61a20d564fb34" - -is-stream@^1.0.0, is-stream@^1.0.1: - version "1.1.0" - resolved "https://registry.npmjs.org/is-stream/-/is-stream-1.1.0.tgz#12d4a3dd4e68e0b79ceb8dbc84173ae80d91ca44" - -is-subset@^0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/is-subset/-/is-subset-0.1.1.tgz#8a59117d932de1de00f245fcdd39ce43f1e939a6" - -is-text-path@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/is-text-path/-/is-text-path-1.0.1.tgz#4e1aa0fb51bfbcb3e92688001397202c1775b66e" - dependencies: - text-extensions "^1.0.0" - -is-typedarray@~1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/is-typedarray/-/is-typedarray-1.0.0.tgz#e479c80858df0c1b11ddda6940f96011fcda4a9a" - -is-unc-path@^0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/is-unc-path/-/is-unc-path-0.1.1.tgz#ab2533d77ad733561124c3dc0f5cd8b90054c86b" - dependencies: - unc-path-regex "^0.1.0" - -is-utf8@^0.2.0: - version "0.2.1" - resolved "https://registry.npmjs.org/is-utf8/-/is-utf8-0.2.1.tgz#4b0da1442104d1b336340e80797e865cf39f7d72" - -is-valid-glob@^0.3.0: - version "0.3.0" - resolved "https://registry.npmjs.org/is-valid-glob/-/is-valid-glob-0.3.0.tgz#d4b55c69f51886f9b65c70d6c2622d37e29f48fe" - -is-windows@^0.2.0: - version "0.2.0" - resolved "https://registry.npmjs.org/is-windows/-/is-windows-0.2.0.tgz#de1aa6d63ea29dd248737b69f1ff8b8002d2108c" - -isarray@~1.0.0, isarray@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz#bb935d48582cba168c06834957a54a3e07124f11" - -isarray@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/isarray/-/isarray-0.0.1.tgz#8a18acfca9a8f4177e09abfc6038939b05d1eedf" - -isbinaryfile@^3.0.0: - version "3.0.1" - resolved "https://registry.npmjs.org/isbinaryfile/-/isbinaryfile-3.0.1.tgz#6e99573675372e841a0520c036b41513d783e79e" - -isemail@1.x.x: - version "1.2.0" - resolved "https://registry.npmjs.org/isemail/-/isemail-1.2.0.tgz#be03df8cc3e29de4d2c5df6501263f1fa4595e9a" - -isexe@^1.1.1: - version "1.1.2" - resolved "https://registry.npmjs.org/isexe/-/isexe-1.1.2.tgz#36f3e22e60750920f5e7241a476a8c6a42275ad0" - -isobject@^2.0.0, isobject@^2.1.0: - version "2.1.0" - resolved "https://registry.npmjs.org/isobject/-/isobject-2.1.0.tgz#f065561096a3f1da2ef46272f815c840d87e0c89" - dependencies: - isarray "1.0.0" - -isstream@~0.1.1, isstream@~0.1.2: - version "0.1.2" - resolved "https://registry.npmjs.org/isstream/-/isstream-0.1.2.tgz#47e63f7af55afa6f92e1500e690eb8b8529c099a" - -jasmine-core@^2.4.1, jasmine-core@~2.5.2: - version "2.5.2" - resolved "https://registry.npmjs.org/jasmine-core/-/jasmine-core-2.5.2.tgz#6f61bd79061e27f43e6f9355e44b3c6cab6ff297" - -jasmine-core@~2.3.0: - version "2.3.4" - resolved "https://registry.npmjs.org/jasmine-core/-/jasmine-core-2.3.4.tgz#ad772662b32d16c564ee25c863edae1d65a038f2" - -jasmine-terminal-reporter@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/jasmine-terminal-reporter/-/jasmine-terminal-reporter-1.0.2.tgz#d38f496abe43a08eddc0d18cddf14cd118d9e44e" - dependencies: - indent-string "^2.1.0" - pluralize "^1.2.1" - -jasmine@^2.3.0, jasmine@^2.4.1: - version "2.5.2" - resolved "https://registry.npmjs.org/jasmine/-/jasmine-2.5.2.tgz#6283cef7085c095cc25d651e954df004f7e3e421" - dependencies: - exit "^0.1.2" - glob "^7.0.6" - jasmine-core "~2.5.2" - -jasmine@2.3.2: - version "2.3.2" - resolved "https://registry.npmjs.org/jasmine/-/jasmine-2.3.2.tgz#febf0e4b4afff63c2d09211f077da0b859f5f191" - dependencies: - exit "^0.1.2" - glob "^3.2.11" - jasmine-core "~2.3.0" - -jasminewd2@0.0.6: - version "0.0.6" - resolved "https://registry.npmjs.org/jasminewd2/-/jasminewd2-0.0.6.tgz#259157f06d2d149fbecb96302c80aa322a377222" - -jodid25519@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/jodid25519/-/jodid25519-1.0.2.tgz#06d4912255093419477d425633606e0e90782967" - dependencies: - jsbn "~0.1.0" - -joi-assert@0.0.3: - version "0.0.3" - resolved "https://registry.npmjs.org/joi-assert/-/joi-assert-0.0.3.tgz#77291376ac3f0b124f433f98db74b4f20f686fd6" - dependencies: - assertion-error "^1.0.0" - -joi@^4.0.0, joi@^4.7.0: - version "4.9.0" - resolved "https://registry.npmjs.org/joi/-/joi-4.9.0.tgz#2355023363089ca01bc1fd079e72949f977baada" - dependencies: - hoek "^2.2.x" - isemail "1.x.x" - moment "2.x.x" - topo "1.x.x" - -js-tokens@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/js-tokens/-/js-tokens-2.0.0.tgz#79903f5563ee778cc1162e6dcf1a0027c97f9cb5" - -js-yaml@^3.1.0: - version "3.6.1" - resolved "https://registry.npmjs.org/js-yaml/-/js-yaml-3.6.1.tgz#6e5fe67d8b205ce4d22fad05b7781e8dadcc4b30" - dependencies: - argparse "^1.0.7" - esprima "^2.6.0" - -jsbn@~0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/jsbn/-/jsbn-0.1.0.tgz#650987da0dd74f4ebf5a11377a2aa2d273e97dfd" - -jsesc@^0.5.0: - version "0.5.0" - resolved "https://registry.npmjs.org/jsesc/-/jsesc-0.5.0.tgz#e7dee66e35d6fc16f710fe91d5cf69f70f08911d" - -jsesc@^1.3.0: - version "1.3.0" - resolved "https://registry.npmjs.org/jsesc/-/jsesc-1.3.0.tgz#46c3fec8c1892b12b0833db9bc7622176dbab34b" - -json-pointer@^0.2.2: - version "0.2.2" - resolved "https://registry.npmjs.org/json-pointer/-/json-pointer-0.2.2.tgz#1a78285d4650c50b10475f7f59919a99db8a164b" - dependencies: - foreach "^2.0.4" - -json-schema@0.2.3: - version "0.2.3" - resolved "https://registry.npmjs.org/json-schema/-/json-schema-0.2.3.tgz#b480c892e59a2f05954ce727bd3f2a4e882f9e13" - -json-stable-stringify@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/json-stable-stringify/-/json-stable-stringify-1.0.1.tgz#9a759d39c5f2ff503fd5300646ed445f88c4f9af" - dependencies: - jsonify "~0.0.0" - -json-stringify-safe@^5.0.1, json-stringify-safe@~5.0.0, json-stringify-safe@~5.0.1: - version "5.0.1" - resolved "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz#1296a2d58fd45f19a0f6ce01d65701e2c735b6eb" - -json@^9.0.3: - version "9.0.4" - resolved "https://registry.npmjs.org/json/-/json-9.0.4.tgz#d0dbf2404c128572a935ecafadfc782ec81112ce" - -json3@3.2.6: - version "3.2.6" - resolved "https://registry.npmjs.org/json3/-/json3-3.2.6.tgz#f6efc93c06a04de9aec53053df2559bb19e2038b" - -json3@3.3.2: - version "3.3.2" - resolved "https://registry.npmjs.org/json3/-/json3-3.3.2.tgz#3c0434743df93e2f5c42aee7b19bcb483575f4e1" - -json5@^0.5.0: - version "0.5.0" - resolved "https://registry.npmjs.org/json5/-/json5-0.5.0.tgz#9b20715b026cbe3778fd769edccd822d8332a5b2" - -jsonfile@^2.1.0: - version "2.4.0" - resolved "https://registry.npmjs.org/jsonfile/-/jsonfile-2.4.0.tgz#3736a2b428b87bbda0cc83b53fa3d633a35c2ae8" - optionalDependencies: - graceful-fs "^4.1.6" - -jsonify@~0.0.0: - version "0.0.0" - resolved "https://registry.npmjs.org/jsonify/-/jsonify-0.0.0.tgz#2c74b6ee41d93ca51b7b5aaee8f503631d252a73" - -jsonparse@^1.2.0: - version "1.2.0" - resolved "https://registry.npmjs.org/jsonparse/-/jsonparse-1.2.0.tgz#5c0c5685107160e72fe7489bddea0b44c2bc67bd" - -jsonpointer@^4.0.0: - version "4.0.0" - resolved "https://registry.npmjs.org/jsonpointer/-/jsonpointer-4.0.0.tgz#6661e161d2fc445f19f98430231343722e1fcbd5" - -JSONStream@^1.0.4: - version "1.2.1" - resolved "https://registry.npmjs.org/JSONStream/-/JSONStream-1.2.1.tgz#32aa5790e799481083b49b4b7fa94e23bae69bf9" - dependencies: - jsonparse "^1.2.0" - through ">=2.2.7 <3" - -jsonwebtoken@5.7.0: - version "5.7.0" - resolved "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-5.7.0.tgz#1c90f9a86ce5b748f5f979c12b70402b4afcddb4" - dependencies: - jws "^3.0.0" - ms "^0.7.1" - xtend "^4.0.1" - -jsprim@^1.2.2: - version "1.3.1" - resolved "https://registry.npmjs.org/jsprim/-/jsprim-1.3.1.tgz#2a7256f70412a29ee3670aaca625994c4dcff252" - dependencies: - extsprintf "1.0.2" - json-schema "0.2.3" - verror "1.3.6" - -jwa@^1.1.2: - version "1.1.3" - resolved "https://registry.npmjs.org/jwa/-/jwa-1.1.3.tgz#fa9f2f005ff0c630e7c41526a31f37f79733cd6d" - dependencies: - base64url "~1.0.4" - buffer-equal-constant-time "^1.0.1" - ecdsa-sig-formatter "^1.0.0" - -jws@^3.0.0: - version "3.1.3" - resolved "https://registry.npmjs.org/jws/-/jws-3.1.3.tgz#b88f1b4581a2c5ee8813c06b3fdf90ea9b5c7e6c" - dependencies: - base64url "~1.0.4" - jwa "^1.1.2" - -jwt-simple@^0.3.1: - version "0.3.1" - resolved "https://registry.npmjs.org/jwt-simple/-/jwt-simple-0.3.1.tgz#86e0b121d149534423dbd8044a727e3cf1eb939e" - -karma-chrome-launcher@^0.2.2: - version "0.2.3" - resolved "https://registry.npmjs.org/karma-chrome-launcher/-/karma-chrome-launcher-0.2.3.tgz#4c6d700d163a9d34c618efd87918be49e7a4a8c9" - dependencies: - fs-access "^1.0.0" - which "^1.2.1" - -karma-firefox-launcher@^0.1.7: - version "0.1.7" - resolved "https://registry.npmjs.org/karma-firefox-launcher/-/karma-firefox-launcher-0.1.7.tgz#c05dd86533691e62f31952595098e8bd357d39f3" - -karma-jasmine@^0.3.6: - version "0.3.8" - resolved "https://registry.npmjs.org/karma-jasmine/-/karma-jasmine-0.3.8.tgz#5b6457791ad9b89aa173f079e3ebe1b8c805236c" - -karma-mocha-reporter@^2.0.2: - version "2.2.0" - resolved "https://registry.npmjs.org/karma-mocha-reporter/-/karma-mocha-reporter-2.2.0.tgz#20367b93f6651cd2c0d06b10d4eea3b81181fb4e" - dependencies: - chalk "1.1.3" - -karma-systemjs@^0.10.0: - version "0.10.0" - resolved "https://registry.npmjs.org/karma-systemjs/-/karma-systemjs-0.10.0.tgz#1b741befa6668210f68945ce134cd8a394f622c1" - dependencies: - lodash "^3.10.1" - minimatch "^3.0.0" - -karma@^0.13.19: - version "0.13.22" - resolved "https://registry.npmjs.org/karma/-/karma-0.13.22.tgz#07750b1bd063d7e7e7b91bcd2e6354d8f2aa8744" - dependencies: - batch "^0.5.3" - bluebird "^2.9.27" - body-parser "^1.12.4" - chokidar "^1.4.1" - colors "^1.1.0" - connect "^3.3.5" - core-js "^2.1.0" - di "^0.0.1" - dom-serialize "^2.2.0" - expand-braces "^0.1.1" - glob "^7.0.0" - graceful-fs "^4.1.2" - http-proxy "^1.13.0" - isbinaryfile "^3.0.0" - lodash "^3.8.0" - log4js "^0.6.31" - mime "^1.3.4" - minimatch "^3.0.0" - optimist "^0.6.1" - rimraf "^2.3.3" - socket.io "^1.4.5" - source-map "^0.5.3" - useragent "^2.1.6" - -kind-of@^3.0.2: - version "3.0.4" - resolved "https://registry.npmjs.org/kind-of/-/kind-of-3.0.4.tgz#7b8ecf18a4e17f8269d73b501c9f232c96887a74" - dependencies: - is-buffer "^1.0.2" - -klaw@^1.0.0: - version "1.3.1" - resolved "https://registry.npmjs.org/klaw/-/klaw-1.3.1.tgz#4088433b46b3b1ba259d78785d8e96f73ba02439" - optionalDependencies: - graceful-fs "^4.1.9" - -latest-version@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/latest-version/-/latest-version-1.0.1.tgz#72cfc46e3e8d1be651e1ebb54ea9f6ea96f374bb" - dependencies: - package-json "^1.0.0" - -latest-version@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/latest-version/-/latest-version-2.0.0.tgz#56f8d6139620847b8017f8f1f4d78e211324168b" - dependencies: - package-json "^2.0.0" - -lazy-cache@^1.0.3: - version "1.0.4" - resolved "https://registry.npmjs.org/lazy-cache/-/lazy-cache-1.0.4.tgz#a1d78fc3a50474cb80845d3b3b6e1da49a446e8e" - -lazy-req@^1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/lazy-req/-/lazy-req-1.1.0.tgz#bdaebead30f8d824039ce0ce149d4daa07ba1fac" - -lazy.js@~0.3.2: - version "0.3.2" - resolved "https://registry.npmjs.org/lazy.js/-/lazy.js-0.3.2.tgz#7cc1107e5f809ae70498f511dd180e1f80b4efa9" - -lazystream@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/lazystream/-/lazystream-1.0.0.tgz#f6995fe0f820392f61396be89462407bb77168e4" - dependencies: - readable-stream "^2.0.5" - -liftoff@^2.1.0: - version "2.3.0" - resolved "https://registry.npmjs.org/liftoff/-/liftoff-2.3.0.tgz#a98f2ff67183d8ba7cfaca10548bd7ff0550b385" - dependencies: - extend "^3.0.0" - findup-sync "^0.4.2" - fined "^1.0.1" - flagged-respawn "^0.3.2" - lodash.isplainobject "^4.0.4" - lodash.isstring "^4.0.1" - lodash.mapvalues "^4.4.0" - rechoir "^0.6.2" - resolve "^1.1.7" - -listify@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/listify/-/listify-1.0.0.tgz#03ca7ba2d150d4267773f74e57558d1053d2bee3" - -load-json-file@^1.0.0: - version "1.1.0" - resolved "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz#956905708d58b4bab4c2261b04f59f31c99374c0" - dependencies: - graceful-fs "^4.1.2" - parse-json "^2.2.0" - pify "^2.0.0" - pinkie-promise "^2.0.0" - strip-bom "^2.0.0" - -lockfile@^1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/lockfile/-/lockfile-1.0.2.tgz#97e1990174f696cbe0a3acd58a43b84aa30c7c83" - -lodash._basecopy@^3.0.0: - version "3.0.1" - resolved "https://registry.npmjs.org/lodash._basecopy/-/lodash._basecopy-3.0.1.tgz#8da0e6a876cf344c0ad8a54882111dd3c5c7ca36" - -lodash._basetostring@^3.0.0: - version "3.0.1" - resolved "https://registry.npmjs.org/lodash._basetostring/-/lodash._basetostring-3.0.1.tgz#d1861d877f824a52f669832dcaf3ee15566a07d5" - -lodash._basevalues@^3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/lodash._basevalues/-/lodash._basevalues-3.0.0.tgz#5b775762802bde3d3297503e26300820fdf661b7" - -lodash._getnative@^3.0.0: - version "3.9.1" - resolved "https://registry.npmjs.org/lodash._getnative/-/lodash._getnative-3.9.1.tgz#570bc7dede46d61cdcde687d65d3eecbaa3aaff5" - -lodash._isiterateecall@^3.0.0: - version "3.0.9" - resolved "https://registry.npmjs.org/lodash._isiterateecall/-/lodash._isiterateecall-3.0.9.tgz#5203ad7ba425fae842460e696db9cf3e6aac057c" - -lodash._reescape@^3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/lodash._reescape/-/lodash._reescape-3.0.0.tgz#2b1d6f5dfe07c8a355753e5f27fac7f1cde1616a" - -lodash._reevaluate@^3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/lodash._reevaluate/-/lodash._reevaluate-3.0.0.tgz#58bc74c40664953ae0b124d806996daca431e2ed" - -lodash._reinterpolate@^3.0.0, lodash._reinterpolate@~3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/lodash._reinterpolate/-/lodash._reinterpolate-3.0.0.tgz#0ccf2d89166af03b3663c796538b75ac6e114d9d" - -lodash._root@^3.0.0: - version "3.0.1" - resolved "https://registry.npmjs.org/lodash._root/-/lodash._root-3.0.1.tgz#fba1c4524c19ee9a5f8136b4609f017cf4ded692" - -lodash.assignwith@^4.0.7: - version "4.2.0" - resolved "https://registry.npmjs.org/lodash.assignwith/-/lodash.assignwith-4.2.0.tgz#127a97f02adc41751a954d24b0de17e100e038eb" - -lodash.escape@^3.0.0: - version "3.2.0" - resolved "https://registry.npmjs.org/lodash.escape/-/lodash.escape-3.2.0.tgz#995ee0dc18c1b48cc92effae71a10aab5b487698" - dependencies: - lodash._root "^3.0.0" - -lodash.isarguments@^3.0.0: - version "3.1.0" - resolved "https://registry.npmjs.org/lodash.isarguments/-/lodash.isarguments-3.1.0.tgz#2f573d85c6a24289ff00663b491c1d338ff3458a" - -lodash.isarray@^3.0.0: - version "3.0.4" - resolved "https://registry.npmjs.org/lodash.isarray/-/lodash.isarray-3.0.4.tgz#79e4eb88c36a8122af86f844aa9bcd851b5fbb55" - -lodash.isempty@^4.2.1: - version "4.4.0" - resolved "https://registry.npmjs.org/lodash.isempty/-/lodash.isempty-4.4.0.tgz#6f86cbedd8be4ec987be9aaf33c9684db1b31e7e" - -lodash.isequal@^4.0.0: - version "4.4.0" - resolved "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.4.0.tgz#6295768e98e14dc15ce8d362ef6340db82852031" - -lodash.isplainobject@^4.0.4: - version "4.0.6" - resolved "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz#7c526a52d89b45c45cc690b88163be0497f550cb" - -lodash.isstring@^4.0.1: - version "4.0.1" - resolved "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz#d527dfb5456eca7cc9bb95d5daeaf88ba54a5451" - -lodash.keys@^3.0.0: - version "3.1.2" - resolved "https://registry.npmjs.org/lodash.keys/-/lodash.keys-3.1.2.tgz#4dbc0472b156be50a0b286855d1bd0b0c656098a" - dependencies: - lodash._getnative "^3.0.0" - lodash.isarguments "^3.0.0" - lodash.isarray "^3.0.0" - -lodash.mapvalues@^4.4.0: - version "4.6.0" - resolved "https://registry.npmjs.org/lodash.mapvalues/-/lodash.mapvalues-4.6.0.tgz#1bafa5005de9dd6f4f26668c30ca37230cc9689c" - -lodash.pick@^4.2.1: - version "4.4.0" - resolved "https://registry.npmjs.org/lodash.pick/-/lodash.pick-4.4.0.tgz#52f05610fff9ded422611441ed1fc123a03001b3" - -lodash.restparam@^3.0.0: - version "3.6.1" - resolved "https://registry.npmjs.org/lodash.restparam/-/lodash.restparam-3.6.1.tgz#936a4e309ef330a7645ed4145986c85ae5b20805" - -lodash.template@^3.0.0: - version "3.6.2" - resolved "https://registry.npmjs.org/lodash.template/-/lodash.template-3.6.2.tgz#f8cdecc6169a255be9098ae8b0c53d378931d14f" - dependencies: - lodash._basecopy "^3.0.0" - lodash._basetostring "^3.0.0" - lodash._basevalues "^3.0.0" - lodash._isiterateecall "^3.0.0" - lodash._reinterpolate "^3.0.0" - lodash.escape "^3.0.0" - lodash.keys "^3.0.0" - lodash.restparam "^3.0.0" - lodash.templatesettings "^3.0.0" - -lodash.template@^4.0.2: - version "4.4.0" - resolved "https://registry.npmjs.org/lodash.template/-/lodash.template-4.4.0.tgz#e73a0385c8355591746e020b99679c690e68fba0" - dependencies: - lodash._reinterpolate "~3.0.0" - lodash.templatesettings "^4.0.0" - -lodash.templatesettings@^3.0.0: - version "3.1.1" - resolved "https://registry.npmjs.org/lodash.templatesettings/-/lodash.templatesettings-3.1.1.tgz#fb307844753b66b9f1afa54e262c745307dba8e5" - dependencies: - lodash._reinterpolate "^3.0.0" - lodash.escape "^3.0.0" - -lodash.templatesettings@^4.0.0: - version "4.1.0" - resolved "https://registry.npmjs.org/lodash.templatesettings/-/lodash.templatesettings-4.1.0.tgz#2b4d4e95ba440d915ff08bc899e4553666713316" - dependencies: - lodash._reinterpolate "~3.0.0" - -lodash@^3.10.1, lodash@^3.8.0, lodash@3.10.1: - version "3.10.1" - resolved "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz#5bf45e8e49ba4189e17d482789dfd15bd140b7b6" - -lodash@^4.0.0, lodash@^4.1.0, lodash@^4.2.0, lodash@^4.2.1, lodash@^4.5.1: - version "4.16.4" - resolved "https://registry.npmjs.org/lodash/-/lodash-4.16.4.tgz#01ce306b9bad1319f2a5528674f88297aeb70127" - -lodash@~1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/lodash/-/lodash-1.0.2.tgz#8f57560c83b59fc270bd3d561b690043430e2551" - -lodash@~2.4.1: - version "2.4.2" - resolved "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz#fadd834b9683073da179b3eae6d9c0d15053f73e" - -log-update@^1.0.2: - version "1.0.2" - resolved "https://registry.npmjs.org/log-update/-/log-update-1.0.2.tgz#19929f64c4093d2d2e7075a1dad8af59c296b8d1" - dependencies: - ansi-escapes "^1.0.0" - cli-cursor "^1.0.2" - -log4js@^0.6.31: - version "0.6.38" - resolved "https://registry.npmjs.org/log4js/-/log4js-0.6.38.tgz#2c494116695d6fb25480943d3fc872e662a522fd" - dependencies: - readable-stream "~1.0.2" - semver "~4.3.3" - -longest@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/longest/-/longest-1.0.1.tgz#30a0b2da38f73770e8294a0d22e6625ed77d0097" - -loose-envify@^1.0.0: - version "1.3.0" - resolved "https://registry.npmjs.org/loose-envify/-/loose-envify-1.3.0.tgz#6b26248c42f6d4fa4b0d8542f78edfcde35642a8" - dependencies: - js-tokens "^2.0.0" - -loud-rejection@^1.0.0: - version "1.6.0" - resolved "https://registry.npmjs.org/loud-rejection/-/loud-rejection-1.6.0.tgz#5b46f80147edee578870f086d04821cf998e551f" - dependencies: - currently-unhandled "^0.4.1" - signal-exit "^3.0.0" - -lowercase-keys@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/lowercase-keys/-/lowercase-keys-1.0.0.tgz#4e3366b39e7f5457e35f1324bdf6f88d0bfc7306" - -lru-cache@^2.5.0, lru-cache@2: - version "2.7.3" - resolved "https://registry.npmjs.org/lru-cache/-/lru-cache-2.7.3.tgz#6d4524e8b955f95d4f5b58851ce21dd72fb4e952" - -lru-cache@~2.5.0: - version "2.5.2" - resolved "https://registry.npmjs.org/lru-cache/-/lru-cache-2.5.2.tgz#1fddad938aae1263ce138680be1b3f591c0ab41c" - -lru-cache@2.2.x: - version "2.2.4" - resolved "https://registry.npmjs.org/lru-cache/-/lru-cache-2.2.4.tgz#6c658619becf14031d0d0b594b16042ce4dc063d" - -make-error-cause@^1.2.1: - version "1.2.2" - resolved "https://registry.npmjs.org/make-error-cause/-/make-error-cause-1.2.2.tgz#df0388fcd0b37816dff0a5fb8108939777dcbc9d" - dependencies: - make-error "^1.2.0" - -make-error@^1.2.0: - version "1.2.1" - resolved "https://registry.npmjs.org/make-error/-/make-error-1.2.1.tgz#9a6dfb4844423b9f145806728d05c6e935670e75" - -map-cache@^0.2.0: - version "0.2.2" - resolved "https://registry.npmjs.org/map-cache/-/map-cache-0.2.2.tgz#c32abd0bd6525d9b051645bb4f26ac5dc98a0dbf" - -map-obj@^1.0.0, map-obj@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/map-obj/-/map-obj-1.0.1.tgz#d933ceb9205d82bdcf4886f6742bdc2b4dea146d" - -map-stream@~0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/map-stream/-/map-stream-0.1.0.tgz#e56aa94c4c8055a16404a0674b78f215f7c8e194" - -marked@^0.3.5: - version "0.3.6" - resolved "https://registry.npmjs.org/marked/-/marked-0.3.6.tgz#b2c6c618fccece4ef86c4fc6cb8a7cbf5aeda8d7" - -media-typer@0.3.0: - version "0.3.0" - resolved "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz#8710d7af0aa626f8fffa1ce00168545263255748" - -meow@^3.3.0, meow@^3.7.0: - version "3.7.0" - resolved "https://registry.npmjs.org/meow/-/meow-3.7.0.tgz#72cb668b425228290abbfa856892587308a801fb" - dependencies: - camelcase-keys "^2.0.0" - decamelize "^1.1.2" - loud-rejection "^1.0.0" - map-obj "^1.0.1" - minimist "^1.1.3" - normalize-package-data "^2.3.4" - object-assign "^4.0.1" - read-pkg-up "^1.0.1" - redent "^1.0.0" - trim-newlines "^1.0.0" - -meow@~2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/meow/-/meow-2.0.0.tgz#8f530a8ecf5d40d3f4b4df93c3472900fba2a8f1" - dependencies: - camelcase-keys "^1.0.0" - indent-string "^1.1.0" - minimist "^1.1.0" - object-assign "^1.0.0" - -merge-stream@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/merge-stream/-/merge-stream-1.0.0.tgz#9cfd156fef35421e2b5403ce11dc6eb1962b026e" - dependencies: - readable-stream "^2.0.1" - -micromatch@^2.1.5, micromatch@^2.3.7: - version "2.3.11" - resolved "https://registry.npmjs.org/micromatch/-/micromatch-2.3.11.tgz#86677c97d1720b363431d04d0d15293bd38c1565" - dependencies: - arr-diff "^2.0.0" - array-unique "^0.2.1" - braces "^1.8.2" - expand-brackets "^0.1.4" - extglob "^0.3.1" - filename-regex "^2.0.0" - is-extglob "^1.0.0" - is-glob "^2.0.1" - kind-of "^3.0.2" - normalize-path "^2.0.1" - object.omit "^2.0.0" - parse-glob "^3.0.4" - regex-cache "^0.4.2" - -mime-db@~1.12.0: - version "1.12.0" - resolved "https://registry.npmjs.org/mime-db/-/mime-db-1.12.0.tgz#3d0c63180f458eb10d325aaa37d7c58ae312e9d7" - -mime-db@~1.24.0: - version "1.24.0" - resolved "https://registry.npmjs.org/mime-db/-/mime-db-1.24.0.tgz#e2d13f939f0016c6e4e9ad25a8652f126c467f0c" - -mime-types@^2.1.12, mime-types@~2.1.11, mime-types@~2.1.7: - version "2.1.12" - resolved "https://registry.npmjs.org/mime-types/-/mime-types-2.1.12.tgz#152ba256777020dd4663f54c2e7bc26381e71729" - dependencies: - mime-db "~1.24.0" - -mime-types@~2.0.1, mime-types@~2.0.3: - version "2.0.14" - resolved "https://registry.npmjs.org/mime-types/-/mime-types-2.0.14.tgz#310e159db23e077f8bb22b748dabfa4957140aa6" - dependencies: - mime-db "~1.12.0" - -mime@^1.2.11, mime@^1.3.4: - version "1.3.4" - resolved "https://registry.npmjs.org/mime/-/mime-1.3.4.tgz#115f9e3b6b3daf2959983cb38f149a2d40eb5d53" - -minichain@~0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/minichain/-/minichain-0.0.1.tgz#0bae49774170d8931401c271bb6ed6d3992a9f52" - dependencies: - ministyle "~0.1.2" - miniwrite "~0.1.2" - -minimatch@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/minimatch/-/minimatch-1.0.0.tgz#e0dd2120b49e1b724ce8d714c520822a9438576d" - dependencies: - lru-cache "2" - sigmund "~1.0.0" - -minimatch@^2.0.1: - version "2.0.10" - resolved "https://registry.npmjs.org/minimatch/-/minimatch-2.0.10.tgz#8d087c39c6b38c001b97fca7ce6d0e1e80afbac7" - dependencies: - brace-expansion "^1.0.0" - -minimatch@^3.0.0, minimatch@^3.0.2, "minimatch@2 || 3": - version "3.0.3" - resolved "https://registry.npmjs.org/minimatch/-/minimatch-3.0.3.tgz#2a4e4090b96b2db06a9d7df01055a62a77c9b774" - dependencies: - brace-expansion "^1.0.0" - -minimatch@~0.2.11: - version "0.2.14" - resolved "https://registry.npmjs.org/minimatch/-/minimatch-0.2.14.tgz#c74e780574f63c6f9a090e90efbe6ef53a6a756a" - dependencies: - lru-cache "2" - sigmund "~1.0.0" - -minimatch@0.3: - version "0.3.0" - resolved "https://registry.npmjs.org/minimatch/-/minimatch-0.3.0.tgz#275d8edaac4f1bb3326472089e7949c8394699dd" - dependencies: - lru-cache "2" - sigmund "~1.0.0" - -minimist@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/minimist/-/minimist-0.1.0.tgz#99df657a52574c21c9057497df742790b2b4c0de" - -minimist@^1.1.0, minimist@^1.1.3, minimist@^1.2.0: - version "1.2.0" - resolved "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz#a35008b20f41383eec1fb914f4cd5df79a264284" - -minimist@~0.0.1: - version "0.0.10" - resolved "https://registry.npmjs.org/minimist/-/minimist-0.0.10.tgz#de3f98543dbf96082be48ad1a0c7cda836301dcf" - -minimist@0.0.8: - version "0.0.8" - resolved "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz#857fcabfc3397d2625b8228262e86aa7a011b05d" - -ministyle@~0.1.2, ministyle@~0.1.3: - version "0.1.4" - resolved "https://registry.npmjs.org/ministyle/-/ministyle-0.1.4.tgz#b10481eb16aa8f7b6cd983817393a44da0e5a0cd" - -minitable@0.0.4: - version "0.0.4" - resolved "https://registry.npmjs.org/minitable/-/minitable-0.0.4.tgz#8d61cb78fae6f371d8051ce77e8a7831ce3d5396" - dependencies: - minichain "~0.0.1" - ministyle "~0.1.2" - miniwrite "~0.1.2" - -miniwrite@~0.1.2, miniwrite@~0.1.3: - version "0.1.4" - resolved "https://registry.npmjs.org/miniwrite/-/miniwrite-0.1.4.tgz#72f02385c0ac37d542efe27dc6764b31908725ce" - dependencies: - mkdirp "~0.3.5" - -mkdirp@^0.5.0, mkdirp@^0.5.1, "mkdirp@>=0.5 0", mkdirp@~0.5.0, mkdirp@~0.5.1, mkdirp@0.5.x: - version "0.5.1" - resolved "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz#30057438eac6cf7f8c4767f38648d6697d75c903" - dependencies: - minimist "0.0.8" - -mkdirp@~0.3.5: - version "0.3.5" - resolved "https://registry.npmjs.org/mkdirp/-/mkdirp-0.3.5.tgz#de3e5f8961c88c787ee1368df849ac4413eca8d7" - -modify-values@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/modify-values/-/modify-values-1.0.0.tgz#e2b6cdeb9ce19f99317a53722f3dbf5df5eaaab2" - -moment@^2.11.2, moment@2.x.x: - version "2.15.2" - resolved "https://registry.npmjs.org/moment/-/moment-2.15.2.tgz#1bfdedf6a6e345f322fe956d5df5bd08a8ce84dc" - -ms@^0.7.1: - version "0.7.2" - resolved "https://registry.npmjs.org/ms/-/ms-0.7.2.tgz#ae25cf2512b3885a1d95d7f037868d8431124765" - -ms@0.7.1: - version "0.7.1" - resolved "https://registry.npmjs.org/ms/-/ms-0.7.1.tgz#9cd13c03adbff25b65effde7ce864ee952017098" - -multipipe@^0.1.2: - version "0.1.2" - resolved "https://registry.npmjs.org/multipipe/-/multipipe-0.1.2.tgz#2a8f2ddf70eed564dff2d57f1e1a137d9f05078b" - dependencies: - duplexer2 "0.0.2" - -nan@^2.0.5, nan@^2.3.0: - version "2.4.0" - resolved "https://registry.npmjs.org/nan/-/nan-2.4.0.tgz#fb3c59d45fe4effe215f0b890f8adf6eb32d2232" - -native-or-bluebird@1.2.0: - version "1.2.0" - resolved "https://registry.npmjs.org/native-or-bluebird/-/native-or-bluebird-1.2.0.tgz#39c47bfd7825d1fb9ffad32210ae25daadf101c9" - -natives@^1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/natives/-/natives-1.1.0.tgz#e9ff841418a6b2ec7a495e939984f78f163e6e31" - -ncp@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/ncp/-/ncp-2.0.0.tgz#195a21d6c46e361d2fb1281ba38b91e9df7bdbb3" - -negotiator@0.6.1: - version "0.6.1" - resolved "https://registry.npmjs.org/negotiator/-/negotiator-0.6.1.tgz#2b327184e8992101177b28563fb5e7102acd0ca9" - -nested-error-stacks@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/nested-error-stacks/-/nested-error-stacks-1.0.2.tgz#19f619591519f096769a5ba9a86e6eeec823c3cf" - dependencies: - inherits "~2.0.1" - -node-pre-gyp@^0.6.29: - version "0.6.31" - resolved "https://registry.npmjs.org/node-pre-gyp/-/node-pre-gyp-0.6.31.tgz#d8a00ddaa301a940615dbcc8caad4024d58f6017" - dependencies: - mkdirp "~0.5.1" - nopt "~3.0.6" - npmlog "^4.0.0" - rc "~1.1.6" - request "^2.75.0" - rimraf "~2.5.4" - semver "~5.3.0" - tar "~2.2.1" - tar-pack "~3.3.0" - -node-status-codes@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/node-status-codes/-/node-status-codes-1.0.0.tgz#5ae5541d024645d32a58fcddc9ceecea7ae3ac2f" - -node-uuid@~1.4.0, node-uuid@~1.4.7, node-uuid@1.x: - version "1.4.7" - resolved "https://registry.npmjs.org/node-uuid/-/node-uuid-1.4.7.tgz#6da5a17668c4b3dd59623bda11cf7fa4c1f60a6f" - -nopt@~1.0.10: - version "1.0.10" - resolved "https://registry.npmjs.org/nopt/-/nopt-1.0.10.tgz#6ddd21bd2a31417b92727dd585f8a6f37608ebee" - dependencies: - abbrev "1" - -nopt@~3.0.6: - version "3.0.6" - resolved "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz#c6465dbf08abcd4db359317f79ac68a646b28ff9" - dependencies: - abbrev "1" - -normalize-package-data@^2.3.0, normalize-package-data@^2.3.2, normalize-package-data@^2.3.4, normalize-package-data@^2.3.5: - version "2.3.5" - resolved "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.3.5.tgz#8d924f142960e1777e7ffe170543631cc7cb02df" - dependencies: - hosted-git-info "^2.1.4" - is-builtin-module "^1.0.0" - semver "2 || 3 || 4 || 5" - validate-npm-package-license "^3.0.1" - -normalize-path@^2.0.1: - version "2.0.1" - resolved "https://registry.npmjs.org/normalize-path/-/normalize-path-2.0.1.tgz#47886ac1662760d4261b7d979d241709d3ce3f7a" - -npmlog@^4.0.0: - version "4.0.0" - resolved "https://registry.npmjs.org/npmlog/-/npmlog-4.0.0.tgz#e094503961c70c1774eb76692080e8d578a9f88f" - dependencies: - are-we-there-yet "~1.1.2" - console-control-strings "~1.1.0" - gauge "~2.6.0" - set-blocking "~2.0.0" - -null-check@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/null-check/-/null-check-1.0.0.tgz#977dffd7176012b9ec30d2a39db5cf72a0439edd" - -number-is-nan@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/number-is-nan/-/number-is-nan-1.0.1.tgz#097b602b53422a522c1afb8790318336941a011d" - -oauth-sign@~0.8.0, oauth-sign@~0.8.1: - version "0.8.2" - resolved "https://registry.npmjs.org/oauth-sign/-/oauth-sign-0.8.2.tgz#46a6ab7f0aead8deae9ec0565780b7d4efeb9d43" - -object-assign@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/object-assign/-/object-assign-1.0.0.tgz#e65dc8766d3b47b4b8307465c8311da030b070a6" - -object-assign@^2.0.0: - version "2.1.1" - resolved "https://registry.npmjs.org/object-assign/-/object-assign-2.1.1.tgz#43c36e5d569ff8e4816c4efa8be02d26967c18aa" - -object-assign@^3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/object-assign/-/object-assign-3.0.0.tgz#9bedd5ca0897949bca47e7ff408062d549f587f2" - -object-assign@^4.0.0, object-assign@^4.0.1, object-assign@^4.1.0: - version "4.1.0" - resolved "https://registry.npmjs.org/object-assign/-/object-assign-4.1.0.tgz#7a3b3d0e98063d43f4c03f2e8ae6cd51a86883a0" - -object-component@0.0.3: - version "0.0.3" - resolved "https://registry.npmjs.org/object-component/-/object-component-0.0.3.tgz#f0c69aa50efc95b866c186f400a33769cb2f1291" - -object.omit@^2.0.0: - version "2.0.1" - resolved "https://registry.npmjs.org/object.omit/-/object.omit-2.0.1.tgz#1a9c744829f39dbb858c76ca3579ae2a54ebd1fa" - dependencies: - for-own "^0.1.4" - is-extendable "^0.1.1" - -object.pick@^1.1.1: - version "1.2.0" - resolved "https://registry.npmjs.org/object.pick/-/object.pick-1.2.0.tgz#b5392bee9782da6d9fb7d6afaf539779f1234c2b" - dependencies: - isobject "^2.1.0" - -on-finished@~2.3.0: - version "2.3.0" - resolved "https://registry.npmjs.org/on-finished/-/on-finished-2.3.0.tgz#20f1336481b083cd75337992a16971aa2d906947" - dependencies: - ee-first "1.1.1" - -once@^1.3.0: - version "1.4.0" - resolved "https://registry.npmjs.org/once/-/once-1.4.0.tgz#583b1aa775961d4b113ac17d9c50baef9dd76bd1" - dependencies: - wrappy "1" - -once@~1.3.0, once@~1.3.3: - version "1.3.3" - resolved "https://registry.npmjs.org/once/-/once-1.3.3.tgz#b2e261557ce4c314ec8304f3fa82663e4297ca20" - dependencies: - wrappy "1" - -onetime@^1.0.0: - version "1.1.0" - resolved "https://registry.npmjs.org/onetime/-/onetime-1.1.0.tgz#a1f7838f8314c516f05ecefcbc4ccfe04b4ed789" - -open@~0.0.5: - version "0.0.5" - resolved "https://registry.npmjs.org/open/-/open-0.0.5.tgz#42c3e18ec95466b6bf0dc42f3a2945c3f0cad8fc" - -opener@~1.4.0: - version "1.4.2" - resolved "https://registry.npmjs.org/opener/-/opener-1.4.2.tgz#b32582080042af8680c389a499175b4c54fff523" - -optimist@^0.6.1, optimist@~0.6.0, optimist@0.6.x: - version "0.6.1" - resolved "https://registry.npmjs.org/optimist/-/optimist-0.6.1.tgz#da3ea74686fa21a19a111c326e90eb15a0196686" - dependencies: - minimist "~0.0.1" - wordwrap "~0.0.2" - -options@>=0.0.5: - version "0.0.6" - resolved "https://registry.npmjs.org/options/-/options-0.0.6.tgz#ec22d312806bb53e731773e7cdaefcf1c643128f" - -orchestrator@^0.3.0: - version "0.3.7" - resolved "https://registry.npmjs.org/orchestrator/-/orchestrator-0.3.7.tgz#c45064e22c5a2a7b99734f409a95ffedc7d3c3df" - dependencies: - end-of-stream "~0.1.5" - sequencify "~0.0.7" - stream-consume "~0.1.0" - -ordered-read-streams@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/ordered-read-streams/-/ordered-read-streams-0.1.0.tgz#fd565a9af8eb4473ba69b6ed8a34352cb552f126" - -ordered-read-streams@^0.3.0: - version "0.3.0" - resolved "https://registry.npmjs.org/ordered-read-streams/-/ordered-read-streams-0.3.0.tgz#7137e69b3298bb342247a1bbee3881c80e2fd78b" - dependencies: - is-stream "^1.0.1" - readable-stream "^2.0.1" - -os-homedir@^1.0.0, os-homedir@^1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/os-homedir/-/os-homedir-1.0.2.tgz#ffbc4988336e0e833de0c168c7ef152121aa7fb3" - -os-tmpdir@^1.0.0, os-tmpdir@^1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz#bbe67406c79aa85c5cfec766fe5734555dfa1274" - -osenv@^0.1.0, osenv@^0.1.3: - version "0.1.3" - resolved "https://registry.npmjs.org/osenv/-/osenv-0.1.3.tgz#83cf05c6d6458fc4d5ac6362ea325d92f2754217" - dependencies: - os-homedir "^1.0.0" - os-tmpdir "^1.0.0" - -package-json@^1.0.0: - version "1.2.0" - resolved "https://registry.npmjs.org/package-json/-/package-json-1.2.0.tgz#c8ecac094227cdf76a316874ed05e27cc939a0e0" - dependencies: - got "^3.2.0" - registry-url "^3.0.0" - -package-json@^2.0.0: - version "2.4.0" - resolved "https://registry.npmjs.org/package-json/-/package-json-2.4.0.tgz#0d15bd67d1cbbddbb2ca222ff2edb86bcb31a8bb" - dependencies: - got "^5.0.0" - registry-auth-token "^3.0.1" - registry-url "^3.0.3" - semver "^5.1.0" - -parse-filepath@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/parse-filepath/-/parse-filepath-1.0.1.tgz#159d6155d43904d16c10ef698911da1e91969b73" - dependencies: - is-absolute "^0.2.3" - map-cache "^0.2.0" - path-root "^0.1.1" - -parse-github-repo-url@^1.3.0: - version "1.3.0" - resolved "https://registry.npmjs.org/parse-github-repo-url/-/parse-github-repo-url-1.3.0.tgz#d4de02d68e2e60f0d6a182e7a8cb21b6f38c730b" - -parse-glob@^3.0.4: - version "3.0.4" - resolved "https://registry.npmjs.org/parse-glob/-/parse-glob-3.0.4.tgz#b2c376cfb11f35513badd173ef0bb6e3a388391c" - dependencies: - glob-base "^0.3.0" - is-dotfile "^1.0.0" - is-extglob "^1.0.0" - is-glob "^2.0.0" - -parse-json@^2.1.0, parse-json@^2.2.0: - version "2.2.0" - resolved "https://registry.npmjs.org/parse-json/-/parse-json-2.2.0.tgz#f480f40434ef80741f8469099f8dea18f55a4dc9" - dependencies: - error-ex "^1.2.0" - -parse5@^1.3.2: - version "1.5.1" - resolved "https://registry.npmjs.org/parse5/-/parse5-1.5.1.tgz#9b7f3b0de32be78dc2401b17573ccaf0f6f59d94" - -parse5@^2.2.1: - version "2.2.3" - resolved "https://registry.npmjs.org/parse5/-/parse5-2.2.3.tgz#0c4fc41c1000c5e6b93d48b03f8083837834e9f6" - -parsejson@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/parsejson/-/parsejson-0.0.1.tgz#9b10c6c0d825ab589e685153826de0a3ba278bcc" - dependencies: - better-assert "~1.0.0" - -parseqs@0.0.2: - version "0.0.2" - resolved "https://registry.npmjs.org/parseqs/-/parseqs-0.0.2.tgz#9dfe70b2cddac388bde4f35b1f240fa58adbe6c7" - dependencies: - better-assert "~1.0.0" - -parseuri@0.0.4: - version "0.0.4" - resolved "https://registry.npmjs.org/parseuri/-/parseuri-0.0.4.tgz#806582a39887e1ea18dd5e2fe0e01902268e9350" - dependencies: - better-assert "~1.0.0" - -parseurl@~1.3.1: - version "1.3.1" - resolved "https://registry.npmjs.org/parseurl/-/parseurl-1.3.1.tgz#c8ab8c9223ba34888aa64a297b28853bec18da56" - -parsimmon@^0.5.0: - version "0.5.1" - resolved "https://registry.npmjs.org/parsimmon/-/parsimmon-0.5.1.tgz#247c970d7d5e99a51115b16a106de96f0eb9303b" - dependencies: - pjs "5.x" - -path-dirname@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/path-dirname/-/path-dirname-1.0.2.tgz#cc33d24d525e099a5388c0336c6e32b9160609e0" - -path-exists@^2.0.0: - version "2.1.0" - resolved "https://registry.npmjs.org/path-exists/-/path-exists-2.1.0.tgz#0feb6c64f0fc518d9a754dd5efb62c7022761f4b" - dependencies: - pinkie-promise "^2.0.0" - -path-is-absolute@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz#174b9268735534ffbc7ace6bf53a5a9e1b5c5f5f" - -path-root-regex@^0.1.0: - version "0.1.2" - resolved "https://registry.npmjs.org/path-root-regex/-/path-root-regex-0.1.2.tgz#bfccdc8df5b12dc52c8b43ec38d18d72c04ba96d" - -path-root@^0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/path-root/-/path-root-0.1.1.tgz#9a4a6814cac1c0cd73360a95f32083c8ea4745b7" - dependencies: - path-root-regex "^0.1.0" - -path-type@^1.0.0: - version "1.1.0" - resolved "https://registry.npmjs.org/path-type/-/path-type-1.1.0.tgz#59c44f7ee491da704da415da5a4070ba4f8fe441" - dependencies: - graceful-fs "^4.1.2" - pify "^2.0.0" - pinkie-promise "^2.0.0" - -pause-stream@0.0.11: - version "0.0.11" - resolved "https://registry.npmjs.org/pause-stream/-/pause-stream-0.0.11.tgz#fe5a34b0cbce12b5aa6a2b403ee2e73b602f1445" - dependencies: - through "~2.3" - -pify@^2.0.0, pify@^2.3.0: - version "2.3.0" - resolved "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz#ed141a6ac043a849ea588498e7dca8b15330e90c" - -pinkie-promise@^2.0.0: - version "2.0.1" - resolved "https://registry.npmjs.org/pinkie-promise/-/pinkie-promise-2.0.1.tgz#2135d6dfa7a358c069ac9b178776288228450ffa" - dependencies: - pinkie "^2.0.0" - -pinkie@^2.0.0: - version "2.0.4" - resolved "https://registry.npmjs.org/pinkie/-/pinkie-2.0.4.tgz#72556b80cfa0d48a974e80e77248e80ed4f7f870" - -pjs@5.x: - version "5.1.1" - resolved "https://registry.npmjs.org/pjs/-/pjs-5.1.1.tgz#9dfc4673bb01deffd6915fb1dec75827aba42abf" - -pluralize@^1.2.1: - version "1.2.1" - resolved "https://registry.npmjs.org/pluralize/-/pluralize-1.2.1.tgz#d1a21483fd22bb41e58a12fa3421823140897c45" - -popsicle-proxy-agent@^3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/popsicle-proxy-agent/-/popsicle-proxy-agent-3.0.0.tgz#b9133c55d945759ab7ee61b7711364620d3aeadc" - dependencies: - http-proxy-agent "^1.0.0" - https-proxy-agent "^1.0.0" - -popsicle-retry@^3.2.0: - version "3.2.1" - resolved "https://registry.npmjs.org/popsicle-retry/-/popsicle-retry-3.2.1.tgz#e06e866533b42a7a123eb330cbe63a7cebcba10c" - dependencies: - any-promise "^1.1.0" - xtend "^4.0.1" - -popsicle-rewrite@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/popsicle-rewrite/-/popsicle-rewrite-1.0.0.tgz#1dd4e8ea9c3182351fb820f87934d992f7fb9007" - -popsicle-status@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/popsicle-status/-/popsicle-status-2.0.0.tgz#54e12722376efba0a353abdf53cbf1ce0e852efa" - -popsicle@^8.0.2: - version "8.2.0" - resolved "https://registry.npmjs.org/popsicle/-/popsicle-8.2.0.tgz#ff4401005cab43a9418a91410611c00197712d21" - dependencies: - any-promise "^1.3.0" - arrify "^1.0.0" - concat-stream "^1.4.7" - form-data "^2.0.0" - make-error-cause "^1.2.1" - throwback "^1.1.0" - tough-cookie "^2.0.0" - xtend "^4.0.0" - -portfinder@0.4.x: - version "0.4.0" - resolved "https://registry.npmjs.org/portfinder/-/portfinder-0.4.0.tgz#a3ffadffafe4fb98e0601a85eda27c27ce84ca1e" - dependencies: - async "0.9.0" - mkdirp "0.5.x" - -prepend-http@^1.0.0, prepend-http@^1.0.1: - version "1.0.4" - resolved "https://registry.npmjs.org/prepend-http/-/prepend-http-1.0.4.tgz#d4f4562b0ce3696e41ac52d0e002e57a635dc6dc" - -preserve@^0.2.0: - version "0.2.0" - resolved "https://registry.npmjs.org/preserve/-/preserve-0.2.0.tgz#815ed1f6ebc65926f865b310c0713bcb3315ce4b" - -pretty-hrtime@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/pretty-hrtime/-/pretty-hrtime-1.0.2.tgz#70ca96f4d0628a443b918758f79416a9a7bc9fa8" - -private@^0.1.6: - version "0.1.6" - resolved "https://registry.npmjs.org/private/-/private-0.1.6.tgz#55c6a976d0f9bafb9924851350fe47b9b5fbb7c1" - -process-nextick-args@~1.0.6: - version "1.0.7" - resolved "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-1.0.7.tgz#150e20b756590ad3f91093f25a4f2ad8bff30ba3" - -progress@^1.1.8: - version "1.1.8" - resolved "https://registry.npmjs.org/progress/-/progress-1.1.8.tgz#e260c78f6161cdd9b0e56cc3e0a85de17c7a57be" - -promise-finally@^2.0.1, promise-finally@^2.2.1: - version "2.2.1" - resolved "https://registry.npmjs.org/promise-finally/-/promise-finally-2.2.1.tgz#22616c4ba902916e988bd46c54d7caa08910cd77" - dependencies: - any-promise "^1.3.0" - -protractor@3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/protractor/-/protractor-3.0.0.tgz#ac76778770f629bab2afa56a6aac9c59ca6d259d" - dependencies: - adm-zip "0.4.4" - glob "~3.2" - jasmine "2.3.2" - jasminewd2 "0.0.6" - lodash "~2.4.1" - optimist "~0.6.0" - q "1.0.0" - request "~2.57.0" - saucelabs "~1.0.1" - selenium-webdriver "2.48.2" - source-map-support "~0.3.2" - -punycode@^1.4.1: - version "1.4.1" - resolved "https://registry.npmjs.org/punycode/-/punycode-1.4.1.tgz#c0d5a63b2718800ad8e1eb0fa5269c84dd41845e" - -q@^1.4.1: - version "1.4.1" - resolved "https://registry.npmjs.org/q/-/q-1.4.1.tgz#55705bcd93c5f3673530c2c2cbc0c2b3addc286e" - -q@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/q/-/q-1.0.0.tgz#dc1f92c4587be54f7853b29dc28e6d243a88498d" - -qs@~2.3.3: - version "2.3.3" - resolved "https://registry.npmjs.org/qs/-/qs-2.3.3.tgz#e9e85adbe75da0bbe4c8e0476a086290f863b404" - -qs@~3.1.0: - version "3.1.0" - resolved "https://registry.npmjs.org/qs/-/qs-3.1.0.tgz#d0e9ae745233a12dc43fb4f3055bba446261153c" - -qs@~6.3.0: - version "6.3.0" - resolved "https://registry.npmjs.org/qs/-/qs-6.3.0.tgz#f403b264f23bc01228c74131b407f18d5ea5d442" - -qs@6.2.0: - version "6.2.0" - resolved "https://registry.npmjs.org/qs/-/qs-6.2.0.tgz#3b7848c03c2dece69a9522b0fae8c4126d745f3b" - -randomatic@^1.1.3: - version "1.1.5" - resolved "https://registry.npmjs.org/randomatic/-/randomatic-1.1.5.tgz#5e9ef5f2d573c67bd2b8124ae90b5156e457840b" - dependencies: - is-number "^2.0.2" - kind-of "^3.0.2" - -raw-body@~2.1.7: - version "2.1.7" - resolved "https://registry.npmjs.org/raw-body/-/raw-body-2.1.7.tgz#adfeace2e4fb3098058014d08c072dcc59758774" - dependencies: - bytes "2.4.0" - iconv-lite "0.4.13" - unpipe "1.0.0" - -rc@^1.0.1, rc@^1.1.5, rc@^1.1.6, rc@~1.1.6: - version "1.1.6" - resolved "https://registry.npmjs.org/rc/-/rc-1.1.6.tgz#43651b76b6ae53b5c802f1151fa3fc3b059969c9" - dependencies: - deep-extend "~0.4.0" - ini "~1.3.0" - minimist "^1.2.0" - strip-json-comments "~1.0.4" - -read-all-stream@^3.0.0: - version "3.1.0" - resolved "https://registry.npmjs.org/read-all-stream/-/read-all-stream-3.1.0.tgz#35c3e177f2078ef789ee4bfafa4373074eaef4fa" - dependencies: - pinkie-promise "^2.0.0" - readable-stream "^2.0.0" - -read-pkg-up@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-1.0.1.tgz#9d63c13276c065918d57f002a57f40a1b643fb02" - dependencies: - find-up "^1.0.0" - read-pkg "^1.0.0" - -read-pkg@^1.0.0, read-pkg@^1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/read-pkg/-/read-pkg-1.1.0.tgz#f5ffaa5ecd29cb31c0474bca7d756b6bb29e3f28" - dependencies: - load-json-file "^1.0.0" - normalize-package-data "^2.3.2" - path-type "^1.0.0" - -readable-stream@^2.0.0, "readable-stream@^2.0.0 || ^1.1.13", readable-stream@^2.0.1, readable-stream@^2.0.2, readable-stream@^2.0.4, readable-stream@^2.0.5, readable-stream@~2.1.4: - version "2.1.5" - resolved "https://registry.npmjs.org/readable-stream/-/readable-stream-2.1.5.tgz#66fa8b720e1438b364681f2ad1a63c618448c9d0" - dependencies: - buffer-shims "^1.0.0" - core-util-is "~1.0.0" - inherits "~2.0.1" - isarray "~1.0.0" - process-nextick-args "~1.0.6" - string_decoder "~0.10.x" - util-deprecate "~1.0.1" - -"readable-stream@>=1.0.33-1 <1.1.0-0", readable-stream@~1.0.2, readable-stream@~1.0.26: - version "1.0.34" - resolved "https://registry.npmjs.org/readable-stream/-/readable-stream-1.0.34.tgz#125820e34bc842d2f2aaafafe4c2916ee32c157c" - dependencies: - core-util-is "~1.0.0" - inherits "~2.0.1" - isarray "0.0.1" - string_decoder "~0.10.x" - -readable-stream@~1.1.9: - version "1.1.14" - resolved "https://registry.npmjs.org/readable-stream/-/readable-stream-1.1.14.tgz#7cf4c54ef648e3813084c636dd2079e166c081d9" - dependencies: - core-util-is "~1.0.0" - inherits "~2.0.1" - isarray "0.0.1" - string_decoder "~0.10.x" - -readable-stream@~2.0.0: - version "2.0.6" - resolved "https://registry.npmjs.org/readable-stream/-/readable-stream-2.0.6.tgz#8f90341e68a53ccc928788dacfcd11b36eb9b78e" - dependencies: - core-util-is "~1.0.0" - inherits "~2.0.1" - isarray "~1.0.0" - process-nextick-args "~1.0.6" - string_decoder "~0.10.x" - util-deprecate "~1.0.1" - -readdirp@^2.0.0: - version "2.1.0" - resolved "https://registry.npmjs.org/readdirp/-/readdirp-2.1.0.tgz#4ed0ad060df3073300c48440373f72d1cc642d78" - dependencies: - graceful-fs "^4.1.2" - minimatch "^3.0.2" - readable-stream "^2.0.2" - set-immediate-shim "^1.0.1" - -rechoir@^0.6.2: - version "0.6.2" - resolved "https://registry.npmjs.org/rechoir/-/rechoir-0.6.2.tgz#85204b54dba82d5742e28c96756ef43af50e3384" - dependencies: - resolve "^1.1.6" - -redent@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/redent/-/redent-1.0.0.tgz#cf916ab1fd5f1f16dfb20822dd6ec7f730c2afde" - dependencies: - indent-string "^2.1.0" - strip-indent "^1.0.1" - -reflect-metadata@^0.1.2: - version "0.1.8" - resolved "https://registry.npmjs.org/reflect-metadata/-/reflect-metadata-0.1.8.tgz#72426d570b60776e3688968bd5ab9537a15cecf6" - -reflect-metadata@0.1.2: - version "0.1.2" - resolved "https://registry.npmjs.org/reflect-metadata/-/reflect-metadata-0.1.2.tgz#ea23e5823dc830f292822bd3da9b89fd57bffb03" - -regenerator-runtime@^0.9.5: - version "0.9.5" - resolved "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.9.5.tgz#403d6d40a4bdff9c330dd9392dcbb2d9a8bba1fc" - -regex-cache@^0.4.2: - version "0.4.3" - resolved "https://registry.npmjs.org/regex-cache/-/regex-cache-0.4.3.tgz#9b1a6c35d4d0dfcef5711ae651e8e9d3d7114145" - dependencies: - is-equal-shallow "^0.1.3" - is-primitive "^2.0.0" - -registry-auth-token@^3.0.1: - version "3.1.0" - resolved "https://registry.npmjs.org/registry-auth-token/-/registry-auth-token-3.1.0.tgz#997c08256e0c7999837b90e944db39d8a790276b" - dependencies: - rc "^1.1.6" - -registry-url@^3.0.0, registry-url@^3.0.3: - version "3.1.0" - resolved "https://registry.npmjs.org/registry-url/-/registry-url-3.1.0.tgz#3d4ef870f73dde1d77f0cf9a381432444e174942" - dependencies: - rc "^1.0.1" - -repeat-element@^1.1.2: - version "1.1.2" - resolved "https://registry.npmjs.org/repeat-element/-/repeat-element-1.1.2.tgz#ef089a178d1483baae4d93eb98b4f9e4e11d990a" - -repeat-string@^0.2.2: - version "0.2.2" - resolved "https://registry.npmjs.org/repeat-string/-/repeat-string-0.2.2.tgz#c7a8d3236068362059a7e4651fc6884e8b1fb4ae" - -repeat-string@^1.5.2: - version "1.6.1" - resolved "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz#8dcae470e1c88abc2d600fff4a776286da75e637" - -repeating@^1.1.0: - version "1.1.3" - resolved "https://registry.npmjs.org/repeating/-/repeating-1.1.3.tgz#3d4114218877537494f97f77f9785fab810fa4ac" - dependencies: - is-finite "^1.0.0" - -repeating@^2.0.0: - version "2.0.1" - resolved "https://registry.npmjs.org/repeating/-/repeating-2.0.1.tgz#5214c53a926d3552707527fbab415dbc08d06dda" - dependencies: - is-finite "^1.0.0" - -replace-ext@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/replace-ext/-/replace-ext-0.0.1.tgz#29bbd92078a739f0bcce2b4ee41e837953522924" - -replaceall@^0.1.3: - version "0.1.6" - resolved "https://registry.npmjs.org/replaceall/-/replaceall-0.1.6.tgz#81d81ac7aeb72d7f5c4942adf2697a3220688d8e" - -request@^2.45.0, request@^2.75.0, request@2.x: - version "2.76.0" - resolved "https://registry.npmjs.org/request/-/request-2.76.0.tgz#be44505afef70360a0436955106be3945d95560e" - dependencies: - aws-sign2 "~0.6.0" - aws4 "^1.2.1" - caseless "~0.11.0" - combined-stream "~1.0.5" - extend "~3.0.0" - forever-agent "~0.6.1" - form-data "~2.1.1" - har-validator "~2.0.6" - hawk "~3.1.3" - http-signature "~1.1.0" - is-typedarray "~1.0.0" - isstream "~0.1.2" - json-stringify-safe "~5.0.1" - mime-types "~2.1.7" - node-uuid "~1.4.7" - oauth-sign "~0.8.1" - qs "~6.3.0" - stringstream "~0.0.4" - tough-cookie "~2.3.0" - tunnel-agent "~0.4.1" - -request@~2.57.0: - version "2.57.0" - resolved "https://registry.npmjs.org/request/-/request-2.57.0.tgz#d445105a42d009b9d724289633b449a6d723d989" - dependencies: - aws-sign2 "~0.5.0" - bl "~0.9.0" - caseless "~0.10.0" - combined-stream "~1.0.1" - forever-agent "~0.6.0" - form-data "~0.2.0" - har-validator "^1.6.1" - hawk "~2.3.0" - http-signature "~0.11.0" - isstream "~0.1.1" - json-stringify-safe "~5.0.0" - mime-types "~2.0.1" - node-uuid "~1.4.0" - oauth-sign "~0.8.0" - qs "~3.1.0" - stringstream "~0.0.4" - tough-cookie ">=0.12.0" - tunnel-agent "~0.4.0" - -requires-port@1.x.x: - version "1.0.0" - resolved "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz#925d2601d39ac485e091cf0da5c6e694dc3dcaff" - -resolve-dir@^0.1.0: - version "0.1.1" - resolved "https://registry.npmjs.org/resolve-dir/-/resolve-dir-0.1.1.tgz#b219259a5602fac5c5c496ad894a6e8cc430261e" - dependencies: - expand-tilde "^1.2.2" - global-modules "^0.2.3" - -resolve@^1.1.6, resolve@^1.1.7: - version "1.1.7" - resolved "https://registry.npmjs.org/resolve/-/resolve-1.1.7.tgz#203114d82ad2c5ed9e8e0411b3932875e889e97b" - -restore-cursor@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/restore-cursor/-/restore-cursor-1.0.1.tgz#34661f46886327fed2991479152252df92daa541" - dependencies: - exit-hook "^1.0.0" - onetime "^1.0.0" - -right-align@^0.1.1: - version "0.1.3" - resolved "https://registry.npmjs.org/right-align/-/right-align-0.1.3.tgz#61339b722fe6a3515689210d24e14c96148613ef" - dependencies: - align-text "^0.1.1" - -rimraf@^2.2.8, rimraf@^2.3.3, rimraf@^2.4.4, rimraf@^2.5.4, rimraf@~2.5.1, rimraf@~2.5.4, rimraf@2: - version "2.5.4" - resolved "https://registry.npmjs.org/rimraf/-/rimraf-2.5.4.tgz#96800093cbf1a0c86bd95b4625467535c29dfa04" - dependencies: - glob "^7.0.5" - -rimraf@~2.2.8: - version "2.2.8" - resolved "https://registry.npmjs.org/rimraf/-/rimraf-2.2.8.tgz#e439be2aaee327321952730f99a8929e4fc50582" - -rollup-watch@^2.5.0: - version "2.5.0" - resolved "https://registry.npmjs.org/rollup-watch/-/rollup-watch-2.5.0.tgz#852d660ddecc51696890aa8c22e95ed4558cc5f7" - dependencies: - semver "^5.1.0" - -rollup@^0.35.11: - version "0.35.15" - resolved "https://registry.npmjs.org/rollup/-/rollup-0.35.15.tgz#f1df97205ea7c7ce79afbf113c7b1a61ec8300fd" - dependencies: - source-map-support "^0.4.0" - -rollup@^0.36.3: - version "0.36.3" - resolved "https://registry.npmjs.org/rollup/-/rollup-0.36.3.tgz#c89ac479828924ff8f69c1d44541cb4ea2fc11fc" - dependencies: - source-map-support "^0.4.0" - -rsvp@^3.0.13: - version "3.3.3" - resolved "https://registry.npmjs.org/rsvp/-/rsvp-3.3.3.tgz#34633caaf8bc66ceff4be3c2e1dffd032538a813" - -rsvp@3.2.1: - version "3.2.1" - resolved "https://registry.npmjs.org/rsvp/-/rsvp-3.2.1.tgz#07cb4a5df25add9e826ebc67dcc9fd89db27d84a" - -rx@2.3.24: - version "2.3.24" - resolved "https://registry.npmjs.org/rx/-/rx-2.3.24.tgz#14f950a4217d7e35daa71bbcbe58eff68ea4b2b7" - -rxjs@5.0.0-beta.12: - version "5.0.0-beta.12" - resolved "https://registry.npmjs.org/rxjs/-/rxjs-5.0.0-beta.12.tgz#cdfde2d8c4639d20ae7794bff8fddf32da7ad337" - dependencies: - symbol-observable "^1.0.1" - -saucelabs@~1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/saucelabs/-/saucelabs-1.0.1.tgz#b50a100d9c5a4140748b35335a6e5d70017dadf9" - dependencies: - https-proxy-agent "^1.0.0" - -sax@0.6.x: - version "0.6.1" - resolved "https://registry.npmjs.org/sax/-/sax-0.6.1.tgz#563b19c7c1de892e09bfc4f2fc30e3c27f0952b9" - -selenium-webdriver@2.48.2: - version "2.48.2" - resolved "https://registry.npmjs.org/selenium-webdriver/-/selenium-webdriver-2.48.2.tgz#b26a4631430d0a9f36284ee0cfe09676e8f348ca" - dependencies: - adm-zip "0.4.4" - rimraf "^2.2.8" - tmp "0.0.24" - ws "^0.8.0" - xml2js "0.4.4" - -semver-diff@^2.0.0: - version "2.1.0" - resolved "https://registry.npmjs.org/semver-diff/-/semver-diff-2.1.0.tgz#4bbb8437c8d37e4b0cf1a68fd726ec6d645d6d36" - dependencies: - semver "^5.0.3" - -semver@^4.1.0, semver@^4.3.1, semver@^4.3.3, semver@~4.3.3: - version "4.3.6" - resolved "https://registry.npmjs.org/semver/-/semver-4.3.6.tgz#300bc6e0e86374f7ba61068b5b1ecd57fc6532da" - -semver@^5.0.1, semver@^5.0.3, semver@^5.1.0, semver@~5.3.0, "semver@2 || 3 || 4 || 5": - version "5.3.0" - resolved "https://registry.npmjs.org/semver/-/semver-5.3.0.tgz#9b2ce5d3de02d17c6012ad326aa6b4d0cf54f94f" - -semver@~5.0.1: - version "5.0.3" - resolved "https://registry.npmjs.org/semver/-/semver-5.0.3.tgz#77466de589cd5d3c95f138aa78bc569a3cb5d27a" - -semver@2.x: - version "2.3.2" - resolved "https://registry.npmjs.org/semver/-/semver-2.3.2.tgz#b9848f25d6cf36333073ec9ef8856d42f1233e52" - -sequencify@~0.0.7: - version "0.0.7" - resolved "https://registry.npmjs.org/sequencify/-/sequencify-0.0.7.tgz#90cff19d02e07027fd767f5ead3e7b95d1e7380c" - -set-blocking@~2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz#045f9782d011ae9a6803ddd382b24392b3d890f7" - -set-immediate-shim@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/set-immediate-shim/-/set-immediate-shim-1.0.1.tgz#4b2b1b27eb808a9f8dcc481a58e5e56f599f3f61" - -setprototypeof@1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.0.1.tgz#52009b27888c4dc48f591949c0a8275834c1ca7e" - -shelljs@^0.5.3: - version "0.5.3" - resolved "https://registry.npmjs.org/shelljs/-/shelljs-0.5.3.tgz#c54982b996c76ef0c1e6b59fbdc5825f5b713113" - -sigmund@~1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/sigmund/-/sigmund-1.0.1.tgz#3ff21f198cad2175f9f3b781853fd94d0d19b590" - -signal-exit@^3.0.0: - version "3.0.1" - resolved "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.1.tgz#5a4c884992b63a7acd9badb7894c3ee9cfccad81" - -slash@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/slash/-/slash-1.0.0.tgz#c41f2f6c39fc16d1cd17ad4b5d896114ae470d55" - -slice-ansi@0.0.4: - version "0.0.4" - resolved "https://registry.npmjs.org/slice-ansi/-/slice-ansi-0.0.4.tgz#edbf8903f66f7ce2f8eafd6ceed65e264c831b35" - -slide@^1.1.5: - version "1.1.6" - resolved "https://registry.npmjs.org/slide/-/slide-1.1.6.tgz#56eb027d65b4d2dce6cb2e2d32c4d4afc9e1d707" - -sntp@1.x.x: - version "1.0.9" - resolved "https://registry.npmjs.org/sntp/-/sntp-1.0.9.tgz#6541184cc90aeea6c6e7b35e2659082443c66198" - dependencies: - hoek "2.x.x" - -socket.io-adapter@0.4.0: - version "0.4.0" - resolved "https://registry.npmjs.org/socket.io-adapter/-/socket.io-adapter-0.4.0.tgz#fb9f82ab1aa65290bf72c3657955b930a991a24f" - dependencies: - debug "2.2.0" - socket.io-parser "2.2.2" - -socket.io-client@1.5.1: - version "1.5.1" - resolved "https://registry.npmjs.org/socket.io-client/-/socket.io-client-1.5.1.tgz#0f366eae7de34bc880ebd71106e1ce8143775827" - dependencies: - backo2 "1.0.2" - component-bind "1.0.0" - component-emitter "1.2.0" - debug "2.2.0" - engine.io-client "1.7.2" - has-binary "0.1.7" - indexof "0.0.1" - object-component "0.0.3" - parseuri "0.0.4" - socket.io-parser "2.3.1" - to-array "0.1.4" - -socket.io-parser@2.2.2: - version "2.2.2" - resolved "https://registry.npmjs.org/socket.io-parser/-/socket.io-parser-2.2.2.tgz#3d7af6b64497e956b7d9fe775f999716027f9417" - dependencies: - benchmark "1.0.0" - component-emitter "1.1.2" - debug "0.7.4" - isarray "0.0.1" - json3 "3.2.6" - -socket.io-parser@2.3.1: - version "2.3.1" - resolved "https://registry.npmjs.org/socket.io-parser/-/socket.io-parser-2.3.1.tgz#dd532025103ce429697326befd64005fcfe5b4a0" - dependencies: - component-emitter "1.1.2" - debug "2.2.0" - isarray "0.0.1" - json3 "3.3.2" - -socket.io@^1.4.5: - version "1.5.1" - resolved "https://registry.npmjs.org/socket.io/-/socket.io-1.5.1.tgz#c3ea8c4ed4164436bc56adef60e31ad366518ca9" - dependencies: - debug "2.2.0" - engine.io "1.7.2" - has-binary "0.1.7" - socket.io-adapter "0.4.0" - socket.io-client "1.5.1" - socket.io-parser "2.3.1" - -sort-keys@^1.0.0: - version "1.1.2" - resolved "https://registry.npmjs.org/sort-keys/-/sort-keys-1.1.2.tgz#441b6d4d346798f1b4e49e8920adfba0e543f9ad" - dependencies: - is-plain-obj "^1.0.0" - -source-map-support@^0.3.1, source-map-support@~0.3.2: - version "0.3.3" - resolved "https://registry.npmjs.org/source-map-support/-/source-map-support-0.3.3.tgz#34900977d5ba3f07c7757ee72e73bb1a9b53754f" - dependencies: - source-map "0.1.32" - -source-map-support@^0.4.0, source-map-support@^0.4.2: - version "0.4.5" - resolved "https://registry.npmjs.org/source-map-support/-/source-map-support-0.4.5.tgz#4438df4219e1b3c7feb674614b4c67f9722db1e4" - dependencies: - source-map "^0.5.3" - -source-map-support@~0.2.8: - version "0.2.10" - resolved "https://registry.npmjs.org/source-map-support/-/source-map-support-0.2.10.tgz#ea5a3900a1c1cb25096a0ae8cc5c2b4b10ded3dc" - dependencies: - source-map "0.1.32" - -source-map@^0.4.2, source-map@^0.4.4: - version "0.4.4" - resolved "https://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz#eba4f5da9c0dc999de68032d8b4f76173652036b" - dependencies: - amdefine ">=0.0.4" - -source-map@^0.5.0, source-map@^0.5.3, source-map@~0.5.1, source-map@~0.5.3: - version "0.5.6" - resolved "https://registry.npmjs.org/source-map/-/source-map-0.5.6.tgz#75ce38f52bf0733c5a7f0c118d81334a2bb5f412" - -source-map@0.1.32: - version "0.1.32" - resolved "https://registry.npmjs.org/source-map/-/source-map-0.1.32.tgz#c8b6c167797ba4740a8ea33252162ff08591b266" - dependencies: - amdefine ">=0.0.4" - -sparkles@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/sparkles/-/sparkles-1.0.0.tgz#1acbbfb592436d10bbe8f785b7cc6f82815012c3" - -spdx-correct@~1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/spdx-correct/-/spdx-correct-1.0.2.tgz#4b3073d933ff51f3912f03ac5519498a4150db40" - dependencies: - spdx-license-ids "^1.0.2" - -spdx-expression-parse@~1.0.0: - version "1.0.4" - resolved "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-1.0.4.tgz#9bdf2f20e1f40ed447fbe273266191fced51626c" - -spdx-license-ids@^1.0.2: - version "1.2.2" - resolved "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-1.2.2.tgz#c9df7a3424594ade6bd11900d596696dc06bac57" - -split@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/split/-/split-1.0.0.tgz#c4395ce683abcd254bc28fe1dabb6e5c27dcffae" - dependencies: - through "2" - -split@0.2: - version "0.2.10" - resolved "https://registry.npmjs.org/split/-/split-0.2.10.tgz#67097c601d697ce1368f418f06cd201cf0521a57" - dependencies: - through "2" - -split2@^2.0.0: - version "2.1.0" - resolved "https://registry.npmjs.org/split2/-/split2-2.1.0.tgz#7382c148cb622c4b28af7c727f9673730b73f474" - dependencies: - through2 "~2.0.0" - -sprintf-js@~1.0.2: - version "1.0.3" - resolved "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz#04e6926f662895354f3dd015203633b857297e2c" - -sshpk@^1.7.0: - version "1.10.1" - resolved "https://registry.npmjs.org/sshpk/-/sshpk-1.10.1.tgz#30e1a5d329244974a1af61511339d595af6638b0" - dependencies: - asn1 "~0.2.3" - assert-plus "^1.0.0" - dashdash "^1.12.0" - getpass "^0.1.1" - optionalDependencies: - bcrypt-pbkdf "^1.0.0" - ecc-jsbn "~0.1.1" - jodid25519 "^1.0.0" - jsbn "~0.1.0" - tweetnacl "~0.14.0" - -"statuses@>= 1.3.0 < 2", statuses@~1.3.0: - version "1.3.0" - resolved "https://registry.npmjs.org/statuses/-/statuses-1.3.0.tgz#8e55758cb20e7682c1f4fce8dcab30bf01d1e07a" - -stream-combiner@~0.0.4: - version "0.0.4" - resolved "https://registry.npmjs.org/stream-combiner/-/stream-combiner-0.0.4.tgz#4d5e433c185261dde623ca3f44c586bcf5c4ad14" - dependencies: - duplexer "~0.1.1" - -stream-consume@~0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/stream-consume/-/stream-consume-0.1.0.tgz#a41ead1a6d6081ceb79f65b061901b6d8f3d1d0f" - -stream-shift@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/stream-shift/-/stream-shift-1.0.0.tgz#d5c752825e5367e786f78e18e445ea223a155952" - -string_decoder@~0.10.x: - version "0.10.31" - resolved "https://registry.npmjs.org/string_decoder/-/string_decoder-0.10.31.tgz#62e203bc41766c6c28c9fc84301dab1c5310fa94" - -string-length@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/string-length/-/string-length-1.0.1.tgz#56970fb1c38558e9e70b728bf3de269ac45adfac" - dependencies: - strip-ansi "^3.0.0" - -string-template@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/string-template/-/string-template-1.0.0.tgz#9e9f2233dc00f218718ec379a28a5673ecca8b96" - -string-width@^1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/string-width/-/string-width-1.0.2.tgz#118bdf5b8cdc51a2a7e70d211e07e2b0b9b107d3" - dependencies: - code-point-at "^1.0.0" - is-fullwidth-code-point "^1.0.0" - strip-ansi "^3.0.0" - -stringstream@~0.0.4: - version "0.0.5" - resolved "https://registry.npmjs.org/stringstream/-/stringstream-0.0.5.tgz#4e484cd4de5a0bbbee18e46307710a8a81621878" - -strip-ansi@^0.3.0: - version "0.3.0" - resolved "https://registry.npmjs.org/strip-ansi/-/strip-ansi-0.3.0.tgz#25f48ea22ca79187f3174a4db8759347bb126220" - dependencies: - ansi-regex "^0.2.1" - -strip-ansi@^3.0.0, strip-ansi@^3.0.1: - version "3.0.1" - resolved "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz#6a385fb8853d952d5ff05d0e8aaf94278dc63dcf" - dependencies: - ansi-regex "^2.0.0" - -strip-bom-stream@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/strip-bom-stream/-/strip-bom-stream-1.0.0.tgz#e7144398577d51a6bed0fa1994fa05f43fd988ee" - dependencies: - first-chunk-stream "^1.0.0" - strip-bom "^2.0.0" - -strip-bom@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/strip-bom/-/strip-bom-1.0.0.tgz#85b8862f3844b5a6d5ec8467a93598173a36f794" - dependencies: - first-chunk-stream "^1.0.0" - is-utf8 "^0.2.0" - -strip-bom@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/strip-bom/-/strip-bom-2.0.0.tgz#6219a85616520491f35788bdbf1447a99c7e6b0e" - dependencies: - is-utf8 "^0.2.0" - -strip-indent@^1.0.1: - version "1.0.1" - resolved "https://registry.npmjs.org/strip-indent/-/strip-indent-1.0.1.tgz#0c7962a6adefa7bbd4ac366460a638552ae1a0a2" - dependencies: - get-stdin "^4.0.1" - -strip-json-comments@~1.0.4: - version "1.0.4" - resolved "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-1.0.4.tgz#1e15fbcac97d3ee99bf2d73b4c656b082bbafb91" - -supports-color@^0.2.0: - version "0.2.0" - resolved "https://registry.npmjs.org/supports-color/-/supports-color-0.2.0.tgz#d92de2694eb3f67323973d7ae3d8b55b4c22190a" - -supports-color@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz#535d045ce6b6363fa40117084629995e9df324c7" - -symbol-observable@^1.0.1: - version "1.0.4" - resolved "https://registry.npmjs.org/symbol-observable/-/symbol-observable-1.0.4.tgz#29bf615d4aa7121bdd898b22d4b3f9bc4e2aa03d" - -systemjs-builder@^0.15.7: - version "0.15.33" - resolved "https://registry.npmjs.org/systemjs-builder/-/systemjs-builder-0.15.33.tgz#7bd4d045769a67b52f9596141ba21cd94b49910c" - dependencies: - babel-core "^6.9.0" - babel-plugin-transform-cjs-system-wrapper "^0.2.1" - babel-plugin-transform-es2015-modules-systemjs "^6.6.5" - babel-plugin-transform-global-system-wrapper "0.0.1" - babel-plugin-transform-system-register "0.0.1" - bluebird "^3.3.4" - data-uri-to-buffer "0.0.4" - es6-template-strings "^2.0.0" - glob "^7.0.3" - mkdirp "^0.5.1" - rollup "^0.36.3" - source-map "^0.5.3" - systemjs "^0.19.39" - traceur "0.0.105" - uglify-js "^2.6.1" - -systemjs@^0.19.16, systemjs@^0.19.39: - version "0.19.40" - resolved "https://registry.npmjs.org/systemjs/-/systemjs-0.19.40.tgz#158f64a9f4ef541a7fda6b40e527ee46b6c54cd0" - dependencies: - when "^3.7.5" - -tar-pack@~3.3.0: - version "3.3.0" - resolved "https://registry.npmjs.org/tar-pack/-/tar-pack-3.3.0.tgz#30931816418f55afc4d21775afdd6720cee45dae" - dependencies: - debug "~2.2.0" - fstream "~1.0.10" - fstream-ignore "~1.0.5" - once "~1.3.3" - readable-stream "~2.1.4" - rimraf "~2.5.1" - tar "~2.2.1" - uid-number "~0.0.6" - -tar@~2.2.1: - version "2.2.1" - resolved "https://registry.npmjs.org/tar/-/tar-2.2.1.tgz#8e4d2a256c0e2185c6b18ad694aec968b83cb1d1" - dependencies: - block-stream "*" - fstream "^1.0.2" - inherits "2" - -targaryen@2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/targaryen/-/targaryen-2.0.0.tgz#ac905f8704c0d11e70e8a5c026dcea21cfad8705" - dependencies: - cli-table "^0.3.1" - colors "^1.0.3" - esprima "^1.2.2" - extend "^2.0.0" - minimist "^1.1.0" - replaceall "^0.1.3" - -tempfile@^1.1.1: - version "1.1.1" - resolved "https://registry.npmjs.org/tempfile/-/tempfile-1.1.1.tgz#5bcc4eaecc4ab2c707d8bc11d99ccc9a2cb287f2" - dependencies: - os-tmpdir "^1.0.0" - uuid "^2.0.1" - -text-extensions@^1.0.0: - version "1.3.3" - resolved "https://registry.npmjs.org/text-extensions/-/text-extensions-1.3.3.tgz#fef0c8ce07f5bb3b8297bcf075304531754124bf" - -thenify@^3.1.0: - version "3.2.1" - resolved "https://registry.npmjs.org/thenify/-/thenify-3.2.1.tgz#251fd1c80aff6e5cf57cb179ab1fcb724269bd11" - dependencies: - any-promise "^1.0.0" - -throat@^3.0.0: - version "3.0.0" - resolved "https://registry.npmjs.org/throat/-/throat-3.0.0.tgz#e7c64c867cbb3845f10877642f7b60055b8ec0d6" - -"through@>=2.2.7 <3", through@~2.3, through@~2.3.1, through@2: - version "2.3.8" - resolved "https://registry.npmjs.org/through/-/through-2.3.8.tgz#0dd4c9ffaabc357960b1b724115d7e0e86a2e1f5" - -through2-filter@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/through2-filter/-/through2-filter-2.0.0.tgz#60bc55a0dacb76085db1f9dae99ab43f83d622ec" - dependencies: - through2 "~2.0.0" - xtend "~4.0.0" - -through2@^0.6.0, through2@^0.6.1: - version "0.6.5" - resolved "https://registry.npmjs.org/through2/-/through2-0.6.5.tgz#41ab9c67b29d57209071410e1d7a7a968cd3ad48" - dependencies: - readable-stream ">=1.0.33-1 <1.1.0-0" - xtend ">=4.0.0 <4.1.0-0" - -through2@^2.0.0, through2@~2.0.0, through2@~2.0.1: - version "2.0.1" - resolved "https://registry.npmjs.org/through2/-/through2-2.0.1.tgz#384e75314d49f32de12eebb8136b8eb6b5d59da9" - dependencies: - readable-stream "~2.0.0" - xtend "~4.0.0" - -throwback@^1.1.0: - version "1.1.1" - resolved "https://registry.npmjs.org/throwback/-/throwback-1.1.1.tgz#f007e7c17604a6d16d7a07c41aa0e8fedc6184a4" - dependencies: - any-promise "^1.3.0" - -tildify@^1.0.0: - version "1.2.0" - resolved "https://registry.npmjs.org/tildify/-/tildify-1.2.0.tgz#dcec03f55dca9b7aa3e5b04f21817eb56e63588a" - dependencies: - os-homedir "^1.0.0" - -time-stamp@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/time-stamp/-/time-stamp-1.0.1.tgz#9f4bd23559c9365966f3302dbba2b07c6b99b151" - -timed-out@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/timed-out/-/timed-out-2.0.0.tgz#f38b0ae81d3747d628001f41dafc652ace671c0a" - -tmp@0.0.24: - version "0.0.24" - resolved "https://registry.npmjs.org/tmp/-/tmp-0.0.24.tgz#d6a5e198d14a9835cc6f2d7c3d9e302428c8cf12" - -to-absolute-glob@^0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/to-absolute-glob/-/to-absolute-glob-0.1.1.tgz#1cdfa472a9ef50c239ee66999b662ca0eb39937f" - dependencies: - extend-shallow "^2.0.1" - -to-array@0.1.4: - version "0.1.4" - resolved "https://registry.npmjs.org/to-array/-/to-array-0.1.4.tgz#17e6c11f73dd4f3d74cda7a4ff3238e9ad9bf890" - -to-fast-properties@^1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-1.0.2.tgz#f3f5c0c3ba7299a7ef99427e44633257ade43320" - -topo@1.x.x: - version "1.1.0" - resolved "https://registry.npmjs.org/topo/-/topo-1.1.0.tgz#e9d751615d1bb87dc865db182fa1ca0a5ef536d5" - dependencies: - hoek "2.x.x" - -touch@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/touch/-/touch-1.0.0.tgz#449cbe2dbae5a8c8038e30d71fa0ff464947c4de" - dependencies: - nopt "~1.0.10" - -tough-cookie@^2.0.0, tough-cookie@>=0.12.0, tough-cookie@~2.3.0: - version "2.3.2" - resolved "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.3.2.tgz#f081f76e4c85720e6c37a5faced737150d84072a" - dependencies: - punycode "^1.4.1" - -traceur@0.0.105: - version "0.0.105" - resolved "https://registry.npmjs.org/traceur/-/traceur-0.0.105.tgz#5cf9dee83d6b77861c3d6c44d53859aed7ab0479" - dependencies: - commander "2.9.x" - glob "5.0.x" - rsvp "^3.0.13" - semver "^4.3.3" - source-map-support "~0.2.8" - -traceur@0.0.96: - version "0.0.96" - resolved "https://registry.npmjs.org/traceur/-/traceur-0.0.96.tgz#5f709b896e3b17fe0326503a67f34ab4baccabdd" - dependencies: - commander "2.6" - glob "4.3" - rsvp "^3.0.13" - semver "2.x" - source-map-support "~0.2.8" - -trim-newlines@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/trim-newlines/-/trim-newlines-1.0.0.tgz#5887966bb582a4503a41eb524f7d35011815a613" - -trim-off-newlines@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/trim-off-newlines/-/trim-off-newlines-1.0.1.tgz#9f9ba9d9efa8764c387698bcbfeb2c848f11adb3" - -tsd@^0.6.5: - version "0.6.5" - resolved "https://registry.npmjs.org/tsd/-/tsd-0.6.5.tgz#34a0b64c1db6a70b3860fe4f5571d9d1357421ad" - dependencies: - assertion-error "1.0.0" - bl "^0.9.3" - bluebird "~1.2.4" - chalk "^1.0.0" - colors "^1.1.0" - deep-freeze "0.0.1" - definition-header "~0.1.0" - detect-indent "^0.2.0" - diff "^1.4.0" - event-stream "~3.1.5" - exit "~0.1.2" - glob "^4.0.6" - joi "^4.7.0" - joi-assert "0.0.3" - jsesc "^0.5.0" - json-pointer "^0.2.2" - lazy.js "~0.3.2" - lru-cache "~2.5.0" - minimatch "^1.0.0" - minimist "^1.1.0" - ministyle "~0.1.3" - minitable "0.0.4" - miniwrite "~0.1.3" - mkdirp "~0.5.0" - open "~0.0.5" - request "^2.45.0" - rimraf "~2.2.8" - semver "^4.3.1" - type-detect "~0.1.2" - universal-analytics "~0.3.4" - update-notifier "^0.2.2" - uri-templates "~0.1.5" - uuid "^2.0.1" - verror "~1.4.0" - -tsickle@^0.1.7: - version "0.1.7" - resolved "https://registry.npmjs.org/tsickle/-/tsickle-0.1.7.tgz#bfe8f4cdcdaf9a40b84a729a38480c2f824f18ab" - dependencies: - minimist "^1.2.0" - mkdirp "^0.5.1" - source-map "^0.4.2" - source-map-support "^0.3.1" - -tunnel-agent@~0.4.0, tunnel-agent@~0.4.1: - version "0.4.3" - resolved "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.4.3.tgz#6373db76909fe570e08d73583365ed828a74eeeb" - -tweetnacl@^0.14.3, tweetnacl@~0.14.0: - version "0.14.3" - resolved "https://registry.npmjs.org/tweetnacl/-/tweetnacl-0.14.3.tgz#3da382f670f25ded78d7b3d1792119bca0b7132d" - -type-detect@~0.1.2: - version "0.1.2" - resolved "https://registry.npmjs.org/type-detect/-/type-detect-0.1.2.tgz#c88e853e54e5abd88f1bf3194b477c853c94f854" - -type-is@~1.6.13: - version "1.6.13" - resolved "https://registry.npmjs.org/type-is/-/type-is-1.6.13.tgz#6e83ba7bc30cd33a7bb0b7fb00737a2085bf9d08" - dependencies: - media-typer "0.3.0" - mime-types "~2.1.11" - -typedarray@~0.0.5: - version "0.0.6" - resolved "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz#867ac74e3864187b1d3d47d996a78ec5c8830777" - -typedoc-default-themes@0.3.4: - version "0.3.4" - resolved "https://registry.npmjs.org/typedoc-default-themes/-/typedoc-default-themes-0.3.4.tgz#5a387f9e9ead8f9a29431e62ac90c2243f5a6af6" - -"typedoc@github:jeffbcross/typedoc": - version "0.4.0" - resolved "https://codeload.github.com/jeffbcross/typedoc/tar.gz/6bd74522c04136b228f0b1279a2966bccd850eba" - dependencies: - fs-extra "^0.26.2" - handlebars "4.0.5" - highlight.js "^9.0.0" - lodash "^3.10.1" - marked "^0.3.5" - minimatch "^3.0.0" - progress "^1.1.8" - shelljs "^0.5.3" - typedoc-default-themes "0.3.4" - typescript "1.7.5" - -typescript@^2.0.2, typescript@^2.0.3: - version "2.0.6" - resolved "https://registry.npmjs.org/typescript/-/typescript-2.0.6.tgz#5385499ac9811508c2c43e0ea07a1ddca435e111" - -typescript@1.7.5: - version "1.7.5" - resolved "https://registry.npmjs.org/typescript/-/typescript-1.7.5.tgz#a80fc231d9b95afeb9d10f0589560428dd0a045e" - -typescript@1.8.10: - version "1.8.10" - resolved "https://registry.npmjs.org/typescript/-/typescript-1.8.10.tgz#b475d6e0dff0bf50f296e5ca6ef9fbb5c7320f1e" - -typings-core@^1.6.1: - version "1.6.1" - resolved "https://registry.npmjs.org/typings-core/-/typings-core-1.6.1.tgz#ce4b2931ea2f19bb8f3dacbec69983ac4e964a37" - dependencies: - any-promise "^1.3.0" - array-uniq "^1.0.2" - configstore "^2.0.0" - debug "^2.2.0" - detect-indent "^4.0.0" - graceful-fs "^4.1.2" - has "^1.0.1" - invariant "^2.2.0" - is-absolute "^0.2.3" - listify "^1.0.0" - lockfile "^1.0.1" - make-error-cause "^1.2.1" - mkdirp "^0.5.1" - object.pick "^1.1.1" - parse-json "^2.2.0" - popsicle "^8.0.2" - popsicle-proxy-agent "^3.0.0" - popsicle-retry "^3.2.0" - popsicle-rewrite "^1.0.0" - popsicle-status "^2.0.0" - promise-finally "^2.0.1" - rc "^1.1.5" - rimraf "^2.4.4" - sort-keys "^1.0.0" - string-template "^1.0.0" - strip-bom "^2.0.0" - thenify "^3.1.0" - throat "^3.0.0" - touch "^1.0.0" - typescript "^2.0.3" - xtend "^4.0.0" - zip-object "^0.1.0" - -typings@^1.3.2: - version "1.5.0" - resolved "https://registry.npmjs.org/typings/-/typings-1.5.0.tgz#b9d236cf1d37460854f8c671ea495d9405b8103f" - dependencies: - any-promise "^1.3.0" - archy "^1.0.0" - bluebird "^3.1.1" - chalk "^1.0.0" - cli-truncate "^0.2.1" - columnify "^1.5.2" - elegant-spinner "^1.0.1" - has-unicode "^2.0.1" - listify "^1.0.0" - log-update "^1.0.2" - minimist "^1.2.0" - promise-finally "^2.2.1" - typings-core "^1.6.1" - update-notifier "^1.0.0" - wordwrap "^1.0.0" - xtend "^4.0.1" - -uglify-js@^2.6, uglify-js@^2.6.1: - version "2.7.4" - resolved "https://registry.npmjs.org/uglify-js/-/uglify-js-2.7.4.tgz#a295a0de12b6a650c031c40deb0dc40b14568bd2" - dependencies: - async "~0.2.6" - source-map "~0.5.1" - uglify-to-browserify "~1.0.0" - yargs "~3.10.0" - -uglify-to-browserify@~1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/uglify-to-browserify/-/uglify-to-browserify-1.0.2.tgz#6e0924d6bda6b5afe349e39a6d632850a0f882b7" - -uid-number@~0.0.6: - version "0.0.6" - resolved "https://registry.npmjs.org/uid-number/-/uid-number-0.0.6.tgz#0ea10e8035e8eb5b8e4449f06da1c730663baa81" - -ultron@1.0.x: - version "1.0.2" - resolved "https://registry.npmjs.org/ultron/-/ultron-1.0.2.tgz#ace116ab557cd197386a4e88f4685378c8b2e4fa" - -unc-path-regex@^0.1.0: - version "0.1.2" - resolved "https://registry.npmjs.org/unc-path-regex/-/unc-path-regex-0.1.2.tgz#e73dd3d7b0d7c5ed86fbac6b0ae7d8c6a69d50fa" - -underscore@1.x: - version "1.8.3" - resolved "https://registry.npmjs.org/underscore/-/underscore-1.8.3.tgz#4f3fb53b106e6097fcf9cb4109f2a5e9bdfa5022" - -union@~0.4.3: - version "0.4.6" - resolved "https://registry.npmjs.org/union/-/union-0.4.6.tgz#198fbdaeba254e788b0efcb630bc11f24a2959e0" - dependencies: - qs "~2.3.3" - -unique-stream@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/unique-stream/-/unique-stream-1.0.0.tgz#d59a4a75427447d9aa6c91e70263f8d26a4b104b" - -unique-stream@^2.0.2: - version "2.2.1" - resolved "https://registry.npmjs.org/unique-stream/-/unique-stream-2.2.1.tgz#5aa003cfbe94c5ff866c4e7d668bb1c4dbadb369" - dependencies: - json-stable-stringify "^1.0.0" - through2-filter "^2.0.0" - -universal-analytics@~0.3.4: - version "0.3.11" - resolved "https://registry.npmjs.org/universal-analytics/-/universal-analytics-0.3.11.tgz#512879193a12a66dcbd9185121389bab913cd4b6" - dependencies: - async "0.2.x" - node-uuid "1.x" - request "2.x" - underscore "1.x" - -unpipe@~1.0.0, unpipe@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz#b2bf4ee8514aae6165b4817829d21b2ef49904ec" - -unzip-response@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/unzip-response/-/unzip-response-1.0.1.tgz#4a73959f2989470fa503791cefb54e1dbbc68412" - -update-notifier@^0.2.2: - version "0.2.2" - resolved "https://registry.npmjs.org/update-notifier/-/update-notifier-0.2.2.tgz#e69b3a784b4e686a2acd98f5e66944591996e187" - dependencies: - chalk "^0.5.1" - configstore "^0.3.1" - is-npm "^1.0.0" - latest-version "^1.0.0" - semver-diff "^2.0.0" - string-length "^1.0.0" - -update-notifier@^1.0.0: - version "1.0.2" - resolved "https://registry.npmjs.org/update-notifier/-/update-notifier-1.0.2.tgz#27c90519196dc15015be02a34ea52986feab8877" - dependencies: - boxen "^0.6.0" - chalk "^1.0.0" - configstore "^2.0.0" - is-npm "^1.0.0" - latest-version "^2.0.0" - lazy-req "^1.1.0" - semver-diff "^2.0.0" - xdg-basedir "^2.0.0" - -uri-templates@~0.1.5: - version "0.1.9" - resolved "https://registry.npmjs.org/uri-templates/-/uri-templates-0.1.9.tgz#c56f7a5731b3a310226695f6e5639180fd1aa249" - -url-join@0.0.1: - version "0.0.1" - resolved "https://registry.npmjs.org/url-join/-/url-join-0.0.1.tgz#1db48ad422d3402469a87f7d97bdebfe4fb1e3c8" - -url-parse-lax@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/url-parse-lax/-/url-parse-lax-1.0.0.tgz#7af8f303645e9bd79a272e7a14ac68bc0609da73" - dependencies: - prepend-http "^1.0.1" - -user-home@^1.0.0, user-home@^1.1.1: - version "1.1.1" - resolved "https://registry.npmjs.org/user-home/-/user-home-1.1.1.tgz#2b5be23a32b63a7c9deb8d0f28d485724a3df190" - -useragent@^2.1.6: - version "2.1.9" - resolved "https://registry.npmjs.org/useragent/-/useragent-2.1.9.tgz#4dba2bc4dad1875777ab15de3ff8098b475000b7" - dependencies: - lru-cache "2.2.x" - -utf-8-validate@1.2.x: - version "1.2.1" - resolved "https://registry.npmjs.org/utf-8-validate/-/utf-8-validate-1.2.1.tgz#44cb7c6eead73d6b40448f71f745904357b9f72c" - dependencies: - bindings "1.2.x" - nan "^2.0.5" - -util-deprecate@~1.0.1: - version "1.0.2" - resolved "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz#450d4dc9fa70de732762fbd2d4a28981419a0ccf" - -utils-merge@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.0.tgz#0294fb922bb9375153541c4f7096231f287c8af8" - -uuid@^2.0.1: - version "2.0.3" - resolved "https://registry.npmjs.org/uuid/-/uuid-2.0.3.tgz#67e2e863797215530dff318e5bf9dcebfd47b21a" - -v8flags@^2.0.2: - version "2.0.11" - resolved "https://registry.npmjs.org/v8flags/-/v8flags-2.0.11.tgz#bca8f30f0d6d60612cc2c00641e6962d42ae6881" - dependencies: - user-home "^1.1.1" - -vali-date@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/vali-date/-/vali-date-1.0.0.tgz#1b904a59609fb328ef078138420934f6b86709a6" - -validate-npm-package-license@^3.0.1: - version "3.0.1" - resolved "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.1.tgz#2804babe712ad3379459acfbe24746ab2c303fbc" - dependencies: - spdx-correct "~1.0.0" - spdx-expression-parse "~1.0.0" - -verror@~1.4.0: - version "1.4.0" - resolved "https://registry.npmjs.org/verror/-/verror-1.4.0.tgz#5d8fdf5875141c3183b7c6bc23a0aa3e3e6ca4e2" - dependencies: - extsprintf "1.0.3" - -verror@1.3.6: - version "1.3.6" - resolved "https://registry.npmjs.org/verror/-/verror-1.3.6.tgz#cff5df12946d297d2baaefaa2689e25be01c005c" - dependencies: - extsprintf "1.0.2" - -vinyl-fs@^0.3.0: - version "0.3.14" - resolved "https://registry.npmjs.org/vinyl-fs/-/vinyl-fs-0.3.14.tgz#9a6851ce1cac1c1cea5fe86c0931d620c2cfa9e6" - dependencies: - defaults "^1.0.0" - glob-stream "^3.1.5" - glob-watcher "^0.0.6" - graceful-fs "^3.0.0" - mkdirp "^0.5.0" - strip-bom "^1.0.0" - through2 "^0.6.1" - vinyl "^0.4.0" - -vinyl-fs@~2.4.3: - version "2.4.4" - resolved "https://registry.npmjs.org/vinyl-fs/-/vinyl-fs-2.4.4.tgz#be6ff3270cb55dfd7d3063640de81f25d7532239" - dependencies: - duplexify "^3.2.0" - glob-stream "^5.3.2" - graceful-fs "^4.0.0" - gulp-sourcemaps "1.6.0" - is-valid-glob "^0.3.0" - lazystream "^1.0.0" - lodash.isequal "^4.0.0" - merge-stream "^1.0.0" - mkdirp "^0.5.0" - object-assign "^4.0.0" - readable-stream "^2.0.4" - strip-bom "^2.0.0" - strip-bom-stream "^1.0.0" - through2 "^2.0.0" - through2-filter "^2.0.0" - vali-date "^1.0.0" - vinyl "^1.0.0" - -vinyl@^0.4.0: - version "0.4.6" - resolved "https://registry.npmjs.org/vinyl/-/vinyl-0.4.6.tgz#2f356c87a550a255461f36bbeb2a5ba8bf784847" - dependencies: - clone "^0.2.0" - clone-stats "^0.0.1" - -vinyl@^0.5.0: - version "0.5.3" - resolved "https://registry.npmjs.org/vinyl/-/vinyl-0.5.3.tgz#b0455b38fc5e0cf30d4325132e461970c2091cde" - dependencies: - clone "^1.0.0" - clone-stats "^0.0.1" - replace-ext "0.0.1" - -vinyl@^1.0.0: - version "1.2.0" - resolved "https://registry.npmjs.org/vinyl/-/vinyl-1.2.0.tgz#5c88036cf565e5df05558bfc911f8656df218884" - dependencies: - clone "^1.0.0" - clone-stats "^0.0.1" - replace-ext "0.0.1" - -void-elements@^2.0.0: - version "2.0.1" - resolved "https://registry.npmjs.org/void-elements/-/void-elements-2.0.1.tgz#c066afb582bb1cb4128d60ea92392e94d5e9dbec" - -wcwidth@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/wcwidth/-/wcwidth-1.0.1.tgz#f0b0dcf915bc5ff1528afadb2c0e17b532da2fe8" - dependencies: - defaults "^1.0.3" - -websocket-driver@>=0.5.1: - version "0.6.5" - resolved "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.6.5.tgz#5cb2556ceb85f4373c6d8238aa691c8454e13a36" - dependencies: - websocket-extensions ">=0.1.1" - -websocket-extensions@>=0.1.1: - version "0.1.1" - resolved "https://registry.npmjs.org/websocket-extensions/-/websocket-extensions-0.1.1.tgz#76899499c184b6ef754377c2dbb0cd6cb55d29e7" - -when@^3.7.2, when@^3.7.5: - version "3.7.7" - resolved "https://registry.npmjs.org/when/-/when-3.7.7.tgz#aba03fc3bb736d6c88b091d013d8a8e590d84718" - -which@^1.2.1, which@^1.2.10: - version "1.2.11" - resolved "https://registry.npmjs.org/which/-/which-1.2.11.tgz#c8b2eeea6b8c1659fa7c1dd4fdaabe9533dc5e8b" - dependencies: - isexe "^1.1.1" - -wide-align@^1.1.0: - version "1.1.0" - resolved "https://registry.npmjs.org/wide-align/-/wide-align-1.1.0.tgz#40edde802a71fea1f070da3e62dcda2e7add96ad" - dependencies: - string-width "^1.0.1" - -widest-line@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/widest-line/-/widest-line-1.0.0.tgz#0c09c85c2a94683d0d7eaf8ee097d564bf0e105c" - dependencies: - string-width "^1.0.1" - -window-size@0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/window-size/-/window-size-0.1.0.tgz#5438cd2ea93b202efa3a19fe8887aee7c94f9c9d" - -wordwrap@^1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz#27584810891456a4171c8d0226441ade90cbcaeb" - -wordwrap@~0.0.2: - version "0.0.3" - resolved "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.3.tgz#a3d5da6cd5c0bc0008d37234bbaf1bed63059107" - -wordwrap@0.0.2: - version "0.0.2" - resolved "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.2.tgz#b79669bb42ecb409f83d583cad52ca17eaa1643f" - -wrappy@1: - version "1.0.2" - resolved "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f" - -write-file-atomic@^1.1.2: - version "1.2.0" - resolved "https://registry.npmjs.org/write-file-atomic/-/write-file-atomic-1.2.0.tgz#14c66d4e4cb3ca0565c28cf3b7a6f3e4d5938fab" - dependencies: - graceful-fs "^4.1.2" - imurmurhash "^0.1.4" - slide "^1.1.5" - -ws@^0.8.0, ws@0.8.1: - version "0.8.1" - resolved "https://registry.npmjs.org/ws/-/ws-0.8.1.tgz#6b65273b99193c5f067a4cf5809598f777e3b759" - dependencies: - options ">=0.0.5" - ultron "1.0.x" - optionalDependencies: - bufferutil "1.2.x" - utf-8-validate "1.2.x" - -ws@1.1.1: - version "1.1.1" - resolved "https://registry.npmjs.org/ws/-/ws-1.1.1.tgz#082ddb6c641e85d4bb451f03d52f06eabdb1f018" - dependencies: - options ">=0.0.5" - ultron "1.0.x" - -wtf-8@1.0.0: - version "1.0.0" - resolved "https://registry.npmjs.org/wtf-8/-/wtf-8-1.0.0.tgz#392d8ba2d0f1c34d1ee2d630f15d0efb68e1048a" - -xdg-basedir@^1.0.0: - version "1.0.1" - resolved "https://registry.npmjs.org/xdg-basedir/-/xdg-basedir-1.0.1.tgz#14ff8f63a4fdbcb05d5b6eea22b36f3033b9f04e" - dependencies: - user-home "^1.0.0" - -xdg-basedir@^2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/xdg-basedir/-/xdg-basedir-2.0.0.tgz#edbc903cc385fc04523d966a335504b5504d1bd2" - dependencies: - os-homedir "^1.0.0" - -xml2js@0.4.4: - version "0.4.4" - resolved "https://registry.npmjs.org/xml2js/-/xml2js-0.4.4.tgz#3111010003008ae19240eba17497b57c729c555d" - dependencies: - sax "0.6.x" - xmlbuilder ">=1.0.0" - -xmlbuilder@>=1.0.0: - version "8.2.2" - resolved "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-8.2.2.tgz#69248673410b4ba42e1a6136551d2922335aa773" - -xmlhttprequest-ssl@1.5.1: - version "1.5.1" - resolved "https://registry.npmjs.org/xmlhttprequest-ssl/-/xmlhttprequest-ssl-1.5.1.tgz#3b7741fea4a86675976e908d296d4445961faa67" - -xmlhttprequest@1.8.0: - version "1.8.0" - resolved "https://registry.npmjs.org/xmlhttprequest/-/xmlhttprequest-1.8.0.tgz#67fe075c5c24fef39f9d65f5f7b7fe75171968fc" - -xregexp@~2.0.0: - version "2.0.0" - resolved "https://registry.npmjs.org/xregexp/-/xregexp-2.0.0.tgz#52a63e56ca0b84a7f3a5f3d61872f126ad7a5943" - -xtend@^4.0.0, xtend@^4.0.1, "xtend@>=4.0.0 <4.1.0-0", xtend@~4.0.0: - version "4.0.1" - resolved "https://registry.npmjs.org/xtend/-/xtend-4.0.1.tgz#a5c6d532be656e23db820efb943a1f04998d63af" - -yargs@~3.10.0: - version "3.10.0" - resolved "https://registry.npmjs.org/yargs/-/yargs-3.10.0.tgz#f7ee7bd857dd7c1d2d38c0e74efbd681d1431fd1" - dependencies: - camelcase "^1.0.2" - cliui "^2.1.0" - decamelize "^1.0.0" - window-size "0.1.0" - -yeast@0.1.2: - version "0.1.2" - resolved "https://registry.npmjs.org/yeast/-/yeast-0.1.2.tgz#008e06d8094320c372dbc2f8ed76a0ca6c8ac419" - -zip-object@^0.1.0: - version "0.1.0" - resolved "https://registry.npmjs.org/zip-object/-/zip-object-0.1.0.tgz#c1a0da04c88c837756e248680a03ff902ec3f53a" - -zone.js@^0.6.21: - version "0.6.26" - resolved "https://registry.npmjs.org/zone.js/-/zone.js-0.6.26.tgz#067c13b8b80223a89b62e9dc82680f09762c4636" -