@etainabl/nodejs-sdk 1.0.0

package/.eslintrc.js

@@ -0,0 +1,29 @@
+module.exports = {
+  extends: ['airbnb-base'],
+  parser: '@typescript-eslint/parser',
+  rules: {
+    'no-console': 'off',
+    'comma-dangle': [2, 'never'],
+    'arrow-parens': [2, 'as-needed'],
+    'linebreak-style': 0,
+    'padded-blocks': 0,
+    'no-underscore-dangle': [0],
+    'no-param-reassign': [2, { props: false }],
+    'new-cap': [2, { capIsNewExceptions: ['Router', 'ObjectId'] }],
+    'no-tabs': 2,
+    'max-len': [1, 150],
+    'no-plusplus': 0,
+    'generator-star-spacing': 0,
+    'class-methods-use-this': 0,
+    'import/extensions': 0,
+    'import/no-unresolved': 0,
+    'prefer-destructuring': 0,
+    'no-use-before-define': 0,
+    'import/prefer-default-export': 'off'
+  },
+  env: {
+    node: true,
+    browser: true
+  },
+  parserOptions: { ecmaVersion: 2020 }
+};

package/api.js

@@ -0,0 +1,119 @@
+import axios from 'axios';
+import logger from './logger.js';
+const log = logger('etainablApi');
+const factory = {
+    get: (etainablApi, endpoint, postEndpoint) => async (id, options = {}) => {
+        log.info(`API Request: GET ${process.env.ETAINABL_API_URL}/${endpoint}/${id}${postEndpoint ? `/${postEndpoint}` : ''}`);
+        const response = await etainablApi.get(`${endpoint}/${id}${postEndpoint ? `/${postEndpoint}` : ''}`, options);
+        if (response.status !== 200) {
+            throw new Error(`${response.status} ${response.statusText} response from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+        }
+        if (!response.data) {
+            throw new Error(`No data from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+        }
+        return response.data;
+    },
+    list: (etainablApi, endpoint) => async (options = {}) => {
+        log.info(`API Request: GET ${process.env.ETAINABL_API_URL}/${endpoint}`);
+        const response = await etainablApi.get(`${endpoint}`, options);
+        if (response.status !== 200) {
+            throw new Error(`${response.status} ${response.statusText} response from API (GET ${endpoint})`);
+        }
+        if (!response.data || !response.data.data) {
+            throw new Error(`No data from API (GET ${endpoint})`);
+        }
+        return response.data;
+    },
+    update: (etainablApi, endpoint) => async (id, data, options = {}) => {
+        log.info(`API Request: PATCH ${process.env.ETAINABL_API_URL}/${endpoint}/${id}`);
+        const response = await etainablApi.patch(`${endpoint}/${id}`, data, options);
+        if (response.status !== 200) {
+            throw new Error(`${response.status} ${response.statusText} response from API (PATCH ${endpoint})`);
+        }
+        if (!response.data) {
+            throw new Error(`No data from API (PATCH ${endpoint})`);
+        }
+        return response.data;
+    },
+    create: (etainablApi, endpoint) => async (data, options = {}) => {
+        log.info(`API Request: POST ${process.env.ETAINABL_API_URL}/${endpoint}`);
+        const response = await etainablApi.post(`${endpoint}`, data, options);
+        if (response.status !== 200) {
+            throw new Error(`${response.status} ${response.statusText} response from API (POST ${endpoint})`);
+        }
+        if (!response.data) {
+            throw new Error(`No data from API (POST ${endpoint})`);
+        }
+        return response.data;
+    },
+    remove: (etainablApi, endpoint) => async (id, options = {}) => {
+        log.info(`API Request: DELETE ${process.env.ETAINABL_API_URL}/${endpoint}/${id}`);
+        const response = await etainablApi.delete(`${endpoint}/${id}`, options);
+        if (response.status !== 200) {
+            throw new Error(`${response.status} ${response.statusText} response from API (DELETE ${endpoint})`);
+        }
+        if (!response.data) {
+            throw new Error(`No data from API (DELETE ${endpoint})`);
+        }
+        return response.data;
+    }
+};
+export default (auth, instanceOptions = {}) => {
+    const headers = {};
+    if (auth.key) {
+        headers['x-key'] = auth.key;
+    }
+    else if (auth.token) {
+        headers['Authorization'] = auth.token;
+    }
+    else {
+        headers['x-key'] = process.env.ETAINABL_API_KEY;
+    }
+    const etainablApi = axios.create({
+        baseURL: process.env.ETAINABL_API_URL,
+        timeout: 30000,
+        headers,
+        ...instanceOptions
+    });
+    return {
+        instance: etainablApi,
+        // accounts
+        getAccount: factory.get(etainablApi, 'accounts'),
+        listAccounts: factory.list(etainablApi, 'accounts'),
+        updateAccount: factory.update(etainablApi, 'accounts'),
+        createAccount: factory.create(etainablApi, 'accounts'),
+        removeAccount: factory.remove(etainablApi, 'accounts'),
+        // assets
+        getAsset: factory.get(etainablApi, 'assets'),
+        listAssets: factory.list(etainablApi, 'assets'),
+        updateAsset: factory.update(etainablApi, 'assets'),
+        createAsset: factory.create(etainablApi, 'assets'),
+        removeAsset: factory.remove(etainablApi, 'assets'),
+        // assetGroups
+        getAssetGroup: factory.get(etainablApi, 'asset-groups'),
+        listAssetGroups: factory.list(etainablApi, 'asset-groups'),
+        updateAssetGroup: factory.update(etainablApi, 'asset-groups'),
+        createAssetGroup: factory.create(etainablApi, 'asset-groups'),
+        removeAssetGroup: factory.remove(etainablApi, 'asset-groups'),
+        getAssetGroupAssets: factory.get(etainablApi, 'asset-groups', 'assets'),
+        // automation
+        getAutomation: factory.get(etainablApi, 'automation'),
+        listAutomations: factory.list(etainablApi, 'automation'),
+        updateAutomation: factory.update(etainablApi, 'automation'),
+        createAutomation: factory.create(etainablApi, 'automation'),
+        removeAutomation: factory.remove(etainablApi, 'automation'),
+        // consumption
+        getConsumption: factory.get(etainablApi, 'consumptions'),
+        listConsumptions: factory.list(etainablApi, 'consumptions'),
+        updateConsumption: factory.update(etainablApi, 'consumptions'),
+        createConsumption: factory.create(etainablApi, 'consumptions'),
+        removeConsumption: factory.remove(etainablApi, 'consumptions'),
+        // readings
+        getReading: factory.get(etainablApi, 'readings'),
+        listReadings: factory.list(etainablApi, 'readings'),
+        updateReading: factory.update(etainablApi, 'readings'),
+        createReading: factory.create(etainablApi, 'readings'),
+        removeReading: factory.remove(etainablApi, 'readings'),
+    };
+};
+//# sourceMappingURL=api.js.map

package/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["src/api.ts"],"names":[],"mappings":"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"}

