ali-skills 0.0.21 → 0.0.22

package/node_modules/circular-json-for-egg/build/circular-json.node.js

@@ -0,0 +1,207 @@
+/*!
+Copyright (C) 2013-2017 by Andrea Giammarchi - @WebReflection
+
+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.
+
+*/
+var
+  // should be a not so common char
+  // possibly one JSON does not encode
+  // possibly one encodeURIComponent does not encode
+  // right now this char is '~' but this might change in the future
+  specialChar = '~',
+  safeSpecialChar = '\\x' + (
+    '0' + specialChar.charCodeAt(0).toString(16)
+  ).slice(-2),
+  escapedSafeSpecialChar = '\\' + safeSpecialChar,
+  specialCharRG = new RegExp(safeSpecialChar, 'g'),
+  safeSpecialCharRG = new RegExp(escapedSafeSpecialChar, 'g'),
+
+  safeStartWithSpecialCharRG = new RegExp('(?:^|([^\\\\]))' + escapedSafeSpecialChar),
+
+  indexOf = [].indexOf || function(v){
+    for(var i=this.length;i--&&this[i]!==v;);
+    return i;
+  },
+  $String = String  // there's no way to drop warnings in JSHint
+                    // about new String ... well, I need that here!
+                    // faked, and happy linter!
+;
+
+function generateReplacer(value, replacer, resolve) {
+  var
+    doNotIgnore = false,
+    inspect = !!replacer,
+    path = [],
+    all  = [value],
+    seen = [value],
+    mapp = [resolve ? specialChar : '[Circular]'],
+    last = value,
+    lvl  = 1,
+    i, fn
+  ;
+  if (inspect) {
+    fn = typeof replacer === 'object' ?
+      function (key, value) {
+        return key !== '' && indexOf.call(replacer, key) < 0 ? void 0 : value;
+      } :
+      replacer;
+  }
+  return function(key, value) {
+    // the replacer has rights to decide
+    // if a new object should be returned
+    // or if there's some key to drop
+    // let's call it here rather than "too late"
+    if (inspect) value = fn.call(this, key, value);
+
+    // first pass should be ignored, since it's just the initial object
+    if (doNotIgnore) {
+      if (last !== this) {
+        i = lvl - indexOf.call(all, this) - 1;
+        lvl -= i;
+        all.splice(lvl, all.length);
+        path.splice(lvl - 1, path.length);
+        last = this;
+      }
+      // console.log(lvl, key, path);
+      if (typeof value === 'object' && value) {
+    	// if object isn't referring to parent object, add to the
+        // object path stack. Otherwise it is already there.
+        if (indexOf.call(all, value) < 0) {
+          all.push(last = value);
+        }
+        lvl = all.length;
+        i = indexOf.call(seen, value);
+        if (i < 0) {
+          i = seen.push(value) - 1;
+          if (resolve) {
+            // key cannot contain specialChar but could be not a string
+            path.push(('' + key).replace(specialCharRG, safeSpecialChar));
+            mapp[i] = specialChar + path.join(specialChar);
+          } else {
+            mapp[i] = mapp[0];
+          }
+        } else {
+          value = mapp[i];
+        }
+      } else {
+        if (typeof value === 'string' && resolve) {
+          // ensure no special char involved on deserialization
+          // in this case only first char is important
+          // no need to replace all value (better performance)
+          value = value .replace(safeSpecialChar, escapedSafeSpecialChar)
+                        .replace(specialChar, safeSpecialChar);
+        }
+      }
+    } else {
+      doNotIgnore = true;
+    }
+    return value;
+  };
+}
+
+function retrieveFromPath(current, keys) {
+  for(var i = 0, length = keys.length; i < length; current = current[
+    // keys should be normalized back here
+    keys[i++].replace(safeSpecialCharRG, specialChar)
+  ]);
+  return current;
+}
+
+function generateReviver(reviver) {
+  return function(key, value) {
+    var isString = typeof value === 'string';
+    if (isString && value.charAt(0) === specialChar) {
+      return new $String(value.slice(1));
+    }
+    if (key === '') value = regenerate(value, value, {});
+    // again, only one needed, do not use the RegExp for this replacement
+    // only keys need the RegExp
+    if (isString) value = value .replace(safeStartWithSpecialCharRG, '$1' + specialChar)
+                                .replace(escapedSafeSpecialChar, safeSpecialChar);
+    return reviver ? reviver.call(this, key, value) : value;
+  };
+}
+
+function regenerateArray(root, current, retrieve) {
+  for (var i = 0, length = current.length; i < length; i++) {
+    current[i] = regenerate(root, current[i], retrieve);
+  }
+  return current;
+}
+
+function regenerateObject(root, current, retrieve) {
+  for (var key in current) {
+    if (current.hasOwnProperty(key)) {
+      current[key] = regenerate(root, current[key], retrieve);
+    }
+  }
+  return current;
+}
+
+function regenerate(root, current, retrieve) {
+  return current instanceof Array ?
+    // fast Array reconstruction
+    regenerateArray(root, current, retrieve) :
+    (
+      current instanceof $String ?
+        (
+          // root is an empty string
+          current.length ?
+            (
+              retrieve.hasOwnProperty(current) ?
+                retrieve[current] :
+                retrieve[current] = retrieveFromPath(
+                  root, current.split(specialChar)
+                )
+            ) :
+            root
+        ) :
+        (
+          current instanceof Object ?
+            // dedicated Object parser
+            regenerateObject(root, current, retrieve) :
+            // value as it is
+            current
+        )
+    )
+  ;
+}
+
+var CircularJSON = {
+  stringify: function stringify(value, replacer, space, doNotResolve) {
+    return CircularJSON.parser.stringify(
+      value,
+      generateReplacer(value, replacer, !doNotResolve),
+      space
+    );
+  },
+  parse: function parse(text, reviver) {
+    return CircularJSON.parser.parse(
+      text,
+      generateReviver(reviver)
+    );
+  },
+  // A parser should be an API 1:1 compatible with JSON
+  // it should expose stringify and parse methods.
+  // The default parser is the native JSON.
+  parser: JSON
+};
+
+module.exports = CircularJSON;

