122 lines
5.0 KiB
JavaScript
122 lines
5.0 KiB
JavaScript
/*! firebase-admin v11.0.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;
|