package/consumption.js

@@ -0,0 +1,47 @@
+import moment from 'moment';
+import { interpolate } from './lib/readingsInterpolate.js';
+const apportionedReadings = (readings, granularity = 'days', interpolationMethod = 'linear', startDate, endDate) => {
+    // Readings sorted from newest to oldest
+    const sortedReadings = [...readings].sort((a, b) => moment(a.submittedAt).diff(b.submittedAt));
+    // Array of every hour/day etc between the first and last reading
+    const intervals = moment(sortedReadings[sortedReadings.length - 1].submittedAt).diff(moment(sortedReadings[0].submittedAt), granularity);
+    const dates = [...Array(intervals).keys()]
+        .slice(1)
+        .map((interval) => moment(sortedReadings[0].submittedAt).startOf(granularity).add(interval, granularity));
+    let interpolatedReadings = dates.map((date) => {
+        const reading = interpolate(sortedReadings, date, interpolationMethod);
+        return {
+            date,
+            reading
+        };
+    });
+    interpolatedReadings = interpolatedReadings.map((reading, index) => {
+        const prevReading = interpolatedReadings[index - 1];
+        if (prevReading) {
+            return {
+                ...reading,
+                consumption: reading.reading - prevReading.reading
+            };
+        }
+        return reading;
+    });
+    if (startDate) {
+        interpolatedReadings = interpolatedReadings.filter((reading) => moment(reading.date).isSameOrAfter(startDate, granularity));
+    }
+    if (endDate) {
+        interpolatedReadings = interpolatedReadings.filter((reading) => moment(reading.date).isSameOrBefore(endDate, granularity));
+    }
+    return interpolatedReadings;
+};
+const consumptionFromReadings = (readings, startDate, endDate, granularity = 'hours', interpolationMethod = 'linear') => {
+    // Split the readings into hourly readings and calculate the consumption for each hour
+    const apportioned = apportionedReadings(readings, granularity, interpolationMethod, startDate, endDate);
+    // Calculate the total consumption between the start and end dates
+    const totalConsumption = apportioned.reduce((acc, reading) => acc + reading.consumption, 0);
+    return { totalConsumption, apportioned };
+};
+export default {
+    apportionedReadings,
+    consumptionFromReadings
+};
+//# sourceMappingURL=consumption.js.map

