@kumologica/sdk 3.0.0

package/src/app/lib/aws/ca-iot-api.js

@@ -0,0 +1,105 @@
+const AWS = require('aws-sdk');
+const jp = require('jsonpath');
+
+class CAAWSIot {
+  
+  constructor(log) {
+    this.log = log; 
+    this.iot = new AWS.Iot();
+  }
+  
+  /**
+   * Returns IOT Event Rule
+   * https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Iot.html#getTopicRule-property
+   * @param  {} event IOT Event configuration 
+   * 
+   * @returns {JSON} Topic rule definition
+   */
+  async getTopicRule(event) {
+    var rule;
+    try {
+      rule = await this.iot.getTopicRule({ruleName: event.rule}).promise();
+    } catch (UnauthorizedException) {
+      // rule doesnt exists
+    }
+    return rule;
+  }
+  /**
+   * 
+   * @param  {} event
+   * @param  {} lambdaName
+   * @param  {} lambdaArn
+   */
+  async addTrigger(event, lambdaName, lambdaArn) {
+    this.log(`Adding trigger to the rule: ${event.rule} ...`);
+    
+    var rule = await this.getTopicRule(event);
+
+    if (!rule && !event.query) {
+      this.log(`Error: Unable to add trigger to the iot rule, rule ${event.rule} doesn't exists.`);
+      this.log("       If you wish to create iot rule please provide query parameter and re-run deploy. Iot rule will be created and trigger will be added.");
+      return;
+    }
+
+    if (rule) {
+      var lambdaRule = jp.query(rule, `rule.actions[?(@.lambda.functionArn=='${lambdaArn}')]`);    
+      if (lambdaRule.length == 0) {
+        await this.iot.replaceTopicRule(this.replaceTopicRuleRequest(rule, lambdaArn)).promise();
+        return rule;
+      }
+ 
+    } else { 
+      await this.iot.createTopicRule(this.createTopicRuleRequest(event, lambdaArn)).promise();    
+      return  this.getTopicRule(event);
+    }
+  }
+
+  replaceTopicRuleRequest(rule, lambdaArn) {
+
+    rule.rule.actions.push({
+      lambda: {
+        functionArn: lambdaArn
+      }
+    });
+    
+    return {
+      ruleName: rule.rule.ruleName,
+      topicRulePayload: {
+        actions: rule.rule.actions,
+        sql: rule.rule.sql,
+        awsIotSqlVersion: rule.rule.awsIotSqlVersion,
+        description: rule.rule.description,
+        errorAction: rule.rule.errorAction,
+        ruleDisabled: rule.rule.ruleDisabled
+      }
+    }
+  }
+  /**
+   * @param  {} event     IOT Event configuration
+   * @param  {} lambdaArn The ARN of lambda function the topic rule is attached
+   */
+  createTopicRuleRequest(event, lambdaArn) {
+    return {
+      ruleName: event.rule,
+      topicRulePayload: {
+        sql: event.query,
+        ruleDisabled: false,
+        actions: [{
+          lambda: {
+            functionArn: lambdaArn
+          }
+        }]
+      }
+    }
+  } 
+
+  async listTopicRules() {
+    const response = await this.iot.listTopicRules({}).promise();
+    
+    return response.rules.map(function(v) {   
+      return {id: v.ruleName, name: v.ruleName, arn: v.ruleArn};
+    });
+  }
+}
+
+module.exports = CAAWSIot;

package/src/app/lib/aws/ca-s3-api.js

