cloudstructs 0.4.21 → 0.4.24

package/node_modules/compress-brotli/README.md

@@ -0,0 +1,125 @@
+# compress-brotli
+
+![Last version](https://img.shields.io/github/tag/Kikobeats/compress-brotli.svg?style=flat-square)
+[![Coverage Status](https://img.shields.io/coveralls/Kikobeats/compress-brotli.svg?style=flat-square)](https://coveralls.io/github/Kikobeats/compress-brotli)
+[![NPM Status](https://img.shields.io/npm/dm/compress-brotli.svg?style=flat-square)](https://www.npmjs.org/package/compress-brotli)
+
+> Compress/Decompress using Brotli in a simple way.
+
+## Highlights
+
+- Handle edge cases (such as try to compress `undefined`).
+- JSON serialization/deserialization with Buffer support by default.
+- Easy tu customize (e.g., using [v8 serialization](https://nodejs.org/api/v8.html#v8_v8_serialize_value)).
+
+## Install
+
+```bash
+$ npm install compress-brotli --save
+```
+
+## Usage
+
+```js
+const createCompress = require('compress-brotli')
+
+// It exposes compress/decompress methods
+const { compress, decompress } = createCompress()
+```
+
+using [v8 serialization](https://nodejs.org/api/v8.html#v8_v8_serialize_value):
+
+```js
+const createCompress = require('compress-brotli')
+const v8 = require('v8')
+
+const { compress, decompress } = createCompress({
+  serialize: v8.serialize,
+  deserialize: v8.deserialize
+})
+```
+customizing compress options:
+```js
+const createCompress = require('compress-brotli')
+
+const {
+  constants: {
+    BROTLI_MODE_TEXT,
+    BROTLI_PARAM_MODE,
+    BROTLI_PARAM_QUALITY
+  }
+} = require('zlib')
+
+// Provide factory level default options
+const { compress, decompress } = createCompress({
+  compressOptions: {
+    chunkSize: 1024,
+    parameters: {
+      [BROTLI_PARAM_MODE]: BROTLI_MODE_TEXT
+    }
+  },
+  decompressOptions: {
+    chunkSize: 1024,
+    parameters: {
+      [BROTLI_PARAM_MODE]: BROTLI_MODE_TEXT
+    }
+  }
+})
+const data = 'whatever'
+
+// Override call level options (deep merge for parameters)
+const compressed = compress(data, {
+  parameters: {
+    [BROTLI_PARAM_QUALITY]: 7
+  }
+})
+decompress(compressed, {
+  chunkSize: 2048
+})
+```
+
+## API
+
+### compressBrotli([options])
+
+#### enable
+
+Type: `boolean`<br>
+Default: `false`
+
+If pass disable, it will return a noop compress/decompress methods.
+
+#### serialize
+
+Type: `function`<br>
+Default: `JSONB.stringify`
+
+It determines the serialize method to use before compress the data.
+
+#### deserialize
+
+Type: `function`<br>
+Default: `JSONB.parse`
+
+It determines the deserialize method to use after decompress the data.
+
+#### compressOptions
+
+Type: `zlib.BrotliOptions`<br>
+Default: `{}` i.e. default *zlib.brotliCompress* options will be used
+
+It  defines default options to be used in wrapped *zlib.brotliCompress* call
+
+#### decompressOptions
+
+Type: `zlib.BrotliOptions`<br>
+Default: `{}` i.e. default *zlib.brotliDecompress* options will be used
+
+It defines default options to be used in wrapped *zlib.brotliDecompress* call
+
+## License
+
+**compress-brotli** © [Kiko Beats](https://kikobeats.com), released under the [MIT](https://github.com/Kikobeats/compress-brotli/blob/master/LICENSE.md) License.<br>
+Authored and maintained by Kiko Beats with help from [contributors](https://github.com/Kikobeats/compress-brotli/contributors).
+
+> [kikobeats.com](https://kikobeats.com) · GitHub [Kiko Beats](https://github.com/Kikobeats) · Twitter [@Kikobeats](https://twitter.com/Kikobeats)

package/node_modules/compress-brotli/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "compress-brotli",
+  "description": "Simple cross Node.js inteface for using brotli compression",
+  "homepage": "https://nicedoc.io/Kikobeats/compress-brotli",
+  "version": "1.3.8",
+  "main": "src/index.js",
+  "author": {
+    "email": "josefrancisco.verdu@gmail.com",
+    "name": "Kiko Beats",
+    "url": "https://kikobeats.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kikobeats/compress-brotli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Kikobeats/compress-brotli/issues"
+  },
+  "keywords": [
+    "api",
+    "brotli",
+    "compress",
+    "compressed",
+    "compression",
+    "decode",
+    "decompress",
+    "decompression",
+    "encode",
+    "format",
+    "zlib"
+  ],
+  "dependencies": {
+    "@types/json-buffer": "~3.0.0",
+    "json-buffer": "~3.0.1"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "latest",
+    "@commitlint/config-conventional": "latest",
+    "ava": "latest",
+    "c8": "latest",
+    "ci-publish": "latest",
+    "conventional-github-releaser": "latest",
+    "finepack": "latest",
+    "git-authors-cli": "latest",
+    "git-dirty": "latest",
+    "nano-staged": "latest",
+    "npm-check-updates": "latest",
+    "prettier-standard": "latest",
+    "simple-git-hooks": "latest",
+    "sinon": "latest",
+    "standard": "latest",
+    "standard-markdown": "latest",
+    "standard-version": "latest"
+  },
+  "engines": {
+    "node": ">= 12"
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "clean": "rm -rf node_modules",
+    "contributors": "(git-authors-cli && finepack && git add package.json && git commit -m 'build: contributors' --no-verify) || true",
+    "lint": "standard-markdown README.md && standard",
+    "postrelease": "npm run release:tags && npm run release:github && (ci-publish || npm publish --access=public)",
+    "prerelease": "npm run update:check && npm run contributors",
+    "pretest": "npm run lint",
+    "release": "standard-version -a",
+    "release:github": "conventional-github-releaser -p angular",
+    "release:tags": "git push --follow-tags origin HEAD:master",
+    "test": "c8 ava",
+    "update": "ncu -u",
+    "update:check": "ncu -- --error-level 2"
+  },
+  "license": "MIT",
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "nano-staged": {
+    "*.js,!*.min.js,": [
+      "prettier-standard"
+    ],
+    "*.md": [
+      "standard-markdown"
+    ],
+    "package.json": [
+      "finepack"
+    ]
+  },
+  "simple-git-hooks": {
+    "commit-msg": "npx commitlint --edit",
+    "pre-commit": "npx nano-staged"
+  },
+  "types": "src/index.d.ts"
+}

package/node_modules/compress-brotli/src/index.d.ts

@@ -0,0 +1,36 @@
+import { BrotliOptions, InputType, CompressCallback } from 'zlib'
+import { stringify as JSONBstringify, parse as JSONBparse } from 'json-buffer'
+
+declare module 'compress-brotli'
+
+type CompressResult = Promise<Parameters<CompressCallback>[1]>
+type DecompressResult = Promise<ReturnType<typeof JSONBparse>>
+
+type Serialize<T> = (source: InputType) => T
+type Deserialize<T> = (source: CompressResult) => T
+
+declare function createCompress<
+  SerializeResult = ReturnType<typeof JSONBstringify>,
+  DeserializeResult = ReturnType<typeof JSONBparse>
+>(
+  options?: {
+    enable?: boolean,
+    serialize?: Serialize<SerializeResult>,
+    deserialize?: Deserialize<DeserializeResult>,
+    iltorb?: any,
+    compressOptions?: BrotliOptions,
+    decompressOptions?: BrotliOptions
+  }
+): {
+  serialize: Serialize<SerializeResult>,
+  deserialize: Deserialize<DeserializeResult>,
+  compress: (data: InputType, optioins?: BrotliOptions) => CompressResult
+  decompress: (data: InputType, optioins?: BrotliOptions) => DecompressResult
+}
+
+declare namespace createCompress {
+  const stringify: typeof JSONBstringify
+  const parse: typeof JSONBparse
+}
+
+export default createCompress

package/node_modules/compress-brotli/src/index.js

@@ -0,0 +1,45 @@
+'use strict'
+
+const { promisify } = require('util')
+const JSONB = require('json-buffer')
+const zlib = require('zlib')
+
+const mergeOptions = require('./merge-options')
+
+const compress = promisify(zlib.brotliCompress)
+
+const decompress = promisify(zlib.brotliDecompress)
+
+const identity = val => val
+
+const createCompress = ({
+  enable = true,
+  serialize = JSONB.stringify,
+  deserialize = JSONB.parse,
+  compressOptions,
+  decompressOptions
+} = {}) => {
+  if (!enable) {
+    return { serialize, deserialize, decompress: identity, compress: identity }
+  }
+
+  return {
+    serialize,
+    deserialize,
+    compress: async (data, options = {}) => {
+      if (data === undefined) return data
+      const serializedData = serialize(data)
+      return compress(serializedData, mergeOptions(compressOptions, options))
+    },
+    decompress: async (data, options = {}) => {
+      if (data === undefined) return data
+      return deserialize(
+        await decompress(data, mergeOptions(decompressOptions, options))
+      )
+    }
+  }
+}
+
+module.exports = createCompress
+module.exports.stringify = JSONB.stringify
+module.exports.parse = JSONB.parse

package/node_modules/compress-brotli/src/merge-options.js

@@ -0,0 +1,18 @@
+'use strict'
+
+module.exports = (defaultOptions = {}, options = {}) => {
+  const params = {
+    ...(defaultOptions.params || {}),
+    ...(options.params || {})
+  }
+
+  return {
+    ...defaultOptions,
+    ...options,
+    ...(Object.keys(params).length
+      ? {
+          params
+        }
+      : {})
+  }
+}

package/node_modules/follow-redirects/README.md

@@ -63,10 +63,17 @@ const { http, https } = require('follow-redirects');
 
 const options = url.parse('http://bit.ly/900913');
 options.maxRedirects = 10;
-options.beforeRedirect = (options, { headers }) => {
+options.beforeRedirect = (options, response, request) => {
   // Use this to adjust the request options upon redirecting,
   // to inspect the latest response headers,
   // or to cancel the request by throwing an error
+
+  // response.headers = the redirect response headers
+  // response.statusCode = the redirect response code (eg. 301, 307, etc.)
+
+  // request.url = the requested URL that resulted in a redirect
+  // request.headers = the headers in the request that resulted in a redirect
+  // request.method = the method of the request that resulted in a redirect
   if (options.hostname === "example.com") {
     options.auth = "user:password";
   }

package/node_modules/follow-redirects/index.js

@@ -270,7 +270,7 @@ RedirectableRequest.prototype._performRequest = function () {
   // If specified, use the agent corresponding to the protocol
   // (HTTP and HTTPS use different types of agents)
   if (this._options.agents) {
-    var scheme = protocol.substr(0, protocol.length - 1);
+    var scheme = protocol.slice(0, -1);
     this._options.agent = this._options.agents[scheme];
   }
 
@@ -362,10 +362,21 @@ RedirectableRequest.prototype._processResponse = function (response) {
     return;
   }
 
+  // Store the request headers if applicable
+  var requestHeaders;
+  var beforeRedirect = this._options.beforeRedirect;
+  if (beforeRedirect) {
+    requestHeaders = Object.assign({
+      // The Host header was set by nativeProtocol.request
+      Host: response.req.getHeader("host"),
+    }, this._options.headers);
+  }
+
   // RFC7231§6.4: Automatic redirection needs to done with
   // care for methods not known to be safe, […]
   // RFC7231§6.4.2–3: For historical reasons, a user agent MAY change
   // the request method from POST to GET for the subsequent request.
+  var method = this._options.method;
   if ((statusCode === 301 || statusCode === 302) && this._options.method === "POST" ||
       // RFC7231§6.4.4: The 303 (See Other) status code indicates that
       // the server is redirecting the user agent to a different resource […]
@@ -413,10 +424,18 @@ RedirectableRequest.prototype._processResponse = function (response) {
   }
 
   // Evaluate the beforeRedirect callback
-  if (typeof this._options.beforeRedirect === "function") {
-    var responseDetails = { headers: response.headers };
+  if (typeof beforeRedirect === "function") {
+    var responseDetails = {
+      headers: response.headers,
+      statusCode: statusCode,
+    };
+    var requestDetails = {
+      url: currentUrl,
+      method: method,
+      headers: requestHeaders,
+    };
     try {
-      this._options.beforeRedirect.call(null, this._options, responseDetails);
+      beforeRedirect(this._options, responseDetails, requestDetails);
     }
     catch (err) {
       this.emit("error", err);

package/node_modules/follow-redirects/package.json

@@ -1,6 +1,6 @@
 {
   "name": "follow-redirects",
-  "version": "1.14.9",
+  "version": "1.15.0",
   "description": "HTTP and HTTPS modules that follow redirects.",
   "license": "MIT",
   "main": "index.js",

package/node_modules/keyv/package.json

@@ -1,48 +1,57 @@
 {
-  "name": "keyv",
-  "version": "4.1.1",
-  "description": "Simple key-value storage with support for multiple backends",
-  "main": "src/index.js",
-  "scripts": {
-    "test": "xo && nyc ava --serial",
-    "coverage": "nyc report --reporter=text-lcov > coverage.lcov",
-    "clean": "rm -rf node_modules && rm -rf .nyc_output && rm -rf coverage.lcov && rm -rf ./test/testdb.sqlite"
-  },
-  "xo": {
-    "extends": "xo-lukechilds",
-    "rules": {
-      "unicorn/prefer-module": 0
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/jaredwray/keyv.git"
-  },
-  "keywords": [
-    "key",
-    "value",
-    "store",
-    "cache",
-    "ttl"
-  ],
-  "author": "Jared Wray <me@jaredwray.com> (http://jaredwray.com)",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/jaredwray/keyv/issues"
-  },
-  "homepage": "https://github.com/jaredwray/keyv",
-  "dependencies": {
-    "json-buffer": "3.0.1"
-  },
-  "devDependencies": {
-    "@keyv/test-suite": "*",
-    "ava": "^4.0.1",
-    "eslint-config-xo-lukechilds": "^1.0.1",
-    "eslint-plugin-promise": "^6.0.0",
-    "nyc": "^15.1.0",
-    "pify": "5.0.0",
-    "this": "^1.1.0",
-    "timekeeper": "^2.2.0",
-    "xo": "^0.47.0"
-  }
+	"name": "keyv",
+	"version": "4.2.6",
+	"description": "Simple key-value storage with support for multiple backends",
+	"main": "src/index.js",
+	"scripts": {
+		"test": "xo && nyc ava --serial",
+		"coverage": "nyc report --reporter=text-lcov > coverage.lcov",
+		"clean": "rm -rf node_modules && rm -rf .nyc_output && rm -rf coverage.lcov && rm -rf ./test/testdb.sqlite"
+	},
+	"xo": {
+		"rules": {
+			"unicorn/prefer-module": 0,
+			"unicorn/prefer-node-protocol": 0
+		}
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/jaredwray/keyv.git"
+	},
+	"keywords": [
+		"key",
+		"value",
+		"store",
+		"cache",
+		"ttl"
+	],
+	"author": "Jared Wray <me@jaredwray.com> (http://jaredwray.com)",
+	"license": "MIT",
+	"bugs": {
+		"url": "https://github.com/jaredwray/keyv/issues"
+	},
+	"homepage": "https://github.com/jaredwray/keyv",
+	"dependencies": {
+		"compress-brotli": "^1.3.8",
+		"json-buffer": "3.0.1"
+	},
+	"devDependencies": {
+		"@keyv/test-suite": "*",
+		"ava": "^4.2.0",
+		"eslint-plugin-promise": "^6.0.0",
+		"nyc": "^15.1.0",
+		"pify": "5.0.0",
+		"this": "^1.1.0",
+		"timekeeper": "^2.2.0",
+		"tsd": "^0.20.0",
+		"typescript": "^4.6.4",
+		"xo": "^0.48.0"
+	},
+	"tsd": {
+		"directory": "test"
+	},
+	"types": "./src/index.d.ts",
+	"files": [
+		"src"
+	]
 }

package/node_modules/keyv/src/index.d.ts

@@ -0,0 +1,89 @@
+import {EventEmitter} from 'events';
+
+type WithRequiredProperties<T, K extends keyof T> = T & Required<Pick<T, K>>;
+
+declare class Keyv<Value = any, Options extends Record<string, any> = Record<string, unknown>> extends EventEmitter {
+	/**
+     * `this.opts` is an object containing at least the properties listed
+     * below. However, `Keyv.Options` allows arbitrary properties as well.
+     * These properties can be specified as the second type parameter to `Keyv`.
+     */
+	opts: WithRequiredProperties<
+	Keyv.Options<Value>,
+	'deserialize' | 'namespace' | 'serialize' | 'store' | 'uri'
+	> &
+	Options;
+
+	/**
+     * @param opts The options object is also passed through to the storage adapter. Check your storage adapter docs for any extra options.
+     */
+	constructor(options?: Keyv.Options<Value> & Options);
+	/**
+     * @param uri The connection string URI.
+     *
+     * Merged into the options object as options.uri.
+     * @param opts The options object is also passed through to the storage adapter. Check your storage adapter docs for any extra options.
+     */
+	constructor(uri?: string, options?: Keyv.Options<Value> & Options);
+
+	/** Returns the value. */
+	get<Raw extends boolean = false>(key: string | string[], options?: {raw?: Raw}):
+	Promise<(Raw extends false
+		? Value
+		: Keyv.DeserializedData<Value>) | undefined>;
+	/**
+     * Set a value.
+     *
+     * By default keys are persistent. You can set an expiry TTL in milliseconds.
+     */
+	set(key: string, value: Value, ttl?: number): Promise<true>;
+	/**
+     * Deletes an entry.
+     *
+     * Returns `true` if the key existed, `false` if not.
+     */
+	delete(key: string | string[]): Promise<boolean>;
+	/** Delete all entries in the current namespace. */
+	clear(): Promise<void>;
+	/** Check if key exists in current namespace. */
+	has(key: string): Promise<boolean>;
+	/** Iterator */
+	iterator(namespace: string | undefined): AsyncGenerator<any, void, any>;
+}
+
+declare namespace Keyv {
+	interface Options<Value> {
+		[key: string]: any;
+
+		/** Namespace for the current instance. */
+		namespace?: string | undefined;
+		/** A custom serialization function. */
+		serialize?: ((data: DeserializedData<Value>) => string) | undefined;
+		/** A custom deserialization function. */
+		deserialize?: ((data: string) => DeserializedData<Value> | undefined) | undefined;
+		/** The connection string URI. */
+		uri?: string | undefined;
+		/** The storage adapter instance to be used by Keyv. */
+		store?: Store<Value> | undefined;
+		/** Default TTL. Can be overridden by specififying a TTL on `.set()`. */
+		ttl?: number | undefined;
+		/** Specify an adapter to use. e.g `'redis'` or `'mongodb'`. */
+		adapter?: 'redis' | 'mongodb' | 'mongo' | 'sqlite' | 'postgresql' | 'postgres' | 'mysql' | undefined;
+		/** Enable compression option **/
+		compress?: Record<string, unknown> | undefined;
+	}
+
+	interface DeserializedData<Value> {
+		value: Value; expires: number | undefined;
+	}
+
+	interface Store<Value> {
+		get(key: string): Value | Promise<Value | undefined> | undefined;
+		set(key: string, value: Value, ttl?: number): any;
+		delete(key: string): boolean | Promise<boolean>;
+		clear(): void | Promise<void>;
+		has(key: string): boolean | Promise<boolean>;
+	}
+}
+
+export = Keyv;