123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121 |
- /*! firebase-admin v12.1.1 */
- "use strict";
- /*!
- * @license
- * Copyright 2017 Google Inc.
- *
- * 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
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
- Object.defineProperty(exports, "__esModule", { value: true });
- exports.Storage = void 0;
- const error_1 = require("../utils/error");
- const credential_internal_1 = require("../app/credential-internal");
- const utils = require("../utils/index");
- const validator = require("../utils/validator");
- /**
- * The default `Storage` service if no
- * app is provided or the `Storage` service associated with the provided
- * app.
- */
- class Storage {
- /**
- * @param app - The app for this Storage service.
- * @constructor
- * @internal
- */
- constructor(app) {
- if (!validator.isNonNullObject(app) || !('options' in app)) {
- throw new error_1.FirebaseError({
- code: 'storage/invalid-argument',
- message: 'First argument passed to admin.storage() must be a valid Firebase app instance.',
- });
- }
- if (!process.env.STORAGE_EMULATOR_HOST && process.env.FIREBASE_STORAGE_EMULATOR_HOST) {
- const firebaseStorageEmulatorHost = process.env.FIREBASE_STORAGE_EMULATOR_HOST;
- if (firebaseStorageEmulatorHost.match(/https?:\/\//)) {
- throw new error_1.FirebaseError({
- code: 'storage/invalid-emulator-host',
- message: 'FIREBASE_STORAGE_EMULATOR_HOST should not contain a protocol (http or https).',
- });
- }
- process.env.STORAGE_EMULATOR_HOST = `http://${process.env.FIREBASE_STORAGE_EMULATOR_HOST}`;
- }
- let storage;
- try {
- storage = require('@google-cloud/storage').Storage;
- }
- catch (err) {
- throw new error_1.FirebaseError({
- code: 'storage/missing-dependencies',
- message: 'Failed to import the Cloud Storage client library for Node.js. '
- + 'Make sure to install the "@google-cloud/storage" npm package. '
- + `Original error: ${err}`,
- });
- }
- const projectId = utils.getExplicitProjectId(app);
- const credential = app.options.credential;
- if (credential instanceof credential_internal_1.ServiceAccountCredential) {
- this.storageClient = new storage({
- // When the SDK is initialized with ServiceAccountCredentials an explicit projectId is
- // guaranteed to be available.
- projectId: projectId,
- credentials: {
- private_key: credential.privateKey,
- client_email: credential.clientEmail,
- },
- });
- }
- else if ((0, credential_internal_1.isApplicationDefault)(app.options.credential)) {
- // Try to use the Google application default credentials.
- this.storageClient = new storage();
- }
- else {
- throw new error_1.FirebaseError({
- code: 'storage/invalid-credential',
- message: 'Failed to initialize Google Cloud Storage client with the available credential. ' +
- 'Must initialize the SDK with a certificate credential or application default credentials ' +
- 'to use Cloud Storage API.',
- });
- }
- this.appInternal = app;
- }
- /**
- * Gets a reference to a Cloud Storage bucket.
- *
- * @param name - Optional name of the bucket to be retrieved. If name is not specified,
- * retrieves a reference to the default bucket.
- * @returns A {@link https://cloud.google.com/nodejs/docs/reference/storage/latest/Bucket | Bucket}
- * instance as defined in the `@google-cloud/storage` package.
- */
- bucket(name) {
- const bucketName = (typeof name !== 'undefined')
- ? name : this.appInternal.options.storageBucket;
- if (validator.isNonEmptyString(bucketName)) {
- return this.storageClient.bucket(bucketName);
- }
- throw new error_1.FirebaseError({
- code: 'storage/invalid-argument',
- message: 'Bucket name not specified or invalid. Specify a valid bucket name via the ' +
- 'storageBucket option when initializing the app, or specify the bucket name ' +
- 'explicitly when calling the getBucket() method.',
- });
- }
- /**
- * Optional app whose `Storage` service to
- * return. If not provided, the default `Storage` service will be returned.
- */
- get app() {
- return this.appInternal;
- }
- }
- exports.Storage = Storage;
|