@@ -0,0 +1,115 @@
+const AWS = require('aws-sdk');
+
+/*
+ * Follow link:
+ * https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html
+ *
+ * AWS JS API:
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/APIGateway.html
+ */
+class CAS3 {
+  
+  
+  constructor(log) {
+    this.log = log; 
+    this.s3 = new AWS.S3();
+  }
+  
+  /*
+   * creates s3 bucket used for deployments, if s3 bucket exists then 
+   * nothing is done. 
+   */
+  async createS3Bucket(bucketName) {
+    this.log(`Creating deployment bucket...`);
+
+     try {
+      await this.s3.createBucket({Bucket: bucketName}).promise();
+
+    } catch (error) {     
+      if (error.code != "BucketAlreadyOwnedByYou") { // ignore bucket already exists
+        throw Error(error);
+      }
+    } 
+  }
+
+  async upload(settings) {
+      return this.s3.upload(settings).promise();
+  }
+
+  async putBucketNotificationConfiguration(settings) {
+      return this.s3.putBucketNotificationConfiguration(settings).promise();
+  }
+
+  async deleteS3Objects(bucketName, key) {
+    
+    var items = await this.s3.listObjectsV2({Bucket: bucketName, Prefix: key}).promise();
+    
+    if (!items || !items.Contents || items.Contents.length == 0) {
+      return;
+    }
+
+    var keys = items.Contents.map(function(i) {
+      return {Key: i.Key};
+    });
+
+    if (keys) {
+      await this.s3.deleteObjects({Bucket: bucketName, Delete: {Objects: keys}}).promise();
+    }
+  
+  }
+
+  /**
+   * Api doc:
+   * https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#listBuckets-property
+   * 
+   */
+  async getBuckets() {
+    const b = await this.s3.listBuckets({}).promise();
+    
+    return b.Buckets.map(function(v) {
+      return {id: v.Name, name: v.CreationDate, arn: `arn-ccc`}
+    });
+  }
+
+  async bucketNotificationConfiguration (lambdaArn, bucket, eventType, prefix, suffix) {
+ 
+    let configuration = await this.s3.getBucketNotificationConfiguration({Bucket: bucket}).promise();
+    
+    let idx = configuration.LambdaFunctionConfigurations.findIndex(c => c.LambdaFunctionArn == lambdaArn);
+    if (idx != -1) {
+      configuration.LambdaFunctionConfigurations.splice(idx, 1);
+    }
+    
+    let lambdaConfiguration = {
+        Events: [ eventType ],
+        LambdaFunctionArn: lambdaArn
+    }; 
+    let filterRules = [];
+  
+    if (prefix) {
+      filterRules.push({ Name: "prefix", Value: prefix });
+    };
+       
+    if (suffix) {
+      filterRules.push({ Name: "suffix", Value: suffix });
+    }
+  
+    if (filterRules.length) {
+      lambdaConfiguration.Filter = {
+        Key: {
+          FilterRules: filterRules
+        }
+      };
+    }
+
+    configuration.LambdaFunctionConfigurations.push(lambdaConfiguration);
+    let params = {
+      Bucket: bucket, 
+      NotificationConfiguration: configuration
+    };
+
+    return this.s3.putBucketNotificationConfiguration(params).promise();
+  }
+}
+
+module.exports = CAS3;

package/src/app/lib/aws/ca-sns-api.js

@@ -0,0 +1,38 @@
+const AWS = require('aws-sdk');
+
+/*
+ * AWS JS API:
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html
+ */
+class CASNS {
+  
+  constructor(log) {
+    this.log = log; 
+    this.sns = new AWS.SNS();
+  }
+
+  async subscribe(topic, lambdaArn) {
+    const params = {
+        Protocol: 'lambda',
+        TopicArn: topic,
+        Endpoint: lambdaArn
+      };
+  
+      return this.sns.subscribe(params).promise();
+  }
+  
+  /**
+   * 
+   */
+  async getTopics() {
+   
+    const topics = await this.sns.listTopics({}).promise();
+    
+    return topics.Topics.map(function(v) {
+      const parts = v.TopicArn.split(':');
+      return {id: v.TopicArn, name: parts[parts.length-1], arn: v.TopicArn};
+    });
+  }
+}
+
+module.exports = CASNS;

package/src/app/lib/aws/ca-sqs-api.js

@@ -0,0 +1,51 @@
+const AWS = require('aws-sdk');
+
+/*
+ * AWS JS API:
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SNS.html
+ */
+class CASQS {
+
+  constructor(log) {
+    this.log = log; 
+    this.sqs = new AWS.SQS();
+  }
+  
+  /**
+   * Doc Url:
+   * https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/SQS.html#getQueueAttributes-property
+   * 
+   * @param {string} url 
+   */
+  async getQueueArn(url) {
+    var params = {
+        QueueUrl: `${url}`,
+        AttributeNames: [  "QueueArn" ]
+      };
+      
+      var response = await this.sqs.getQueueAttributes(params).promise();
+      
+      return response.Attributes.QueueArn;
+  }
+
+  /**
+   * Returns list of queues or empty array if none defined.
+   */
+  async getQueues() {
+   
+    const queues = await this.sqs.listQueues({}).promise();
+    
+    if (queues && queues.QueueUrls) {
+      return queues.QueueUrls.map(function(v) {
+        const parts = v.split('/');
+        return {id: v, name: parts[parts.length-1], arn: v};
+      });
+   
+    } else {
+       return [];
+    }
+  }
+
+}
+
+module.exports = CASQS;