package/consumption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption.js","sourceRoot":"","sources":["src/consumption.ts"],"names":[],"mappings":"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"}

package/index.js

@@ -0,0 +1,5 @@
+import api from './api.js';
+import consumption from './consumption.js';
+import logger from './logger.js';
+export { api, logger, consumption };
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EACL,GAAG,EACH,MAAM,EACN,WAAW,EACZ,CAAA"}

package/lib/readingsInterpolate.d.ts

@@ -0,0 +1 @@
+export declare function interpolate(meterReadings: any[], targetDate: any, method?: string): any;

package/lib/readingsInterpolate.js

@@ -0,0 +1,73 @@
+import moment from 'moment';
+export function interpolate(meterReadings, targetDate, method = 'linear') {
+    if (method === 'cubic') {
+        return cubicInterpolation(meterReadings, targetDate);
+    }
+    if (method === 'linear') {
+        return linearInterpolation(meterReadings, targetDate);
+    }
+    throw new Error(`Interpolation method ${method} not supported`);
+}
+function linearInterpolation(meterReadings, targetDate) {
+    // Ensure the meter readings are sorted by date
+    meterReadings.sort((a, b) => moment(a.submittedAt).unix() - moment(b.submittedAt).unix());
+    const targetTimestamp = moment(targetDate).startOf('minute').unix();
+    // Find the two nearest meter readings for the target date
+    let lowerIndex = -1;
+    let upperIndex = -1;
+    for (let i = 0; i < meterReadings.length; i++) {
+        const reading = meterReadings[i];
+        if (moment(reading.submittedAt).startOf('minute').unix() <= targetTimestamp) {
+            lowerIndex = i;
+        }
+        else {
+            upperIndex = i;
+            break;
+        }
+    }
+    // If no readings are available for interpolation, return null
+    if (lowerIndex === -1 || upperIndex === -1) {
+        return null;
+    }
+    const lowerReading = meterReadings[lowerIndex];
+    const upperReading = meterReadings[upperIndex];
+    // Linear interpolation formula
+    const consumption = lowerReading.value
+        + ((targetTimestamp - moment(lowerReading.submittedAt).startOf('minute').unix())
+            / (moment(upperReading.submittedAt).startOf('minute').unix() - moment(lowerReading.submittedAt).startOf('minute').unix()))
+            * (upperReading.value - lowerReading.value);
+    return consumption;
+}
+;
+function cubicInterpolateCalc(x0, y0, x1, y1, x2, y2, x3, y3, x) {
+    const t = (x - x1) / (x2 - x1);
+    const t2 = t * t;
+    const t3 = t2 * t;
+    const a0 = y3 - y2 - y0 + y1;
+    const a1 = y0 - y1 - a0;
+    const a2 = y2 - y0;
+    const a3 = y1;
+    return a0 * t3 + a1 * t2 + a2 * t + a3;
+}
+function cubicInterpolation(meterReadings, targetDate) {
+    // Ensure the meter readings are sorted by date
+    meterReadings.sort((a, b) => moment(a.submittedAt).unix() - moment(b.submittedAt).unix());
+    const targetTimestamp = new Date(targetDate).getTime();
+    // Find the four nearest meter readings for the target date
+    let startIndex = -1;
+    for (let i = 0; i < meterReadings.length; i++) {
+        const reading = meterReadings[i];
+        if (moment(reading.submittedAt).startOf('minute').unix() > targetTimestamp) {
+            startIndex = i - 2;
+            break;
+        }
+    }
+    // If no readings are available for interpolation, return null
+    if (startIndex < 0 || startIndex + 3 >= meterReadings.length) {
+        return null;
+    }
+    const readings = meterReadings.slice(startIndex, startIndex + 4);
+    const interpolatedConsumption = cubicInterpolateCalc(moment(readings[0].submittedAt).startOf('minute').unix(), readings[0].value, moment(readings[1].submittedAt).startOf('minute').unix(), readings[1].value, moment(readings[2].submittedAt).startOf('minute').unix(), readings[2].value, moment(readings[3].submittedAt).startOf('minute').unix(), readings[3].value, targetTimestamp);
+    return interpolatedConsumption;
+}
+//# sourceMappingURL=readingsInterpolate.js.map