package/node_modules/circular-json-for-egg/package.json

@@ -0,0 +1,42 @@
+{
+  "version": "1.0.0",
+  "name": "circular-json-for-egg",
+  "description": "JSON does not handle circular references. This version does",
+  "license": "MIT",
+  "homepage": "https://github.com/eggjs/circular-json",
+  "keywords": [
+    "JSON",
+    "circular",
+    "reference",
+    "recursive",
+    "recursion",
+    "parse",
+    "stringify"
+  ],
+  "files": [
+    "build"
+  ],
+  "generator": "https://github.com/WebReflection/gitstrap",
+  "author": {
+    "name": "Andrea Giammarchi",
+    "web": "http://webreflection.blogspot.com/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/WebReflection/circular-json.git"
+  },
+  "unpkg": "build/circular-json.js",
+  "main": "./build/circular-json.node.js",
+  "scripts": {
+    "test": "istanbul cover test/circular-json.js",
+    "coveralls": "cat ./coverage/lcov.info | coveralls",
+    "web": "$(sleep 2 && open http://0.0.0.0:7151/) & tiny-cdn run ./",
+    "prepublish": "make build"
+  },
+  "devDependencies": {
+    "coveralls": "^2.13.0",
+    "istanbul": "^0.4.5",
+    "tiny-cdn": "^0.7.0",
+    "tressa": "^0.3.1"
+  }
+}

package/node_modules/cluster-client/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 node_modules
+
+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.

package/node_modules/cluster-client/README.md

