tra-analysis/website/node_modules/firebase-functions/lib/providers/storage.js
2019-01-06 13:14:45 -06:00

119 lines
4.4 KiB
JavaScript

"use strict";
// The MIT License (MIT)
//
// Copyright (c) 2017 Firebase
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
// SOFTWARE.
Object.defineProperty(exports, "__esModule", { value: true });
const cloud_functions_1 = require("../cloud-functions");
const config_1 = require("../config");
/** @internal */
exports.provider = 'google.storage';
/** @internal */
exports.service = 'storage.googleapis.com';
/**
* The optional bucket function allows you to choose which buckets' events to handle.
* This step can be bypassed by calling object() directly, which will use the default
* Cloud Storage for Firebase bucket.
* @param bucket Name of the Google Cloud Storage bucket to listen to.
*/
function bucket(bucket) {
return _bucketWithOpts({}, bucket);
}
exports.bucket = bucket;
/**
* Handle events related to Cloud Storage objects.
*/
function object() {
return _objectWithOpts({});
}
exports.object = object;
/** @internal */
function _bucketWithOpts(opts, bucket) {
const resourceGetter = () => {
bucket = bucket || config_1.firebaseConfig().storageBucket;
if (!bucket) {
throw new Error('Missing bucket name. If you are unit testing, please provide a bucket name' +
' through `functions.storage.bucket(bucketName)`, or set process.env.FIREBASE_CONFIG.');
}
if (!/^[a-z\d][a-z\d\\._-]{1,230}[a-z\d]$/.test(bucket)) {
throw new Error(`Invalid bucket name ${bucket}`);
}
return `projects/_/buckets/${bucket}`;
};
return new BucketBuilder(resourceGetter, opts);
}
exports._bucketWithOpts = _bucketWithOpts;
/** @internal */
function _objectWithOpts(opts) {
return _bucketWithOpts(opts).object();
}
exports._objectWithOpts = _objectWithOpts;
class BucketBuilder {
/** @internal */
constructor(triggerResource, opts) {
this.triggerResource = triggerResource;
this.opts = opts;
}
/** Handle events for objects in this bucket. */
object() {
return new ObjectBuilder(this.triggerResource, this.opts);
}
}
exports.BucketBuilder = BucketBuilder;
class ObjectBuilder {
/** @internal */
constructor(triggerResource, opts) {
this.triggerResource = triggerResource;
this.opts = opts;
}
/** @internal */
onChange(handler) {
throw new Error('"onChange" is now deprecated, please use "onArchive", "onDelete", ' +
'"onFinalize", or "onMetadataUpdate".');
}
/** Respond to archiving of an object, this is only for buckets that enabled object versioning. */
onArchive(handler) {
return this.onOperation(handler, 'object.archive');
}
/** Respond to the deletion of an object (not to archiving, if object versioning is enabled). */
onDelete(handler) {
return this.onOperation(handler, 'object.delete');
}
/** Respond to the successful creation of an object. */
onFinalize(handler) {
return this.onOperation(handler, 'object.finalize');
}
/** Respond to metadata updates of existing objects. */
onMetadataUpdate(handler) {
return this.onOperation(handler, 'object.metadataUpdate');
}
onOperation(handler, eventType) {
return cloud_functions_1.makeCloudFunction({
handler,
provider: exports.provider,
service: exports.service,
eventType,
triggerResource: this.triggerResource,
opts: this.opts,
});
}
}
exports.ObjectBuilder = ObjectBuilder;