package/lib/readingsInterpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readingsInterpolate.js","sourceRoot":"","sources":["../src/lib/readingsInterpolate.ts"],"names":[],"mappings":"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"}

package/logger.js

@@ -0,0 +1,10 @@
+import winston from 'winston';
+export default (namespace) => winston.createLogger({
+    level: 'debug',
+    format: winston.format.combine(winston.format.timestamp(), winston.format.json()),
+    defaultMeta: { service: process.env.AWS_LAMBDA_FUNCTION_NAME, script: namespace },
+    transports: [
+        new winston.transports.Console()
+    ]
+});
+//# sourceMappingURL=logger.js.map

package/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,eAAe,CAAC,SAAiB,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC;IACzD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACtB;IACD,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,MAAM,EAAE,SAAS,EAAE;IACjF,UAAU,EAAE;QACV,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE;KACjC;CACF,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@etainabl/nodejs-sdk",
+  "version": "1.0.0",
+  "main": "index.js",
+  "author": "Jonathan Lambert <jonathan@etainabl.com>",
+  "type": "module",
+  "dependencies": {
+    "axios": "^1.4.0",
+    "moment": "^2.29.4",
+    "winston": "^3.10.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.4.5"
+  }
+}

package/src/api.d.ts

@@ -0,0 +1,46 @@
+import type { AxiosRequestConfig, AxiosInstance, CreateAxiosDefaults } from 'axios';
+interface ETNPagedResponse {
+    data: any[];
+    total: number;
+    limit: number;
+    skip: number;
+}
+interface AuthOptions {
+    key?: string;
+    token?: string;
+}
+declare const _default: (auth: AuthOptions, instanceOptions?: CreateAxiosDefaults) => {
+    instance: AxiosInstance;
+    getAccount: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    listAccounts: (options?: AxiosRequestConfig<any>) => Promise<ETNPagedResponse>;
+    updateAccount: (id: string, data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    createAccount: (data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    removeAccount: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    getAsset: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    listAssets: (options?: AxiosRequestConfig<any>) => Promise<ETNPagedResponse>;
+    updateAsset: (id: string, data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    createAsset: (data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    removeAsset: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    getAssetGroup: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    listAssetGroups: (options?: AxiosRequestConfig<any>) => Promise<ETNPagedResponse>;
+    updateAssetGroup: (id: string, data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    createAssetGroup: (data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    removeAssetGroup: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    getAssetGroupAssets: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    getAutomation: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    listAutomations: (options?: AxiosRequestConfig<any>) => Promise<ETNPagedResponse>;
+    updateAutomation: (id: string, data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    createAutomation: (data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    removeAutomation: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    getConsumption: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    listConsumptions: (options?: AxiosRequestConfig<any>) => Promise<ETNPagedResponse>;
+    updateConsumption: (id: string, data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    createConsumption: (data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    removeConsumption: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    getReading: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+    listReadings: (options?: AxiosRequestConfig<any>) => Promise<ETNPagedResponse>;
+    updateReading: (id: string, data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    createReading: (data: any, options?: AxiosRequestConfig<any>) => Promise<any>;
+    removeReading: (id: string, options?: AxiosRequestConfig<any>) => Promise<any>;
+};
+export default _default;

package/src/api.ts

@@ -0,0 +1,212 @@
+import axios from 'axios';
+import type { AxiosRequestConfig, AxiosInstance, CreateAxiosDefaults } from 'axios';
+
+import logger from './logger.js';
+
+const log = logger('etainablApi');
+
+interface ETNPagedResponse {
+  data: any[];
+  total: number;
+  limit: number;
+  skip: number;
+}
+
+const factory = {
+  get: (etainablApi: AxiosInstance, endpoint: any, postEndpoint?: any) => async (id: string, options: AxiosRequestConfig = {}) => {
+    log.info(`API Request: GET ${process.env.ETAINABL_API_URL}/${endpoint}/${id}${postEndpoint ? `/${postEndpoint}` : ''}`);
+
+    let response;
+
+    try {
+      response = await etainablApi.get(`${endpoint}/${id}${postEndpoint ? `/${postEndpoint}` : ''}`, options);
+    } catch (e: any) {
+      if (e.response?.data) throw new Error(`API error response: ${JSON.stringify(e.response.data)}`);
+    }
+
+    if (!response) {
+      throw new Error(`No response from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+    }
+
+    if (response.status !== 200) {
+      throw new Error(`${response.status} ${response.statusText} response from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+    }
+
+    if (!response.data) {
+      throw new Error(`No data from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+    }
+
+    return response.data;
+  },
+  list: (etainablApi: AxiosInstance, endpoint: any) => async (options: AxiosRequestConfig = {}): Promise<ETNPagedResponse> => {
+    log.info(`API Request: GET ${process.env.ETAINABL_API_URL}/${endpoint}`);
+
+    let response;
+    
+    try {
+      response = await etainablApi.get(`${endpoint}`, options);
+    } catch (e: any) {
+      if (e.response?.data) throw new Error(`API error response: ${JSON.stringify(e.response.data)}`);
+    }
+
+    if (!response) {
+      throw new Error(`No response from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+    }
+
+    if (response.status !== 200) {
+      throw new Error(`${response.status} ${response.statusText} response from API (GET ${endpoint})`);
+    }
+
+    if (!response.data || !response.data.data) {
+      throw new Error(`No data from API (GET ${endpoint})`);
+    }
+
+    return response.data;
+  },
+  update: (etainablApi: AxiosInstance, endpoint: any) => async (id: string, data: any, options: AxiosRequestConfig = {}) => {
+    log.info(`API Request: PATCH ${process.env.ETAINABL_API_URL}/${endpoint}/${id}`);
+
+    let response;
+    
+    try {
+      response = await etainablApi.patch(`${endpoint}/${id}`, data, options);
+    } catch (e: any) {
+      if (e.response?.data) throw new Error(`API error response: ${JSON.stringify(e.response.data)}`);
+    }
+
+    if (!response) {
+      throw new Error(`No response from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+    }
+
+    if (response.status !== 200) {
+      throw new Error(`${response.status} ${response.statusText} response from API (PATCH ${endpoint})`);
+    }
+
+    if (!response.data) {
+      throw new Error(`No data from API (PATCH ${endpoint})`);
+    }
+
+    return response.data;
+  },
+  create: (etainablApi: AxiosInstance, endpoint: any) => async (data: any, options: AxiosRequestConfig = {}) => {
+    log.info(`API Request: POST ${process.env.ETAINABL_API_URL}/${endpoint}`);
+
+    let response;
+    
+    try {
+      response = await etainablApi.post(`${endpoint}`, data, options);
+    } catch (e: any) {
+      if (e.response?.data) throw new Error(`API error response: ${JSON.stringify(e.response.data)}`);
+    }
+
+    if (!response) {
+      throw new Error(`No response from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+    }
+
+    if (response.status !== 200) {
+      throw new Error(`${response.status} ${response.statusText} response from API (POST ${endpoint})`);
+    }
+
+    if (!response.data) {
+      throw new Error(`No data from API (POST ${endpoint})`);
+    }
+
+    return response.data;
+  },
+  remove: (etainablApi: AxiosInstance, endpoint: any) => async (id: string, options: AxiosRequestConfig = {}) => {
+    log.info(`API Request: DELETE ${process.env.ETAINABL_API_URL}/${endpoint}/${id}`);
+
+    let response;
+    
+    try {
+      response = await etainablApi.delete(`${endpoint}/${id}`, options);
+    } catch (e: any) {
+      if (e.response?.data) throw new Error(`API error response: ${JSON.stringify(e.response.data)}`);
+    }
+
+    if (!response) {
+      throw new Error(`No response from API (GET ${endpoint}/:id${postEndpoint ? `/${postEndpoint}` : ''})`);
+    }
+
+    if (response.status !== 200) {
+      throw new Error(`${response.status} ${response.statusText} response from API (DELETE ${endpoint})`);
+    }
+
+    if (!response.data) {
+      throw new Error(`No data from API (DELETE ${endpoint})`);
+    }
+
+    return response.data;
+  }
+};
+
+interface AuthOptions {
+  key?: string;
+  token?: string;
+}
+
+export default (auth: AuthOptions, instanceOptions: CreateAxiosDefaults = {}) => {
+  const headers: any = {};
+
+  if (auth.key) {
+    headers['x-key'] = auth.key;
+  } else if (auth.token) {
+    headers['Authorization'] = auth.token;
+  } else {
+    headers['x-key'] = process.env.ETAINABL_API_KEY;
+  }
+
+  const etainablApi = axios.create({
+    baseURL: process.env.ETAINABL_API_URL,
+    timeout: 30000,
+    headers,
+    ...instanceOptions
+  });
+
+  return {
+    instance: etainablApi,
+
+    // accounts
+    getAccount: factory.get(etainablApi, 'accounts'),
+    listAccounts: factory.list(etainablApi, 'accounts'),
+    updateAccount: factory.update(etainablApi, 'accounts'),
+    createAccount: factory.create(etainablApi, 'accounts'),
+    removeAccount: factory.remove(etainablApi, 'accounts'),
+
+    // assets
+    getAsset: factory.get(etainablApi, 'assets'),
+    listAssets: factory.list(etainablApi, 'assets'),
+    updateAsset: factory.update(etainablApi, 'assets'),
+    createAsset: factory.create(etainablApi, 'assets'),
+    removeAsset: factory.remove(etainablApi, 'assets'),
+
+    // assetGroups
+    getAssetGroup: factory.get(etainablApi, 'asset-groups'),
+    listAssetGroups: factory.list(etainablApi, 'asset-groups'),
+    updateAssetGroup: factory.update(etainablApi, 'asset-groups'),
+    createAssetGroup: factory.create(etainablApi, 'asset-groups'),
+    removeAssetGroup: factory.remove(etainablApi, 'asset-groups'),
+    getAssetGroupAssets: factory.get(etainablApi, 'asset-groups', 'assets'),
+
+    // automation
+    getAutomation: factory.get(etainablApi, 'automation'),
+    listAutomations: factory.list(etainablApi, 'automation'),
+    updateAutomation: factory.update(etainablApi, 'automation'),
+    createAutomation: factory.create(etainablApi, 'automation'),
+    removeAutomation: factory.remove(etainablApi, 'automation'),
+
+    // consumption
+    getConsumption: factory.get(etainablApi, 'consumptions'),
+    listConsumptions: factory.list(etainablApi, 'consumptions'),
+    updateConsumption: factory.update(etainablApi, 'consumptions'),
+    createConsumption: factory.create(etainablApi, 'consumptions'),
+    removeConsumption: factory.remove(etainablApi, 'consumptions'),
+
+    // readings
+    getReading: factory.get(etainablApi, 'readings'),
+    listReadings: factory.list(etainablApi, 'readings'),
+    updateReading: factory.update(etainablApi, 'readings'),
+    createReading: factory.create(etainablApi, 'readings'),
+    removeReading: factory.remove(etainablApi, 'readings'),
+  }
+};

package/src/consumption.d.ts

@@ -0,0 +1,18 @@
+import moment from 'moment';
+export interface Reading {
+    submittedAt: string;
+    value: number;
+}
+export interface ApportionedReading {
+    date: moment.Moment;
+    reading: number;
+    consumption?: number;
+}
+declare const _default: {
+    apportionedReadings: (readings: Reading[], granularity?: moment.unitOfTime.Diff, interpolationMethod?: string, startDate?: string | undefined, endDate?: string | undefined) => ApportionedReading[];
+    consumptionFromReadings: (readings: Reading[], startDate: string, endDate: string, granularity?: moment.unitOfTime.Diff, interpolationMethod?: string) => {
+        totalConsumption: any;
+        apportioned: ApportionedReading[];
+    };
+};
+export default _default;

package/src/consumption.ts

@@ -0,0 +1,73 @@
+import moment from 'moment';
+import { interpolate } from './lib/readingsInterpolate.js';
+
+export interface Reading {
+  submittedAt: string,
+  value: number
+}
+
+export interface ApportionedReading {
+  date: moment.Moment,
+  reading: number,
+  consumption?: number
+}
+
+const apportionedReadings = (readings: Reading[], granularity: moment.unitOfTime.Diff = 'days', interpolationMethod: string = 'linear', startDate?: string, endDate?: string): ApportionedReading[] => {
+  // Readings sorted from newest to oldest
+  const sortedReadings = [...readings].sort((a, b) => moment(a.submittedAt).diff(b.submittedAt));
+
+  // Array of every hour/day etc between the first and last reading
+  const intervals = moment(sortedReadings[sortedReadings.length - 1].submittedAt).diff(moment(sortedReadings[0].submittedAt), granularity);
+
+  const dates = [...Array(intervals).keys()]
+    .slice(1)
+    .map((interval: number) => moment(sortedReadings[0].submittedAt).startOf(granularity).add(interval, granularity));
+
+  let interpolatedReadings = dates.map((date: moment.Moment) => {
+    const reading = interpolate(sortedReadings, date, interpolationMethod);
+
+    return {
+      date,
+      reading
+    };
+  });
+
+  interpolatedReadings = interpolatedReadings.map((reading: ApportionedReading, index: number) => {
+    const prevReading = interpolatedReadings[index - 1];
+
+    if (prevReading) {
+      return {
+        ...reading,
+        consumption: reading.reading - prevReading.reading
+      };
+    }
+
+    return reading;
+
+  });
+
+  if (startDate) {
+    interpolatedReadings = interpolatedReadings.filter((reading: ApportionedReading) => moment(reading.date).isSameOrAfter(startDate, granularity));
+  }
+
+  if (endDate) {
+    interpolatedReadings = interpolatedReadings.filter((reading: ApportionedReading) => moment(reading.date).isSameOrBefore(endDate, granularity));
+  }
+
+  return interpolatedReadings;
+};
+
+const consumptionFromReadings = (readings: Reading[], startDate: string, endDate: string, granularity: moment.unitOfTime.Diff = 'hours', interpolationMethod: string = 'linear') => {
+  // Split the readings into hourly readings and calculate the consumption for each hour
+  const apportioned = apportionedReadings(readings, granularity, interpolationMethod, startDate, endDate);
+
+  // Calculate the total consumption between the start and end dates
+  const totalConsumption = apportioned.reduce((acc: any, reading) => acc + reading.consumption, 0);
+
+  return { totalConsumption, apportioned };
+};
+
+export default {
+  apportionedReadings,
+  consumptionFromReadings
+};

package/src/db.ts

@@ -0,0 +1,34 @@
+import { MongoClient, Db } from 'mongodb';
+import { logger } from './logger';
+
+const log = logger('dbHelpers');
+
+let cachedDb: Db;
+
+export async function connectToDatabase() {
+  log.debug('Connecting to MongoDB server...');
+
+  if (cachedDb) {
+    log.debug('Using cached MongoDB connection.');
+    return Promise.resolve(cachedDb);
+  }
+
+  const uri = `mongodb+srv://${process.env.ETAINABL_DB_URL}`;
+
+  const client = new MongoClient(uri, {
+    auth: {
+      username: process.env.AWS_ACCESS_KEY_ID,
+      password: process.env.AWS_SECRET_ACCESS_KEY
+    },
+    authSource: '$external',
+    authMechanism: 'MONGODB-AWS'
+  });
+
+  await client.connect();
+
+  log.debug('Connected successfully to MongoDB server!');
+
+  cachedDb = client.db('etainabl');
+
+  return cachedDb;
+}

package/src/index.d.ts

@@ -0,0 +1,4 @@
+import api from './api.js';
+import consumption from './consumption.js';
+import logger from './logger.js';
+export { api, logger, consumption };

package/src/index.ts

@@ -0,0 +1,9 @@
+import api from './api.js';
+import consumption from './consumption.js';
+import logger from './logger.js';
+
+export {
+  api,
+  logger,
+  consumption
+}

package/src/lib/readingsInterpolate.ts

@@ -0,0 +1,100 @@
+import moment from 'moment';
+
+export function interpolate(meterReadings: any[], targetDate: any, method: string = 'linear') {
+  if (method === 'cubic') {
+    return cubicInterpolation(meterReadings, targetDate);
+  }
+
+  if (method === 'linear') {
+    return linearInterpolation(meterReadings, targetDate);
+  }
+
+  throw new Error(`Interpolation method ${method} not supported`);
+}
+
+function linearInterpolation(meterReadings: any[], targetDate: any) {
+  // Ensure the meter readings are sorted by date
+  meterReadings.sort((a, b) => moment(a.submittedAt).unix() - moment(b.submittedAt).unix());
+
+  const targetTimestamp = moment(targetDate).startOf('minute').unix();
+
+  // Find the two nearest meter readings for the target date
+  let lowerIndex = -1;
+  let upperIndex = -1;
+  for (let i = 0; i < meterReadings.length; i++) {
+    const reading = meterReadings[i];
+    if (moment(reading.submittedAt).startOf('minute').unix() <= targetTimestamp) {
+      lowerIndex = i;
+    } else {
+      upperIndex = i;
+      break;
+    }
+  }
+
+  // If no readings are available for interpolation, return null
+  if (lowerIndex === -1 || upperIndex === -1) {
+    return null;
+  }
+
+  const lowerReading = meterReadings[lowerIndex];
+  const upperReading = meterReadings[upperIndex];
+
+  // Linear interpolation formula
+  const consumption = lowerReading.value
+    + ((targetTimestamp - moment(lowerReading.submittedAt).startOf('minute').unix())
+      / (moment(upperReading.submittedAt).startOf('minute').unix() - moment(lowerReading.submittedAt).startOf('minute').unix()))
+      * (upperReading.value - lowerReading.value);
+
+  return consumption;
+};
+
+function cubicInterpolateCalc(x0: number, y0: number, x1: number, y1: number, x2: number, y2: number, x3: number, y3: number, x: number) {
+    const t = (x - x1) / (x2 - x1);
+    const t2 = t * t;
+    const t3 = t2 * t;
+
+    const a0 = y3 - y2 - y0 + y1;
+    const a1 = y0 - y1 - a0;
+    const a2 = y2 - y0;
+    const a3 = y1;
+
+    return a0 * t3 + a1 * t2 + a2 * t + a3;
+}
+  
+function cubicInterpolation(meterReadings: any[], targetDate: any) {
+    // Ensure the meter readings are sorted by date
+    meterReadings.sort((a, b) => moment(a.submittedAt).unix() - moment(b.submittedAt).unix());
+
+    const targetTimestamp = new Date(targetDate).getTime();
+
+    // Find the four nearest meter readings for the target date
+    let startIndex = -1;
+    for (let i = 0; i < meterReadings.length; i++) {
+        const reading = meterReadings[i];
+        if (moment(reading.submittedAt).startOf('minute').unix() > targetTimestamp) {
+        startIndex = i - 2;
+        break;
+        }
+    }
+
+    // If no readings are available for interpolation, return null
+    if (startIndex < 0 || startIndex + 3 >= meterReadings.length) {
+        return null;
+    }
+
+    const readings = meterReadings.slice(startIndex, startIndex + 4);
+
+    const interpolatedConsumption = cubicInterpolateCalc(
+        moment(readings[0].submittedAt).startOf('minute').unix(),
+        readings[0].value,
+        moment(readings[1].submittedAt).startOf('minute').unix(),
+        readings[1].value,
+        moment(readings[2].submittedAt).startOf('minute').unix(),
+        readings[2].value,
+        moment(readings[3].submittedAt).startOf('minute').unix(),
+        readings[3].value,
+        targetTimestamp
+    );
+
+    return interpolatedConsumption;
+}

package/src/logger.d.ts

@@ -0,0 +1,3 @@
+import winston from 'winston';
+declare const _default: (namespace: string) => winston.Logger;
+export default _default;

package/src/logger.ts

@@ -0,0 +1,13 @@
+import winston from 'winston';
+
+export default (namespace: string) => winston.createLogger({
+  level: 'debug',
+  format: winston.format.combine(
+    winston.format.timestamp(),
+    winston.format.json()
+  ),
+  defaultMeta: { service: process.env.AWS_LAMBDA_FUNCTION_NAME, script: namespace },
+  transports: [
+    new winston.transports.Console()
+  ]
+});

package/tsconfig.json

@@ -0,0 +1,36 @@
+{   
+    "display": "soclean-connector",
+    "compilerOptions": {
+        "target": "es2022",
+        "strict": true,
+        "outDir": "./",                       
+        "rootDir": "./src", 
+        "preserveConstEnums": true,
+        "sourceMap": true,
+        "module":"ESNext",
+        "moduleResolution":"NodeNext",
+        "esModuleInterop": true, 
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true, 
+        "isolatedModules": true,
+        "pretty": true,
+        "resolveJsonModule": true,
+        "allowJs": true,
+        "declaration": true
+    },
+    "watchOptions": {
+        // Use native file system events for files and directories
+        "watchFile": "useFsEvents",
+        "watchDirectory": "useFsEvents",
+        // Poll files for updates more frequently
+        // when they're updated a lot.
+        "fallbackPolling": "dynamicPriority",
+        // Don't coalesce watch notification
+        "synchronousWatchDirectory": true
+        // Finally, two additional settings for reducing the amount of possible
+        // files to track  work from these directories
+    },
+    "exclude": [],
+    "include": ["./src/*.ts"],
+    "compileOnSave": true
+}