@@ -0,0 +1,319 @@
+# cluster-client
+
+Sharing Connection among Multi-Process Nodejs
+
+[![NPM version][npm-image]][npm-url]
+[![CI](https://github.com/node-modules/cluster-client/actions/workflows/nodejs.yml/badge.svg)](https://github.com/node-modules/cluster-client/actions/workflows/nodejs.yml)
+[![Test coverage][codecov-image]][codecov-url]
+[![Known Vulnerabilities][snyk-image]][snyk-url]
+[![npm download][download-image]][download-url]
+
+[npm-image]: https://img.shields.io/npm/v/cluster-client.svg?style=flat-square
+[npm-url]: https://npmjs.org/package/cluster-client
+[codecov-image]: https://codecov.io/gh/node-modules/cluster-client/branch/master/graph/badge.svg
+[codecov-url]: https://codecov.io/gh/node-modules/cluster-client
+[snyk-image]: https://snyk.io/test/npm/cluster-client/badge.svg?style=flat-square
+[snyk-url]: https://snyk.io/test/npm/cluster-client
+[download-image]: https://img.shields.io/npm/dm/cluster-client.svg?style=flat-square
+[download-url]: https://npmjs.org/package/cluster-client
+
+As we know, each Node.js process runs in a single thread. Usually, we split a single process into multiple processes to take advantage of multi-core systems. On the other hand, it brings more system overhead, sush as maintaining more TCP connections between servers.
+
+This module is designed to share connections among multi-process Nodejs.
+
+## Theory
+
+- Inspired by [Leader/Follower pattern](http://www.cs.wustl.edu/~schmidt/PDF/lf.pdf).
+- Allow ONLY one process "the Leader" to communicate with server. Other processes "the Followers" act as "Proxy" client, and forward all requests to Leader.
+- The Leader is selected by "Port Competition". Every process try to listen on a certain port (for example 7777), but ONLY one can occupy the port, then it becomes the Leader, the others become Followers.
+- TCP socket connections are maintained between Leader and Followers. And I design a simple communication protocol to exchange data between them.
+- If old Leader dies, one of processes will be selected as the new Leader.
+
+## Diagram
+
+normal (without using cluster client)
+
+```js
++--------+   +--------+
+| Client |   | Client |   ...
++--------+   +--------+
+    |  \     /   |
+    |    \ /     |
+    |    / \     |
+    |  /     \   |
++--------+   +--------+
+| Server |   | Server |   ...
++--------+   +--------+
+
+```
+
+using cluster-client
+
+```js
+             +-------+
+             | start |
+             +---+---+
+                 |
+        +--------+---------+
+      __| port competition |__
+win /   +------------------+  \ lose
+   /                           \
++--------+     tcp conn     +----------+
+| Leader |<---------------->| Follower |
++--------+                  +----------+
+    |
++--------+
+| Client |
++--------+
+    |  \
+    |    \
+    |      \
+    |        \
++--------+   +--------+
+| Server |   | Server |   ...
++--------+   +--------+
+
+```
+
+## Protocol
+
+- Packet structure
+
+```js
+ 0       1       2               4                                                              12
+ +-------+-------+---------------+---------------------------------------------------------------+
+ |version|req/res|    reserved   |                          request id                           |
+ +-------------------------------+-------------------------------+-------------------------------+
+ |           timeout             |   connection object length    |   application object length   |
+ +-------------------------------+---------------------------------------------------------------+
+ |         conn object (JSON format)  ...                    |            app object             |
+ +-----------------------------------------------------------+                                   |
+ |                                          ...                                                  |
+ +-----------------------------------------------------------------------------------------------+
+```
+
+- Protocol Type
+  - Register Channel
+  - Subscribe/Publish
+  - Invoke
+- Sequence diagram
+
+```js
+ +----------+             +---------------+          +---------+
+ | Follower |             |  local server |          |  Leader |
+ +----------+             +---------------+          +---------+
+      |     register channel     |       assign to        |
+      + -----------------------> |  --------------------> |
+      |                          |                        |
+      |                                subscribe          |
+      + ------------------------------------------------> |
+      |       subscribe result                            |
+      | <------------------------------------------------ +
+      |                                                   |
+      |                                 invoke            |
+      + ------------------------------------------------> |
+      |          invoke result                            |
+      | <------------------------------------------------ +
+      |                                                   |
+```
+
+## Install
+
+```bash
+npm install cluster-client --save
+```
+
+Node.js >= 6.0.0 required
+
+## Usage
+
+```js
+'use strict';
+
+const co = require('co');
+const Base = require('sdk-base');
+const cluster = require('cluster-client');
+
+/**
+ * Client Example
+ */
+class YourClient extends Base {
+  constructor(options) {
+    super(options);
+
+    this.options = options;
+    this.ready(true);
+  }
+
+  subscribe(reg, listener) {
+    // subscribe logic
+  }
+
+  publish(reg) {
+    // publish logic
+  }
+
+  * getData(id) {
+    // invoke api
+  }
+
+  getDataCallback(id, cb) {
+    // ...
+  }
+
+  getDataPromise(id) {
+    // ...
+  }
+}
+
+// create some client instances, but only one instance will connect to server
+const client_1 = cluster(YourClient)
+  .delegate('getData')
+  .delegate('getDataCallback')
+  .delegate('getDataPromise')
+  .create({ foo: 'bar' });
+const client_2 = cluster(YourClient)
+  .delegate('getData')
+  .delegate('getDataCallback')
+  .delegate('getDataPromise')
+  .create({ foo: 'bar' });
+const client_3 = cluster(YourClient)
+  .delegate('getData')
+  .delegate('getDataCallback')
+  .delegate('getDataPromise')
+  .create({ foo: 'bar' });
+
+// subscribe information
+client_1.subscribe('some thing', result => console.log(result));
+client_2.subscribe('some thing', result => console.log(result));
+client_3.subscribe('some thing', result => console.log(result));
+
+// publish data
+client_2.publish('some data');
+
+// invoke method
+client_3.getDataCallback('some thing', (err, val) => console.log(val));
+client_2.getDataPromise('some thing').then(val => console.log(val));
+
+co(function*() {
+  const ret = yield client_1.getData('some thing');
+  console.log(ret);
+}).catch(err => console.error(err));
+```
+
+## API
+
+- `delegate(from, to)`:
+  create delegate method, `from` is the method name your want to create, and `to` have 6 possible values: [ `subscribe`, `unSubscribe`, `publish`, `invoke`, `invokeOneway`, `close` ],  and the default value is invoke
+- `override(name, value)`:
+  override one property
+- `create(…)`
+  create the client instance
+- `close(client)`
+  close the client
+- `APIClientBase`  a base class to help you create your api client
+
+## Best Practice
+
+1. DataClient
+
+- Only provider data API, interact with server and maintain persistent connections etc.
+- No need to concern `cluster` issue
+
+1. APIClient
+
+- Using `cluster-client` to wrap DataClient
+- Put your bussiness logic here
+
+### DataClient
+
+```js
+const Base = require('sdk-base');
+
+class DataClient extends Base {
+  constructor(options) {
+    super(options);
+    this.ready(true);
+  }
+
+  subscribe(info, listener) {
+    // subscribe data from server
+  }
+
+  publish(info) {
+    // publish data to server
+  }
+
+  * getData(id) {
+    // asynchronous API
+  }
+}
+```
+
+### APIClient
+
+```js
+const DataClient = require('./your-data-client');
+const { APIClientBase } = require('cluster-client');
+
+class APIClient extends APIClientBase {
+  constructor(options) {
+    super(options);
+    this._cache = new Map();
+  }
+  get DataClient() {
+    return DataClient;
+  }
+  get delegates() {
+    return {
+      getData: 'invoke',
+    };
+  }
+  get clusterOptions() {
+    return {
+      name: 'MyClient',
+    };
+  }
+  subscribe(...args) {
+    return this._client.subscribe(...args);
+  }
+  publish(...args) {
+    return this._client.publish(...args);
+  }
+  * getData(id) {
+    // write your business logic & use data client API
+    if (this._cache.has(id)) {
+      return this._cache.get(id);
+    }
+    const data = yield this._client.getData(id);
+    this._cache.set(id, data);
+    return datal
+  }
+}
+```
+
+```js
+|------------------------------------------------|
+| APIClient                                      |
+|       |----------------------------------------|
+|       | ClusterClient                          |
+|       |      |---------------------------------|
+|       |      | DataClient                      |
+|-------|------|---------------------------------|
+```
+
+For more information, you can refer to the [discussion](https://github.com/eggjs/egg/issues/322)
+
+[MIT](LICENSE)
+
+<!-- GITCONTRIBUTOR_START -->
+
+## Contributors
+
+|[<img src="https://avatars.githubusercontent.com/u/1207064?v=4" width="100px;"/><br/><sub><b>gxcsoccer</b></sub>](https://github.com/gxcsoccer)<br/>|[<img src="https://avatars.githubusercontent.com/u/156269?v=4" width="100px;"/><br/><sub><b>fengmk2</b></sub>](https://github.com/fengmk2)<br/>|[<img src="https://avatars.githubusercontent.com/u/456108?v=4" width="100px;"/><br/><sub><b>shaoshuai0102</b></sub>](https://github.com/shaoshuai0102)<br/>|[<img src="https://avatars.githubusercontent.com/u/6897780?v=4" width="100px;"/><br/><sub><b>killagu</b></sub>](https://github.com/killagu)<br/>|[<img src="https://avatars.githubusercontent.com/u/32174276?v=4" width="100px;"/><br/><sub><b>semantic-release-bot</b></sub>](https://github.com/semantic-release-bot)<br/>|[<img src="https://avatars.githubusercontent.com/u/227713?v=4" width="100px;"/><br/><sub><b>atian25</b></sub>](https://github.com/atian25)<br/>|
+| :---: | :---: | :---: | :---: | :---: | :---: |
+[<img src="https://avatars.githubusercontent.com/u/546535?v=4" width="100px;"/><br/><sub><b>leoner</b></sub>](https://github.com/leoner)<br/>|[<img src="https://avatars.githubusercontent.com/u/2160731?v=4" width="100px;"/><br/><sub><b>mansonchor</b></sub>](https://github.com/mansonchor)<br/>|[<img src="https://avatars.githubusercontent.com/u/19849579?v=4" width="100px;"/><br/><sub><b>sinkhaha</b></sub>](https://github.com/sinkhaha)<br/>|[<img src="https://avatars.githubusercontent.com/u/6457450?v=4" width="100px;"/><br/><sub><b>limitMe</b></sub>](https://github.com/limitMe)<br/>
+
+This project follows the git-contributor [spec](https://github.com/xudafeng/git-contributor), auto updated at `Tue Jun 20 2023 12:29:14 GMT+0800`.
+
+<!-- GITCONTRIBUTOR_END -->

package/node_modules/cluster-client/index.js

@@ -0,0 +1,66 @@
+'use strict';
+
+const assert = require('assert');
+const is = require('is-type-of');
+const cluster = require('./lib');
+const symbols = require('./lib/symbol');
+const APIClientBase = require('./lib/api_client');
+
+/**
+ * Create an Wrapper
+ *
+ * @param {Function} clientClass - client class
+ * @param {Object} options - wrapper options
+ * @return {ClientWrapper} wrapper
+ */
+module.exports = cluster;
+
+/**
+ * Close a ClusterClient
+ *
+ * @param {Object} client - ClusterClient instance to be closed
+ * @return {Promise} returns a promise which will be resolved after fully closed
+ */
+module.exports.close = client => {
+  assert(is.function(client[symbols.close]), '[cluster#close] client should be instanceof ClusterClient');
+  return client[symbols.close]();
+};
+
+/**
+ * API Client SuperClass
+ *
+ * @example
+ * ---------------------------------------------
+ * class ClusterClient extends APIClientBase {
+ *   get DataClient() {
+ *     return require('./supports/client');
+ *   }
+ *   get delegates() {
+ *     return {
+ *       unPublish: 'invokeOneway',
+ *     };
+ *   }
+ *   get clusterOptions() {
+ *     return {
+ *       responseTimeout: 1000,
+ *       port,
+ *     };
+ *   }
+ *   subscribe(...args) {
+ *     return this._client.subscribe(...args);
+ *   }
+ *   unSubscribe(...args) {
+ *     return this._client.unSubscribe(...args);
+ *   }
+ *   publish(...args) {
+ *     return this._client.publish(...args);
+ *   }
+ *   unPublish(...args) {
+ *     return this._client.unPublish(...args);
+ *   }
+ *   close() {
+ *     return this._client.close();
+ *   }
+ * }
+ */
+module.exports.APIClientBase = APIClientBase;