[ini]
Christian Fraß

Christian Fraß commited on 2021-11-18 23:53:54
Zeige 94 geänderte Dateien mit 20408 Einfügungen und 0 Löschungen.

... ...
@@ -0,0 +1,2 @@
1
+temp/
2
+build/
... ...
@@ -0,0 +1,36 @@
1
+{
2
+  "name": "node",
3
+  "lockfileVersion": 2,
4
+  "requires": true,
5
+  "packages": {
6
+    "node_modules/irc": {
7
+      "version": "0.5.2",
8
+      "resolved": "https://registry.npmjs.org/irc/-/irc-0.5.2.tgz",
9
+      "integrity": "sha1-NxT0doNlqW0LL3dryRFmvrJGS7w=",
10
+      "dependencies": {
11
+        "irc-colors": "^1.1.0"
12
+      },
13
+      "engines": {
14
+        "node": ">=0.10.0"
15
+      },
16
+      "optionalDependencies": {
17
+        "iconv": "~2.2.1",
18
+        "node-icu-charset-detector": "~0.2.0"
19
+      }
20
+    },
21
+    "node_modules/irc-colors": {
22
+      "version": "1.5.0",
23
+      "resolved": "https://registry.npmjs.org/irc-colors/-/irc-colors-1.5.0.tgz",
24
+      "integrity": "sha512-HtszKchBQTcqw1DC09uD7i7vvMayHGM1OCo6AHt5pkgZEyo99ClhHTMJdf+Ezc9ovuNNxcH89QfyclGthjZJOw==",
25
+      "engines": {
26
+        "node": ">=6"
27
+      }
28
+    },
29
+    "node_modules/nan": {
30
+      "version": "2.15.0",
31
+      "resolved": "https://registry.npmjs.org/nan/-/nan-2.15.0.tgz",
32
+      "integrity": "sha512-8ZtvEnA2c5aYCZYd1cvgdnU6cqwixRoYg70xPLWUws5ORTa/lnw+u4amixRS/Ac5U5mQVgp9pnlSUnbNWFaWZQ==",
33
+      "optional": true
34
+    }
35
+  }
36
+}
... ...
@@ -0,0 +1,21 @@
1
+MIT License
2
+
3
+Copyright (C) 2011 by fent
4
+
5
+Permission is hereby granted, free of charge, to any person obtaining a copy
6
+of this software and associated documentation files (the "Software"), to deal
7
+in the Software without restriction, including without limitation the rights
8
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+copies of the Software, and to permit persons to whom the Software is
10
+furnished to do so, subject to the following conditions:
11
+
12
+The above copyright notice and this permission notice shall be included in
13
+all copies or substantial portions of the Software.
14
+
15
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+THE SOFTWARE. 
... ...
@@ -0,0 +1,85 @@
1
+# irc.colors.js
2
+
3
+Easily use colored output and formatting in your irc bots.
4
+
5
+[![Build Status](https://secure.travis-ci.org/fent/irc-colors.js.svg)](http://travis-ci.org/fent/irc-colors.js)
6
+[![Dependency Status](https://david-dm.org/fent/irc-colors.js.svg)](https://david-dm.org/fent/irc-colors.js)
7
+[![codecov](https://codecov.io/gh/fent/irc-colors.js/branch/master/graph/badge.svg)](https://codecov.io/gh/fent/irc-colors.js)
8
+
9
+
10
+
11
+# Usage
12
+
13
+```javascript
14
+const c = require('irc-colors');
15
+...
16
+ircbot.say('#chan', c.blue('hello everyone')); // prints blue text
17
+ircbot.say('#chan', c.underline.red('WARNING')); // can be chained
18
+ircbot.say('#chan', c.white.bgblack('inverted')); // white text with black background
19
+
20
+warn = c.bold.red.bgyellow;
21
+ircbot.say('#chan', warn('BIGGER WARNING')); // bold red text with yellow background
22
+ircbot.say('#chan', c.rainbow('having fun!'); // prints rainbow colored text
23
+```
24
+
25
+### But wait, there's more!
26
+
27
+If you don't mind changing the prototype of the String object, then use the global() function.
28
+
29
+```javascript
30
+require('irc-colors').global()
31
+...
32
+ircbot.say('#chan', 'say something'.irc.red()); // prints red text
33
+ircbot.say('#chan', 'hi everyone!'.irc.green.bold()); // prints green bold text
34
+ircbot.say('#chan', 'etc etc'.irc.underline.grey.bgblack()) // chains work too
35
+```
36
+
37
+Global syntax was inspired by [colors.js](https://github.com/marak/colors.js) and because of that, there's possibility that you might want to use that module along with this one. That's why the *irc* property of a String needs to be called first to use the formatting functions.
38
+
39
+
40
+## Colors
41
+
42
+![colors](img/colors.png)
43
+
44
+Original name or alternate can be used, without spaces
45
+
46
+    bot.say('#chat', c.bluecyan('hi'));
47
+
48
+
49
+## Styles
50
+
51
+![styles](img/styles.png)
52
+
53
+
54
+## Extras
55
+
56
+![extras](img/extras.png)
57
+
58
+## Strip
59
+
60
+You can also strip out any colors/style from IRC messages.
61
+
62
+* `stripColors`
63
+* `stripStyle`
64
+* `stripColorsAndStyle`
65
+
66
+```js
67
+const c = require('irc-colors');
68
+
69
+ircbot.on('message', (from, message) => {
70
+  console.log(c.stripColorsAndStyle(message));
71
+});
72
+```
73
+
74
+
75
+# Install
76
+
77
+    npm install irc-colors
78
+
79
+
80
+# Tests
81
+Tests are written with [vows](http://vowsjs.org/)
82
+
83
+```bash
84
+npm test
85
+```
... ...
@@ -0,0 +1,187 @@
1
+const colors = {
2
+  '00': ['white'],
3
+  '01': ['black'],
4
+  '02': ['navy'],
5
+  '03': ['green'],
6
+  '04': ['red'],
7
+  '05': ['brown', 'maroon'],
8
+  '06': ['purple', 'violet'],
9
+  '07': ['olive'],
10
+  '08': ['yellow'],
11
+  '09': ['lightgreen', 'lime'],
12
+  '10': ['teal', 'bluecyan'],
13
+  '11': ['cyan', 'aqua'],
14
+  '12': ['blue', 'royal'],
15
+  '13': ['pink', 'lightpurple', 'fuchsia'],
16
+  '14': ['gray', 'grey'],
17
+  '15': ['lightgray', 'lightgrey', 'silver']
18
+};
19
+
20
+const styles = {
21
+  normal        : '\x0F',
22
+  underline     : '\x1F',
23
+  bold          : '\x02',
24
+  italic        : '\x1D',
25
+  inverse       : '\x16',
26
+  strikethrough : '\x1E',
27
+  monospace     : '\x11',
28
+};
29
+
30
+const styleChars = {};
31
+Object.keys(styles).forEach((key) => {
32
+  styleChars[styles[key]] = true;
33
+});
34
+
35
+
36
+// Coloring character.
37
+const c = '\x03';
38
+const zero = styles.bold + styles.bold;
39
+const badStr = /^,\d/;
40
+const colorCodeStr = new RegExp(`^${c}\\d\\d`);
41
+
42
+const allColors = {
43
+  fg: [], bg: [], styles: Object.keys(styles), custom: [], extras: [],
44
+};
45
+
46
+// Make color functions for both foreground and background.
47
+Object.keys(colors).forEach((code) => {
48
+  // Foreground.
49
+  // If the string begins with /,\d/,
50
+  // it can undersirably apply a background color.
51
+  let fg = str => c + code + (badStr.test(str) ? zero : '') + str + c;
52
+
53
+  // Background.
54
+  let bg = (str) => {
55
+    // If the string begins with a foreground color already applied,
56
+    // use it to save string space.
57
+    if (colorCodeStr.test(str)) {
58
+      let str2 = str.substr(3);
59
+      return str.substr(0, 3) + ',' + code +
60
+        (str2.indexOf(zero) === 0 ? str2.substr(zero.length) : str2);
61
+    } else {
62
+      return c + '01,' + code + str + c;
63
+    }
64
+  };
65
+
66
+  colors[code].forEach((color) => {
67
+    allColors.fg.push(color);
68
+    allColors.bg.push('bg' + color);
69
+    exports[color] = fg;
70
+    exports['bg' + color] = bg;
71
+  });
72
+});
73
+
74
+// Style functions.
75
+Object.keys(styles).forEach((style) => {
76
+  let code = styles[style];
77
+  exports[style] = str => code + str + code;
78
+});
79
+
80
+// Some custom helpers.
81
+const custom = {
82
+  rainbow: (str, colorArr) => {
83
+    let rainbow = [
84
+      'red', 'olive', 'yellow', 'green', 'blue', 'navy', 'violet'
85
+    ];
86
+    colorArr = colorArr || rainbow;
87
+    let l = colorArr.length;
88
+    let i = 0;
89
+
90
+    return str
91
+      .split('')
92
+      .map(c => c !== ' ' ? exports[colorArr[i++ % l]](c) : c)
93
+      .join('');
94
+  },
95
+};
96
+
97
+Object.keys(custom).forEach((extra) => {
98
+  allColors.custom.push(extra);
99
+  exports[extra] = custom[extra];
100
+});
101
+
102
+// Extras.
103
+const extras = {
104
+  stripColors: str => str.replace(/\x03\d{0,2}(,\d{0,2}|\x02\x02)?/g, ''),
105
+
106
+  stripStyle: (str) => {
107
+    let path = [];
108
+    for (let i = 0, len = str.length; i < len; i++) {
109
+      let char = str[i];
110
+      if (styleChars[char] || char === c) {
111
+        let lastChar = path[path.length - 1];
112
+        if (lastChar && lastChar[0] === char) {
113
+          let p0 = lastChar[1];
114
+          // Don't strip out styles with no characters inbetween.
115
+          // And don't strip out color codes.
116
+          if (i - p0 > 1 && char !== c) {
117
+            str = str.slice(0, p0) + str.slice(p0 + 1, i) + str.slice(i + 1);
118
+            i -= 2;
119
+          }
120
+          path.pop();
121
+        } else {
122
+          path.push([str[i], i]);
123
+        }
124
+      }
125
+
126
+    }
127
+
128
+    // Remove any unmatching style characterss.
129
+    // Traverse list backwards to make removing less complicated.
130
+    for (let char of path.reverse()) {
131
+      if (char[0] !== c) {
132
+        let pos = char[1];
133
+        str = str.slice(0, pos) + str.slice(pos + 1);
134
+      }
135
+    }
136
+    return str;
137
+  },
138
+
139
+  stripColorsAndStyle: str => exports.stripColors(exports.stripStyle(str)),
140
+};
141
+
142
+Object.keys(extras).forEach((extra) => {
143
+  allColors.extras.push(extra);
144
+  exports[extra] = extras[extra];
145
+});
146
+
147
+// Adds all functions to each other so they can be chained.
148
+const addGetters = (fn, types) => {
149
+  Object.keys(allColors).forEach((type) => {
150
+    if (types.indexOf(type) > -1) { return; }
151
+    allColors[type].forEach((color) => {
152
+      if (fn[color] != null) { return; }
153
+      Object.defineProperty(fn, color, {
154
+        get: () => {
155
+          let f = str => exports[color](fn(str));
156
+          addGetters(f, [].concat(types, type));
157
+          return f;
158
+        },
159
+      });
160
+    });
161
+  });
162
+};
163
+
164
+Object.keys(allColors).forEach((type) => {
165
+  allColors[type].forEach((color) => {
166
+    addGetters(exports[color], [type]);
167
+  });
168
+});
169
+
170
+
171
+// Adds functions to global String object.
172
+exports.global = () => {
173
+  let str, irc = {};
174
+
175
+  String.prototype.__defineGetter__('irc', function() {
176
+    str = this;
177
+    return irc;
178
+  });
179
+
180
+  for (let type in allColors) {
181
+    allColors[type].forEach((color) => {
182
+      let fn = () => exports[color](str);
183
+      addGetters(fn, [type]);
184
+      irc[color] = fn;
185
+    });
186
+  }
187
+};
... ...
@@ -0,0 +1,33 @@
1
+{
2
+  "name": "irc-colors",
3
+  "description": "Color and formatting for irc made easy.",
4
+  "keywords": [
5
+    "irc",
6
+    "color",
7
+    "colour"
8
+  ],
9
+  "version": "1.5.0",
10
+  "repository": {
11
+    "type": "git",
12
+    "url": "git://github.com/fent/irc-colors.js.git"
13
+  },
14
+  "author": "fent (https://github.com/fent)",
15
+  "main": "./lib/irc-colors.js",
16
+  "files": [
17
+    "lib"
18
+  ],
19
+  "scripts": {
20
+    "test": "istanbul cover vows -- --spec test/*-test.js"
21
+  },
22
+  "directories": {
23
+    "lib": "./lib"
24
+  },
25
+  "devDependencies": {
26
+    "istanbul": "^0.4.5",
27
+    "vows": "^0.8.1"
28
+  },
29
+  "engines": {
30
+    "node": ">=6"
31
+  },
32
+  "license": "MIT"
33
+}
... ...
@@ -0,0 +1,7 @@
1
+{
2
+  "validateIndentation": 4,
3
+  "disallowMultipleVarDecl": null,
4
+  "requireMultipleVarDecl": null,
5
+  "requireCamelCaseOrUpperCaseIdentifiers": "ignoreProperties",
6
+  "safeContextKeyword": "self"
7
+}
... ...
@@ -0,0 +1,4 @@
1
+*.log
2
+node_modules/
3
+_build/
4
+.idea/
... ...
@@ -0,0 +1,16 @@
1
+language: node_js
2
+node_js:
3
+  - "0.10"
4
+  - "0.12"
5
+  - "4"
6
+  - "5"
7
+  - "6"
8
+  - "7"
9
+before_install:
10
+  - sudo apt-get -y install libicu-dev
11
+  - npm install -g npm
12
+script:
13
+  - "npm run-script lint"
14
+  - "npm test"
15
+notifications:
16
+  irc: "chat.freenode.net##node-irc"
... ...
@@ -0,0 +1,473 @@
1
+# Change Log
2
+
3
+## [v0.5.2](https://github.com/martynsmith/node-irc/tree/v0.5.2) (2016-11-25)
4
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.5.1...v0.5.2)
5
+
6
+**Merged pull requests:**
7
+
8
+- Update iconv to 2.2.1 and node-icu-charset-detector to 0.2.0 to fix node 6+ support [\#487](https://github.com/martynsmith/node-irc/pull/487) ([paladox](https://github.com/paladox))
9
+
10
+## [v0.5.1](https://github.com/martynsmith/node-irc/tree/v0.5.1) (2016-11-17)
11
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.5.0...v0.5.1)
12
+
13
+**Implemented enhancements:**
14
+
15
+- Detect ping timeout [\#76](https://github.com/martynsmith/node-irc/issues/76)
16
+
17
+**Fixed bugs:**
18
+
19
+- Call stack size exceeded [\#337](https://github.com/martynsmith/node-irc/issues/337)
20
+- Many servers do not send a meaningful hostname in 001 [\#288](https://github.com/martynsmith/node-irc/issues/288)
21
+- disconnect does not appear to send the reason to the server [\#89](https://github.com/martynsmith/node-irc/issues/89)
22
+
23
+**Closed issues:**
24
+
25
+- Creating a whitelist against the nickname  [\#484](https://github.com/martynsmith/node-irc/issues/484)
26
+- Deployed on Heroku, app is running, no IRC connection [\#481](https://github.com/martynsmith/node-irc/issues/481)
27
+- Install does not work on Debian stable. [\#475](https://github.com/martynsmith/node-irc/issues/475)
28
+- Non private reply with highlighted nick [\#474](https://github.com/martynsmith/node-irc/issues/474)
29
+- retryDelay not mentioned in the docs [\#446](https://github.com/martynsmith/node-irc/issues/446)
30
+- 'names' event returns only 10 nicks [\#414](https://github.com/martynsmith/node-irc/issues/414)
31
+- can't get chat messages [\#384](https://github.com/martynsmith/node-irc/issues/384)
32
+- parse message TypeError: Cannot read property '1' of null [\#331](https://github.com/martynsmith/node-irc/issues/331)
33
+- TypeError: No method channel [\#254](https://github.com/martynsmith/node-irc/issues/254)
34
+- Unable to connect to OFTC network over SSL [\#247](https://github.com/martynsmith/node-irc/issues/247)
35
+- Specific mode sequences can crash the bot [\#233](https://github.com/martynsmith/node-irc/issues/233)
36
+- Event listener ctcp-privmsg's "message" is empty [\#207](https://github.com/martynsmith/node-irc/issues/207)
37
+- Mass channel MODE with -lk throws error [\#177](https://github.com/martynsmith/node-irc/issues/177)
38
+
39
+**Merged pull requests:**
40
+
41
+- Respect opt.messageSplit when calculating message length [\#385](https://github.com/martynsmith/node-irc/pull/385) ([LinuxMercedes](https://github.com/LinuxMercedes))
42
+
43
+## [v0.5.0](https://github.com/martynsmith/node-irc/tree/v0.5.0) (2016-03-26)
44
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.4.1...v0.5.0)
45
+
46
+**Implemented enhancements:**
47
+
48
+- Allow tilde in nicks [\#438](https://github.com/martynsmith/node-irc/pull/438) ([hexjelly](https://github.com/hexjelly))
49
+
50
+**Fixed bugs:**
51
+
52
+- Fixes \#427 [\#429](https://github.com/martynsmith/node-irc/pull/429) ([ghost](https://github.com/ghost))
53
+
54
+**Closed issues:**
55
+
56
+- How to get current server. [\#453](https://github.com/martynsmith/node-irc/issues/453)
57
+- Library never connects to server  [\#451](https://github.com/martynsmith/node-irc/issues/451)
58
+- Ping timeout causes double reconnect [\#449](https://github.com/martynsmith/node-irc/issues/449)
59
+- Changelog for v4.0? [\#435](https://github.com/martynsmith/node-irc/issues/435)
60
+- How to multiple server connections at the same time [\#434](https://github.com/martynsmith/node-irc/issues/434)
61
+- Add connected flag [\#430](https://github.com/martynsmith/node-irc/issues/430)
62
+- Add link to docs on github wiki page [\#422](https://github.com/martynsmith/node-irc/issues/422)
63
+- maxLineLength is not set by default and can crash the bot [\#419](https://github.com/martynsmith/node-irc/issues/419)
64
+- PING/PONG Error! [\#415](https://github.com/martynsmith/node-irc/issues/415)
65
+- quit event provides wrong channel information [\#398](https://github.com/martynsmith/node-irc/issues/398)
66
+- Detect client timeout ? [\#375](https://github.com/martynsmith/node-irc/issues/375)
67
+- User MODE changes are not being received in +MODE/-MODE handlers [\#374](https://github.com/martynsmith/node-irc/issues/374)
68
+- Error client.say\(nick, "record\\w3xp\\random\\wins"\); [\#369](https://github.com/martynsmith/node-irc/issues/369)
69
+- SASL over SSL never happens [\#250](https://github.com/martynsmith/node-irc/issues/250)
70
+- Message Events Ignored [\#242](https://github.com/martynsmith/node-irc/issues/242)
71
+- Bot crashes on mode +q-o [\#221](https://github.com/martynsmith/node-irc/issues/221)
72
+- Cannot pass MODE command with multiple arguments [\#147](https://github.com/martynsmith/node-irc/issues/147)
73
+- Certain MODE messages could access on undefined [\#144](https://github.com/martynsmith/node-irc/issues/144)
74
+- mode emit event [\#136](https://github.com/martynsmith/node-irc/issues/136)
75
+- QUIT, KILL removes users from user list before processing event hooks [\#73](https://github.com/martynsmith/node-irc/issues/73)
76
+
77
+**Merged pull requests:**
78
+
79
+- fix\(ping timeouts\): When a ping timeout is detected properly destroy … [\#452](https://github.com/martynsmith/node-irc/pull/452) ([jirwin](https://github.com/jirwin))
80
+- Added link to install instructions for ICU [\#450](https://github.com/martynsmith/node-irc/pull/450) ([spalger](https://github.com/spalger))
81
+- User status isn't updated on MODE if he's not VOICE or OP [\#448](https://github.com/martynsmith/node-irc/pull/448) ([Zoddo](https://github.com/Zoddo))
82
+- Add a Gitter chat badge to README.md [\#444](https://github.com/martynsmith/node-irc/pull/444) ([gitter-badger](https://github.com/gitter-badger))
83
+- Detect and recover from ping timeouts [\#418](https://github.com/martynsmith/node-irc/pull/418) ([philip-peterson](https://github.com/philip-peterson))
84
+- Adding support for command rpl\_whoreply \(352\) [\#413](https://github.com/martynsmith/node-irc/pull/413) ([lan17](https://github.com/lan17))
85
+- Update .gitignore [\#373](https://github.com/martynsmith/node-irc/pull/373) ([Phalanxia](https://github.com/Phalanxia))
86
+- Update license attribute [\#372](https://github.com/martynsmith/node-irc/pull/372) ([pdehaan](https://github.com/pdehaan))
87
+
88
+## [v0.4.1](https://github.com/martynsmith/node-irc/tree/v0.4.1) (2016-01-27)
89
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.4.0...v0.4.1)
90
+
91
+**Implemented enhancements:**
92
+
93
+- Dealing with OPER command replies. [\#439](https://github.com/martynsmith/node-irc/pull/439) ([ellisgl](https://github.com/ellisgl))
94
+
95
+**Fixed bugs:**
96
+
97
+- Fix SASL auth [\#443](https://github.com/martynsmith/node-irc/pull/443) ([ggreer](https://github.com/ggreer))
98
+
99
+**Closed issues:**
100
+
101
+- Can't use it sadly [\#433](https://github.com/martynsmith/node-irc/issues/433)
102
+- how do I auto reconnect if the server goes down? [\#431](https://github.com/martynsmith/node-irc/issues/431)
103
+- WebIRC Support [\#427](https://github.com/martynsmith/node-irc/issues/427)
104
+- Error Handling Improvements \(all errors should gracefully fail\)   [\#421](https://github.com/martynsmith/node-irc/issues/421)
105
+- client.send\(\) always include : in first text [\#420](https://github.com/martynsmith/node-irc/issues/420)
106
+- node-irc with express/socket.io [\#417](https://github.com/martynsmith/node-irc/issues/417)
107
+- Not enough parameters' [\#416](https://github.com/martynsmith/node-irc/issues/416)
108
+- Help with error [\#393](https://github.com/martynsmith/node-irc/issues/393)
109
+-  Microsoft Visual Studio needed to install this in windoze [\#390](https://github.com/martynsmith/node-irc/issues/390)
110
+- oper command [\#234](https://github.com/martynsmith/node-irc/issues/234)
111
+
112
+**Merged pull requests:**
113
+
114
+- Remove \#blah from the example [\#440](https://github.com/martynsmith/node-irc/pull/440) ([ben-rabid](https://github.com/ben-rabid))
115
+- Move dependency 'ansi-color' to devDependencies [\#407](https://github.com/martynsmith/node-irc/pull/407) ([ho-ho-ho](https://github.com/ho-ho-ho))
116
+
117
+## [v0.4.0](https://github.com/martynsmith/node-irc/tree/v0.4.0) (2015-09-30)
118
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.12...v0.4.0)
119
+
120
+**Fixed bugs:**
121
+
122
+- Fix compile warnings on node v4 [\#409](https://github.com/martynsmith/node-irc/pull/409) ([feross](https://github.com/feross))
123
+
124
+**Closed issues:**
125
+
126
+- Error: Cannot enqueue Handshake after already enqueuing a Handshake. [\#404](https://github.com/martynsmith/node-irc/issues/404)
127
+- How to get current Config? [\#401](https://github.com/martynsmith/node-irc/issues/401)
128
+- Error Installing [\#400](https://github.com/martynsmith/node-irc/issues/400)
129
+- maxLineLength undefined when splitting long lines [\#395](https://github.com/martynsmith/node-irc/issues/395)
130
+- Package 'ansi-color' not found [\#389](https://github.com/martynsmith/node-irc/issues/389)
131
+- speak function bug, can't compile [\#388](https://github.com/martynsmith/node-irc/issues/388)
132
+- Error undefined nick [\#371](https://github.com/martynsmith/node-irc/issues/371)
133
+- Send CustomCommand to server [\#367](https://github.com/martynsmith/node-irc/issues/367)
134
+- The framework constantly crashes - "Cannot call method 'replace' of undefined" [\#364](https://github.com/martynsmith/node-irc/issues/364)
135
+- Trying to make a bot and can't figure out how to kick and do other op tasks [\#363](https://github.com/martynsmith/node-irc/issues/363)
136
+- Update Client.chans on change MODE [\#361](https://github.com/martynsmith/node-irc/issues/361)
137
+- Can node-irc determine who is a mod? [\#340](https://github.com/martynsmith/node-irc/issues/340)
138
+- Config with Password? [\#336](https://github.com/martynsmith/node-irc/issues/336)
139
+- Update node-icu-charset-detector version for nodejs 0.12 compatibility [\#332](https://github.com/martynsmith/node-irc/issues/332)
140
+- \[Question\] Timestamps or how much time a user has been connected? [\#321](https://github.com/martynsmith/node-irc/issues/321)
141
+
142
+**Merged pull requests:**
143
+
144
+- Bug fix: 'pm' event wouldnt always be trigged [\#397](https://github.com/martynsmith/node-irc/pull/397) ([ravenstar](https://github.com/ravenstar))
145
+- Call updateMaxLineLength on connection [\#396](https://github.com/martynsmith/node-irc/pull/396) ([secretrobotron](https://github.com/secretrobotron))
146
+- Fix typo. [\#383](https://github.com/martynsmith/node-irc/pull/383) ([schmich](https://github.com/schmich))
147
+- SyntaxError: Octal literals are not allowed in strict mode. [\#368](https://github.com/martynsmith/node-irc/pull/368) ([tom--](https://github.com/tom--))
148
+- Fix channel user modes on Twitch IRC \(closes \#364\) [\#366](https://github.com/martynsmith/node-irc/pull/366) ([sim642](https://github.com/sim642))
149
+
150
+## [v0.3.12](https://github.com/martynsmith/node-irc/tree/v0.3.12) (2015-04-25)
151
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.11...v0.3.12)
152
+
153
+**Closed issues:**
154
+
155
+- Document 'selfMessage' from \#17 [\#349](https://github.com/martynsmith/node-irc/issues/349)
156
+- Random crash after rpl\_luserunknown [\#342](https://github.com/martynsmith/node-irc/issues/342)
157
+
158
+**Merged pull requests:**
159
+
160
+- Cosmetics: fix minor spelling mistakes \[ci skip\] [\#356](https://github.com/martynsmith/node-irc/pull/356) ([vBm](https://github.com/vBm))
161
+- Travis: Sort supported node versions [\#355](https://github.com/martynsmith/node-irc/pull/355) ([vBm](https://github.com/vBm))
162
+- Readme: Add badges for npm version, dependency status and license [\#354](https://github.com/martynsmith/node-irc/pull/354) ([vBm](https://github.com/vBm))
163
+- Fix for unrealircd auditorium [\#352](https://github.com/martynsmith/node-irc/pull/352) ([PNWebster](https://github.com/PNWebster))
164
+- Add information about action events in the docs [\#350](https://github.com/martynsmith/node-irc/pull/350) ([ekmartin](https://github.com/ekmartin))
165
+- Fix charset conversion for invalid charsets  [\#347](https://github.com/martynsmith/node-irc/pull/347) ([aivot-on](https://github.com/aivot-on))
166
+- fix\(travis\): Add node 0.12 and iojs to travis. [\#333](https://github.com/martynsmith/node-irc/pull/333) ([jirwin](https://github.com/jirwin))
167
+
168
+## [v0.3.11](https://github.com/martynsmith/node-irc/tree/v0.3.11) (2015-04-06)
169
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.10...v0.3.11)
170
+
171
+## [v0.3.10](https://github.com/martynsmith/node-irc/tree/v0.3.10) (2015-04-02)
172
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.9...v0.3.10)
173
+
174
+**Closed issues:**
175
+
176
+- Error with node-icu-charset-detector [\#327](https://github.com/martynsmith/node-irc/issues/327)
177
+- Cannot call method 'match' of undefined [\#326](https://github.com/martynsmith/node-irc/issues/326)
178
+- TypeError: Cannot read property '1' of null [\#325](https://github.com/martynsmith/node-irc/issues/325)
179
+- Crashes if channel is undefined on say command [\#314](https://github.com/martynsmith/node-irc/issues/314)
180
+- Issue installing on OS X Mavericks [\#308](https://github.com/martynsmith/node-irc/issues/308)
181
+
182
+**Merged pull requests:**
183
+
184
+- Fixed case sensitivity bug in client.whois\(\) [\#338](https://github.com/martynsmith/node-irc/pull/338) ([itsrachelfish](https://github.com/itsrachelfish))
185
+- fix\(deps\): Upgrade node-icu to 0.1.0 for v0.12 support. [\#334](https://github.com/martynsmith/node-irc/pull/334) ([jirwin](https://github.com/jirwin))
186
+- Update API documentation with missing event and internal variable [\#330](https://github.com/martynsmith/node-irc/pull/330) ([RyanMorrison04](https://github.com/RyanMorrison04))
187
+- Documentation improvements [\#323](https://github.com/martynsmith/node-irc/pull/323) ([TimothyGu](https://github.com/TimothyGu))
188
+- fix blank lines being passed to parse message [\#318](https://github.com/martynsmith/node-irc/pull/318) ([helderroem](https://github.com/helderroem))
189
+- Rember to add path.resolve while requiring things! [\#316](https://github.com/martynsmith/node-irc/pull/316) ([Palid](https://github.com/Palid))
190
+- Fix option handling when passing a secure object [\#311](https://github.com/martynsmith/node-irc/pull/311) ([masochist](https://github.com/masochist))
191
+- Added a bit more information about Client.chans [\#310](https://github.com/martynsmith/node-irc/pull/310) ([itsrachelfish](https://github.com/itsrachelfish))
192
+
193
+## [v0.3.9](https://github.com/martynsmith/node-irc/tree/v0.3.9) (2015-01-16)
194
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.8...v0.3.9)
195
+
196
+**Implemented enhancements:**
197
+
198
+- Factor out test data into a fixtures file. [\#302](https://github.com/martynsmith/node-irc/pull/302) ([masochist](https://github.com/masochist))
199
+
200
+**Fixed bugs:**
201
+
202
+- Fix TLS connections. [\#304](https://github.com/martynsmith/node-irc/pull/304) ([masochist](https://github.com/masochist))
203
+
204
+**Closed issues:**
205
+
206
+- Please add feature for IRCv3 message tags! [\#298](https://github.com/martynsmith/node-irc/issues/298)
207
+- Switch to irc-color [\#297](https://github.com/martynsmith/node-irc/issues/297)
208
+- SSL Broken as of v0.3.8 [\#296](https://github.com/martynsmith/node-irc/issues/296)
209
+- Version 0.3.8 failed while using hubot-irc [\#289](https://github.com/martynsmith/node-irc/issues/289)
210
+- Loading self signed certs [\#262](https://github.com/martynsmith/node-irc/issues/262)
211
+- 0.3.x : 'nicknameinuse' event missing [\#258](https://github.com/martynsmith/node-irc/issues/258)
212
+- Is there an autoConnect callback? [\#239](https://github.com/martynsmith/node-irc/issues/239)
213
+
214
+**Merged pull requests:**
215
+
216
+- Log net connection errors. Thanks Trinitas. [\#307](https://github.com/martynsmith/node-irc/pull/307) ([jirwin](https://github.com/jirwin))
217
+- Bring in irc-colors for stripping colors [\#306](https://github.com/martynsmith/node-irc/pull/306) ([masochist](https://github.com/masochist))
218
+- do not autorejoin on kicks. bad bot! no cookie! [\#303](https://github.com/martynsmith/node-irc/pull/303) ([masochist](https://github.com/masochist))
219
+- fix\(style\): Clean up various style issues in irc.js [\#299](https://github.com/martynsmith/node-irc/pull/299) ([jirwin](https://github.com/jirwin))
220
+- Write a test for setting the hostmask when nick is in use [\#294](https://github.com/martynsmith/node-irc/pull/294) ([masochist](https://github.com/masochist))
221
+- fix\(parseMessage\): Factor parseMessage to another file for decoupling. [\#293](https://github.com/martynsmith/node-irc/pull/293) ([jirwin](https://github.com/jirwin))
222
+- Set self.hostMask to the empty string to elegantly solve \#286 [\#292](https://github.com/martynsmith/node-irc/pull/292) ([masochist](https://github.com/masochist))
223
+- First draft of contributing doc [\#287](https://github.com/martynsmith/node-irc/pull/287) ([masochist](https://github.com/masochist))
224
+- Fix data split delimiter [\#280](https://github.com/martynsmith/node-irc/pull/280) ([ota42y](https://github.com/ota42y))
225
+
226
+## [v0.3.8](https://github.com/martynsmith/node-irc/tree/v0.3.8) (2015-01-09)
227
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.7...v0.3.8)
228
+
229
+**Fixed bugs:**
230
+
231
+- Client.whois on nick not in use crashes bot running with v.0.3.3 [\#267](https://github.com/martynsmith/node-irc/issues/267)
232
+
233
+**Closed issues:**
234
+
235
+- Documentation on RTD gone? [\#264](https://github.com/martynsmith/node-irc/issues/264)
236
+- Allow passworded IRC connections [\#263](https://github.com/martynsmith/node-irc/issues/263)
237
+- Parse RPL\_CREATIONTIME [\#260](https://github.com/martynsmith/node-irc/issues/260)
238
+- News from 0.3.x? [\#259](https://github.com/martynsmith/node-irc/issues/259)
239
+- The master branch is not up to date with npm [\#257](https://github.com/martynsmith/node-irc/issues/257)
240
+- Browserify support? [\#253](https://github.com/martynsmith/node-irc/issues/253)
241
+- self.chan and self.chandata events [\#243](https://github.com/martynsmith/node-irc/issues/243)
242
+
243
+**Merged pull requests:**
244
+
245
+- fix\(webirc\): Set sane defaults for WEBIRC options. [\#283](https://github.com/martynsmith/node-irc/pull/283) ([jirwin](https://github.com/jirwin))
246
+- WIP: fix\(tests\): A first attempt at a sane pattern to begin testing the handling of the protocol. [\#282](https://github.com/martynsmith/node-irc/pull/282) ([jirwin](https://github.com/jirwin))
247
+- fix\(irc.js\): Use the proper EventEmitter class. [\#281](https://github.com/martynsmith/node-irc/pull/281) ([jirwin](https://github.com/jirwin))
248
+- Update colors.js [\#279](https://github.com/martynsmith/node-irc/pull/279) ([bcome](https://github.com/bcome))
249
+- Optional encoding option [\#278](https://github.com/martynsmith/node-irc/pull/278) ([tarlepp](https://github.com/tarlepp))
250
+- WEBIRC support [\#276](https://github.com/martynsmith/node-irc/pull/276) ([Trinitas](https://github.com/Trinitas))
251
+- fix\(style\): Remove folding hints from codes and irc. [\#275](https://github.com/martynsmith/node-irc/pull/275) ([jirwin](https://github.com/jirwin))
252
+- fix\(tests\): Ditch mocha and should for tape! [\#274](https://github.com/martynsmith/node-irc/pull/274) ([jirwin](https://github.com/jirwin))
253
+- Add travis with lint and tests [\#271](https://github.com/martynsmith/node-irc/pull/271) ([jirwin](https://github.com/jirwin))
254
+- Add proper long line wrapping. [\#268](https://github.com/martynsmith/node-irc/pull/268) ([masochist](https://github.com/masochist))
255
+- update README regarding npm and the 0.3.x branch [\#256](https://github.com/martynsmith/node-irc/pull/256) ([mbouchenoire](https://github.com/mbouchenoire))
256
+- Updated API information [\#240](https://github.com/martynsmith/node-irc/pull/240) ([Hydrothermal](https://github.com/Hydrothermal))
257
+- Add option to specify bind address when connecting [\#146](https://github.com/martynsmith/node-irc/pull/146) ([revmischa](https://github.com/revmischa))
258
+
259
+## [v0.3.7](https://github.com/martynsmith/node-irc/tree/v0.3.7) (2014-05-29)
260
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.5...v0.3.7)
261
+
262
+**Closed issues:**
263
+
264
+- Sending nick out of sequence can cause exceptions [\#235](https://github.com/martynsmith/node-irc/issues/235)
265
+- Events need a different approach [\#231](https://github.com/martynsmith/node-irc/issues/231)
266
+- Check if an user is a voice, half-operator, operator,... [\#230](https://github.com/martynsmith/node-irc/issues/230)
267
+- my script throws error "You have not registered" [\#229](https://github.com/martynsmith/node-irc/issues/229)
268
+- Cannot call method 'indexOf' of undefined [\#227](https://github.com/martynsmith/node-irc/issues/227)
269
+- I need SPEED ! [\#223](https://github.com/martynsmith/node-irc/issues/223)
270
+- With stripColors: true set, a post only containing control characters, such as color or bold crashes the library [\#218](https://github.com/martynsmith/node-irc/issues/218)
271
+- Bot Disconnects Every 10 Minutes [\#215](https://github.com/martynsmith/node-irc/issues/215)
272
+- State of project [\#213](https://github.com/martynsmith/node-irc/issues/213)
273
+- add the 'action' event to the documentation [\#212](https://github.com/martynsmith/node-irc/issues/212)
274
+- line ending problem: module does not support UNIX Line Ending [\#208](https://github.com/martynsmith/node-irc/issues/208)
275
+- identify command? [\#205](https://github.com/martynsmith/node-irc/issues/205)
276
+- looking for a maintainer? [\#197](https://github.com/martynsmith/node-irc/issues/197)
277
+- pm only works with mirc clients? [\#196](https://github.com/martynsmith/node-irc/issues/196)
278
+- message time [\#195](https://github.com/martynsmith/node-irc/issues/195)
279
+- Ping Pong idea [\#194](https://github.com/martynsmith/node-irc/issues/194)
280
+- examples not working [\#193](https://github.com/martynsmith/node-irc/issues/193)
281
+- Code reuse and license compliance [\#192](https://github.com/martynsmith/node-irc/issues/192)
282
+- Pull requests building up in backlog [\#189](https://github.com/martynsmith/node-irc/issues/189)
283
+- Bold text [\#185](https://github.com/martynsmith/node-irc/issues/185)
284
+- Support for server-time extension [\#184](https://github.com/martynsmith/node-irc/issues/184)
285
+- client.removeListener [\#180](https://github.com/martynsmith/node-irc/issues/180)
286
+- Adding callback to say\(\) method of Node IRC client [\#179](https://github.com/martynsmith/node-irc/issues/179)
287
+- Getting "Assertion failed" error with secure:true flag [\#178](https://github.com/martynsmith/node-irc/issues/178)
288
+- PRIVMSG that starts with : causes crash [\#173](https://github.com/martynsmith/node-irc/issues/173)
289
+- MODE change resulting in constant crash [\#171](https://github.com/martynsmith/node-irc/issues/171)
290
+- client.addListener\("message\#Channel" bug [\#169](https://github.com/martynsmith/node-irc/issues/169)
291
+- Reconnection fails because of nick modification [\#168](https://github.com/martynsmith/node-irc/issues/168)
292
+- When sending NICK command, the channel returned is lowercase [\#167](https://github.com/martynsmith/node-irc/issues/167)
293
+- Crash when using NAMES command [\#163](https://github.com/martynsmith/node-irc/issues/163)
294
+- Incompatible with Node 0.10.x with `secure` is `true` [\#160](https://github.com/martynsmith/node-irc/issues/160)
295
+- Handling ISO-8859-1 characters [\#157](https://github.com/martynsmith/node-irc/issues/157)
296
+- Cannot login to twitch irc [\#156](https://github.com/martynsmith/node-irc/issues/156)
297
+- Problem with connecting to Inspircd server [\#154](https://github.com/martynsmith/node-irc/issues/154)
298
+- Method for specifying the user's hostname [\#153](https://github.com/martynsmith/node-irc/issues/153)
299
+- Limit output [\#152](https://github.com/martynsmith/node-irc/issues/152)
300
+- Change nick at runtime? [\#149](https://github.com/martynsmith/node-irc/issues/149)
301
+- how to connect with a server password for twitchtv/justintv? [\#148](https://github.com/martynsmith/node-irc/issues/148)
302
+- please delete it [\#141](https://github.com/martynsmith/node-irc/issues/141)
303
+- Ensure QUIT message is processed correctly when using flood protection [\#138](https://github.com/martynsmith/node-irc/issues/138)
304
+- add connection parameters to include userName and realName [\#135](https://github.com/martynsmith/node-irc/issues/135)
305
+- Add an 'action' event [\#134](https://github.com/martynsmith/node-irc/issues/134)
306
+- chat server connection errors [\#127](https://github.com/martynsmith/node-irc/issues/127)
307
+- CTCP event should provide message object \(similar to message\# event\) [\#126](https://github.com/martynsmith/node-irc/issues/126)
308
+- new npm release? [\#124](https://github.com/martynsmith/node-irc/issues/124)
309
+- MODE messages don't appear to work correctly with JustinTV/TwitchTV chat. [\#123](https://github.com/martynsmith/node-irc/issues/123)
310
+- Colons in user messages cause issues [\#122](https://github.com/martynsmith/node-irc/issues/122)
311
+- rpl\_channelmodeis messages are not parsed correctly [\#120](https://github.com/martynsmith/node-irc/issues/120)
312
+- Issue with Non-ASCII Nick [\#104](https://github.com/martynsmith/node-irc/issues/104)
313
+
314
+**Merged pull requests:**
315
+
316
+- Fixes \#235 type error where channel does not exist [\#236](https://github.com/martynsmith/node-irc/pull/236) ([qq99](https://github.com/qq99))
317
+- support for use\_strict [\#228](https://github.com/martynsmith/node-irc/pull/228) ([tedgoddard](https://github.com/tedgoddard))
318
+- Fixed irc not connecting to selfsigned servers [\#201](https://github.com/martynsmith/node-irc/pull/201) ([antonva](https://github.com/antonva))
319
+- added 'err\_erroneusnickname' message case' [\#191](https://github.com/martynsmith/node-irc/pull/191) ([redshark1802](https://github.com/redshark1802))
320
+- fix\(package.json\): Add ansi-color to the package dependencies. [\#188](https://github.com/martynsmith/node-irc/pull/188) ([jirwin](https://github.com/jirwin))
321
+- fix\(lib/irc\): Use protected loops when iterating channels to remove users [\#187](https://github.com/martynsmith/node-irc/pull/187) ([jirwin](https://github.com/jirwin))
322
+- Fix the color wrap function [\#186](https://github.com/martynsmith/node-irc/pull/186) ([cattode](https://github.com/cattode))
323
+- Hide 'Sending irc NICK/User' debug msg [\#183](https://github.com/martynsmith/node-irc/pull/183) ([porjo](https://github.com/porjo))
324
+- Added bold/underline "colors" [\#170](https://github.com/martynsmith/node-irc/pull/170) ([BenjaminRH](https://github.com/BenjaminRH))
325
+- Fix Cient.join: when user specify a password [\#166](https://github.com/martynsmith/node-irc/pull/166) ([macpie](https://github.com/macpie))
326
+- Fix a crash bug when a zero length message is received [\#165](https://github.com/martynsmith/node-irc/pull/165) ([shiwano](https://github.com/shiwano))
327
+- Change to be a non-existing server/channel [\#162](https://github.com/martynsmith/node-irc/pull/162) ([chilts](https://github.com/chilts))
328
+- Add support for client certificates in connection handling [\#161](https://github.com/martynsmith/node-irc/pull/161) ([squeeks](https://github.com/squeeks))
329
+- fixed a small typo for util.log\(\) on MODE change [\#158](https://github.com/martynsmith/node-irc/pull/158) ([JohnMaguire](https://github.com/JohnMaguire))
330
+- Fix: codes variable is leaked to global scope [\#155](https://github.com/martynsmith/node-irc/pull/155) ([garyc40](https://github.com/garyc40))
331
+- Added user message support for PART [\#140](https://github.com/martynsmith/node-irc/pull/140) ([qsheets](https://github.com/qsheets))
332
+- Fix for receiving messages with colons [\#137](https://github.com/martynsmith/node-irc/pull/137) ([qsheets](https://github.com/qsheets))
333
+- add names for five numerics; fix handling of 002 and 003 [\#131](https://github.com/martynsmith/node-irc/pull/131) ([rwg](https://github.com/rwg))
334
+- provide message object to ctcp events [\#130](https://github.com/martynsmith/node-irc/pull/130) ([damianb](https://github.com/damianb))
335
+- add names\#channel event [\#129](https://github.com/martynsmith/node-irc/pull/129) ([ydnax](https://github.com/ydnax))
336
+- Added SASL support [\#125](https://github.com/martynsmith/node-irc/pull/125) ([gsf](https://github.com/gsf))
337
+
338
+## [v0.3.5](https://github.com/martynsmith/node-irc/tree/v0.3.5) (2013-01-01)
339
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.3...v0.3.5)
340
+
341
+**Closed issues:**
342
+
343
+- How to handle disconnects? [\#117](https://github.com/martynsmith/node-irc/issues/117)
344
+- opping and kicking on freenode.net [\#110](https://github.com/martynsmith/node-irc/issues/110)
345
+- 'LOAD' event issue?  [\#108](https://github.com/martynsmith/node-irc/issues/108)
346
+- TOPIC command doesn't play nicely with send function [\#98](https://github.com/martynsmith/node-irc/issues/98)
347
+- Add support for more channel types [\#97](https://github.com/martynsmith/node-irc/issues/97)
348
+- Passing a large array of channels causes flood kick [\#96](https://github.com/martynsmith/node-irc/issues/96)
349
+- Issuing NICK during session breaks JOIN [\#93](https://github.com/martynsmith/node-irc/issues/93)
350
+- Make Client writable/readable stream? [\#92](https://github.com/martynsmith/node-irc/issues/92)
351
+- whois + host with IPv6 leads to info.host = '0' [\#90](https://github.com/martynsmith/node-irc/issues/90)
352
+- Sending PASS to password protected irc server prepends : [\#87](https://github.com/martynsmith/node-irc/issues/87)
353
+- 'invite' not emitted [\#86](https://github.com/martynsmith/node-irc/issues/86)
354
+- uncaught error on data listener [\#83](https://github.com/martynsmith/node-irc/issues/83)
355
+- Disable stdout for server events without specific listeners [\#78](https://github.com/martynsmith/node-irc/issues/78)
356
+- Handle server connection failures gracefully [\#74](https://github.com/martynsmith/node-irc/issues/74)
357
+- Emit mode change events [\#70](https://github.com/martynsmith/node-irc/issues/70)
358
+- Emit channels for "kill" like for "quit" [\#69](https://github.com/martynsmith/node-irc/issues/69)
359
+- Handle errors when parsing message [\#64](https://github.com/martynsmith/node-irc/issues/64)
360
+- Event on successful pm [\#56](https://github.com/martynsmith/node-irc/issues/56)
361
+- \[Feature request\] Automatic flood protection [\#36](https://github.com/martynsmith/node-irc/issues/36)
362
+- refactor node-irc to emit only one 'event' object [\#18](https://github.com/martynsmith/node-irc/issues/18)
363
+
364
+**Merged pull requests:**
365
+
366
+- Added library support for the RPL\_ISUPPORT server reply [\#114](https://github.com/martynsmith/node-irc/pull/114) ([qsheets](https://github.com/qsheets))
367
+- Fixed the message splitting on Client.say [\#112](https://github.com/martynsmith/node-irc/pull/112) ([Pumpuli](https://github.com/Pumpuli))
368
+- Fixed the message object being modified on MODE command. [\#111](https://github.com/martynsmith/node-irc/pull/111) ([Pumpuli](https://github.com/Pumpuli))
369
+- Add option to split long messages into multiple PRIVMSG calls [\#106](https://github.com/martynsmith/node-irc/pull/106) ([PherricOxide](https://github.com/PherricOxide))
370
+- Restore Fix for: Handle unverifiable self-signed certificates. [\#102](https://github.com/martynsmith/node-irc/pull/102) ([4poc](https://github.com/4poc))
371
+- If needed, update self.nick when NICK is received [\#94](https://github.com/martynsmith/node-irc/pull/94) ([toolness](https://github.com/toolness))
372
+- This fixes the IPv6-Issue \#90 for me. [\#91](https://github.com/martynsmith/node-irc/pull/91) ([ccoenen](https://github.com/ccoenen))
373
+- Make flood protection timeout setting configurable. [\#84](https://github.com/martynsmith/node-irc/pull/84) ([lewinski](https://github.com/lewinski))
374
+- Event emiter for bad connection [\#77](https://github.com/martynsmith/node-irc/pull/77) ([akavlie](https://github.com/akavlie))
375
+- Include channels user was in when 'kill' is emitted [\#72](https://github.com/martynsmith/node-irc/pull/72) ([alexwhitman](https://github.com/alexwhitman))
376
+- Emit +mode and -mode on mode changes [\#71](https://github.com/martynsmith/node-irc/pull/71) ([alexwhitman](https://github.com/alexwhitman))
377
+- Fix problem with 'QUIT' command [\#68](https://github.com/martynsmith/node-irc/pull/68) ([tapichu](https://github.com/tapichu))
378
+- Emit 'message\#' for a channel message [\#67](https://github.com/martynsmith/node-irc/pull/67) ([alexwhitman](https://github.com/alexwhitman))
379
+- Include message object with emits [\#66](https://github.com/martynsmith/node-irc/pull/66) ([alexwhitman](https://github.com/alexwhitman))
380
+- add some simple CTCP support [\#58](https://github.com/martynsmith/node-irc/pull/58) ([thejh](https://github.com/thejh))
381
+- Updating the certExpired option [\#53](https://github.com/martynsmith/node-irc/pull/53) ([jonrohan](https://github.com/jonrohan))
382
+
383
+## [v0.3.3](https://github.com/martynsmith/node-irc/tree/v0.3.3) (2011-11-16)
384
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.2...v0.3.3)
385
+
386
+**Closed issues:**
387
+
388
+- Race condition, mode+- before mode= seems to cause crash [\#65](https://github.com/martynsmith/node-irc/issues/65)
389
+- SSL Failed to connect [\#60](https://github.com/martynsmith/node-irc/issues/60)
390
+- "kill" emits no event [\#59](https://github.com/martynsmith/node-irc/issues/59)
391
+- NAMES command crashes client on InspIRCd-2.0 servers [\#55](https://github.com/martynsmith/node-irc/issues/55)
392
+- Traceback after joining network in 0.3.1 [\#50](https://github.com/martynsmith/node-irc/issues/50)
393
+- Handle erroneous commands gracefully [\#48](https://github.com/martynsmith/node-irc/issues/48)
394
+- Automatic NickServ /IDENTIFYcation? [\#47](https://github.com/martynsmith/node-irc/issues/47)
395
+
396
+**Merged pull requests:**
397
+
398
+- Handle errors in rpl\_namreply. [\#62](https://github.com/martynsmith/node-irc/pull/62) ([schwuk](https://github.com/schwuk))
399
+- Handle unverifiable self-signed certificates. [\#61](https://github.com/martynsmith/node-irc/pull/61) ([schwuk](https://github.com/schwuk))
400
+- Password support [\#51](https://github.com/martynsmith/node-irc/pull/51) ([wraithan](https://github.com/wraithan))
401
+
402
+## [v0.3.2](https://github.com/martynsmith/node-irc/tree/v0.3.2) (2011-10-30)
403
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.1...v0.3.2)
404
+
405
+## [v0.3.1](https://github.com/martynsmith/node-irc/tree/v0.3.1) (2011-10-29)
406
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.3.0...v0.3.1)
407
+
408
+## [v0.3.0](https://github.com/martynsmith/node-irc/tree/v0.3.0) (2011-10-28)
409
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.2.1...v0.3.0)
410
+
411
+**Closed issues:**
412
+
413
+- Add command for listing channels [\#42](https://github.com/martynsmith/node-irc/issues/42)
414
+- Parse /version instead of hardcoded symbols in MODE [\#40](https://github.com/martynsmith/node-irc/issues/40)
415
+- Channel letter-case crashes client [\#39](https://github.com/martynsmith/node-irc/issues/39)
416
+- Cannot read property 'users' of undefined [\#38](https://github.com/martynsmith/node-irc/issues/38)
417
+
418
+**Merged pull requests:**
419
+
420
+- Update package.json [\#45](https://github.com/martynsmith/node-irc/pull/45) ([chilts](https://github.com/chilts))
421
+- Added optional callbacks to connect and disconnect [\#44](https://github.com/martynsmith/node-irc/pull/44) ([fent](https://github.com/fent))
422
+- stripColors option [\#43](https://github.com/martynsmith/node-irc/pull/43) ([Excedrin](https://github.com/Excedrin))
423
+- Fixed missing nick in TOPIC socketio event [\#41](https://github.com/martynsmith/node-irc/pull/41) ([alexmingoia](https://github.com/alexmingoia))
424
+- Document internal functions and variables, activateFloodProtection [\#37](https://github.com/martynsmith/node-irc/pull/37) ([Hello71](https://github.com/Hello71))
425
+- first pass at sphinx docs [\#35](https://github.com/martynsmith/node-irc/pull/35) ([wraithan](https://github.com/wraithan))
426
+- adding colors [\#33](https://github.com/martynsmith/node-irc/pull/33) ([wraithan](https://github.com/wraithan))
427
+- split out irc codes from client code. [\#31](https://github.com/martynsmith/node-irc/pull/31) ([wraithan](https://github.com/wraithan))
428
+
429
+## [v0.2.1](https://github.com/martynsmith/node-irc/tree/v0.2.1) (2011-10-01)
430
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.2.0...v0.2.1)
431
+
432
+**Closed issues:**
433
+
434
+- \[Path [\#22](https://github.com/martynsmith/node-irc/issues/22)
435
+- Should sending messages also emit a 'message' signal? [\#17](https://github.com/martynsmith/node-irc/issues/17)
436
+- provide a way to access the current nick [\#12](https://github.com/martynsmith/node-irc/issues/12)
437
+
438
+**Merged pull requests:**
439
+
440
+- Self signed SSL certificates [\#27](https://github.com/martynsmith/node-irc/pull/27) ([stigi](https://github.com/stigi))
441
+- Adds 'selfMessage' event [\#25](https://github.com/martynsmith/node-irc/pull/25) ([AvianFlu](https://github.com/AvianFlu))
442
+- Added support for flood protection [\#23](https://github.com/martynsmith/node-irc/pull/23) ([epeli](https://github.com/epeli))
443
+- Fixed bug when sending empty strings or several lines to say [\#21](https://github.com/martynsmith/node-irc/pull/21) ([eirikb](https://github.com/eirikb))
444
+- append notice method to Client.prototype. [\#20](https://github.com/martynsmith/node-irc/pull/20) ([futoase](https://github.com/futoase))
445
+- Parsing out ~ & and % in the channel user list [\#15](https://github.com/martynsmith/node-irc/pull/15) ([pusherman](https://github.com/pusherman))
446
+- Reconnect all rooms upon server reconnect.   [\#14](https://github.com/martynsmith/node-irc/pull/14) ([lloyd](https://github.com/lloyd))
447
+- listen for the socket 'close' event rather than 'end'.  'end' is triggere [\#13](https://github.com/martynsmith/node-irc/pull/13) ([lloyd](https://github.com/lloyd))
448
+- Bug fix in join/part/kick events [\#11](https://github.com/martynsmith/node-irc/pull/11) ([luscoma](https://github.com/luscoma))
449
+
450
+## [v0.2.0](https://github.com/martynsmith/node-irc/tree/v0.2.0) (2011-04-29)
451
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.1.2...v0.2.0)
452
+
453
+**Merged pull requests:**
454
+
455
+- Add an event for `/invite` [\#10](https://github.com/martynsmith/node-irc/pull/10) ([jsocol](https://github.com/jsocol))
456
+- Documented the Client.Disconnect method [\#9](https://github.com/martynsmith/node-irc/pull/9) ([mdwrigh2](https://github.com/mdwrigh2))
457
+- Updated ssl support to work with tsl [\#8](https://github.com/martynsmith/node-irc/pull/8) ([indiefan](https://github.com/indiefan))
458
+- QUIT and NICK events [\#7](https://github.com/martynsmith/node-irc/pull/7) ([Mortal](https://github.com/Mortal))
459
+- autoConnect Client option [\#6](https://github.com/martynsmith/node-irc/pull/6) ([Oshuma](https://github.com/Oshuma))
460
+- added a "notice" event [\#5](https://github.com/martynsmith/node-irc/pull/5) ([thejh](https://github.com/thejh))
461
+- Properly handle changing user mode [\#4](https://github.com/martynsmith/node-irc/pull/4) ([justinabrahms](https://github.com/justinabrahms))
462
+- fix unwritable stream error after disconnected [\#3](https://github.com/martynsmith/node-irc/pull/3) ([sublee](https://github.com/sublee))
463
+
464
+## [v0.1.2](https://github.com/martynsmith/node-irc/tree/v0.1.2) (2010-05-19)
465
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.1.1...v0.1.2)
466
+
467
+## [v0.1.1](https://github.com/martynsmith/node-irc/tree/v0.1.1) (2010-05-15)
468
+[Full Changelog](https://github.com/martynsmith/node-irc/compare/v0.1.0...v0.1.1)
469
+
470
+## [v0.1.0](https://github.com/martynsmith/node-irc/tree/v0.1.0) (2010-05-14)
471
+
472
+
473
+\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*
0 474
\ No newline at end of file
... ...
@@ -0,0 +1,47 @@
1
+# Contributing to node-irc
2
+
3
+First, and most importantly, thank you for contributing to node-irc! Your efforts make the library
4
+as awesome as it is, and we really couldn't do it without you. Through your pull requests, issues,
5
+and discussion, together we are building the best IRC library for node. So, once again, *thank you*!
6
+
7
+What follows is a set of guidelines for contributing to node-irc. We ask that you follow them
8
+because they make our lives as maintainers easier, which means that your pull requests and issues
9
+have a higher chance of being addressed quickly. Please help us help you!
10
+
11
+This guide is roughly based on the [Atom contributor's guide](https://github.com/atom/atom/blob/master/CONTRIBUTING.md), so thanks to the Atom team for
12
+providing such a solid framework on which to hang our ideas.
13
+
14
+# Submitting Issues
15
+* Include the version of node-irc, or the SHA1 from git if you're using git.
16
+* Include the behavior you expect, other clients / bots where you've seen that behavior, the
17
+ observed behavior, and details on how the two differ if it's not obvious.
18
+* Enable debug mode for node-irc and include its output in your report.
19
+* In the case of a crash, include the full stack trace and any error output.
20
+* Perform a cursory search to see if similar issues or pull requests have already been filed, and
21
+comment on them to move the discussion forward.
22
+* Most importantly, provide a minimal test case that demonstrates your bug. This is the best way
23
+to help us quickly isolate and fix your bug.
24
+* Consider joining us on IRC (##node-irc on freenode) for realtime discussion. Not only is it a
25
+friendly gesture, it also helps us isolate your issue far more quickly than the back-and-forth of
26
+issues on github allows.
27
+
28
+# Pull requests
29
+* Add yourself to the contributors section of package.json to claim credit for your work!
30
+* Do your work on a branch from master and file your pull request from that branch to master.
31
+* Make sure your code passes all tests (`npm run test; npm run lint`).
32
+* If possible, write *new* tests for the functionality you add. Once we have sane testing in place,
33
+this will become a hard requirement, so it's best to get used to it now!
34
+* If you change any user-facing element of the library (e.g. the API), document your changes.
35
+* If you make *breaking* changes, say so clearly in your pull request, so we know to schedule the
36
+merge when we plan to break the API for other changes.
37
+* Squash your commits into one before issuing your pull request. If you are not sure how to do this,
38
+take a look at the [edx instructions](https://github.com/edx/edx-platform/wiki/How-to-Rebase-a-Pull-Request) and change the
39
+obvious things to apply to your node-irc fork. If this doesn't make sense, or you're having trouble,
40
+come talk to us on IRC! We'll be glad to walk you through it.
41
+* End files with a newline.
42
+
43
+# Commit messages
44
+* Use the present tense ("Add feature" not "Added feature").
45
+* Use the imperative mood ("Change message handling..." not "Changes message handling...").
46
+* Limit the first line to 72 characters or less.
47
+* Reference issues and pull requests liberally.
... ...
@@ -0,0 +1,674 @@
1
+                    GNU GENERAL PUBLIC LICENSE
2
+                       Version 3, 29 June 2007
3
+
4
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
5
+ Everyone is permitted to copy and distribute verbatim copies
6
+ of this license document, but changing it is not allowed.
7
+
8
+                            Preamble
9
+
10
+  The GNU General Public License is a free, copyleft license for
11
+software and other kinds of works.
12
+
13
+  The licenses for most software and other practical works are designed
14
+to take away your freedom to share and change the works.  By contrast,
15
+the GNU General Public License is intended to guarantee your freedom to
16
+share and change all versions of a program--to make sure it remains free
17
+software for all its users.  We, the Free Software Foundation, use the
18
+GNU General Public License for most of our software; it applies also to
19
+any other work released this way by its authors.  You can apply it to
20
+your programs, too.
21
+
22
+  When we speak of free software, we are referring to freedom, not
23
+price.  Our General Public Licenses are designed to make sure that you
24
+have the freedom to distribute copies of free software (and charge for
25
+them if you wish), that you receive source code or can get it if you
26
+want it, that you can change the software or use pieces of it in new
27
+free programs, and that you know you can do these things.
28
+
29
+  To protect your rights, we need to prevent others from denying you
30
+these rights or asking you to surrender the rights.  Therefore, you have
31
+certain responsibilities if you distribute copies of the software, or if
32
+you modify it: responsibilities to respect the freedom of others.
33
+
34
+  For example, if you distribute copies of such a program, whether
35
+gratis or for a fee, you must pass on to the recipients the same
36
+freedoms that you received.  You must make sure that they, too, receive
37
+or can get the source code.  And you must show them these terms so they
38
+know their rights.
39
+
40
+  Developers that use the GNU GPL protect your rights with two steps:
41
+(1) assert copyright on the software, and (2) offer you this License
42
+giving you legal permission to copy, distribute and/or modify it.
43
+
44
+  For the developers' and authors' protection, the GPL clearly explains
45
+that there is no warranty for this free software.  For both users' and
46
+authors' sake, the GPL requires that modified versions be marked as
47
+changed, so that their problems will not be attributed erroneously to
48
+authors of previous versions.
49
+
50
+  Some devices are designed to deny users access to install or run
51
+modified versions of the software inside them, although the manufacturer
52
+can do so.  This is fundamentally incompatible with the aim of
53
+protecting users' freedom to change the software.  The systematic
54
+pattern of such abuse occurs in the area of products for individuals to
55
+use, which is precisely where it is most unacceptable.  Therefore, we
56
+have designed this version of the GPL to prohibit the practice for those
57
+products.  If such problems arise substantially in other domains, we
58
+stand ready to extend this provision to those domains in future versions
59
+of the GPL, as needed to protect the freedom of users.
60
+
61
+  Finally, every program is threatened constantly by software patents.
62
+States should not allow patents to restrict development and use of
63
+software on general-purpose computers, but in those that do, we wish to
64
+avoid the special danger that patents applied to a free program could
65
+make it effectively proprietary.  To prevent this, the GPL assures that
66
+patents cannot be used to render the program non-free.
67
+
68
+  The precise terms and conditions for copying, distribution and
69
+modification follow.
70
+
71
+                       TERMS AND CONDITIONS
72
+
73
+  0. Definitions.
74
+
75
+  "This License" refers to version 3 of the GNU General Public License.
76
+
77
+  "Copyright" also means copyright-like laws that apply to other kinds of
78
+works, such as semiconductor masks.
79
+
80
+  "The Program" refers to any copyrightable work licensed under this
81
+License.  Each licensee is addressed as "you".  "Licensees" and
82
+"recipients" may be individuals or organizations.
83
+
84
+  To "modify" a work means to copy from or adapt all or part of the work
85
+in a fashion requiring copyright permission, other than the making of an
86
+exact copy.  The resulting work is called a "modified version" of the
87
+earlier work or a work "based on" the earlier work.
88
+
89
+  A "covered work" means either the unmodified Program or a work based
90
+on the Program.
91
+
92
+  To "propagate" a work means to do anything with it that, without
93
+permission, would make you directly or secondarily liable for
94
+infringement under applicable copyright law, except executing it on a
95
+computer or modifying a private copy.  Propagation includes copying,
96
+distribution (with or without modification), making available to the
97
+public, and in some countries other activities as well.
98
+
99
+  To "convey" a work means any kind of propagation that enables other
100
+parties to make or receive copies.  Mere interaction with a user through
101
+a computer network, with no transfer of a copy, is not conveying.
102
+
103
+  An interactive user interface displays "Appropriate Legal Notices"
104
+to the extent that it includes a convenient and prominently visible
105
+feature that (1) displays an appropriate copyright notice, and (2)
106
+tells the user that there is no warranty for the work (except to the
107
+extent that warranties are provided), that licensees may convey the
108
+work under this License, and how to view a copy of this License.  If
109
+the interface presents a list of user commands or options, such as a
110
+menu, a prominent item in the list meets this criterion.
111
+
112
+  1. Source Code.
113
+
114
+  The "source code" for a work means the preferred form of the work
115
+for making modifications to it.  "Object code" means any non-source
116
+form of a work.
117
+
118
+  A "Standard Interface" means an interface that either is an official
119
+standard defined by a recognized standards body, or, in the case of
120
+interfaces specified for a particular programming language, one that
121
+is widely used among developers working in that language.
122
+
123
+  The "System Libraries" of an executable work include anything, other
124
+than the work as a whole, that (a) is included in the normal form of
125
+packaging a Major Component, but which is not part of that Major
126
+Component, and (b) serves only to enable use of the work with that
127
+Major Component, or to implement a Standard Interface for which an
128
+implementation is available to the public in source code form.  A
129
+"Major Component", in this context, means a major essential component
130
+(kernel, window system, and so on) of the specific operating system
131
+(if any) on which the executable work runs, or a compiler used to
132
+produce the work, or an object code interpreter used to run it.
133
+
134
+  The "Corresponding Source" for a work in object code form means all
135
+the source code needed to generate, install, and (for an executable
136
+work) run the object code and to modify the work, including scripts to
137
+control those activities.  However, it does not include the work's
138
+System Libraries, or general-purpose tools or generally available free
139
+programs which are used unmodified in performing those activities but
140
+which are not part of the work.  For example, Corresponding Source
141
+includes interface definition files associated with source files for
142
+the work, and the source code for shared libraries and dynamically
143
+linked subprograms that the work is specifically designed to require,
144
+such as by intimate data communication or control flow between those
145
+subprograms and other parts of the work.
146
+
147
+  The Corresponding Source need not include anything that users
148
+can regenerate automatically from other parts of the Corresponding
149
+Source.
150
+
151
+  The Corresponding Source for a work in source code form is that
152
+same work.
153
+
154
+  2. Basic Permissions.
155
+
156
+  All rights granted under this License are granted for the term of
157
+copyright on the Program, and are irrevocable provided the stated
158
+conditions are met.  This License explicitly affirms your unlimited
159
+permission to run the unmodified Program.  The output from running a
160
+covered work is covered by this License only if the output, given its
161
+content, constitutes a covered work.  This License acknowledges your
162
+rights of fair use or other equivalent, as provided by copyright law.
163
+
164
+  You may make, run and propagate covered works that you do not
165
+convey, without conditions so long as your license otherwise remains
166
+in force.  You may convey covered works to others for the sole purpose
167
+of having them make modifications exclusively for you, or provide you
168
+with facilities for running those works, provided that you comply with
169
+the terms of this License in conveying all material for which you do
170
+not control copyright.  Those thus making or running the covered works
171
+for you must do so exclusively on your behalf, under your direction
172
+and control, on terms that prohibit them from making any copies of
173
+your copyrighted material outside their relationship with you.
174
+
175
+  Conveying under any other circumstances is permitted solely under
176
+the conditions stated below.  Sublicensing is not allowed; section 10
177
+makes it unnecessary.
178
+
179
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180
+
181
+  No covered work shall be deemed part of an effective technological
182
+measure under any applicable law fulfilling obligations under article
183
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
184
+similar laws prohibiting or restricting circumvention of such
185
+measures.
186
+
187
+  When you convey a covered work, you waive any legal power to forbid
188
+circumvention of technological measures to the extent such circumvention
189
+is effected by exercising rights under this License with respect to
190
+the covered work, and you disclaim any intention to limit operation or
191
+modification of the work as a means of enforcing, against the work's
192
+users, your or third parties' legal rights to forbid circumvention of
193
+technological measures.
194
+
195
+  4. Conveying Verbatim Copies.
196
+
197
+  You may convey verbatim copies of the Program's source code as you
198
+receive it, in any medium, provided that you conspicuously and
199
+appropriately publish on each copy an appropriate copyright notice;
200
+keep intact all notices stating that this License and any
201
+non-permissive terms added in accord with section 7 apply to the code;
202
+keep intact all notices of the absence of any warranty; and give all
203
+recipients a copy of this License along with the Program.
204
+
205
+  You may charge any price or no price for each copy that you convey,
206
+and you may offer support or warranty protection for a fee.
207
+
208
+  5. Conveying Modified Source Versions.
209
+
210
+  You may convey a work based on the Program, or the modifications to
211
+produce it from the Program, in the form of source code under the
212
+terms of section 4, provided that you also meet all of these conditions:
213
+
214
+    a) The work must carry prominent notices stating that you modified
215
+    it, and giving a relevant date.
216
+
217
+    b) The work must carry prominent notices stating that it is
218
+    released under this License and any conditions added under section
219
+    7.  This requirement modifies the requirement in section 4 to
220
+    "keep intact all notices".
221
+
222
+    c) You must license the entire work, as a whole, under this
223
+    License to anyone who comes into possession of a copy.  This
224
+    License will therefore apply, along with any applicable section 7
225
+    additional terms, to the whole of the work, and all its parts,
226
+    regardless of how they are packaged.  This License gives no
227
+    permission to license the work in any other way, but it does not
228
+    invalidate such permission if you have separately received it.
229
+
230
+    d) If the work has interactive user interfaces, each must display
231
+    Appropriate Legal Notices; however, if the Program has interactive
232
+    interfaces that do not display Appropriate Legal Notices, your
233
+    work need not make them do so.
234
+
235
+  A compilation of a covered work with other separate and independent
236
+works, which are not by their nature extensions of the covered work,
237
+and which are not combined with it such as to form a larger program,
238
+in or on a volume of a storage or distribution medium, is called an
239
+"aggregate" if the compilation and its resulting copyright are not
240
+used to limit the access or legal rights of the compilation's users
241
+beyond what the individual works permit.  Inclusion of a covered work
242
+in an aggregate does not cause this License to apply to the other
243
+parts of the aggregate.
244
+
245
+  6. Conveying Non-Source Forms.
246
+
247
+  You may convey a covered work in object code form under the terms
248
+of sections 4 and 5, provided that you also convey the
249
+machine-readable Corresponding Source under the terms of this License,
250
+in one of these ways:
251
+
252
+    a) Convey the object code in, or embodied in, a physical product
253
+    (including a physical distribution medium), accompanied by the
254
+    Corresponding Source fixed on a durable physical medium
255
+    customarily used for software interchange.
256
+
257
+    b) Convey the object code in, or embodied in, a physical product
258
+    (including a physical distribution medium), accompanied by a
259
+    written offer, valid for at least three years and valid for as
260
+    long as you offer spare parts or customer support for that product
261
+    model, to give anyone who possesses the object code either (1) a
262
+    copy of the Corresponding Source for all the software in the
263
+    product that is covered by this License, on a durable physical
264
+    medium customarily used for software interchange, for a price no
265
+    more than your reasonable cost of physically performing this
266
+    conveying of source, or (2) access to copy the
267
+    Corresponding Source from a network server at no charge.
268
+
269
+    c) Convey individual copies of the object code with a copy of the
270
+    written offer to provide the Corresponding Source.  This
271
+    alternative is allowed only occasionally and noncommercially, and
272
+    only if you received the object code with such an offer, in accord
273
+    with subsection 6b.
274
+
275
+    d) Convey the object code by offering access from a designated
276
+    place (gratis or for a charge), and offer equivalent access to the
277
+    Corresponding Source in the same way through the same place at no
278
+    further charge.  You need not require recipients to copy the
279
+    Corresponding Source along with the object code.  If the place to
280
+    copy the object code is a network server, the Corresponding Source
281
+    may be on a different server (operated by you or a third party)
282
+    that supports equivalent copying facilities, provided you maintain
283
+    clear directions next to the object code saying where to find the
284
+    Corresponding Source.  Regardless of what server hosts the
285
+    Corresponding Source, you remain obligated to ensure that it is
286
+    available for as long as needed to satisfy these requirements.
287
+
288
+    e) Convey the object code using peer-to-peer transmission, provided
289
+    you inform other peers where the object code and Corresponding
290
+    Source of the work are being offered to the general public at no
291
+    charge under subsection 6d.
292
+
293
+  A separable portion of the object code, whose source code is excluded
294
+from the Corresponding Source as a System Library, need not be
295
+included in conveying the object code work.
296
+
297
+  A "User Product" is either (1) a "consumer product", which means any
298
+tangible personal property which is normally used for personal, family,
299
+or household purposes, or (2) anything designed or sold for incorporation
300
+into a dwelling.  In determining whether a product is a consumer product,
301
+doubtful cases shall be resolved in favor of coverage.  For a particular
302
+product received by a particular user, "normally used" refers to a
303
+typical or common use of that class of product, regardless of the status
304
+of the particular user or of the way in which the particular user
305
+actually uses, or expects or is expected to use, the product.  A product
306
+is a consumer product regardless of whether the product has substantial
307
+commercial, industrial or non-consumer uses, unless such uses represent
308
+the only significant mode of use of the product.
309
+
310
+  "Installation Information" for a User Product means any methods,
311
+procedures, authorization keys, or other information required to install
312
+and execute modified versions of a covered work in that User Product from
313
+a modified version of its Corresponding Source.  The information must
314
+suffice to ensure that the continued functioning of the modified object
315
+code is in no case prevented or interfered with solely because
316
+modification has been made.
317
+
318
+  If you convey an object code work under this section in, or with, or
319
+specifically for use in, a User Product, and the conveying occurs as
320
+part of a transaction in which the right of possession and use of the
321
+User Product is transferred to the recipient in perpetuity or for a
322
+fixed term (regardless of how the transaction is characterized), the
323
+Corresponding Source conveyed under this section must be accompanied
324
+by the Installation Information.  But this requirement does not apply
325
+if neither you nor any third party retains the ability to install
326
+modified object code on the User Product (for example, the work has
327
+been installed in ROM).
328
+
329
+  The requirement to provide Installation Information does not include a
330
+requirement to continue to provide support service, warranty, or updates
331
+for a work that has been modified or installed by the recipient, or for
332
+the User Product in which it has been modified or installed.  Access to a
333
+network may be denied when the modification itself materially and
334
+adversely affects the operation of the network or violates the rules and
335
+protocols for communication across the network.
336
+
337
+  Corresponding Source conveyed, and Installation Information provided,
338
+in accord with this section must be in a format that is publicly
339
+documented (and with an implementation available to the public in
340
+source code form), and must require no special password or key for
341
+unpacking, reading or copying.
342
+
343
+  7. Additional Terms.
344
+
345
+  "Additional permissions" are terms that supplement the terms of this
346
+License by making exceptions from one or more of its conditions.
347
+Additional permissions that are applicable to the entire Program shall
348
+be treated as though they were included in this License, to the extent
349
+that they are valid under applicable law.  If additional permissions
350
+apply only to part of the Program, that part may be used separately
351
+under those permissions, but the entire Program remains governed by
352
+this License without regard to the additional permissions.
353
+
354
+  When you convey a copy of a covered work, you may at your option
355
+remove any additional permissions from that copy, or from any part of
356
+it.  (Additional permissions may be written to require their own
357
+removal in certain cases when you modify the work.)  You may place
358
+additional permissions on material, added by you to a covered work,
359
+for which you have or can give appropriate copyright permission.
360
+
361
+  Notwithstanding any other provision of this License, for material you
362
+add to a covered work, you may (if authorized by the copyright holders of
363
+that material) supplement the terms of this License with terms:
364
+
365
+    a) Disclaiming warranty or limiting liability differently from the
366
+    terms of sections 15 and 16 of this License; or
367
+
368
+    b) Requiring preservation of specified reasonable legal notices or
369
+    author attributions in that material or in the Appropriate Legal
370
+    Notices displayed by works containing it; or
371
+
372
+    c) Prohibiting misrepresentation of the origin of that material, or
373
+    requiring that modified versions of such material be marked in
374
+    reasonable ways as different from the original version; or
375
+
376
+    d) Limiting the use for publicity purposes of names of licensors or
377
+    authors of the material; or
378
+
379
+    e) Declining to grant rights under trademark law for use of some
380
+    trade names, trademarks, or service marks; or
381
+
382
+    f) Requiring indemnification of licensors and authors of that
383
+    material by anyone who conveys the material (or modified versions of
384
+    it) with contractual assumptions of liability to the recipient, for
385
+    any liability that these contractual assumptions directly impose on
386
+    those licensors and authors.
387
+
388
+  All other non-permissive additional terms are considered "further
389
+restrictions" within the meaning of section 10.  If the Program as you
390
+received it, or any part of it, contains a notice stating that it is
391
+governed by this License along with a term that is a further
392
+restriction, you may remove that term.  If a license document contains
393
+a further restriction but permits relicensing or conveying under this
394
+License, you may add to a covered work material governed by the terms
395
+of that license document, provided that the further restriction does
396
+not survive such relicensing or conveying.
397
+
398
+  If you add terms to a covered work in accord with this section, you
399
+must place, in the relevant source files, a statement of the
400
+additional terms that apply to those files, or a notice indicating
401
+where to find the applicable terms.
402
+
403
+  Additional terms, permissive or non-permissive, may be stated in the
404
+form of a separately written license, or stated as exceptions;
405
+the above requirements apply either way.
406
+
407
+  8. Termination.
408
+
409
+  You may not propagate or modify a covered work except as expressly
410
+provided under this License.  Any attempt otherwise to propagate or
411
+modify it is void, and will automatically terminate your rights under
412
+this License (including any patent licenses granted under the third
413
+paragraph of section 11).
414
+
415
+  However, if you cease all violation of this License, then your
416
+license from a particular copyright holder is reinstated (a)
417
+provisionally, unless and until the copyright holder explicitly and
418
+finally terminates your license, and (b) permanently, if the copyright
419
+holder fails to notify you of the violation by some reasonable means
420
+prior to 60 days after the cessation.
421
+
422
+  Moreover, your license from a particular copyright holder is
423
+reinstated permanently if the copyright holder notifies you of the
424
+violation by some reasonable means, this is the first time you have
425
+received notice of violation of this License (for any work) from that
426
+copyright holder, and you cure the violation prior to 30 days after
427
+your receipt of the notice.
428
+
429
+  Termination of your rights under this section does not terminate the
430
+licenses of parties who have received copies or rights from you under
431
+this License.  If your rights have been terminated and not permanently
432
+reinstated, you do not qualify to receive new licenses for the same
433
+material under section 10.
434
+
435
+  9. Acceptance Not Required for Having Copies.
436
+
437
+  You are not required to accept this License in order to receive or
438
+run a copy of the Program.  Ancillary propagation of a covered work
439
+occurring solely as a consequence of using peer-to-peer transmission
440
+to receive a copy likewise does not require acceptance.  However,
441
+nothing other than this License grants you permission to propagate or
442
+modify any covered work.  These actions infringe copyright if you do
443
+not accept this License.  Therefore, by modifying or propagating a
444
+covered work, you indicate your acceptance of this License to do so.
445
+
446
+  10. Automatic Licensing of Downstream Recipients.
447
+
448
+  Each time you convey a covered work, the recipient automatically
449
+receives a license from the original licensors, to run, modify and
450
+propagate that work, subject to this License.  You are not responsible
451
+for enforcing compliance by third parties with this License.
452
+
453
+  An "entity transaction" is a transaction transferring control of an
454
+organization, or substantially all assets of one, or subdividing an
455
+organization, or merging organizations.  If propagation of a covered
456
+work results from an entity transaction, each party to that
457
+transaction who receives a copy of the work also receives whatever
458
+licenses to the work the party's predecessor in interest had or could
459
+give under the previous paragraph, plus a right to possession of the
460
+Corresponding Source of the work from the predecessor in interest, if
461
+the predecessor has it or can get it with reasonable efforts.
462
+
463
+  You may not impose any further restrictions on the exercise of the
464
+rights granted or affirmed under this License.  For example, you may
465
+not impose a license fee, royalty, or other charge for exercise of
466
+rights granted under this License, and you may not initiate litigation
467
+(including a cross-claim or counterclaim in a lawsuit) alleging that
468
+any patent claim is infringed by making, using, selling, offering for
469
+sale, or importing the Program or any portion of it.
470
+
471
+  11. Patents.
472
+
473
+  A "contributor" is a copyright holder who authorizes use under this
474
+License of the Program or a work on which the Program is based.  The
475
+work thus licensed is called the contributor's "contributor version".
476
+
477
+  A contributor's "essential patent claims" are all patent claims
478
+owned or controlled by the contributor, whether already acquired or
479
+hereafter acquired, that would be infringed by some manner, permitted
480
+by this License, of making, using, or selling its contributor version,
481
+but do not include claims that would be infringed only as a
482
+consequence of further modification of the contributor version.  For
483
+purposes of this definition, "control" includes the right to grant
484
+patent sublicenses in a manner consistent with the requirements of
485
+this License.
486
+
487
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
488
+patent license under the contributor's essential patent claims, to
489
+make, use, sell, offer for sale, import and otherwise run, modify and
490
+propagate the contents of its contributor version.
491
+
492
+  In the following three paragraphs, a "patent license" is any express
493
+agreement or commitment, however denominated, not to enforce a patent
494
+(such as an express permission to practice a patent or covenant not to
495
+sue for patent infringement).  To "grant" such a patent license to a
496
+party means to make such an agreement or commitment not to enforce a
497
+patent against the party.
498
+
499
+  If you convey a covered work, knowingly relying on a patent license,
500
+and the Corresponding Source of the work is not available for anyone
501
+to copy, free of charge and under the terms of this License, through a
502
+publicly available network server or other readily accessible means,
503
+then you must either (1) cause the Corresponding Source to be so
504
+available, or (2) arrange to deprive yourself of the benefit of the
505
+patent license for this particular work, or (3) arrange, in a manner
506
+consistent with the requirements of this License, to extend the patent
507
+license to downstream recipients.  "Knowingly relying" means you have
508
+actual knowledge that, but for the patent license, your conveying the
509
+covered work in a country, or your recipient's use of the covered work
510
+in a country, would infringe one or more identifiable patents in that
511
+country that you have reason to believe are valid.
512
+
513
+  If, pursuant to or in connection with a single transaction or
514
+arrangement, you convey, or propagate by procuring conveyance of, a
515
+covered work, and grant a patent license to some of the parties
516
+receiving the covered work authorizing them to use, propagate, modify
517
+or convey a specific copy of the covered work, then the patent license
518
+you grant is automatically extended to all recipients of the covered
519
+work and works based on it.
520
+
521
+  A patent license is "discriminatory" if it does not include within
522
+the scope of its coverage, prohibits the exercise of, or is
523
+conditioned on the non-exercise of one or more of the rights that are
524
+specifically granted under this License.  You may not convey a covered
525
+work if you are a party to an arrangement with a third party that is
526
+in the business of distributing software, under which you make payment
527
+to the third party based on the extent of your activity of conveying
528
+the work, and under which the third party grants, to any of the
529
+parties who would receive the covered work from you, a discriminatory
530
+patent license (a) in connection with copies of the covered work
531
+conveyed by you (or copies made from those copies), or (b) primarily
532
+for and in connection with specific products or compilations that
533
+contain the covered work, unless you entered into that arrangement,
534
+or that patent license was granted, prior to 28 March 2007.
535
+
536
+  Nothing in this License shall be construed as excluding or limiting
537
+any implied license or other defenses to infringement that may
538
+otherwise be available to you under applicable patent law.
539
+
540
+  12. No Surrender of Others' Freedom.
541
+
542
+  If conditions are imposed on you (whether by court order, agreement or
543
+otherwise) that contradict the conditions of this License, they do not
544
+excuse you from the conditions of this License.  If you cannot convey a
545
+covered work so as to satisfy simultaneously your obligations under this
546
+License and any other pertinent obligations, then as a consequence you may
547
+not convey it at all.  For example, if you agree to terms that obligate you
548
+to collect a royalty for further conveying from those to whom you convey
549
+the Program, the only way you could satisfy both those terms and this
550
+License would be to refrain entirely from conveying the Program.
551
+
552
+  13. Use with the GNU Affero General Public License.
553
+
554
+  Notwithstanding any other provision of this License, you have
555
+permission to link or combine any covered work with a work licensed
556
+under version 3 of the GNU Affero General Public License into a single
557
+combined work, and to convey the resulting work.  The terms of this
558
+License will continue to apply to the part which is the covered work,
559
+but the special requirements of the GNU Affero General Public License,
560
+section 13, concerning interaction through a network will apply to the
561
+combination as such.
562
+
563
+  14. Revised Versions of this License.
564
+
565
+  The Free Software Foundation may publish revised and/or new versions of
566
+the GNU General Public License from time to time.  Such new versions will
567
+be similar in spirit to the present version, but may differ in detail to
568
+address new problems or concerns.
569
+
570
+  Each version is given a distinguishing version number.  If the
571
+Program specifies that a certain numbered version of the GNU General
572
+Public License "or any later version" applies to it, you have the
573
+option of following the terms and conditions either of that numbered
574
+version or of any later version published by the Free Software
575
+Foundation.  If the Program does not specify a version number of the
576
+GNU General Public License, you may choose any version ever published
577
+by the Free Software Foundation.
578
+
579
+  If the Program specifies that a proxy can decide which future
580
+versions of the GNU General Public License can be used, that proxy's
581
+public statement of acceptance of a version permanently authorizes you
582
+to choose that version for the Program.
583
+
584
+  Later license versions may give you additional or different
585
+permissions.  However, no additional obligations are imposed on any
586
+author or copyright holder as a result of your choosing to follow a
587
+later version.
588
+
589
+  15. Disclaimer of Warranty.
590
+
591
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599
+
600
+  16. Limitation of Liability.
601
+
602
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610
+SUCH DAMAGES.
611
+
612
+  17. Interpretation of Sections 15 and 16.
613
+
614
+  If the disclaimer of warranty and limitation of liability provided
615
+above cannot be given local legal effect according to their terms,
616
+reviewing courts shall apply local law that most closely approximates
617
+an absolute waiver of all civil liability in connection with the
618
+Program, unless a warranty or assumption of liability accompanies a
619
+copy of the Program in return for a fee.
620
+
621
+                     END OF TERMS AND CONDITIONS
622
+
623
+            How to Apply These Terms to Your New Programs
624
+
625
+  If you develop a new program, and you want it to be of the greatest
626
+possible use to the public, the best way to achieve this is to make it
627
+free software which everyone can redistribute and change under these terms.
628
+
629
+  To do so, attach the following notices to the program.  It is safest
630
+to attach them to the start of each source file to most effectively
631
+state the exclusion of warranty; and each file should have at least
632
+the "copyright" line and a pointer to where the full notice is found.
633
+
634
+    <one line to give the program's name and a brief idea of what it does.>
635
+    Copyright (C) <year>  <name of author>
636
+
637
+    This program is free software: you can redistribute it and/or modify
638
+    it under the terms of the GNU General Public License as published by
639
+    the Free Software Foundation, either version 3 of the License, or
640
+    (at your option) any later version.
641
+
642
+    This program is distributed in the hope that it will be useful,
643
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
644
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
645
+    GNU General Public License for more details.
646
+
647
+    You should have received a copy of the GNU General Public License
648
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
649
+
650
+Also add information on how to contact you by electronic and paper mail.
651
+
652
+  If the program does terminal interaction, make it output a short
653
+notice like this when it starts in an interactive mode:
654
+
655
+    <program>  Copyright (C) <year>  <name of author>
656
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657
+    This is free software, and you are welcome to redistribute it
658
+    under certain conditions; type `show c' for details.
659
+
660
+The hypothetical commands `show w' and `show c' should show the appropriate
661
+parts of the General Public License.  Of course, your program's commands
662
+might be different; for a GUI interface, you would use an "about box".
663
+
664
+  You should also get your employer (if you work as a programmer) or school,
665
+if any, to sign a "copyright disclaimer" for the program, if necessary.
666
+For more information on this, and how to apply and follow the GNU GPL, see
667
+<http://www.gnu.org/licenses/>.
668
+
669
+  The GNU General Public License does not permit incorporating your program
670
+into proprietary programs.  If your program is a subroutine library, you
671
+may consider it more useful to permit linking proprietary applications with
672
+the library.  If this is what you want to do, use the GNU Lesser General
673
+Public License instead of this License.  But first, please read
674
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.
... ...
@@ -0,0 +1,134 @@
1
+[![Travis](https://img.shields.io/travis/martynsmith/node-irc.svg?style=flat)](https://travis-ci.org/martynsmith/node-irc)
2
+[![npm](https://img.shields.io/npm/v/irc.svg?style=flat)](https://www.npmjs.com/package/irc)
3
+[![Dependency Status](https://img.shields.io/david/martynsmith/node-irc.svg?style=flat)](https://david-dm.org/martynsmith/node-irc#info=Dependencies)
4
+[![devDependency Status](https://img.shields.io/david/dev/martynsmith/node-irc.svg?style=flat)](https://david-dm.org/martynsmith/node-irc#info=devDependencies)
5
+[![License](https://img.shields.io/badge/license-GPLv3-blue.svg?style=flat)](http://opensource.org/licenses/GPL-3.0)
6
+[![Join the chat at https://gitter.im/martynsmith/node-irc](https://badges.gitter.im/martynsmith/node-irc.svg)](https://gitter.im/martynsmith/node-irc?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
7
+
8
+
9
+[node-irc](http://node-irc.readthedocs.org/) is an IRC client library written in [JavaScript](http://en.wikipedia.org/wiki/JavaScript) for [Node](http://nodejs.org/).
10
+
11
+You can access more detailed documentation for this module at [Read the Docs](http://readthedocs.org/docs/node-irc/en/latest/)
12
+
13
+
14
+## Installation
15
+
16
+The easiest way to get it is via [npm](http://github.com/isaacs/npm):
17
+
18
+```
19
+npm install irc
20
+```
21
+
22
+If you want to run the latest version (i.e. later than the version available via
23
+[npm](http://github.com/isaacs/npm)) you can clone this repo, then use [npm](http://github.com/isaacs/npm) to link-install it:
24
+
25
+```
26
+    npm link /path/to/your/clone
27
+```
28
+
29
+Of course, you can just clone this, and manually point at the library itself,
30
+but we really recommend using [npm](http://github.com/isaacs/npm)!
31
+
32
+Note that as of version 0.3.8, node-irc supports character set detection using
33
+[icu](http://site.icu-project.org/). You'll need to install libiconv (if
34
+necessary; Linux systems tend to ship this in their glibc) and libicu (and its
35
+headers, if necessary, [install instructions](https://github.com/mooz/node-icu-charset-detector#installing-icu)) in order to use this feature. If you do not have these
36
+libraries or their headers installed, you will receive errors when trying to
37
+build these dependencies. However, node-irc will still install (assuming
38
+nothing else failed) and you'll be able to use it, just not the character
39
+set features.
40
+
41
+## Basic Usage
42
+
43
+This library provides basic IRC client functionality. In the simplest case you
44
+can connect to an IRC server like so:
45
+
46
+```js
47
+var irc = require('irc');
48
+var client = new irc.Client('irc.yourserver.com', 'myNick', {
49
+    channels: ['#channel'],
50
+});
51
+```
52
+
53
+Of course it's not much use once it's connected if that's all you have!
54
+
55
+The client emits a large number of events that correlate to things you'd
56
+normally see in your favorite IRC client. Most likely the first one you'll want
57
+to use is:
58
+
59
+```js
60
+client.addListener('message', function (from, to, message) {
61
+    console.log(from + ' => ' + to + ': ' + message);
62
+});
63
+```
64
+
65
+or if you're only interested in messages to the bot itself:
66
+
67
+```js
68
+client.addListener('pm', function (from, message) {
69
+    console.log(from + ' => ME: ' + message);
70
+});
71
+```
72
+
73
+or to a particular channel:
74
+
75
+```js
76
+client.addListener('message#yourchannel', function (from, message) {
77
+    console.log(from + ' => #yourchannel: ' + message);
78
+});
79
+```
80
+
81
+At the moment there are functions for joining:
82
+
83
+```js
84
+client.join('#yourchannel yourpass');
85
+```
86
+
87
+parting:
88
+
89
+```js
90
+client.part('#yourchannel');
91
+```
92
+
93
+talking:
94
+
95
+```js
96
+client.say('#yourchannel', "I'm a bot!");
97
+client.say('nonbeliever', "SRSLY, I AM!");
98
+```
99
+
100
+and many others. Check out the API documentation for a complete reference.
101
+
102
+For any commands that there aren't methods for you can use the send() method
103
+which sends raw messages to the server:
104
+
105
+```js
106
+client.send('MODE', '#yourchannel', '+o', 'yournick');
107
+```
108
+
109
+## Help! - it keeps crashing!
110
+
111
+When the client receives errors from the IRC network, it emits an "error"
112
+event. As stated in the [Node JS EventEmitter documentation](http://nodejs.org/api/events.html#events_class_events_eventemitter) if you don't bind
113
+something to this error, it will cause a fatal stack trace.
114
+
115
+The upshot of this is basically that if you bind an error handler to your
116
+client, errors will be sent there instead of crashing your program.:
117
+
118
+```js
119
+client.addListener('error', function(message) {
120
+    console.log('error: ', message);
121
+});
122
+```
123
+
124
+
125
+## Further Support
126
+
127
+Further documentation (including a complete API reference) is available in
128
+reStructuredText format in the docs/ folder of this project, or online at [Read the Docs](http://readthedocs.org/docs/node-irc/en/latest/).
129
+
130
+If you find any issues with the documentation (or the module) please send a pull
131
+request or file an issue and we'll do our best to accommodate.
132
+
133
+You can also visit us on ##node-irc on freenode to discuss issues you're having
134
+with the library, pull requests, or anything else related to node-irc.
... ...
@@ -0,0 +1,548 @@
1
+API
2
+===
3
+
4
+This library provides IRC client functionality
5
+
6
+Client
7
+----------
8
+
9
+.. js:function:: irc.Client(server, nick [, options])
10
+
11
+    This object is the base of everything, it represents a single nick connected to
12
+    a single IRC server.
13
+
14
+    The first two arguments are the server to connect to, and the nickname to
15
+    attempt to use. The third optional argument is an options object with default
16
+    values::
17
+
18
+        {
19
+            userName: 'nodebot',
20
+            realName: 'nodeJS IRC client',
21
+            port: 6667,
22
+            localAddress: null,
23
+            debug: false,
24
+            showErrors: false,
25
+            autoRejoin: false,
26
+            autoConnect: true,
27
+            channels: [],
28
+            secure: false,
29
+            selfSigned: false,
30
+            certExpired: false,
31
+            floodProtection: false,
32
+            floodProtectionDelay: 1000,
33
+            sasl: false,
34
+            retryCount: 0,
35
+            retryDelay: 2000,
36
+            stripColors: false,
37
+            channelPrefixes: "&#",
38
+            messageSplit: 512,
39
+            encoding: ''
40
+        }
41
+
42
+    `secure` (SSL connection) can be a true value or an object (the kind of object
43
+    returned from `crypto.createCredentials()`) specifying cert etc for validation.
44
+    If you set `selfSigned` to true SSL accepts certificates from a non trusted CA.
45
+    If you set `certExpired` to true, the bot connects even if the ssl cert has expired.
46
+
47
+    `localAddress` is the address to bind to when connecting.
48
+
49
+    `floodProtection` queues all your messages and slowly unpacks it to make sure
50
+    that we won't get kicked out because for Excess Flood. You can also use
51
+    `Client.activateFloodProtection()` to activate flood protection after
52
+    instantiating the client.
53
+
54
+    `floodProtectionDelay` sets the amount of time that the client will wait
55
+    between sending subsequent messages when `floodProtection` is enabled.
56
+
57
+    Set `sasl` to true to enable SASL support. You'll also want to set `nick`,
58
+    `userName`, and `password` for authentication.
59
+
60
+    `stripColors` removes mirc colors (0x03 followed by one or two ascii
61
+    numbers for foreground,background) and ircII "effect" codes (0x02
62
+    bold, 0x1f underline, 0x16 reverse, 0x0f reset) from the entire
63
+    message before parsing it and passing it along.
64
+
65
+    `messageSplit` will split up large messages sent with the `say` method
66
+    into multiple messages of length fewer than `messageSplit` characters.
67
+
68
+    With `encoding` you can set IRC bot to convert all messages to specified character set. If you don't want to use
69
+    this just leave value blank or false. Example values are UTF-8, ISO-8859-15, etc.
70
+
71
+    Setting `debug` to true will emit timestamped messages to the console
72
+    using `util.log` when certain events are fired.
73
+
74
+    `autoRejoin` has the client rejoin channels after being kicked.
75
+
76
+    Setting `autoConnect` to false prevents the Client from connecting on
77
+    instantiation.  You will need to call `connect()` on the client instance::
78
+
79
+        var client = new irc.Client({ autoConnect: false, ... });
80
+        client.connect();
81
+
82
+    `retryCount` is the number of times the client will try to automatically reconnect when disconnected. It defaults to 0.
83
+
84
+    `retryDelay` is the number of milliseconds to wait before retying to automatically reconnect when disconnected. It defaults to 2000.
85
+
86
+.. js:function:: Client.send(command, arg1, arg2, ...)
87
+
88
+    Sends a raw message to the server; generally speaking, it's best not to use
89
+    this method unless you know what you're doing. Instead, use one of the
90
+    methods below.
91
+
92
+.. js:function:: Client.join(channel, callback)
93
+
94
+    Joins the specified channel.
95
+
96
+    :param string channel: Channel to join
97
+    :param function callback: Callback to automatically subscribed to the
98
+        `join#channel` event, but removed after the first invocation.  `channel`
99
+        supports multiple JOIN arguments as a space separated string (similar to
100
+        the IRC protocol).
101
+
102
+.. js:function:: Client.part(channel, [message], callback)
103
+
104
+    Parts the specified channel.
105
+
106
+    :param string channel: Channel to part
107
+    :param string message: Optional message to send upon leaving the channel
108
+    :param function callback: Callback to automatically subscribed to the
109
+        `part#channel` event, but removed after the first invocation.
110
+
111
+.. js:function:: Client.say(target, message)
112
+
113
+    Sends a message to the specified target.
114
+
115
+    :param string target: is either a nickname, or a channel.
116
+    :param string message: the message to send to the target.
117
+
118
+.. js:function:: Client.ctcp(target, type, text)
119
+
120
+    Sends a CTCP message to the specified target.
121
+
122
+    :param string target: is either a nickname, or a channel.
123
+    :param string type: the type of the CTCP message. Specify "privmsg" for a
124
+        PRIVMSG, and anything else for a NOTICE.
125
+    :param string text: the CTCP message to send.
126
+
127
+.. js:function:: Client.action(target, message)
128
+
129
+    Sends an action to the specified target.
130
+
131
+.. js:function:: Client.notice(target, message)
132
+
133
+    Sends a notice to the specified target.
134
+
135
+    :param string target: is either a nickname, or a channel.
136
+    :param string message: the message to send as a notice to the target.
137
+
138
+.. js:function:: Client.whois(nick, callback)
139
+
140
+    Request a whois for the specified `nick`.
141
+
142
+    :param string nick: is a nickname
143
+    :param function callback: Callback to fire when the server has finished
144
+        generating the whois information and is passed exactly the same
145
+        information as a `whois` event described above.
146
+
147
+.. js:function:: Client.list([arg1, arg2, ...])
148
+
149
+   Request a channel listing from the server. The arguments for this method are
150
+   fairly server specific, this method just passes them through exactly as
151
+   specified.
152
+
153
+   Responses from the server are available via the `channellist_start`,
154
+   `channellist_item`, and `channellist` events.
155
+
156
+.. js:function:: Client.connect([retryCount [, callback]])
157
+
158
+   Connects to the server. Used when `autoConnect` in the options is set to
159
+   false. If `retryCount` is a function it will be treated as the `callback`
160
+   (i.e. both arguments to this function are optional).
161
+
162
+    :param integer retryCount: Optional number of times to attempt reconnection
163
+    :param function callback: Optional callback
164
+
165
+.. js:function:: Client.disconnect([message [, callback]])
166
+
167
+    Disconnects from the IRC server. If `message` is a function it will be
168
+    treated as the `callback` (i.e. both arguments to this function are
169
+    optional).
170
+
171
+    :param string message: Optional message to send when disconnecting.
172
+    :param function callback: Optional callback
173
+
174
+.. js:function:: Client.activateFloodProtection([interval])
175
+
176
+    Activates flood protection "after the fact". You can also use
177
+    `floodProtection` while instantiating the Client to enable flood
178
+    protection, and `floodProtectionDelay` to set the default message
179
+    interval.
180
+
181
+    :param integer interval: Optional configuration for amount of time
182
+        to wait between messages. Takes value from client configuration
183
+        if unspecified.
184
+
185
+Events
186
+------
187
+
188
+`irc.Client` instances are EventEmitters with the following events:
189
+
190
+
191
+.. js:data:: 'registered'
192
+
193
+    `function (message) { }`
194
+
195
+    Emitted when the server sends the initial 001 line, indicating you've connected
196
+    to the server. See the `raw` event for details on the `message` object.
197
+
198
+.. js:data:: 'motd'
199
+
200
+    `function (motd) { }`
201
+
202
+    Emitted when the server sends the message of the day to clients.
203
+
204
+.. js:data:: 'names'
205
+
206
+    `function (channel, nicks) { }`
207
+
208
+    Emitted when the server sends a list of nicks for a channel (which happens
209
+    immediately after joining and on request. The nicks object passed to the
210
+    callback is keyed by nick names, and has values '', '+', or '@' depending on the
211
+    level of that nick in the channel.
212
+
213
+.. js:data:: 'names#channel'
214
+
215
+    `function (nicks) { }`
216
+
217
+    As per 'names' event but only emits for the subscribed channel.
218
+
219
+.. js:data:: 'topic'
220
+
221
+    `function (channel, topic, nick, message) { }`
222
+
223
+    Emitted when the server sends the channel topic on joining a channel, or when a
224
+    user changes the topic on a channel. See the `raw` event for details on the
225
+    `message` object.
226
+
227
+.. js:data:: 'join'
228
+
229
+    `function (channel, nick, message) { }`
230
+
231
+    Emitted when a user joins a channel (including when the client itself joins a
232
+    channel). See the `raw` event for details on the `message` object.
233
+
234
+.. js:data:: 'join#channel'
235
+
236
+    `function (nick, message) { }`
237
+
238
+    As per 'join' event but only emits for the subscribed channel.
239
+    See the `raw` event for details on the `message` object.
240
+
241
+.. js:data:: 'part'
242
+
243
+    `function (channel, nick, reason, message) { }`
244
+
245
+    Emitted when a user parts a channel (including when the client itself parts a
246
+    channel). See the `raw` event for details on the `message` object.
247
+
248
+.. js:data:: 'part#channel'
249
+
250
+    `function (nick, reason, message) { }`
251
+
252
+    As per 'part' event but only emits for the subscribed channel.
253
+    See the `raw` event for details on the `message` object.
254
+
255
+.. js:data:: 'quit'
256
+
257
+    `function (nick, reason, channels, message) { }`
258
+
259
+    Emitted when a user disconnects from the IRC, leaving the specified array of
260
+    channels. See the `raw` event for details on the `message` object.
261
+
262
+.. js:data:: 'kick'
263
+
264
+    `function (channel, nick, by, reason, message) { }`
265
+
266
+    Emitted when a user is kicked from a channel. See the `raw` event for details
267
+    on the `message` object.
268
+
269
+.. js:data:: 'kick#channel'
270
+
271
+    `function (nick, by, reason, message) { }`
272
+
273
+    As per 'kick' event but only emits for the subscribed channel.
274
+    See the `raw` event for details on the `message` object.
275
+
276
+.. js:data:: 'kill'
277
+
278
+    `function (nick, reason, channels, message) { }`
279
+
280
+    Emitted when a user is killed from the IRC server.
281
+    `channels` is an array of channels the killed user was in which
282
+    are known to the client.
283
+    See the `raw` event for details on the `message` object.
284
+
285
+.. js:data:: 'message'
286
+
287
+    `function (nick, to, text, message) { }`
288
+
289
+    Emitted when a message is sent. `to` can be either a nick (which is most likely
290
+    this clients nick and means a private message), or a channel (which means a
291
+    message to that channel). See the `raw` event for details on the `message` object.
292
+
293
+.. js:data:: 'message#'
294
+
295
+    `function (nick, to, text, message) { }`
296
+
297
+    Emitted when a message is sent to any channel (i.e. exactly the same as the
298
+    `message` event but excluding private messages.
299
+    See the `raw` event for details on the `message` object.
300
+
301
+.. js:data:: 'message#channel'
302
+
303
+    `function (nick, text, message) { }`
304
+
305
+    As per 'message' event but only emits for the subscribed channel.
306
+    See the `raw` event for details on the `message` object.
307
+
308
+.. js:data:: 'selfMessage'
309
+
310
+    `function (to, text) { }`
311
+
312
+    Emitted when a message is sent from the client. `to` is who the message was
313
+    sent to. It can be either a nick (which most likely means a private message),
314
+    or a channel (which means a message to that channel).
315
+
316
+.. js:data:: 'notice'
317
+
318
+    `function (nick, to, text, message) { }`
319
+
320
+    Emitted when a notice is sent. `to` can be either a nick (which is most likely
321
+    this clients nick and means a private message), or a channel (which means a
322
+    message to that channel). `nick` is either the senders nick or `null` which
323
+    means that the notice comes from the server. See the `raw` event for details
324
+    on the `message` object.
325
+
326
+.. js:data:: 'ping'
327
+
328
+   `function (server) { }`
329
+
330
+   Emitted when a server PINGs the client. The client will automatically send a
331
+   PONG request just before this is emitted.
332
+
333
+.. js:data:: 'pm'
334
+
335
+    `function (nick, text, message) { }`
336
+
337
+    As per 'message' event but only emits when the message is direct to the client.
338
+    See the `raw` event for details on the `message` object.
339
+
340
+.. js:data:: 'ctcp'
341
+
342
+   `function (from, to, text, type, message) { }`
343
+
344
+   Emitted when a CTCP notice or privmsg was received (`type` is either `'notice'`
345
+   or `'privmsg'`).  See the `raw` event for details on the `message` object.
346
+
347
+.. js:data:: 'ctcp-notice'
348
+
349
+   `function (from, to, text, message) { }`
350
+
351
+   Emitted when a CTCP notice was received.
352
+   See the `raw` event for details on the `message` object.
353
+
354
+.. js:data:: 'ctcp-privmsg'
355
+
356
+   `function (from, to, text, message) { }`
357
+
358
+   Emitted when a CTCP privmsg was received.
359
+   See the `raw` event for details on the `message` object.
360
+
361
+.. js:data:: 'ctcp-version'
362
+
363
+   `function (from, to, message) { }`
364
+
365
+   Emitted when a CTCP VERSION request was received.
366
+   See the `raw` event for details on the `message` object.
367
+
368
+.. js:data:: 'nick'
369
+
370
+    `function (oldnick, newnick, channels, message) { }`
371
+
372
+    Emitted when a user changes nick along with the channels the user is in.
373
+    See the `raw` event for details on the `message` object.
374
+
375
+.. js:data:: 'invite'
376
+
377
+    `function (channel, from, message) { }`
378
+
379
+    Emitted when the client receives an `/invite`. See the `raw` event for details
380
+    on the `message` object.
381
+
382
+.. js:data:: '+mode'
383
+
384
+  `function (channel, by, mode, argument, message) { }`
385
+
386
+    Emitted when a mode is added to a user or channel. `channel` is the channel
387
+    which the mode is being set on/in. `by` is the user setting the mode. `mode`
388
+    is the single character mode identifier. If the mode is being set on a user,
389
+    `argument` is the nick of the user.  If the mode is being set on a channel,
390
+    `argument` is the argument to the mode. If a channel mode doesn't have any
391
+    arguments, `argument` will be 'undefined'. See the `raw` event for details
392
+    on the `message` object.
393
+
394
+.. js:data:: '-mode'
395
+
396
+  `function (channel, by, mode, argument, message) { }`
397
+
398
+    Emitted when a mode is removed from a user or channel. `channel` is the channel
399
+    which the mode is being set on/in. `by` is the user setting the mode. `mode`
400
+    is the single character mode identifier. If the mode is being set on a user,
401
+    `argument` is the nick of the user.  If the mode is being set on a channel,
402
+    `argument` is the argument to the mode. If a channel mode doesn't have any
403
+    arguments, `argument` will be 'undefined'. See the `raw` event for details
404
+    on the `message` object.
405
+
406
+.. js:data:: 'whois'
407
+
408
+    `function (info) { }`
409
+
410
+    Emitted whenever the server finishes outputting a WHOIS response. The
411
+    information should look something like::
412
+
413
+        {
414
+            nick: "Ned",
415
+            user: "martyn",
416
+            host: "10.0.0.18",
417
+            realname: "Unknown",
418
+            channels: ["@#purpledishwashers", "#blah", "#mmmmbacon"],
419
+            server: "*.dollyfish.net.nz",
420
+            serverinfo: "The Dollyfish Underworld",
421
+            operator: "is an IRC Operator"
422
+        }
423
+
424
+.. js:data:: 'channellist_start'
425
+
426
+    `function () {}`
427
+
428
+    Emitted whenever the server starts a new channel listing
429
+
430
+.. js:data:: 'channellist_item'
431
+
432
+   `function (channel_info) {}`
433
+
434
+   Emitted for each channel the server returns. The channel_info object
435
+   contains keys 'name', 'users' (number of users on the channel), and 'topic'.
436
+
437
+.. js:data:: 'channellist'
438
+
439
+   `function (channel_list) {}`
440
+
441
+   Emitted when the server has finished returning a channel list. The
442
+   channel_list array is simply a list of the objects that were returned in the
443
+   intervening `channellist_item` events.
444
+
445
+   This data is also available via the Client.channellist property after this
446
+   event has fired.
447
+
448
+.. js:data:: 'raw'
449
+
450
+    `function (message) { }`
451
+
452
+    Emitted when ever the client receives a "message" from the server. A message is
453
+    basically a single line of data from the server, but the parameter to the
454
+    callback has already been parsed and contains::
455
+
456
+        message = {
457
+            prefix: "The prefix for the message (optional)",
458
+            nick: "The nickname portion of the prefix (optional)",
459
+            user: "The username portion of the prefix (optional)",
460
+            host: "The hostname portion of the prefix (optional)",
461
+            server: "The servername (if the prefix was a servername)",
462
+            rawCommand: "The command exactly as sent from the server",
463
+            command: "Human readable version of the command",
464
+            commandType: "normal, error, or reply",
465
+            args: ['arguments', 'to', 'the', 'command'],
466
+        }
467
+
468
+    You can read more about the IRC protocol by reading `RFC 1459
469
+    <http://www.ietf.org/rfc/rfc1459.txt>`_
470
+
471
+.. js:data:: 'error'
472
+
473
+    `function (message) { }`
474
+
475
+    Emitted when ever the server responds with an error-type message. The message
476
+    parameter is exactly as in the 'raw' event.
477
+
478
+.. js:data:: 'action'
479
+
480
+    `function (from, to, text, message) { }`
481
+
482
+    Emitted whenever a user performs an action (e.g. `/me waves`).
483
+    The message parameter is exactly as in the 'raw' event.
484
+
485
+Colors
486
+------
487
+
488
+.. js:function:: irc.colors.wrap(color, text [, reset_color])
489
+
490
+    Takes a color by name, text, and optionally what color to return.
491
+
492
+    :param string color: the name of the color as a string
493
+    :param string text: the text you want colorized
494
+    :param string reset_color: the name of the color you want set after the text (defaults to 'reset')
495
+
496
+.. js:data:: irc.colors.codes
497
+
498
+    This contains the set of colors available and a function to wrap text in a
499
+    color.
500
+
501
+    The following color choices are available:
502
+
503
+    {
504
+        white: '\u000300',
505
+        black: '\u000301',
506
+        dark_blue: '\u000302',
507
+        dark_green: '\u000303',
508
+        light_red: '\u000304',
509
+        dark_red: '\u000305',
510
+        magenta: '\u000306',
511
+        orange: '\u000307',
512
+        yellow: '\u000308',
513
+        light_green: '\u000309',
514
+        cyan: '\u000310',
515
+        light_cyan: '\u000311',
516
+        light_blue: '\u000312',
517
+        light_magenta: '\u000313',
518
+        gray: '\u000314',
519
+        light_gray: '\u000315',
520
+        reset: '\u000f',
521
+    }
522
+
523
+Internal
524
+------
525
+
526
+.. js:data:: Client.conn
527
+
528
+    Socket to the server. Rarely, if ever needed. Use `Client.send` instead.
529
+
530
+.. js:data:: Client.chans
531
+
532
+    Channels joined. Includes channel modes, user list, and topic information. Only updated *after* the server recognizes the join.
533
+
534
+.. js:data:: Client.nick
535
+
536
+    The current nick of the client. Updated if the nick changes (e.g. nick collision when connecting to a server).
537
+
538
+.. js:function:: client._whoisData
539
+
540
+    Buffer of whois data as whois is sent over multiple lines.
541
+
542
+.. js:function:: client._addWhoisData
543
+
544
+    Self-explanatory.
545
+
546
+.. js:function:: client._clearWhoisData
547
+
548
+    Self-explanatory.
... ...
@@ -0,0 +1,130 @@
1
+# Makefile for Sphinx documentation
2
+#
3
+
4
+# You can set these variables from the command line.
5
+SPHINXOPTS    =
6
+SPHINXBUILD   = sphinx-build
7
+PAPER         =
8
+BUILDDIR      = _build
9
+
10
+# Internal variables.
11
+PAPEROPT_a4     = -D latex_paper_size=a4
12
+PAPEROPT_letter = -D latex_paper_size=letter
13
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
14
+
15
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
16
+
17
+help:
18
+	@echo "Please use \`make <target>' where <target> is one of"
19
+	@echo "  html       to make standalone HTML files"
20
+	@echo "  dirhtml    to make HTML files named index.html in directories"
21
+	@echo "  singlehtml to make a single large HTML file"
22
+	@echo "  pickle     to make pickle files"
23
+	@echo "  json       to make JSON files"
24
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
25
+	@echo "  qthelp     to make HTML files and a qthelp project"
26
+	@echo "  devhelp    to make HTML files and a Devhelp project"
27
+	@echo "  epub       to make an epub"
28
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
29
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
30
+	@echo "  text       to make text files"
31
+	@echo "  man        to make manual pages"
32
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
33
+	@echo "  linkcheck  to check all external links for integrity"
34
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
35
+
36
+clean:
37
+	-rm -rf $(BUILDDIR)/*
38
+
39
+html:
40
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
41
+	@echo
42
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
43
+
44
+dirhtml:
45
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
46
+	@echo
47
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
48
+
49
+singlehtml:
50
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
51
+	@echo
52
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
53
+
54
+pickle:
55
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
56
+	@echo
57
+	@echo "Build finished; now you can process the pickle files."
58
+
59
+json:
60
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
61
+	@echo
62
+	@echo "Build finished; now you can process the JSON files."
63
+
64
+htmlhelp:
65
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
66
+	@echo
67
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
68
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
69
+
70
+qthelp:
71
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
72
+	@echo
73
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
74
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
75
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/node-irc.qhcp"
76
+	@echo "To view the help file:"
77
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/node-irc.qhc"
78
+
79
+devhelp:
80
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
81
+	@echo
82
+	@echo "Build finished."
83
+	@echo "To view the help file:"
84
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/node-irc"
85
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/node-irc"
86
+	@echo "# devhelp"
87
+
88
+epub:
89
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
90
+	@echo
91
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
92
+
93
+latex:
94
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
95
+	@echo
96
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
97
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
98
+	      "(use \`make latexpdf' here to do that automatically)."
99
+
100
+latexpdf:
101
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
102
+	@echo "Running LaTeX files through pdflatex..."
103
+	make -C $(BUILDDIR)/latex all-pdf
104
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
105
+
106
+text:
107
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
108
+	@echo
109
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
110
+
111
+man:
112
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
113
+	@echo
114
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
115
+
116
+changes:
117
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
118
+	@echo
119
+	@echo "The overview file is in $(BUILDDIR)/changes."
120
+
121
+linkcheck:
122
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
123
+	@echo
124
+	@echo "Link check complete; look for any errors in the above output " \
125
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
126
+
127
+doctest:
128
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
129
+	@echo "Testing of doctests in the sources finished, look at the " \
130
+	      "results in $(BUILDDIR)/doctest/output.txt."
... ...
@@ -0,0 +1,216 @@
1
+# -*- coding: utf-8 -*-
2
+#
3
+# node-irc documentation build configuration file, created by
4
+# sphinx-quickstart on Sat Oct  1 00:02:31 2011.
5
+#
6
+# This file is execfile()d with the current directory set to its containing dir.
7
+#
8
+# Note that not all possible configuration values are present in this
9
+# autogenerated file.
10
+#
11
+# All configuration values have a default; values that are commented out
12
+# serve to show the default.
13
+
14
+import sys, os
15
+
16
+# If extensions (or modules to document with autodoc) are in another directory,
17
+# add these directories to sys.path here. If the directory is relative to the
18
+# documentation root, use os.path.abspath to make it absolute, like shown here.
19
+#sys.path.insert(0, os.path.abspath('.'))
20
+
21
+# -- General configuration -----------------------------------------------------
22
+
23
+# If your documentation needs a minimal Sphinx version, state it here.
24
+#needs_sphinx = '1.0'
25
+
26
+# Add any Sphinx extension module names here, as strings. They can be extensions
27
+# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
28
+extensions = []
29
+
30
+# Add any paths that contain templates here, relative to this directory.
31
+templates_path = ['_templates']
32
+
33
+# The suffix of source filenames.
34
+source_suffix = '.rst'
35
+
36
+# The encoding of source files.
37
+#source_encoding = 'utf-8-sig'
38
+
39
+# The master toctree document.
40
+master_doc = 'index'
41
+
42
+# General information about the project.
43
+project = u'node-irc'
44
+copyright = u'2011, Martyn Smith'
45
+
46
+# The version info for the project you're documenting, acts as replacement for
47
+# |version| and |release|, also used in various other places throughout the
48
+# built documents.
49
+#
50
+# The short X.Y version.
51
+version = '2.1'
52
+# The full version, including alpha/beta/rc tags.
53
+release = '2.1'
54
+
55
+# The language for content autogenerated by Sphinx. Refer to documentation
56
+# for a list of supported languages.
57
+#language = None
58
+
59
+# There are two options for replacing |today|: either, you set today to some
60
+# non-false value, then it is used:
61
+#today = ''
62
+# Else, today_fmt is used as the format for a strftime call.
63
+#today_fmt = '%B %d, %Y'
64
+
65
+# List of patterns, relative to source directory, that match files and
66
+# directories to ignore when looking for source files.
67
+exclude_patterns = ['_build']
68
+
69
+# The reST default role (used for this markup: `text`) to use for all documents.
70
+#default_role = None
71
+
72
+# If true, '()' will be appended to :func: etc. cross-reference text.
73
+#add_function_parentheses = True
74
+
75
+# If true, the current module name will be prepended to all description
76
+# unit titles (such as .. function::).
77
+#add_module_names = True
78
+
79
+# If true, sectionauthor and moduleauthor directives will be shown in the
80
+# output. They are ignored by default.
81
+#show_authors = False
82
+
83
+# The name of the Pygments (syntax highlighting) style to use.
84
+pygments_style = 'sphinx'
85
+
86
+# A list of ignored prefixes for module index sorting.
87
+#modindex_common_prefix = []
88
+
89
+
90
+# -- Options for HTML output ---------------------------------------------------
91
+
92
+# The theme to use for HTML and HTML Help pages.  See the documentation for
93
+# a list of builtin themes.
94
+html_theme = 'default'
95
+
96
+# Theme options are theme-specific and customize the look and feel of a theme
97
+# further.  For a list of options available for each theme, see the
98
+# documentation.
99
+#html_theme_options = {}
100
+
101
+# Add any paths that contain custom themes here, relative to this directory.
102
+#html_theme_path = []
103
+
104
+# The name for this set of Sphinx documents.  If None, it defaults to
105
+# "<project> v<release> documentation".
106
+#html_title = None
107
+
108
+# A shorter title for the navigation bar.  Default is the same as html_title.
109
+#html_short_title = None
110
+
111
+# The name of an image file (relative to this directory) to place at the top
112
+# of the sidebar.
113
+#html_logo = None
114
+
115
+# The name of an image file (within the static path) to use as favicon of the
116
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
117
+# pixels large.
118
+#html_favicon = None
119
+
120
+# Add any paths that contain custom static files (such as style sheets) here,
121
+# relative to this directory. They are copied after the builtin static files,
122
+# so a file named "default.css" will overwrite the builtin "default.css".
123
+html_static_path = ['_static']
124
+
125
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
126
+# using the given strftime format.
127
+#html_last_updated_fmt = '%b %d, %Y'
128
+
129
+# If true, SmartyPants will be used to convert quotes and dashes to
130
+# typographically correct entities.
131
+#html_use_smartypants = True
132
+
133
+# Custom sidebar templates, maps document names to template names.
134
+#html_sidebars = {}
135
+
136
+# Additional templates that should be rendered to pages, maps page names to
137
+# template names.
138
+#html_additional_pages = {}
139
+
140
+# If false, no module index is generated.
141
+#html_domain_indices = True
142
+
143
+# If false, no index is generated.
144
+#html_use_index = True
145
+
146
+# If true, the index is split into individual pages for each letter.
147
+#html_split_index = False
148
+
149
+# If true, links to the reST sources are added to the pages.
150
+#html_show_sourcelink = True
151
+
152
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
153
+#html_show_sphinx = True
154
+
155
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
156
+#html_show_copyright = True
157
+
158
+# If true, an OpenSearch description file will be output, and all pages will
159
+# contain a <link> tag referring to it.  The value of this option must be the
160
+# base URL from which the finished HTML is served.
161
+#html_use_opensearch = ''
162
+
163
+# This is the file name suffix for HTML files (e.g. ".xhtml").
164
+#html_file_suffix = None
165
+
166
+# Output file base name for HTML help builder.
167
+htmlhelp_basename = 'node-ircdoc'
168
+
169
+
170
+# -- Options for LaTeX output --------------------------------------------------
171
+
172
+# The paper size ('letter' or 'a4').
173
+#latex_paper_size = 'letter'
174
+
175
+# The font size ('10pt', '11pt' or '12pt').
176
+#latex_font_size = '10pt'
177
+
178
+# Grouping the document tree into LaTeX files. List of tuples
179
+# (source start file, target name, title, author, documentclass [howto/manual]).
180
+latex_documents = [
181
+  ('index', 'node-irc.tex', u'node-irc Documentation',
182
+   u'Martyn Smith', 'manual'),
183
+]
184
+
185
+# The name of an image file (relative to this directory) to place at the top of
186
+# the title page.
187
+#latex_logo = None
188
+
189
+# For "manual" documents, if this is true, then toplevel headings are parts,
190
+# not chapters.
191
+#latex_use_parts = False
192
+
193
+# If true, show page references after internal links.
194
+#latex_show_pagerefs = False
195
+
196
+# If true, show URL addresses after external links.
197
+#latex_show_urls = False
198
+
199
+# Additional stuff for the LaTeX preamble.
200
+#latex_preamble = ''
201
+
202
+# Documents to append as an appendix to all manuals.
203
+#latex_appendices = []
204
+
205
+# If false, no module index is generated.
206
+#latex_domain_indices = True
207
+
208
+
209
+# -- Options for manual page output --------------------------------------------
210
+
211
+# One entry per manual page. List of tuples
212
+# (source start file, name, description, authors, manual section).
213
+man_pages = [
214
+    ('index', 'node-irc', u'node-irc Documentation',
215
+     [u'Martyn Smith'], 1)
216
+]
... ...
@@ -0,0 +1,13 @@
1
+Welcome to node-irc's documentation!
2
+====================================
3
+
4
+.. include:: ../README.rst
5
+
6
+More detailed docs:
7
+-------------------
8
+
9
+.. toctree::
10
+   :maxdepth: 2
11
+
12
+   API
13
+
... ...
@@ -0,0 +1,170 @@
1
+@ECHO OFF
2
+
3
+REM Command file for Sphinx documentation
4
+
5
+if "%SPHINXBUILD%" == "" (
6
+	set SPHINXBUILD=sphinx-build
7
+)
8
+set BUILDDIR=_build
9
+set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
10
+if NOT "%PAPER%" == "" (
11
+	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
12
+)
13
+
14
+if "%1" == "" goto help
15
+
16
+if "%1" == "help" (
17
+	:help
18
+	echo.Please use `make ^<target^>` where ^<target^> is one of
19
+	echo.  html       to make standalone HTML files
20
+	echo.  dirhtml    to make HTML files named index.html in directories
21
+	echo.  singlehtml to make a single large HTML file
22
+	echo.  pickle     to make pickle files
23
+	echo.  json       to make JSON files
24
+	echo.  htmlhelp   to make HTML files and a HTML help project
25
+	echo.  qthelp     to make HTML files and a qthelp project
26
+	echo.  devhelp    to make HTML files and a Devhelp project
27
+	echo.  epub       to make an epub
28
+	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
29
+	echo.  text       to make text files
30
+	echo.  man        to make manual pages
31
+	echo.  changes    to make an overview over all changed/added/deprecated items
32
+	echo.  linkcheck  to check all external links for integrity
33
+	echo.  doctest    to run all doctests embedded in the documentation if enabled
34
+	goto end
35
+)
36
+
37
+if "%1" == "clean" (
38
+	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
39
+	del /q /s %BUILDDIR%\*
40
+	goto end
41
+)
42
+
43
+if "%1" == "html" (
44
+	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
45
+	if errorlevel 1 exit /b 1
46
+	echo.
47
+	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
48
+	goto end
49
+)
50
+
51
+if "%1" == "dirhtml" (
52
+	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
53
+	if errorlevel 1 exit /b 1
54
+	echo.
55
+	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
56
+	goto end
57
+)
58
+
59
+if "%1" == "singlehtml" (
60
+	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
61
+	if errorlevel 1 exit /b 1
62
+	echo.
63
+	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
64
+	goto end
65
+)
66
+
67
+if "%1" == "pickle" (
68
+	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
69
+	if errorlevel 1 exit /b 1
70
+	echo.
71
+	echo.Build finished; now you can process the pickle files.
72
+	goto end
73
+)
74
+
75
+if "%1" == "json" (
76
+	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
77
+	if errorlevel 1 exit /b 1
78
+	echo.
79
+	echo.Build finished; now you can process the JSON files.
80
+	goto end
81
+)
82
+
83
+if "%1" == "htmlhelp" (
84
+	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
85
+	if errorlevel 1 exit /b 1
86
+	echo.
87
+	echo.Build finished; now you can run HTML Help Workshop with the ^
88
+.hhp project file in %BUILDDIR%/htmlhelp.
89
+	goto end
90
+)
91
+
92
+if "%1" == "qthelp" (
93
+	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
94
+	if errorlevel 1 exit /b 1
95
+	echo.
96
+	echo.Build finished; now you can run "qcollectiongenerator" with the ^
97
+.qhcp project file in %BUILDDIR%/qthelp, like this:
98
+	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\node-irc.qhcp
99
+	echo.To view the help file:
100
+	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\node-irc.ghc
101
+	goto end
102
+)
103
+
104
+if "%1" == "devhelp" (
105
+	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
106
+	if errorlevel 1 exit /b 1
107
+	echo.
108
+	echo.Build finished.
109
+	goto end
110
+)
111
+
112
+if "%1" == "epub" (
113
+	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
114
+	if errorlevel 1 exit /b 1
115
+	echo.
116
+	echo.Build finished. The epub file is in %BUILDDIR%/epub.
117
+	goto end
118
+)
119
+
120
+if "%1" == "latex" (
121
+	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
122
+	if errorlevel 1 exit /b 1
123
+	echo.
124
+	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
125
+	goto end
126
+)
127
+
128
+if "%1" == "text" (
129
+	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
130
+	if errorlevel 1 exit /b 1
131
+	echo.
132
+	echo.Build finished. The text files are in %BUILDDIR%/text.
133
+	goto end
134
+)
135
+
136
+if "%1" == "man" (
137
+	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
138
+	if errorlevel 1 exit /b 1
139
+	echo.
140
+	echo.Build finished. The manual pages are in %BUILDDIR%/man.
141
+	goto end
142
+)
143
+
144
+if "%1" == "changes" (
145
+	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
146
+	if errorlevel 1 exit /b 1
147
+	echo.
148
+	echo.The overview file is in %BUILDDIR%/changes.
149
+	goto end
150
+)
151
+
152
+if "%1" == "linkcheck" (
153
+	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
154
+	if errorlevel 1 exit /b 1
155
+	echo.
156
+	echo.Link check complete; look for any errors in the above output ^
157
+or in %BUILDDIR%/linkcheck/output.txt.
158
+	goto end
159
+)
160
+
161
+if "%1" == "doctest" (
162
+	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
163
+	if errorlevel 1 exit /b 1
164
+	echo.
165
+	echo.Testing of doctests in the sources finished, look at the ^
166
+results in %BUILDDIR%/doctest/output.txt.
167
+	goto end
168
+)
169
+
170
+:end
... ...
@@ -0,0 +1,49 @@
1
+#!/usr/bin/env node
2
+
3
+var irc = require('../');
4
+
5
+var bot = new irc.Client('irc.dollyfish.net.nz', 'nodebot', {
6
+    debug: true,
7
+    channels: ['#test', '#othertest']
8
+});
9
+
10
+bot.addListener('error', function(message) {
11
+    console.error('ERROR: %s: %s', message.command, message.args.join(' '));
12
+});
13
+
14
+bot.addListener('message#blah', function(from, message) {
15
+    console.log('<%s> %s', from, message);
16
+});
17
+
18
+bot.addListener('message', function(from, to, message) {
19
+    console.log('%s => %s: %s', from, to, message);
20
+
21
+    if (to.match(/^[#&]/)) {
22
+        // channel message
23
+        if (message.match(/hello/i)) {
24
+            bot.say(to, 'Hello there ' + from);
25
+        }
26
+        if (message.match(/dance/)) {
27
+            setTimeout(function() { bot.say(to, '\u0001ACTION dances: :D\\-<\u0001'); }, 1000);
28
+            setTimeout(function() { bot.say(to, '\u0001ACTION dances: :D|-<\u0001');  }, 2000);
29
+            setTimeout(function() { bot.say(to, '\u0001ACTION dances: :D/-<\u0001');  }, 3000);
30
+            setTimeout(function() { bot.say(to, '\u0001ACTION dances: :D|-<\u0001');  }, 4000);
31
+        }
32
+    }
33
+    else {
34
+        // private message
35
+        console.log('private message');
36
+    }
37
+});
38
+bot.addListener('pm', function(nick, message) {
39
+    console.log('Got private message from %s: %s', nick, message);
40
+});
41
+bot.addListener('join', function(channel, who) {
42
+    console.log('%s has joined %s', who, channel);
43
+});
44
+bot.addListener('part', function(channel, who, reason) {
45
+    console.log('%s has left %s: %s', who, channel, reason);
46
+});
47
+bot.addListener('kick', function(channel, who, by, reason) {
48
+    console.log('%s was kicked from %s by %s: %s', who, channel, by, reason);
49
+});
... ...
@@ -0,0 +1,63 @@
1
+#!/usr/bin/env node
2
+
3
+var irc = require('../');
4
+/*
5
+* To set the key/cert explicitly, you could do the following
6
+var fs = require('fs');
7
+
8
+var options = {
9
+  key: fs.readFileSync('privkey.pem'),
10
+  cert: fs.readFileSync('certificate.crt')
11
+};
12
+*/
13
+
14
+// Or to just use defaults
15
+var options = true;
16
+
17
+var bot = new irc.Client('chat.us.freenode.net', 'nodebot', {
18
+	port: 6697,
19
+    debug: true,
20
+	secure: options,
21
+    channels: ['#botwar']
22
+});
23
+
24
+bot.addListener('error', function(message) {
25
+    console.error('ERROR: %s: %s', message.command, message.args.join(' '));
26
+});
27
+
28
+bot.addListener('message#blah', function(from, message) {
29
+    console.log('<%s> %s', from, message);
30
+});
31
+
32
+bot.addListener('message', function(from, to, message) {
33
+    console.log('%s => %s: %s', from, to, message);
34
+
35
+    if (to.match(/^[#&]/)) {
36
+        // channel message
37
+        if (message.match(/hello/i)) {
38
+            bot.say(to, 'Hello there ' + from);
39
+        }
40
+        if (message.match(/dance/)) {
41
+            setTimeout(function() { bot.say(to, '\u0001ACTION dances: :D\\-<\u0001'); }, 1000);
42
+            setTimeout(function() { bot.say(to, '\u0001ACTION dances: :D|-<\u0001');  }, 2000);
43
+            setTimeout(function() { bot.say(to, '\u0001ACTION dances: :D/-<\u0001');  }, 3000);
44
+            setTimeout(function() { bot.say(to, '\u0001ACTION dances: :D|-<\u0001');  }, 4000);
45
+        }
46
+    }
47
+    else {
48
+        // private message
49
+        console.log('private message');
50
+    }
51
+});
52
+bot.addListener('pm', function(nick, message) {
53
+    console.log('Got private message from %s: %s', nick, message);
54
+});
55
+bot.addListener('join', function(channel, who) {
56
+    console.log('%s has joined %s', who, channel);
57
+});
58
+bot.addListener('part', function(channel, who, reason) {
59
+    console.log('%s has left %s: %s', who, channel, reason);
60
+});
61
+bot.addListener('kick', function(channel, who, by, reason) {
62
+    console.log('%s was kicked from %s by %s: %s', who, channel, by, reason);
63
+});
... ...
@@ -0,0 +1,514 @@
1
+module.exports = {
2
+   '001': {
3
+      name: 'rpl_welcome',
4
+      type: 'reply'
5
+   },
6
+   '002': {
7
+      name: 'rpl_yourhost',
8
+      type: 'reply'
9
+   },
10
+   '003': {
11
+      name: 'rpl_created',
12
+      type: 'reply'
13
+   },
14
+   '004': {
15
+      name: 'rpl_myinfo',
16
+      type: 'reply'
17
+   },
18
+   '005': {
19
+      name: 'rpl_isupport',
20
+      type: 'reply'
21
+   },
22
+   200: {
23
+      name: 'rpl_tracelink',
24
+      type: 'reply'
25
+   },
26
+   201: {
27
+      name: 'rpl_traceconnecting',
28
+      type: 'reply'
29
+   },
30
+   202: {
31
+      name: 'rpl_tracehandshake',
32
+      type: 'reply'
33
+   },
34
+   203: {
35
+      name: 'rpl_traceunknown',
36
+      type: 'reply'
37
+   },
38
+   204: {
39
+      name: 'rpl_traceoperator',
40
+      type: 'reply'
41
+   },
42
+   205: {
43
+      name: 'rpl_traceuser',
44
+      type: 'reply'
45
+   },
46
+   206: {
47
+      name: 'rpl_traceserver',
48
+      type: 'reply'
49
+   },
50
+   208: {
51
+      name: 'rpl_tracenewtype',
52
+      type: 'reply'
53
+   },
54
+   211: {
55
+      name: 'rpl_statslinkinfo',
56
+      type: 'reply'
57
+   },
58
+   212: {
59
+      name: 'rpl_statscommands',
60
+      type: 'reply'
61
+   },
62
+   213: {
63
+      name: 'rpl_statscline',
64
+      type: 'reply'
65
+   },
66
+   214: {
67
+      name: 'rpl_statsnline',
68
+      type: 'reply'
69
+   },
70
+   215: {
71
+      name: 'rpl_statsiline',
72
+      type: 'reply'
73
+   },
74
+   216: {
75
+      name: 'rpl_statskline',
76
+      type: 'reply'
77
+   },
78
+   218: {
79
+      name: 'rpl_statsyline',
80
+      type: 'reply'
81
+   },
82
+   219: {
83
+      name: 'rpl_endofstats',
84
+      type: 'reply'
85
+   },
86
+   221: {
87
+      name: 'rpl_umodeis',
88
+      type: 'reply'
89
+   },
90
+   241: {
91
+      name: 'rpl_statslline',
92
+      type: 'reply'
93
+   },
94
+   242: {
95
+      name: 'rpl_statsuptime',
96
+      type: 'reply'
97
+   },
98
+   243: {
99
+      name: 'rpl_statsoline',
100
+      type: 'reply'
101
+   },
102
+   244: {
103
+      name: 'rpl_statshline',
104
+      type: 'reply'
105
+   },
106
+   250: {
107
+      name: 'rpl_statsconn',
108
+      type: 'reply'
109
+   },
110
+   251: {
111
+      name: 'rpl_luserclient',
112
+      type: 'reply'
113
+   },
114
+   252: {
115
+      name: 'rpl_luserop',
116
+      type: 'reply'
117
+   },
118
+   253: {
119
+      name: 'rpl_luserunknown',
120
+      type: 'reply'
121
+   },
122
+   254: {
123
+      name: 'rpl_luserchannels',
124
+      type: 'reply'
125
+   },
126
+   255: {
127
+      name: 'rpl_luserme',
128
+      type: 'reply'
129
+   },
130
+   256: {
131
+      name: 'rpl_adminme',
132
+      type: 'reply'
133
+   },
134
+   257: {
135
+      name: 'rpl_adminloc1',
136
+      type: 'reply'
137
+   },
138
+   258: {
139
+      name: 'rpl_adminloc2',
140
+      type: 'reply'
141
+   },
142
+   259: {
143
+      name: 'rpl_adminemail',
144
+      type: 'reply'
145
+   },
146
+   261: {
147
+      name: 'rpl_tracelog',
148
+      type: 'reply'
149
+   },
150
+   265: {
151
+      name: 'rpl_localusers',
152
+      type: 'reply'
153
+   },
154
+   266: {
155
+      name: 'rpl_globalusers',
156
+      type: 'reply'
157
+   },
158
+   300: {
159
+      name: 'rpl_none',
160
+      type: 'reply'
161
+   },
162
+   301: {
163
+      name: 'rpl_away',
164
+      type: 'reply'
165
+   },
166
+   302: {
167
+      name: 'rpl_userhost',
168
+      type: 'reply'
169
+   },
170
+   303: {
171
+      name: 'rpl_ison',
172
+      type: 'reply'
173
+   },
174
+   305: {
175
+      name: 'rpl_unaway',
176
+      type: 'reply'
177
+   },
178
+   306: {
179
+      name: 'rpl_nowaway',
180
+      type: 'reply'
181
+   },
182
+   311: {
183
+      name: 'rpl_whoisuser',
184
+      type: 'reply'
185
+   },
186
+   312: {
187
+      name: 'rpl_whoisserver',
188
+      type: 'reply'
189
+   },
190
+   313: {
191
+      name: 'rpl_whoisoperator',
192
+      type: 'reply'
193
+   },
194
+   314: {
195
+      name: 'rpl_whowasuser',
196
+      type: 'reply'
197
+   },
198
+   315: {
199
+      name: 'rpl_endofwho',
200
+      type: 'reply'
201
+   },
202
+   317: {
203
+      name: 'rpl_whoisidle',
204
+      type: 'reply'
205
+   },
206
+   318: {
207
+      name: 'rpl_endofwhois',
208
+      type: 'reply'
209
+   },
210
+   319: {
211
+      name: 'rpl_whoischannels',
212
+      type: 'reply'
213
+   },
214
+   321: {
215
+      name: 'rpl_liststart',
216
+      type: 'reply'
217
+   },
218
+   322: {
219
+      name: 'rpl_list',
220
+      type: 'reply'
221
+   },
222
+   323: {
223
+      name: 'rpl_listend',
224
+      type: 'reply'
225
+   },
226
+   324: {
227
+      name: 'rpl_channelmodeis',
228
+      type: 'reply'
229
+   },
230
+   329: {
231
+      name: 'rpl_creationtime',
232
+      type: 'reply'
233
+   },
234
+   331: {
235
+      name: 'rpl_notopic',
236
+      type: 'reply'
237
+   },
238
+   332: {
239
+      name: 'rpl_topic',
240
+      type: 'reply'
241
+   },
242
+   333: {
243
+      name: 'rpl_topicwhotime',
244
+      type: 'reply'
245
+   },
246
+   341: {
247
+      name: 'rpl_inviting',
248
+      type: 'reply'
249
+   },
250
+   342: {
251
+      name: 'rpl_summoning',
252
+      type: 'reply'
253
+   },
254
+   351: {
255
+      name: 'rpl_version',
256
+      type: 'reply'
257
+   },
258
+   352: {
259
+      name: 'rpl_whoreply',
260
+      type: 'reply'
261
+   },
262
+   353: {
263
+      name: 'rpl_namreply',
264
+      type: 'reply'
265
+   },
266
+   364: {
267
+      name: 'rpl_links',
268
+      type: 'reply'
269
+   },
270
+   365: {
271
+      name: 'rpl_endoflinks',
272
+      type: 'reply'
273
+   },
274
+   366: {
275
+      name: 'rpl_endofnames',
276
+      type: 'reply'
277
+   },
278
+   367: {
279
+      name: 'rpl_banlist',
280
+      type: 'reply'
281
+   },
282
+   368: {
283
+      name: 'rpl_endofbanlist',
284
+      type: 'reply'
285
+   },
286
+   369: {
287
+      name: 'rpl_endofwhowas',
288
+      type: 'reply'
289
+   },
290
+   371: {
291
+      name: 'rpl_info',
292
+      type: 'reply'
293
+   },
294
+   372: {
295
+      name: 'rpl_motd',
296
+      type: 'reply'
297
+   },
298
+   374: {
299
+      name: 'rpl_endofinfo',
300
+      type: 'reply'
301
+   },
302
+   375: {
303
+      name: 'rpl_motdstart',
304
+      type: 'reply'
305
+   },
306
+   376: {
307
+      name: 'rpl_endofmotd',
308
+      type: 'reply'
309
+   },
310
+   381: {
311
+      name: 'rpl_youreoper',
312
+      type: 'reply'
313
+   },
314
+   382: {
315
+      name: 'rpl_rehashing',
316
+      type: 'reply'
317
+   },
318
+   391: {
319
+      name: 'rpl_time',
320
+      type: 'reply'
321
+   },
322
+   392: {
323
+      name: 'rpl_usersstart',
324
+      type: 'reply'
325
+   },
326
+   393: {
327
+      name: 'rpl_users',
328
+      type: 'reply'
329
+   },
330
+   394: {
331
+      name: 'rpl_endofusers',
332
+      type: 'reply'
333
+   },
334
+   395: {
335
+      name: 'rpl_nousers',
336
+      type: 'reply'
337
+   },
338
+   401: {
339
+      name: 'err_nosuchnick',
340
+      type: 'error'
341
+   },
342
+   402: {
343
+      name: 'err_nosuchserver',
344
+      type: 'error'
345
+   },
346
+   403: {
347
+      name: 'err_nosuchchannel',
348
+      type: 'error'
349
+   },
350
+   404: {
351
+      name: 'err_cannotsendtochan',
352
+      type: 'error'
353
+   },
354
+   405: {
355
+      name: 'err_toomanychannels',
356
+      type: 'error'
357
+   },
358
+   406: {
359
+      name: 'err_wasnosuchnick',
360
+      type: 'error'
361
+   },
362
+   407: {
363
+      name: 'err_toomanytargets',
364
+      type: 'error'
365
+   },
366
+   409: {
367
+      name: 'err_noorigin',
368
+      type: 'error'
369
+   },
370
+   411: {
371
+      name: 'err_norecipient',
372
+      type: 'error'
373
+   },
374
+   412: {
375
+      name: 'err_notexttosend',
376
+      type: 'error'
377
+   },
378
+   413: {
379
+      name: 'err_notoplevel',
380
+      type: 'error'
381
+   },
382
+   414: {
383
+      name: 'err_wildtoplevel',
384
+      type: 'error'
385
+   },
386
+   421: {
387
+      name: 'err_unknowncommand',
388
+      type: 'error'
389
+   },
390
+   422: {
391
+      name: 'err_nomotd',
392
+      type: 'error'
393
+   },
394
+   423: {
395
+      name: 'err_noadmininfo',
396
+      type: 'error'
397
+   },
398
+   424: {
399
+      name: 'err_fileerror',
400
+      type: 'error'
401
+   },
402
+   431: {
403
+      name: 'err_nonicknamegiven',
404
+      type: 'error'
405
+   },
406
+   432: {
407
+      name: 'err_erroneusnickname',
408
+      type: 'error'
409
+   },
410
+   433: {
411
+      name: 'err_nicknameinuse',
412
+      type: 'error'
413
+   },
414
+   436: {
415
+      name: 'err_nickcollision',
416
+      type: 'error'
417
+   },
418
+   441: {
419
+      name: 'err_usernotinchannel',
420
+      type: 'error'
421
+   },
422
+   442: {
423
+      name: 'err_notonchannel',
424
+      type: 'error'
425
+   },
426
+   443: {
427
+      name: 'err_useronchannel',
428
+      type: 'error'
429
+   },
430
+   444: {
431
+      name: 'err_nologin',
432
+      type: 'error'
433
+   },
434
+   445: {
435
+      name: 'err_summondisabled',
436
+      type: 'error'
437
+   },
438
+   446: {
439
+      name: 'err_usersdisabled',
440
+      type: 'error'
441
+   },
442
+   451: {
443
+      name: 'err_notregistered',
444
+      type: 'error'
445
+   },
446
+   461: {
447
+      name: 'err_needmoreparams',
448
+      type: 'error'
449
+   },
450
+   462: {
451
+      name: 'err_alreadyregistred',
452
+      type: 'error'
453
+   },
454
+   463: {
455
+      name: 'err_nopermforhost',
456
+      type: 'error'
457
+   },
458
+   464: {
459
+      name: 'err_passwdmismatch',
460
+      type: 'error'
461
+   },
462
+   465: {
463
+      name: 'err_yourebannedcreep',
464
+      type: 'error'
465
+   },
466
+   467: {
467
+      name: 'err_keyset',
468
+      type: 'error'
469
+   },
470
+   471: {
471
+      name: 'err_channelisfull',
472
+      type: 'error'
473
+   },
474
+   472: {
475
+      name: 'err_unknownmode',
476
+      type: 'error'
477
+   },
478
+   473: {
479
+      name: 'err_inviteonlychan',
480
+      type: 'error'
481
+   },
482
+   474: {
483
+      name: 'err_bannedfromchan',
484
+      type: 'error'
485
+   },
486
+   475: {
487
+      name: 'err_badchannelkey',
488
+      type: 'error'
489
+   },
490
+   481: {
491
+      name: 'err_noprivileges',
492
+      type: 'error'
493
+   },
494
+   482: {
495
+      name: 'err_chanoprivsneeded',
496
+      type: 'error'
497
+   },
498
+   483: {
499
+      name: 'err_cantkillserver',
500
+      type: 'error'
501
+   },
502
+   491: {
503
+      name: 'err_nooperhost',
504
+      type: 'error'
505
+   },
506
+   501: {
507
+      name: 'err_umodeunknownflag',
508
+      type: 'error'
509
+   },
510
+   502: {
511
+      name: 'err_usersdontmatch',
512
+      type: 'error'
513
+   }
514
+};
... ...
@@ -0,0 +1,33 @@
1
+var codes = {
2
+    white: '\u000300',
3
+    black: '\u000301',
4
+    dark_blue: '\u000302',
5
+    dark_green: '\u000303',
6
+    light_red: '\u000304',
7
+    dark_red: '\u000305',
8
+    magenta: '\u000306',
9
+    orange: '\u000307',
10
+    yellow: '\u000308',
11
+    light_green: '\u000309',
12
+    cyan: '\u000310',
13
+    light_cyan: '\u000311',
14
+    light_blue: '\u000312',
15
+    light_magenta: '\u000313',
16
+    gray: '\u000314',
17
+    light_gray: '\u000315',
18
+
19
+    bold: '\u0002',
20
+    underline: '\u001f',
21
+
22
+    reset: '\u000f'
23
+};
24
+exports.codes = codes;
25
+
26
+function wrap(color, text, resetColor) {
27
+    if (codes[color]) {
28
+        text = codes[color] + text;
29
+        text += (codes[resetColor]) ? codes[resetColor] : codes.reset;
30
+    }
31
+    return text;
32
+}
33
+exports.wrap = wrap;
... ...
@@ -0,0 +1,87 @@
1
+'use strict';
2
+
3
+var util = require('util');
4
+var EventEmitter = require('events').EventEmitter;
5
+
6
+/**
7
+ * This class encapsulates the ping timeout functionality. When enough
8
+ * silence (lack of server-sent activity) time passes, an object of this type
9
+ * will emit a 'wantPing' event, indicating you should send a PING message
10
+ * to the server in order to get some signs of life from it. If enough
11
+ * time passes after that (i.e. server does not respond to PING), then
12
+ * an object of this type will emit a 'pingTimeout' event.
13
+ *
14
+ * To start the gears turning, call start() on an instance of this class To
15
+ * put it in the 'started' state.
16
+ *
17
+ * When server-side activity occurs, call notifyOfActivity() on the object.
18
+ *
19
+ * When a pingTimeout occurs, the object will go into the 'stopped' state.
20
+ */
21
+var ctr = 0;
22
+
23
+function CyclingPingTimer(client) {
24
+    var timerNumber = ctr++;
25
+    var started = false;
26
+    var self = this;
27
+
28
+    // Only one of these two should be non-null at any given time.
29
+    var loopingTimeout = null;
30
+    var pingWaitTimeout = null;
31
+
32
+    // conditionally log debug messages
33
+    function debug(msg) {
34
+        if (client.opt.debug) {
35
+            console.error('CyclingPingTimer ' + timerNumber + ': ' + msg);
36
+        }
37
+    }
38
+
39
+    // set up EventEmitter functionality
40
+    EventEmitter.call(self);
41
+
42
+    self.on('wantPing', function() {
43
+        debug('server silent for too long, let\'s send a PING');
44
+        pingWaitTimeout = setTimeout(function() {
45
+            self.stop();
46
+            debug('ping timeout!');
47
+            self.emit('pingTimeout');
48
+        }, client.opt.millisecondsBeforePingTimeout);
49
+    });
50
+
51
+    self.notifyOfActivity = function() {
52
+        if (started) {
53
+            self.stop();
54
+            self.start();
55
+        }
56
+    };
57
+
58
+    self.stop = function() {
59
+        if (!started) {
60
+            return;
61
+        }
62
+        started = false;
63
+
64
+        clearTimeout(loopingTimeout);
65
+        clearTimeout(pingWaitTimeout);
66
+
67
+        loopingTimeout = null;
68
+        pingWaitTimeout = null;
69
+    };
70
+
71
+    self.start = function() {
72
+        if (started) {
73
+            debug('can\'t start, not stopped!');
74
+            return;
75
+        }
76
+        started = true;
77
+
78
+        loopingTimeout = setTimeout(function() {
79
+            loopingTimeout = null;
80
+            self.emit('wantPing');
81
+        }, client.opt.millisecondsOfSilenceBeforePingSent);
82
+    };
83
+}
84
+
85
+util.inherits(CyclingPingTimer, EventEmitter);
86
+
87
+module.exports = CyclingPingTimer;
... ...
@@ -0,0 +1,1162 @@
1
+/*
2
+    irc.js - Node JS IRC client library
3
+
4
+    (C) Copyright Martyn Smith 2010
5
+
6
+    This library is free software: you can redistribute it and/or modify
7
+    it under the terms of the GNU General Public License as published by
8
+    the Free Software Foundation, either version 3 of the License, or
9
+    (at your option) any later version.
10
+
11
+    This library is distributed in the hope that it will be useful,
12
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
13
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14
+    GNU General Public License for more details.
15
+
16
+    You should have received a copy of the GNU General Public License
17
+    along with this library.  If not, see <http://www.gnu.org/licenses/>.
18
+*/
19
+
20
+exports.Client = Client;
21
+var net  = require('net');
22
+var tls  = require('tls');
23
+var util = require('util');
24
+var EventEmitter = require('events').EventEmitter;
25
+
26
+var colors = require('./colors');
27
+var parseMessage = require('./parse_message');
28
+exports.colors = colors;
29
+var CyclingPingTimer = require('./cycling_ping_timer.js');
30
+
31
+var lineDelimiter = new RegExp('\r\n|\r|\n')
32
+
33
+function Client(server, nick, opt) {
34
+    var self = this;
35
+    self.opt = {
36
+        server: server,
37
+        nick: nick,
38
+        password: null,
39
+        userName: 'nodebot',
40
+        realName: 'nodeJS IRC client',
41
+        port: 6667,
42
+        localAddress: null,
43
+        debug: false,
44
+        showErrors: false,
45
+        autoRejoin: false,
46
+        autoConnect: true,
47
+        channels: [],
48
+        retryCount: null,
49
+        retryDelay: 2000,
50
+        secure: false,
51
+        selfSigned: false,
52
+        certExpired: false,
53
+        floodProtection: false,
54
+        floodProtectionDelay: 1000,
55
+        sasl: false,
56
+        stripColors: false,
57
+        channelPrefixes: '&#',
58
+        messageSplit: 512,
59
+        encoding: false,
60
+        webirc: {
61
+          pass: '',
62
+          ip: '',
63
+          host: ''
64
+        },
65
+        millisecondsOfSilenceBeforePingSent: 15 * 1000,
66
+        millisecondsBeforePingTimeout: 8 * 1000
67
+    };
68
+
69
+    // Features supported by the server
70
+    // (initial values are RFC 1459 defaults. Zeros signify
71
+    // no default or unlimited value)
72
+    self.supported = {
73
+        channel: {
74
+            idlength: [],
75
+            length: 200,
76
+            limit: [],
77
+            modes: { a: '', b: '', c: '', d: ''},
78
+            types: self.opt.channelPrefixes
79
+        },
80
+        kicklength: 0,
81
+        maxlist: [],
82
+        maxtargets: [],
83
+        modes: 3,
84
+        nicklength: 9,
85
+        topiclength: 0,
86
+        usermodes: ''
87
+    };
88
+
89
+    if (typeof arguments[2] == 'object') {
90
+        var keys = Object.keys(self.opt);
91
+        for (var i = 0; i < keys.length; i++) {
92
+            var k = keys[i];
93
+            if (arguments[2][k] !== undefined)
94
+                self.opt[k] = arguments[2][k];
95
+        }
96
+    }
97
+
98
+    if (self.opt.floodProtection) {
99
+        self.activateFloodProtection();
100
+    }
101
+
102
+    self.hostMask = '';
103
+
104
+    // TODO - fail if nick or server missing
105
+    // TODO - fail if username has a space in it
106
+    if (self.opt.autoConnect === true) {
107
+        self.connect();
108
+    }
109
+
110
+    self.addListener('raw', function(message) {
111
+        var channels = [],
112
+            channel,
113
+            nick,
114
+            from,
115
+            text,
116
+            to;
117
+
118
+        switch (message.command) {
119
+            case 'rpl_welcome':
120
+                // Set nick to whatever the server decided it really is
121
+                // (normally this is because you chose something too long and
122
+                // the server has shortened it
123
+                self.nick = message.args[0];
124
+                // Note our hostmask to use it in splitting long messages.
125
+                // We don't send our hostmask when issuing PRIVMSGs or NOTICEs,
126
+                // of course, but rather the servers on the other side will
127
+                // include it in messages and will truncate what we send if
128
+                // the string is too long. Therefore, we need to be considerate
129
+                // neighbors and truncate our messages accordingly.
130
+                var welcomeStringWords = message.args[1].split(/\s+/);
131
+                self.hostMask = welcomeStringWords[welcomeStringWords.length - 1];
132
+                self._updateMaxLineLength();
133
+                self.emit('registered', message);
134
+                self.whois(self.nick, function(args) {
135
+                    self.nick = args.nick;
136
+                    self.hostMask = args.user + '@' + args.host;
137
+                    self._updateMaxLineLength();
138
+                });
139
+                break;
140
+            case 'rpl_myinfo':
141
+                self.supported.usermodes = message.args[3];
142
+                break;
143
+            case 'rpl_isupport':
144
+                message.args.forEach(function(arg) {
145
+                    var match;
146
+                    match = arg.match(/([A-Z]+)=(.*)/);
147
+                    if (match) {
148
+                        var param = match[1];
149
+                        var value = match[2];
150
+                        switch (param) {
151
+                            case 'CHANLIMIT':
152
+                                value.split(',').forEach(function(val) {
153
+                                    val = val.split(':');
154
+                                    self.supported.channel.limit[val[0]] = parseInt(val[1]);
155
+                                });
156
+                                break;
157
+                            case 'CHANMODES':
158
+                                value = value.split(',');
159
+                                var type = ['a', 'b', 'c', 'd'];
160
+                                for (var i = 0; i < type.length; i++) {
161
+                                    self.supported.channel.modes[type[i]] += value[i];
162
+                                }
163
+                                break;
164
+                            case 'CHANTYPES':
165
+                                self.supported.channel.types = value;
166
+                                break;
167
+                            case 'CHANNELLEN':
168
+                                self.supported.channel.length = parseInt(value);
169
+                                break;
170
+                            case 'IDCHAN':
171
+                                value.split(',').forEach(function(val) {
172
+                                    val = val.split(':');
173
+                                    self.supported.channel.idlength[val[0]] = val[1];
174
+                                });
175
+                                break;
176
+                            case 'KICKLEN':
177
+                                self.supported.kicklength = value;
178
+                                break;
179
+                            case 'MAXLIST':
180
+                                value.split(',').forEach(function(val) {
181
+                                    val = val.split(':');
182
+                                    self.supported.maxlist[val[0]] = parseInt(val[1]);
183
+                                });
184
+                                break;
185
+                            case 'NICKLEN':
186
+                                self.supported.nicklength = parseInt(value);
187
+                                break;
188
+                            case 'PREFIX':
189
+                                match = value.match(/\((.*?)\)(.*)/);
190
+                                if (match) {
191
+                                    match[1] = match[1].split('');
192
+                                    match[2] = match[2].split('');
193
+                                    while (match[1].length) {
194
+                                        self.modeForPrefix[match[2][0]] = match[1][0];
195
+                                        self.supported.channel.modes.b += match[1][0];
196
+                                        self.prefixForMode[match[1].shift()] = match[2].shift();
197
+                                    }
198
+                                }
199
+                                break;
200
+                            case 'STATUSMSG':
201
+                                break;
202
+                            case 'TARGMAX':
203
+                                value.split(',').forEach(function(val) {
204
+                                    val = val.split(':');
205
+                                    val[1] = (!val[1]) ? 0 : parseInt(val[1]);
206
+                                    self.supported.maxtargets[val[0]] = val[1];
207
+                                });
208
+                                break;
209
+                            case 'TOPICLEN':
210
+                                self.supported.topiclength = parseInt(value);
211
+                                break;
212
+                        }
213
+                    }
214
+                });
215
+                break;
216
+            case 'rpl_yourhost':
217
+            case 'rpl_created':
218
+            case 'rpl_luserclient':
219
+            case 'rpl_luserop':
220
+            case 'rpl_luserchannels':
221
+            case 'rpl_luserme':
222
+            case 'rpl_localusers':
223
+            case 'rpl_globalusers':
224
+            case 'rpl_statsconn':
225
+            case 'rpl_luserunknown':
226
+            case '396':
227
+            case '042':
228
+                // Random welcome crap, ignoring
229
+                break;
230
+            case 'err_nicknameinuse':
231
+                if (typeof (self.opt.nickMod) == 'undefined')
232
+                    self.opt.nickMod = 0;
233
+                self.opt.nickMod++;
234
+                self.send('NICK', self.opt.nick + self.opt.nickMod);
235
+                self.nick = self.opt.nick + self.opt.nickMod;
236
+                self._updateMaxLineLength();
237
+                break;
238
+            case 'PING':
239
+                self.send('PONG', message.args[0]);
240
+                self.emit('ping', message.args[0]);
241
+                break;
242
+            case 'PONG':
243
+                self.emit('pong', message.args[0]);
244
+                break;
245
+            case 'NOTICE':
246
+                from = message.nick;
247
+                to = message.args[0];
248
+                if (!to) {
249
+                    to = null;
250
+                }
251
+                text = message.args[1] || '';
252
+                if (text[0] === '\u0001' && text.lastIndexOf('\u0001') > 0) {
253
+                    self._handleCTCP(from, to, text, 'notice', message);
254
+                    break;
255
+                }
256
+                self.emit('notice', from, to, text, message);
257
+
258
+                if (self.opt.debug && to == self.nick)
259
+                    util.log('GOT NOTICE from ' + (from ? '"' + from + '"' : 'the server') + ': "' + text + '"');
260
+                break;
261
+            case 'MODE':
262
+                if (self.opt.debug)
263
+                    util.log('MODE: ' + message.args[0] + ' sets mode: ' + message.args[1]);
264
+
265
+                channel = self.chanData(message.args[0]);
266
+                if (!channel) break;
267
+                var modeList = message.args[1].split('');
268
+                var adding = true;
269
+                var modeArgs = message.args.slice(2);
270
+                modeList.forEach(function(mode) {
271
+                    if (mode == '+') {
272
+                        adding = true;
273
+                        return;
274
+                    }
275
+                    if (mode == '-') {
276
+                        adding = false;
277
+                        return;
278
+                    }
279
+
280
+                    var eventName = (adding ? '+' : '-') + 'mode';
281
+                    var supported = self.supported.channel.modes;
282
+                    var modeArg;
283
+                    var chanModes = function(mode, param) {
284
+                        var arr = param && Array.isArray(param);
285
+                        if (adding) {
286
+                            if (channel.mode.indexOf(mode) == -1) {
287
+                                channel.mode += mode;
288
+                            }
289
+                            if (param === undefined) {
290
+                                channel.modeParams[mode] = [];
291
+                            } else if (arr) {
292
+                                channel.modeParams[mode] = channel.modeParams[mode] ?
293
+                                    channel.modeParams[mode].concat(param) : param;
294
+                            } else {
295
+                                channel.modeParams[mode] = [param];
296
+                            }
297
+                        } else {
298
+                            if (arr) {
299
+                                channel.modeParams[mode] = channel.modeParams[mode]
300
+                                    .filter(function(v) { return v !== param[0]; });
301
+                            }
302
+                            if (!arr || channel.modeParams[mode].length === 0) {
303
+                                channel.mode = channel.mode.replace(mode, '');
304
+                                delete channel.modeParams[mode];
305
+                            }
306
+                        }
307
+                    };
308
+                    if (mode in self.prefixForMode) {
309
+                        modeArg = modeArgs.shift();
310
+                        if (channel.users.hasOwnProperty(modeArg)) {
311
+                            if (adding) {
312
+                                if (channel.users[modeArg].indexOf(self.prefixForMode[mode]) === -1)
313
+                                    channel.users[modeArg] += self.prefixForMode[mode];
314
+                            } else channel.users[modeArg] = channel.users[modeArg].replace(self.prefixForMode[mode], '');
315
+                        }
316
+                        self.emit(eventName, message.args[0], message.nick, mode, modeArg, message);
317
+                    } else if (supported.a.indexOf(mode) !== -1) {
318
+                        modeArg = modeArgs.shift();
319
+                        chanModes(mode, [modeArg]);
320
+                        self.emit(eventName, message.args[0], message.nick, mode, modeArg, message);
321
+                    } else if (supported.b.indexOf(mode) !== -1) {
322
+                        modeArg = modeArgs.shift();
323
+                        chanModes(mode, modeArg);
324
+                        self.emit(eventName, message.args[0], message.nick, mode, modeArg, message);
325
+                    } else if (supported.c.indexOf(mode) !== -1) {
326
+                        if (adding) modeArg = modeArgs.shift();
327
+                        else modeArg = undefined;
328
+                        chanModes(mode, modeArg);
329
+                        self.emit(eventName, message.args[0], message.nick, mode, modeArg, message);
330
+                    } else if (supported.d.indexOf(mode) !== -1) {
331
+                        chanModes(mode);
332
+                        self.emit(eventName, message.args[0], message.nick, mode, undefined, message);
333
+                    }
334
+                });
335
+                break;
336
+            case 'NICK':
337
+                if (message.nick == self.nick) {
338
+                    // the user just changed their own nick
339
+                    self.nick = message.args[0];
340
+                    self._updateMaxLineLength();
341
+                }
342
+
343
+                if (self.opt.debug)
344
+                    util.log('NICK: ' + message.nick + ' changes nick to ' + message.args[0]);
345
+
346
+                channels = [];
347
+
348
+                // TODO better way of finding what channels a user is in?
349
+                Object.keys(self.chans).forEach(function(channame) {
350
+                    var channel = self.chans[channame];
351
+                    channel.users[message.args[0]] = channel.users[message.nick];
352
+                    delete channel.users[message.nick];
353
+                    channels.push(channame);
354
+                });
355
+
356
+                // old nick, new nick, channels
357
+                self.emit('nick', message.nick, message.args[0], channels, message);
358
+                break;
359
+            case 'rpl_motdstart':
360
+                self.motd = message.args[1] + '\n';
361
+                break;
362
+            case 'rpl_motd':
363
+                self.motd += message.args[1] + '\n';
364
+                break;
365
+            case 'rpl_endofmotd':
366
+            case 'err_nomotd':
367
+                self.motd += message.args[1] + '\n';
368
+                self.emit('motd', self.motd);
369
+                break;
370
+            case 'rpl_namreply':
371
+                channel = self.chanData(message.args[2]);
372
+                var users = message.args[3].trim().split(/ +/);
373
+                if (channel) {
374
+                    users.forEach(function(user) {
375
+                        var match = user.match(/^(.)(.*)$/);
376
+                        if (match) {
377
+                            if (match[1] in self.modeForPrefix) {
378
+                                channel.users[match[2]] = match[1];
379
+                            }
380
+                            else {
381
+                                channel.users[match[1] + match[2]] = '';
382
+                            }
383
+                        }
384
+                    });
385
+                }
386
+                break;
387
+            case 'rpl_endofnames':
388
+                channel = self.chanData(message.args[1]);
389
+                if (channel) {
390
+                    self.emit('names', message.args[1], channel.users);
391
+                    self.emit('names' + message.args[1], channel.users);
392
+                    self.send('MODE', message.args[1]);
393
+                }
394
+                break;
395
+            case 'rpl_topic':
396
+                channel = self.chanData(message.args[1]);
397
+                if (channel) {
398
+                    channel.topic = message.args[2];
399
+                }
400
+                break;
401
+            case 'rpl_away':
402
+                self._addWhoisData(message.args[1], 'away', message.args[2], true);
403
+                break;
404
+            case 'rpl_whoisuser':
405
+                self._addWhoisData(message.args[1], 'user', message.args[2]);
406
+                self._addWhoisData(message.args[1], 'host', message.args[3]);
407
+                self._addWhoisData(message.args[1], 'realname', message.args[5]);
408
+                break;
409
+            case 'rpl_whoisidle':
410
+                self._addWhoisData(message.args[1], 'idle', message.args[2]);
411
+                break;
412
+            case 'rpl_whoischannels':
413
+               // TODO - clean this up?
414
+                self._addWhoisData(message.args[1], 'channels', message.args[2].trim().split(/\s+/));
415
+                break;
416
+            case 'rpl_whoisserver':
417
+                self._addWhoisData(message.args[1], 'server', message.args[2]);
418
+                self._addWhoisData(message.args[1], 'serverinfo', message.args[3]);
419
+                break;
420
+            case 'rpl_whoisoperator':
421
+                self._addWhoisData(message.args[1], 'operator', message.args[2]);
422
+                break;
423
+            case '330': // rpl_whoisaccount?
424
+                self._addWhoisData(message.args[1], 'account', message.args[2]);
425
+                self._addWhoisData(message.args[1], 'accountinfo', message.args[3]);
426
+                break;
427
+            case 'rpl_endofwhois':
428
+                self.emit('whois', self._clearWhoisData(message.args[1]));
429
+                break;
430
+            case 'rpl_whoreply':
431
+                self._addWhoisData(message.args[5], 'user', message.args[2]);
432
+                self._addWhoisData(message.args[5], 'host', message.args[3]);
433
+                self._addWhoisData(message.args[5], 'server', message.args[4]);
434
+                self._addWhoisData(message.args[5], 'realname', /[0-9]+\s*(.+)/g.exec(message.args[7])[1]);
435
+                // emit right away because rpl_endofwho doesn't contain nick
436
+                self.emit('whois', self._clearWhoisData(message.args[5]));
437
+                break;
438
+            case 'rpl_liststart':
439
+                self.channellist = [];
440
+                self.emit('channellist_start');
441
+                break;
442
+            case 'rpl_list':
443
+                channel = {
444
+                    name: message.args[1],
445
+                    users: message.args[2],
446
+                    topic: message.args[3]
447
+                };
448
+                self.emit('channellist_item', channel);
449
+                self.channellist.push(channel);
450
+                break;
451
+            case 'rpl_listend':
452
+                self.emit('channellist', self.channellist);
453
+                break;
454
+            case 'rpl_topicwhotime':
455
+                channel = self.chanData(message.args[1]);
456
+                if (channel) {
457
+                    channel.topicBy = message.args[2];
458
+                    // channel, topic, nick
459
+                    self.emit('topic', message.args[1], channel.topic, channel.topicBy, message);
460
+                }
461
+                break;
462
+            case 'TOPIC':
463
+                // channel, topic, nick
464
+                self.emit('topic', message.args[0], message.args[1], message.nick, message);
465
+
466
+                channel = self.chanData(message.args[0]);
467
+                if (channel) {
468
+                    channel.topic = message.args[1];
469
+                    channel.topicBy = message.nick;
470
+                }
471
+                break;
472
+            case 'rpl_channelmodeis':
473
+                channel = self.chanData(message.args[1]);
474
+                if (channel) {
475
+                    channel.mode = message.args[2];
476
+                }
477
+                break;
478
+            case 'rpl_creationtime':
479
+                channel = self.chanData(message.args[1]);
480
+                if (channel) {
481
+                    channel.created = message.args[2];
482
+                }
483
+                break;
484
+            case 'JOIN':
485
+                // channel, who
486
+                if (self.nick == message.nick) {
487
+                    self.chanData(message.args[0], true);
488
+                }
489
+                else {
490
+                    channel = self.chanData(message.args[0]);
491
+                    if (channel && channel.users) {
492
+                        channel.users[message.nick] = '';
493
+                    }
494
+                }
495
+                self.emit('join', message.args[0], message.nick, message);
496
+                self.emit('join' + message.args[0], message.nick, message);
497
+                if (message.args[0] != message.args[0].toLowerCase()) {
498
+                    self.emit('join' + message.args[0].toLowerCase(), message.nick, message);
499
+                }
500
+                break;
501
+            case 'PART':
502
+                // channel, who, reason
503
+                self.emit('part', message.args[0], message.nick, message.args[1], message);
504
+                self.emit('part' + message.args[0], message.nick, message.args[1], message);
505
+                if (message.args[0] != message.args[0].toLowerCase()) {
506
+                    self.emit('part' + message.args[0].toLowerCase(), message.nick, message.args[1], message);
507
+                }
508
+                if (self.nick == message.nick) {
509
+                    channel = self.chanData(message.args[0]);
510
+                    delete self.chans[channel.key];
511
+                }
512
+                else {
513
+                    channel = self.chanData(message.args[0]);
514
+                    if (channel && channel.users) {
515
+                        delete channel.users[message.nick];
516
+                    }
517
+                }
518
+                break;
519
+            case 'KICK':
520
+                // channel, who, by, reason
521
+                self.emit('kick', message.args[0], message.args[1], message.nick, message.args[2], message);
522
+                self.emit('kick' + message.args[0], message.args[1], message.nick, message.args[2], message);
523
+                if (message.args[0] != message.args[0].toLowerCase()) {
524
+                    self.emit('kick' + message.args[0].toLowerCase(),
525
+                              message.args[1], message.nick, message.args[2], message);
526
+                }
527
+
528
+                if (self.nick == message.args[1]) {
529
+                    channel = self.chanData(message.args[0]);
530
+                    delete self.chans[channel.key];
531
+                }
532
+                else {
533
+                    channel = self.chanData(message.args[0]);
534
+                    if (channel && channel.users) {
535
+                        delete channel.users[message.args[1]];
536
+                    }
537
+                }
538
+                break;
539
+            case 'KILL':
540
+                nick = message.args[0];
541
+                channels = [];
542
+                Object.keys(self.chans).forEach(function(channame) {
543
+                    var channel = self.chans[channame];
544
+                    channels.push(channame);
545
+                    delete channel.users[nick];
546
+                });
547
+                self.emit('kill', nick, message.args[1], channels, message);
548
+                break;
549
+            case 'PRIVMSG':
550
+                from = message.nick;
551
+                to = message.args[0];
552
+                text = message.args[1] || '';
553
+                if (text[0] === '\u0001' && text.lastIndexOf('\u0001') > 0) {
554
+                    self._handleCTCP(from, to, text, 'privmsg', message);
555
+                    break;
556
+                }
557
+                self.emit('message', from, to, text, message);
558
+                if (self.supported.channel.types.indexOf(to.charAt(0)) !== -1) {
559
+                    self.emit('message#', from, to, text, message);
560
+                    self.emit('message' + to, from, text, message);
561
+                    if (to != to.toLowerCase()) {
562
+                        self.emit('message' + to.toLowerCase(), from, text, message);
563
+                    }
564
+                }
565
+                if (to.toUpperCase() === self.nick.toUpperCase()) self.emit('pm', from, text, message);
566
+
567
+                if (self.opt.debug && to == self.nick)
568
+                    util.log('GOT MESSAGE from ' + from + ': ' + text);
569
+                break;
570
+            case 'INVITE':
571
+                from = message.nick;
572
+                to = message.args[0];
573
+                channel = message.args[1];
574
+                self.emit('invite', channel, from, message);
575
+                break;
576
+            case 'QUIT':
577
+                if (self.opt.debug)
578
+                    util.log('QUIT: ' + message.prefix + ' ' + message.args.join(' '));
579
+                if (self.nick == message.nick) {
580
+                    // TODO handle?
581
+                    break;
582
+                }
583
+                // handle other people quitting
584
+
585
+                channels = [];
586
+
587
+                // TODO better way of finding what channels a user is in?
588
+                Object.keys(self.chans).forEach(function(channame) {
589
+                    var channel = self.chans[channame];
590
+                    delete channel.users[message.nick];
591
+                    channels.push(channame);
592
+                });
593
+
594
+                // who, reason, channels
595
+                self.emit('quit', message.nick, message.args[0], channels, message);
596
+                break;
597
+
598
+            // for sasl
599
+            case 'CAP':
600
+                if (message.args[0] === '*' &&
601
+                     message.args[1] === 'ACK' &&
602
+                     message.args[2] === 'sasl ') // there's a space after sasl
603
+                    self.send('AUTHENTICATE', 'PLAIN');
604
+                break;
605
+            case 'AUTHENTICATE':
606
+                if (message.args[0] === '+') self.send('AUTHENTICATE',
607
+                    new Buffer(
608
+                        self.opt.nick + '\0' +
609
+                        self.opt.userName + '\0' +
610
+                        self.opt.password
611
+                    ).toString('base64'));
612
+                break;
613
+            case '903':
614
+                self.send('CAP', 'END');
615
+                break;
616
+
617
+            case 'err_umodeunknownflag':
618
+                if (self.opt.showErrors)
619
+                    util.log('\u001b[01;31mERROR: ' + util.inspect(message) + '\u001b[0m');
620
+                break;
621
+
622
+            case 'err_erroneusnickname':
623
+                if (self.opt.showErrors)
624
+                    util.log('\u001b[01;31mERROR: ' + util.inspect(message) + '\u001b[0m');
625
+                self.emit('error', message);
626
+                break;
627
+
628
+            // Commands relating to OPER
629
+            case 'err_nooperhost':
630
+                if (self.opt.showErrors) {
631
+                    self.emit('error', message);
632
+                    if (self.opt.showErrors)
633
+                        util.log('\u001b[01;31mERROR: ' + util.inspect(message) + '\u001b[0m');
634
+                }
635
+                break;
636
+
637
+            case 'rpl_youreoper':
638
+                self.emit('opered');
639
+                break;
640
+
641
+            default:
642
+                if (message.commandType == 'error') {
643
+                    self.emit('error', message);
644
+                    if (self.opt.showErrors)
645
+                        util.log('\u001b[01;31mERROR: ' + util.inspect(message) + '\u001b[0m');
646
+                }
647
+                else {
648
+                    if (self.opt.debug)
649
+                        util.log('\u001b[01;31mUnhandled message: ' + util.inspect(message) + '\u001b[0m');
650
+                    break;
651
+                }
652
+        }
653
+    });
654
+
655
+    self.addListener('kick', function(channel, who, by, reason) {
656
+        if (self.opt.autoRejoin)
657
+            self.send.apply(self, ['JOIN'].concat(channel.split(' ')));
658
+    });
659
+    self.addListener('motd', function(motd) {
660
+        self.opt.channels.forEach(function(channel) {
661
+            self.send.apply(self, ['JOIN'].concat(channel.split(' ')));
662
+        });
663
+    });
664
+
665
+    EventEmitter.call(this);
666
+}
667
+util.inherits(Client, EventEmitter);
668
+
669
+Client.prototype.conn = null;
670
+Client.prototype.prefixForMode = {};
671
+Client.prototype.modeForPrefix = {};
672
+Client.prototype.chans = {};
673
+Client.prototype._whoisData = {};
674
+
675
+Client.prototype.connectionTimedOut = function(conn) {
676
+    var self = this;
677
+    if (conn !== self.conn) {
678
+        // Only care about a timeout event if it came from the connection
679
+        // that is most current.
680
+        return;
681
+    }
682
+    self.end();
683
+};
684
+
685
+(function() {
686
+    var pingCounter = 1;
687
+    Client.prototype.connectionWantsPing = function(conn) {
688
+        var self = this;
689
+        if (conn !== self.conn) {
690
+            // Only care about a wantPing event if it came from the connection
691
+            // that is most current.
692
+            return;
693
+        }
694
+        self.send('PING', (pingCounter++).toString());
695
+    };
696
+}());
697
+
698
+Client.prototype.chanData = function(name, create) {
699
+    var key = name.toLowerCase();
700
+    if (create) {
701
+        this.chans[key] = this.chans[key] || {
702
+            key: key,
703
+            serverName: name,
704
+            users: {},
705
+            modeParams: {},
706
+            mode: ''
707
+        };
708
+    }
709
+
710
+    return this.chans[key];
711
+};
712
+
713
+Client.prototype._connectionHandler = function() {
714
+    if (this.opt.webirc.ip && this.opt.webirc.pass && this.opt.webirc.host) {
715
+        this.send('WEBIRC', this.opt.webirc.pass, this.opt.userName, this.opt.webirc.host, this.opt.webirc.ip);
716
+    }
717
+    if (this.opt.sasl) {
718
+        // see http://ircv3.atheme.org/extensions/sasl-3.1
719
+        this.send('CAP REQ', 'sasl');
720
+    } else if (this.opt.password) {
721
+        this.send('PASS', this.opt.password);
722
+    }
723
+    if (this.opt.debug)
724
+        util.log('Sending irc NICK/USER');
725
+    this.send('NICK', this.opt.nick);
726
+    this.nick = this.opt.nick;
727
+    this._updateMaxLineLength();
728
+    this.send('USER', this.opt.userName, 8, '*', this.opt.realName);
729
+
730
+    this.conn.cyclingPingTimer.start();
731
+
732
+    this.emit('connect');
733
+};
734
+
735
+Client.prototype.connect = function(retryCount, callback) {
736
+    if (typeof (retryCount) === 'function') {
737
+        callback = retryCount;
738
+        retryCount = undefined;
739
+    }
740
+    retryCount = retryCount || 0;
741
+    if (typeof (callback) === 'function') {
742
+        this.once('registered', callback);
743
+    }
744
+    var self = this;
745
+    self.chans = {};
746
+
747
+    // socket opts
748
+    var connectionOpts = {
749
+        host: self.opt.server,
750
+        port: self.opt.port
751
+    };
752
+
753
+    // local address to bind to
754
+    if (self.opt.localAddress)
755
+        connectionOpts.localAddress = self.opt.localAddress;
756
+
757
+    // try to connect to the server
758
+    if (self.opt.secure) {
759
+        connectionOpts.rejectUnauthorized = !self.opt.selfSigned;
760
+
761
+        if (typeof self.opt.secure == 'object') {
762
+            // copy "secure" opts to options passed to connect()
763
+            for (var f in self.opt.secure) {
764
+                connectionOpts[f] = self.opt.secure[f];
765
+            }
766
+        }
767
+
768
+        self.conn = tls.connect(connectionOpts, function() {
769
+            // callback called only after successful socket connection
770
+            self.conn.connected = true;
771
+            if (self.conn.authorized ||
772
+                (self.opt.selfSigned &&
773
+                    (self.conn.authorizationError   === 'DEPTH_ZERO_SELF_SIGNED_CERT' ||
774
+                     self.conn.authorizationError === 'UNABLE_TO_VERIFY_LEAF_SIGNATURE' ||
775
+                     self.conn.authorizationError === 'SELF_SIGNED_CERT_IN_CHAIN')) ||
776
+                (self.opt.certExpired &&
777
+                 self.conn.authorizationError === 'CERT_HAS_EXPIRED')) {
778
+                // authorization successful
779
+
780
+                if (!self.opt.encoding) {
781
+                    self.conn.setEncoding('utf-8');
782
+                }
783
+
784
+                if (self.opt.certExpired &&
785
+                    self.conn.authorizationError === 'CERT_HAS_EXPIRED') {
786
+                    util.log('Connecting to server with expired certificate');
787
+                }
788
+
789
+                self._connectionHandler();
790
+            } else {
791
+                // authorization failed
792
+                util.log(self.conn.authorizationError);
793
+            }
794
+        });
795
+    } else {
796
+        self.conn = net.createConnection(connectionOpts, self._connectionHandler.bind(self));
797
+    }
798
+    self.conn.requestedDisconnect = false;
799
+    self.conn.setTimeout(0);
800
+
801
+    // Each connection gets its own CyclingPingTimer. The connection forwards the timer's 'timeout' and 'wantPing' events
802
+    // to the client object via calling the connectionTimedOut() and connectionWantsPing() functions.
803
+    //
804
+    // Since the client's "current connection" value changes over time because of retry functionality,
805
+    // the client should ignore timeout/wantPing events that come from old connections.
806
+    self.conn.cyclingPingTimer = new CyclingPingTimer(self);
807
+    (function(conn) {
808
+        conn.cyclingPingTimer.on('pingTimeout', function() {
809
+            self.connectionTimedOut(conn);
810
+        });
811
+        conn.cyclingPingTimer.on('wantPing', function() {
812
+            self.connectionWantsPing(conn);
813
+        });
814
+    }(self.conn));
815
+
816
+    if (!self.opt.encoding) {
817
+        self.conn.setEncoding('utf8');
818
+    }
819
+
820
+    var buffer = new Buffer('');
821
+
822
+    function handleData(chunk) {
823
+        self.conn.cyclingPingTimer.notifyOfActivity();
824
+
825
+        if (typeof (chunk) === 'string') {
826
+            buffer += chunk;
827
+        } else {
828
+            buffer = Buffer.concat([buffer, chunk]);
829
+        }
830
+
831
+        var lines = self.convertEncoding(buffer).toString().split(lineDelimiter);
832
+
833
+        if (lines.pop()) {
834
+            // if buffer is not ended with \r\n, there's more chunks.
835
+            return;
836
+        } else {
837
+            // else, initialize the buffer.
838
+            buffer = new Buffer('');
839
+        }
840
+
841
+        lines.forEach(function iterator(line) {
842
+            if (line.length) {
843
+                var message = parseMessage(line, self.opt.stripColors);
844
+
845
+                try {
846
+                    self.emit('raw', message);
847
+                } catch (err) {
848
+                    if (!self.conn.requestedDisconnect) {
849
+                        throw err;
850
+                    }
851
+                }
852
+            }
853
+        });
854
+    }
855
+
856
+    self.conn.addListener('data', handleData);
857
+    self.conn.addListener('end', function() {
858
+        if (self.opt.debug)
859
+            util.log('Connection got "end" event');
860
+    });
861
+    self.conn.addListener('close', function() {
862
+        if (self.opt.debug)
863
+            util.log('Connection got "close" event');
864
+
865
+        if (self.conn && self.conn.requestedDisconnect)
866
+            return;
867
+        if (self.opt.debug)
868
+            util.log('Disconnected: reconnecting');
869
+        if (self.opt.retryCount !== null && retryCount >= self.opt.retryCount) {
870
+            if (self.opt.debug) {
871
+                util.log('Maximum retry count (' + self.opt.retryCount + ') reached. Aborting');
872
+            }
873
+            self.emit('abort', self.opt.retryCount);
874
+            return;
875
+        }
876
+
877
+        if (self.opt.debug) {
878
+            util.log('Waiting ' + self.opt.retryDelay + 'ms before retrying');
879
+        }
880
+        setTimeout(function() {
881
+            self.connect(retryCount + 1);
882
+        }, self.opt.retryDelay);
883
+    });
884
+    self.conn.addListener('error', function(exception) {
885
+        self.emit('netError', exception);
886
+        if (self.opt.debug) {
887
+            util.log('Network error: ' + exception);
888
+        }
889
+    });
890
+};
891
+
892
+Client.prototype.end = function() {
893
+    if (this.conn) {
894
+        this.conn.cyclingPingTimer.stop();
895
+        this.conn.destroy();
896
+    }
897
+    this.conn = null;
898
+};
899
+
900
+Client.prototype.disconnect = function(message, callback) {
901
+    if (typeof (message) === 'function') {
902
+        callback = message;
903
+        message = undefined;
904
+    }
905
+    message = message || 'node-irc says goodbye';
906
+    var self = this;
907
+    if (self.conn.readyState == 'open') {
908
+        var sendFunction;
909
+        if (self.opt.floodProtection) {
910
+            sendFunction = self._sendImmediate;
911
+            self._clearCmdQueue();
912
+        } else {
913
+            sendFunction = self.send;
914
+        }
915
+        sendFunction.call(self, 'QUIT', message);
916
+    }
917
+    self.conn.requestedDisconnect = true;
918
+    if (typeof (callback) === 'function') {
919
+        self.conn.once('end', callback);
920
+    }
921
+    self.conn.end();
922
+};
923
+
924
+Client.prototype.send = function(command) {
925
+    var args = Array.prototype.slice.call(arguments);
926
+
927
+    // Note that the command arg is included in the args array as the first element
928
+
929
+    if (args[args.length - 1].match(/\s/) || args[args.length - 1].match(/^:/) || args[args.length - 1] === '') {
930
+        args[args.length - 1] = ':' + args[args.length - 1];
931
+    }
932
+
933
+    if (this.opt.debug)
934
+        util.log('SEND: ' + args.join(' '));
935
+
936
+    if (!this.conn.requestedDisconnect) {
937
+        this.conn.write(args.join(' ') + '\r\n');
938
+    }
939
+};
940
+
941
+Client.prototype.activateFloodProtection = function(interval) {
942
+
943
+    var cmdQueue = [],
944
+        safeInterval = interval || this.opt.floodProtectionDelay,
945
+        self = this,
946
+        origSend = this.send,
947
+        dequeue;
948
+
949
+    // Wrapper for the original function. Just put everything to on central
950
+    // queue.
951
+    this.send = function() {
952
+        cmdQueue.push(arguments);
953
+    };
954
+
955
+    this._sendImmediate = function() {
956
+        origSend.apply(self, arguments);
957
+    };
958
+
959
+    this._clearCmdQueue = function() {
960
+        cmdQueue = [];
961
+    };
962
+
963
+    dequeue = function() {
964
+        var args = cmdQueue.shift();
965
+        if (args) {
966
+            origSend.apply(self, args);
967
+        }
968
+    };
969
+
970
+    // Slowly unpack the queue without flooding.
971
+    setInterval(dequeue, safeInterval);
972
+    dequeue();
973
+};
974
+
975
+Client.prototype.join = function(channel, callback) {
976
+    var channelName =  channel.split(' ')[0];
977
+    this.once('join' + channelName, function() {
978
+        // if join is successful, add this channel to opts.channels
979
+        // so that it will be re-joined upon reconnect (as channels
980
+        // specified in options are)
981
+        if (this.opt.channels.indexOf(channel) == -1) {
982
+            this.opt.channels.push(channel);
983
+        }
984
+
985
+        if (typeof (callback) == 'function') {
986
+            return callback.apply(this, arguments);
987
+        }
988
+    });
989
+    this.send.apply(this, ['JOIN'].concat(channel.split(' ')));
990
+};
991
+
992
+Client.prototype.part = function(channel, message, callback) {
993
+    if (typeof (message) === 'function') {
994
+        callback = message;
995
+        message = undefined;
996
+    }
997
+    if (typeof (callback) == 'function') {
998
+        this.once('part' + channel, callback);
999
+    }
1000
+
1001
+    // remove this channel from this.opt.channels so we won't rejoin
1002
+    // upon reconnect
1003
+    if (this.opt.channels.indexOf(channel) != -1) {
1004
+        this.opt.channels.splice(this.opt.channels.indexOf(channel), 1);
1005
+    }
1006
+
1007
+    if (message) {
1008
+        this.send('PART', channel, message);
1009
+    } else {
1010
+        this.send('PART', channel);
1011
+    }
1012
+};
1013
+
1014
+Client.prototype.action = function(channel, text) {
1015
+    var self = this;
1016
+    if (typeof text !== 'undefined') {
1017
+        text.toString().split(/\r?\n/).filter(function(line) {
1018
+            return line.length > 0;
1019
+        }).forEach(function(line) {
1020
+            self.say(channel, '\u0001ACTION ' + line + '\u0001');
1021
+        });
1022
+    }
1023
+};
1024
+
1025
+Client.prototype._splitLongLines = function(words, maxLength, destination) {
1026
+    maxLength = maxLength || 450; // If maxLength hasn't been initialized yet, prefer an arbitrarily low line length over crashing.
1027
+    if (words.length == 0) {
1028
+        return destination;
1029
+    }
1030
+    if (words.length <= maxLength) {
1031
+        destination.push(words);
1032
+        return destination;
1033
+    }
1034
+    var c = words[maxLength];
1035
+    var cutPos;
1036
+    var wsLength = 1;
1037
+    if (c.match(/\s/)) {
1038
+        cutPos = maxLength;
1039
+    } else {
1040
+        var offset = 1;
1041
+        while ((maxLength - offset) > 0) {
1042
+            var c = words[maxLength - offset];
1043
+            if (c.match(/\s/)) {
1044
+                cutPos = maxLength - offset;
1045
+                break;
1046
+            }
1047
+            offset++;
1048
+        }
1049
+        if (maxLength - offset <= 0) {
1050
+            cutPos = maxLength;
1051
+            wsLength = 0;
1052
+        }
1053
+    }
1054
+    var part = words.substring(0, cutPos);
1055
+    destination.push(part);
1056
+    return this._splitLongLines(words.substring(cutPos + wsLength, words.length), maxLength, destination);
1057
+};
1058
+
1059
+Client.prototype.say = function(target, text) {
1060
+    this._speak('PRIVMSG', target, text);
1061
+};
1062
+
1063
+Client.prototype.notice = function(target, text) {
1064
+    this._speak('NOTICE', target, text);
1065
+};
1066
+
1067
+Client.prototype._speak = function(kind, target, text) {
1068
+    var self = this;
1069
+    var maxLength = Math.min(this.maxLineLength - target.length, this.opt.messageSplit);
1070
+    if (typeof text !== 'undefined') {
1071
+        text.toString().split(/\r?\n/).filter(function(line) {
1072
+            return line.length > 0;
1073
+        }).forEach(function(line) {
1074
+            var linesToSend = self._splitLongLines(line, maxLength, []);
1075
+            linesToSend.forEach(function(toSend) {
1076
+                self.send(kind, target, toSend);
1077
+                if (kind == 'PRIVMSG') {
1078
+                    self.emit('selfMessage', target, toSend);
1079
+                }
1080
+            });
1081
+        });
1082
+    }
1083
+};
1084
+
1085
+Client.prototype.whois = function(nick, callback) {
1086
+    if (typeof callback === 'function') {
1087
+        var callbackWrapper = function(info) {
1088
+            if (info.nick.toLowerCase() == nick.toLowerCase()) {
1089
+                this.removeListener('whois', callbackWrapper);
1090
+                return callback.apply(this, arguments);
1091
+            }
1092
+        };
1093
+        this.addListener('whois', callbackWrapper);
1094
+    }
1095
+    this.send('WHOIS', nick);
1096
+};
1097
+
1098
+Client.prototype.list = function() {
1099
+    var args = Array.prototype.slice.call(arguments, 0);
1100
+    args.unshift('LIST');
1101
+    this.send.apply(this, args);
1102
+};
1103
+
1104
+Client.prototype._addWhoisData = function(nick, key, value, onlyIfExists) {
1105
+    if (onlyIfExists && !this._whoisData[nick]) return;
1106
+    this._whoisData[nick] = this._whoisData[nick] || {nick: nick};
1107
+    this._whoisData[nick][key] = value;
1108
+};
1109
+
1110
+Client.prototype._clearWhoisData = function(nick) {
1111
+    // Ensure that at least the nick exists before trying to return
1112
+    this._addWhoisData(nick, 'nick', nick);
1113
+    var data = this._whoisData[nick];
1114
+    delete this._whoisData[nick];
1115
+    return data;
1116
+};
1117
+
1118
+Client.prototype._handleCTCP = function(from, to, text, type, message) {
1119
+    text = text.slice(1);
1120
+    text = text.slice(0, text.indexOf('\u0001'));
1121
+    var parts = text.split(' ');
1122
+    this.emit('ctcp', from, to, text, type, message);
1123
+    this.emit('ctcp-' + type, from, to, text, message);
1124
+    if (type === 'privmsg' && text === 'VERSION')
1125
+        this.emit('ctcp-version', from, to, message);
1126
+    if (parts[0] === 'ACTION' && parts.length > 1)
1127
+        this.emit('action', from, to, parts.slice(1).join(' '), message);
1128
+    if (parts[0] === 'PING' && type === 'privmsg' && parts.length > 1)
1129
+        this.ctcp(from, 'notice', text);
1130
+};
1131
+
1132
+Client.prototype.ctcp = function(to, type, text) {
1133
+    return this[type === 'privmsg' ? 'say' : 'notice'](to, '\u0001' + text + '\u0001');
1134
+};
1135
+
1136
+Client.prototype.convertEncoding = function(str) {
1137
+    var self = this, out = str;
1138
+
1139
+    if (self.opt.encoding) {
1140
+        try {
1141
+            var charsetDetector = require('node-icu-charset-detector');
1142
+            var Iconv = require('iconv').Iconv;
1143
+            var charset = charsetDetector.detectCharset(str);
1144
+            var converter = new Iconv(charset.toString(), self.opt.encoding);
1145
+
1146
+            out = converter.convert(str);
1147
+        } catch (err) {
1148
+            if (self.opt.debug) {
1149
+                util.log('\u001b[01;31mERROR: ' + err + '\u001b[0m');
1150
+                util.inspect({ str: str, charset: charset });
1151
+            }
1152
+        }
1153
+    }
1154
+
1155
+    return out;
1156
+};
1157
+// blatantly stolen from irssi's splitlong.pl. Thanks, Bjoern Krombholz!
1158
+Client.prototype._updateMaxLineLength = function() {
1159
+    // 497 = 510 - (":" + "!" + " PRIVMSG " + " :").length;
1160
+    // target is determined in _speak() and subtracted there
1161
+    this.maxLineLength = 497 - this.nick.length - this.hostMask.length;
1162
+};
... ...
@@ -0,0 +1,69 @@
1
+var ircColors = require('irc-colors');
2
+var replyFor = require('./codes');
3
+
4
+/**
5
+ * parseMessage(line, stripColors)
6
+ *
7
+ * takes a raw "line" from the IRC server and turns it into an object with
8
+ * useful keys
9
+ * @param {String} line Raw message from IRC server.
10
+ * @param {Boolean} stripColors If true, strip IRC colors.
11
+ * @return {Object} A parsed message object.
12
+ */
13
+module.exports = function parseMessage(line, stripColors) {
14
+    var message = {};
15
+    var match;
16
+
17
+    if (stripColors) {
18
+        line = ircColors.stripColorsAndStyle(line);
19
+    }
20
+
21
+    // Parse prefix
22
+    match = line.match(/^:([^ ]+) +/);
23
+    if (match) {
24
+        message.prefix = match[1];
25
+        line = line.replace(/^:[^ ]+ +/, '');
26
+        match = message.prefix.match(/^([_a-zA-Z0-9\~\[\]\\`^{}|-]*)(!([^@]+)@(.*))?$/);
27
+        if (match) {
28
+            message.nick = match[1];
29
+            message.user = match[3];
30
+            message.host = match[4];
31
+        }
32
+        else {
33
+            message.server = message.prefix;
34
+        }
35
+    }
36
+
37
+    // Parse command
38
+    match = line.match(/^([^ ]+) */);
39
+    message.command = match[1];
40
+    message.rawCommand = match[1];
41
+    message.commandType = 'normal';
42
+    line = line.replace(/^[^ ]+ +/, '');
43
+
44
+    if (replyFor[message.rawCommand]) {
45
+        message.command     = replyFor[message.rawCommand].name;
46
+        message.commandType = replyFor[message.rawCommand].type;
47
+    }
48
+
49
+    message.args = [];
50
+    var middle, trailing;
51
+
52
+    // Parse parameters
53
+    if (line.search(/^:|\s+:/) != -1) {
54
+        match = line.match(/(.*?)(?:^:|\s+:)(.*)/);
55
+        middle = match[1].trimRight();
56
+        trailing = match[2];
57
+    }
58
+    else {
59
+        middle = line;
60
+    }
61
+
62
+    if (middle.length)
63
+        message.args = middle.split(/ +/);
64
+
65
+    if (typeof (trailing) != 'undefined' && trailing.length)
66
+        message.args.push(trailing);
67
+
68
+    return message;
69
+}
... ...
@@ -0,0 +1,46 @@
1
+{
2
+  "name": "irc",
3
+  "description": "An IRC client library for node",
4
+  "version": "0.5.2",
5
+  "author": "Martyn Smith <martyn@dollyfish.net.nz>",
6
+  "scripts": {
7
+    "test": "./node_modules/faucet/bin/cmd.js test/test-*.js",
8
+    "lint": "./node_modules/jscs/bin/jscs --preset=airbnb */*.js"
9
+  },
10
+  "contributors": [
11
+    "Fionn Kelleher <me@fionn.co>",
12
+    "xAndy <xandy@hackerspace-bamberg.de>",
13
+    "Mischa Spiegelmock <revmischa@cpan.org>",
14
+    "Justin Gallardo <justin.gallardo@gmail.com>",
15
+    "Chris Nehren <cnehren@pobox.com>",
16
+    "Henri Niemeläinen <aivot-on@iki.fi>",
17
+    "Alex Miles <ghostaldev@gmail.com>",
18
+    "Simmo Saan <simmo.saan@gmail.com>"
19
+  ],
20
+  "repository": {
21
+    "type": "git",
22
+    "url": "http://github.com/martynsmith/node-irc"
23
+  },
24
+  "bugs": {
25
+    "mail": "martyn@dollyfish.net.nz",
26
+    "url": "http://github.com/martynsmith/node-irc/issues"
27
+  },
28
+  "main": "lib/irc",
29
+  "engines": {
30
+    "node": ">=0.10.0"
31
+  },
32
+  "license": "GPL-3.0",
33
+  "dependencies": {
34
+    "irc-colors": "^1.1.0"
35
+  },
36
+  "optionalDependencies": {
37
+    "iconv": "~2.2.1",
38
+    "node-icu-charset-detector": "~0.2.0"
39
+  },
40
+  "devDependencies": {
41
+    "ansi-color": "0.2.1",
42
+    "faucet": "0.0.1",
43
+    "jscs": "1.9.0",
44
+    "tape": "^3.0.3"
45
+  }
46
+}
... ...
@@ -0,0 +1,29 @@
1
+#!/usr/bin/env node
2
+
3
+var irc  = require('./lib/irc.js');
4
+var util = require('util');
5
+var color = require('ansi-color').set;
6
+
7
+var c = new irc.Client(
8
+    'irc.dollyfish.net.nz',
9
+    'nodebot',
10
+    {
11
+        channels: ['#test'],
12
+        //debug: true
13
+    }
14
+);
15
+
16
+c.addListener('raw', function(message) { console.log('raw: ', message) });
17
+c.addListener('error', function(message) { console.log(color('error: ', 'red'), message) });
18
+
19
+var repl = require('repl').start('> ');
20
+repl.context.repl = repl;
21
+repl.context.util = util;
22
+repl.context.irc = irc;
23
+repl.context.c = c;
24
+
25
+repl.inputStream.addListener('close', function() {
26
+    console.log("\nClosing session");
27
+    c.disconnect('Closing session');
28
+});
29
+
... ...
@@ -0,0 +1,197 @@
1
+{
2
+	"basic": {
3
+		"sent": [
4
+			["NICK testbot", "Client sent NICK message"],
5
+			["USER nodebot 8 * :nodeJS IRC client", "Client sent USER message"],
6
+			["QUIT :node-irc says goodbye", "Client sent QUIT message"]
7
+		],
8
+
9
+		"received": [
10
+			[":localhost 001 testbot :Welcome to the Internet Relay Chat Network testbot\r\n", "Received welcome message"]
11
+		]
12
+	},
13
+	"double-CRLF": {
14
+		"sent": [
15
+			["NICK testbot", "Client sent NICK message"],
16
+			["USER nodebot 8 * :nodeJS IRC client", "Client sent USER message"],
17
+			["QUIT :node-irc says goodbye", "Client sent QUIT message"]
18
+		],
19
+
20
+		"received": [
21
+			[":localhost 001 testbot :Welcome to the Internet Relay Chat Network testbot\r\n\r\n", "Received welcome message"]
22
+		]
23
+	},
24
+	"parse-line": {
25
+		":irc.dollyfish.net.nz 372 nodebot :The message of the day was last changed: 2012-6-16 23:57": {
26
+			"prefix": "irc.dollyfish.net.nz",
27
+			"server": "irc.dollyfish.net.nz",
28
+			"command": "rpl_motd",
29
+			"rawCommand": "372",
30
+			"commandType": "reply",
31
+			"args": ["nodebot", "The message of the day was last changed: 2012-6-16 23:57"]
32
+		},
33
+		":Ned!~martyn@irc.dollyfish.net.nz PRIVMSG #test :Hello nodebot!": {
34
+			"prefix": "Ned!~martyn@irc.dollyfish.net.nz",
35
+			"nick": "Ned",
36
+			"user": "~martyn",
37
+			"host": "irc.dollyfish.net.nz",
38
+			"command": "PRIVMSG",
39
+			"rawCommand": "PRIVMSG",
40
+			"commandType": "normal",
41
+			"args": ["#test", "Hello nodebot!"]
42
+		},
43
+		":Ned!~martyn@irc.dollyfish.net.nz PRIVMSG #test ::-)": {
44
+			"prefix": "Ned!~martyn@irc.dollyfish.net.nz",
45
+			"nick": "Ned",
46
+			"user": "~martyn",
47
+			"host": "irc.dollyfish.net.nz",
48
+			"command": "PRIVMSG",
49
+			"rawCommand": "PRIVMSG",
50
+			"commandType": "normal",
51
+			"args": ["#test", ":-)"]
52
+		},
53
+		":Ned!~martyn@irc.dollyfish.net.nz PRIVMSG #test ::": {
54
+			"prefix": "Ned!~martyn@irc.dollyfish.net.nz",
55
+			"nick": "Ned",
56
+			"user": "~martyn",
57
+			"host": "irc.dollyfish.net.nz",
58
+			"command": "PRIVMSG",
59
+			"rawCommand": "PRIVMSG",
60
+			"commandType": "normal",
61
+			"args": ["#test", ":"]
62
+		},
63
+		":Ned!~martyn@irc.dollyfish.net.nz PRIVMSG #test ::^:^:": {
64
+			"prefix": "Ned!~martyn@irc.dollyfish.net.nz",
65
+			"nick": "Ned",
66
+			"user": "~martyn",
67
+			"host": "irc.dollyfish.net.nz",
68
+			"command": "PRIVMSG",
69
+			"rawCommand": "PRIVMSG",
70
+			"commandType": "normal",
71
+			"args": ["#test", ":^:^:"]
72
+		},
73
+		":some.irc.net 324 webuser #channel +Cnj 5:10": {
74
+			"prefix": "some.irc.net",
75
+			"server": "some.irc.net",
76
+			"command": "rpl_channelmodeis",
77
+			"rawCommand": "324",
78
+			"commandType": "reply",
79
+			"args": ["webuser", "#channel", "+Cnj", "5:10"]
80
+		},
81
+		":nick!user@host QUIT :Ping timeout: 252 seconds": {
82
+			"prefix": "nick!user@host",
83
+			"nick": "nick",
84
+			"user": "user",
85
+			"host": "host",
86
+			"command": "QUIT",
87
+			"rawCommand": "QUIT",
88
+			"commandType": "normal",
89
+			"args": ["Ping timeout: 252 seconds"]
90
+		},
91
+		":nick!user@host PRIVMSG #channel :so : colons: :are :: not a problem ::::": {
92
+			"prefix": "nick!user@host",
93
+			"nick": "nick",
94
+			"user": "user",
95
+			"host": "host",
96
+			"command": "PRIVMSG",
97
+			"rawCommand": "PRIVMSG",
98
+			"commandType": "normal",
99
+			"args": ["#channel", "so : colons: :are :: not a problem ::::"]
100
+		},
101
+		":nick!user@host PRIVMSG #channel :\u000314,01\u001fneither are colors or styles\u001f\u0003": {
102
+			"prefix": "nick!user@host",
103
+			"nick": "nick",
104
+			"user": "user",
105
+			"host": "host",
106
+			"command": "PRIVMSG",
107
+			"rawCommand": "PRIVMSG",
108
+			"commandType": "normal",
109
+			"args": ["#channel", "neither are colors or styles"],
110
+			"stripColors": true
111
+		},
112
+		":nick!user@host PRIVMSG #channel :\u000314,01\u001fwe can leave styles and colors alone if desired\u001f\u0003": {
113
+			"prefix": "nick!user@host",
114
+			"nick": "nick",
115
+			"user": "user",
116
+			"host": "host",
117
+			"command": "PRIVMSG",
118
+			"rawCommand": "PRIVMSG",
119
+			"commandType": "normal",
120
+			"args": ["#channel", "\u000314,01\u001fwe can leave styles and colors alone if desired\u001f\u0003"],
121
+			"stripColors": false
122
+		},
123
+		":pratchett.freenode.net 324 nodebot #ubuntu +CLcntjf 5:10 #ubuntu-unregged": {
124
+			"prefix": "pratchett.freenode.net",
125
+			"server": "pratchett.freenode.net",
126
+			"command": "rpl_channelmodeis",
127
+			"rawCommand": "324",
128
+			"commandType": "reply",
129
+			"args": ["nodebot", "#ubuntu", "+CLcntjf", "5:10", "#ubuntu-unregged"]
130
+		}
131
+
132
+	},
133
+	"433-before-001": {
134
+		"sent": [
135
+			["NICK testbot", "Client sent NICK message"],
136
+			["USER nodebot 8 * :nodeJS IRC client", "Client sent USER message"],
137
+			["NICK testbot1", "Client sent proper response to 433 nickname in use message"],
138
+			["QUIT :node-irc says goodbye", "Client sent QUIT message"]
139
+		],
140
+
141
+		"received": [
142
+			[":localhost 433 * testbot :Nickname is already in use.\r\n", "Received nick in use error"],
143
+			[":localhost 001 testbot1 :Welcome to the Internet Relay Chat Network testbot\r\n", "Received welcome message"]
144
+		],
145
+		"clientInfo": [
146
+			"hostmask is as expected after 433",
147
+			"nick is as expected after 433",
148
+			"maxLineLength is as expected after 433"
149
+		]
150
+	},
151
+    "convert-encoding": {
152
+        "causesException": [
153
+            ":ubottu!ubottu@ubuntu/bot/ubottu MODE #ubuntu -bo *!~Brian@* ubottu\r\n",
154
+            "Elizabeth",
155
+            ":sblack1!~sblack1@unaffiliated/sblack1 NICK :sblack\r\n",
156
+            ":TijG!~TijG@null.1ago.be PRIVMSG #ubuntu :ThinkPad\r\n"
157
+        ]
158
+    },
159
+    "_splitLongLines": [
160
+        {
161
+            "input": "abcde ",
162
+            "maxLength": 5,
163
+            "result": ["abcde"]
164
+        },
165
+        {
166
+            "input": "abcde",
167
+            "maxLength": 5,
168
+            "result": ["abcde"]
169
+        },
170
+        {
171
+            "input": "abcdefghijklmnopqrstuvwxyz",
172
+            "maxLength": 5,
173
+            "result": ["abcde", "fghij", "klmno", "pqrst", "uvwxy", "z"]
174
+        },
175
+        {
176
+            "input": "abc abcdef abc abcd abc",
177
+            "maxLength": 5,
178
+            "result": ["abc", "abcde", "f abc", "abcd", "abc"]
179
+        }
180
+    ],
181
+	"_splitLongLines_no_max": [
182
+		{
183
+			"input": "abcdefghijklmnopqrstuvwxyz",
184
+			"result": ["abcdefghijklmnopqrstuvwxyz"]
185
+		}
186
+	],
187
+	"_speak": [
188
+		{
189
+			"length": 30,
190
+			"expected": 10
191
+		},
192
+		{
193
+			"length": 7,
194
+			"expected": 1
195
+		}
196
+	]
197
+}
... ...
@@ -0,0 +1,15 @@
1
+-----BEGIN RSA PRIVATE KEY-----
2
+MIICWwIBAAKBgQDH5pYbcECKUrbRbUXKUu7lMCgb9UkPi4+Ur9f0LYdspHZJlv0S
3
+yBn4RpJOl8EsMhWI+houY3mBlcCL/DwiGfMDk5TSomyrI6eONFworokTJpG2h0f0
4
+cWnGdDW1zu8Z1odo047NWzwwv2mU03fkZmzfCclAzjKkDMMqP34mPl5TnwIDAQAB
5
+AoGAJslK3tAM9cnOxxvYqsUkrTuGzMXvAyElHshvsmUTHbVbbjPprrc8sruer7kq
6
+NhURsJ42bkHG1ankzkSGtmcqi3LdBBhVLm5gyog2JxQlTxvUVOPvyrOsQkl3uDwL
7
+aZqGTESHlLx7jhOKgiImqo0uGxNy46tzsHbpFGAeqTYcYKECQQD6faxqytMpMc/h
8
+zcrWsRhe7Omj5D6VdrbkGkM8razn4Oyr42p8Xylcde2MlnTiTAL5ElxlLd4PYsLD
9
+hKme/M5tAkEAzEwT1GU7CYjPdHHfsHUbDIHBh0BOJje2TXhDOa5tiZbOZevIk6TZ
10
+V6p/9zjLe5RAc/dpzHv1C+vQOkhgvoNyuwJARwjGkU5NTXxTwGwUnoeAKsMyioia
11
+etY8jTkpYha6VtOBKkmGlBiEaTUEFX9BTD9UBIABdavpMiHGq51+YJi+jQJAGYic
12
+pdwtH8jwnM4qtgQ86DhDduMLoW0vJMmWJVxuplap30Uz4XgmDfXqXnzDueNSluvi
13
+VkNb4iyL7uzi4ozNRwJALT0vP65RQ2d7OUEwB4XZFExKYzHADiFtw0NZtcWRW6y3
14
+rN0uXMxEZ6vRQurVjO9GhB76fAo/UooX0MVF0ShFNQ==
15
+-----END RSA PRIVATE KEY-----
... ...
@@ -0,0 +1,17 @@
1
+-----BEGIN CERTIFICATE-----
2
+MIICojCCAgugAwIBAgIJAMid3M25tUeUMA0GCSqGSIb3DQEBBQUAMGoxCzAJBgNV
3
+BAYTAlpaMREwDwYDVQQIDAhJbnRlcm5ldDEPMA0GA1UEBwwGZ2l0aHViMREwDwYD
4
+VQQKDAhub2RlLWlyYzEQMA4GA1UECwwHdGVzdGluZzESMBAGA1UEAwwJbG9jYWxo
5
+b3N0MB4XDTE1MDExMjIzNDg0MloXDTI1MDEwOTIzNDg0MlowajELMAkGA1UEBhMC
6
+WloxETAPBgNVBAgMCEludGVybmV0MQ8wDQYDVQQHDAZnaXRodWIxETAPBgNVBAoM
7
+CG5vZGUtaXJjMRAwDgYDVQQLDAd0ZXN0aW5nMRIwEAYDVQQDDAlsb2NhbGhvc3Qw
8
+gZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMfmlhtwQIpSttFtRcpS7uUwKBv1
9
+SQ+Lj5Sv1/Qth2ykdkmW/RLIGfhGkk6XwSwyFYj6Gi5jeYGVwIv8PCIZ8wOTlNKi
10
+bKsjp440XCiuiRMmkbaHR/RxacZ0NbXO7xnWh2jTjs1bPDC/aZTTd+RmbN8JyUDO
11
+MqQMwyo/fiY+XlOfAgMBAAGjUDBOMB0GA1UdDgQWBBTUaumzrTJrl1goRRzOGgEO
12
+VNKFmjAfBgNVHSMEGDAWgBTUaumzrTJrl1goRRzOGgEOVNKFmjAMBgNVHRMEBTAD
13
+AQH/MA0GCSqGSIb3DQEBBQUAA4GBAGKppBE9mjk2zJPSxPcHl3RSpnPs5ZkuBLnK
14
+rxZ2bR9VJhoQEwtiZRxkSXSdooj3eJgzMobYMEhSvFibUeBuIppB7oacys2Bd+O1
15
+xzILcbgEPqsk5JFbYT9KD8r+sZy5Wa1A39eNkmdD/oWt9Mb1PLrDfM/melvZ9/vW
16
+oMSmMipK
17
+-----END CERTIFICATE-----
... ...
@@ -0,0 +1,69 @@
1
+/* Mock irc server */
2
+
3
+var path = require('path');
4
+var fs = require('fs');
5
+var net = require('net');
6
+var tls = require('tls');
7
+var util = require('util');
8
+var EventEmitter = require('events').EventEmitter;
9
+
10
+var MockIrcd = function(port, encoding, isSecure) {
11
+    var self = this;
12
+    var connectionClass;
13
+    var options = {};
14
+
15
+    if (isSecure) {
16
+        connectionClass = tls;
17
+        options = {
18
+            key: fs.readFileSync(path.resolve(__dirname, 'data/ircd.key')),
19
+            cert: fs.readFileSync(path.resolve(__dirname, 'data/ircd.pem'))
20
+        };
21
+    } else {
22
+        connectionClass = net;
23
+    }
24
+
25
+    this.port = port || (isSecure ? 6697 : 6667);
26
+    this.encoding = encoding || 'utf-8';
27
+    this.incoming = [];
28
+    this.outgoing = [];
29
+
30
+    this.server = connectionClass.createServer(options, function(c) {
31
+        c.on('data', function(data) {
32
+            var msg = data.toString(self.encoding).split('\r\n').filter(function(m) { return m; });
33
+            self.incoming = self.incoming.concat(msg);
34
+        });
35
+
36
+        self.on('send', function(data) {
37
+            self.outgoing.push(data);
38
+            c.write(data);
39
+        });
40
+
41
+        c.on('end', function() {
42
+            self.emit('end');
43
+        });
44
+    });
45
+
46
+    this.server.listen(this.port);
47
+};
48
+util.inherits(MockIrcd, EventEmitter);
49
+
50
+MockIrcd.prototype.send = function(data) {
51
+    this.emit('send', data);
52
+};
53
+
54
+MockIrcd.prototype.close = function() {
55
+    this.server.close();
56
+};
57
+
58
+MockIrcd.prototype.getIncomingMsgs = function() {
59
+    return this.incoming;
60
+};
61
+
62
+var fixtures = require('./data/fixtures');
63
+module.exports.getFixtures = function(testSuite) {
64
+    return fixtures[testSuite];
65
+};
66
+
67
+module.exports.MockIrcd = function(port, encoding, isSecure) {
68
+    return new MockIrcd(port, encoding, isSecure);
69
+};
... ...
@@ -0,0 +1,39 @@
1
+var irc = require('../lib/irc');
2
+var test = require('tape');
3
+
4
+var testHelpers = require('./helpers');
5
+
6
+test('connect and sets hostmask when nick in use', function(t) {
7
+    var client, mock, expected;
8
+
9
+    mock = testHelpers.MockIrcd();
10
+    client = new irc.Client('localhost', 'testbot', {debug: true});
11
+
12
+    expected = testHelpers.getFixtures('433-before-001');
13
+
14
+    t.plan(expected.sent.length + expected.received.length + expected.clientInfo.length);
15
+
16
+    mock.server.on('connection', function() {
17
+        mock.send(':localhost 433 * testbot :Nickname is already in use.\r\n')
18
+        mock.send(':localhost 001 testbot1 :Welcome to the Internet Relay Chat Network testbot\r\n');
19
+    });
20
+
21
+    client.on('registered', function() {
22
+        t.equal(mock.outgoing[0], expected.received[0][0], expected.received[0][1]);
23
+        t.equal(mock.outgoing[1], expected.received[1][0], expected.received[1][1]);
24
+        client.disconnect(function() {
25
+            t.equal(client.hostMask, 'testbot', 'hostmask is as expected after 433');
26
+            t.equal(client.nick, 'testbot1', 'nick is as expected after 433');
27
+            t.equal(client.maxLineLength, 482, 'maxLineLength is as expected after 433');
28
+        });
29
+    });
30
+
31
+    mock.on('end', function() {
32
+        var msgs = mock.getIncomingMsgs();
33
+
34
+        for (var i = 0; i < msgs.length; i++) {
35
+            t.equal(msgs[i], expected.sent[i][0], expected.sent[i][1]);
36
+        }
37
+        mock.close();
38
+    });
39
+});
... ...
@@ -0,0 +1,36 @@
1
+var net = require('net');
2
+
3
+var irc = require('../lib/irc');
4
+var test = require('tape');
5
+
6
+var testHelpers = require('./helpers');
7
+
8
+test('user gets opped in auditorium', function(t) {
9
+    var mock = testHelpers.MockIrcd();
10
+    var client = new irc.Client('localhost', 'testbot', {debug: true});
11
+
12
+    client.on('+mode', function(channel, by, mode, argument) {
13
+        if (channel == '#auditorium' && argument == 'user') {
14
+            client.disconnect();
15
+        }
16
+    });
17
+
18
+    mock.server.on('connection', function() {
19
+        // Initiate connection
20
+        mock.send(':localhost 001 testbot :Welcome to the Internet Relay Chat Network testbot\r\n');
21
+
22
+        // Set prefix modes
23
+        mock.send(':localhost 005 testbot PREFIX=(ov)@+ CHANTYPES=#& :are supported by this server\r\n');
24
+
25
+        // Force join into auditorium
26
+        mock.send(':testbot JOIN #auditorium\r\n');
27
+
28
+        // +o the invisible user
29
+        mock.send(':ChanServ MODE #auditorium +o user\r\n');
30
+    });
31
+
32
+    mock.on('end', function() {
33
+        mock.close();
34
+        t.end();
35
+    });
36
+});
... ...
@@ -0,0 +1,53 @@
1
+var irc = require('../lib/irc');
2
+var test = require('tape');
3
+var testHelpers = require('./helpers');
4
+var checks = testHelpers.getFixtures('convert-encoding');
5
+var bindTo = { opt: { encoding: 'utf-8' } };
6
+
7
+test('irc.Client.convertEncoding old', function(assert) {
8
+    var convertEncoding = function(str) {
9
+        var self = this;
10
+
11
+        if (self.opt.encoding) {
12
+            var charsetDetector = require('node-icu-charset-detector');
13
+            var Iconv = require('iconv').Iconv;
14
+            var charset = charsetDetector.detectCharset(str).toString();
15
+            var to = new Iconv(charset, self.opt.encoding);
16
+
17
+            return to.convert(str);
18
+        } else {
19
+            return str;
20
+        }
21
+    }.bind(bindTo);
22
+
23
+    checks.causesException.forEach(function iterate(line) {
24
+        var causedException = false;
25
+        try {
26
+            convertEncoding(line);
27
+        } catch (e) {
28
+            causedException = true;
29
+        }
30
+
31
+        assert.equal(causedException, true, line + ' caused exception');
32
+    });
33
+
34
+    assert.end();
35
+});
36
+
37
+test('irc.Client.convertEncoding', function(assert) {
38
+    var convertEncoding = irc.Client.prototype.convertEncoding.bind(bindTo);
39
+
40
+    checks.causesException.forEach(function iterate(line) {
41
+        var causedException = false;
42
+
43
+        try {
44
+            convertEncoding(line);
45
+        } catch (e) {
46
+            causedException = true;
47
+        }
48
+
49
+        assert.equal(causedException, false, line + ' didn\'t cause exception');
50
+    });
51
+
52
+    assert.end();
53
+});
... ...
@@ -0,0 +1,33 @@
1
+var net = require('net');
2
+
3
+var irc = require('../lib/irc');
4
+var test = require('tape');
5
+
6
+var testHelpers = require('./helpers');
7
+
8
+test('sent messages ending with double CRLF', function(t) {
9
+    var mock = testHelpers.MockIrcd();
10
+    var client = new irc.Client('localhost', 'testbot', { debug: true});
11
+
12
+    var expected = testHelpers.getFixtures('double-CRLF');
13
+
14
+    t.plan(expected.sent.length + expected.received.length);
15
+
16
+    mock.server.on('connection', function() {
17
+        mock.send(expected.received[0][0]);
18
+    });
19
+
20
+    client.on('registered', function() {
21
+        t.equal(mock.outgoing[0], expected.received[0][0], expected.received[0][1]);
22
+        client.disconnect();
23
+    });
24
+
25
+    mock.on('end', function() {
26
+        var msgs = mock.getIncomingMsgs();
27
+
28
+        for (var i = 0; i < msgs.length; i++) {
29
+            t.equal(msgs[i], expected.sent[i][0], expected.sent[i][1]);
30
+        }
31
+        mock.close();
32
+    });
33
+});
... ...
@@ -0,0 +1,132 @@
1
+var net = require('net');
2
+
3
+var irc = require('../lib/irc');
4
+var test = require('tape');
5
+
6
+var testHelpers = require('./helpers');
7
+
8
+var expected = testHelpers.getFixtures('basic');
9
+var greeting = ':localhost 001 testbot :Welcome to the Internet Relay Chat Network testbot\r\n';
10
+
11
+test('connect, register and quit', function(t) {
12
+    runTests(t, false, false);
13
+});
14
+
15
+test('connect, register and quit, securely', function(t) {
16
+    runTests(t, true, false);
17
+});
18
+
19
+test('connect, register and quit, securely, with secure object', function(t) {
20
+    runTests(t, true, true);
21
+});
22
+
23
+function runTests(t, isSecure, useSecureObject) {
24
+    var port = isSecure ? 6697 : 6667;
25
+    var mock = testHelpers.MockIrcd(port, 'utf-8', isSecure);
26
+    var client;
27
+    if (isSecure && useSecureObject) {
28
+        client = new irc.Client('notlocalhost', 'testbot', {
29
+            secure: {
30
+                host: 'localhost',
31
+                port: port,
32
+                rejectUnauthorized: false
33
+            },
34
+            selfSigned: true,
35
+            retryCount: 0,
36
+            debug: true
37
+        });
38
+    } else {
39
+        var client = new irc.Client('localhost', 'testbot', {
40
+            secure: isSecure,
41
+            selfSigned: true,
42
+            port: port,
43
+            retryCount: 0,
44
+            debug: true
45
+        });
46
+    }
47
+
48
+    t.plan(expected.sent.length + expected.received.length);
49
+
50
+    mock.server.on(isSecure ? 'secureConnection' : 'connection', function() {
51
+        mock.send(greeting);
52
+    });
53
+
54
+    client.on('registered', function() {
55
+        t.equal(mock.outgoing[0], expected.received[0][0], expected.received[0][1]);
56
+        client.disconnect();
57
+    });
58
+
59
+    mock.on('end', function() {
60
+        var msgs = mock.getIncomingMsgs();
61
+
62
+        for (var i = 0; i < msgs.length; i++) {
63
+            t.equal(msgs[i], expected.sent[i][0], expected.sent[i][1]);
64
+        }
65
+        mock.close();
66
+    });
67
+}
68
+
69
+test ('splitting of long lines', function(t) {
70
+    var port = 6667;
71
+    var mock = testHelpers.MockIrcd(port, 'utf-8', false);
72
+    var client = new irc.Client('localhost', 'testbot', {
73
+        secure: false,
74
+        selfSigned: true,
75
+        port: port,
76
+        retryCount: 0,
77
+        debug: true
78
+    });
79
+
80
+    var group = testHelpers.getFixtures('_splitLongLines');
81
+    t.plan(group.length);
82
+    group.forEach(function(item) {
83
+        t.deepEqual(client._splitLongLines(item.input, item.maxLength, []), item.result);
84
+    });
85
+    mock.close();
86
+});
87
+
88
+test ('splitting of long lines with no maxLength defined.', function(t) {
89
+    var port = 6667;
90
+    var mock = testHelpers.MockIrcd(port, 'utf-8', false);
91
+    var client = new irc.Client('localhost', 'testbot', {
92
+        secure: false,
93
+        selfSigned: true,
94
+        port: port,
95
+        retryCount: 0,
96
+        debug: true
97
+    });
98
+
99
+    var group = testHelpers.getFixtures('_splitLongLines_no_max');
100
+    console.log(group.length);
101
+    t.plan(group.length);
102
+    group.forEach(function(item) {
103
+        t.deepEqual(client._splitLongLines(item.input, null, []), item.result);
104
+    });
105
+    mock.close();
106
+});
107
+
108
+test ('opt.messageSplit used when set', function(t) {
109
+    var port = 6667;
110
+    var mock = testHelpers.MockIrcd(port, 'utf-8', false);
111
+    var client = new irc.Client('localhost', 'testbot', {
112
+        secure: false,
113
+        selfSigned: true,
114
+        port: port,
115
+        retryCount: 0,
116
+        debug: true,
117
+        messageSplit: 10
118
+    });
119
+
120
+    var group = testHelpers.getFixtures('_speak');
121
+    t.plan(group.length);
122
+    group.forEach(function(item) {
123
+        client.maxLineLength = item.length;
124
+        client._splitLongLines = function(words, maxLength, destination) {
125
+            t.equal(maxLength, item.expected);
126
+            return [words];
127
+        }
128
+        client._speak('kind', 'target', 'test message');
129
+    });
130
+
131
+    mock.close();
132
+});
... ...
@@ -0,0 +1,68 @@
1
+var irc = require('../lib/irc');
2
+var test = require('tape');
3
+
4
+var testHelpers = require('./helpers');
5
+
6
+test('various origins and types of chanmodes get handled correctly', function(t) {
7
+    var mock = testHelpers.MockIrcd();
8
+    var client = new irc.Client('localhost', 'testbot', { debug: true });
9
+
10
+    var count = 0;
11
+    client.on('+mode', function() {
12
+        //console.log(client.chans['#channel']);
13
+        t.deepEqual(client.chans['#channel'], expected[count++]);
14
+    });
15
+    client.on('-mode', function() {
16
+        //console.log(client.chans['#channel']);
17
+        t.deepEqual(client.chans['#channel'], expected[count++]);
18
+    });
19
+
20
+    var expected = [
21
+        { key: '#channel', serverName: '#channel', users: {}, modeParams: { n: [] }, mode: 'n' },
22
+        { key: '#channel', serverName: '#channel', users: {}, modeParams: { n: [], t: [] }, mode: 'nt' },
23
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntb', modeParams: { b: ['*!*@AN.IP.1'], n: [], t: [] } },
24
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntb', modeParams: { b: ['*!*@AN.IP.1', '*!*@AN.IP.2'], n: [], t: [] } },
25
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntb', modeParams: { b: ['*!*@AN.IP.1', '*!*@AN.IP.2', '*!*@AN.IP.3'], n: [], t: [] } },
26
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntb', modeParams: { b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
27
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbf', modeParams: { f: ['[10j]:15'], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
28
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbf', modeParams: { f: ['[8j]:15'], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
29
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntb', modeParams: { b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
30
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbj', modeParams: { j: ['3:5'], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
31
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbj', modeParams: { j: ['2:5'], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
32
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntb', modeParams: { b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
33
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbp', modeParams: { p: [], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
34
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbps', modeParams: { s: [], p: [], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
35
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbpsK', modeParams: { K: [], s: [], p: [], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
36
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbsK', modeParams: { K: [], s: [], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
37
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbK', modeParams: { K: [], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } },
38
+        { key: '#channel', serverName: '#channel', users: { testbot: '@' }, mode: '+ntbKF', modeParams: { F: [], K: [], b: ['*!*@AN.IP.1', '*!*@AN.IP.3'], n: [], t: [] } }
39
+    ];
40
+
41
+    mock.server.on('connection', function() {
42
+        mock.send(':localhost 001 testbot :Welcome!\r\n');
43
+        mock.send(':localhost 005 testbot MODES=12 CHANTYPES=# PREFIX=(ohv)@%+ CHANMODES=beIqa,kfL,lj,psmntirRcOAQKVCuzNSMTGHFEB\r\n');
44
+        mock.send(':testbot MODE testbot :+ix\r\n');
45
+        mock.send(':testbot JOIN :#channel\r\n');
46
+        mock.send(':localhost MODE #channel +nt\r\n');
47
+        mock.send(':localhost 353 testbot = #channel :@testbot\r\n');
48
+        mock.send(':localhost 366 testbot #channel :End of /NAMES list.\r\n');
49
+        mock.send(':localhost 324 testbot #channel +nt\r\n');
50
+        mock.send(':localhost MODE #channel +b *!*@AN.IP.1\r\n');
51
+        mock.send(':localhost MODE #channel +bb *!*@AN.IP.2 *!*@AN.IP.3\r\n');
52
+        mock.send(':localhost MODE #channel -b *!*@AN.IP.2\r\n');
53
+        mock.send(':localhost MODE #channel +f [10j]:15\r\n');
54
+        mock.send(':localhost MODE #channel +f [8j]:15\r\n');
55
+        mock.send(':localhost MODE #channel -f+j [10j]:15 3:5\r\n');
56
+        mock.send(':localhost MODE #channel +j 2:5\r\n');
57
+        mock.send(':localhost MODE #channel -j\r\n');
58
+        mock.send(':localhost MODE #channel +ps\r\n');
59
+        mock.send(':localhost MODE #channel +K-p-s+F\r\n');
60
+
61
+        client.disconnect();
62
+    });
63
+
64
+    mock.on('end', function() {
65
+        mock.close();
66
+        t.end();
67
+    });
68
+});
... ...
@@ -0,0 +1,22 @@
1
+var parseMessage  = require('../lib/parse_message');
2
+var test = require('tape');
3
+
4
+var testHelpers = require('./helpers');
5
+
6
+test('irc.parseMessage', function(t) {
7
+    var checks = testHelpers.getFixtures('parse-line');
8
+
9
+    Object.keys(checks).forEach(function(line) {
10
+        var stripColors = false;
11
+        if (checks[line].hasOwnProperty('stripColors')) {
12
+            stripColors = checks[line].stripColors;
13
+            delete checks[line].stripColors;
14
+        }
15
+        t.equal(
16
+            JSON.stringify(checks[line]),
17
+            JSON.stringify(parseMessage(line, stripColors)),
18
+            line + ' parses correctly'
19
+        );
20
+    });
21
+    t.end();
22
+});
... ...
@@ -0,0 +1,541 @@
1
+# NAN ChangeLog
2
+
3
+**Version 2.15.0: current Node 16.6.1, Node 0.12: 0.12.18, Node 0.10: 0.10.48, iojs: 3.3.1**
4
+
5
+### 2.15.0 Aug 4 2021
6
+
7
+  - Feature: add ScriptOrigin (#918) d09debf9eeedcb7ca4073e84ffe5fbb455ecb709
8
+
9
+### 2.14.2 Oct 13 2020
10
+
11
+  - Bugfix: fix gcc 8 function cast warning (#899) 35f0fab205574b2cbda04e6347c8b2db755e124f
12
+
13
+### 2.14.1 Apr 21 2020
14
+
15
+  - Bugfix: use GetBackingStore() instead of GetContents() (#888) 2c023bd447661a61071da318b0ff4003c3858d39
16
+
17
+### 2.14.0 May 16 2019
18
+
19
+  - Feature: Add missing methods to Nan::Maybe<T> (#852) 4e962489fb84a184035b9fa74f245f650249aca6
20
+
21
+### 2.13.2 Mar 24 2019
22
+
23
+  - Bugfix: remove usage of deprecated `IsNearDeath` (#842) fbaf42252af279c3d867c6b193571f9711c39847
24
+
25
+### 2.13.1 Mar 14 2019
26
+
27
+  - Bugfix: check V8 version directly instead of inferring from NMV (#840) 12f9df9f393285de8fb4a8cd01478dc4fe3b089d
28
+
29
+### 2.13.0 Mar 13 2019
30
+
31
+  - Feature: add support for node master (#831) 113c0282072e7ff4f9dfc98b432fd894b798c2c
32
+
33
+### 2.12.1 Dec 18 2018
34
+
35
+  - Bugfix: Fix build breakage with Node.js 10.0.0-10.9.0. (#833) 625e90e8fef8d39ffa7247250a76a100b2487474
36
+
37
+### 2.12.0 Dec 16 2018
38
+
39
+  - Bugfix: Add scope.Escape() to Call() (#817) 2e5ed4fc3a8ac80a6ef1f2a55099ab3ac8800dc6
40
+  - Bugfix: Fix Node.js v10.12.0 deprecation warnings. 509859cc23b1770376b56550a027840a2ce0f73d
41
+  - Feature: Allow SetWeak() for non-object persistent handles. (#824) e6ef6a48e7e671fe3e4b7dddaa8912a3f8262ecd
42
+
43
+### 2.11.1 Sep 29 2018
44
+
45
+  - Fix: adapt to V8 7.0 24a22c3b25eeeec2016c6ec239bdd6169e985447
46
+
47
+### 2.11.0 Aug 25 2018
48
+
49
+  - Removal: remove `FunctionCallbackInfo::Callee` for nodejs `>= 10` 1a56c0a6efd4fac944cb46c30912a8e023bda7d4
50
+  - Bugfix: Fix `AsyncProgressWorkerBase::WorkProgress` sends invalid data b0c764d1dab11e9f8b37ffb81e2560a4498aad5e
51
+  - Feature: Introduce `GetCurrentEventLoop` b4911b0bb1f6d47d860e10ec014d941c51efac5e
52
+  - Feature: Add `NAN_MODULE_WORKER_ENABLED` macro as a replacement for `NAN_MODULE` b058fb047d18a58250e66ae831444441c1f2ac7a
53
+
54
+### 2.10.0 Mar 16 2018
55
+
56
+  - Deprecation: Deprecate `MakeCallback` 5e92b19a59e194241d6a658bd6ff7bfbda372950
57
+  - Feature: add `Nan::Call` overload 4482e1242fe124d166fc1a5b2be3c1cc849fe452
58
+  - Feature: add more `Nan::Call` overloads 8584e63e6d04c7d2eb8c4a664e4ef57d70bf672b
59
+  - Feature: Fix deprecation warnings for Node 10 1caf258243b0602ed56922bde74f1c91b0cbcb6a
60
+
61
+### 2.9.2 Feb 22 2018
62
+
63
+  - Bugfix: Bandaid for async hooks 212bd2f849be14ef1b02fc85010b053daa24252b
64
+
65
+### 2.9.1 Feb 22 2018
66
+
67
+  - Bugfix: Avoid deprecation warnings in deprecated `Nan::Callback::operator()` 372b14d91289df4604b0f81780709708c45a9aa4
68
+  - Bugfix: Avoid deprecation warnings in `Nan::JSON` 3bc294bce0b7d0a3ee4559926303e5ed4866fda2
69
+
70
+### 2.9.0 Feb 22 2018
71
+
72
+  - Deprecation: Deprecate legacy `Callback::Call` 6dd5fa690af61ca3523004b433304c581b3ea309
73
+  - Feature: introduce `AsyncResource` class 90c0a179c0d8cb5fd26f1a7d2b1d6231eb402d48o
74
+  - Feature: Add context aware `Nan::Callback::Call` functions 7169e09fb088418b6e388222e88b4c13f07ebaee
75
+  - Feature: Make `AsyncWorker` context aware 066ba21a6fb9e2b5230c9ed3a6fc51f1211736a4
76
+  - Feature: add `Callback` overload to `Nan::Call` 5328daf66e202658c1dc0d916c3aaba99b3cc606
77
+  - Bugfix: fix warning: suggest parentheses around `&&` within `||` b2bb63d68b8ae623a526b542764e1ac82319cb2c
78
+  - Bugfix: Fix compilation on io.js 3 d06114dba0a522fb436f0c5f47b994210968cd7b
79
+
80
+### 2.8.0 Nov 15 2017
81
+
82
+  - Deprecation: Deprecate `Nan::ForceSet` in favor of `Nan::DefineOwnProperty()` 95cbb976d6fbbba88ba0f86dd188223a8591b4e7
83
+  - Feature: Add `Nan::AsyncProgressQueueWorker` a976636ecc2ef617d1b061ce4a6edf39923691cb
84
+  - Feature: Add `Nan::DefineOwnProperty()` 95cbb976d6fbbba88ba0f86dd188223a8591b4e7
85
+  - Bugfix: Fix compiling on io.js 1 & 2 82705a64503ce60c62e98df5bd02972bba090900
86
+  - Bugfix: Use DefineOwnProperty instead of ForceSet 95cbb976d6fbbba88ba0f86dd188223a8591b4e7
87
+
88
+### 2.7.0 Aug 30 2017
89
+
90
+  - Feature: Add `Nan::To<v8::Function>()` overload. b93280670c9f6da42ed4cf6cbf085ffdd87bd65b
91
+  - Bugfix: Fix ternary in `Nan::MaybeLocal<T>::FromMaybe<S>()`. 79a26f7d362e756a9524e672a82c3d603b542867
92
+
93
+### 2.6.2 Apr 12 2017
94
+
95
+  - Bugfix: Fix v8::JSON::Parse() deprecation warning. 87f6a3c65815fa062296a994cc863e2fa124867d
96
+
97
+### 2.6.1 Apr 6 2017
98
+
99
+  - Bugfix: nan_json.h: fix build breakage in Node 6 ac8d47dc3c10bfbf3f15a6b951633120c0ee6d51
100
+
101
+### 2.6.0 Apr 6 2017
102
+
103
+  - Feature: nan: add support for JSON::Parse & Stringify b533226c629cce70e1932a873bb6f849044a56c5
104
+
105
+### 2.5.1 Jan 23 2017
106
+
107
+  - Bugfix: Fix disappearing handle for private value 6a80995694f162ef63dbc9948fbefd45d4485aa0
108
+  - Bugfix: Add missing scopes a93b8bae6bc7d32a170db6e89228b7f60ee57112
109
+  - Bugfix: Use string::data instead of string::front in NewOneByteString d5f920371e67e1f3b268295daee6e83af86b6e50
110
+
111
+### 2.5.0 Dec 21 2016
112
+
113
+  - Feature: Support Private accessors a86255cb357e8ad8ccbf1f6a4a901c921e39a178
114
+  - Bugfix: Abort in delete operators that shouldn't be called 0fe38215ff8581703967dfd26c12793feb960018
115
+
116
+### 2.4.0 Jul 10 2016
117
+
118
+  - Feature: Rewrite Callback to add Callback::Reset c4cf44d61f8275cd5f7b0c911d7a806d4004f649
119
+  - Feature: AsyncProgressWorker: add template types for .send 1242c9a11a7ed481c8f08ec06316385cacc513d0
120
+  - Bugfix: Add constness to old Persistent comparison operators bd43cb9982c7639605d60fd073efe8cae165d9b2
121
+
122
+### 2.3.5 May 31 2016
123
+
124
+  - Bugfix: Replace NAN_INLINE with 'inline' keyword. 71819d8725f822990f439479c9aba3b240804909
125
+
126
+### 2.3.4 May 31 2016
127
+
128
+  - Bugfix: Remove V8 deprecation warnings 0592fb0a47f3a1c7763087ebea8e1138829f24f9
129
+  - Bugfix: Fix new versions not to use WeakCallbackInfo::IsFirstPass 615c19d9e03d4be2049c10db0151edbc3b229246
130
+  - Bugfix: Make ObjectWrap::handle() const d19af99595587fe7a26bd850af6595c2a7145afc
131
+  - Bugfix: Fix compilation errors related to 0592fb0a47f3a1c7763087ebea8e1138829f24f9 e9191c525b94f652718325e28610a1adcf90fed8
132
+
133
+### 2.3.3 May 4 2016
134
+
135
+  - Bugfix: Refactor SetMethod() to deal with v8::Templates (#566) b9083cf6d5de6ebe6bcb49c7502fbb7c0d9ddda8
136
+
137
+### 2.3.2 Apr 27 2016
138
+
139
+  - Bugfix: Fix compilation on outdated versions due to Handle removal f8b7c875d04d425a41dfd4f3f8345bc3a11e6c52
140
+
141
+### 2.3.1 Apr 27 2016
142
+
143
+  - Bugfix: Don't use deprecated v8::Template::Set() in SetMethod a90951e9ea70fa1b3836af4b925322919159100e
144
+
145
+### 2.3.0 Apr 27 2016
146
+
147
+  - Feature: added Signal() for invoking async callbacks without sending data from AsyncProgressWorker d8adba45f20e077d00561b20199133620c990b38
148
+  - Bugfix: Don't use deprecated v8::Template::Set() 00dacf0a4b86027415867fa7f1059acc499dcece
149
+
150
+### 2.2.1 Mar 29 2016
151
+
152
+  - Bugfix: Use NewFromUnsigned in ReturnValue<T>::Set(uint32_t i) for pre_12 3a18f9bdce29826e0e4c217854bc476918241a58
153
+  - Performance: Remove unneeeded nullptr checks b715ef44887931c94f0d1605b3b1a4156eebece9
154
+
155
+### 2.2.0 Jan 9 2016
156
+
157
+  - Feature: Add Function::Call wrapper 4c157474dacf284d125c324177b45aa5dabc08c6
158
+  - Feature: Rename GC*logueCallback to GCCallback for > 4.0 3603435109f981606d300eb88004ca101283acec
159
+  - Bugfix: Fix Global::Pass for old versions 367e82a60fbaa52716232cc89db1cc3f685d77d9
160
+  - Bugfix: Remove weird MaybeLocal wrapping of what already is a MaybeLocal 23b4590db10c2ba66aee2338aebe9751c4cb190b
161
+
162
+### 2.1.0 Oct 8 2015
163
+
164
+  - Deprecation: Deprecate NanErrnoException in favor of ErrnoException 0af1ca4cf8b3f0f65ed31bc63a663ab3319da55c
165
+  - Feature: added helper class for accessing contents of typedarrays 17b51294c801e534479d5463697a73462d0ca555
166
+  - Feature: [Maybe types] Add MakeMaybe(...) 48d7b53d9702b0c7a060e69ea10fea8fb48d814d
167
+  - Feature: new: allow utf16 string with length 66ac6e65c8ab9394ef588adfc59131b3b9d8347b
168
+  - Feature: Introduce SetCallHandler and SetCallAsFunctionHandler 7764a9a115d60ba10dc24d86feb0fbc9b4f75537
169
+  - Bugfix: Enable creating Locals from Globals under Node 0.10. 9bf9b8b190821af889790fdc18ace57257e4f9ff
170
+  - Bugfix: Fix issue #462 where PropertyCallbackInfo data is not stored safely. 55f50adedd543098526c7b9f4fffd607d3f9861f
171
+
172
+### 2.0.9 Sep 8 2015
173
+
174
+  - Bugfix: EscapableHandleScope in Nan::NewBuffer for Node 0.8 and 0.10 b1654d7
175
+
176
+### 2.0.8 Aug 28 2015
177
+
178
+  - Work around duplicate linking bug in clang 11902da
179
+
180
+### 2.0.7 Aug 26 2015
181
+
182
+  - Build: Repackage
183
+
184
+### 2.0.6 Aug 26 2015
185
+
186
+  - Bugfix: Properly handle null callback in FunctionTemplate factory 6e99cb1
187
+  - Bugfix: Remove unused static std::map instances 525bddc
188
+  - Bugfix: Make better use of maybe versions of APIs bfba85b
189
+  - Bugfix: Fix shadowing issues with handle in ObjectWrap 0a9072d
190
+
191
+### 2.0.5 Aug 10 2015
192
+
193
+  - Bugfix: Reimplement weak callback in ObjectWrap 98d38c1
194
+  - Bugfix: Make sure callback classes are not assignable, copyable or movable 81f9b1d
195
+
196
+### 2.0.4 Aug 6 2015
197
+
198
+  - Build: Repackage
199
+
200
+### 2.0.3 Aug 6 2015
201
+
202
+  - Bugfix: Don't use clang++ / g++ syntax extension. 231450e
203
+
204
+### 2.0.2 Aug 6 2015
205
+
206
+  - Build: Repackage
207
+
208
+### 2.0.1 Aug 6 2015
209
+
210
+  - Bugfix: Add workaround for missing REPLACE_INVALID_UTF8 60d6687
211
+  - Bugfix: Reimplement ObjectWrap from scratch to prevent memory leaks 6484601
212
+  - Bugfix: Fix Persistent leak in FunctionCallbackInfo and PropertyCallbackInfo 641ef5f
213
+  - Bugfix: Add missing overload for Nan::NewInstance that takes argc/argv 29450ed
214
+
215
+### 2.0.0 Jul 31 2015
216
+
217
+  - Change: Renamed identifiers with leading underscores	b5932b4
218
+  - Change: Replaced NanObjectWrapHandle with class NanObjectWrap	464f1e1
219
+  - Change: Replace NanScope and NanEscpableScope macros with classes	47751c4
220
+  - Change: Rename NanNewBufferHandle to NanNewBuffer	6745f99
221
+  - Change: Rename NanBufferUse to NanNewBuffer	3e8b0a5
222
+  - Change: Rename NanNewBuffer to NanCopyBuffer	d6af78d
223
+  - Change: Remove Nan prefix from all names	72d1f67
224
+  - Change: Update Buffer API for new upstream changes	d5d3291
225
+  - Change: Rename Scope and EscapableScope to HandleScope and EscapableHandleScope	21a7a6a
226
+  - Change: Get rid of Handles	 e6c0daf
227
+  - Feature: Support io.js 3 with V8 4.4
228
+  - Feature: Introduce NanPersistent	7fed696
229
+  - Feature: Introduce NanGlobal	4408da1
230
+  - Feature: Added NanTryCatch	10f1ca4
231
+  - Feature: Update for V8 v4.3	4b6404a
232
+  - Feature: Introduce NanNewOneByteString	c543d32
233
+  - Feature: Introduce namespace Nan	67ed1b1
234
+  - Removal: Remove NanLocker and NanUnlocker	dd6e401
235
+  - Removal: Remove string converters, except NanUtf8String, which now follows the node implementation b5d00a9
236
+  - Removal: Remove NanReturn* macros	d90a25c
237
+  - Removal: Remove HasInstance	e8f84fe
238
+
239
+
240
+### 1.9.0 Jul 31 2015
241
+
242
+  - Feature: Added `NanFatalException` 81d4a2c
243
+  - Feature: Added more error types 4265f06
244
+  - Feature: Added dereference and function call operators to NanCallback c4b2ed0
245
+  - Feature: Added indexed GetFromPersistent and SaveToPersistent edd510c
246
+  - Feature: Added more overloads of SaveToPersistent and GetFromPersistent 8b1cef6
247
+  - Feature: Added NanErrnoException dd87d9e
248
+  - Correctness: Prevent assign, copy, and move for classes that do not support it 1f55c59, 4b808cb, c96d9b2, fba4a29, 3357130
249
+  - Deprecation: Deprecate `NanGetPointerSafe` and `NanSetPointerSafe` 81d4a2c
250
+  - Deprecation: Deprecate `NanBooleanOptionValue` and `NanUInt32OptionValue` 0ad254b
251
+
252
+### 1.8.4 Apr 26 2015
253
+
254
+  - Build: Repackage
255
+
256
+### 1.8.3 Apr 26 2015
257
+
258
+  - Bugfix: Include missing header 1af8648
259
+
260
+### 1.8.2 Apr 23 2015
261
+
262
+  - Build: Repackage
263
+
264
+### 1.8.1 Apr 23 2015
265
+
266
+  - Bugfix: NanObjectWrapHandle should take a pointer 155f1d3
267
+
268
+### 1.8.0 Apr 23 2015
269
+
270
+  - Feature: Allow primitives with NanReturnValue 2e4475e
271
+  - Feature: Added comparison operators to NanCallback 55b075e
272
+  - Feature: Backport thread local storage 15bb7fa
273
+  - Removal: Remove support for signatures with arguments 8a2069d
274
+  - Correcteness: Replaced NanObjectWrapHandle macro with function 0bc6d59
275
+
276
+### 1.7.0 Feb 28 2015
277
+
278
+  - Feature: Made NanCallback::Call accept optional target 8d54da7
279
+  - Feature: Support atom-shell 0.21 0b7f1bb
280
+
281
+### 1.6.2 Feb 6 2015
282
+
283
+  - Bugfix: NanEncode: fix argument type for node::Encode on io.js 2be8639
284
+
285
+### 1.6.1 Jan 23 2015
286
+
287
+  - Build: version bump
288
+
289
+### 1.5.3 Jan 23 2015
290
+
291
+  - Build: repackage
292
+
293
+### 1.6.0 Jan 23 2015
294
+
295
+ - Deprecated `NanNewContextHandle` in favor of `NanNew<Context>` 49259af
296
+ - Support utility functions moved in newer v8 versions (Node 0.11.15, io.js 1.0) a0aa179
297
+ - Added `NanEncode`, `NanDecodeBytes` and `NanDecodeWrite` 75e6fb9
298
+
299
+### 1.5.2 Jan 23 2015
300
+
301
+  - Bugfix: Fix non-inline definition build error with clang++ 21d96a1, 60fadd4
302
+  - Bugfix: Readded missing String constructors 18d828f
303
+  - Bugfix: Add overload handling NanNew<FunctionTemplate>(..) 5ef813b
304
+  - Bugfix: Fix uv_work_cb versioning 997e4ae
305
+  - Bugfix: Add function factory and test 4eca89c
306
+  - Bugfix: Add object template factory and test cdcb951
307
+  - Correctness: Lifted an io.js related typedef c9490be
308
+  - Correctness: Make explicit downcasts of String lengths 00074e6
309
+  - Windows: Limit the scope of disabled warning C4530 83d7deb
310
+
311
+### 1.5.1 Jan 15 2015
312
+
313
+  - Build: version bump
314
+
315
+### 1.4.3 Jan 15 2015
316
+
317
+  - Build: version bump
318
+
319
+### 1.4.2 Jan 15 2015
320
+
321
+  - Feature: Support io.js 0dbc5e8
322
+
323
+### 1.5.0 Jan 14 2015
324
+
325
+ - Feature: Support io.js b003843
326
+ - Correctness: Improved NanNew internals 9cd4f6a
327
+ - Feature: Implement progress to NanAsyncWorker 8d6a160
328
+
329
+### 1.4.1 Nov 8 2014
330
+
331
+ - Bugfix: Handle DEBUG definition correctly
332
+ - Bugfix: Accept int as Boolean
333
+
334
+### 1.4.0 Nov 1 2014
335
+
336
+ - Feature: Added NAN_GC_CALLBACK 6a5c245
337
+ - Performance: Removed unnecessary local handle creation 18a7243, 41fe2f8
338
+ - Correctness: Added constness to references in NanHasInstance 02c61cd
339
+ - Warnings: Fixed spurious warnings from -Wundef and -Wshadow, 541b122, 99d8cb6
340
+ - Windoze: Shut Visual Studio up when compiling 8d558c1
341
+ - License: Switch to plain MIT from custom hacked MIT license 11de983
342
+ - Build: Added test target to Makefile e232e46
343
+ - Performance: Removed superfluous scope in NanAsyncWorker f4b7821
344
+ - Sugar/Feature: Added NanReturnThis() and NanReturnHolder() shorthands 237a5ff, d697208
345
+ - Feature: Added suitable overload of NanNew for v8::Integer::NewFromUnsigned b27b450
346
+
347
+### 1.3.0 Aug 2 2014
348
+
349
+ - Added NanNew<v8::String, std::string>(std::string)
350
+ - Added NanNew<v8::String, std::string&>(std::string&)
351
+ - Added NanAsciiString helper class
352
+ - Added NanUtf8String helper class
353
+ - Added NanUcs2String helper class
354
+ - Deprecated NanRawString()
355
+ - Deprecated NanCString()
356
+ - Added NanGetIsolateData(v8::Isolate *isolate)
357
+ - Added NanMakeCallback(v8::Handle<v8::Object> target, v8::Handle<v8::Function> func, int argc, v8::Handle<v8::Value>* argv)
358
+ - Added NanMakeCallback(v8::Handle<v8::Object> target, v8::Handle<v8::String> symbol, int argc, v8::Handle<v8::Value>* argv)
359
+ - Added NanMakeCallback(v8::Handle<v8::Object> target, const char* method, int argc, v8::Handle<v8::Value>* argv)
360
+ - Added NanSetTemplate(v8::Handle<v8::Template> templ, v8::Handle<v8::String> name , v8::Handle<v8::Data> value, v8::PropertyAttribute attributes)
361
+ - Added NanSetPrototypeTemplate(v8::Local<v8::FunctionTemplate> templ, v8::Handle<v8::String> name, v8::Handle<v8::Data> value, v8::PropertyAttribute attributes)
362
+ - Added NanSetInstanceTemplate(v8::Local<v8::FunctionTemplate> templ, const char *name, v8::Handle<v8::Data> value)
363
+ - Added NanSetInstanceTemplate(v8::Local<v8::FunctionTemplate> templ, v8::Handle<v8::String> name, v8::Handle<v8::Data> value, v8::PropertyAttribute attributes)
364
+
365
+### 1.2.0 Jun 5 2014
366
+
367
+ - Add NanSetPrototypeTemplate
368
+ - Changed NAN_WEAK_CALLBACK internals, switched _NanWeakCallbackData to class,
369
+     introduced _NanWeakCallbackDispatcher
370
+ - Removed -Wno-unused-local-typedefs from test builds
371
+ - Made test builds Windows compatible ('Sleep()')
372
+
373
+### 1.1.2 May 28 2014
374
+
375
+ - Release to fix more stuff-ups in 1.1.1
376
+
377
+### 1.1.1 May 28 2014
378
+
379
+ - Release to fix version mismatch in nan.h and lack of changelog entry for 1.1.0
380
+
381
+### 1.1.0 May 25 2014
382
+
383
+ - Remove nan_isolate, use v8::Isolate::GetCurrent() internally instead
384
+ - Additional explicit overloads for NanNew(): (char*,int), (uint8_t*[,int]),
385
+     (uint16_t*[,int), double, int, unsigned int, bool, v8::String::ExternalStringResource*,
386
+     v8::String::ExternalAsciiStringResource*
387
+ - Deprecate NanSymbol()
388
+ - Added SetErrorMessage() and ErrorMessage() to NanAsyncWorker
389
+
390
+### 1.0.0 May 4 2014
391
+
392
+ - Heavy API changes for V8 3.25 / Node 0.11.13
393
+ - Use cpplint.py
394
+ - Removed NanInitPersistent
395
+ - Removed NanPersistentToLocal
396
+ - Removed NanFromV8String
397
+ - Removed NanMakeWeak
398
+ - Removed NanNewLocal
399
+ - Removed NAN_WEAK_CALLBACK_OBJECT
400
+ - Removed NAN_WEAK_CALLBACK_DATA
401
+ - Introduce NanNew, replaces NanNewLocal, NanPersistentToLocal, adds many overloaded typed versions
402
+ - Introduce NanUndefined, NanNull, NanTrue and NanFalse
403
+ - Introduce NanEscapableScope and NanEscapeScope
404
+ - Introduce NanMakeWeakPersistent (requires a special callback to work on both old and new node)
405
+ - Introduce NanMakeCallback for node::MakeCallback
406
+ - Introduce NanSetTemplate
407
+ - Introduce NanGetCurrentContext
408
+ - Introduce NanCompileScript and NanRunScript
409
+ - Introduce NanAdjustExternalMemory
410
+ - Introduce NanAddGCEpilogueCallback, NanAddGCPrologueCallback, NanRemoveGCEpilogueCallback, NanRemoveGCPrologueCallback
411
+ - Introduce NanGetHeapStatistics
412
+ - Rename NanAsyncWorker#SavePersistent() to SaveToPersistent()
413
+
414
+### 0.8.0 Jan 9 2014
415
+
416
+ - NanDispose -> NanDisposePersistent, deprecate NanDispose
417
+ - Extract _NAN_*_RETURN_TYPE, pull up NAN_*()
418
+
419
+### 0.7.1 Jan 9 2014
420
+
421
+ - Fixes to work against debug builds of Node
422
+ - Safer NanPersistentToLocal (avoid reinterpret_cast)
423
+ - Speed up common NanRawString case by only extracting flattened string when necessary
424
+
425
+### 0.7.0 Dec 17 2013
426
+
427
+ - New no-arg form of NanCallback() constructor.
428
+ - NanCallback#Call takes Handle rather than Local
429
+ - Removed deprecated NanCallback#Run method, use NanCallback#Call instead
430
+ - Split off _NAN_*_ARGS_TYPE from _NAN_*_ARGS
431
+ - Restore (unofficial) Node 0.6 compatibility at NanCallback#Call()
432
+ - Introduce NanRawString() for char* (or appropriate void*) from v8::String
433
+     (replacement for NanFromV8String)
434
+ - Introduce NanCString() for null-terminated char* from v8::String
435
+
436
+### 0.6.0 Nov 21 2013
437
+
438
+ - Introduce NanNewLocal<T>(v8::Handle<T> value) for use in place of
439
+     v8::Local<T>::New(...) since v8 started requiring isolate in Node 0.11.9
440
+
441
+### 0.5.2 Nov 16 2013
442
+
443
+ - Convert SavePersistent and GetFromPersistent in NanAsyncWorker from protected and public
444
+
445
+### 0.5.1 Nov 12 2013
446
+
447
+ - Use node::MakeCallback() instead of direct v8::Function::Call()
448
+
449
+### 0.5.0 Nov 11 2013
450
+
451
+ - Added @TooTallNate as collaborator
452
+ - New, much simpler, "include_dirs" for binding.gyp
453
+ - Added full range of NAN_INDEX_* macros to match NAN_PROPERTY_* macros
454
+
455
+### 0.4.4 Nov 2 2013
456
+
457
+ - Isolate argument from v8::Persistent::MakeWeak removed for 0.11.8+
458
+
459
+### 0.4.3 Nov 2 2013
460
+
461
+ - Include node_object_wrap.h, removed from node.h for Node 0.11.8.
462
+
463
+### 0.4.2 Nov 2 2013
464
+
465
+ - Handle deprecation of v8::Persistent::Dispose(v8::Isolate* isolate)) for
466
+     Node 0.11.8 release.
467
+
468
+### 0.4.1 Sep 16 2013
469
+
470
+ - Added explicit `#include <uv.h>` as it was removed from node.h for v0.11.8
471
+
472
+### 0.4.0 Sep 2 2013
473
+
474
+ - Added NAN_INLINE and NAN_DEPRECATED and made use of them
475
+ - Added NanError, NanTypeError and NanRangeError
476
+ - Cleaned up code
477
+
478
+### 0.3.2 Aug 30 2013
479
+
480
+ - Fix missing scope declaration in GetFromPersistent() and SaveToPersistent
481
+     in NanAsyncWorker
482
+
483
+### 0.3.1 Aug 20 2013
484
+
485
+ - fix "not all control paths return a value" compile warning on some platforms
486
+
487
+### 0.3.0 Aug 19 2013
488
+
489
+ - Made NAN work with NPM
490
+ - Lots of fixes to NanFromV8String, pulling in features from new Node core
491
+ - Changed node::encoding to Nan::Encoding in NanFromV8String to unify the API
492
+ - Added optional error number argument for NanThrowError()
493
+ - Added NanInitPersistent()
494
+ - Added NanReturnNull() and NanReturnEmptyString()
495
+ - Added NanLocker and NanUnlocker
496
+ - Added missing scopes
497
+ - Made sure to clear disposed Persistent handles
498
+ - Changed NanAsyncWorker to allocate error messages on the heap
499
+ - Changed NanThrowError(Local<Value>) to NanThrowError(Handle<Value>)
500
+ - Fixed leak in NanAsyncWorker when errmsg is used
501
+
502
+### 0.2.2 Aug 5 2013
503
+
504
+ - Fixed usage of undefined variable with node::BASE64 in NanFromV8String()
505
+
506
+### 0.2.1 Aug 5 2013
507
+
508
+ - Fixed 0.8 breakage, node::BUFFER encoding type not available in 0.8 for
509
+     NanFromV8String()
510
+
511
+### 0.2.0 Aug 5 2013
512
+
513
+ - Added NAN_PROPERTY_GETTER, NAN_PROPERTY_SETTER, NAN_PROPERTY_ENUMERATOR,
514
+     NAN_PROPERTY_DELETER, NAN_PROPERTY_QUERY
515
+ - Extracted _NAN_METHOD_ARGS, _NAN_GETTER_ARGS, _NAN_SETTER_ARGS,
516
+     _NAN_PROPERTY_GETTER_ARGS, _NAN_PROPERTY_SETTER_ARGS,
517
+     _NAN_PROPERTY_ENUMERATOR_ARGS, _NAN_PROPERTY_DELETER_ARGS,
518
+     _NAN_PROPERTY_QUERY_ARGS
519
+ - Added NanGetInternalFieldPointer, NanSetInternalFieldPointer
520
+ - Added NAN_WEAK_CALLBACK, NAN_WEAK_CALLBACK_OBJECT,
521
+     NAN_WEAK_CALLBACK_DATA, NanMakeWeak
522
+ - Renamed THROW_ERROR to _NAN_THROW_ERROR
523
+ - Added NanNewBufferHandle(char*, size_t, node::smalloc::FreeCallback, void*)
524
+ - Added NanBufferUse(char*, uint32_t)
525
+ - Added NanNewContextHandle(v8::ExtensionConfiguration*,
526
+       v8::Handle<v8::ObjectTemplate>, v8::Handle<v8::Value>)
527
+ - Fixed broken NanCallback#GetFunction()
528
+ - Added optional encoding and size arguments to NanFromV8String()
529
+ - Added NanGetPointerSafe() and NanSetPointerSafe()
530
+ - Added initial test suite (to be expanded)
531
+ - Allow NanUInt32OptionValue to convert any Number object
532
+
533
+### 0.1.0 Jul 21 2013
534
+
535
+ - Added `NAN_GETTER`, `NAN_SETTER`
536
+ - Added `NanThrowError` with single Local<Value> argument
537
+ - Added `NanNewBufferHandle` with single uint32_t argument
538
+ - Added `NanHasInstance(Persistent<FunctionTemplate>&, Handle<Value>)`
539
+ - Added `Local<Function> NanCallback#GetFunction()`
540
+ - Added `NanCallback#Call(int, Local<Value>[])`
541
+ - Deprecated `NanCallback#Run(int, Local<Value>[])` in favour of Call
... ...
@@ -0,0 +1,13 @@
1
+The MIT License (MIT)
2
+=====================
3
+
4
+Copyright (c) 2018 NAN contributors
5
+-----------------------------------
6
+
7
+*NAN contributors listed at <https://github.com/nodejs/nan#contributors>*
8
+
9
+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:
10
+
11
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
12
+
13
+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.
... ...
@@ -0,0 +1,456 @@
1
+Native Abstractions for Node.js
2
+===============================
3
+
4
+**A header file filled with macro and utility goodness for making add-on development for Node.js easier across versions 0.8, 0.10, 0.12, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 and 16.**
5
+
6
+***Current version: 2.15.0***
7
+
8
+*(See [CHANGELOG.md](https://github.com/nodejs/nan/blob/master/CHANGELOG.md) for complete ChangeLog)*
9
+
10
+[![NPM](https://nodei.co/npm/nan.png?downloads=true&downloadRank=true)](https://nodei.co/npm/nan/) [![NPM](https://nodei.co/npm-dl/nan.png?months=6&height=3)](https://nodei.co/npm/nan/)
11
+
12
+[![Build Status](https://api.travis-ci.com/nodejs/nan.svg?branch=master)](https://travis-ci.com/nodejs/nan)
13
+[![Build status](https://ci.appveyor.com/api/projects/status/kh73pbm9dsju7fgh)](https://ci.appveyor.com/project/RodVagg/nan)
14
+
15
+Thanks to the crazy changes in V8 (and some in Node core), keeping native addons compiling happily across versions, particularly 0.10 to 0.12 to 4.0, is a minor nightmare. The goal of this project is to store all logic necessary to develop native Node.js addons without having to inspect `NODE_MODULE_VERSION` and get yourself into a macro-tangle.
16
+
17
+This project also contains some helper utilities that make addon development a bit more pleasant.
18
+
19
+ * **[News & Updates](#news)**
20
+ * **[Usage](#usage)**
21
+ * **[Example](#example)**
22
+ * **[API](#api)**
23
+ * **[Tests](#tests)**
24
+ * **[Known issues](#issues)**
25
+ * **[Governance & Contributing](#governance)**
26
+
27
+<a name="news"></a>
28
+
29
+## News & Updates
30
+
31
+<a name="usage"></a>
32
+
33
+## Usage
34
+
35
+Simply add **NAN** as a dependency in the *package.json* of your Node addon:
36
+
37
+``` bash
38
+$ npm install --save nan
39
+```
40
+
41
+Pull in the path to **NAN** in your *binding.gyp* so that you can use `#include <nan.h>` in your *.cpp* files:
42
+
43
+``` python
44
+"include_dirs" : [
45
+    "<!(node -e \"require('nan')\")"
46
+]
47
+```
48
+
49
+This works like a `-I<path-to-NAN>` when compiling your addon.
50
+
51
+<a name="example"></a>
52
+
53
+## Example
54
+
55
+Just getting started with Nan? Take a look at the **[Node Add-on Examples](https://github.com/nodejs/node-addon-examples)**.
56
+
57
+Refer to a [quick-start **Nan** Boilerplate](https://github.com/fcanas/node-native-boilerplate) for a ready-to-go project that utilizes basic Nan functionality.
58
+
59
+For a simpler example, see the **[async pi estimation example](https://github.com/nodejs/nan/tree/master/examples/async_pi_estimate)** in the examples directory for full code and an explanation of what this Monte Carlo Pi estimation example does. Below are just some parts of the full example that illustrate the use of **NAN**.
60
+
61
+Yet another example is **[nan-example-eol](https://github.com/CodeCharmLtd/nan-example-eol)**. It shows newline detection implemented as a native addon.
62
+
63
+Also take a look at our comprehensive **[C++ test suite](https://github.com/nodejs/nan/tree/master/test/cpp)** which has a plethora of code snippets for your pasting pleasure.
64
+
65
+<a name="api"></a>
66
+
67
+## API
68
+
69
+Additional to the NAN documentation below, please consult:
70
+
71
+* [The V8 Getting Started * Guide](https://v8.dev/docs/embed)
72
+* [V8 API Documentation](https://v8docs.nodesource.com/)
73
+* [Node Add-on Documentation](https://nodejs.org/api/addons.html)
74
+
75
+<!-- START API -->
76
+
77
+### JavaScript-accessible methods
78
+
79
+A _template_ is a blueprint for JavaScript functions and objects in a context. You can use a template to wrap C++ functions and data structures within JavaScript objects so that they can be manipulated from JavaScript. See the V8 Embedders Guide section on [Templates](https://github.com/v8/v8/wiki/Embedder%27s-Guide#templates) for further information.
80
+
81
+In order to expose functionality to JavaScript via a template, you must provide it to V8 in a form that it understands. Across the versions of V8 supported by NAN, JavaScript-accessible method signatures vary widely, NAN fully abstracts method declaration and provides you with an interface that is similar to the most recent V8 API but is backward-compatible with older versions that still use the now-deceased `v8::Argument` type.
82
+
83
+* **Method argument types**
84
+ - <a href="doc/methods.md#api_nan_function_callback_info"><b><code>Nan::FunctionCallbackInfo</code></b></a>
85
+ - <a href="doc/methods.md#api_nan_property_callback_info"><b><code>Nan::PropertyCallbackInfo</code></b></a>
86
+ - <a href="doc/methods.md#api_nan_return_value"><b><code>Nan::ReturnValue</code></b></a>
87
+* **Method declarations**
88
+ - <a href="doc/methods.md#api_nan_method"><b>Method declaration</b></a>
89
+ - <a href="doc/methods.md#api_nan_getter"><b>Getter declaration</b></a>
90
+ - <a href="doc/methods.md#api_nan_setter"><b>Setter declaration</b></a>
91
+ - <a href="doc/methods.md#api_nan_property_getter"><b>Property getter declaration</b></a>
92
+ - <a href="doc/methods.md#api_nan_property_setter"><b>Property setter declaration</b></a>
93
+ - <a href="doc/methods.md#api_nan_property_enumerator"><b>Property enumerator declaration</b></a>
94
+ - <a href="doc/methods.md#api_nan_property_deleter"><b>Property deleter declaration</b></a>
95
+ - <a href="doc/methods.md#api_nan_property_query"><b>Property query declaration</b></a>
96
+ - <a href="doc/methods.md#api_nan_index_getter"><b>Index getter declaration</b></a>
97
+ - <a href="doc/methods.md#api_nan_index_setter"><b>Index setter declaration</b></a>
98
+ - <a href="doc/methods.md#api_nan_index_enumerator"><b>Index enumerator declaration</b></a>
99
+ - <a href="doc/methods.md#api_nan_index_deleter"><b>Index deleter declaration</b></a>
100
+ - <a href="doc/methods.md#api_nan_index_query"><b>Index query declaration</b></a>
101
+* Method and template helpers
102
+ - <a href="doc/methods.md#api_nan_set_method"><b><code>Nan::SetMethod()</code></b></a>
103
+ - <a href="doc/methods.md#api_nan_set_prototype_method"><b><code>Nan::SetPrototypeMethod()</code></b></a>
104
+ - <a href="doc/methods.md#api_nan_set_accessor"><b><code>Nan::SetAccessor()</code></b></a>
105
+ - <a href="doc/methods.md#api_nan_set_named_property_handler"><b><code>Nan::SetNamedPropertyHandler()</code></b></a>
106
+ - <a href="doc/methods.md#api_nan_set_indexed_property_handler"><b><code>Nan::SetIndexedPropertyHandler()</code></b></a>
107
+ - <a href="doc/methods.md#api_nan_set_template"><b><code>Nan::SetTemplate()</code></b></a>
108
+ - <a href="doc/methods.md#api_nan_set_prototype_template"><b><code>Nan::SetPrototypeTemplate()</code></b></a>
109
+ - <a href="doc/methods.md#api_nan_set_instance_template"><b><code>Nan::SetInstanceTemplate()</code></b></a>
110
+ - <a href="doc/methods.md#api_nan_set_call_handler"><b><code>Nan::SetCallHandler()</code></b></a>
111
+ - <a href="doc/methods.md#api_nan_set_call_as_function_handler"><b><code>Nan::SetCallAsFunctionHandler()</code></b></a>
112
+
113
+### Scopes
114
+
115
+A _local handle_ is a pointer to an object. All V8 objects are accessed using handles, they are necessary because of the way the V8 garbage collector works.
116
+
117
+A handle scope can be thought of as a container for any number of handles. When you've finished with your handles, instead of deleting each one individually you can simply delete their scope.
118
+
119
+The creation of `HandleScope` objects is different across the supported versions of V8. Therefore, NAN provides its own implementations that can be used safely across these.
120
+
121
+ - <a href="doc/scopes.md#api_nan_handle_scope"><b><code>Nan::HandleScope</code></b></a>
122
+ - <a href="doc/scopes.md#api_nan_escapable_handle_scope"><b><code>Nan::EscapableHandleScope</code></b></a>
123
+
124
+Also see the V8 Embedders Guide section on [Handles and Garbage Collection](https://github.com/v8/v8/wiki/Embedder%27s%20Guide#handles-and-garbage-collection).
125
+
126
+### Persistent references
127
+
128
+An object reference that is independent of any `HandleScope` is a _persistent_ reference. Where a `Local` handle only lives as long as the `HandleScope` in which it was allocated, a `Persistent` handle remains valid until it is explicitly disposed.
129
+
130
+Due to the evolution of the V8 API, it is necessary for NAN to provide a wrapper implementation of the `Persistent` classes to supply compatibility across the V8 versions supported.
131
+
132
+ - <a href="doc/persistent.md#api_nan_persistent_base"><b><code>Nan::PersistentBase & v8::PersistentBase</code></b></a>
133
+ - <a href="doc/persistent.md#api_nan_non_copyable_persistent_traits"><b><code>Nan::NonCopyablePersistentTraits & v8::NonCopyablePersistentTraits</code></b></a>
134
+ - <a href="doc/persistent.md#api_nan_copyable_persistent_traits"><b><code>Nan::CopyablePersistentTraits & v8::CopyablePersistentTraits</code></b></a>
135
+ - <a href="doc/persistent.md#api_nan_persistent"><b><code>Nan::Persistent</code></b></a>
136
+ - <a href="doc/persistent.md#api_nan_global"><b><code>Nan::Global</code></b></a>
137
+ - <a href="doc/persistent.md#api_nan_weak_callback_info"><b><code>Nan::WeakCallbackInfo</code></b></a>
138
+ - <a href="doc/persistent.md#api_nan_weak_callback_type"><b><code>Nan::WeakCallbackType</code></b></a>
139
+
140
+Also see the V8 Embedders Guide section on [Handles and Garbage Collection](https://developers.google.com/v8/embed#handles).
141
+
142
+### New
143
+
144
+NAN provides a `Nan::New()` helper for the creation of new JavaScript objects in a way that's compatible across the supported versions of V8.
145
+
146
+ - <a href="doc/new.md#api_nan_new"><b><code>Nan::New()</code></b></a>
147
+ - <a href="doc/new.md#api_nan_undefined"><b><code>Nan::Undefined()</code></b></a>
148
+ - <a href="doc/new.md#api_nan_null"><b><code>Nan::Null()</code></b></a>
149
+ - <a href="doc/new.md#api_nan_true"><b><code>Nan::True()</code></b></a>
150
+ - <a href="doc/new.md#api_nan_false"><b><code>Nan::False()</code></b></a>
151
+ - <a href="doc/new.md#api_nan_empty_string"><b><code>Nan::EmptyString()</code></b></a>
152
+
153
+
154
+### Converters
155
+
156
+NAN contains functions that convert `v8::Value`s to other `v8::Value` types and native types. Since type conversion is not guaranteed to succeed, they return `Nan::Maybe` types. These converters can be used in place of `value->ToX()` and `value->XValue()` (where `X` is one of the types, e.g. `Boolean`) in a way that provides a consistent interface across V8 versions. Newer versions of V8 use the new `v8::Maybe` and `v8::MaybeLocal` types for these conversions, older versions don't have this functionality so it is provided by NAN.
157
+
158
+ - <a href="doc/converters.md#api_nan_to"><b><code>Nan::To()</code></b></a>
159
+
160
+### Maybe Types
161
+
162
+The `Nan::MaybeLocal` and `Nan::Maybe` types are monads that encapsulate `v8::Local` handles that _may be empty_.
163
+
164
+* **Maybe Types**
165
+  - <a href="doc/maybe_types.md#api_nan_maybe_local"><b><code>Nan::MaybeLocal</code></b></a>
166
+  - <a href="doc/maybe_types.md#api_nan_maybe"><b><code>Nan::Maybe</code></b></a>
167
+  - <a href="doc/maybe_types.md#api_nan_nothing"><b><code>Nan::Nothing</code></b></a>
168
+  - <a href="doc/maybe_types.md#api_nan_just"><b><code>Nan::Just</code></b></a>
169
+* **Maybe Helpers**
170
+  - <a href="doc/maybe_types.md#api_nan_call"><b><code>Nan::Call()</code></b></a>
171
+  - <a href="doc/maybe_types.md#api_nan_to_detail_string"><b><code>Nan::ToDetailString()</code></b></a>
172
+  - <a href="doc/maybe_types.md#api_nan_to_array_index"><b><code>Nan::ToArrayIndex()</code></b></a>
173
+  - <a href="doc/maybe_types.md#api_nan_equals"><b><code>Nan::Equals()</code></b></a>
174
+  - <a href="doc/maybe_types.md#api_nan_new_instance"><b><code>Nan::NewInstance()</code></b></a>
175
+  - <a href="doc/maybe_types.md#api_nan_get_function"><b><code>Nan::GetFunction()</code></b></a>
176
+  - <a href="doc/maybe_types.md#api_nan_set"><b><code>Nan::Set()</code></b></a>
177
+  - <a href="doc/maybe_types.md#api_nan_define_own_property"><b><code>Nan::DefineOwnProperty()</code></b></a>
178
+  - <a href="doc/maybe_types.md#api_nan_force_set"><del><b><code>Nan::ForceSet()</code></b></del></a>
179
+  - <a href="doc/maybe_types.md#api_nan_get"><b><code>Nan::Get()</code></b></a>
180
+  - <a href="doc/maybe_types.md#api_nan_get_property_attribute"><b><code>Nan::GetPropertyAttributes()</code></b></a>
181
+  - <a href="doc/maybe_types.md#api_nan_has"><b><code>Nan::Has()</code></b></a>
182
+  - <a href="doc/maybe_types.md#api_nan_delete"><b><code>Nan::Delete()</code></b></a>
183
+  - <a href="doc/maybe_types.md#api_nan_get_property_names"><b><code>Nan::GetPropertyNames()</code></b></a>
184
+  - <a href="doc/maybe_types.md#api_nan_get_own_property_names"><b><code>Nan::GetOwnPropertyNames()</code></b></a>
185
+  - <a href="doc/maybe_types.md#api_nan_set_prototype"><b><code>Nan::SetPrototype()</code></b></a>
186
+  - <a href="doc/maybe_types.md#api_nan_object_proto_to_string"><b><code>Nan::ObjectProtoToString()</code></b></a>
187
+  - <a href="doc/maybe_types.md#api_nan_has_own_property"><b><code>Nan::HasOwnProperty()</code></b></a>
188
+  - <a href="doc/maybe_types.md#api_nan_has_real_named_property"><b><code>Nan::HasRealNamedProperty()</code></b></a>
189
+  - <a href="doc/maybe_types.md#api_nan_has_real_indexed_property"><b><code>Nan::HasRealIndexedProperty()</code></b></a>
190
+  - <a href="doc/maybe_types.md#api_nan_has_real_named_callback_property"><b><code>Nan::HasRealNamedCallbackProperty()</code></b></a>
191
+  - <a href="doc/maybe_types.md#api_nan_get_real_named_property_in_prototype_chain"><b><code>Nan::GetRealNamedPropertyInPrototypeChain()</code></b></a>
192
+  - <a href="doc/maybe_types.md#api_nan_get_real_named_property"><b><code>Nan::GetRealNamedProperty()</code></b></a>
193
+  - <a href="doc/maybe_types.md#api_nan_call_as_function"><b><code>Nan::CallAsFunction()</code></b></a>
194
+  - <a href="doc/maybe_types.md#api_nan_call_as_constructor"><b><code>Nan::CallAsConstructor()</code></b></a>
195
+  - <a href="doc/maybe_types.md#api_nan_get_source_line"><b><code>Nan::GetSourceLine()</code></b></a>
196
+  - <a href="doc/maybe_types.md#api_nan_get_line_number"><b><code>Nan::GetLineNumber()</code></b></a>
197
+  - <a href="doc/maybe_types.md#api_nan_get_start_column"><b><code>Nan::GetStartColumn()</code></b></a>
198
+  - <a href="doc/maybe_types.md#api_nan_get_end_column"><b><code>Nan::GetEndColumn()</code></b></a>
199
+  - <a href="doc/maybe_types.md#api_nan_clone_element_at"><b><code>Nan::CloneElementAt()</code></b></a>
200
+  - <a href="doc/maybe_types.md#api_nan_has_private"><b><code>Nan::HasPrivate()</code></b></a>
201
+  - <a href="doc/maybe_types.md#api_nan_get_private"><b><code>Nan::GetPrivate()</code></b></a>
202
+  - <a href="doc/maybe_types.md#api_nan_set_private"><b><code>Nan::SetPrivate()</code></b></a>
203
+  - <a href="doc/maybe_types.md#api_nan_delete_private"><b><code>Nan::DeletePrivate()</code></b></a>
204
+  - <a href="doc/maybe_types.md#api_nan_make_maybe"><b><code>Nan::MakeMaybe()</code></b></a>
205
+
206
+### Script
207
+
208
+NAN provides `v8::Script` helpers as the API has changed over the supported versions of V8.
209
+
210
+ - <a href="doc/script.md#api_nan_compile_script"><b><code>Nan::CompileScript()</code></b></a>
211
+ - <a href="doc/script.md#api_nan_run_script"><b><code>Nan::RunScript()</code></b></a>
212
+ - <a href="doc/script.md#api_nan_script_origin"><b><code>Nan::ScriptOrigin</code></b></a>
213
+
214
+
215
+### JSON
216
+
217
+The _JSON_ object provides the C++ versions of the methods offered by the `JSON` object in javascript. V8 exposes these methods via the `v8::JSON` object.
218
+
219
+ - <a href="doc/json.md#api_nan_json_parse"><b><code>Nan::JSON.Parse</code></b></a>
220
+ - <a href="doc/json.md#api_nan_json_stringify"><b><code>Nan::JSON.Stringify</code></b></a>
221
+
222
+Refer to the V8 JSON object in the [V8 documentation](https://v8docs.nodesource.com/node-8.16/da/d6f/classv8_1_1_j_s_o_n.html) for more information about these methods and their arguments.
223
+
224
+### Errors
225
+
226
+NAN includes helpers for creating, throwing and catching Errors as much of this functionality varies across the supported versions of V8 and must be abstracted.
227
+
228
+Note that an Error object is simply a specialized form of `v8::Value`.
229
+
230
+Also consult the V8 Embedders Guide section on [Exceptions](https://developers.google.com/v8/embed#exceptions) for more information.
231
+
232
+ - <a href="doc/errors.md#api_nan_error"><b><code>Nan::Error()</code></b></a>
233
+ - <a href="doc/errors.md#api_nan_range_error"><b><code>Nan::RangeError()</code></b></a>
234
+ - <a href="doc/errors.md#api_nan_reference_error"><b><code>Nan::ReferenceError()</code></b></a>
235
+ - <a href="doc/errors.md#api_nan_syntax_error"><b><code>Nan::SyntaxError()</code></b></a>
236
+ - <a href="doc/errors.md#api_nan_type_error"><b><code>Nan::TypeError()</code></b></a>
237
+ - <a href="doc/errors.md#api_nan_throw_error"><b><code>Nan::ThrowError()</code></b></a>
238
+ - <a href="doc/errors.md#api_nan_throw_range_error"><b><code>Nan::ThrowRangeError()</code></b></a>
239
+ - <a href="doc/errors.md#api_nan_throw_reference_error"><b><code>Nan::ThrowReferenceError()</code></b></a>
240
+ - <a href="doc/errors.md#api_nan_throw_syntax_error"><b><code>Nan::ThrowSyntaxError()</code></b></a>
241
+ - <a href="doc/errors.md#api_nan_throw_type_error"><b><code>Nan::ThrowTypeError()</code></b></a>
242
+ - <a href="doc/errors.md#api_nan_fatal_exception"><b><code>Nan::FatalException()</code></b></a>
243
+ - <a href="doc/errors.md#api_nan_errno_exception"><b><code>Nan::ErrnoException()</code></b></a>
244
+ - <a href="doc/errors.md#api_nan_try_catch"><b><code>Nan::TryCatch</code></b></a>
245
+
246
+
247
+### Buffers
248
+
249
+NAN's `node::Buffer` helpers exist as the API has changed across supported Node versions. Use these methods to ensure compatibility.
250
+
251
+ - <a href="doc/buffers.md#api_nan_new_buffer"><b><code>Nan::NewBuffer()</code></b></a>
252
+ - <a href="doc/buffers.md#api_nan_copy_buffer"><b><code>Nan::CopyBuffer()</code></b></a>
253
+ - <a href="doc/buffers.md#api_nan_free_callback"><b><code>Nan::FreeCallback()</code></b></a>
254
+
255
+### Nan::Callback
256
+
257
+`Nan::Callback` makes it easier to use `v8::Function` handles as callbacks. A class that wraps a `v8::Function` handle, protecting it from garbage collection and making it particularly useful for storage and use across asynchronous execution.
258
+
259
+ - <a href="doc/callback.md#api_nan_callback"><b><code>Nan::Callback</code></b></a>
260
+
261
+### Asynchronous work helpers
262
+
263
+`Nan::AsyncWorker`, `Nan::AsyncProgressWorker` and `Nan::AsyncProgressQueueWorker` are helper classes that make working with asynchronous code easier.
264
+
265
+ - <a href="doc/asyncworker.md#api_nan_async_worker"><b><code>Nan::AsyncWorker</code></b></a>
266
+ - <a href="doc/asyncworker.md#api_nan_async_progress_worker"><b><code>Nan::AsyncProgressWorkerBase &amp; Nan::AsyncProgressWorker</code></b></a>
267
+ - <a href="doc/asyncworker.md#api_nan_async_progress_queue_worker"><b><code>Nan::AsyncProgressQueueWorker</code></b></a>
268
+ - <a href="doc/asyncworker.md#api_nan_async_queue_worker"><b><code>Nan::AsyncQueueWorker</code></b></a>
269
+
270
+### Strings & Bytes
271
+
272
+Miscellaneous string & byte encoding and decoding functionality provided for compatibility across supported versions of V8 and Node. Implemented by NAN to ensure that all encoding types are supported, even for older versions of Node where they are missing.
273
+
274
+ - <a href="doc/string_bytes.md#api_nan_encoding"><b><code>Nan::Encoding</code></b></a>
275
+ - <a href="doc/string_bytes.md#api_nan_encode"><b><code>Nan::Encode()</code></b></a>
276
+ - <a href="doc/string_bytes.md#api_nan_decode_bytes"><b><code>Nan::DecodeBytes()</code></b></a>
277
+ - <a href="doc/string_bytes.md#api_nan_decode_write"><b><code>Nan::DecodeWrite()</code></b></a>
278
+
279
+
280
+### Object Wrappers
281
+
282
+The `ObjectWrap` class can be used to make wrapped C++ objects and a factory of wrapped objects.
283
+
284
+ - <a href="doc/object_wrappers.md#api_nan_object_wrap"><b><code>Nan::ObjectWrap</code></b></a>
285
+
286
+
287
+### V8 internals
288
+
289
+The hooks to access V8 internals—including GC and statistics—are different across the supported versions of V8, therefore NAN provides its own hooks that call the appropriate V8 methods.
290
+
291
+ - <a href="doc/v8_internals.md#api_nan_gc_callback"><b><code>NAN_GC_CALLBACK()</code></b></a>
292
+ - <a href="doc/v8_internals.md#api_nan_add_gc_epilogue_callback"><b><code>Nan::AddGCEpilogueCallback()</code></b></a>
293
+ - <a href="doc/v8_internals.md#api_nan_remove_gc_epilogue_callback"><b><code>Nan::RemoveGCEpilogueCallback()</code></b></a>
294
+ - <a href="doc/v8_internals.md#api_nan_add_gc_prologue_callback"><b><code>Nan::AddGCPrologueCallback()</code></b></a>
295
+ - <a href="doc/v8_internals.md#api_nan_remove_gc_prologue_callback"><b><code>Nan::RemoveGCPrologueCallback()</code></b></a>
296
+ - <a href="doc/v8_internals.md#api_nan_get_heap_statistics"><b><code>Nan::GetHeapStatistics()</code></b></a>
297
+ - <a href="doc/v8_internals.md#api_nan_set_counter_function"><b><code>Nan::SetCounterFunction()</code></b></a>
298
+ - <a href="doc/v8_internals.md#api_nan_set_create_histogram_function"><b><code>Nan::SetCreateHistogramFunction()</code></b></a>
299
+ - <a href="doc/v8_internals.md#api_nan_set_add_histogram_sample_function"><b><code>Nan::SetAddHistogramSampleFunction()</code></b></a>
300
+ - <a href="doc/v8_internals.md#api_nan_idle_notification"><b><code>Nan::IdleNotification()</code></b></a>
301
+ - <a href="doc/v8_internals.md#api_nan_low_memory_notification"><b><code>Nan::LowMemoryNotification()</code></b></a>
302
+ - <a href="doc/v8_internals.md#api_nan_context_disposed_notification"><b><code>Nan::ContextDisposedNotification()</code></b></a>
303
+ - <a href="doc/v8_internals.md#api_nan_get_internal_field_pointer"><b><code>Nan::GetInternalFieldPointer()</code></b></a>
304
+ - <a href="doc/v8_internals.md#api_nan_set_internal_field_pointer"><b><code>Nan::SetInternalFieldPointer()</code></b></a>
305
+ - <a href="doc/v8_internals.md#api_nan_adjust_external_memory"><b><code>Nan::AdjustExternalMemory()</code></b></a>
306
+
307
+
308
+### Miscellaneous V8 Helpers
309
+
310
+ - <a href="doc/v8_misc.md#api_nan_utf8_string"><b><code>Nan::Utf8String</code></b></a>
311
+ - <a href="doc/v8_misc.md#api_nan_get_current_context"><b><code>Nan::GetCurrentContext()</code></b></a>
312
+ - <a href="doc/v8_misc.md#api_nan_set_isolate_data"><b><code>Nan::SetIsolateData()</code></b></a>
313
+ - <a href="doc/v8_misc.md#api_nan_get_isolate_data"><b><code>Nan::GetIsolateData()</code></b></a>
314
+ - <a href="doc/v8_misc.md#api_nan_typedarray_contents"><b><code>Nan::TypedArrayContents</code></b></a>
315
+
316
+
317
+### Miscellaneous Node Helpers
318
+
319
+ - <a href="doc/node_misc.md#api_nan_asyncresource"><b><code>Nan::AsyncResource</code></b></a>
320
+ - <a href="doc/node_misc.md#api_nan_make_callback"><b><code>Nan::MakeCallback()</code></b></a>
321
+ - <a href="doc/node_misc.md#api_nan_module_init"><b><code>NAN_MODULE_INIT()</code></b></a>
322
+ - <a href="doc/node_misc.md#api_nan_export"><b><code>Nan::Export()</code></b></a>
323
+
324
+<!-- END API -->
325
+
326
+
327
+<a name="tests"></a>
328
+
329
+### Tests
330
+
331
+To run the NAN tests do:
332
+
333
+``` sh
334
+npm install
335
+npm run-script rebuild-tests
336
+npm test
337
+```
338
+
339
+Or just:
340
+
341
+``` sh
342
+npm install
343
+make test
344
+```
345
+
346
+<a name="issues"></a>
347
+
348
+## Known issues
349
+
350
+### Compiling against Node.js 0.12 on OSX
351
+
352
+With new enough compilers available on OSX, the versions of V8 headers corresponding to Node.js 0.12
353
+do not compile anymore. The error looks something like:
354
+
355
+```
356
+❯   CXX(target) Release/obj.target/accessors/cpp/accessors.o
357
+In file included from ../cpp/accessors.cpp:9:
358
+In file included from ../../nan.h:51:
359
+In file included from /Users/ofrobots/.node-gyp/0.12.18/include/node/node.h:61:
360
+/Users/ofrobots/.node-gyp/0.12.18/include/node/v8.h:5800:54: error: 'CreateHandle' is a protected member of 'v8::HandleScope'
361
+  return Handle<T>(reinterpret_cast<T*>(HandleScope::CreateHandle(
362
+                                        ~~~~~~~~~~~~~^~~~~~~~~~~~
363
+```
364
+
365
+This can be worked around by patching your local versions of v8.h corresponding to Node 0.12 to make
366
+`v8::Handle` a friend of `v8::HandleScope`. Since neither Node.js not V8 support this release line anymore
367
+this patch cannot be released by either project in an official release.
368
+
369
+For this reason, we do not test against Node.js 0.12 on OSX in this project's CI. If you need to support
370
+that configuration, you will need to either get an older compiler, or apply a source patch to the version
371
+of V8 headers as a workaround.
372
+
373
+<a name="governance"></a>
374
+
375
+## Governance & Contributing
376
+
377
+NAN is governed by the [Node.js Addon API Working Group](https://github.com/nodejs/CTC/blob/master/WORKING_GROUPS.md#addon-api)
378
+
379
+### Addon API Working Group (WG)
380
+
381
+The NAN project is jointly governed by a Working Group which is responsible for high-level guidance of the project.
382
+
383
+Members of the WG are also known as Collaborators, there is no distinction between the two, unlike other Node.js projects.
384
+
385
+The WG has final authority over this project including:
386
+
387
+* Technical direction
388
+* Project governance and process (including this policy)
389
+* Contribution policy
390
+* GitHub repository hosting
391
+* Maintaining the list of additional Collaborators
392
+
393
+For the current list of WG members, see the project [README.md](./README.md#collaborators).
394
+
395
+Individuals making significant and valuable contributions are made members of the WG and given commit-access to the project. These individuals are identified by the WG and their addition to the WG is discussed via GitHub and requires unanimous consensus amongst those WG members participating in the discussion with a quorum of 50% of WG members required for acceptance of the vote.
396
+
397
+_Note:_ If you make a significant contribution and are not considered for commit-access log an issue or contact a WG member directly.
398
+
399
+For the current list of WG members / Collaborators, see the project [README.md](./README.md#collaborators).
400
+
401
+### Consensus Seeking Process
402
+
403
+The WG follows a [Consensus Seeking](https://en.wikipedia.org/wiki/Consensus-seeking_decision-making) decision making model.
404
+
405
+Modifications of the contents of the NAN repository are made on a collaborative basis. Anybody with a GitHub account may propose a modification via pull request and it will be considered by the WG. All pull requests must be reviewed and accepted by a WG member with sufficient expertise who is able to take full responsibility for the change. In the case of pull requests proposed by an existing WG member, an additional WG member is required for sign-off. Consensus should be sought if additional WG members participate and there is disagreement around a particular modification.
406
+
407
+If a change proposal cannot reach a consensus, a WG member can call for a vote amongst the members of the WG. Simple majority wins.
408
+
409
+<a id="developers-certificate-of-origin"></a>
410
+
411
+## Developer's Certificate of Origin 1.1
412
+
413
+By making a contribution to this project, I certify that:
414
+
415
+* (a) The contribution was created in whole or in part by me and I
416
+  have the right to submit it under the open source license
417
+  indicated in the file; or
418
+
419
+* (b) The contribution is based upon previous work that, to the best
420
+  of my knowledge, is covered under an appropriate open source
421
+  license and I have the right under that license to submit that
422
+  work with modifications, whether created in whole or in part
423
+  by me, under the same open source license (unless I am
424
+  permitted to submit under a different license), as indicated
425
+  in the file; or
426
+
427
+* (c) The contribution was provided directly to me by some other
428
+  person who certified (a), (b) or (c) and I have not modified
429
+  it.
430
+
431
+* (d) I understand and agree that this project and the contribution
432
+  are public and that a record of the contribution (including all
433
+  personal information I submit with it, including my sign-off) is
434
+  maintained indefinitely and may be redistributed consistent with
435
+  this project or the open source license(s) involved.
436
+
437
+<a name="collaborators"></a>
438
+
439
+### WG Members / Collaborators
440
+
441
+<table><tbody>
442
+<tr><th align="left">Rod Vagg</th><td><a href="https://github.com/rvagg">GitHub/rvagg</a></td><td><a href="http://twitter.com/rvagg">Twitter/@rvagg</a></td></tr>
443
+<tr><th align="left">Benjamin Byholm</th><td><a href="https://github.com/kkoopa/">GitHub/kkoopa</a></td><td>-</td></tr>
444
+<tr><th align="left">Trevor Norris</th><td><a href="https://github.com/trevnorris">GitHub/trevnorris</a></td><td><a href="http://twitter.com/trevnorris">Twitter/@trevnorris</a></td></tr>
445
+<tr><th align="left">Nathan Rajlich</th><td><a href="https://github.com/TooTallNate">GitHub/TooTallNate</a></td><td><a href="http://twitter.com/TooTallNate">Twitter/@TooTallNate</a></td></tr>
446
+<tr><th align="left">Brett Lawson</th><td><a href="https://github.com/brett19">GitHub/brett19</a></td><td><a href="http://twitter.com/brett19x">Twitter/@brett19x</a></td></tr>
447
+<tr><th align="left">Ben Noordhuis</th><td><a href="https://github.com/bnoordhuis">GitHub/bnoordhuis</a></td><td><a href="http://twitter.com/bnoordhuis">Twitter/@bnoordhuis</a></td></tr>
448
+<tr><th align="left">David Siegel</th><td><a href="https://github.com/agnat">GitHub/agnat</a></td><td><a href="http://twitter.com/agnat">Twitter/@agnat</a></td></tr>
449
+<tr><th align="left">Michael Ira Krufky</th><td><a href="https://github.com/mkrufky">GitHub/mkrufky</a></td><td><a href="http://twitter.com/mkrufky">Twitter/@mkrufky</a></td></tr>
450
+</tbody></table>
451
+
452
+## Licence &amp; copyright
453
+
454
+Copyright (c) 2018 NAN WG Members / Collaborators (listed above).
455
+
456
+Native Abstractions for Node.js is licensed under an MIT license. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.
... ...
@@ -0,0 +1,146 @@
1
+## Asynchronous work helpers
2
+
3
+`Nan::AsyncWorker`, `Nan::AsyncProgressWorker` and `Nan::AsyncProgressQueueWorker` are helper classes that make working with asynchronous code easier.
4
+
5
+ - <a href="#api_nan_async_worker"><b><code>Nan::AsyncWorker</code></b></a>
6
+ - <a href="#api_nan_async_progress_worker"><b><code>Nan::AsyncProgressWorkerBase &amp; Nan::AsyncProgressWorker</code></b></a>
7
+ - <a href="#api_nan_async_progress_queue_worker"><b><code>Nan::AsyncProgressQueueWorker</code></b></a>
8
+ - <a href="#api_nan_async_queue_worker"><b><code>Nan::AsyncQueueWorker</code></b></a>
9
+
10
+<a name="api_nan_async_worker"></a>
11
+### Nan::AsyncWorker
12
+
13
+`Nan::AsyncWorker` is an _abstract_ class that you can subclass to have much of the annoying asynchronous queuing and handling taken care of for you. It can even store arbitrary V8 objects for you and have them persist while the asynchronous work is in progress.
14
+
15
+This class internally handles the details of creating an [`AsyncResource`][AsyncResource], and running the callback in the
16
+correct async context. To be able to identify the async resources created by this class in async-hooks, provide a
17
+`resource_name` to the constructor. It is recommended that the module name be used as a prefix to the `resource_name` to avoid
18
+collisions in the names. For more details see [`AsyncResource`][AsyncResource] documentation.  The `resource_name` needs to stay valid for the lifetime of the worker instance.
19
+
20
+Definition:
21
+
22
+```c++
23
+class AsyncWorker {
24
+ public:
25
+  explicit AsyncWorker(Callback *callback_, const char* resource_name = "nan:AsyncWorker");
26
+
27
+  virtual ~AsyncWorker();
28
+
29
+  virtual void WorkComplete();
30
+
31
+  void SaveToPersistent(const char *key, const v8::Local<v8::Value> &value);
32
+
33
+  void SaveToPersistent(const v8::Local<v8::String> &key,
34
+                        const v8::Local<v8::Value> &value);
35
+
36
+  void SaveToPersistent(uint32_t index,
37
+                        const v8::Local<v8::Value> &value);
38
+
39
+  v8::Local<v8::Value> GetFromPersistent(const char *key) const;
40
+
41
+  v8::Local<v8::Value> GetFromPersistent(const v8::Local<v8::String> &key) const;
42
+
43
+  v8::Local<v8::Value> GetFromPersistent(uint32_t index) const;
44
+
45
+  virtual void Execute() = 0;
46
+
47
+  uv_work_t request;
48
+
49
+  virtual void Destroy();
50
+
51
+ protected:
52
+  Persistent<v8::Object> persistentHandle;
53
+
54
+  Callback *callback;
55
+
56
+  virtual void HandleOKCallback();
57
+
58
+  virtual void HandleErrorCallback();
59
+
60
+  void SetErrorMessage(const char *msg);
61
+
62
+  const char* ErrorMessage();
63
+};
64
+```
65
+
66
+<a name="api_nan_async_progress_worker"></a>
67
+### Nan::AsyncProgressWorkerBase &amp; Nan::AsyncProgressWorker
68
+
69
+`Nan::AsyncProgressWorkerBase` is an _abstract_ class template that extends `Nan::AsyncWorker` and adds additional progress reporting callbacks that can be used during the asynchronous work execution to provide progress data back to JavaScript.
70
+
71
+Previously the definition of `Nan::AsyncProgressWorker` only allowed sending `const char` data. Now extending `Nan::AsyncProgressWorker` will yield an instance of the implicit `Nan::AsyncProgressWorkerBase` template with type `<char>` for compatibility.
72
+
73
+`Nan::AsyncProgressWorkerBase` &amp; `Nan::AsyncProgressWorker` is intended for best-effort delivery of nonessential progress messages, e.g. a progress bar.  The last event sent before the main thread is woken will be delivered.
74
+
75
+Definition:
76
+
77
+```c++
78
+template<class T>
79
+class AsyncProgressWorkerBase<T> : public AsyncWorker {
80
+ public:
81
+  explicit AsyncProgressWorkerBase(Callback *callback_, const char* resource_name = ...);
82
+
83
+  virtual ~AsyncProgressWorkerBase();
84
+
85
+  void WorkProgress();
86
+
87
+  class ExecutionProgress {
88
+   public:
89
+    void Signal() const;
90
+    void Send(const T* data, size_t count) const;
91
+  };
92
+
93
+  virtual void Execute(const ExecutionProgress& progress) = 0;
94
+
95
+  virtual void HandleProgressCallback(const T *data, size_t count) = 0;
96
+
97
+  virtual void Destroy();
98
+};
99
+
100
+typedef AsyncProgressWorkerBase<T> AsyncProgressWorker;
101
+```
102
+
103
+<a name="api_nan_async_progress_queue_worker"></a>
104
+### Nan::AsyncProgressQueueWorker
105
+
106
+`Nan::AsyncProgressQueueWorker` is an _abstract_ class template that extends `Nan::AsyncWorker` and adds additional progress reporting callbacks that can be used during the asynchronous work execution to provide progress data back to JavaScript.
107
+
108
+`Nan::AsyncProgressQueueWorker` behaves exactly the same as `Nan::AsyncProgressWorker`, except all events are queued and delivered to the main thread.
109
+
110
+Definition:
111
+
112
+```c++
113
+template<class T>
114
+class AsyncProgressQueueWorker<T> : public AsyncWorker {
115
+ public:
116
+  explicit AsyncProgressQueueWorker(Callback *callback_, const char* resource_name = "nan:AsyncProgressQueueWorker");
117
+
118
+  virtual ~AsyncProgressQueueWorker();
119
+
120
+  void WorkProgress();
121
+
122
+  class ExecutionProgress {
123
+   public:
124
+    void Send(const T* data, size_t count) const;
125
+  };
126
+
127
+  virtual void Execute(const ExecutionProgress& progress) = 0;
128
+
129
+  virtual void HandleProgressCallback(const T *data, size_t count) = 0;
130
+
131
+  virtual void Destroy();
132
+};
133
+```
134
+
135
+<a name="api_nan_async_queue_worker"></a>
136
+### Nan::AsyncQueueWorker
137
+
138
+`Nan::AsyncQueueWorker` will run a `Nan::AsyncWorker` asynchronously via libuv. Both the `execute` and `after_work` steps are taken care of for you. Most of the logic for this is embedded in `Nan::AsyncWorker`.
139
+
140
+Definition:
141
+
142
+```c++
143
+void AsyncQueueWorker(AsyncWorker *);
144
+```
145
+
146
+[AsyncResource]: node_misc.md#api_nan_asyncresource
... ...
@@ -0,0 +1,54 @@
1
+## Buffers
2
+
3
+NAN's `node::Buffer` helpers exist as the API has changed across supported Node versions. Use these methods to ensure compatibility.
4
+
5
+ - <a href="#api_nan_new_buffer"><b><code>Nan::NewBuffer()</code></b></a>
6
+ - <a href="#api_nan_copy_buffer"><b><code>Nan::CopyBuffer()</code></b></a>
7
+ - <a href="#api_nan_free_callback"><b><code>Nan::FreeCallback()</code></b></a>
8
+
9
+<a name="api_nan_new_buffer"></a>
10
+### Nan::NewBuffer()
11
+
12
+Allocate a new `node::Buffer` object with the specified size and optional data. Calls `node::Buffer::New()`.
13
+
14
+Note that when creating a `Buffer` using `Nan::NewBuffer()` and an existing `char*`, it is assumed that the ownership of the pointer is being transferred to the new `Buffer` for management.
15
+When a `node::Buffer` instance is garbage collected and a `FreeCallback` has not been specified, `data` will be disposed of via a call to `free()`.
16
+You _must not_ free the memory space manually once you have created a `Buffer` in this way.
17
+
18
+Signature:
19
+
20
+```c++
21
+Nan::MaybeLocal<v8::Object> Nan::NewBuffer(uint32_t size)
22
+Nan::MaybeLocal<v8::Object> Nan::NewBuffer(char* data, uint32_t size)
23
+Nan::MaybeLocal<v8::Object> Nan::NewBuffer(char *data,
24
+                                           size_t length,
25
+                                           Nan::FreeCallback callback,
26
+                                           void *hint)
27
+```
28
+
29
+
30
+<a name="api_nan_copy_buffer"></a>
31
+### Nan::CopyBuffer()
32
+
33
+Similar to [`Nan::NewBuffer()`](#api_nan_new_buffer) except that an implicit memcpy will occur within Node. Calls `node::Buffer::Copy()`.
34
+
35
+Management of the `char*` is left to the user, you should manually free the memory space if necessary as the new `Buffer` will have its own copy.
36
+
37
+Signature:
38
+
39
+```c++
40
+Nan::MaybeLocal<v8::Object> Nan::CopyBuffer(const char *data, uint32_t size)
41
+```
42
+
43
+
44
+<a name="api_nan_free_callback"></a>
45
+### Nan::FreeCallback()
46
+
47
+A free callback that can be provided to [`Nan::NewBuffer()`](#api_nan_new_buffer).
48
+The supplied callback will be invoked when the `Buffer` undergoes garbage collection.
49
+
50
+Signature:
51
+
52
+```c++
53
+typedef void (*FreeCallback)(char *data, void *hint);
54
+```
... ...
@@ -0,0 +1,76 @@
1
+## Nan::Callback
2
+
3
+`Nan::Callback` makes it easier to use `v8::Function` handles as callbacks. A class that wraps a `v8::Function` handle, protecting it from garbage collection and making it particularly useful for storage and use across asynchronous execution.
4
+
5
+ - <a href="#api_nan_callback"><b><code>Nan::Callback</code></b></a>
6
+
7
+<a name="api_nan_callback"></a>
8
+### Nan::Callback
9
+
10
+```c++
11
+class Callback {
12
+ public:
13
+  Callback();
14
+
15
+  explicit Callback(const v8::Local<v8::Function> &fn);
16
+
17
+  ~Callback();
18
+
19
+  bool operator==(const Callback &other) const;
20
+
21
+  bool operator!=(const Callback &other) const;
22
+
23
+  v8::Local<v8::Function> operator*() const;
24
+
25
+  MaybeLocal<v8::Value> operator()(AsyncResource* async_resource,
26
+                                   v8::Local<v8::Object> target,
27
+                                   int argc = 0,
28
+                                   v8::Local<v8::Value> argv[] = 0) const;
29
+
30
+  MaybeLocal<v8::Value> operator()(AsyncResource* async_resource,
31
+                                   int argc = 0,
32
+                                   v8::Local<v8::Value> argv[] = 0) const;
33
+
34
+  void SetFunction(const v8::Local<v8::Function> &fn);
35
+
36
+  v8::Local<v8::Function> GetFunction() const;
37
+
38
+  bool IsEmpty() const;
39
+
40
+  void Reset(const v8::Local<v8::Function> &fn);
41
+
42
+  void Reset();
43
+
44
+  MaybeLocal<v8::Value> Call(v8::Local<v8::Object> target,
45
+                            int argc,
46
+                            v8::Local<v8::Value> argv[],
47
+                            AsyncResource* async_resource) const;
48
+  MaybeLocal<v8::Value> Call(int argc,
49
+                             v8::Local<v8::Value> argv[],
50
+                             AsyncResource* async_resource) const;
51
+
52
+  // Deprecated versions. Use the versions that accept an async_resource instead
53
+  // as they run the callback in the correct async context as specified by the
54
+  // resource. If you want to call a synchronous JS function (i.e. on a
55
+  // non-empty JS stack), you can use Nan::Call instead.
56
+  v8::Local<v8::Value> operator()(v8::Local<v8::Object> target,
57
+                                  int argc = 0,
58
+                                  v8::Local<v8::Value> argv[] = 0) const;
59
+
60
+  v8::Local<v8::Value> operator()(int argc = 0,
61
+                                  v8::Local<v8::Value> argv[] = 0) const;
62
+  v8::Local<v8::Value> Call(v8::Local<v8::Object> target,
63
+                            int argc,
64
+                            v8::Local<v8::Value> argv[]) const;
65
+
66
+  v8::Local<v8::Value> Call(int argc, v8::Local<v8::Value> argv[]) const;
67
+};
68
+```
69
+
70
+Example usage:
71
+
72
+```c++
73
+v8::Local<v8::Function> function;
74
+Nan::Callback callback(function);
75
+callback.Call(0, 0);
76
+```
... ...
@@ -0,0 +1,41 @@
1
+## Converters
2
+
3
+NAN contains functions that convert `v8::Value`s to other `v8::Value` types and native types. Since type conversion is not guaranteed to succeed, they return `Nan::Maybe` types. These converters can be used in place of `value->ToX()` and `value->XValue()` (where `X` is one of the types, e.g. `Boolean`) in a way that provides a consistent interface across V8 versions. Newer versions of V8 use the new `v8::Maybe` and `v8::MaybeLocal` types for these conversions, older versions don't have this functionality so it is provided by NAN.
4
+
5
+ - <a href="#api_nan_to"><b><code>Nan::To()</code></b></a>
6
+
7
+<a name="api_nan_to"></a>
8
+### Nan::To()
9
+
10
+Converts a `v8::Local<v8::Value>` to a different subtype of `v8::Value` or to a native data type. Returns a `Nan::MaybeLocal<>` or a `Nan::Maybe<>` accordingly.
11
+
12
+See [maybe_types.md](./maybe_types.md) for more information on `Nan::Maybe` types.
13
+
14
+Signatures:
15
+
16
+```c++
17
+// V8 types
18
+Nan::MaybeLocal<v8::Boolean> Nan::To<v8::Boolean>(v8::Local<v8::Value> val);
19
+Nan::MaybeLocal<v8::Int32> Nan::To<v8::Int32>(v8::Local<v8::Value> val);
20
+Nan::MaybeLocal<v8::Integer> Nan::To<v8::Integer>(v8::Local<v8::Value> val);
21
+Nan::MaybeLocal<v8::Object> Nan::To<v8::Object>(v8::Local<v8::Value> val);
22
+Nan::MaybeLocal<v8::Number> Nan::To<v8::Number>(v8::Local<v8::Value> val);
23
+Nan::MaybeLocal<v8::String> Nan::To<v8::String>(v8::Local<v8::Value> val);
24
+Nan::MaybeLocal<v8::Uint32> Nan::To<v8::Uint32>(v8::Local<v8::Value> val);
25
+
26
+// Native types
27
+Nan::Maybe<bool> Nan::To<bool>(v8::Local<v8::Value> val);
28
+Nan::Maybe<double> Nan::To<double>(v8::Local<v8::Value> val);
29
+Nan::Maybe<int32_t> Nan::To<int32_t>(v8::Local<v8::Value> val);
30
+Nan::Maybe<int64_t> Nan::To<int64_t>(v8::Local<v8::Value> val);
31
+Nan::Maybe<uint32_t> Nan::To<uint32_t>(v8::Local<v8::Value> val);
32
+```
33
+
34
+### Example
35
+
36
+```c++
37
+v8::Local<v8::Value> val;
38
+Nan::MaybeLocal<v8::String> str = Nan::To<v8::String>(val);
39
+Nan::Maybe<double> d = Nan::To<double>(val);
40
+```
41
+
... ...
@@ -0,0 +1,226 @@
1
+## Errors
2
+
3
+NAN includes helpers for creating, throwing and catching Errors as much of this functionality varies across the supported versions of V8 and must be abstracted.
4
+
5
+Note that an Error object is simply a specialized form of `v8::Value`.
6
+
7
+Also consult the V8 Embedders Guide section on [Exceptions](https://developers.google.com/v8/embed#exceptions) for more information.
8
+
9
+ - <a href="#api_nan_error"><b><code>Nan::Error()</code></b></a>
10
+ - <a href="#api_nan_range_error"><b><code>Nan::RangeError()</code></b></a>
11
+ - <a href="#api_nan_reference_error"><b><code>Nan::ReferenceError()</code></b></a>
12
+ - <a href="#api_nan_syntax_error"><b><code>Nan::SyntaxError()</code></b></a>
13
+ - <a href="#api_nan_type_error"><b><code>Nan::TypeError()</code></b></a>
14
+ - <a href="#api_nan_throw_error"><b><code>Nan::ThrowError()</code></b></a>
15
+ - <a href="#api_nan_throw_range_error"><b><code>Nan::ThrowRangeError()</code></b></a>
16
+ - <a href="#api_nan_throw_reference_error"><b><code>Nan::ThrowReferenceError()</code></b></a>
17
+ - <a href="#api_nan_throw_syntax_error"><b><code>Nan::ThrowSyntaxError()</code></b></a>
18
+ - <a href="#api_nan_throw_type_error"><b><code>Nan::ThrowTypeError()</code></b></a>
19
+ - <a href="#api_nan_fatal_exception"><b><code>Nan::FatalException()</code></b></a>
20
+ - <a href="#api_nan_errno_exception"><b><code>Nan::ErrnoException()</code></b></a>
21
+ - <a href="#api_nan_try_catch"><b><code>Nan::TryCatch</code></b></a>
22
+
23
+
24
+<a name="api_nan_error"></a>
25
+### Nan::Error()
26
+
27
+Create a new Error object using the [v8::Exception](https://v8docs.nodesource.com/node-8.16/da/d6a/classv8_1_1_exception.html) class in a way that is compatible across the supported versions of V8.
28
+
29
+Note that an Error object is simply a specialized form of `v8::Value`.
30
+
31
+Signature:
32
+
33
+```c++
34
+v8::Local<v8::Value> Nan::Error(const char *msg);
35
+v8::Local<v8::Value> Nan::Error(v8::Local<v8::String> msg);
36
+```
37
+
38
+
39
+<a name="api_nan_range_error"></a>
40
+### Nan::RangeError()
41
+
42
+Create a new RangeError object using the [v8::Exception](https://v8docs.nodesource.com/node-8.16/da/d6a/classv8_1_1_exception.html) class in a way that is compatible across the supported versions of V8.
43
+
44
+Note that an RangeError object is simply a specialized form of `v8::Value`.
45
+
46
+Signature:
47
+
48
+```c++
49
+v8::Local<v8::Value> Nan::RangeError(const char *msg);
50
+v8::Local<v8::Value> Nan::RangeError(v8::Local<v8::String> msg);
51
+```
52
+
53
+
54
+<a name="api_nan_reference_error"></a>
55
+### Nan::ReferenceError()
56
+
57
+Create a new ReferenceError object using the [v8::Exception](https://v8docs.nodesource.com/node-8.16/da/d6a/classv8_1_1_exception.html) class in a way that is compatible across the supported versions of V8.
58
+
59
+Note that an ReferenceError object is simply a specialized form of `v8::Value`.
60
+
61
+Signature:
62
+
63
+```c++
64
+v8::Local<v8::Value> Nan::ReferenceError(const char *msg);
65
+v8::Local<v8::Value> Nan::ReferenceError(v8::Local<v8::String> msg);
66
+```
67
+
68
+
69
+<a name="api_nan_syntax_error"></a>
70
+### Nan::SyntaxError()
71
+
72
+Create a new SyntaxError object using the [v8::Exception](https://v8docs.nodesource.com/node-8.16/da/d6a/classv8_1_1_exception.html) class in a way that is compatible across the supported versions of V8.
73
+
74
+Note that an SyntaxError object is simply a specialized form of `v8::Value`.
75
+
76
+Signature:
77
+
78
+```c++
79
+v8::Local<v8::Value> Nan::SyntaxError(const char *msg);
80
+v8::Local<v8::Value> Nan::SyntaxError(v8::Local<v8::String> msg);
81
+```
82
+
83
+
84
+<a name="api_nan_type_error"></a>
85
+### Nan::TypeError()
86
+
87
+Create a new TypeError object using the [v8::Exception](https://v8docs.nodesource.com/node-8.16/da/d6a/classv8_1_1_exception.html) class in a way that is compatible across the supported versions of V8.
88
+
89
+Note that an TypeError object is simply a specialized form of `v8::Value`.
90
+
91
+Signature:
92
+
93
+```c++
94
+v8::Local<v8::Value> Nan::TypeError(const char *msg);
95
+v8::Local<v8::Value> Nan::TypeError(v8::Local<v8::String> msg);
96
+```
97
+
98
+
99
+<a name="api_nan_throw_error"></a>
100
+### Nan::ThrowError()
101
+
102
+Throw an Error object (a specialized `v8::Value` as above) in the current context. If a `msg` is provided, a new Error object will be created.
103
+
104
+Signature:
105
+
106
+```c++
107
+void Nan::ThrowError(const char *msg);
108
+void Nan::ThrowError(v8::Local<v8::String> msg);
109
+void Nan::ThrowError(v8::Local<v8::Value> error);
110
+```
111
+
112
+
113
+<a name="api_nan_throw_range_error"></a>
114
+### Nan::ThrowRangeError()
115
+
116
+Throw an RangeError object (a specialized `v8::Value` as above) in the current context. If a `msg` is provided, a new RangeError object will be created.
117
+
118
+Signature:
119
+
120
+```c++
121
+void Nan::ThrowRangeError(const char *msg);
122
+void Nan::ThrowRangeError(v8::Local<v8::String> msg);
123
+void Nan::ThrowRangeError(v8::Local<v8::Value> error);
124
+```
125
+
126
+
127
+<a name="api_nan_throw_reference_error"></a>
128
+### Nan::ThrowReferenceError()
129
+
130
+Throw an ReferenceError object (a specialized `v8::Value` as above) in the current context. If a `msg` is provided, a new ReferenceError object will be created.
131
+
132
+Signature:
133
+
134
+```c++
135
+void Nan::ThrowReferenceError(const char *msg);
136
+void Nan::ThrowReferenceError(v8::Local<v8::String> msg);
137
+void Nan::ThrowReferenceError(v8::Local<v8::Value> error);
138
+```
139
+
140
+
141
+<a name="api_nan_throw_syntax_error"></a>
142
+### Nan::ThrowSyntaxError()
143
+
144
+Throw an SyntaxError object (a specialized `v8::Value` as above) in the current context. If a `msg` is provided, a new SyntaxError object will be created.
145
+
146
+Signature:
147
+
148
+```c++
149
+void Nan::ThrowSyntaxError(const char *msg);
150
+void Nan::ThrowSyntaxError(v8::Local<v8::String> msg);
151
+void Nan::ThrowSyntaxError(v8::Local<v8::Value> error);
152
+```
153
+
154
+
155
+<a name="api_nan_throw_type_error"></a>
156
+### Nan::ThrowTypeError()
157
+
158
+Throw an TypeError object (a specialized `v8::Value` as above) in the current context. If a `msg` is provided, a new TypeError object will be created.
159
+
160
+Signature:
161
+
162
+```c++
163
+void Nan::ThrowTypeError(const char *msg);
164
+void Nan::ThrowTypeError(v8::Local<v8::String> msg);
165
+void Nan::ThrowTypeError(v8::Local<v8::Value> error);
166
+```
167
+
168
+<a name="api_nan_fatal_exception"></a>
169
+### Nan::FatalException()
170
+
171
+Replaces `node::FatalException()` which has a different API across supported versions of Node. For use with [`Nan::TryCatch`](#api_nan_try_catch).
172
+
173
+Signature:
174
+
175
+```c++
176
+void Nan::FatalException(const Nan::TryCatch& try_catch);
177
+```
178
+
179
+<a name="api_nan_errno_exception"></a>
180
+### Nan::ErrnoException()
181
+
182
+Replaces `node::ErrnoException()` which has a different API across supported versions of Node. 
183
+
184
+Signature:
185
+
186
+```c++
187
+v8::Local<v8::Value> Nan::ErrnoException(int errorno,
188
+                                         const char* syscall = NULL,
189
+                                         const char* message = NULL,
190
+                                         const char* path = NULL);
191
+```
192
+
193
+
194
+<a name="api_nan_try_catch"></a>
195
+### Nan::TryCatch
196
+
197
+A simple wrapper around [`v8::TryCatch`](https://v8docs.nodesource.com/node-8.16/d4/dc6/classv8_1_1_try_catch.html) compatible with all supported versions of V8. Can be used as a direct replacement in most cases. See also [`Nan::FatalException()`](#api_nan_fatal_exception) for an internal use compatible with `node::FatalException`.
198
+
199
+Signature:
200
+
201
+```c++
202
+class Nan::TryCatch {
203
+ public:
204
+  Nan::TryCatch();
205
+
206
+  bool HasCaught() const;
207
+
208
+  bool CanContinue() const;
209
+
210
+  v8::Local<v8::Value> ReThrow();
211
+
212
+  v8::Local<v8::Value> Exception() const;
213
+
214
+  // Nan::MaybeLocal for older versions of V8
215
+  v8::MaybeLocal<v8::Value> StackTrace() const;
216
+
217
+  v8::Local<v8::Message> Message() const;
218
+
219
+  void Reset();
220
+
221
+  void SetVerbose(bool value);
222
+
223
+  void SetCaptureMessage(bool value);
224
+};
225
+```
226
+
... ...
@@ -0,0 +1,62 @@
1
+## JSON
2
+
3
+The _JSON_ object provides the C++ versions of the methods offered by the `JSON` object in javascript. V8 exposes these methods via the `v8::JSON` object.
4
+
5
+ - <a href="#api_nan_json_parse"><b><code>Nan::JSON.Parse</code></b></a>
6
+ - <a href="#api_nan_json_stringify"><b><code>Nan::JSON.Stringify</code></b></a>
7
+
8
+Refer to the V8 JSON object in the [V8 documentation](https://v8docs.nodesource.com/node-8.16/da/d6f/classv8_1_1_j_s_o_n.html) for more information about these methods and their arguments.
9
+
10
+<a name="api_nan_json_parse"></a>
11
+
12
+### Nan::JSON.Parse
13
+
14
+A simple wrapper around [`v8::JSON::Parse`](https://v8docs.nodesource.com/node-8.16/da/d6f/classv8_1_1_j_s_o_n.html#a936310d2540fb630ed37d3ee3ffe4504).
15
+
16
+Definition:
17
+
18
+```c++
19
+Nan::MaybeLocal<v8::Value> Nan::JSON::Parse(v8::Local<v8::String> json_string);
20
+```
21
+
22
+Use `JSON.Parse(json_string)` to parse a string into a `v8::Value`.
23
+
24
+Example:
25
+
26
+```c++
27
+v8::Local<v8::String> json_string = Nan::New("{ \"JSON\": \"object\" }").ToLocalChecked();
28
+
29
+Nan::JSON NanJSON;
30
+Nan::MaybeLocal<v8::Value> result = NanJSON.Parse(json_string);
31
+if (!result.IsEmpty()) {
32
+  v8::Local<v8::Value> val = result.ToLocalChecked();
33
+}
34
+```
35
+
36
+<a name="api_nan_json_stringify"></a>
37
+
38
+### Nan::JSON.Stringify
39
+
40
+A simple wrapper around [`v8::JSON::Stringify`](https://v8docs.nodesource.com/node-8.16/da/d6f/classv8_1_1_j_s_o_n.html#a44b255c3531489ce43f6110209138860).
41
+
42
+Definition:
43
+
44
+```c++
45
+Nan::MaybeLocal<v8::String> Nan::JSON::Stringify(v8::Local<v8::Object> json_object, v8::Local<v8::String> gap = v8::Local<v8::String>());
46
+```
47
+
48
+Use `JSON.Stringify(value)` to stringify a `v8::Object`.
49
+
50
+Example:
51
+
52
+```c++
53
+// using `v8::Local<v8::Value> val` from the `JSON::Parse` example
54
+v8::Local<v8::Object> obj = Nan::To<v8::Object>(val).ToLocalChecked();
55
+
56
+Nan::JSON NanJSON;
57
+Nan::MaybeLocal<v8::String> result = NanJSON.Stringify(obj);
58
+if (!result.IsEmpty()) {
59
+  v8::Local<v8::String> stringified = result.ToLocalChecked();
60
+}
61
+```
62
+
... ...
@@ -0,0 +1,583 @@
1
+## Maybe Types
2
+
3
+The `Nan::MaybeLocal` and `Nan::Maybe` types are monads that encapsulate `v8::Local` handles that _may be empty_.
4
+
5
+* **Maybe Types**
6
+  - <a href="#api_nan_maybe_local"><b><code>Nan::MaybeLocal</code></b></a>
7
+  - <a href="#api_nan_maybe"><b><code>Nan::Maybe</code></b></a>
8
+  - <a href="#api_nan_nothing"><b><code>Nan::Nothing</code></b></a>
9
+  - <a href="#api_nan_just"><b><code>Nan::Just</code></b></a>
10
+* **Maybe Helpers**
11
+  - <a href="#api_nan_call"><b><code>Nan::Call()</code></b></a>
12
+  - <a href="#api_nan_to_detail_string"><b><code>Nan::ToDetailString()</code></b></a>
13
+  - <a href="#api_nan_to_array_index"><b><code>Nan::ToArrayIndex()</code></b></a>
14
+  - <a href="#api_nan_equals"><b><code>Nan::Equals()</code></b></a>
15
+  - <a href="#api_nan_new_instance"><b><code>Nan::NewInstance()</code></b></a>
16
+  - <a href="#api_nan_get_function"><b><code>Nan::GetFunction()</code></b></a>
17
+  - <a href="#api_nan_set"><b><code>Nan::Set()</code></b></a>
18
+  - <a href="#api_nan_define_own_property"><b><code>Nan::DefineOwnProperty()</code></b></a>
19
+  - <a href="#api_nan_force_set"><del><b><code>Nan::ForceSet()</code></b></del></a>
20
+  - <a href="#api_nan_get"><b><code>Nan::Get()</code></b></a>
21
+  - <a href="#api_nan_get_property_attribute"><b><code>Nan::GetPropertyAttributes()</code></b></a>
22
+  - <a href="#api_nan_has"><b><code>Nan::Has()</code></b></a>
23
+  - <a href="#api_nan_delete"><b><code>Nan::Delete()</code></b></a>
24
+  - <a href="#api_nan_get_property_names"><b><code>Nan::GetPropertyNames()</code></b></a>
25
+  - <a href="#api_nan_get_own_property_names"><b><code>Nan::GetOwnPropertyNames()</code></b></a>
26
+  - <a href="#api_nan_set_prototype"><b><code>Nan::SetPrototype()</code></b></a>
27
+  - <a href="#api_nan_object_proto_to_string"><b><code>Nan::ObjectProtoToString()</code></b></a>
28
+  - <a href="#api_nan_has_own_property"><b><code>Nan::HasOwnProperty()</code></b></a>
29
+  - <a href="#api_nan_has_real_named_property"><b><code>Nan::HasRealNamedProperty()</code></b></a>
30
+  - <a href="#api_nan_has_real_indexed_property"><b><code>Nan::HasRealIndexedProperty()</code></b></a>
31
+  - <a href="#api_nan_has_real_named_callback_property"><b><code>Nan::HasRealNamedCallbackProperty()</code></b></a>
32
+  - <a href="#api_nan_get_real_named_property_in_prototype_chain"><b><code>Nan::GetRealNamedPropertyInPrototypeChain()</code></b></a>
33
+  - <a href="#api_nan_get_real_named_property"><b><code>Nan::GetRealNamedProperty()</code></b></a>
34
+  - <a href="#api_nan_call_as_function"><b><code>Nan::CallAsFunction()</code></b></a>
35
+  - <a href="#api_nan_call_as_constructor"><b><code>Nan::CallAsConstructor()</code></b></a>
36
+  - <a href="#api_nan_get_source_line"><b><code>Nan::GetSourceLine()</code></b></a>
37
+  - <a href="#api_nan_get_line_number"><b><code>Nan::GetLineNumber()</code></b></a>
38
+  - <a href="#api_nan_get_start_column"><b><code>Nan::GetStartColumn()</code></b></a>
39
+  - <a href="#api_nan_get_end_column"><b><code>Nan::GetEndColumn()</code></b></a>
40
+  - <a href="#api_nan_clone_element_at"><b><code>Nan::CloneElementAt()</code></b></a>
41
+  - <a href="#api_nan_has_private"><b><code>Nan::HasPrivate()</code></b></a>
42
+  - <a href="#api_nan_get_private"><b><code>Nan::GetPrivate()</code></b></a>
43
+  - <a href="#api_nan_set_private"><b><code>Nan::SetPrivate()</code></b></a>
44
+  - <a href="#api_nan_delete_private"><b><code>Nan::DeletePrivate()</code></b></a>
45
+  - <a href="#api_nan_make_maybe"><b><code>Nan::MakeMaybe()</code></b></a>
46
+
47
+<a name="api_nan_maybe_local"></a>
48
+### Nan::MaybeLocal
49
+
50
+A `Nan::MaybeLocal<T>` is a wrapper around [`v8::Local<T>`](https://v8docs.nodesource.com/node-8.16/de/deb/classv8_1_1_local.html) that enforces a check that determines whether the `v8::Local<T>` is empty before it can be used.
51
+
52
+If an API method returns a `Nan::MaybeLocal`, the API method can potentially fail either because an exception is thrown, or because an exception is pending, e.g. because a previous API call threw an exception that hasn't been caught yet, or because a `v8::TerminateExecution` exception was thrown. In that case, an empty `Nan::MaybeLocal` is returned.
53
+
54
+Definition:
55
+
56
+```c++
57
+template<typename T> class Nan::MaybeLocal {
58
+ public:
59
+  MaybeLocal();
60
+
61
+  template<typename S> MaybeLocal(v8::Local<S> that);
62
+
63
+  bool IsEmpty() const;
64
+
65
+  template<typename S> bool ToLocal(v8::Local<S> *out);
66
+
67
+  // Will crash if the MaybeLocal<> is empty.
68
+  v8::Local<T> ToLocalChecked();
69
+
70
+  template<typename S> v8::Local<S> FromMaybe(v8::Local<S> default_value) const;
71
+};
72
+```
73
+
74
+See the documentation for [`v8::MaybeLocal`](https://v8docs.nodesource.com/node-8.16/d8/d7d/classv8_1_1_maybe_local.html) for further details.
75
+
76
+<a name="api_nan_maybe"></a>
77
+### Nan::Maybe
78
+
79
+A simple `Nan::Maybe` type, representing an object which may or may not have a value, see https://hackage.haskell.org/package/base/docs/Data-Maybe.html.
80
+
81
+If an API method returns a `Nan::Maybe<>`, the API method can potentially fail either because an exception is thrown, or because an exception is pending, e.g. because a previous API call threw an exception that hasn't been caught yet, or because a `v8::TerminateExecution` exception was thrown. In that case, a "Nothing" value is returned.
82
+
83
+Definition:
84
+
85
+```c++
86
+template<typename T> class Nan::Maybe {
87
+ public:
88
+  bool IsNothing() const;
89
+  bool IsJust() const;
90
+
91
+  // Will crash if the Maybe<> is nothing.
92
+  T FromJust();
93
+
94
+  T FromMaybe(const T& default_value);
95
+
96
+  bool operator==(const Maybe &other);
97
+
98
+  bool operator!=(const Maybe &other);
99
+};
100
+```
101
+
102
+See the documentation for [`v8::Maybe`](https://v8docs.nodesource.com/node-8.16/d9/d4b/classv8_1_1_maybe.html) for further details.
103
+
104
+<a name="api_nan_nothing"></a>
105
+### Nan::Nothing
106
+
107
+Construct an empty `Nan::Maybe` type representing _nothing_.
108
+
109
+```c++
110
+template<typename T> Nan::Maybe<T> Nan::Nothing();
111
+```
112
+
113
+<a name="api_nan_just"></a>
114
+### Nan::Just
115
+
116
+Construct a `Nan::Maybe` type representing _just_ a value.
117
+
118
+```c++
119
+template<typename T> Nan::Maybe<T> Nan::Just(const T &t);
120
+```
121
+
122
+<a name="api_nan_call"></a>
123
+### Nan::Call()
124
+
125
+A helper method for calling a synchronous [`v8::Function#Call()`](https://v8docs.nodesource.com/node-8.16/d5/d54/classv8_1_1_function.html#a9c3d0e4e13ddd7721fce238aa5b94a11) in a way compatible across supported versions of V8.
126
+
127
+For asynchronous callbacks, use Nan::Callback::Call along with an AsyncResource.
128
+
129
+Signature:
130
+
131
+```c++
132
+Nan::MaybeLocal<v8::Value> Nan::Call(v8::Local<v8::Function> fun, v8::Local<v8::Object> recv, int argc, v8::Local<v8::Value> argv[]);
133
+Nan::MaybeLocal<v8::Value> Nan::Call(const Nan::Callback& callback, v8::Local<v8::Object> recv,
134
+ int argc, v8::Local<v8::Value> argv[]);
135
+Nan::MaybeLocal<v8::Value> Nan::Call(const Nan::Callback& callback, int argc, v8::Local<v8::Value> argv[]);
136
+```
137
+
138
+
139
+<a name="api_nan_to_detail_string"></a>
140
+### Nan::ToDetailString()
141
+
142
+A helper method for calling [`v8::Value#ToDetailString()`](https://v8docs.nodesource.com/node-8.16/dc/d0a/classv8_1_1_value.html#a2f9770296dc2c8d274bc8cc0dca243e5) in a way compatible across supported versions of V8.
143
+
144
+Signature:
145
+
146
+```c++
147
+Nan::MaybeLocal<v8::String> Nan::ToDetailString(v8::Local<v8::Value> val);
148
+```
149
+
150
+
151
+<a name="api_nan_to_array_index"></a>
152
+### Nan::ToArrayIndex()
153
+
154
+A helper method for calling [`v8::Value#ToArrayIndex()`](https://v8docs.nodesource.com/node-8.16/dc/d0a/classv8_1_1_value.html#acc5bbef3c805ec458470c0fcd6f13493) in a way compatible across supported versions of V8.
155
+
156
+Signature:
157
+
158
+```c++
159
+Nan::MaybeLocal<v8::Uint32> Nan::ToArrayIndex(v8::Local<v8::Value> val);
160
+```
161
+
162
+
163
+<a name="api_nan_equals"></a>
164
+### Nan::Equals()
165
+
166
+A helper method for calling [`v8::Value#Equals()`](https://v8docs.nodesource.com/node-8.16/dc/d0a/classv8_1_1_value.html#a08fba1d776a59bbf6864b25f9152c64b) in a way compatible across supported versions of V8.
167
+
168
+Signature:
169
+
170
+```c++
171
+Nan::Maybe<bool> Nan::Equals(v8::Local<v8::Value> a, v8::Local<v8::Value>(b));
172
+```
173
+
174
+
175
+<a name="api_nan_new_instance"></a>
176
+### Nan::NewInstance()
177
+
178
+A helper method for calling [`v8::Function#NewInstance()`](https://v8docs.nodesource.com/node-8.16/d5/d54/classv8_1_1_function.html#ae477558b10c14b76ed00e8dbab44ce5b) and [`v8::ObjectTemplate#NewInstance()`](https://v8docs.nodesource.com/node-8.16/db/d5f/classv8_1_1_object_template.html#ad605a7543cfbc5dab54cdb0883d14ae4) in a way compatible across supported versions of V8.
179
+
180
+Signature:
181
+
182
+```c++
183
+Nan::MaybeLocal<v8::Object> Nan::NewInstance(v8::Local<v8::Function> h);
184
+Nan::MaybeLocal<v8::Object> Nan::NewInstance(v8::Local<v8::Function> h, int argc, v8::Local<v8::Value> argv[]);
185
+Nan::MaybeLocal<v8::Object> Nan::NewInstance(v8::Local<v8::ObjectTemplate> h);
186
+```
187
+
188
+
189
+<a name="api_nan_get_function"></a>
190
+### Nan::GetFunction()
191
+
192
+A helper method for calling [`v8::FunctionTemplate#GetFunction()`](https://v8docs.nodesource.com/node-8.16/d8/d83/classv8_1_1_function_template.html#a56d904662a86eca78da37d9bb0ed3705) in a way compatible across supported versions of V8.
193
+
194
+Signature:
195
+
196
+```c++
197
+Nan::MaybeLocal<v8::Function> Nan::GetFunction(v8::Local<v8::FunctionTemplate> t);
198
+```
199
+
200
+
201
+<a name="api_nan_set"></a>
202
+### Nan::Set()
203
+
204
+A helper method for calling [`v8::Object#Set()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a67604ea3734f170c66026064ea808f20) in a way compatible across supported versions of V8.
205
+
206
+Signature:
207
+
208
+```c++
209
+Nan::Maybe<bool> Nan::Set(v8::Local<v8::Object> obj,
210
+                          v8::Local<v8::Value> key,
211
+                          v8::Local<v8::Value> value)
212
+Nan::Maybe<bool> Nan::Set(v8::Local<v8::Object> obj,
213
+                          uint32_t index,
214
+                          v8::Local<v8::Value> value);
215
+```
216
+
217
+
218
+<a name="api_nan_define_own_property"></a>
219
+### Nan::DefineOwnProperty()
220
+
221
+A helper method for calling [`v8::Object#DefineOwnProperty()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a6f76b2ed605cb8f9185b92de0033a820) in a way compatible across supported versions of V8.
222
+
223
+Signature:
224
+
225
+```c++
226
+Nan::Maybe<bool> Nan::DefineOwnProperty(v8::Local<v8::Object> obj,
227
+                                        v8::Local<v8::String> key,
228
+                                        v8::Local<v8::Value> value,
229
+                                        v8::PropertyAttribute attribs = v8::None);
230
+```
231
+
232
+
233
+<a name="api_nan_force_set"></a>
234
+### <del>Nan::ForceSet()</del>
235
+
236
+Deprecated, use <a href="#api_nan_define_own_property"><code>Nan::DefineOwnProperty()</code></a>.
237
+
238
+<del>A helper method for calling [`v8::Object#ForceSet()`](https://v8docs.nodesource.com/node-0.12/db/d85/classv8_1_1_object.html#acfbdfd7427b516ebdb5c47c4df5ed96c) in a way compatible across supported versions of V8.</del>
239
+
240
+Signature:
241
+
242
+```c++
243
+NAN_DEPRECATED Nan::Maybe<bool> Nan::ForceSet(v8::Local<v8::Object> obj,
244
+                                              v8::Local<v8::Value> key,
245
+                                              v8::Local<v8::Value> value,
246
+                                              v8::PropertyAttribute attribs = v8::None);
247
+```
248
+
249
+
250
+<a name="api_nan_get"></a>
251
+### Nan::Get()
252
+
253
+A helper method for calling [`v8::Object#Get()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a2565f03e736694f6b1e1cf22a0b4eac2) in a way compatible across supported versions of V8.
254
+
255
+Signature:
256
+
257
+```c++
258
+Nan::MaybeLocal<v8::Value> Nan::Get(v8::Local<v8::Object> obj,
259
+                                    v8::Local<v8::Value> key);
260
+Nan::MaybeLocal<v8::Value> Nan::Get(v8::Local<v8::Object> obj, uint32_t index);
261
+```
262
+
263
+
264
+<a name="api_nan_get_property_attribute"></a>
265
+### Nan::GetPropertyAttributes()
266
+
267
+A helper method for calling [`v8::Object#GetPropertyAttributes()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a9b898894da3d1db2714fd9325a54fe57) in a way compatible across supported versions of V8.
268
+
269
+Signature:
270
+
271
+```c++
272
+Nan::Maybe<v8::PropertyAttribute> Nan::GetPropertyAttributes(
273
+    v8::Local<v8::Object> obj,
274
+    v8::Local<v8::Value> key);
275
+```
276
+
277
+
278
+<a name="api_nan_has"></a>
279
+### Nan::Has()
280
+
281
+A helper method for calling [`v8::Object#Has()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ab3c3d89ea7c2f9afd08965bd7299a41d) in a way compatible across supported versions of V8.
282
+
283
+Signature:
284
+
285
+```c++
286
+Nan::Maybe<bool> Nan::Has(v8::Local<v8::Object> obj, v8::Local<v8::String> key);
287
+Nan::Maybe<bool> Nan::Has(v8::Local<v8::Object> obj, uint32_t index);
288
+```
289
+
290
+
291
+<a name="api_nan_delete"></a>
292
+### Nan::Delete()
293
+
294
+A helper method for calling [`v8::Object#Delete()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a48e4a19b2cedff867eecc73ddb7d377f) in a way compatible across supported versions of V8.
295
+
296
+Signature:
297
+
298
+```c++
299
+Nan::Maybe<bool> Nan::Delete(v8::Local<v8::Object> obj,
300
+                             v8::Local<v8::String> key);
301
+Nan::Maybe<bool> Nan::Delete(v8::Local<v8::Object> obj, uint32_t index);
302
+```
303
+
304
+
305
+<a name="api_nan_get_property_names"></a>
306
+### Nan::GetPropertyNames()
307
+
308
+A helper method for calling [`v8::Object#GetPropertyNames()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#aced885270cfd2c956367b5eedc7fbfe8) in a way compatible across supported versions of V8.
309
+
310
+Signature:
311
+
312
+```c++
313
+Nan::MaybeLocal<v8::Array> Nan::GetPropertyNames(v8::Local<v8::Object> obj);
314
+```
315
+
316
+
317
+<a name="api_nan_get_own_property_names"></a>
318
+### Nan::GetOwnPropertyNames()
319
+
320
+A helper method for calling [`v8::Object#GetOwnPropertyNames()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a79a6e4d66049b9aa648ed4dfdb23e6eb) in a way compatible across supported versions of V8.
321
+
322
+Signature:
323
+
324
+```c++
325
+Nan::MaybeLocal<v8::Array> Nan::GetOwnPropertyNames(v8::Local<v8::Object> obj);
326
+```
327
+
328
+
329
+<a name="api_nan_set_prototype"></a>
330
+### Nan::SetPrototype()
331
+
332
+A helper method for calling [`v8::Object#SetPrototype()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a442706b22fceda6e6d1f632122a9a9f4) in a way compatible across supported versions of V8.
333
+
334
+Signature:
335
+
336
+```c++
337
+Nan::Maybe<bool> Nan::SetPrototype(v8::Local<v8::Object> obj,
338
+                                   v8::Local<v8::Value> prototype);
339
+```
340
+
341
+
342
+<a name="api_nan_object_proto_to_string"></a>
343
+### Nan::ObjectProtoToString()
344
+
345
+A helper method for calling [`v8::Object#ObjectProtoToString()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ab7a92b4dcf822bef72f6c0ac6fea1f0b) in a way compatible across supported versions of V8.
346
+
347
+Signature:
348
+
349
+```c++
350
+Nan::MaybeLocal<v8::String> Nan::ObjectProtoToString(v8::Local<v8::Object> obj);
351
+```
352
+
353
+
354
+<a name="api_nan_has_own_property"></a>
355
+### Nan::HasOwnProperty()
356
+
357
+A helper method for calling [`v8::Object#HasOwnProperty()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ab7b7245442ca6de1e1c145ea3fd653ff) in a way compatible across supported versions of V8.
358
+
359
+Signature:
360
+
361
+```c++
362
+Nan::Maybe<bool> Nan::HasOwnProperty(v8::Local<v8::Object> obj,
363
+                                     v8::Local<v8::String> key);
364
+```
365
+
366
+
367
+<a name="api_nan_has_real_named_property"></a>
368
+### Nan::HasRealNamedProperty()
369
+
370
+A helper method for calling [`v8::Object#HasRealNamedProperty()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ad8b80a59c9eb3c1e6c3cd6c84571f767) in a way compatible across supported versions of V8.
371
+
372
+Signature:
373
+
374
+```c++
375
+Nan::Maybe<bool> Nan::HasRealNamedProperty(v8::Local<v8::Object> obj,
376
+                                           v8::Local<v8::String> key);
377
+```
378
+
379
+
380
+<a name="api_nan_has_real_indexed_property"></a>
381
+### Nan::HasRealIndexedProperty()
382
+
383
+A helper method for calling [`v8::Object#HasRealIndexedProperty()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#af94fc1135a5e74a2193fb72c3a1b9855) in a way compatible across supported versions of V8.
384
+
385
+Signature:
386
+
387
+```c++
388
+Nan::Maybe<bool> Nan::HasRealIndexedProperty(v8::Local<v8::Object> obj,
389
+                                             uint32_t index);
390
+```
391
+
392
+
393
+<a name="api_nan_has_real_named_callback_property"></a>
394
+### Nan::HasRealNamedCallbackProperty()
395
+
396
+A helper method for calling [`v8::Object#HasRealNamedCallbackProperty()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#af743b7ea132b89f84d34d164d0668811) in a way compatible across supported versions of V8.
397
+
398
+Signature:
399
+
400
+```c++
401
+Nan::Maybe<bool> Nan::HasRealNamedCallbackProperty(
402
+    v8::Local<v8::Object> obj,
403
+    v8::Local<v8::String> key);
404
+```
405
+
406
+
407
+<a name="api_nan_get_real_named_property_in_prototype_chain"></a>
408
+### Nan::GetRealNamedPropertyInPrototypeChain()
409
+
410
+A helper method for calling [`v8::Object#GetRealNamedPropertyInPrototypeChain()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a8700b1862e6b4783716964ba4d5e6172) in a way compatible across supported versions of V8.
411
+
412
+Signature:
413
+
414
+```c++
415
+Nan::MaybeLocal<v8::Value> Nan::GetRealNamedPropertyInPrototypeChain(
416
+    v8::Local<v8::Object> obj,
417
+    v8::Local<v8::String> key);
418
+```
419
+
420
+
421
+<a name="api_nan_get_real_named_property"></a>
422
+### Nan::GetRealNamedProperty()
423
+
424
+A helper method for calling [`v8::Object#GetRealNamedProperty()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a84471a824576a5994fdd0ffcbf99ccc0) in a way compatible across supported versions of V8.
425
+
426
+Signature:
427
+
428
+```c++
429
+Nan::MaybeLocal<v8::Value> Nan::GetRealNamedProperty(v8::Local<v8::Object> obj,
430
+                                                     v8::Local<v8::String> key);
431
+```
432
+
433
+
434
+<a name="api_nan_call_as_function"></a>
435
+### Nan::CallAsFunction()
436
+
437
+A helper method for calling [`v8::Object#CallAsFunction()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ad3ffc36f3dfc3592ce2a96bc047ee2cd) in a way compatible across supported versions of V8.
438
+
439
+Signature:
440
+
441
+```c++
442
+Nan::MaybeLocal<v8::Value> Nan::CallAsFunction(v8::Local<v8::Object> obj,
443
+                                               v8::Local<v8::Object> recv,
444
+                                               int argc,
445
+                                               v8::Local<v8::Value> argv[]);
446
+```
447
+
448
+
449
+<a name="api_nan_call_as_constructor"></a>
450
+### Nan::CallAsConstructor()
451
+
452
+A helper method for calling [`v8::Object#CallAsConstructor()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a50d571de50d0b0dfb28795619d07a01b) in a way compatible across supported versions of V8.
453
+
454
+Signature:
455
+
456
+```c++
457
+Nan::MaybeLocal<v8::Value> Nan::CallAsConstructor(v8::Local<v8::Object> obj,
458
+                                                  int argc,
459
+                                                  v8::Local<v8::Value> argv[]);
460
+```
461
+
462
+
463
+<a name="api_nan_get_source_line"></a>
464
+### Nan::GetSourceLine()
465
+
466
+A helper method for calling [`v8::Message#GetSourceLine()`](https://v8docs.nodesource.com/node-8.16/d9/d28/classv8_1_1_message.html#a849f7a6c41549d83d8159825efccd23a) in a way compatible across supported versions of V8.
467
+
468
+Signature:
469
+
470
+```c++
471
+Nan::MaybeLocal<v8::String> Nan::GetSourceLine(v8::Local<v8::Message> msg);
472
+```
473
+
474
+
475
+<a name="api_nan_get_line_number"></a>
476
+### Nan::GetLineNumber()
477
+
478
+A helper method for calling [`v8::Message#GetLineNumber()`](https://v8docs.nodesource.com/node-8.16/d9/d28/classv8_1_1_message.html#adbe46c10a88a6565f2732a2d2adf99b9) in a way compatible across supported versions of V8.
479
+
480
+Signature:
481
+
482
+```c++
483
+Nan::Maybe<int> Nan::GetLineNumber(v8::Local<v8::Message> msg);
484
+```
485
+
486
+
487
+<a name="api_nan_get_start_column"></a>
488
+### Nan::GetStartColumn()
489
+
490
+A helper method for calling [`v8::Message#GetStartColumn()`](https://v8docs.nodesource.com/node-8.16/d9/d28/classv8_1_1_message.html#a60ede616ba3822d712e44c7a74487ba6) in a way compatible across supported versions of V8.
491
+
492
+Signature:
493
+
494
+```c++
495
+Nan::Maybe<int> Nan::GetStartColumn(v8::Local<v8::Message> msg);
496
+```
497
+
498
+
499
+<a name="api_nan_get_end_column"></a>
500
+### Nan::GetEndColumn()
501
+
502
+A helper method for calling [`v8::Message#GetEndColumn()`](https://v8docs.nodesource.com/node-8.16/d9/d28/classv8_1_1_message.html#aaa004cf19e529da980bc19fcb76d93be) in a way compatible across supported versions of V8.
503
+
504
+Signature:
505
+
506
+```c++
507
+Nan::Maybe<int> Nan::GetEndColumn(v8::Local<v8::Message> msg);
508
+```
509
+
510
+
511
+<a name="api_nan_clone_element_at"></a>
512
+### Nan::CloneElementAt()
513
+
514
+A helper method for calling [`v8::Array#CloneElementAt()`](https://v8docs.nodesource.com/node-4.8/d3/d32/classv8_1_1_array.html#a1d3a878d4c1c7cae974dd50a1639245e) in a way compatible across supported versions of V8.
515
+
516
+Signature:
517
+
518
+```c++
519
+Nan::MaybeLocal<v8::Object> Nan::CloneElementAt(v8::Local<v8::Array> array, uint32_t index);
520
+```
521
+
522
+<a name="api_nan_has_private"></a>
523
+### Nan::HasPrivate()
524
+
525
+A helper method for calling [`v8::Object#HasPrivate()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#af68a0b98066cfdeb8f943e98a40ba08d) in a way compatible across supported versions of V8.
526
+
527
+Signature:
528
+
529
+```c++
530
+Nan::Maybe<bool> Nan::HasPrivate(v8::Local<v8::Object> object, v8::Local<v8::String> key);
531
+```
532
+
533
+<a name="api_nan_get_private"></a>
534
+### Nan::GetPrivate()
535
+
536
+A helper method for calling [`v8::Object#GetPrivate()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a169f2da506acbec34deadd9149a1925a) in a way compatible across supported versions of V8.
537
+
538
+Signature:
539
+
540
+```c++
541
+Nan::MaybeLocal<v8::Value> Nan::GetPrivate(v8::Local<v8::Object> object, v8::Local<v8::String> key);
542
+```
543
+
544
+<a name="api_nan_set_private"></a>
545
+### Nan::SetPrivate()
546
+
547
+A helper method for calling [`v8::Object#SetPrivate()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ace1769b0f3b86bfe9fda1010916360ee) in a way compatible across supported versions of V8.
548
+
549
+Signature:
550
+
551
+```c++
552
+Nan::Maybe<bool> Nan::SetPrivate(v8::Local<v8::Object> object, v8::Local<v8::String> key, v8::Local<v8::Value> value);
553
+```
554
+
555
+<a name="api_nan_delete_private"></a>
556
+### Nan::DeletePrivate()
557
+
558
+A helper method for calling [`v8::Object#DeletePrivate()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a138bb32a304f3982be02ad499693b8fd) in a way compatible across supported versions of V8.
559
+
560
+Signature:
561
+
562
+```c++
563
+Nan::Maybe<bool> Nan::DeletePrivate(v8::Local<v8::Object> object, v8::Local<v8::String> key);
564
+```
565
+
566
+<a name="api_nan_make_maybe"></a>
567
+### Nan::MakeMaybe()
568
+
569
+Wraps a `v8::Local<>` in a `Nan::MaybeLocal<>`. When called with a `Nan::MaybeLocal<>` it just returns its argument. This is useful in generic template code that builds on NAN.
570
+
571
+Synopsis:
572
+
573
+```c++
574
+  MaybeLocal<v8::Number> someNumber = MakeMaybe(New<v8::Number>(3.141592654));
575
+  MaybeLocal<v8::String> someString = MakeMaybe(New<v8::String>("probably"));
576
+```
577
+
578
+Signature:
579
+
580
+```c++
581
+template <typename T, template <typename> class MaybeMaybe>
582
+Nan::MaybeLocal<T> Nan::MakeMaybe(MaybeMaybe<T> v);
583
+```
... ...
@@ -0,0 +1,664 @@
1
+## JavaScript-accessible methods
2
+
3
+A _template_ is a blueprint for JavaScript functions and objects in a context. You can use a template to wrap C++ functions and data structures within JavaScript objects so that they can be manipulated from JavaScript. See the V8 Embedders Guide section on [Templates](https://github.com/v8/v8/wiki/Embedder%27s-Guide#templates) for further information.
4
+
5
+In order to expose functionality to JavaScript via a template, you must provide it to V8 in a form that it understands. Across the versions of V8 supported by NAN, JavaScript-accessible method signatures vary widely, NAN fully abstracts method declaration and provides you with an interface that is similar to the most recent V8 API but is backward-compatible with older versions that still use the now-deceased `v8::Argument` type.
6
+
7
+* **Method argument types**
8
+ - <a href="#api_nan_function_callback_info"><b><code>Nan::FunctionCallbackInfo</code></b></a>
9
+ - <a href="#api_nan_property_callback_info"><b><code>Nan::PropertyCallbackInfo</code></b></a>
10
+ - <a href="#api_nan_return_value"><b><code>Nan::ReturnValue</code></b></a>
11
+* **Method declarations**
12
+ - <a href="#api_nan_method"><b>Method declaration</b></a>
13
+ - <a href="#api_nan_getter"><b>Getter declaration</b></a>
14
+ - <a href="#api_nan_setter"><b>Setter declaration</b></a>
15
+ - <a href="#api_nan_property_getter"><b>Property getter declaration</b></a>
16
+ - <a href="#api_nan_property_setter"><b>Property setter declaration</b></a>
17
+ - <a href="#api_nan_property_enumerator"><b>Property enumerator declaration</b></a>
18
+ - <a href="#api_nan_property_deleter"><b>Property deleter declaration</b></a>
19
+ - <a href="#api_nan_property_query"><b>Property query declaration</b></a>
20
+ - <a href="#api_nan_index_getter"><b>Index getter declaration</b></a>
21
+ - <a href="#api_nan_index_setter"><b>Index setter declaration</b></a>
22
+ - <a href="#api_nan_index_enumerator"><b>Index enumerator declaration</b></a>
23
+ - <a href="#api_nan_index_deleter"><b>Index deleter declaration</b></a>
24
+ - <a href="#api_nan_index_query"><b>Index query declaration</b></a>
25
+* Method and template helpers
26
+ - <a href="#api_nan_set_method"><b><code>Nan::SetMethod()</code></b></a>
27
+ - <a href="#api_nan_set_prototype_method"><b><code>Nan::SetPrototypeMethod()</code></b></a>
28
+ - <a href="#api_nan_set_accessor"><b><code>Nan::SetAccessor()</code></b></a>
29
+ - <a href="#api_nan_set_named_property_handler"><b><code>Nan::SetNamedPropertyHandler()</code></b></a>
30
+ - <a href="#api_nan_set_indexed_property_handler"><b><code>Nan::SetIndexedPropertyHandler()</code></b></a>
31
+ - <a href="#api_nan_set_template"><b><code>Nan::SetTemplate()</code></b></a>
32
+ - <a href="#api_nan_set_prototype_template"><b><code>Nan::SetPrototypeTemplate()</code></b></a>
33
+ - <a href="#api_nan_set_instance_template"><b><code>Nan::SetInstanceTemplate()</code></b></a>
34
+ - <a href="#api_nan_set_call_handler"><b><code>Nan::SetCallHandler()</code></b></a>
35
+ - <a href="#api_nan_set_call_as_function_handler"><b><code>Nan::SetCallAsFunctionHandler()</code></b></a>
36
+
37
+<a name="api_nan_function_callback_info"></a>
38
+### Nan::FunctionCallbackInfo
39
+
40
+`Nan::FunctionCallbackInfo` should be used in place of [`v8::FunctionCallbackInfo`](https://v8docs.nodesource.com/node-8.16/dd/d0d/classv8_1_1_function_callback_info.html), even with older versions of Node where `v8::FunctionCallbackInfo` does not exist.
41
+
42
+Definition:
43
+
44
+```c++
45
+template<typename T> class FunctionCallbackInfo {
46
+ public:
47
+  ReturnValue<T> GetReturnValue() const;
48
+  v8::Local<v8::Function> Callee(); // NOTE: Not available in NodeJS >= 10.0.0
49
+  v8::Local<v8::Value> Data();
50
+  v8::Local<v8::Object> Holder();
51
+  bool IsConstructCall();
52
+  int Length() const;
53
+  v8::Local<v8::Value> operator[](int i) const;
54
+  v8::Local<v8::Object> This() const;
55
+  v8::Isolate *GetIsolate() const;
56
+};
57
+```
58
+
59
+See the [`v8::FunctionCallbackInfo`](https://v8docs.nodesource.com/node-8.16/dd/d0d/classv8_1_1_function_callback_info.html) documentation for usage details on these. See [`Nan::ReturnValue`](#api_nan_return_value) for further information on how to set a return value from methods.
60
+
61
+**Note:** `FunctionCallbackInfo::Callee` is removed in Node.js after `10.0.0` because it is was deprecated in V8. Consider using `info.Data()` to pass any information you need.
62
+
63
+<a name="api_nan_property_callback_info"></a>
64
+### Nan::PropertyCallbackInfo
65
+
66
+`Nan::PropertyCallbackInfo` should be used in place of [`v8::PropertyCallbackInfo`](https://v8docs.nodesource.com/node-8.16/d7/dc5/classv8_1_1_property_callback_info.html), even with older versions of Node where `v8::PropertyCallbackInfo` does not exist.
67
+
68
+Definition:
69
+
70
+```c++
71
+template<typename T> class PropertyCallbackInfo : public PropertyCallbackInfoBase<T> {
72
+ public:
73
+  ReturnValue<T> GetReturnValue() const;
74
+  v8::Isolate* GetIsolate() const;
75
+  v8::Local<v8::Value> Data() const;
76
+  v8::Local<v8::Object> This() const;
77
+  v8::Local<v8::Object> Holder() const;
78
+};
79
+```
80
+
81
+See the [`v8::PropertyCallbackInfo`](https://v8docs.nodesource.com/node-8.16/d7/dc5/classv8_1_1_property_callback_info.html) documentation for usage details on these. See [`Nan::ReturnValue`](#api_nan_return_value) for further information on how to set a return value from property accessor methods.
82
+
83
+<a name="api_nan_return_value"></a>
84
+### Nan::ReturnValue
85
+
86
+`Nan::ReturnValue` is used in place of [`v8::ReturnValue`](https://v8docs.nodesource.com/node-8.16/da/da7/classv8_1_1_return_value.html) on both [`Nan::FunctionCallbackInfo`](#api_nan_function_callback_info) and [`Nan::PropertyCallbackInfo`](#api_nan_property_callback_info) as the return type of `GetReturnValue()`.
87
+
88
+Example usage:
89
+
90
+```c++
91
+void EmptyArray(const Nan::FunctionCallbackInfo<v8::Value>& info) {
92
+  info.GetReturnValue().Set(Nan::New<v8::Array>());
93
+}
94
+```
95
+
96
+Definition:
97
+
98
+```c++
99
+template<typename T> class ReturnValue {
100
+ public:
101
+  // Handle setters
102
+  template <typename S> void Set(const v8::Local<S> &handle);
103
+  template <typename S> void Set(const Nan::Global<S> &handle);
104
+
105
+  // Fast primitive setters
106
+  void Set(bool value);
107
+  void Set(double i);
108
+  void Set(int32_t i);
109
+  void Set(uint32_t i);
110
+
111
+  // Fast JS primitive setters
112
+  void SetNull();
113
+  void SetUndefined();
114
+  void SetEmptyString();
115
+
116
+  // Convenience getter for isolate
117
+  v8::Isolate *GetIsolate() const;
118
+};
119
+```
120
+
121
+See the documentation on [`v8::ReturnValue`](https://v8docs.nodesource.com/node-8.16/da/da7/classv8_1_1_return_value.html) for further information on this.
122
+
123
+<a name="api_nan_method"></a>
124
+### Method declaration
125
+
126
+JavaScript-accessible methods should be declared with the following signature to form a `Nan::FunctionCallback`:
127
+
128
+```c++
129
+typedef void(*FunctionCallback)(const FunctionCallbackInfo<v8::Value>&);
130
+```
131
+
132
+Example:
133
+
134
+```c++
135
+void MethodName(const Nan::FunctionCallbackInfo<v8::Value>& info) {
136
+  ...
137
+}
138
+```
139
+
140
+You do not need to declare a new `HandleScope` within a method as one is implicitly created for you.
141
+
142
+**Example usage**
143
+
144
+```c++
145
+// .h:
146
+class Foo : public Nan::ObjectWrap {
147
+  ...
148
+
149
+  static void Bar(const Nan::FunctionCallbackInfo<v8::Value>& info);
150
+  static void Baz(const Nan::FunctionCallbackInfo<v8::Value>& info);
151
+}
152
+
153
+
154
+// .cc:
155
+void Foo::Bar(const Nan::FunctionCallbackInfo<v8::Value>& info) {
156
+  ...
157
+}
158
+
159
+void Foo::Baz(const Nan::FunctionCallbackInfo<v8::Value>& info) {
160
+  ...
161
+}
162
+```
163
+
164
+A helper macro `NAN_METHOD(methodname)` exists, compatible with NAN v1 method declarations.
165
+
166
+**Example usage with `NAN_METHOD(methodname)`**
167
+
168
+```c++
169
+// .h:
170
+class Foo : public Nan::ObjectWrap {
171
+  ...
172
+
173
+  static NAN_METHOD(Bar);
174
+  static NAN_METHOD(Baz);
175
+}
176
+
177
+
178
+// .cc:
179
+NAN_METHOD(Foo::Bar) {
180
+  ...
181
+}
182
+
183
+NAN_METHOD(Foo::Baz) {
184
+  ...
185
+}
186
+```
187
+
188
+Use [`Nan::SetPrototypeMethod`](#api_nan_set_prototype_method) to attach a method to a JavaScript function prototype or [`Nan::SetMethod`](#api_nan_set_method) to attach a method directly on a JavaScript object.
189
+
190
+<a name="api_nan_getter"></a>
191
+### Getter declaration
192
+
193
+JavaScript-accessible getters should be declared with the following signature to form a `Nan::GetterCallback`:
194
+
195
+```c++
196
+typedef void(*GetterCallback)(v8::Local<v8::String>,
197
+                              const PropertyCallbackInfo<v8::Value>&);
198
+```
199
+
200
+Example:
201
+
202
+```c++
203
+void GetterName(v8::Local<v8::String> property,
204
+                const Nan::PropertyCallbackInfo<v8::Value>& info) {
205
+  ...
206
+}
207
+```
208
+
209
+You do not need to declare a new `HandleScope` within a getter as one is implicitly created for you.
210
+
211
+A helper macro `NAN_GETTER(methodname)` exists, compatible with NAN v1 method declarations.
212
+
213
+Also see the V8 Embedders Guide documentation on [Accessors](https://developers.google.com/v8/embed#accesssors).
214
+
215
+<a name="api_nan_setter"></a>
216
+### Setter declaration
217
+
218
+JavaScript-accessible setters should be declared with the following signature to form a <b><code>Nan::SetterCallback</code></b>:
219
+
220
+```c++
221
+typedef void(*SetterCallback)(v8::Local<v8::String>,
222
+                              v8::Local<v8::Value>,
223
+                              const PropertyCallbackInfo<void>&);
224
+```
225
+
226
+Example:
227
+
228
+```c++
229
+void SetterName(v8::Local<v8::String> property,
230
+                v8::Local<v8::Value> value,
231
+                const Nan::PropertyCallbackInfo<void>& info) {
232
+  ...
233
+}
234
+```
235
+
236
+You do not need to declare a new `HandleScope` within a setter as one is implicitly created for you.
237
+
238
+A helper macro `NAN_SETTER(methodname)` exists, compatible with NAN v1 method declarations.
239
+
240
+Also see the V8 Embedders Guide documentation on [Accessors](https://developers.google.com/v8/embed#accesssors).
241
+
242
+<a name="api_nan_property_getter"></a>
243
+### Property getter declaration
244
+
245
+JavaScript-accessible property getters should be declared with the following signature to form a <b><code>Nan::PropertyGetterCallback</code></b>:
246
+
247
+```c++
248
+typedef void(*PropertyGetterCallback)(v8::Local<v8::String>,
249
+                                      const PropertyCallbackInfo<v8::Value>&);
250
+```
251
+
252
+Example:
253
+
254
+```c++
255
+void PropertyGetterName(v8::Local<v8::String> property,
256
+                        const Nan::PropertyCallbackInfo<v8::Value>& info) {
257
+  ...
258
+}
259
+```
260
+
261
+You do not need to declare a new `HandleScope` within a property getter as one is implicitly created for you.
262
+
263
+A helper macro `NAN_PROPERTY_GETTER(methodname)` exists, compatible with NAN v1 method declarations.
264
+
265
+Also see the V8 Embedders Guide documentation on named property [Interceptors](https://developers.google.com/v8/embed#interceptors).
266
+
267
+<a name="api_nan_property_setter"></a>
268
+### Property setter declaration
269
+
270
+JavaScript-accessible property setters should be declared with the following signature to form a <b><code>Nan::PropertySetterCallback</code></b>:
271
+
272
+```c++
273
+typedef void(*PropertySetterCallback)(v8::Local<v8::String>,
274
+                                      v8::Local<v8::Value>,
275
+                                      const PropertyCallbackInfo<v8::Value>&);
276
+```
277
+
278
+Example:
279
+
280
+```c++
281
+void PropertySetterName(v8::Local<v8::String> property,
282
+                        v8::Local<v8::Value> value,
283
+                        const Nan::PropertyCallbackInfo<v8::Value>& info);
284
+```
285
+
286
+You do not need to declare a new `HandleScope` within a property setter as one is implicitly created for you.
287
+
288
+A helper macro `NAN_PROPERTY_SETTER(methodname)` exists, compatible with NAN v1 method declarations.
289
+
290
+Also see the V8 Embedders Guide documentation on named property [Interceptors](https://developers.google.com/v8/embed#interceptors).
291
+
292
+<a name="api_nan_property_enumerator"></a>
293
+### Property enumerator declaration
294
+
295
+JavaScript-accessible property enumerators should be declared with the following signature to form a <b><code>Nan::PropertyEnumeratorCallback</code></b>:
296
+
297
+```c++
298
+typedef void(*PropertyEnumeratorCallback)(const PropertyCallbackInfo<v8::Array>&);
299
+```
300
+
301
+Example:
302
+
303
+```c++
304
+void PropertyEnumeratorName(const Nan::PropertyCallbackInfo<v8::Array>& info);
305
+```
306
+
307
+You do not need to declare a new `HandleScope` within a property enumerator as one is implicitly created for you.
308
+
309
+A helper macro `NAN_PROPERTY_ENUMERATOR(methodname)` exists, compatible with NAN v1 method declarations.
310
+
311
+Also see the V8 Embedders Guide documentation on named property [Interceptors](https://developers.google.com/v8/embed#interceptors).
312
+
313
+<a name="api_nan_property_deleter"></a>
314
+### Property deleter declaration
315
+
316
+JavaScript-accessible property deleters should be declared with the following signature to form a <b><code>Nan::PropertyDeleterCallback</code></b>:
317
+
318
+```c++
319
+typedef void(*PropertyDeleterCallback)(v8::Local<v8::String>,
320
+                                       const PropertyCallbackInfo<v8::Boolean>&);
321
+```
322
+
323
+Example:
324
+
325
+```c++
326
+void PropertyDeleterName(v8::Local<v8::String> property,
327
+                         const Nan::PropertyCallbackInfo<v8::Boolean>& info);
328
+```
329
+
330
+You do not need to declare a new `HandleScope` within a property deleter as one is implicitly created for you.
331
+
332
+A helper macro `NAN_PROPERTY_DELETER(methodname)` exists, compatible with NAN v1 method declarations.
333
+
334
+Also see the V8 Embedders Guide documentation on named property [Interceptors](https://developers.google.com/v8/embed#interceptors).
335
+
336
+<a name="api_nan_property_query"></a>
337
+### Property query declaration
338
+
339
+JavaScript-accessible property query methods should be declared with the following signature to form a <b><code>Nan::PropertyQueryCallback</code></b>:
340
+
341
+```c++
342
+typedef void(*PropertyQueryCallback)(v8::Local<v8::String>,
343
+                                     const PropertyCallbackInfo<v8::Integer>&);
344
+```
345
+
346
+Example:
347
+
348
+```c++
349
+void PropertyQueryName(v8::Local<v8::String> property,
350
+                       const Nan::PropertyCallbackInfo<v8::Integer>& info);
351
+```
352
+
353
+You do not need to declare a new `HandleScope` within a property query method as one is implicitly created for you.
354
+
355
+A helper macro `NAN_PROPERTY_QUERY(methodname)` exists, compatible with NAN v1 method declarations.
356
+
357
+Also see the V8 Embedders Guide documentation on named property [Interceptors](https://developers.google.com/v8/embed#interceptors).
358
+
359
+<a name="api_nan_index_getter"></a>
360
+### Index getter declaration
361
+
362
+JavaScript-accessible index getter methods should be declared with the following signature to form a <b><code>Nan::IndexGetterCallback</code></b>:
363
+
364
+```c++
365
+typedef void(*IndexGetterCallback)(uint32_t,
366
+                                   const PropertyCallbackInfo<v8::Value>&);
367
+```
368
+
369
+Example:
370
+
371
+```c++
372
+void IndexGetterName(uint32_t index, const PropertyCallbackInfo<v8::Value>& info);
373
+```
374
+
375
+You do not need to declare a new `HandleScope` within a index getter as one is implicitly created for you.
376
+
377
+A helper macro `NAN_INDEX_GETTER(methodname)` exists, compatible with NAN v1 method declarations.
378
+
379
+Also see the V8 Embedders Guide documentation on indexed property [Interceptors](https://developers.google.com/v8/embed#interceptors).
380
+
381
+<a name="api_nan_index_setter"></a>
382
+### Index setter declaration
383
+
384
+JavaScript-accessible index setter methods should be declared with the following signature to form a <b><code>Nan::IndexSetterCallback</code></b>:
385
+
386
+```c++
387
+typedef void(*IndexSetterCallback)(uint32_t,
388
+                                   v8::Local<v8::Value>,
389
+                                   const PropertyCallbackInfo<v8::Value>&);
390
+```
391
+
392
+Example:
393
+
394
+```c++
395
+void IndexSetterName(uint32_t index,
396
+                     v8::Local<v8::Value> value,
397
+                     const PropertyCallbackInfo<v8::Value>& info);
398
+```
399
+
400
+You do not need to declare a new `HandleScope` within a index setter as one is implicitly created for you.
401
+
402
+A helper macro `NAN_INDEX_SETTER(methodname)` exists, compatible with NAN v1 method declarations.
403
+
404
+Also see the V8 Embedders Guide documentation on indexed property [Interceptors](https://developers.google.com/v8/embed#interceptors).
405
+
406
+<a name="api_nan_index_enumerator"></a>
407
+### Index enumerator declaration
408
+
409
+JavaScript-accessible index enumerator methods should be declared with the following signature to form a <b><code>Nan::IndexEnumeratorCallback</code></b>:
410
+
411
+```c++
412
+typedef void(*IndexEnumeratorCallback)(const PropertyCallbackInfo<v8::Array>&);
413
+```
414
+
415
+Example:
416
+
417
+```c++
418
+void IndexEnumeratorName(const PropertyCallbackInfo<v8::Array>& info);
419
+```
420
+
421
+You do not need to declare a new `HandleScope` within a index enumerator as one is implicitly created for you.
422
+
423
+A helper macro `NAN_INDEX_ENUMERATOR(methodname)` exists, compatible with NAN v1 method declarations.
424
+
425
+Also see the V8 Embedders Guide documentation on indexed property [Interceptors](https://developers.google.com/v8/embed#interceptors).
426
+
427
+<a name="api_nan_index_deleter"></a>
428
+### Index deleter declaration
429
+
430
+JavaScript-accessible index deleter methods should be declared with the following signature to form a <b><code>Nan::IndexDeleterCallback</code></b>:
431
+
432
+```c++
433
+typedef void(*IndexDeleterCallback)(uint32_t,
434
+                                    const PropertyCallbackInfo<v8::Boolean>&);
435
+```
436
+
437
+Example:
438
+
439
+```c++
440
+void IndexDeleterName(uint32_t index, const PropertyCallbackInfo<v8::Boolean>& info);
441
+```
442
+
443
+You do not need to declare a new `HandleScope` within a index deleter as one is implicitly created for you.
444
+
445
+A helper macro `NAN_INDEX_DELETER(methodname)` exists, compatible with NAN v1 method declarations.
446
+
447
+Also see the V8 Embedders Guide documentation on indexed property [Interceptors](https://developers.google.com/v8/embed#interceptors).
448
+
449
+<a name="api_nan_index_query"></a>
450
+### Index query declaration
451
+
452
+JavaScript-accessible index query methods should be declared with the following signature to form a <b><code>Nan::IndexQueryCallback</code></b>:
453
+
454
+```c++
455
+typedef void(*IndexQueryCallback)(uint32_t,
456
+                                  const PropertyCallbackInfo<v8::Integer>&);
457
+```
458
+
459
+Example:
460
+
461
+```c++
462
+void IndexQueryName(uint32_t index, const PropertyCallbackInfo<v8::Integer>& info);
463
+```
464
+
465
+You do not need to declare a new `HandleScope` within a index query method as one is implicitly created for you.
466
+
467
+A helper macro `NAN_INDEX_QUERY(methodname)` exists, compatible with NAN v1 method declarations.
468
+
469
+Also see the V8 Embedders Guide documentation on indexed property [Interceptors](https://developers.google.com/v8/embed#interceptors).
470
+
471
+<a name="api_nan_set_method"></a>
472
+### Nan::SetMethod()
473
+
474
+Sets a method with a given name directly on a JavaScript object where the method has the `Nan::FunctionCallback` signature (see <a href="#api_nan_method">Method declaration</a>).
475
+
476
+Signature:
477
+
478
+```c++
479
+void Nan::SetMethod(v8::Local<v8::Object> recv,
480
+                    const char *name,
481
+                    Nan::FunctionCallback callback,
482
+                    v8::Local<v8::Value> data = v8::Local<v8::Value>())
483
+void Nan::SetMethod(v8::Local<v8::Template> templ,
484
+                    const char *name,
485
+                    Nan::FunctionCallback callback,
486
+                    v8::Local<v8::Value> data = v8::Local<v8::Value>())
487
+```
488
+
489
+<a name="api_nan_set_prototype_method"></a>
490
+### Nan::SetPrototypeMethod()
491
+
492
+Sets a method with a given name on a `FunctionTemplate`'s prototype where the method has the `Nan::FunctionCallback` signature (see <a href="#api_nan_method">Method declaration</a>).
493
+
494
+Signature:
495
+
496
+```c++
497
+void Nan::SetPrototypeMethod(v8::Local<v8::FunctionTemplate> recv,
498
+                             const char* name,
499
+                             Nan::FunctionCallback callback,
500
+                             v8::Local<v8::Value> data = v8::Local<v8::Value>())
501
+```
502
+
503
+<a name="api_nan_set_accessor"></a>
504
+### Nan::SetAccessor()
505
+
506
+Sets getters and setters for a property with a given name on an `ObjectTemplate` or a plain `Object`. Accepts getters with the `Nan::GetterCallback` signature (see <a href="#api_nan_getter">Getter declaration</a>) and setters with the `Nan::SetterCallback` signature (see <a href="#api_nan_setter">Setter declaration</a>).
507
+
508
+Signature:
509
+
510
+```c++
511
+void SetAccessor(v8::Local<v8::ObjectTemplate> tpl,
512
+                 v8::Local<v8::String> name,
513
+                 Nan::GetterCallback getter,
514
+                 Nan::SetterCallback setter = 0,
515
+                 v8::Local<v8::Value> data = v8::Local<v8::Value>(),
516
+                 v8::AccessControl settings = v8::DEFAULT,
517
+                 v8::PropertyAttribute attribute = v8::None,
518
+                 imp::Sig signature = imp::Sig());
519
+bool SetAccessor(v8::Local<v8::Object> obj,
520
+                 v8::Local<v8::String> name,
521
+                 Nan::GetterCallback getter,
522
+                 Nan::SetterCallback setter = 0,
523
+                 v8::Local<v8::Value> data = v8::Local<v8::Value>(),
524
+                 v8::AccessControl settings = v8::DEFAULT,
525
+                 v8::PropertyAttribute attribute = v8::None)
526
+```
527
+
528
+See the V8 [`ObjectTemplate#SetAccessor()`](https://v8docs.nodesource.com/node-8.16/db/d5f/classv8_1_1_object_template.html#aca0ed196f8a9adb1f68b1aadb6c9cd77) and [`Object#SetAccessor()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ae91b3b56b357f285288c89fbddc46d1b) for further information about how to use `Nan::SetAccessor()`.
529
+
530
+<a name="api_nan_set_named_property_handler"></a>
531
+### Nan::SetNamedPropertyHandler()
532
+
533
+Sets named property getters, setters, query, deleter and enumerator methods on an `ObjectTemplate`. Accepts:
534
+
535
+* Property getters with the `Nan::PropertyGetterCallback` signature (see <a href="#api_nan_property_getter">Property getter declaration</a>)
536
+* Property setters with the `Nan::PropertySetterCallback` signature (see <a href="#api_nan_property_setter">Property setter declaration</a>)
537
+* Property query methods with the `Nan::PropertyQueryCallback` signature (see <a href="#api_nan_property_query">Property query declaration</a>)
538
+* Property deleters with the `Nan::PropertyDeleterCallback` signature (see <a href="#api_nan_property_deleter">Property deleter declaration</a>)
539
+* Property enumerators with the `Nan::PropertyEnumeratorCallback` signature (see <a href="#api_nan_property_enumerator">Property enumerator declaration</a>)
540
+
541
+Signature:
542
+
543
+```c++
544
+void SetNamedPropertyHandler(v8::Local<v8::ObjectTemplate> tpl,
545
+                             Nan::PropertyGetterCallback getter,
546
+                             Nan::PropertySetterCallback setter = 0,
547
+                             Nan::PropertyQueryCallback query = 0,
548
+                             Nan::PropertyDeleterCallback deleter = 0,
549
+                             Nan::PropertyEnumeratorCallback enumerator = 0,
550
+                             v8::Local<v8::Value> data = v8::Local<v8::Value>())
551
+```
552
+
553
+See the V8 [`ObjectTemplate#SetNamedPropertyHandler()`](https://v8docs.nodesource.com/node-8.16/db/d5f/classv8_1_1_object_template.html#a33b3ebd7de641f6cc6414b7de01fc1c7) for further information about how to use `Nan::SetNamedPropertyHandler()`.
554
+
555
+<a name="api_nan_set_indexed_property_handler"></a>
556
+### Nan::SetIndexedPropertyHandler()
557
+
558
+Sets indexed property getters, setters, query, deleter and enumerator methods on an `ObjectTemplate`. Accepts:
559
+
560
+* Indexed property getters with the `Nan::IndexGetterCallback` signature (see <a href="#api_nan_index_getter">Index getter declaration</a>)
561
+* Indexed property setters with the `Nan::IndexSetterCallback` signature (see <a href="#api_nan_index_setter">Index setter declaration</a>)
562
+* Indexed property query methods with the `Nan::IndexQueryCallback` signature (see <a href="#api_nan_index_query">Index query declaration</a>)
563
+* Indexed property deleters with the `Nan::IndexDeleterCallback` signature (see <a href="#api_nan_index_deleter">Index deleter declaration</a>)
564
+* Indexed property enumerators with the `Nan::IndexEnumeratorCallback` signature (see <a href="#api_nan_index_enumerator">Index enumerator declaration</a>)
565
+
566
+Signature:
567
+
568
+```c++
569
+void SetIndexedPropertyHandler(v8::Local<v8::ObjectTemplate> tpl,
570
+                               Nan::IndexGetterCallback getter,
571
+                               Nan::IndexSetterCallback setter = 0,
572
+                               Nan::IndexQueryCallback query = 0,
573
+                               Nan::IndexDeleterCallback deleter = 0,
574
+                               Nan::IndexEnumeratorCallback enumerator = 0,
575
+                               v8::Local<v8::Value> data = v8::Local<v8::Value>())
576
+```
577
+
578
+See the V8 [`ObjectTemplate#SetIndexedPropertyHandler()`](https://v8docs.nodesource.com/node-8.16/db/d5f/classv8_1_1_object_template.html#ac89f06d634add0e890452033f7d17ff1) for further information about how to use `Nan::SetIndexedPropertyHandler()`.
579
+
580
+<a name="api_nan_set_template"></a>
581
+### Nan::SetTemplate()
582
+
583
+Adds properties on an `Object`'s or `Function`'s template.
584
+
585
+Signature:
586
+
587
+```c++
588
+void Nan::SetTemplate(v8::Local<v8::Template> templ,
589
+                      const char *name,
590
+                      v8::Local<v8::Data> value);
591
+void Nan::SetTemplate(v8::Local<v8::Template> templ,
592
+                      v8::Local<v8::String> name,
593
+                      v8::Local<v8::Data> value,
594
+                      v8::PropertyAttribute attributes)
595
+```
596
+
597
+Calls the `Template`'s [`Set()`](https://v8docs.nodesource.com/node-8.16/db/df7/classv8_1_1_template.html#ae3fbaff137557aa6a0233bc7e52214ac).
598
+
599
+<a name="api_nan_set_prototype_template"></a>
600
+### Nan::SetPrototypeTemplate()
601
+
602
+Adds properties on an `Object`'s or `Function`'s prototype template.
603
+
604
+Signature:
605
+
606
+```c++
607
+void Nan::SetPrototypeTemplate(v8::Local<v8::FunctionTemplate> templ,
608
+                               const char *name,
609
+                               v8::Local<v8::Data> value);
610
+void Nan::SetPrototypeTemplate(v8::Local<v8::FunctionTemplate> templ,
611
+                               v8::Local<v8::String> name,
612
+                               v8::Local<v8::Data> value,
613
+                               v8::PropertyAttribute attributes)
614
+```
615
+
616
+Calls the `FunctionTemplate`'s _PrototypeTemplate's_ [`Set()`](https://v8docs.nodesource.com/node-8.16/db/df7/classv8_1_1_template.html#a2db6a56597bf23c59659c0659e564ddf).
617
+
618
+<a name="api_nan_set_instance_template"></a>
619
+### Nan::SetInstanceTemplate()
620
+
621
+Use to add instance properties on `FunctionTemplate`'s.
622
+
623
+Signature:
624
+
625
+```c++
626
+void Nan::SetInstanceTemplate(v8::Local<v8::FunctionTemplate> templ,
627
+                              const char *name,
628
+                              v8::Local<v8::Data> value);
629
+void Nan::SetInstanceTemplate(v8::Local<v8::FunctionTemplate> templ,
630
+                              v8::Local<v8::String> name,
631
+                              v8::Local<v8::Data> value,
632
+                              v8::PropertyAttribute attributes)
633
+```
634
+
635
+Calls the `FunctionTemplate`'s _InstanceTemplate's_ [`Set()`](https://v8docs.nodesource.com/node-8.16/db/df7/classv8_1_1_template.html#a2db6a56597bf23c59659c0659e564ddf).
636
+
637
+<a name="api_nan_set_call_handler"></a>
638
+### Nan::SetCallHandler()
639
+
640
+Set the call-handler callback for a `v8::FunctionTemplate`.
641
+This callback is called whenever the function created from this FunctionTemplate is called.
642
+
643
+Signature:
644
+
645
+```c++
646
+void Nan::SetCallHandler(v8::Local<v8::FunctionTemplate> templ, Nan::FunctionCallback callback, v8::Local<v8::Value> data = v8::Local<v8::Value>())
647
+```
648
+
649
+Calls the `FunctionTemplate`'s [`SetCallHandler()`](https://v8docs.nodesource.com/node-8.16/d8/d83/classv8_1_1_function_template.html#ab7574b298db3c27fbc2ed465c08ea2f8).
650
+
651
+<a name="api_nan_set_call_as_function_handler"></a>
652
+### Nan::SetCallAsFunctionHandler()
653
+
654
+Sets the callback to be used when calling instances created from the `v8::ObjectTemplate` as a function.
655
+If no callback is set, instances behave like normal JavaScript objects that cannot be called as a function.
656
+
657
+Signature:
658
+
659
+```c++
660
+void Nan::SetCallAsFunctionHandler(v8::Local<v8::ObjectTemplate> templ, Nan::FunctionCallback callback, v8::Local<v8::Value> data = v8::Local<v8::Value>())
661
+```
662
+
663
+Calls the `ObjectTemplate`'s [`SetCallAsFunctionHandler()`](https://v8docs.nodesource.com/node-8.16/db/d5f/classv8_1_1_object_template.html#a5e9612fc80bf6db8f2da199b9b0bd04e).
664
+
... ...
@@ -0,0 +1,147 @@
1
+## New
2
+
3
+NAN provides a `Nan::New()` helper for the creation of new JavaScript objects in a way that's compatible across the supported versions of V8.
4
+
5
+ - <a href="#api_nan_new"><b><code>Nan::New()</code></b></a>
6
+ - <a href="#api_nan_undefined"><b><code>Nan::Undefined()</code></b></a>
7
+ - <a href="#api_nan_null"><b><code>Nan::Null()</code></b></a>
8
+ - <a href="#api_nan_true"><b><code>Nan::True()</code></b></a>
9
+ - <a href="#api_nan_false"><b><code>Nan::False()</code></b></a>
10
+ - <a href="#api_nan_empty_string"><b><code>Nan::EmptyString()</code></b></a>
11
+
12
+
13
+<a name="api_nan_new"></a>
14
+### Nan::New()
15
+
16
+`Nan::New()` should be used to instantiate new JavaScript objects.
17
+
18
+Refer to the specific V8 type in the [V8 documentation](https://v8docs.nodesource.com/node-8.16/d1/d83/classv8_1_1_data.html) for information on the types of arguments required for instantiation.
19
+
20
+Signatures:
21
+
22
+Return types are mostly omitted from the signatures for simplicity. In most cases the type will be contained within a `v8::Local<T>`. The following types will be contained within a `Nan::MaybeLocal<T>`: `v8::String`, `v8::Date`, `v8::RegExp`, `v8::Script`, `v8::UnboundScript`.
23
+
24
+Empty objects:
25
+
26
+```c++
27
+Nan::New<T>();
28
+```
29
+
30
+Generic single and multiple-argument:
31
+
32
+```c++
33
+Nan::New<T>(A0 arg0);
34
+Nan::New<T>(A0 arg0, A1 arg1);
35
+Nan::New<T>(A0 arg0, A1 arg1, A2 arg2);
36
+Nan::New<T>(A0 arg0, A1 arg1, A2 arg2, A3 arg3);
37
+```
38
+
39
+For creating `v8::FunctionTemplate` and `v8::Function` objects:
40
+
41
+_The definition of `Nan::FunctionCallback` can be found in the [Method declaration](./methods.md#api_nan_method) documentation._
42
+
43
+```c++
44
+Nan::New<T>(Nan::FunctionCallback callback,
45
+            v8::Local<v8::Value> data = v8::Local<v8::Value>());
46
+Nan::New<T>(Nan::FunctionCallback callback,
47
+            v8::Local<v8::Value> data = v8::Local<v8::Value>(),
48
+            A2 a2 = A2());
49
+```
50
+
51
+Native number types:
52
+
53
+```c++
54
+v8::Local<v8::Boolean> Nan::New<T>(bool value);
55
+v8::Local<v8::Int32> Nan::New<T>(int32_t value);
56
+v8::Local<v8::Uint32> Nan::New<T>(uint32_t value);
57
+v8::Local<v8::Number> Nan::New<T>(double value);
58
+```
59
+
60
+String types:
61
+
62
+```c++
63
+Nan::MaybeLocal<v8::String> Nan::New<T>(std::string const& value);
64
+Nan::MaybeLocal<v8::String> Nan::New<T>(const char * value, int length);
65
+Nan::MaybeLocal<v8::String> Nan::New<T>(const char * value);
66
+Nan::MaybeLocal<v8::String> Nan::New<T>(const uint16_t * value);
67
+Nan::MaybeLocal<v8::String> Nan::New<T>(const uint16_t * value, int length);
68
+```
69
+
70
+Specialized types:
71
+
72
+```c++
73
+v8::Local<v8::String> Nan::New<T>(v8::String::ExternalStringResource * value);
74
+v8::Local<v8::String> Nan::New<T>(Nan::ExternalOneByteStringResource * value);
75
+v8::Local<v8::RegExp> Nan::New<T>(v8::Local<v8::String> pattern, v8::RegExp::Flags flags);
76
+```
77
+
78
+Note that `Nan::ExternalOneByteStringResource` maps to [`v8::String::ExternalOneByteStringResource`](https://v8docs.nodesource.com/node-8.16/d9/db3/classv8_1_1_string_1_1_external_one_byte_string_resource.html), and `v8::String::ExternalAsciiStringResource` in older versions of V8.
79
+
80
+
81
+<a name="api_nan_undefined"></a>
82
+### Nan::Undefined()
83
+
84
+A helper method to reference the `v8::Undefined` object in a way that is compatible across all supported versions of V8.
85
+
86
+Signature:
87
+
88
+```c++
89
+v8::Local<v8::Primitive> Nan::Undefined()
90
+```
91
+
92
+<a name="api_nan_null"></a>
93
+### Nan::Null()
94
+
95
+A helper method to reference the `v8::Null` object in a way that is compatible across all supported versions of V8.
96
+
97
+Signature:
98
+
99
+```c++
100
+v8::Local<v8::Primitive> Nan::Null()
101
+```
102
+
103
+<a name="api_nan_true"></a>
104
+### Nan::True()
105
+
106
+A helper method to reference the `v8::Boolean` object representing the `true` value in a way that is compatible across all supported versions of V8.
107
+
108
+Signature:
109
+
110
+```c++
111
+v8::Local<v8::Boolean> Nan::True()
112
+```
113
+
114
+<a name="api_nan_false"></a>
115
+### Nan::False()
116
+
117
+A helper method to reference the `v8::Boolean` object representing the `false` value in a way that is compatible across all supported versions of V8.
118
+
119
+Signature:
120
+
121
+```c++
122
+v8::Local<v8::Boolean> Nan::False()
123
+```
124
+
125
+<a name="api_nan_empty_string"></a>
126
+### Nan::EmptyString()
127
+
128
+Call [`v8::String::Empty`](https://v8docs.nodesource.com/node-8.16/d2/db3/classv8_1_1_string.html#a7c1bc8886115d7ee46f1d571dd6ebc6d) to reference the empty string in a way that is compatible across all supported versions of V8.
129
+
130
+Signature:
131
+
132
+```c++
133
+v8::Local<v8::String> Nan::EmptyString()
134
+```
135
+
136
+
137
+<a name="api_nan_new_one_byte_string"></a>
138
+### Nan::NewOneByteString()
139
+
140
+An implementation of [`v8::String::NewFromOneByte()`](https://v8docs.nodesource.com/node-8.16/d2/db3/classv8_1_1_string.html#a5264d50b96d2c896ce525a734dc10f09) provided for consistent availability and API across supported versions of V8. Allocates a new string from Latin-1 data.
141
+
142
+Signature:
143
+
144
+```c++
145
+Nan::MaybeLocal<v8::String> Nan::NewOneByteString(const uint8_t * value,
146
+                                                  int length = -1)
147
+```
... ...
@@ -0,0 +1,123 @@
1
+## Miscellaneous Node Helpers
2
+
3
+ - <a href="#api_nan_asyncresource"><b><code>Nan::AsyncResource</code></b></a>
4
+ - <a href="#api_nan_make_callback"><b><code>Nan::MakeCallback()</code></b></a>
5
+ - <a href="#api_nan_module_init"><b><code>NAN_MODULE_INIT()</code></b></a>
6
+ - <a href="#api_nan_export"><b><code>Nan::Export()</code></b></a>
7
+
8
+<a name="api_nan_asyncresource"></a>
9
+### Nan::AsyncResource
10
+
11
+This class is analogous to the `AsyncResource` JavaScript class exposed by Node's [async_hooks][] API.
12
+
13
+When calling back into JavaScript asynchronously, special care must be taken to ensure that the runtime can properly track
14
+async hops. `Nan::AsyncResource` is a class that provides an RAII wrapper around `node::EmitAsyncInit`, `node::EmitAsyncDestroy`,
15
+and `node::MakeCallback`. Using this mechanism to call back into JavaScript, as opposed to `Nan::MakeCallback` or
16
+`v8::Function::Call` ensures that the callback is executed in the correct async context. This ensures that async mechanisms
17
+such as domains and [async_hooks][] function correctly.
18
+
19
+Definition:
20
+
21
+```c++
22
+class AsyncResource {
23
+ public:
24
+  AsyncResource(v8::Local<v8::String> name,
25
+                v8::Local<v8::Object> resource = New<v8::Object>());
26
+  AsyncResource(const char* name,
27
+                v8::Local<v8::Object> resource = New<v8::Object>());
28
+  ~AsyncResource();
29
+
30
+  v8::MaybeLocal<v8::Value> runInAsyncScope(v8::Local<v8::Object> target,
31
+                                            v8::Local<v8::Function> func,
32
+                                            int argc,
33
+                                            v8::Local<v8::Value>* argv);
34
+  v8::MaybeLocal<v8::Value> runInAsyncScope(v8::Local<v8::Object> target,
35
+                                            v8::Local<v8::String> symbol,
36
+                                            int argc,
37
+                                            v8::Local<v8::Value>* argv);
38
+  v8::MaybeLocal<v8::Value> runInAsyncScope(v8::Local<v8::Object> target,
39
+                                            const char* method,
40
+                                            int argc,
41
+                                            v8::Local<v8::Value>* argv);
42
+};
43
+```
44
+
45
+* `name`: Identifier for the kind of resource that is being provided for diagnostics information exposed by the [async_hooks][]
46
+  API. This will be passed to the possible `init` hook as the `type`. To avoid name collisions with other modules we recommend
47
+  that the name include the name of the owning module as a prefix. For example `mysql` module could use something like
48
+  `mysql:batch-db-query-resource`.
49
+* `resource`: An optional object associated with the async work that will be passed to the possible [async_hooks][]
50
+  `init` hook. If this parameter is omitted, or an empty handle is provided, this object will be created automatically.
51
+* When calling JS on behalf of this resource, one can use `runInAsyncScope`. This will ensure that the callback runs in the
52
+  correct async execution context.
53
+* `AsyncDestroy` is automatically called when an AsyncResource object is destroyed.
54
+
55
+For more details, see the Node [async_hooks][] documentation. You might also want to take a look at the documentation for the
56
+[N-API counterpart][napi]. For example usage, see the `asyncresource.cpp` example in the `test/cpp` directory.
57
+
58
+<a name="api_nan_make_callback"></a>
59
+### Nan::MakeCallback()
60
+
61
+Deprecated wrappers around the legacy `node::MakeCallback()` APIs. Node.js 10+
62
+has deprecated these legacy APIs as they do not provide a mechanism to preserve
63
+async context.
64
+
65
+We recommend that you use the `AsyncResource` class and `AsyncResource::runInAsyncScope` instead of using `Nan::MakeCallback` or
66
+`v8::Function#Call()` directly. `AsyncResource` properly takes care of running the callback in the correct async execution
67
+context – something that is essential for functionality like domains, async_hooks and async debugging.
68
+
69
+Signatures:
70
+
71
+```c++
72
+NAN_DEPRECATED
73
+v8::Local<v8::Value> Nan::MakeCallback(v8::Local<v8::Object> target,
74
+                                       v8::Local<v8::Function> func,
75
+                                       int argc,
76
+                                       v8::Local<v8::Value>* argv);
77
+NAN_DEPRECATED
78
+v8::Local<v8::Value> Nan::MakeCallback(v8::Local<v8::Object> target,
79
+                                       v8::Local<v8::String> symbol,
80
+                                       int argc,
81
+                                       v8::Local<v8::Value>* argv);
82
+NAN_DEPRECATED
83
+v8::Local<v8::Value> Nan::MakeCallback(v8::Local<v8::Object> target,
84
+                                       const char* method,
85
+                                       int argc,
86
+                                       v8::Local<v8::Value>* argv);
87
+```
88
+
89
+
90
+<a name="api_nan_module_init"></a>
91
+### NAN_MODULE_INIT()
92
+
93
+Used to define the entry point function to a Node add-on. Creates a function with a given `name` that receives a `target` object representing the equivalent of the JavaScript `exports` object.
94
+
95
+See example below.
96
+
97
+<a name="api_nan_export"></a>
98
+### Nan::Export()
99
+
100
+A simple helper to register a `v8::FunctionTemplate` from a JavaScript-accessible method (see [Methods](./methods.md)) as a property on an object. Can be used in a way similar to assigning properties to `module.exports` in JavaScript.
101
+
102
+Signature:
103
+
104
+```c++
105
+void Export(v8::Local<v8::Object> target, const char *name, Nan::FunctionCallback f)
106
+```
107
+
108
+Also available as the shortcut `NAN_EXPORT` macro.
109
+
110
+Example:
111
+
112
+```c++
113
+NAN_METHOD(Foo) {
114
+  ...
115
+}
116
+
117
+NAN_MODULE_INIT(Init) {
118
+  NAN_EXPORT(target, Foo);
119
+}
120
+```
121
+
122
+[async_hooks]: https://nodejs.org/dist/latest-v9.x/docs/api/async_hooks.html
123
+[napi]: https://nodejs.org/dist/latest-v9.x/docs/api/n-api.html#n_api_custom_asynchronous_operations
... ...
@@ -0,0 +1,263 @@
1
+## Object Wrappers
2
+
3
+The `ObjectWrap` class can be used to make wrapped C++ objects and a factory of wrapped objects.
4
+
5
+ - <a href="#api_nan_object_wrap"><b><code>Nan::ObjectWrap</code></b></a>
6
+
7
+
8
+<a name="api_nan_object_wrap"></a>
9
+### Nan::ObjectWrap()
10
+
11
+A reimplementation of `node::ObjectWrap` that adds some API not present in older versions of Node. Should be preferred over `node::ObjectWrap` in all cases for consistency.
12
+
13
+Definition:
14
+
15
+```c++
16
+class ObjectWrap {
17
+ public:
18
+  ObjectWrap();
19
+
20
+  virtual ~ObjectWrap();
21
+
22
+  template <class T>
23
+  static inline T* Unwrap(v8::Local<v8::Object> handle);
24
+
25
+  inline v8::Local<v8::Object> handle();
26
+
27
+  inline Nan::Persistent<v8::Object>& persistent();
28
+
29
+ protected:
30
+  inline void Wrap(v8::Local<v8::Object> handle);
31
+
32
+  inline void MakeWeak();
33
+
34
+  /* Ref() marks the object as being attached to an event loop.
35
+   * Refed objects will not be garbage collected, even if
36
+   * all references are lost.
37
+   */
38
+  virtual void Ref();
39
+
40
+  /* Unref() marks an object as detached from the event loop.  This is its
41
+   * default state.  When an object with a "weak" reference changes from
42
+   * attached to detached state it will be freed. Be careful not to access
43
+   * the object after making this call as it might be gone!
44
+   * (A "weak reference" means an object that only has a
45
+   * persistent handle.)
46
+   *
47
+   * DO NOT CALL THIS FROM DESTRUCTOR
48
+   */
49
+  virtual void Unref();
50
+
51
+  int refs_;  // ro
52
+};
53
+```
54
+
55
+See the Node documentation on [Wrapping C++ Objects](https://nodejs.org/api/addons.html#addons_wrapping_c_objects) for more details.
56
+
57
+### This vs. Holder
58
+
59
+When calling `Unwrap`, it is important that the argument is indeed some JavaScript object which got wrapped by a `Wrap` call for this class or any derived class.
60
+The `Signature` installed by [`Nan::SetPrototypeMethod()`](methods.md#api_nan_set_prototype_method) does ensure that `info.Holder()` is just such an instance.
61
+In Node 0.12 and later, `info.This()` will also be of such a type, since otherwise the invocation will get rejected.
62
+However, in Node 0.10 and before it was possible to invoke a method on a JavaScript object which just had the extension type in its prototype chain.
63
+In such a situation, calling `Unwrap` on `info.This()` will likely lead to a failed assertion causing a crash, but could lead to even more serious corruption.
64
+
65
+On the other hand, calling `Unwrap` in an [accessor](methods.md#api_nan_set_accessor) should not use `Holder()` if the accessor is defined on the prototype.
66
+So either define your accessors on the instance template,
67
+or use `This()` after verifying that it is indeed a valid object.
68
+
69
+### Examples
70
+
71
+#### Basic
72
+
73
+```c++
74
+class MyObject : public Nan::ObjectWrap {
75
+ public:
76
+  static NAN_MODULE_INIT(Init) {
77
+    v8::Local<v8::FunctionTemplate> tpl = Nan::New<v8::FunctionTemplate>(New);
78
+    tpl->SetClassName(Nan::New("MyObject").ToLocalChecked());
79
+    tpl->InstanceTemplate()->SetInternalFieldCount(1);
80
+
81
+    Nan::SetPrototypeMethod(tpl, "getHandle", GetHandle);
82
+    Nan::SetPrototypeMethod(tpl, "getValue", GetValue);
83
+
84
+    constructor().Reset(Nan::GetFunction(tpl).ToLocalChecked());
85
+    Nan::Set(target, Nan::New("MyObject").ToLocalChecked(),
86
+      Nan::GetFunction(tpl).ToLocalChecked());
87
+  }
88
+
89
+ private:
90
+  explicit MyObject(double value = 0) : value_(value) {}
91
+  ~MyObject() {}
92
+
93
+  static NAN_METHOD(New) {
94
+    if (info.IsConstructCall()) {
95
+      double value = info[0]->IsUndefined() ? 0 : Nan::To<double>(info[0]).FromJust();
96
+      MyObject *obj = new MyObject(value);
97
+      obj->Wrap(info.This());
98
+      info.GetReturnValue().Set(info.This());
99
+    } else {
100
+      const int argc = 1;
101
+      v8::Local<v8::Value> argv[argc] = {info[0]};
102
+      v8::Local<v8::Function> cons = Nan::New(constructor());
103
+      info.GetReturnValue().Set(Nan::NewInstance(cons, argc, argv).ToLocalChecked());
104
+    }
105
+  }
106
+
107
+  static NAN_METHOD(GetHandle) {
108
+    MyObject* obj = Nan::ObjectWrap::Unwrap<MyObject>(info.Holder());
109
+    info.GetReturnValue().Set(obj->handle());
110
+  }
111
+
112
+  static NAN_METHOD(GetValue) {
113
+    MyObject* obj = Nan::ObjectWrap::Unwrap<MyObject>(info.Holder());
114
+    info.GetReturnValue().Set(obj->value_);
115
+  }
116
+
117
+  static inline Nan::Persistent<v8::Function> & constructor() {
118
+    static Nan::Persistent<v8::Function> my_constructor;
119
+    return my_constructor;
120
+  }
121
+
122
+  double value_;
123
+};
124
+
125
+NODE_MODULE(objectwrapper, MyObject::Init)
126
+```
127
+
128
+To use in Javascript:
129
+
130
+```Javascript
131
+var objectwrapper = require('bindings')('objectwrapper');
132
+
133
+var obj = new objectwrapper.MyObject(5);
134
+console.log('Should be 5: ' + obj.getValue());
135
+```
136
+
137
+#### Factory of wrapped objects
138
+
139
+```c++
140
+class MyFactoryObject : public Nan::ObjectWrap {
141
+ public:
142
+  static NAN_MODULE_INIT(Init) {
143
+    v8::Local<v8::FunctionTemplate> tpl = Nan::New<v8::FunctionTemplate>(New);
144
+    tpl->InstanceTemplate()->SetInternalFieldCount(1);
145
+
146
+    Nan::SetPrototypeMethod(tpl, "getValue", GetValue);
147
+
148
+    constructor().Reset(Nan::GetFunction(tpl).ToLocalChecked());
149
+  }
150
+
151
+  static NAN_METHOD(NewInstance) {
152
+    v8::Local<v8::Function> cons = Nan::New(constructor());
153
+    double value = info[0]->IsNumber() ? Nan::To<double>(info[0]).FromJust() : 0;
154
+    const int argc = 1;
155
+    v8::Local<v8::Value> argv[1] = {Nan::New(value)};
156
+    info.GetReturnValue().Set(Nan::NewInstance(cons, argc, argv).ToLocalChecked());
157
+  }
158
+
159
+  // Needed for the next example:
160
+  inline double value() const {
161
+    return value_;
162
+  }
163
+
164
+ private:
165
+  explicit MyFactoryObject(double value = 0) : value_(value) {}
166
+  ~MyFactoryObject() {}
167
+
168
+  static NAN_METHOD(New) {
169
+    if (info.IsConstructCall()) {
170
+      double value = info[0]->IsNumber() ? Nan::To<double>(info[0]).FromJust() : 0;
171
+      MyFactoryObject * obj = new MyFactoryObject(value);
172
+      obj->Wrap(info.This());
173
+      info.GetReturnValue().Set(info.This());
174
+    } else {
175
+      const int argc = 1;
176
+      v8::Local<v8::Value> argv[argc] = {info[0]};
177
+      v8::Local<v8::Function> cons = Nan::New(constructor());
178
+      info.GetReturnValue().Set(Nan::NewInstance(cons, argc, argv).ToLocalChecked());
179
+    }
180
+  }
181
+
182
+  static NAN_METHOD(GetValue) {
183
+    MyFactoryObject* obj = ObjectWrap::Unwrap<MyFactoryObject>(info.Holder());
184
+    info.GetReturnValue().Set(obj->value_);
185
+  }
186
+
187
+  static inline Nan::Persistent<v8::Function> & constructor() {
188
+    static Nan::Persistent<v8::Function> my_constructor;
189
+    return my_constructor;
190
+  }
191
+
192
+  double value_;
193
+};
194
+
195
+NAN_MODULE_INIT(Init) {
196
+  MyFactoryObject::Init(target);
197
+  Nan::Set(target,
198
+    Nan::New<v8::String>("newFactoryObjectInstance").ToLocalChecked(),
199
+    Nan::GetFunction(
200
+      Nan::New<v8::FunctionTemplate>(MyFactoryObject::NewInstance)).ToLocalChecked()
201
+  );
202
+}
203
+
204
+NODE_MODULE(wrappedobjectfactory, Init)
205
+```
206
+
207
+To use in Javascript:
208
+
209
+```Javascript
210
+var wrappedobjectfactory = require('bindings')('wrappedobjectfactory');
211
+
212
+var obj = wrappedobjectfactory.newFactoryObjectInstance(10);
213
+console.log('Should be 10: ' + obj.getValue());
214
+```
215
+
216
+#### Passing wrapped objects around
217
+
218
+Use the `MyFactoryObject` class above along with the following:
219
+
220
+```c++
221
+static NAN_METHOD(Sum) {
222
+  Nan::MaybeLocal<v8::Object> maybe1 = Nan::To<v8::Object>(info[0]);
223
+  Nan::MaybeLocal<v8::Object> maybe2 = Nan::To<v8::Object>(info[1]);
224
+
225
+  // Quick check:
226
+  if (maybe1.IsEmpty() || maybe2.IsEmpty()) {
227
+    // return value is undefined by default
228
+    return;
229
+  }
230
+
231
+  MyFactoryObject* obj1 =
232
+    Nan::ObjectWrap::Unwrap<MyFactoryObject>(maybe1.ToLocalChecked());
233
+  MyFactoryObject* obj2 =
234
+    Nan::ObjectWrap::Unwrap<MyFactoryObject>(maybe2.ToLocalChecked());
235
+
236
+  info.GetReturnValue().Set(Nan::New<v8::Number>(obj1->value() + obj2->value()));
237
+}
238
+
239
+NAN_MODULE_INIT(Init) {
240
+  MyFactoryObject::Init(target);
241
+  Nan::Set(target,
242
+    Nan::New<v8::String>("newFactoryObjectInstance").ToLocalChecked(),
243
+    Nan::GetFunction(
244
+      Nan::New<v8::FunctionTemplate>(MyFactoryObject::NewInstance)).ToLocalChecked()
245
+  );
246
+  Nan::Set(target,
247
+    Nan::New<v8::String>("sum").ToLocalChecked(),
248
+    Nan::GetFunction(Nan::New<v8::FunctionTemplate>(Sum)).ToLocalChecked()
249
+  );
250
+}
251
+
252
+NODE_MODULE(myaddon, Init)
253
+```
254
+
255
+To use in Javascript:
256
+
257
+```Javascript
258
+var myaddon = require('bindings')('myaddon');
259
+
260
+var obj1 = myaddon.newFactoryObjectInstance(5);
261
+var obj2 = myaddon.newFactoryObjectInstance(10);
262
+console.log('sum of object values: ' + myaddon.sum(obj1, obj2));
263
+```
... ...
@@ -0,0 +1,296 @@
1
+## Persistent references
2
+
3
+An object reference that is independent of any `HandleScope` is a _persistent_ reference. Where a `Local` handle only lives as long as the `HandleScope` in which it was allocated, a `Persistent` handle remains valid until it is explicitly disposed.
4
+
5
+Due to the evolution of the V8 API, it is necessary for NAN to provide a wrapper implementation of the `Persistent` classes to supply compatibility across the V8 versions supported.
6
+
7
+ - <a href="#api_nan_persistent_base"><b><code>Nan::PersistentBase & v8::PersistentBase</code></b></a>
8
+ - <a href="#api_nan_non_copyable_persistent_traits"><b><code>Nan::NonCopyablePersistentTraits & v8::NonCopyablePersistentTraits</code></b></a>
9
+ - <a href="#api_nan_copyable_persistent_traits"><b><code>Nan::CopyablePersistentTraits & v8::CopyablePersistentTraits</code></b></a>
10
+ - <a href="#api_nan_persistent"><b><code>Nan::Persistent</code></b></a>
11
+ - <a href="#api_nan_global"><b><code>Nan::Global</code></b></a>
12
+ - <a href="#api_nan_weak_callback_info"><b><code>Nan::WeakCallbackInfo</code></b></a>
13
+ - <a href="#api_nan_weak_callback_type"><b><code>Nan::WeakCallbackType</code></b></a>
14
+
15
+Also see the V8 Embedders Guide section on [Handles and Garbage Collection](https://developers.google.com/v8/embed#handles).
16
+
17
+<a name="api_nan_persistent_base"></a>
18
+### Nan::PersistentBase & v8::PersistentBase
19
+
20
+A persistent handle contains a reference to a storage cell in V8 which holds an object value and which is updated by the garbage collector whenever the object is moved. A new storage cell can be created using the constructor or `Nan::PersistentBase::Reset()`. Existing handles can be disposed using an argument-less `Nan::PersistentBase::Reset()`.
21
+
22
+Definition:
23
+
24
+_(note: this is implemented as `Nan::PersistentBase` for older versions of V8 and the native `v8::PersistentBase` is used for newer versions of V8)_
25
+
26
+```c++
27
+template<typename T> class PersistentBase {
28
+ public:
29
+  /**
30
+   * If non-empty, destroy the underlying storage cell
31
+   */
32
+  void Reset();
33
+
34
+  /**
35
+   * If non-empty, destroy the underlying storage cell and create a new one with
36
+   * the contents of another if it is also non-empty
37
+   */
38
+  template<typename S> void Reset(const v8::Local<S> &other);
39
+
40
+  /**
41
+   * If non-empty, destroy the underlying storage cell and create a new one with
42
+   * the contents of another if it is also non-empty
43
+   */
44
+  template<typename S> void Reset(const PersistentBase<S> &other);
45
+
46
+  /** Returns true if the handle is empty. */
47
+  bool IsEmpty() const;
48
+
49
+  /**
50
+   * If non-empty, destroy the underlying storage cell
51
+   * IsEmpty() will return true after this call.
52
+   */
53
+  void Empty();
54
+
55
+  template<typename S> bool operator==(const PersistentBase<S> &that);
56
+
57
+  template<typename S> bool operator==(const v8::Local<S> &that);
58
+
59
+  template<typename S> bool operator!=(const PersistentBase<S> &that);
60
+
61
+  template<typename S> bool operator!=(const v8::Local<S> &that);
62
+
63
+   /**
64
+   *  Install a finalization callback on this object.
65
+   *  NOTE: There is no guarantee as to *when* or even *if* the callback is
66
+   *  invoked. The invocation is performed solely on a best effort basis.
67
+   *  As always, GC-based finalization should *not* be relied upon for any
68
+   *  critical form of resource management! At the moment you can either
69
+   *  specify a parameter for the callback or the location of two internal
70
+   *  fields in the dying object.
71
+   */
72
+  template<typename P>
73
+  void SetWeak(P *parameter,
74
+               typename WeakCallbackInfo<P>::Callback callback,
75
+               WeakCallbackType type);
76
+
77
+  void ClearWeak();
78
+
79
+  /**
80
+   * Marks the reference to this object independent. Garbage collector is free
81
+   * to ignore any object groups containing this object. Weak callback for an
82
+   * independent handle should not assume that it will be preceded by a global
83
+   * GC prologue callback or followed by a global GC epilogue callback.
84
+   */
85
+  void MarkIndependent() const;
86
+
87
+  bool IsIndependent() const;
88
+
89
+  /** Checks if the handle holds the only reference to an object. */
90
+  bool IsNearDeath() const;
91
+
92
+  /** Returns true if the handle's reference is weak.  */
93
+  bool IsWeak() const
94
+};
95
+```
96
+
97
+See the V8 documentation for [`PersistentBase`](https://v8docs.nodesource.com/node-8.16/d4/dca/classv8_1_1_persistent_base.html) for further information.
98
+
99
+**Tip:** To get a `v8::Local` reference to the original object back from a `PersistentBase` or `Persistent` object:
100
+
101
+```c++
102
+v8::Local<v8::Object> object = Nan::New(persistent);
103
+```
104
+
105
+<a name="api_nan_non_copyable_persistent_traits"></a>
106
+### Nan::NonCopyablePersistentTraits & v8::NonCopyablePersistentTraits
107
+
108
+Default traits for `Nan::Persistent`. This class does not allow use of the a copy constructor or assignment operator. At present `kResetInDestructor` is not set, but that will change in a future version.
109
+
110
+Definition:
111
+
112
+_(note: this is implemented as `Nan::NonCopyablePersistentTraits` for older versions of V8 and the native `v8::NonCopyablePersistentTraits` is used for newer versions of V8)_
113
+
114
+```c++
115
+template<typename T> class NonCopyablePersistentTraits {
116
+ public:
117
+  typedef Persistent<T, NonCopyablePersistentTraits<T> > NonCopyablePersistent;
118
+
119
+  static const bool kResetInDestructor = false;
120
+
121
+  template<typename S, typename M>
122
+  static void Copy(const Persistent<S, M> &source,
123
+                   NonCopyablePersistent *dest);
124
+
125
+  template<typename O> static void Uncompilable();
126
+};
127
+```
128
+
129
+See the V8 documentation for [`NonCopyablePersistentTraits`](https://v8docs.nodesource.com/node-8.16/de/d73/classv8_1_1_non_copyable_persistent_traits.html) for further information.
130
+
131
+<a name="api_nan_copyable_persistent_traits"></a>
132
+### Nan::CopyablePersistentTraits & v8::CopyablePersistentTraits
133
+
134
+A helper class of traits to allow copying and assignment of `Persistent`. This will clone the contents of storage cell, but not any of the flags, etc..
135
+
136
+Definition:
137
+
138
+_(note: this is implemented as `Nan::CopyablePersistentTraits` for older versions of V8 and the native `v8::NonCopyablePersistentTraits` is used for newer versions of V8)_
139
+
140
+```c++
141
+template<typename T>
142
+class CopyablePersistentTraits {
143
+ public:
144
+  typedef Persistent<T, CopyablePersistentTraits<T> > CopyablePersistent;
145
+
146
+  static const bool kResetInDestructor = true;
147
+
148
+  template<typename S, typename M>
149
+  static void Copy(const Persistent<S, M> &source,
150
+                   CopyablePersistent *dest);
151
+};
152
+```
153
+
154
+See the V8 documentation for [`CopyablePersistentTraits`](https://v8docs.nodesource.com/node-8.16/da/d5c/structv8_1_1_copyable_persistent_traits.html) for further information.
155
+
156
+<a name="api_nan_persistent"></a>
157
+### Nan::Persistent
158
+
159
+A type of `PersistentBase` which allows copy and assignment. Copy, assignment and destructor behavior is controlled by the traits class `M`.
160
+
161
+Definition:
162
+
163
+```c++
164
+template<typename T, typename M = NonCopyablePersistentTraits<T> >
165
+class Persistent;
166
+
167
+template<typename T, typename M> class Persistent : public PersistentBase<T> {
168
+ public:
169
+ /**
170
+  * A Persistent with no storage cell.
171
+  */
172
+  Persistent();
173
+
174
+  /**
175
+   * Construct a Persistent from a v8::Local. When the v8::Local is non-empty, a
176
+   * new storage cell is created pointing to the same object, and no flags are
177
+   * set.
178
+   */
179
+  template<typename S> Persistent(v8::Local<S> that);
180
+
181
+  /**
182
+   * Construct a Persistent from a Persistent. When the Persistent is non-empty,
183
+   * a new storage cell is created pointing to the same object, and no flags are
184
+   * set.
185
+   */
186
+  Persistent(const Persistent &that);
187
+
188
+  /**
189
+   * The copy constructors and assignment operator create a Persistent exactly
190
+   * as the Persistent constructor, but the Copy function from the traits class
191
+   * is called, allowing the setting of flags based on the copied Persistent.
192
+   */
193
+  Persistent &operator=(const Persistent &that);
194
+
195
+  template <typename S, typename M2>
196
+  Persistent &operator=(const Persistent<S, M2> &that);
197
+
198
+  /**
199
+   * The destructor will dispose the Persistent based on the kResetInDestructor
200
+   * flags in the traits class.  Since not calling dispose can result in a
201
+   * memory leak, it is recommended to always set this flag.
202
+   */
203
+  ~Persistent();
204
+};
205
+```
206
+
207
+See the V8 documentation for [`Persistent`](https://v8docs.nodesource.com/node-8.16/d2/d78/classv8_1_1_persistent.html) for further information.
208
+
209
+<a name="api_nan_global"></a>
210
+### Nan::Global
211
+
212
+A type of `PersistentBase` which has move semantics.
213
+
214
+```c++
215
+template<typename T> class Global : public PersistentBase<T> {
216
+ public:
217
+  /**
218
+   * A Global with no storage cell.
219
+   */
220
+  Global();
221
+
222
+  /**
223
+   * Construct a Global from a v8::Local. When the v8::Local is non-empty, a new
224
+   * storage cell is created pointing to the same object, and no flags are set.
225
+   */
226
+  template<typename S> Global(v8::Local<S> that);
227
+  /**
228
+   * Construct a Global from a PersistentBase. When the Persistent is non-empty,
229
+   * a new storage cell is created pointing to the same object, and no flags are
230
+   * set.
231
+   */
232
+  template<typename S> Global(const PersistentBase<S> &that);
233
+
234
+  /**
235
+   * Pass allows returning globals from functions, etc.
236
+   */
237
+  Global Pass();
238
+};
239
+```
240
+
241
+See the V8 documentation for [`Global`](https://v8docs.nodesource.com/node-8.16/d5/d40/classv8_1_1_global.html) for further information.
242
+
243
+<a name="api_nan_weak_callback_info"></a>
244
+### Nan::WeakCallbackInfo
245
+
246
+`Nan::WeakCallbackInfo` is used as an argument when setting a persistent reference as weak. You may need to free any external resources attached to the object. It is a mirror of `v8:WeakCallbackInfo` as found in newer versions of V8.
247
+
248
+Definition:
249
+
250
+```c++
251
+template<typename T> class WeakCallbackInfo {
252
+ public:
253
+  typedef void (*Callback)(const WeakCallbackInfo<T>& data);
254
+
255
+  v8::Isolate *GetIsolate() const;
256
+
257
+  /**
258
+   * Get the parameter that was associated with the weak handle.
259
+   */
260
+  T *GetParameter() const;
261
+
262
+  /**
263
+   * Get pointer from internal field, index can be 0 or 1.
264
+   */
265
+  void *GetInternalField(int index) const;
266
+};
267
+```
268
+
269
+Example usage:
270
+
271
+```c++
272
+void weakCallback(const WeakCallbackInfo<int> &data) {
273
+  int *parameter = data.GetParameter();
274
+  delete parameter;
275
+}
276
+
277
+Persistent<v8::Object> obj;
278
+int *data = new int(0);
279
+obj.SetWeak(data, callback, WeakCallbackType::kParameter);
280
+```
281
+
282
+See the V8 documentation for [`WeakCallbackInfo`](https://v8docs.nodesource.com/node-8.16/d8/d06/classv8_1_1_weak_callback_info.html) for further information.
283
+
284
+<a name="api_nan_weak_callback_type"></a>
285
+### Nan::WeakCallbackType
286
+
287
+Represents the type of a weak callback.
288
+A weak callback of type `kParameter` makes the supplied parameter to `Nan::PersistentBase::SetWeak` available through `WeakCallbackInfo::GetParameter`.
289
+A weak callback of type `kInternalFields` uses up to two internal fields at indices 0 and 1 on the `Nan::PersistentBase<v8::Object>` being made weak.
290
+Note that only `v8::Object`s and derivatives can have internal fields.
291
+
292
+Definition:
293
+
294
+```c++
295
+enum class WeakCallbackType { kParameter, kInternalFields };
296
+```
... ...
@@ -0,0 +1,73 @@
1
+## Scopes
2
+
3
+A _local handle_ is a pointer to an object. All V8 objects are accessed using handles, they are necessary because of the way the V8 garbage collector works.
4
+
5
+A handle scope can be thought of as a container for any number of handles. When you've finished with your handles, instead of deleting each one individually you can simply delete their scope.
6
+
7
+The creation of `HandleScope` objects is different across the supported versions of V8. Therefore, NAN provides its own implementations that can be used safely across these.
8
+
9
+ - <a href="#api_nan_handle_scope"><b><code>Nan::HandleScope</code></b></a>
10
+ - <a href="#api_nan_escapable_handle_scope"><b><code>Nan::EscapableHandleScope</code></b></a>
11
+
12
+Also see the V8 Embedders Guide section on [Handles and Garbage Collection](https://github.com/v8/v8/wiki/Embedder%27s%20Guide#handles-and-garbage-collection).
13
+
14
+<a name="api_nan_handle_scope"></a>
15
+### Nan::HandleScope
16
+
17
+A simple wrapper around [`v8::HandleScope`](https://v8docs.nodesource.com/node-8.16/d3/d95/classv8_1_1_handle_scope.html).
18
+
19
+Definition:
20
+
21
+```c++
22
+class Nan::HandleScope {
23
+ public:
24
+  Nan::HandleScope();
25
+  static int NumberOfHandles();
26
+};
27
+```
28
+
29
+Allocate a new `Nan::HandleScope` whenever you are creating new V8 JavaScript objects. Note that an implicit `HandleScope` is created for you on JavaScript-accessible methods so you do not need to insert one yourself.
30
+
31
+Example:
32
+
33
+```c++
34
+// new object is created, it needs a new scope:
35
+void Pointless() {
36
+  Nan::HandleScope scope;
37
+  v8::Local<v8::Object> obj = Nan::New<v8::Object>();
38
+}
39
+
40
+// JavaScript-accessible method already has a HandleScope
41
+NAN_METHOD(Pointless2) {
42
+  v8::Local<v8::Object> obj = Nan::New<v8::Object>();
43
+}
44
+```
45
+
46
+<a name="api_nan_escapable_handle_scope"></a>
47
+### Nan::EscapableHandleScope
48
+
49
+Similar to [`Nan::HandleScope`](#api_nan_handle_scope) but should be used in cases where a function needs to return a V8 JavaScript type that has been created within it.
50
+
51
+Definition:
52
+
53
+```c++
54
+class Nan::EscapableHandleScope {
55
+ public:
56
+  Nan::EscapableHandleScope();
57
+  static int NumberOfHandles();
58
+  template<typename T> v8::Local<T> Escape(v8::Local<T> value);
59
+}
60
+```
61
+
62
+Use `Escape(value)` to return the object.
63
+
64
+Example:
65
+
66
+```c++
67
+v8::Local<v8::Object> EmptyObj() {
68
+  Nan::EscapableHandleScope scope;
69
+  v8::Local<v8::Object> obj = Nan::New<v8::Object>();
70
+  return scope.Escape(obj);
71
+}
72
+```
73
+
... ...
@@ -0,0 +1,58 @@
1
+## Script
2
+
3
+NAN provides `v8::Script` helpers as the API has changed over the supported versions of V8.
4
+
5
+ - <a href="#api_nan_compile_script"><b><code>Nan::CompileScript()</code></b></a>
6
+ - <a href="#api_nan_run_script"><b><code>Nan::RunScript()</code></b></a>
7
+ - <a href="#api_nan_script_origin"><b><code>Nan::ScriptOrigin</code></b></a>
8
+
9
+
10
+<a name="api_nan_compile_script"></a>
11
+### Nan::CompileScript()
12
+
13
+A wrapper around [`v8::ScriptCompiler::Compile()`](https://v8docs.nodesource.com/node-8.16/da/da5/classv8_1_1_script_compiler.html#a93f5072a0db55d881b969e9fc98e564b).
14
+
15
+Note that `Nan::BoundScript` is an alias for `v8::Script`.
16
+
17
+Signature:
18
+
19
+```c++
20
+Nan::MaybeLocal<Nan::BoundScript> Nan::CompileScript(
21
+    v8::Local<v8::String> s,
22
+    const v8::ScriptOrigin& origin);
23
+Nan::MaybeLocal<Nan::BoundScript> Nan::CompileScript(v8::Local<v8::String> s);
24
+```
25
+
26
+
27
+<a name="api_nan_run_script"></a>
28
+### Nan::RunScript()
29
+
30
+Calls `script->Run()` or `script->BindToCurrentContext()->Run(Nan::GetCurrentContext())`.
31
+
32
+Note that `Nan::BoundScript` is an alias for `v8::Script` and `Nan::UnboundScript` is an alias for `v8::UnboundScript` where available and `v8::Script` on older versions of V8.
33
+
34
+Signature:
35
+
36
+```c++
37
+Nan::MaybeLocal<v8::Value> Nan::RunScript(v8::Local<Nan::UnboundScript> script)
38
+Nan::MaybeLocal<v8::Value> Nan::RunScript(v8::Local<Nan::BoundScript> script)
39
+```
40
+
41
+<a name="api_nan_script_origin"></a>
42
+### Nan::ScriptOrigin
43
+
44
+A class transparently extending [`v8::ScriptOrigin`](https://v8docs.nodesource.com/node-16.0/db/d84/classv8_1_1_script_origin.html#pub-methods)
45
+to provide backwards compatibility. Only the listed methods are guaranteed to
46
+be available on all versions of Node.
47
+
48
+Declaration:
49
+
50
+```c++
51
+class Nan::ScriptOrigin : public v8::ScriptOrigin {
52
+ public:
53
+  ScriptOrigin(v8::Local<v8::Value> name, v8::Local<v8::Integer> line = v8::Local<v8::Integer>(), v8::Local<v8::Integer> column = v8::Local<v8::Integer>())
54
+  v8::Local<v8::Value> ResourceName() const;
55
+  v8::Local<v8::Integer> ResourceLineOffset() const;
56
+  v8::Local<v8::Integer> ResourceColumnOffset() const;
57
+}
58
+```
... ...
@@ -0,0 +1,62 @@
1
+## Strings & Bytes
2
+
3
+Miscellaneous string & byte encoding and decoding functionality provided for compatibility across supported versions of V8 and Node. Implemented by NAN to ensure that all encoding types are supported, even for older versions of Node where they are missing.
4
+
5
+ - <a href="#api_nan_encoding"><b><code>Nan::Encoding</code></b></a>
6
+ - <a href="#api_nan_encode"><b><code>Nan::Encode()</code></b></a>
7
+ - <a href="#api_nan_decode_bytes"><b><code>Nan::DecodeBytes()</code></b></a>
8
+ - <a href="#api_nan_decode_write"><b><code>Nan::DecodeWrite()</code></b></a>
9
+
10
+
11
+<a name="api_nan_encoding"></a>
12
+### Nan::Encoding
13
+
14
+An enum representing the supported encoding types. A copy of `node::encoding` that is consistent across versions of Node.
15
+
16
+Definition:
17
+
18
+```c++
19
+enum Nan::Encoding { ASCII, UTF8, BASE64, UCS2, BINARY, HEX, BUFFER }
20
+```
21
+
22
+
23
+<a name="api_nan_encode"></a>
24
+### Nan::Encode()
25
+
26
+A wrapper around `node::Encode()` that provides a consistent implementation across supported versions of Node.
27
+
28
+Signature:
29
+
30
+```c++
31
+v8::Local<v8::Value> Nan::Encode(const void *buf,
32
+                                 size_t len,
33
+                                 enum Nan::Encoding encoding = BINARY);
34
+```
35
+
36
+
37
+<a name="api_nan_decode_bytes"></a>
38
+### Nan::DecodeBytes()
39
+
40
+A wrapper around `node::DecodeBytes()` that provides a consistent implementation across supported versions of Node.
41
+
42
+Signature:
43
+
44
+```c++
45
+ssize_t Nan::DecodeBytes(v8::Local<v8::Value> val,
46
+                         enum Nan::Encoding encoding = BINARY);
47
+```
48
+
49
+
50
+<a name="api_nan_decode_write"></a>
51
+### Nan::DecodeWrite()
52
+
53
+A wrapper around `node::DecodeWrite()` that provides a consistent implementation across supported versions of Node.
54
+
55
+Signature:
56
+
57
+```c++
58
+ssize_t Nan::DecodeWrite(char *buf,
59
+                         size_t len,
60
+                         v8::Local<v8::Value> val,
61
+                         enum Nan::Encoding encoding = BINARY);
62
+```
... ...
@@ -0,0 +1,199 @@
1
+## V8 internals
2
+
3
+The hooks to access V8 internals—including GC and statistics—are different across the supported versions of V8, therefore NAN provides its own hooks that call the appropriate V8 methods.
4
+
5
+ - <a href="#api_nan_gc_callback"><b><code>NAN_GC_CALLBACK()</code></b></a>
6
+ - <a href="#api_nan_add_gc_epilogue_callback"><b><code>Nan::AddGCEpilogueCallback()</code></b></a>
7
+ - <a href="#api_nan_remove_gc_epilogue_callback"><b><code>Nan::RemoveGCEpilogueCallback()</code></b></a>
8
+ - <a href="#api_nan_add_gc_prologue_callback"><b><code>Nan::AddGCPrologueCallback()</code></b></a>
9
+ - <a href="#api_nan_remove_gc_prologue_callback"><b><code>Nan::RemoveGCPrologueCallback()</code></b></a>
10
+ - <a href="#api_nan_get_heap_statistics"><b><code>Nan::GetHeapStatistics()</code></b></a>
11
+ - <a href="#api_nan_set_counter_function"><b><code>Nan::SetCounterFunction()</code></b></a>
12
+ - <a href="#api_nan_set_create_histogram_function"><b><code>Nan::SetCreateHistogramFunction()</code></b></a>
13
+ - <a href="#api_nan_set_add_histogram_sample_function"><b><code>Nan::SetAddHistogramSampleFunction()</code></b></a>
14
+ - <a href="#api_nan_idle_notification"><b><code>Nan::IdleNotification()</code></b></a>
15
+ - <a href="#api_nan_low_memory_notification"><b><code>Nan::LowMemoryNotification()</code></b></a>
16
+ - <a href="#api_nan_context_disposed_notification"><b><code>Nan::ContextDisposedNotification()</code></b></a>
17
+ - <a href="#api_nan_get_internal_field_pointer"><b><code>Nan::GetInternalFieldPointer()</code></b></a>
18
+ - <a href="#api_nan_set_internal_field_pointer"><b><code>Nan::SetInternalFieldPointer()</code></b></a>
19
+ - <a href="#api_nan_adjust_external_memory"><b><code>Nan::AdjustExternalMemory()</code></b></a>
20
+
21
+
22
+<a name="api_nan_gc_callback"></a>
23
+### NAN_GC_CALLBACK(callbackname)
24
+
25
+Use `NAN_GC_CALLBACK` to declare your callbacks for `Nan::AddGCPrologueCallback()` and `Nan::AddGCEpilogueCallback()`. Your new method receives the arguments `v8::GCType type` and `v8::GCCallbackFlags flags`.
26
+
27
+```c++
28
+static Nan::Persistent<Function> callback;
29
+
30
+NAN_GC_CALLBACK(gcPrologueCallback) {
31
+  v8::Local<Value> argv[] = { Nan::New("prologue").ToLocalChecked() };
32
+  Nan::MakeCallback(Nan::GetCurrentContext()->Global(), Nan::New(callback), 1, argv);
33
+}
34
+
35
+NAN_METHOD(Hook) {
36
+  callback.Reset(To<Function>(args[0]).ToLocalChecked());
37
+  Nan::AddGCPrologueCallback(gcPrologueCallback);
38
+  info.GetReturnValue().Set(info.Holder());
39
+}
40
+```
41
+
42
+<a name="api_nan_add_gc_epilogue_callback"></a>
43
+### Nan::AddGCEpilogueCallback()
44
+
45
+Signature:
46
+
47
+```c++
48
+void Nan::AddGCEpilogueCallback(v8::Isolate::GCEpilogueCallback callback, v8::GCType gc_type_filter = v8::kGCTypeAll)
49
+```
50
+
51
+Calls V8's [`AddGCEpilogueCallback()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a580f976e4290cead62c2fc4dd396be3e).
52
+
53
+<a name="api_nan_remove_gc_epilogue_callback"></a>
54
+### Nan::RemoveGCEpilogueCallback()
55
+
56
+Signature:
57
+
58
+```c++
59
+void Nan::RemoveGCEpilogueCallback(v8::Isolate::GCEpilogueCallback callback)
60
+```
61
+
62
+Calls V8's [`RemoveGCEpilogueCallback()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#adca9294555a3908e9f23c7bb0f0f284c).
63
+
64
+<a name="api_nan_add_gc_prologue_callback"></a>
65
+### Nan::AddGCPrologueCallback()
66
+
67
+Signature:
68
+
69
+```c++
70
+void Nan::AddGCPrologueCallback(v8::Isolate::GCPrologueCallback, v8::GCType gc_type_filter callback)
71
+```
72
+
73
+Calls V8's [`AddGCPrologueCallback()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a6dbef303603ebdb03da6998794ea05b8).
74
+
75
+<a name="api_nan_remove_gc_prologue_callback"></a>
76
+### Nan::RemoveGCPrologueCallback()
77
+
78
+Signature:
79
+
80
+```c++
81
+void Nan::RemoveGCPrologueCallback(v8::Isolate::GCPrologueCallback callback)
82
+```
83
+
84
+Calls V8's [`RemoveGCPrologueCallback()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a5f72c7cda21415ce062bbe5c58abe09e).
85
+
86
+<a name="api_nan_get_heap_statistics"></a>
87
+### Nan::GetHeapStatistics()
88
+
89
+Signature:
90
+
91
+```c++
92
+void Nan::GetHeapStatistics(v8::HeapStatistics *heap_statistics)
93
+```
94
+
95
+Calls V8's [`GetHeapStatistics()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a5593ac74687b713095c38987e5950b34).
96
+
97
+<a name="api_nan_set_counter_function"></a>
98
+### Nan::SetCounterFunction()
99
+
100
+Signature:
101
+
102
+```c++
103
+void Nan::SetCounterFunction(v8::CounterLookupCallback cb)
104
+```
105
+
106
+Calls V8's [`SetCounterFunction()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a045d7754e62fa0ec72ae6c259b29af94).
107
+
108
+<a name="api_nan_set_create_histogram_function"></a>
109
+### Nan::SetCreateHistogramFunction()
110
+
111
+Signature:
112
+
113
+```c++
114
+void Nan::SetCreateHistogramFunction(v8::CreateHistogramCallback cb) 
115
+```
116
+
117
+Calls V8's [`SetCreateHistogramFunction()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a542d67e85089cb3f92aadf032f99e732).
118
+
119
+<a name="api_nan_set_add_histogram_sample_function"></a>
120
+### Nan::SetAddHistogramSampleFunction()
121
+
122
+Signature:
123
+
124
+```c++
125
+void Nan::SetAddHistogramSampleFunction(v8::AddHistogramSampleCallback cb) 
126
+```
127
+
128
+Calls V8's [`SetAddHistogramSampleFunction()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#aeb420b690bc2c216882d6fdd00ddd3ea).
129
+
130
+<a name="api_nan_idle_notification"></a>
131
+### Nan::IdleNotification()
132
+
133
+Signature:
134
+
135
+```c++
136
+bool Nan::IdleNotification(int idle_time_in_ms)
137
+```
138
+
139
+Calls V8's [`IdleNotification()` or `IdleNotificationDeadline()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#ad6a2a02657f5425ad460060652a5a118) depending on V8 version.
140
+
141
+<a name="api_nan_low_memory_notification"></a>
142
+### Nan::LowMemoryNotification()
143
+
144
+Signature:
145
+
146
+```c++
147
+void Nan::LowMemoryNotification() 
148
+```
149
+
150
+Calls V8's [`LowMemoryNotification()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a24647f61d6b41f69668094bdcd6ea91f).
151
+
152
+<a name="api_nan_context_disposed_notification"></a>
153
+### Nan::ContextDisposedNotification()
154
+
155
+Signature:
156
+
157
+```c++
158
+void Nan::ContextDisposedNotification()
159
+```
160
+
161
+Calls V8's [`ContextDisposedNotification()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#ad7f5dc559866343fe6cd8db1f134d48b).
162
+
163
+<a name="api_nan_get_internal_field_pointer"></a>
164
+### Nan::GetInternalFieldPointer()
165
+
166
+Gets a pointer to the internal field with at `index` from a V8 `Object` handle.
167
+
168
+Signature:
169
+
170
+```c++
171
+void* Nan::GetInternalFieldPointer(v8::Local<v8::Object> object, int index) 
172
+```
173
+
174
+Calls the Object's [`GetAlignedPointerFromInternalField()` or `GetPointerFromInternalField()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#a580ea84afb26c005d6762eeb9e3c308f) depending on the version of V8.
175
+
176
+<a name="api_nan_set_internal_field_pointer"></a>
177
+### Nan::SetInternalFieldPointer()
178
+
179
+Sets the value of the internal field at `index` on a V8 `Object` handle.
180
+
181
+Signature:
182
+
183
+```c++
184
+void Nan::SetInternalFieldPointer(v8::Local<v8::Object> object, int index, void* value)
185
+```
186
+
187
+Calls the Object's [`SetAlignedPointerInInternalField()` or `SetPointerInInternalField()`](https://v8docs.nodesource.com/node-8.16/db/d85/classv8_1_1_object.html#ab3c57184263cf29963ef0017bec82281) depending on the version of V8.
188
+
189
+<a name="api_nan_adjust_external_memory"></a>
190
+### Nan::AdjustExternalMemory()
191
+
192
+Signature:
193
+
194
+```c++
195
+int Nan::AdjustExternalMemory(int bytesChange)
196
+```
197
+
198
+Calls V8's [`AdjustAmountOfExternalAllocatedMemory()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#ae1a59cac60409d3922582c4af675473e).
199
+
... ...
@@ -0,0 +1,85 @@
1
+## Miscellaneous V8 Helpers
2
+
3
+ - <a href="#api_nan_utf8_string"><b><code>Nan::Utf8String</code></b></a>
4
+ - <a href="#api_nan_get_current_context"><b><code>Nan::GetCurrentContext()</code></b></a>
5
+ - <a href="#api_nan_set_isolate_data"><b><code>Nan::SetIsolateData()</code></b></a>
6
+ - <a href="#api_nan_get_isolate_data"><b><code>Nan::GetIsolateData()</code></b></a>
7
+ - <a href="#api_nan_typedarray_contents"><b><code>Nan::TypedArrayContents</code></b></a>
8
+
9
+
10
+<a name="api_nan_utf8_string"></a>
11
+### Nan::Utf8String
12
+
13
+Converts an object to a UTF-8-encoded character array. If conversion to a string fails (e.g. due to an exception in the toString() method of the object) then the length() method returns 0 and the * operator returns NULL. The underlying memory used for this object is managed by the object.
14
+
15
+An implementation of [`v8::String::Utf8Value`](https://v8docs.nodesource.com/node-8.16/d4/d1b/classv8_1_1_string_1_1_utf8_value.html) that is consistent across all supported versions of V8.
16
+
17
+Definition:
18
+
19
+```c++
20
+class Nan::Utf8String {
21
+ public:
22
+  Nan::Utf8String(v8::Local<v8::Value> from);
23
+
24
+  int length() const;
25
+
26
+  char* operator*();
27
+  const char* operator*() const;
28
+};
29
+```
30
+
31
+<a name="api_nan_get_current_context"></a>
32
+### Nan::GetCurrentContext()
33
+
34
+A call to [`v8::Isolate::GetCurrent()->GetCurrentContext()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a81c7a1ed7001ae2a65e89107f75fd053) that works across all supported versions of V8.
35
+
36
+Signature:
37
+
38
+```c++
39
+v8::Local<v8::Context> Nan::GetCurrentContext()
40
+```
41
+
42
+<a name="api_nan_set_isolate_data"></a>
43
+### Nan::SetIsolateData()
44
+
45
+A helper to provide a consistent API to [`v8::Isolate#SetData()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#a7acadfe7965997e9c386a05f098fbe36).
46
+
47
+Signature:
48
+
49
+```c++
50
+void Nan::SetIsolateData(v8::Isolate *isolate, T *data)
51
+```
52
+
53
+
54
+<a name="api_nan_get_isolate_data"></a>
55
+### Nan::GetIsolateData()
56
+
57
+A helper to provide a consistent API to [`v8::Isolate#GetData()`](https://v8docs.nodesource.com/node-8.16/d5/dda/classv8_1_1_isolate.html#aabd223436bc1100a787dadaa024c6257).
58
+
59
+Signature:
60
+
61
+```c++
62
+T *Nan::GetIsolateData(v8::Isolate *isolate)
63
+```
64
+
65
+<a name="api_nan_typedarray_contents"></a>
66
+### Nan::TypedArrayContents<T>
67
+
68
+A helper class for accessing the contents of an ArrayBufferView (aka a typedarray) from C++.  If the input array is not a valid typedarray, then the data pointer of TypedArrayContents will default to `NULL` and the length will be 0.  If the data pointer is not compatible with the alignment requirements of type, an assertion error will fail.
69
+
70
+Note that you must store a reference to the `array` object while you are accessing its contents.
71
+
72
+Definition:
73
+
74
+```c++
75
+template<typename T>
76
+class Nan::TypedArrayContents {
77
+ public:
78
+  TypedArrayContents(v8::Local<Value> array);
79
+
80
+  size_t length() const;
81
+
82
+  T* const operator*();
83
+  const T* const operator*() const;
84
+};
85
+```
... ...
@@ -0,0 +1 @@
1
+console.log(require('path').relative('.', __dirname));
... ...
@@ -0,0 +1,2904 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors:
5
+ *   - Rod Vagg <https://github.com/rvagg>
6
+ *   - Benjamin Byholm <https://github.com/kkoopa>
7
+ *   - Trevor Norris <https://github.com/trevnorris>
8
+ *   - Nathan Rajlich <https://github.com/TooTallNate>
9
+ *   - Brett Lawson <https://github.com/brett19>
10
+ *   - Ben Noordhuis <https://github.com/bnoordhuis>
11
+ *   - David Siegel <https://github.com/agnat>
12
+ *   - Michael Ira Krufky <https://github.com/mkrufky>
13
+ *
14
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
15
+ *
16
+ * Version 2.15.0: current Node 16.6.1, Node 0.12: 0.12.18, Node 0.10: 0.10.48, iojs: 3.3.1
17
+ *
18
+ * See https://github.com/nodejs/nan for the latest update to this file
19
+ **********************************************************************************/
20
+
21
+#ifndef NAN_H_
22
+#define NAN_H_
23
+
24
+#include <node_version.h>
25
+
26
+#define NODE_0_10_MODULE_VERSION 11
27
+#define NODE_0_12_MODULE_VERSION 14
28
+#define ATOM_0_21_MODULE_VERSION 41
29
+#define IOJS_1_0_MODULE_VERSION  42
30
+#define IOJS_1_1_MODULE_VERSION  43
31
+#define IOJS_2_0_MODULE_VERSION  44
32
+#define IOJS_3_0_MODULE_VERSION  45
33
+#define NODE_4_0_MODULE_VERSION  46
34
+#define NODE_5_0_MODULE_VERSION  47
35
+#define NODE_6_0_MODULE_VERSION  48
36
+#define NODE_7_0_MODULE_VERSION  51
37
+#define NODE_8_0_MODULE_VERSION  57
38
+#define NODE_9_0_MODULE_VERSION  59
39
+#define NODE_10_0_MODULE_VERSION 64
40
+#define NODE_11_0_MODULE_VERSION 67
41
+#define NODE_12_0_MODULE_VERSION 72
42
+#define NODE_13_0_MODULE_VERSION 79
43
+#define NODE_14_0_MODULE_VERSION 83
44
+#define NODE_15_0_MODULE_VERSION 88
45
+#define NODE_16_0_MODULE_VERSION 93
46
+
47
+#ifdef _MSC_VER
48
+# define NAN_HAS_CPLUSPLUS_11 (_MSC_VER >= 1800)
49
+#else
50
+# define NAN_HAS_CPLUSPLUS_11 (__cplusplus >= 201103L)
51
+#endif
52
+
53
+#if NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION && !NAN_HAS_CPLUSPLUS_11
54
+# error This version of node/NAN/v8 requires a C++11 compiler
55
+#endif
56
+
57
+#include <uv.h>
58
+#include <node.h>
59
+#include <node_buffer.h>
60
+#include <node_object_wrap.h>
61
+#include <algorithm>
62
+#include <cstring>
63
+#include <climits>
64
+#include <cstdlib>
65
+#include <utility>
66
+#if defined(_MSC_VER)
67
+# pragma warning( push )
68
+# pragma warning( disable : 4530 )
69
+# include <queue>
70
+# include <string>
71
+# include <vector>
72
+# pragma warning( pop )
73
+#else
74
+# include <queue>
75
+# include <string>
76
+# include <vector>
77
+#endif
78
+
79
+// uv helpers
80
+#ifdef UV_VERSION_MAJOR
81
+# ifndef UV_VERSION_PATCH
82
+#  define UV_VERSION_PATCH 0
83
+# endif
84
+# define NAUV_UVVERSION ((UV_VERSION_MAJOR << 16) | \
85
+                         (UV_VERSION_MINOR <<  8) | \
86
+                         (UV_VERSION_PATCH))
87
+#else
88
+# define NAUV_UVVERSION 0x000b00
89
+#endif
90
+
91
+#if NAUV_UVVERSION < 0x000b0b
92
+# ifdef WIN32
93
+#  include <windows.h>
94
+# else
95
+#  include <pthread.h>
96
+# endif
97
+#endif
98
+
99
+namespace Nan {
100
+
101
+#define NAN_CONCAT(a, b) NAN_CONCAT_HELPER(a, b)
102
+#define NAN_CONCAT_HELPER(a, b) a##b
103
+
104
+#define NAN_INLINE inline  // TODO(bnoordhuis) Remove in v3.0.0.
105
+
106
+#if defined(__GNUC__) && \
107
+    !(defined(V8_DISABLE_DEPRECATIONS) && V8_DISABLE_DEPRECATIONS)
108
+# define NAN_DEPRECATED __attribute__((deprecated))
109
+#elif defined(_MSC_VER) && \
110
+    !(defined(V8_DISABLE_DEPRECATIONS) && V8_DISABLE_DEPRECATIONS)
111
+# define NAN_DEPRECATED __declspec(deprecated)
112
+#else
113
+# define NAN_DEPRECATED
114
+#endif
115
+
116
+#if NAN_HAS_CPLUSPLUS_11
117
+# define NAN_DISALLOW_ASSIGN(CLASS) void operator=(const CLASS&) = delete;
118
+# define NAN_DISALLOW_COPY(CLASS) CLASS(const CLASS&) = delete;
119
+# define NAN_DISALLOW_MOVE(CLASS)                                              \
120
+    CLASS(CLASS&&) = delete;  /* NOLINT(build/c++11) */                        \
121
+    void operator=(CLASS&&) = delete;
122
+#else
123
+# define NAN_DISALLOW_ASSIGN(CLASS) void operator=(const CLASS&);
124
+# define NAN_DISALLOW_COPY(CLASS) CLASS(const CLASS&);
125
+# define NAN_DISALLOW_MOVE(CLASS)
126
+#endif
127
+
128
+#define NAN_DISALLOW_ASSIGN_COPY(CLASS)                                        \
129
+    NAN_DISALLOW_ASSIGN(CLASS)                                                 \
130
+    NAN_DISALLOW_COPY(CLASS)
131
+
132
+#define NAN_DISALLOW_ASSIGN_MOVE(CLASS)                                        \
133
+    NAN_DISALLOW_ASSIGN(CLASS)                                                 \
134
+    NAN_DISALLOW_MOVE(CLASS)
135
+
136
+#define NAN_DISALLOW_COPY_MOVE(CLASS)                                          \
137
+    NAN_DISALLOW_COPY(CLASS)                                                   \
138
+    NAN_DISALLOW_MOVE(CLASS)
139
+
140
+#define NAN_DISALLOW_ASSIGN_COPY_MOVE(CLASS)                                   \
141
+    NAN_DISALLOW_ASSIGN(CLASS)                                                 \
142
+    NAN_DISALLOW_COPY(CLASS)                                                   \
143
+    NAN_DISALLOW_MOVE(CLASS)
144
+
145
+#define TYPE_CHECK(T, S)                                                       \
146
+    while (false) {                                                            \
147
+      *(static_cast<T *volatile *>(0)) = static_cast<S*>(0);                   \
148
+    }
149
+
150
+//=== RegistrationFunction =====================================================
151
+
152
+#if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
153
+  typedef v8::Handle<v8::Object> ADDON_REGISTER_FUNCTION_ARGS_TYPE;
154
+#else
155
+  typedef v8::Local<v8::Object> ADDON_REGISTER_FUNCTION_ARGS_TYPE;
156
+#endif
157
+
158
+#define NAN_MODULE_INIT(name)                                                  \
159
+    void name(Nan::ADDON_REGISTER_FUNCTION_ARGS_TYPE target)
160
+
161
+#if NODE_MAJOR_VERSION >= 10 || \
162
+    NODE_MAJOR_VERSION == 9 && NODE_MINOR_VERSION >= 3
163
+#define NAN_MODULE_WORKER_ENABLED(module_name, registration)                   \
164
+    extern "C" NODE_MODULE_EXPORT void                                         \
165
+      NAN_CONCAT(node_register_module_v, NODE_MODULE_VERSION)(                 \
166
+        v8::Local<v8::Object> exports, v8::Local<v8::Value> module,            \
167
+        v8::Local<v8::Context> context)                                        \
168
+    {                                                                          \
169
+        registration(exports);                                                 \
170
+    }
171
+#else
172
+#define NAN_MODULE_WORKER_ENABLED(module_name, registration)                   \
173
+    NODE_MODULE(module_name, registration)
174
+#endif
175
+
176
+//=== CallbackInfo =============================================================
177
+
178
+#include "nan_callbacks.h"  // NOLINT(build/include)
179
+
180
+//==============================================================================
181
+
182
+#if (NODE_MODULE_VERSION < NODE_0_12_MODULE_VERSION)
183
+typedef v8::Script             UnboundScript;
184
+typedef v8::Script             BoundScript;
185
+#else
186
+typedef v8::UnboundScript      UnboundScript;
187
+typedef v8::Script             BoundScript;
188
+#endif
189
+
190
+#if (NODE_MODULE_VERSION < ATOM_0_21_MODULE_VERSION)
191
+typedef v8::String::ExternalAsciiStringResource
192
+    ExternalOneByteStringResource;
193
+#else
194
+typedef v8::String::ExternalOneByteStringResource
195
+    ExternalOneByteStringResource;
196
+#endif
197
+
198
+#if (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)
199
+template<typename T>
200
+class NonCopyablePersistentTraits :
201
+    public v8::NonCopyablePersistentTraits<T> {};
202
+template<typename T>
203
+class CopyablePersistentTraits :
204
+    public v8::CopyablePersistentTraits<T> {};
205
+
206
+template<typename T>
207
+class PersistentBase :
208
+    public v8::PersistentBase<T> {};
209
+
210
+template<typename T, typename M = v8::NonCopyablePersistentTraits<T> >
211
+class Persistent;
212
+#else
213
+template<typename T> class NonCopyablePersistentTraits;
214
+template<typename T> class PersistentBase;
215
+template<typename T, typename P> class WeakCallbackData;
216
+template<typename T, typename M = NonCopyablePersistentTraits<T> >
217
+class Persistent;
218
+#endif  // NODE_MODULE_VERSION
219
+
220
+template<typename T>
221
+class Maybe {
222
+ public:
223
+  inline bool IsNothing() const { return !has_value_; }
224
+  inline bool IsJust() const { return has_value_; }
225
+
226
+  inline T ToChecked() const { return FromJust(); }
227
+  inline void Check() const { FromJust(); }
228
+
229
+  inline bool To(T* out) const {
230
+    if (IsJust()) *out = value_;
231
+    return IsJust();
232
+  }
233
+
234
+  inline T FromJust() const {
235
+#if defined(V8_ENABLE_CHECKS)
236
+    assert(IsJust() && "FromJust is Nothing");
237
+#endif  // V8_ENABLE_CHECKS
238
+    return value_;
239
+  }
240
+
241
+  inline T FromMaybe(const T& default_value) const {
242
+    return has_value_ ? value_ : default_value;
243
+  }
244
+
245
+  inline bool operator==(const Maybe &other) const {
246
+    return (IsJust() == other.IsJust()) &&
247
+        (!IsJust() || FromJust() == other.FromJust());
248
+  }
249
+
250
+  inline bool operator!=(const Maybe &other) const {
251
+    return !operator==(other);
252
+  }
253
+
254
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
255
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
256
+  // Allow implicit conversions from v8::Maybe<T> to Nan::Maybe<T>.
257
+  Maybe(const v8::Maybe<T>& that)  // NOLINT(runtime/explicit)
258
+    : has_value_(that.IsJust())
259
+    , value_(that.FromMaybe(T())) {}
260
+#endif
261
+
262
+ private:
263
+  Maybe() : has_value_(false) {}
264
+  explicit Maybe(const T& t) : has_value_(true), value_(t) {}
265
+  bool has_value_;
266
+  T value_;
267
+
268
+  template<typename U>
269
+  friend Maybe<U> Nothing();
270
+  template<typename U>
271
+  friend Maybe<U> Just(const U& u);
272
+};
273
+
274
+template<typename T>
275
+inline Maybe<T> Nothing() {
276
+  return Maybe<T>();
277
+}
278
+
279
+template<typename T>
280
+inline Maybe<T> Just(const T& t) {
281
+  return Maybe<T>(t);
282
+}
283
+
284
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
285
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
286
+# include "nan_maybe_43_inl.h"  // NOLINT(build/include)
287
+#else
288
+# include "nan_maybe_pre_43_inl.h"  // NOLINT(build/include)
289
+#endif
290
+
291
+#include "nan_converters.h"  // NOLINT(build/include)
292
+#include "nan_new.h"  // NOLINT(build/include)
293
+
294
+#if NAUV_UVVERSION < 0x000b17
295
+#define NAUV_WORK_CB(func) \
296
+    void func(uv_async_t *async, int)
297
+#else
298
+#define NAUV_WORK_CB(func) \
299
+    void func(uv_async_t *async)
300
+#endif
301
+
302
+#if NAUV_UVVERSION >= 0x000b0b
303
+
304
+typedef uv_key_t nauv_key_t;
305
+
306
+inline int nauv_key_create(nauv_key_t *key) {
307
+  return uv_key_create(key);
308
+}
309
+
310
+inline void nauv_key_delete(nauv_key_t *key) {
311
+  uv_key_delete(key);
312
+}
313
+
314
+inline void* nauv_key_get(nauv_key_t *key) {
315
+  return uv_key_get(key);
316
+}
317
+
318
+inline void nauv_key_set(nauv_key_t *key, void *value) {
319
+  uv_key_set(key, value);
320
+}
321
+
322
+#else
323
+
324
+/* Implement thread local storage for older versions of libuv.
325
+ * This is essentially a backport of libuv commit 5d2434bf
326
+ * written by Ben Noordhuis, adjusted for names and inline.
327
+ */
328
+
329
+#ifndef WIN32
330
+
331
+typedef pthread_key_t nauv_key_t;
332
+
333
+inline int nauv_key_create(nauv_key_t* key) {
334
+  return -pthread_key_create(key, NULL);
335
+}
336
+
337
+inline void nauv_key_delete(nauv_key_t* key) {
338
+  if (pthread_key_delete(*key))
339
+    abort();
340
+}
341
+
342
+inline void* nauv_key_get(nauv_key_t* key) {
343
+  return pthread_getspecific(*key);
344
+}
345
+
346
+inline void nauv_key_set(nauv_key_t* key, void* value) {
347
+  if (pthread_setspecific(*key, value))
348
+    abort();
349
+}
350
+
351
+#else
352
+
353
+typedef struct {
354
+  DWORD tls_index;
355
+} nauv_key_t;
356
+
357
+inline int nauv_key_create(nauv_key_t* key) {
358
+  key->tls_index = TlsAlloc();
359
+  if (key->tls_index == TLS_OUT_OF_INDEXES)
360
+    return UV_ENOMEM;
361
+  return 0;
362
+}
363
+
364
+inline void nauv_key_delete(nauv_key_t* key) {
365
+  if (TlsFree(key->tls_index) == FALSE)
366
+    abort();
367
+  key->tls_index = TLS_OUT_OF_INDEXES;
368
+}
369
+
370
+inline void* nauv_key_get(nauv_key_t* key) {
371
+  void* value = TlsGetValue(key->tls_index);
372
+  if (value == NULL)
373
+    if (GetLastError() != ERROR_SUCCESS)
374
+      abort();
375
+  return value;
376
+}
377
+
378
+inline void nauv_key_set(nauv_key_t* key, void* value) {
379
+  if (TlsSetValue(key->tls_index, value) == FALSE)
380
+    abort();
381
+}
382
+
383
+#endif
384
+#endif
385
+
386
+#if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
387
+template<typename T>
388
+v8::Local<T> New(v8::Handle<T>);
389
+#endif
390
+
391
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
392
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
393
+  typedef v8::WeakCallbackType WeakCallbackType;
394
+#else
395
+struct WeakCallbackType {
396
+  enum E {kParameter, kInternalFields};
397
+  E type;
398
+  WeakCallbackType(E other) : type(other) {}  // NOLINT(runtime/explicit)
399
+  inline bool operator==(E other) { return other == this->type; }
400
+  inline bool operator!=(E other) { return !operator==(other); }
401
+};
402
+#endif
403
+
404
+template<typename P> class WeakCallbackInfo;
405
+
406
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
407
+# include "nan_persistent_12_inl.h"  // NOLINT(build/include)
408
+#else
409
+# include "nan_persistent_pre_12_inl.h"  // NOLINT(build/include)
410
+#endif
411
+
412
+namespace imp {
413
+  static const size_t kMaxLength = 0x3fffffff;
414
+  // v8::String::REPLACE_INVALID_UTF8 was introduced
415
+  // in node.js v0.10.29 and v0.8.27.
416
+#if NODE_MAJOR_VERSION > 0 || \
417
+    NODE_MINOR_VERSION > 10 || \
418
+    NODE_MINOR_VERSION == 10 && NODE_PATCH_VERSION >= 29 || \
419
+    NODE_MINOR_VERSION == 8 && NODE_PATCH_VERSION >= 27
420
+  static const unsigned kReplaceInvalidUtf8 = v8::String::REPLACE_INVALID_UTF8;
421
+#else
422
+  static const unsigned kReplaceInvalidUtf8 = 0;
423
+#endif
424
+}  // end of namespace imp
425
+
426
+//=== HandleScope ==============================================================
427
+
428
+class HandleScope {
429
+  v8::HandleScope scope;
430
+
431
+ public:
432
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
433
+  inline HandleScope() : scope(v8::Isolate::GetCurrent()) {}
434
+  inline static int NumberOfHandles() {
435
+    return v8::HandleScope::NumberOfHandles(v8::Isolate::GetCurrent());
436
+  }
437
+#else
438
+  inline HandleScope() : scope() {}
439
+  inline static int NumberOfHandles() {
440
+    return v8::HandleScope::NumberOfHandles();
441
+  }
442
+#endif
443
+
444
+ private:
445
+  // Make it hard to create heap-allocated or illegal handle scopes by
446
+  // disallowing certain operations.
447
+  HandleScope(const HandleScope &);
448
+  void operator=(const HandleScope &);
449
+  void *operator new(size_t size);
450
+  void operator delete(void *, size_t) {
451
+    abort();
452
+  }
453
+};
454
+
455
+class EscapableHandleScope {
456
+ public:
457
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
458
+  inline EscapableHandleScope() : scope(v8::Isolate::GetCurrent()) {}
459
+
460
+  inline static int NumberOfHandles() {
461
+    return v8::EscapableHandleScope::NumberOfHandles(v8::Isolate::GetCurrent());
462
+  }
463
+
464
+  template<typename T>
465
+  inline v8::Local<T> Escape(v8::Local<T> value) {
466
+    return scope.Escape(value);
467
+  }
468
+
469
+ private:
470
+  v8::EscapableHandleScope scope;
471
+#else
472
+  inline EscapableHandleScope() : scope() {}
473
+
474
+  inline static int NumberOfHandles() {
475
+    return v8::HandleScope::NumberOfHandles();
476
+  }
477
+
478
+  template<typename T>
479
+  inline v8::Local<T> Escape(v8::Local<T> value) {
480
+    return scope.Close(value);
481
+  }
482
+
483
+ private:
484
+  v8::HandleScope scope;
485
+#endif
486
+
487
+ private:
488
+  // Make it hard to create heap-allocated or illegal handle scopes by
489
+  // disallowing certain operations.
490
+  EscapableHandleScope(const EscapableHandleScope &);
491
+  void operator=(const EscapableHandleScope &);
492
+  void *operator new(size_t size);
493
+  void operator delete(void *, size_t) {
494
+    abort();
495
+  }
496
+};
497
+
498
+//=== TryCatch =================================================================
499
+
500
+class TryCatch {
501
+  v8::TryCatch try_catch_;
502
+  friend void FatalException(const TryCatch&);
503
+
504
+ public:
505
+#if NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
506
+  TryCatch() : try_catch_(v8::Isolate::GetCurrent()) {}
507
+#endif
508
+
509
+  inline bool HasCaught() const { return try_catch_.HasCaught(); }
510
+
511
+  inline bool CanContinue() const { return try_catch_.CanContinue(); }
512
+
513
+  inline v8::Local<v8::Value> ReThrow() {
514
+#if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
515
+    return New(try_catch_.ReThrow());
516
+#else
517
+    return try_catch_.ReThrow();
518
+#endif
519
+  }
520
+
521
+  inline v8::Local<v8::Value> Exception() const {
522
+    return try_catch_.Exception();
523
+  }
524
+
525
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
526
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
527
+  inline v8::MaybeLocal<v8::Value> StackTrace() const {
528
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
529
+    v8::EscapableHandleScope scope(isolate);
530
+    return scope.Escape(try_catch_.StackTrace(isolate->GetCurrentContext())
531
+                            .FromMaybe(v8::Local<v8::Value>()));
532
+  }
533
+#else
534
+  inline MaybeLocal<v8::Value> StackTrace() const {
535
+    return try_catch_.StackTrace();
536
+  }
537
+#endif
538
+
539
+  inline v8::Local<v8::Message> Message() const {
540
+    return try_catch_.Message();
541
+  }
542
+
543
+  inline void Reset() { try_catch_.Reset(); }
544
+
545
+  inline void SetVerbose(bool value) { try_catch_.SetVerbose(value); }
546
+
547
+  inline void SetCaptureMessage(bool value) {
548
+    try_catch_.SetCaptureMessage(value);
549
+  }
550
+};
551
+
552
+v8::Local<v8::Value> MakeCallback(v8::Local<v8::Object> target,
553
+                                  v8::Local<v8::Function> func,
554
+                                  int argc,
555
+                                  v8::Local<v8::Value>* argv);
556
+v8::Local<v8::Value> MakeCallback(v8::Local<v8::Object> target,
557
+                                  v8::Local<v8::String> symbol,
558
+                                  int argc,
559
+                                  v8::Local<v8::Value>* argv);
560
+v8::Local<v8::Value> MakeCallback(v8::Local<v8::Object> target,
561
+                                  const char* method,
562
+                                  int argc,
563
+                                  v8::Local<v8::Value>* argv);
564
+
565
+// === AsyncResource ===========================================================
566
+
567
+class AsyncResource {
568
+ public:
569
+  AsyncResource(
570
+      v8::Local<v8::String> name
571
+    , v8::Local<v8::Object> resource = New<v8::Object>()) {
572
+#if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
573
+    v8::Isolate* isolate = v8::Isolate::GetCurrent();
574
+
575
+    if (resource.IsEmpty()) {
576
+      resource = New<v8::Object>();
577
+    }
578
+
579
+    context = node::EmitAsyncInit(isolate, resource, name);
580
+#endif
581
+  }
582
+
583
+  AsyncResource(
584
+      const char* name
585
+    , v8::Local<v8::Object> resource = New<v8::Object>()) {
586
+#if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
587
+    v8::Isolate* isolate = v8::Isolate::GetCurrent();
588
+
589
+    if (resource.IsEmpty()) {
590
+      resource = New<v8::Object>();
591
+    }
592
+
593
+    v8::Local<v8::String> name_string =
594
+        New<v8::String>(name).ToLocalChecked();
595
+    context = node::EmitAsyncInit(isolate, resource, name_string);
596
+#endif
597
+  }
598
+
599
+  ~AsyncResource() {
600
+#if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
601
+    v8::Isolate* isolate = v8::Isolate::GetCurrent();
602
+    node::EmitAsyncDestroy(isolate, context);
603
+#endif
604
+  }
605
+
606
+  inline MaybeLocal<v8::Value> runInAsyncScope(
607
+      v8::Local<v8::Object> target
608
+    , v8::Local<v8::Function> func
609
+    , int argc
610
+    , v8::Local<v8::Value>* argv) {
611
+#if NODE_MODULE_VERSION < NODE_9_0_MODULE_VERSION
612
+    return MakeCallback(target, func, argc, argv);
613
+#else
614
+    return node::MakeCallback(
615
+        v8::Isolate::GetCurrent(), target, func, argc, argv, context);
616
+#endif
617
+  }
618
+
619
+  inline MaybeLocal<v8::Value> runInAsyncScope(
620
+      v8::Local<v8::Object> target
621
+    , v8::Local<v8::String> symbol
622
+    , int argc
623
+    , v8::Local<v8::Value>* argv) {
624
+#if NODE_MODULE_VERSION < NODE_9_0_MODULE_VERSION
625
+    return MakeCallback(target, symbol, argc, argv);
626
+#else
627
+    return node::MakeCallback(
628
+        v8::Isolate::GetCurrent(), target, symbol, argc, argv, context);
629
+#endif
630
+  }
631
+
632
+  inline MaybeLocal<v8::Value> runInAsyncScope(
633
+      v8::Local<v8::Object> target
634
+    , const char* method
635
+    , int argc
636
+    , v8::Local<v8::Value>* argv) {
637
+#if NODE_MODULE_VERSION < NODE_9_0_MODULE_VERSION
638
+    return MakeCallback(target, method, argc, argv);
639
+#else
640
+    return node::MakeCallback(
641
+        v8::Isolate::GetCurrent(), target, method, argc, argv, context);
642
+#endif
643
+  }
644
+
645
+ private:
646
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(AsyncResource)
647
+#if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
648
+  node::async_context context;
649
+#endif
650
+};
651
+
652
+inline uv_loop_t* GetCurrentEventLoop() {
653
+#if NODE_MAJOR_VERSION >= 10 || \
654
+  NODE_MAJOR_VERSION == 9 && NODE_MINOR_VERSION >= 3 || \
655
+  NODE_MAJOR_VERSION == 8 && NODE_MINOR_VERSION >= 10
656
+    return node::GetCurrentEventLoop(v8::Isolate::GetCurrent());
657
+#else
658
+    return uv_default_loop();
659
+#endif
660
+}
661
+
662
+//============ =================================================================
663
+
664
+/* node 0.12  */
665
+#if NODE_MODULE_VERSION >= NODE_0_12_MODULE_VERSION
666
+  inline
667
+  void SetCounterFunction(v8::CounterLookupCallback cb) {
668
+    v8::Isolate::GetCurrent()->SetCounterFunction(cb);
669
+  }
670
+
671
+  inline
672
+  void SetCreateHistogramFunction(v8::CreateHistogramCallback cb) {
673
+    v8::Isolate::GetCurrent()->SetCreateHistogramFunction(cb);
674
+  }
675
+
676
+  inline
677
+  void SetAddHistogramSampleFunction(v8::AddHistogramSampleCallback cb) {
678
+    v8::Isolate::GetCurrent()->SetAddHistogramSampleFunction(cb);
679
+  }
680
+
681
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
682
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
683
+  inline bool IdleNotification(int idle_time_in_ms) {
684
+    return v8::Isolate::GetCurrent()->IdleNotificationDeadline(
685
+        idle_time_in_ms * 0.001);
686
+  }
687
+# else
688
+  inline bool IdleNotification(int idle_time_in_ms) {
689
+    return v8::Isolate::GetCurrent()->IdleNotification(idle_time_in_ms);
690
+  }
691
+#endif
692
+
693
+  inline void LowMemoryNotification() {
694
+    v8::Isolate::GetCurrent()->LowMemoryNotification();
695
+  }
696
+
697
+  inline void ContextDisposedNotification() {
698
+    v8::Isolate::GetCurrent()->ContextDisposedNotification();
699
+  }
700
+#else
701
+  inline
702
+  void SetCounterFunction(v8::CounterLookupCallback cb) {
703
+    v8::V8::SetCounterFunction(cb);
704
+  }
705
+
706
+  inline
707
+  void SetCreateHistogramFunction(v8::CreateHistogramCallback cb) {
708
+    v8::V8::SetCreateHistogramFunction(cb);
709
+  }
710
+
711
+  inline
712
+  void SetAddHistogramSampleFunction(v8::AddHistogramSampleCallback cb) {
713
+    v8::V8::SetAddHistogramSampleFunction(cb);
714
+  }
715
+
716
+  inline bool IdleNotification(int idle_time_in_ms) {
717
+    return v8::V8::IdleNotification(idle_time_in_ms);
718
+  }
719
+
720
+  inline void LowMemoryNotification() {
721
+    v8::V8::LowMemoryNotification();
722
+  }
723
+
724
+  inline void ContextDisposedNotification() {
725
+    v8::V8::ContextDisposedNotification();
726
+  }
727
+#endif
728
+
729
+#if (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)  // Node 0.12
730
+  inline v8::Local<v8::Primitive> Undefined() {
731
+# if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
732
+    EscapableHandleScope scope;
733
+    return scope.Escape(New(v8::Undefined(v8::Isolate::GetCurrent())));
734
+# else
735
+    return v8::Undefined(v8::Isolate::GetCurrent());
736
+# endif
737
+  }
738
+
739
+  inline v8::Local<v8::Primitive> Null() {
740
+# if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
741
+    EscapableHandleScope scope;
742
+    return scope.Escape(New(v8::Null(v8::Isolate::GetCurrent())));
743
+# else
744
+    return v8::Null(v8::Isolate::GetCurrent());
745
+# endif
746
+  }
747
+
748
+  inline v8::Local<v8::Boolean> True() {
749
+# if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
750
+    EscapableHandleScope scope;
751
+    return scope.Escape(New(v8::True(v8::Isolate::GetCurrent())));
752
+# else
753
+    return v8::True(v8::Isolate::GetCurrent());
754
+# endif
755
+  }
756
+
757
+  inline v8::Local<v8::Boolean> False() {
758
+# if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
759
+    EscapableHandleScope scope;
760
+    return scope.Escape(New(v8::False(v8::Isolate::GetCurrent())));
761
+# else
762
+    return v8::False(v8::Isolate::GetCurrent());
763
+# endif
764
+  }
765
+
766
+  inline v8::Local<v8::String> EmptyString() {
767
+    return v8::String::Empty(v8::Isolate::GetCurrent());
768
+  }
769
+
770
+  inline int AdjustExternalMemory(int bc) {
771
+    return static_cast<int>(
772
+        v8::Isolate::GetCurrent()->AdjustAmountOfExternalAllocatedMemory(bc));
773
+  }
774
+
775
+  inline void SetTemplate(
776
+      v8::Local<v8::Template> templ
777
+    , const char *name
778
+    , v8::Local<v8::Data> value) {
779
+    templ->Set(v8::Isolate::GetCurrent(), name, value);
780
+  }
781
+
782
+  inline void SetTemplate(
783
+      v8::Local<v8::Template> templ
784
+    , v8::Local<v8::String> name
785
+    , v8::Local<v8::Data> value
786
+    , v8::PropertyAttribute attributes) {
787
+    templ->Set(name, value, attributes);
788
+  }
789
+
790
+  inline v8::Local<v8::Context> GetCurrentContext() {
791
+    return v8::Isolate::GetCurrent()->GetCurrentContext();
792
+  }
793
+
794
+  inline void* GetInternalFieldPointer(
795
+      v8::Local<v8::Object> object
796
+    , int index) {
797
+    return object->GetAlignedPointerFromInternalField(index);
798
+  }
799
+
800
+  inline void SetInternalFieldPointer(
801
+      v8::Local<v8::Object> object
802
+    , int index
803
+    , void* value) {
804
+    object->SetAlignedPointerInInternalField(index, value);
805
+  }
806
+
807
+# define NAN_GC_CALLBACK(name)                                                 \
808
+    void name(v8::Isolate *isolate, v8::GCType type, v8::GCCallbackFlags flags)
809
+
810
+#if NODE_MODULE_VERSION <= NODE_4_0_MODULE_VERSION
811
+  typedef v8::Isolate::GCEpilogueCallback GCEpilogueCallback;
812
+  typedef v8::Isolate::GCPrologueCallback GCPrologueCallback;
813
+#else
814
+  typedef v8::Isolate::GCCallback GCEpilogueCallback;
815
+  typedef v8::Isolate::GCCallback GCPrologueCallback;
816
+#endif
817
+
818
+  inline void AddGCEpilogueCallback(
819
+      GCEpilogueCallback callback
820
+    , v8::GCType gc_type_filter = v8::kGCTypeAll) {
821
+    v8::Isolate::GetCurrent()->AddGCEpilogueCallback(callback, gc_type_filter);
822
+  }
823
+
824
+  inline void RemoveGCEpilogueCallback(
825
+      GCEpilogueCallback callback) {
826
+    v8::Isolate::GetCurrent()->RemoveGCEpilogueCallback(callback);
827
+  }
828
+
829
+  inline void AddGCPrologueCallback(
830
+      GCPrologueCallback callback
831
+    , v8::GCType gc_type_filter = v8::kGCTypeAll) {
832
+    v8::Isolate::GetCurrent()->AddGCPrologueCallback(callback, gc_type_filter);
833
+  }
834
+
835
+  inline void RemoveGCPrologueCallback(
836
+      GCPrologueCallback callback) {
837
+    v8::Isolate::GetCurrent()->RemoveGCPrologueCallback(callback);
838
+  }
839
+
840
+  inline void GetHeapStatistics(
841
+      v8::HeapStatistics *heap_statistics) {
842
+    v8::Isolate::GetCurrent()->GetHeapStatistics(heap_statistics);
843
+  }
844
+
845
+# define X(NAME)                                                               \
846
+    inline v8::Local<v8::Value> NAME(const char *msg) {                        \
847
+      EscapableHandleScope scope;                                              \
848
+      return scope.Escape(v8::Exception::NAME(New(msg).ToLocalChecked()));     \
849
+    }                                                                          \
850
+                                                                               \
851
+    inline                                                                     \
852
+    v8::Local<v8::Value> NAME(v8::Local<v8::String> msg) {                     \
853
+      return v8::Exception::NAME(msg);                                         \
854
+    }                                                                          \
855
+                                                                               \
856
+    inline void Throw ## NAME(const char *msg) {                               \
857
+      HandleScope scope;                                                       \
858
+      v8::Isolate::GetCurrent()->ThrowException(                               \
859
+          v8::Exception::NAME(New(msg).ToLocalChecked()));                     \
860
+    }                                                                          \
861
+                                                                               \
862
+    inline void Throw ## NAME(v8::Local<v8::String> msg) {                     \
863
+      HandleScope scope;                                                       \
864
+      v8::Isolate::GetCurrent()->ThrowException(                               \
865
+          v8::Exception::NAME(msg));                                           \
866
+    }
867
+
868
+  X(Error)
869
+  X(RangeError)
870
+  X(ReferenceError)
871
+  X(SyntaxError)
872
+  X(TypeError)
873
+
874
+# undef X
875
+
876
+  inline void ThrowError(v8::Local<v8::Value> error) {
877
+    v8::Isolate::GetCurrent()->ThrowException(error);
878
+  }
879
+
880
+  inline MaybeLocal<v8::Object> NewBuffer(
881
+      char *data
882
+    , size_t length
883
+#if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
884
+    , node::Buffer::FreeCallback callback
885
+#else
886
+    , node::smalloc::FreeCallback callback
887
+#endif
888
+    , void *hint
889
+  ) {
890
+    // arbitrary buffer lengths requires
891
+    // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
892
+    assert(length <= imp::kMaxLength && "too large buffer");
893
+#if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
894
+    return node::Buffer::New(
895
+        v8::Isolate::GetCurrent(), data, length, callback, hint);
896
+#else
897
+    return node::Buffer::New(v8::Isolate::GetCurrent(), data, length, callback,
898
+                             hint);
899
+#endif
900
+  }
901
+
902
+  inline MaybeLocal<v8::Object> CopyBuffer(
903
+      const char *data
904
+    , uint32_t size
905
+  ) {
906
+    // arbitrary buffer lengths requires
907
+    // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
908
+    assert(size <= imp::kMaxLength && "too large buffer");
909
+#if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
910
+    return node::Buffer::Copy(
911
+        v8::Isolate::GetCurrent(), data, size);
912
+#else
913
+    return node::Buffer::New(v8::Isolate::GetCurrent(), data, size);
914
+#endif
915
+  }
916
+
917
+  inline MaybeLocal<v8::Object> NewBuffer(uint32_t size) {
918
+    // arbitrary buffer lengths requires
919
+    // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
920
+    assert(size <= imp::kMaxLength && "too large buffer");
921
+#if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
922
+    return node::Buffer::New(
923
+        v8::Isolate::GetCurrent(), size);
924
+#else
925
+    return node::Buffer::New(v8::Isolate::GetCurrent(), size);
926
+#endif
927
+  }
928
+
929
+  inline MaybeLocal<v8::Object> NewBuffer(
930
+      char* data
931
+    , uint32_t size
932
+  ) {
933
+    // arbitrary buffer lengths requires
934
+    // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
935
+    assert(size <= imp::kMaxLength && "too large buffer");
936
+#if NODE_MODULE_VERSION > IOJS_2_0_MODULE_VERSION
937
+    return node::Buffer::New(v8::Isolate::GetCurrent(), data, size);
938
+#else
939
+    return node::Buffer::Use(v8::Isolate::GetCurrent(), data, size);
940
+#endif
941
+  }
942
+
943
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
944
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
945
+  inline MaybeLocal<v8::String>
946
+  NewOneByteString(const uint8_t * value, int length = -1) {
947
+    return v8::String::NewFromOneByte(v8::Isolate::GetCurrent(), value,
948
+          v8::NewStringType::kNormal, length);
949
+  }
950
+
951
+  inline MaybeLocal<BoundScript> CompileScript(
952
+      v8::Local<v8::String> s
953
+    , const v8::ScriptOrigin& origin
954
+  ) {
955
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
956
+    v8::EscapableHandleScope scope(isolate);
957
+    v8::ScriptCompiler::Source source(s, origin);
958
+    return scope.Escape(
959
+        v8::ScriptCompiler::Compile(isolate->GetCurrentContext(), &source)
960
+            .FromMaybe(v8::Local<BoundScript>()));
961
+  }
962
+
963
+  inline MaybeLocal<BoundScript> CompileScript(
964
+      v8::Local<v8::String> s
965
+  ) {
966
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
967
+    v8::EscapableHandleScope scope(isolate);
968
+    v8::ScriptCompiler::Source source(s);
969
+    return scope.Escape(
970
+        v8::ScriptCompiler::Compile(isolate->GetCurrentContext(), &source)
971
+            .FromMaybe(v8::Local<BoundScript>()));
972
+  }
973
+
974
+  inline MaybeLocal<v8::Value> RunScript(
975
+      v8::Local<UnboundScript> script
976
+  ) {
977
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
978
+    v8::EscapableHandleScope scope(isolate);
979
+    return scope.Escape(script->BindToCurrentContext()
980
+                            ->Run(isolate->GetCurrentContext())
981
+                            .FromMaybe(v8::Local<v8::Value>()));
982
+  }
983
+
984
+  inline MaybeLocal<v8::Value> RunScript(
985
+      v8::Local<BoundScript> script
986
+  ) {
987
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
988
+    v8::EscapableHandleScope scope(isolate);
989
+    return scope.Escape(script->Run(isolate->GetCurrentContext())
990
+                            .FromMaybe(v8::Local<v8::Value>()));
991
+  }
992
+#else
993
+  inline MaybeLocal<v8::String>
994
+  NewOneByteString(const uint8_t * value, int length = -1) {
995
+    return v8::String::NewFromOneByte(v8::Isolate::GetCurrent(), value,
996
+                                      v8::String::kNormalString, length);
997
+  }
998
+
999
+  inline MaybeLocal<BoundScript> CompileScript(
1000
+      v8::Local<v8::String> s
1001
+    , const v8::ScriptOrigin& origin
1002
+  ) {
1003
+    v8::ScriptCompiler::Source source(s, origin);
1004
+    return v8::ScriptCompiler::Compile(v8::Isolate::GetCurrent(), &source);
1005
+  }
1006
+
1007
+  inline MaybeLocal<BoundScript> CompileScript(
1008
+      v8::Local<v8::String> s
1009
+  ) {
1010
+    v8::ScriptCompiler::Source source(s);
1011
+    return v8::ScriptCompiler::Compile(v8::Isolate::GetCurrent(), &source);
1012
+  }
1013
+
1014
+  inline MaybeLocal<v8::Value> RunScript(
1015
+      v8::Local<UnboundScript> script
1016
+  ) {
1017
+    EscapableHandleScope scope;
1018
+    return scope.Escape(script->BindToCurrentContext()->Run());
1019
+  }
1020
+
1021
+  inline MaybeLocal<v8::Value> RunScript(
1022
+      v8::Local<BoundScript> script
1023
+  ) {
1024
+    return script->Run();
1025
+  }
1026
+#endif
1027
+
1028
+  NAN_DEPRECATED inline v8::Local<v8::Value> MakeCallback(
1029
+      v8::Local<v8::Object> target
1030
+    , v8::Local<v8::Function> func
1031
+    , int argc
1032
+    , v8::Local<v8::Value>* argv) {
1033
+#if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
1034
+    EscapableHandleScope scope;
1035
+    return scope.Escape(New(node::MakeCallback(
1036
+        v8::Isolate::GetCurrent(), target, func, argc, argv)));
1037
+#else
1038
+# if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1039
+    AsyncResource res("nan:makeCallback");
1040
+    return res.runInAsyncScope(target, func, argc, argv)
1041
+        .FromMaybe(v8::Local<v8::Value>());
1042
+# else
1043
+    return node::MakeCallback(
1044
+        v8::Isolate::GetCurrent(), target, func, argc, argv);
1045
+# endif  // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1046
+#endif  // NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
1047
+  }
1048
+
1049
+  NAN_DEPRECATED inline v8::Local<v8::Value> MakeCallback(
1050
+      v8::Local<v8::Object> target
1051
+    , v8::Local<v8::String> symbol
1052
+    , int argc
1053
+    , v8::Local<v8::Value>* argv) {
1054
+#if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
1055
+    EscapableHandleScope scope;
1056
+    return scope.Escape(New(node::MakeCallback(
1057
+        v8::Isolate::GetCurrent(), target, symbol, argc, argv)));
1058
+#else
1059
+# if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1060
+    AsyncResource res("nan:makeCallback");
1061
+    return res.runInAsyncScope(target, symbol, argc, argv)
1062
+        .FromMaybe(v8::Local<v8::Value>());
1063
+# else
1064
+    return node::MakeCallback(
1065
+        v8::Isolate::GetCurrent(), target, symbol, argc, argv);
1066
+# endif  // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1067
+#endif  // NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
1068
+  }
1069
+
1070
+  NAN_DEPRECATED inline v8::Local<v8::Value> MakeCallback(
1071
+      v8::Local<v8::Object> target
1072
+    , const char* method
1073
+    , int argc
1074
+    , v8::Local<v8::Value>* argv) {
1075
+#if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
1076
+    EscapableHandleScope scope;
1077
+    return scope.Escape(New(node::MakeCallback(
1078
+        v8::Isolate::GetCurrent(), target, method, argc, argv)));
1079
+#else
1080
+# if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1081
+    AsyncResource res("nan:makeCallback");
1082
+    return res.runInAsyncScope(target, method, argc, argv)
1083
+        .FromMaybe(v8::Local<v8::Value>());
1084
+# else
1085
+    return node::MakeCallback(
1086
+        v8::Isolate::GetCurrent(), target, method, argc, argv);
1087
+# endif  // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1088
+#endif  // NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
1089
+  }
1090
+
1091
+  inline void FatalException(const TryCatch& try_catch) {
1092
+    node::FatalException(v8::Isolate::GetCurrent(), try_catch.try_catch_);
1093
+  }
1094
+
1095
+  inline v8::Local<v8::Value> ErrnoException(
1096
+          int errorno
1097
+       ,  const char* syscall = NULL
1098
+       ,  const char* message = NULL
1099
+       ,  const char* path = NULL) {
1100
+    return node::ErrnoException(v8::Isolate::GetCurrent(), errorno, syscall,
1101
+            message, path);
1102
+  }
1103
+
1104
+  NAN_DEPRECATED inline v8::Local<v8::Value> NanErrnoException(
1105
+          int errorno
1106
+       ,  const char* syscall = NULL
1107
+       ,  const char* message = NULL
1108
+       ,  const char* path = NULL) {
1109
+    return ErrnoException(errorno, syscall, message, path);
1110
+  }
1111
+
1112
+  template<typename T>
1113
+  inline void SetIsolateData(
1114
+      v8::Isolate *isolate
1115
+    , T *data
1116
+  ) {
1117
+      isolate->SetData(0, data);
1118
+  }
1119
+
1120
+  template<typename T>
1121
+  inline T *GetIsolateData(
1122
+      v8::Isolate *isolate
1123
+  ) {
1124
+      return static_cast<T*>(isolate->GetData(0));
1125
+  }
1126
+
1127
+class Utf8String {
1128
+ public:
1129
+  inline explicit Utf8String(v8::Local<v8::Value> from) :
1130
+      length_(0), str_(str_st_) {
1131
+    HandleScope scope;
1132
+    if (!from.IsEmpty()) {
1133
+#if NODE_MAJOR_VERSION >= 10
1134
+      v8::Local<v8::Context> context = GetCurrentContext();
1135
+      v8::Local<v8::String> string =
1136
+          from->ToString(context).FromMaybe(v8::Local<v8::String>());
1137
+#else
1138
+      v8::Local<v8::String> string = from->ToString();
1139
+#endif
1140
+      if (!string.IsEmpty()) {
1141
+        size_t len = 3 * string->Length() + 1;
1142
+        assert(len <= INT_MAX);
1143
+        if (len > sizeof (str_st_)) {
1144
+          str_ = static_cast<char*>(malloc(len));
1145
+          assert(str_ != 0);
1146
+        }
1147
+        const int flags =
1148
+            v8::String::NO_NULL_TERMINATION | imp::kReplaceInvalidUtf8;
1149
+#if NODE_MAJOR_VERSION >= 11
1150
+        length_ = string->WriteUtf8(v8::Isolate::GetCurrent(), str_,
1151
+                                    static_cast<int>(len), 0, flags);
1152
+#else
1153
+        // See https://github.com/nodejs/nan/issues/832.
1154
+        // Disable the warning as there is no way around it.
1155
+#ifdef _MSC_VER
1156
+#pragma warning(push)
1157
+#pragma warning(disable : 4996)
1158
+#endif
1159
+#ifdef __GNUC__
1160
+#pragma GCC diagnostic push
1161
+#pragma GCC diagnostic ignored "-Wdeprecated-declarations"
1162
+#endif
1163
+        length_ = string->WriteUtf8(str_, static_cast<int>(len), 0, flags);
1164
+#ifdef __GNUC__
1165
+#pragma GCC diagnostic pop
1166
+#endif
1167
+#ifdef _MSC_VER
1168
+#pragma warning(pop)
1169
+#endif
1170
+#endif  // NODE_MAJOR_VERSION < 11
1171
+        str_[length_] = '\0';
1172
+      }
1173
+    }
1174
+  }
1175
+
1176
+  inline int length() const {
1177
+    return length_;
1178
+  }
1179
+
1180
+  inline char* operator*() { return str_; }
1181
+  inline const char* operator*() const { return str_; }
1182
+
1183
+  inline ~Utf8String() {
1184
+    if (str_ != str_st_) {
1185
+      free(str_);
1186
+    }
1187
+  }
1188
+
1189
+ private:
1190
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(Utf8String)
1191
+
1192
+  int length_;
1193
+  char *str_;
1194
+  char str_st_[1024];
1195
+};
1196
+
1197
+#else  // Node 0.8 and 0.10
1198
+  inline v8::Local<v8::Primitive> Undefined() {
1199
+    EscapableHandleScope scope;
1200
+    return scope.Escape(New(v8::Undefined()));
1201
+  }
1202
+
1203
+  inline v8::Local<v8::Primitive> Null() {
1204
+    EscapableHandleScope scope;
1205
+    return scope.Escape(New(v8::Null()));
1206
+  }
1207
+
1208
+  inline v8::Local<v8::Boolean> True() {
1209
+    EscapableHandleScope scope;
1210
+    return scope.Escape(New(v8::True()));
1211
+  }
1212
+
1213
+  inline v8::Local<v8::Boolean> False() {
1214
+    EscapableHandleScope scope;
1215
+    return scope.Escape(New(v8::False()));
1216
+  }
1217
+
1218
+  inline v8::Local<v8::String> EmptyString() {
1219
+    return v8::String::Empty();
1220
+  }
1221
+
1222
+  inline int AdjustExternalMemory(int bc) {
1223
+    return static_cast<int>(v8::V8::AdjustAmountOfExternalAllocatedMemory(bc));
1224
+  }
1225
+
1226
+  inline void SetTemplate(
1227
+      v8::Local<v8::Template> templ
1228
+    , const char *name
1229
+    , v8::Local<v8::Data> value) {
1230
+    templ->Set(name, value);
1231
+  }
1232
+
1233
+  inline void SetTemplate(
1234
+      v8::Local<v8::Template> templ
1235
+    , v8::Local<v8::String> name
1236
+    , v8::Local<v8::Data> value
1237
+    , v8::PropertyAttribute attributes) {
1238
+    templ->Set(name, value, attributes);
1239
+  }
1240
+
1241
+  inline v8::Local<v8::Context> GetCurrentContext() {
1242
+    return v8::Context::GetCurrent();
1243
+  }
1244
+
1245
+  inline void* GetInternalFieldPointer(
1246
+      v8::Local<v8::Object> object
1247
+    , int index) {
1248
+    return object->GetPointerFromInternalField(index);
1249
+  }
1250
+
1251
+  inline void SetInternalFieldPointer(
1252
+      v8::Local<v8::Object> object
1253
+    , int index
1254
+    , void* value) {
1255
+    object->SetPointerInInternalField(index, value);
1256
+  }
1257
+
1258
+# define NAN_GC_CALLBACK(name)                                                 \
1259
+    void name(v8::GCType type, v8::GCCallbackFlags flags)
1260
+
1261
+  inline void AddGCEpilogueCallback(
1262
+    v8::GCEpilogueCallback callback
1263
+  , v8::GCType gc_type_filter = v8::kGCTypeAll) {
1264
+    v8::V8::AddGCEpilogueCallback(callback, gc_type_filter);
1265
+  }
1266
+  inline void RemoveGCEpilogueCallback(
1267
+    v8::GCEpilogueCallback callback) {
1268
+    v8::V8::RemoveGCEpilogueCallback(callback);
1269
+  }
1270
+  inline void AddGCPrologueCallback(
1271
+    v8::GCPrologueCallback callback
1272
+  , v8::GCType gc_type_filter = v8::kGCTypeAll) {
1273
+    v8::V8::AddGCPrologueCallback(callback, gc_type_filter);
1274
+  }
1275
+  inline void RemoveGCPrologueCallback(
1276
+    v8::GCPrologueCallback callback) {
1277
+    v8::V8::RemoveGCPrologueCallback(callback);
1278
+  }
1279
+  inline void GetHeapStatistics(
1280
+    v8::HeapStatistics *heap_statistics) {
1281
+    v8::V8::GetHeapStatistics(heap_statistics);
1282
+  }
1283
+
1284
+# define X(NAME)                                                               \
1285
+    inline v8::Local<v8::Value> NAME(const char *msg) {                        \
1286
+      EscapableHandleScope scope;                                              \
1287
+      return scope.Escape(v8::Exception::NAME(New(msg).ToLocalChecked()));     \
1288
+    }                                                                          \
1289
+                                                                               \
1290
+    inline                                                                     \
1291
+    v8::Local<v8::Value> NAME(v8::Local<v8::String> msg) {                     \
1292
+      return v8::Exception::NAME(msg);                                         \
1293
+    }                                                                          \
1294
+                                                                               \
1295
+    inline void Throw ## NAME(const char *msg) {                               \
1296
+      HandleScope scope;                                                       \
1297
+      v8::ThrowException(v8::Exception::NAME(New(msg).ToLocalChecked()));      \
1298
+    }                                                                          \
1299
+                                                                               \
1300
+    inline                                                                     \
1301
+    void Throw ## NAME(v8::Local<v8::String> errmsg) {                         \
1302
+      HandleScope scope;                                                       \
1303
+      v8::ThrowException(v8::Exception::NAME(errmsg));                         \
1304
+    }
1305
+
1306
+  X(Error)
1307
+  X(RangeError)
1308
+  X(ReferenceError)
1309
+  X(SyntaxError)
1310
+  X(TypeError)
1311
+
1312
+# undef X
1313
+
1314
+  inline void ThrowError(v8::Local<v8::Value> error) {
1315
+    v8::ThrowException(error);
1316
+  }
1317
+
1318
+  inline MaybeLocal<v8::Object> NewBuffer(
1319
+      char *data
1320
+    , size_t length
1321
+    , node::Buffer::free_callback callback
1322
+    , void *hint
1323
+  ) {
1324
+    EscapableHandleScope scope;
1325
+    // arbitrary buffer lengths requires
1326
+    // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
1327
+    assert(length <= imp::kMaxLength && "too large buffer");
1328
+    return scope.Escape(
1329
+        New(node::Buffer::New(data, length, callback, hint)->handle_));
1330
+  }
1331
+
1332
+  inline MaybeLocal<v8::Object> CopyBuffer(
1333
+      const char *data
1334
+    , uint32_t size
1335
+  ) {
1336
+    EscapableHandleScope scope;
1337
+    // arbitrary buffer lengths requires
1338
+    // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
1339
+    assert(size <= imp::kMaxLength && "too large buffer");
1340
+#if NODE_MODULE_VERSION >= NODE_0_10_MODULE_VERSION
1341
+    return scope.Escape(New(node::Buffer::New(data, size)->handle_));
1342
+#else
1343
+    return scope.Escape(
1344
+        New(node::Buffer::New(const_cast<char *>(data), size)->handle_));
1345
+#endif
1346
+  }
1347
+
1348
+  inline MaybeLocal<v8::Object> NewBuffer(uint32_t size) {
1349
+    // arbitrary buffer lengths requires
1350
+    // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
1351
+    EscapableHandleScope scope;
1352
+    assert(size <= imp::kMaxLength && "too large buffer");
1353
+    return scope.Escape(New(node::Buffer::New(size)->handle_));
1354
+  }
1355
+
1356
+  inline void FreeData(char *data, void *hint) {
1357
+    (void) hint;  // unused
1358
+    delete[] data;
1359
+  }
1360
+
1361
+  inline MaybeLocal<v8::Object> NewBuffer(
1362
+      char* data
1363
+    , uint32_t size
1364
+  ) {
1365
+    EscapableHandleScope scope;
1366
+    // arbitrary buffer lengths requires
1367
+    // NODE_MODULE_VERSION >= IOJS_3_0_MODULE_VERSION
1368
+    assert(size <= imp::kMaxLength && "too large buffer");
1369
+    return scope.Escape(
1370
+        New(node::Buffer::New(data, size, FreeData, NULL)->handle_));
1371
+  }
1372
+
1373
+namespace imp {
1374
+inline void
1375
+widenString(std::vector<uint16_t> *ws, const uint8_t *s, int l) {
1376
+  size_t len = static_cast<size_t>(l);
1377
+  if (l < 0) {
1378
+    len = strlen(reinterpret_cast<const char*>(s));
1379
+  }
1380
+  assert(len <= INT_MAX && "string too long");
1381
+  ws->resize(len);
1382
+  std::copy(s, s + len, ws->begin());  // NOLINT(build/include_what_you_use)
1383
+}
1384
+}  // end of namespace imp
1385
+
1386
+  inline MaybeLocal<v8::String>
1387
+  NewOneByteString(const uint8_t * value, int length = -1) {
1388
+    std::vector<uint16_t> wideString;  // NOLINT(build/include_what_you_use)
1389
+    imp::widenString(&wideString, value, length);
1390
+    return v8::String::New(wideString.data(),
1391
+                           static_cast<int>(wideString.size()));
1392
+  }
1393
+
1394
+  inline MaybeLocal<BoundScript> CompileScript(
1395
+      v8::Local<v8::String> s
1396
+    , const v8::ScriptOrigin& origin
1397
+  ) {
1398
+    return v8::Script::Compile(s, const_cast<v8::ScriptOrigin *>(&origin));
1399
+  }
1400
+
1401
+  inline MaybeLocal<BoundScript> CompileScript(
1402
+    v8::Local<v8::String> s
1403
+  ) {
1404
+    return v8::Script::Compile(s);
1405
+  }
1406
+
1407
+  inline
1408
+  MaybeLocal<v8::Value> RunScript(v8::Local<v8::Script> script) {
1409
+    return script->Run();
1410
+  }
1411
+
1412
+  inline v8::Local<v8::Value> MakeCallback(
1413
+      v8::Local<v8::Object> target
1414
+    , v8::Local<v8::Function> func
1415
+    , int argc
1416
+    , v8::Local<v8::Value>* argv) {
1417
+    v8::HandleScope scope;
1418
+    return scope.Close(New(node::MakeCallback(target, func, argc, argv)));
1419
+  }
1420
+
1421
+  inline v8::Local<v8::Value> MakeCallback(
1422
+      v8::Local<v8::Object> target
1423
+    , v8::Local<v8::String> symbol
1424
+    , int argc
1425
+    , v8::Local<v8::Value>* argv) {
1426
+    v8::HandleScope scope;
1427
+    return scope.Close(New(node::MakeCallback(target, symbol, argc, argv)));
1428
+  }
1429
+
1430
+  inline v8::Local<v8::Value> MakeCallback(
1431
+      v8::Local<v8::Object> target
1432
+    , const char* method
1433
+    , int argc
1434
+    , v8::Local<v8::Value>* argv) {
1435
+    v8::HandleScope scope;
1436
+    return scope.Close(New(node::MakeCallback(target, method, argc, argv)));
1437
+  }
1438
+
1439
+  inline void FatalException(const TryCatch& try_catch) {
1440
+    node::FatalException(const_cast<v8::TryCatch &>(try_catch.try_catch_));
1441
+  }
1442
+
1443
+  inline v8::Local<v8::Value> ErrnoException(
1444
+          int errorno
1445
+       ,  const char* syscall = NULL
1446
+       ,  const char* message = NULL
1447
+       ,  const char* path = NULL) {
1448
+    return node::ErrnoException(errorno, syscall, message, path);
1449
+  }
1450
+
1451
+  NAN_DEPRECATED inline v8::Local<v8::Value> NanErrnoException(
1452
+          int errorno
1453
+       ,  const char* syscall = NULL
1454
+       ,  const char* message = NULL
1455
+       ,  const char* path = NULL) {
1456
+    return ErrnoException(errorno, syscall, message, path);
1457
+  }
1458
+
1459
+
1460
+  template<typename T>
1461
+  inline void SetIsolateData(
1462
+      v8::Isolate *isolate
1463
+    , T *data
1464
+  ) {
1465
+      isolate->SetData(data);
1466
+  }
1467
+
1468
+  template<typename T>
1469
+  inline T *GetIsolateData(
1470
+      v8::Isolate *isolate
1471
+  ) {
1472
+      return static_cast<T*>(isolate->GetData());
1473
+  }
1474
+
1475
+class Utf8String {
1476
+ public:
1477
+  inline explicit Utf8String(v8::Local<v8::Value> from) :
1478
+      length_(0), str_(str_st_) {
1479
+    v8::HandleScope scope;
1480
+    if (!from.IsEmpty()) {
1481
+      v8::Local<v8::String> string = from->ToString();
1482
+      if (!string.IsEmpty()) {
1483
+        size_t len = 3 * string->Length() + 1;
1484
+        assert(len <= INT_MAX);
1485
+        if (len > sizeof (str_st_)) {
1486
+          str_ = static_cast<char*>(malloc(len));
1487
+          assert(str_ != 0);
1488
+        }
1489
+        const int flags =
1490
+            v8::String::NO_NULL_TERMINATION | imp::kReplaceInvalidUtf8;
1491
+        length_ = string->WriteUtf8(str_, static_cast<int>(len), 0, flags);
1492
+        str_[length_] = '\0';
1493
+      }
1494
+    }
1495
+  }
1496
+
1497
+  inline int length() const {
1498
+    return length_;
1499
+  }
1500
+
1501
+  inline char* operator*() { return str_; }
1502
+  inline const char* operator*() const { return str_; }
1503
+
1504
+  inline ~Utf8String() {
1505
+    if (str_ != str_st_) {
1506
+      free(str_);
1507
+    }
1508
+  }
1509
+
1510
+ private:
1511
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(Utf8String)
1512
+
1513
+  int length_;
1514
+  char *str_;
1515
+  char str_st_[1024];
1516
+};
1517
+
1518
+#endif  // NODE_MODULE_VERSION
1519
+
1520
+typedef void (*FreeCallback)(char *data, void *hint);
1521
+
1522
+typedef const FunctionCallbackInfo<v8::Value>& NAN_METHOD_ARGS_TYPE;
1523
+typedef void NAN_METHOD_RETURN_TYPE;
1524
+
1525
+typedef const PropertyCallbackInfo<v8::Value>& NAN_GETTER_ARGS_TYPE;
1526
+typedef void NAN_GETTER_RETURN_TYPE;
1527
+
1528
+typedef const PropertyCallbackInfo<void>& NAN_SETTER_ARGS_TYPE;
1529
+typedef void NAN_SETTER_RETURN_TYPE;
1530
+
1531
+typedef const PropertyCallbackInfo<v8::Value>&
1532
+    NAN_PROPERTY_GETTER_ARGS_TYPE;
1533
+typedef void NAN_PROPERTY_GETTER_RETURN_TYPE;
1534
+
1535
+typedef const PropertyCallbackInfo<v8::Value>&
1536
+    NAN_PROPERTY_SETTER_ARGS_TYPE;
1537
+typedef void NAN_PROPERTY_SETTER_RETURN_TYPE;
1538
+
1539
+typedef const PropertyCallbackInfo<v8::Array>&
1540
+    NAN_PROPERTY_ENUMERATOR_ARGS_TYPE;
1541
+typedef void NAN_PROPERTY_ENUMERATOR_RETURN_TYPE;
1542
+
1543
+typedef const PropertyCallbackInfo<v8::Boolean>&
1544
+    NAN_PROPERTY_DELETER_ARGS_TYPE;
1545
+typedef void NAN_PROPERTY_DELETER_RETURN_TYPE;
1546
+
1547
+typedef const PropertyCallbackInfo<v8::Integer>&
1548
+    NAN_PROPERTY_QUERY_ARGS_TYPE;
1549
+typedef void NAN_PROPERTY_QUERY_RETURN_TYPE;
1550
+
1551
+typedef const PropertyCallbackInfo<v8::Value>& NAN_INDEX_GETTER_ARGS_TYPE;
1552
+typedef void NAN_INDEX_GETTER_RETURN_TYPE;
1553
+
1554
+typedef const PropertyCallbackInfo<v8::Value>& NAN_INDEX_SETTER_ARGS_TYPE;
1555
+typedef void NAN_INDEX_SETTER_RETURN_TYPE;
1556
+
1557
+typedef const PropertyCallbackInfo<v8::Array>&
1558
+    NAN_INDEX_ENUMERATOR_ARGS_TYPE;
1559
+typedef void NAN_INDEX_ENUMERATOR_RETURN_TYPE;
1560
+
1561
+typedef const PropertyCallbackInfo<v8::Boolean>&
1562
+    NAN_INDEX_DELETER_ARGS_TYPE;
1563
+typedef void NAN_INDEX_DELETER_RETURN_TYPE;
1564
+
1565
+typedef const PropertyCallbackInfo<v8::Integer>&
1566
+    NAN_INDEX_QUERY_ARGS_TYPE;
1567
+typedef void NAN_INDEX_QUERY_RETURN_TYPE;
1568
+
1569
+#define NAN_METHOD(name)                                                       \
1570
+    Nan::NAN_METHOD_RETURN_TYPE name(Nan::NAN_METHOD_ARGS_TYPE info)
1571
+#define NAN_GETTER(name)                                                       \
1572
+    Nan::NAN_GETTER_RETURN_TYPE name(                                          \
1573
+        v8::Local<v8::String> property                                         \
1574
+      , Nan::NAN_GETTER_ARGS_TYPE info)
1575
+#define NAN_SETTER(name)                                                       \
1576
+    Nan::NAN_SETTER_RETURN_TYPE name(                                          \
1577
+        v8::Local<v8::String> property                                         \
1578
+      , v8::Local<v8::Value> value                                             \
1579
+      , Nan::NAN_SETTER_ARGS_TYPE info)
1580
+#define NAN_PROPERTY_GETTER(name)                                              \
1581
+    Nan::NAN_PROPERTY_GETTER_RETURN_TYPE name(                                 \
1582
+        v8::Local<v8::String> property                                         \
1583
+      , Nan::NAN_PROPERTY_GETTER_ARGS_TYPE info)
1584
+#define NAN_PROPERTY_SETTER(name)                                              \
1585
+    Nan::NAN_PROPERTY_SETTER_RETURN_TYPE name(                                 \
1586
+        v8::Local<v8::String> property                                         \
1587
+      , v8::Local<v8::Value> value                                             \
1588
+      , Nan::NAN_PROPERTY_SETTER_ARGS_TYPE info)
1589
+#define NAN_PROPERTY_ENUMERATOR(name)                                          \
1590
+    Nan::NAN_PROPERTY_ENUMERATOR_RETURN_TYPE name(                             \
1591
+        Nan::NAN_PROPERTY_ENUMERATOR_ARGS_TYPE info)
1592
+#define NAN_PROPERTY_DELETER(name)                                             \
1593
+    Nan::NAN_PROPERTY_DELETER_RETURN_TYPE name(                                \
1594
+        v8::Local<v8::String> property                                         \
1595
+      , Nan::NAN_PROPERTY_DELETER_ARGS_TYPE info)
1596
+#define NAN_PROPERTY_QUERY(name)                                               \
1597
+    Nan::NAN_PROPERTY_QUERY_RETURN_TYPE name(                                  \
1598
+        v8::Local<v8::String> property                                         \
1599
+      , Nan::NAN_PROPERTY_QUERY_ARGS_TYPE info)
1600
+# define NAN_INDEX_GETTER(name)                                                \
1601
+    Nan::NAN_INDEX_GETTER_RETURN_TYPE name(                                    \
1602
+        uint32_t index                                                         \
1603
+      , Nan::NAN_INDEX_GETTER_ARGS_TYPE info)
1604
+#define NAN_INDEX_SETTER(name)                                                 \
1605
+    Nan::NAN_INDEX_SETTER_RETURN_TYPE name(                                    \
1606
+        uint32_t index                                                         \
1607
+      , v8::Local<v8::Value> value                                             \
1608
+      , Nan::NAN_INDEX_SETTER_ARGS_TYPE info)
1609
+#define NAN_INDEX_ENUMERATOR(name)                                             \
1610
+    Nan::NAN_INDEX_ENUMERATOR_RETURN_TYPE                                      \
1611
+    name(Nan::NAN_INDEX_ENUMERATOR_ARGS_TYPE info)
1612
+#define NAN_INDEX_DELETER(name)                                                \
1613
+    Nan::NAN_INDEX_DELETER_RETURN_TYPE name(                                   \
1614
+        uint32_t index                                                         \
1615
+      , Nan::NAN_INDEX_DELETER_ARGS_TYPE info)
1616
+#define NAN_INDEX_QUERY(name)                                                  \
1617
+    Nan::NAN_INDEX_QUERY_RETURN_TYPE name(                                     \
1618
+        uint32_t index                                                         \
1619
+      , Nan::NAN_INDEX_QUERY_ARGS_TYPE info)
1620
+
1621
+class Callback {
1622
+ public:
1623
+  Callback() {}
1624
+
1625
+  explicit Callback(const v8::Local<v8::Function> &fn) : handle_(fn) {}
1626
+
1627
+  ~Callback() {
1628
+    handle_.Reset();
1629
+  }
1630
+
1631
+  bool operator==(const Callback &other) const {
1632
+    return handle_ == other.handle_;
1633
+  }
1634
+
1635
+  bool operator!=(const Callback &other) const {
1636
+    return !operator==(other);
1637
+  }
1638
+
1639
+  inline
1640
+  v8::Local<v8::Function> operator*() const { return GetFunction(); }
1641
+
1642
+  NAN_DEPRECATED inline v8::Local<v8::Value> operator()(
1643
+      v8::Local<v8::Object> target
1644
+    , int argc = 0
1645
+    , v8::Local<v8::Value> argv[] = 0) const {
1646
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1647
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
1648
+# if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1649
+    AsyncResource async("nan:Callback:operator()");
1650
+    return Call_(isolate, target, argc, argv, &async)
1651
+        .FromMaybe(v8::Local<v8::Value>());
1652
+# else
1653
+    return Call_(isolate, target, argc, argv);
1654
+# endif  // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1655
+#else
1656
+    return Call_(target, argc, argv);
1657
+#endif  //  NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1658
+  }
1659
+
1660
+  NAN_DEPRECATED inline v8::Local<v8::Value> operator()(
1661
+      int argc = 0
1662
+    , v8::Local<v8::Value> argv[] = 0) const {
1663
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1664
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
1665
+    v8::EscapableHandleScope scope(isolate);
1666
+# if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1667
+    AsyncResource async("nan:Callback:operator()");
1668
+    return scope.Escape(Call_(isolate, isolate->GetCurrentContext()->Global(),
1669
+                              argc, argv, &async)
1670
+                            .FromMaybe(v8::Local<v8::Value>()));
1671
+# else
1672
+    return scope.Escape(
1673
+        Call_(isolate, isolate->GetCurrentContext()->Global(), argc, argv));
1674
+# endif  // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1675
+#else
1676
+    v8::HandleScope scope;
1677
+    return scope.Close(Call_(v8::Context::GetCurrent()->Global(), argc, argv));
1678
+#endif  //  NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1679
+  }
1680
+
1681
+  inline MaybeLocal<v8::Value> operator()(
1682
+      AsyncResource* resource
1683
+    , int argc = 0
1684
+    , v8::Local<v8::Value> argv[] = 0) const {
1685
+    return this->Call(argc, argv, resource);
1686
+  }
1687
+
1688
+  inline MaybeLocal<v8::Value> operator()(
1689
+      AsyncResource* resource
1690
+    , v8::Local<v8::Object> target
1691
+    , int argc = 0
1692
+    , v8::Local<v8::Value> argv[] = 0) const {
1693
+    return this->Call(target, argc, argv, resource);
1694
+  }
1695
+
1696
+  // TODO(kkoopa): remove
1697
+  inline void SetFunction(const v8::Local<v8::Function> &fn) {
1698
+    Reset(fn);
1699
+  }
1700
+
1701
+  inline void Reset(const v8::Local<v8::Function> &fn) {
1702
+    handle_.Reset(fn);
1703
+  }
1704
+
1705
+  inline void Reset() {
1706
+    handle_.Reset();
1707
+  }
1708
+
1709
+  inline v8::Local<v8::Function> GetFunction() const {
1710
+    return New(handle_);
1711
+  }
1712
+
1713
+  inline bool IsEmpty() const {
1714
+    return handle_.IsEmpty();
1715
+  }
1716
+
1717
+  // Deprecated: For async callbacks Use the versions that accept an
1718
+  // AsyncResource. If this callback does not correspond to an async resource,
1719
+  // that is, it is a synchronous function call on a non-empty JS stack, you
1720
+  // should Nan::Call instead.
1721
+  NAN_DEPRECATED inline v8::Local<v8::Value>
1722
+  Call(v8::Local<v8::Object> target
1723
+     , int argc
1724
+     , v8::Local<v8::Value> argv[]) const {
1725
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1726
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
1727
+# if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1728
+    AsyncResource async("nan:Callback:Call");
1729
+    return Call_(isolate, target, argc, argv, &async)
1730
+        .FromMaybe(v8::Local<v8::Value>());
1731
+# else
1732
+    return Call_(isolate, target, argc, argv);
1733
+# endif  // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1734
+#else
1735
+    return Call_(target, argc, argv);
1736
+#endif
1737
+  }
1738
+
1739
+  // Deprecated: For async callbacks Use the versions that accept an
1740
+  // AsyncResource. If this callback does not correspond to an async resource,
1741
+  // that is, it is a synchronous function call on a non-empty JS stack, you
1742
+  // should Nan::Call instead.
1743
+  NAN_DEPRECATED inline v8::Local<v8::Value>
1744
+  Call(int argc, v8::Local<v8::Value> argv[]) const {
1745
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1746
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
1747
+    v8::EscapableHandleScope scope(isolate);
1748
+# if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1749
+    AsyncResource async("nan:Callback:Call");
1750
+    return scope.Escape(Call_(isolate, isolate->GetCurrentContext()->Global(),
1751
+                              argc, argv, &async)
1752
+                            .FromMaybe(v8::Local<v8::Value>()));
1753
+# else
1754
+    return scope.Escape(
1755
+        Call_(isolate, isolate->GetCurrentContext()->Global(), argc, argv));
1756
+# endif  // NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1757
+#else
1758
+    v8::HandleScope scope;
1759
+    return scope.Close(Call_(v8::Context::GetCurrent()->Global(), argc, argv));
1760
+#endif
1761
+  }
1762
+
1763
+  inline MaybeLocal<v8::Value>
1764
+  Call(v8::Local<v8::Object> target
1765
+     , int argc
1766
+     , v8::Local<v8::Value> argv[]
1767
+     , AsyncResource* resource) const {
1768
+#if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1769
+    v8::Isolate* isolate = v8::Isolate::GetCurrent();
1770
+    return Call_(isolate, target, argc, argv, resource);
1771
+#elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1772
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
1773
+    return Call_(isolate, target, argc, argv);
1774
+#else
1775
+    return Call_(target, argc, argv);
1776
+#endif
1777
+  }
1778
+
1779
+  inline MaybeLocal<v8::Value>
1780
+  Call(int argc, v8::Local<v8::Value> argv[], AsyncResource* resource) const {
1781
+#if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1782
+    v8::Isolate* isolate = v8::Isolate::GetCurrent();
1783
+    return Call(isolate->GetCurrentContext()->Global(), argc, argv, resource);
1784
+#elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1785
+    v8::Isolate *isolate = v8::Isolate::GetCurrent();
1786
+    v8::EscapableHandleScope scope(isolate);
1787
+    return scope.Escape(
1788
+        Call_(isolate, isolate->GetCurrentContext()->Global(), argc, argv));
1789
+#else
1790
+    v8::HandleScope scope;
1791
+    return scope.Close(Call_(v8::Context::GetCurrent()->Global(), argc, argv));
1792
+#endif
1793
+  }
1794
+
1795
+ private:
1796
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(Callback)
1797
+  Persistent<v8::Function> handle_;
1798
+
1799
+#if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
1800
+  MaybeLocal<v8::Value> Call_(v8::Isolate *isolate
1801
+                            , v8::Local<v8::Object> target
1802
+                            , int argc
1803
+                            , v8::Local<v8::Value> argv[]
1804
+                            , AsyncResource* resource) const {
1805
+    EscapableHandleScope scope;
1806
+    v8::Local<v8::Function> func = New(handle_);
1807
+    auto maybe = resource->runInAsyncScope(target, func, argc, argv);
1808
+    v8::Local<v8::Value> local;
1809
+    if (!maybe.ToLocal(&local)) return MaybeLocal<v8::Value>();
1810
+    return scope.Escape(local);
1811
+  }
1812
+#elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1813
+  v8::Local<v8::Value> Call_(v8::Isolate *isolate
1814
+                           , v8::Local<v8::Object> target
1815
+                           , int argc
1816
+                           , v8::Local<v8::Value> argv[]) const {
1817
+    EscapableHandleScope scope;
1818
+
1819
+    v8::Local<v8::Function> callback = New(handle_);
1820
+# if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
1821
+    return scope.Escape(New(node::MakeCallback(
1822
+        isolate
1823
+      , target
1824
+      , callback
1825
+      , argc
1826
+      , argv
1827
+    )));
1828
+# else
1829
+    return scope.Escape(node::MakeCallback(
1830
+        isolate
1831
+      , target
1832
+      , callback
1833
+      , argc
1834
+      , argv
1835
+    ));
1836
+# endif
1837
+  }
1838
+#else
1839
+  v8::Local<v8::Value> Call_(v8::Local<v8::Object> target
1840
+                           , int argc
1841
+                           , v8::Local<v8::Value> argv[]) const {
1842
+    EscapableHandleScope scope;
1843
+
1844
+    v8::Local<v8::Function> callback = New(handle_);
1845
+    return scope.Escape(New(node::MakeCallback(
1846
+        target
1847
+      , callback
1848
+      , argc
1849
+      , argv
1850
+    )));
1851
+  }
1852
+#endif
1853
+};
1854
+
1855
+inline MaybeLocal<v8::Value> Call(
1856
+    const Nan::Callback& callback
1857
+  , v8::Local<v8::Object> recv
1858
+  , int argc
1859
+  , v8::Local<v8::Value> argv[]) {
1860
+  return Call(*callback, recv, argc, argv);
1861
+}
1862
+
1863
+inline MaybeLocal<v8::Value> Call(
1864
+    const Nan::Callback& callback
1865
+  , int argc
1866
+  , v8::Local<v8::Value> argv[]) {
1867
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
1868
+  v8::Isolate* isolate = v8::Isolate::GetCurrent();
1869
+  v8::EscapableHandleScope scope(isolate);
1870
+  return scope.Escape(
1871
+      Call(*callback, isolate->GetCurrentContext()->Global(), argc, argv)
1872
+          .FromMaybe(v8::Local<v8::Value>()));
1873
+#else
1874
+  EscapableHandleScope scope;
1875
+  return scope.Escape(
1876
+      Call(*callback, v8::Context::GetCurrent()->Global(), argc, argv)
1877
+          .FromMaybe(v8::Local<v8::Value>()));
1878
+#endif
1879
+}
1880
+
1881
+inline MaybeLocal<v8::Value> Call(
1882
+    v8::Local<v8::String> symbol
1883
+  , v8::Local<v8::Object> recv
1884
+  , int argc
1885
+  , v8::Local<v8::Value> argv[]) {
1886
+  EscapableHandleScope scope;
1887
+  v8::Local<v8::Value> fn_v =
1888
+      Get(recv, symbol).FromMaybe(v8::Local<v8::Value>());
1889
+  if (fn_v.IsEmpty() || !fn_v->IsFunction()) return v8::Local<v8::Value>();
1890
+  v8::Local<v8::Function> fn = fn_v.As<v8::Function>();
1891
+  return scope.Escape(
1892
+      Call(fn, recv, argc, argv).FromMaybe(v8::Local<v8::Value>()));
1893
+}
1894
+
1895
+inline MaybeLocal<v8::Value> Call(
1896
+    const char* method
1897
+  , v8::Local<v8::Object> recv
1898
+  , int argc
1899
+  , v8::Local<v8::Value> argv[]) {
1900
+  EscapableHandleScope scope;
1901
+  v8::Local<v8::String> method_string =
1902
+      New<v8::String>(method).ToLocalChecked();
1903
+  return scope.Escape(
1904
+      Call(method_string, recv, argc, argv).FromMaybe(v8::Local<v8::Value>()));
1905
+}
1906
+
1907
+/* abstract */ class AsyncWorker {
1908
+ public:
1909
+  explicit AsyncWorker(Callback *callback_,
1910
+                       const char* resource_name = "nan:AsyncWorker")
1911
+      : callback(callback_), errmsg_(NULL) {
1912
+    request.data = this;
1913
+
1914
+    HandleScope scope;
1915
+    v8::Local<v8::Object> obj = New<v8::Object>();
1916
+    persistentHandle.Reset(obj);
1917
+    async_resource = new AsyncResource(resource_name, obj);
1918
+  }
1919
+
1920
+  virtual ~AsyncWorker() {
1921
+    HandleScope scope;
1922
+
1923
+    if (!persistentHandle.IsEmpty())
1924
+      persistentHandle.Reset();
1925
+    delete callback;
1926
+    delete[] errmsg_;
1927
+    delete async_resource;
1928
+  }
1929
+
1930
+  virtual void WorkComplete() {
1931
+    HandleScope scope;
1932
+
1933
+    if (errmsg_ == NULL)
1934
+      HandleOKCallback();
1935
+    else
1936
+      HandleErrorCallback();
1937
+    delete callback;
1938
+    callback = NULL;
1939
+  }
1940
+
1941
+  inline void SaveToPersistent(
1942
+      const char *key, const v8::Local<v8::Value> &value) {
1943
+    HandleScope scope;
1944
+    Set(New(persistentHandle), New(key).ToLocalChecked(), value).FromJust();
1945
+  }
1946
+
1947
+  inline void SaveToPersistent(
1948
+      const v8::Local<v8::String> &key, const v8::Local<v8::Value> &value) {
1949
+    HandleScope scope;
1950
+    Set(New(persistentHandle), key, value).FromJust();
1951
+  }
1952
+
1953
+  inline void SaveToPersistent(
1954
+      uint32_t index, const v8::Local<v8::Value> &value) {
1955
+    HandleScope scope;
1956
+    Set(New(persistentHandle), index, value).FromJust();
1957
+  }
1958
+
1959
+  inline v8::Local<v8::Value> GetFromPersistent(const char *key) const {
1960
+    EscapableHandleScope scope;
1961
+    return scope.Escape(
1962
+        Get(New(persistentHandle), New(key).ToLocalChecked())
1963
+        .FromMaybe(v8::Local<v8::Value>()));
1964
+  }
1965
+
1966
+  inline v8::Local<v8::Value>
1967
+  GetFromPersistent(const v8::Local<v8::String> &key) const {
1968
+    EscapableHandleScope scope;
1969
+    return scope.Escape(
1970
+        Get(New(persistentHandle), key)
1971
+        .FromMaybe(v8::Local<v8::Value>()));
1972
+  }
1973
+
1974
+  inline v8::Local<v8::Value> GetFromPersistent(uint32_t index) const {
1975
+    EscapableHandleScope scope;
1976
+    return scope.Escape(
1977
+        Get(New(persistentHandle), index)
1978
+        .FromMaybe(v8::Local<v8::Value>()));
1979
+  }
1980
+
1981
+  virtual void Execute() = 0;
1982
+
1983
+  uv_work_t request;
1984
+
1985
+  virtual void Destroy() {
1986
+      delete this;
1987
+  }
1988
+
1989
+ protected:
1990
+  Persistent<v8::Object> persistentHandle;
1991
+  Callback *callback;
1992
+  AsyncResource *async_resource;
1993
+
1994
+  virtual void HandleOKCallback() {
1995
+    HandleScope scope;
1996
+
1997
+    callback->Call(0, NULL, async_resource);
1998
+  }
1999
+
2000
+  virtual void HandleErrorCallback() {
2001
+    HandleScope scope;
2002
+
2003
+    v8::Local<v8::Value> argv[] = {
2004
+      v8::Exception::Error(New<v8::String>(ErrorMessage()).ToLocalChecked())
2005
+    };
2006
+    callback->Call(1, argv, async_resource);
2007
+  }
2008
+
2009
+  void SetErrorMessage(const char *msg) {
2010
+    delete[] errmsg_;
2011
+
2012
+    size_t size = strlen(msg) + 1;
2013
+    errmsg_ = new char[size];
2014
+    memcpy(errmsg_, msg, size);
2015
+  }
2016
+
2017
+  const char* ErrorMessage() const {
2018
+    return errmsg_;
2019
+  }
2020
+
2021
+ private:
2022
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(AsyncWorker)
2023
+  char *errmsg_;
2024
+};
2025
+
2026
+/* abstract */ class AsyncBareProgressWorkerBase : public AsyncWorker {
2027
+ public:
2028
+  explicit AsyncBareProgressWorkerBase(
2029
+      Callback *callback_,
2030
+      const char* resource_name = "nan:AsyncBareProgressWorkerBase")
2031
+      : AsyncWorker(callback_, resource_name) {
2032
+    uv_async_init(
2033
+        GetCurrentEventLoop()
2034
+      , &async
2035
+      , AsyncProgress_
2036
+    );
2037
+    async.data = this;
2038
+  }
2039
+
2040
+  virtual ~AsyncBareProgressWorkerBase() {
2041
+  }
2042
+
2043
+  virtual void WorkProgress() = 0;
2044
+
2045
+  virtual void Destroy() {
2046
+      uv_close(reinterpret_cast<uv_handle_t*>(&async), AsyncClose_);
2047
+  }
2048
+
2049
+ private:
2050
+  inline static NAUV_WORK_CB(AsyncProgress_) {
2051
+    AsyncBareProgressWorkerBase *worker =
2052
+            static_cast<AsyncBareProgressWorkerBase*>(async->data);
2053
+    worker->WorkProgress();
2054
+  }
2055
+
2056
+  inline static void AsyncClose_(uv_handle_t* handle) {
2057
+    AsyncBareProgressWorkerBase *worker =
2058
+            static_cast<AsyncBareProgressWorkerBase*>(handle->data);
2059
+    delete worker;
2060
+  }
2061
+
2062
+ protected:
2063
+  uv_async_t async;
2064
+};
2065
+
2066
+template<class T>
2067
+/* abstract */
2068
+class AsyncBareProgressWorker : public AsyncBareProgressWorkerBase {
2069
+ public:
2070
+  explicit AsyncBareProgressWorker(
2071
+      Callback *callback_,
2072
+      const char* resource_name = "nan:AsyncBareProgressWorker")
2073
+      : AsyncBareProgressWorkerBase(callback_, resource_name) {
2074
+    uv_mutex_init(&async_lock);
2075
+  }
2076
+
2077
+  virtual ~AsyncBareProgressWorker() {
2078
+    uv_mutex_destroy(&async_lock);
2079
+  }
2080
+
2081
+  class ExecutionProgress {
2082
+    friend class AsyncBareProgressWorker;
2083
+   public:
2084
+    void Signal() const {
2085
+      uv_mutex_lock(&that_->async_lock);
2086
+      uv_async_send(&that_->async);
2087
+      uv_mutex_unlock(&that_->async_lock);
2088
+    }
2089
+
2090
+    void Send(const T* data, size_t count) const {
2091
+      that_->SendProgress_(data, count);
2092
+    }
2093
+
2094
+   private:
2095
+    explicit ExecutionProgress(AsyncBareProgressWorker *that) : that_(that) {}
2096
+    NAN_DISALLOW_ASSIGN_COPY_MOVE(ExecutionProgress)
2097
+    AsyncBareProgressWorker* const that_;
2098
+  };
2099
+
2100
+  virtual void Execute(const ExecutionProgress& progress) = 0;
2101
+  virtual void HandleProgressCallback(const T *data, size_t size) = 0;
2102
+
2103
+ protected:
2104
+  uv_mutex_t async_lock;
2105
+
2106
+ private:
2107
+  void Execute() /*final override*/ {
2108
+    ExecutionProgress progress(this);
2109
+    Execute(progress);
2110
+  }
2111
+
2112
+  virtual void SendProgress_(const T *data, size_t count) = 0;
2113
+};
2114
+
2115
+template<class T>
2116
+/* abstract */
2117
+class AsyncProgressWorkerBase : public AsyncBareProgressWorker<T> {
2118
+ public:
2119
+  explicit AsyncProgressWorkerBase(
2120
+      Callback *callback_,
2121
+      const char* resource_name = "nan:AsyncProgressWorkerBase")
2122
+      : AsyncBareProgressWorker<T>(callback_, resource_name), asyncdata_(NULL),
2123
+        asyncsize_(0) {
2124
+  }
2125
+
2126
+  virtual ~AsyncProgressWorkerBase() {
2127
+    delete[] asyncdata_;
2128
+  }
2129
+
2130
+  void WorkProgress() {
2131
+    uv_mutex_lock(&this->async_lock);
2132
+    T *data = asyncdata_;
2133
+    size_t size = asyncsize_;
2134
+    asyncdata_ = NULL;
2135
+    asyncsize_ = 0;
2136
+    uv_mutex_unlock(&this->async_lock);
2137
+
2138
+    // Don't send progress events after we've already completed.
2139
+    if (this->callback) {
2140
+        this->HandleProgressCallback(data, size);
2141
+    }
2142
+    delete[] data;
2143
+  }
2144
+
2145
+ private:
2146
+  void SendProgress_(const T *data, size_t count) {
2147
+    T *new_data = new T[count];
2148
+    std::copy(data, data + count, new_data);
2149
+
2150
+    uv_mutex_lock(&this->async_lock);
2151
+    T *old_data = asyncdata_;
2152
+    asyncdata_ = new_data;
2153
+    asyncsize_ = count;
2154
+    uv_async_send(&this->async);
2155
+    uv_mutex_unlock(&this->async_lock);
2156
+
2157
+    delete[] old_data;
2158
+  }
2159
+
2160
+  T *asyncdata_;
2161
+  size_t asyncsize_;
2162
+};
2163
+
2164
+// This ensures compatibility to the previous un-templated AsyncProgressWorker
2165
+// class definition.
2166
+typedef AsyncProgressWorkerBase<char> AsyncProgressWorker;
2167
+
2168
+template<class T>
2169
+/* abstract */
2170
+class AsyncBareProgressQueueWorker : public AsyncBareProgressWorkerBase {
2171
+ public:
2172
+  explicit AsyncBareProgressQueueWorker(
2173
+      Callback *callback_,
2174
+      const char* resource_name = "nan:AsyncBareProgressQueueWorker")
2175
+      : AsyncBareProgressWorkerBase(callback_, resource_name) {
2176
+  }
2177
+
2178
+  virtual ~AsyncBareProgressQueueWorker() {
2179
+  }
2180
+
2181
+  class ExecutionProgress {
2182
+    friend class AsyncBareProgressQueueWorker;
2183
+   public:
2184
+    void Send(const T* data, size_t count) const {
2185
+      that_->SendProgress_(data, count);
2186
+    }
2187
+
2188
+   private:
2189
+    explicit ExecutionProgress(AsyncBareProgressQueueWorker *that)
2190
+        : that_(that) {}
2191
+    NAN_DISALLOW_ASSIGN_COPY_MOVE(ExecutionProgress)
2192
+    AsyncBareProgressQueueWorker* const that_;
2193
+  };
2194
+
2195
+  virtual void Execute(const ExecutionProgress& progress) = 0;
2196
+  virtual void HandleProgressCallback(const T *data, size_t size) = 0;
2197
+
2198
+ private:
2199
+  void Execute() /*final override*/ {
2200
+    ExecutionProgress progress(this);
2201
+    Execute(progress);
2202
+  }
2203
+
2204
+  virtual void SendProgress_(const T *data, size_t count) = 0;
2205
+};
2206
+
2207
+template<class T>
2208
+/* abstract */
2209
+class AsyncProgressQueueWorker : public AsyncBareProgressQueueWorker<T> {
2210
+ public:
2211
+  explicit AsyncProgressQueueWorker(
2212
+      Callback *callback_,
2213
+      const char* resource_name = "nan:AsyncProgressQueueWorker")
2214
+      : AsyncBareProgressQueueWorker<T>(callback_) {
2215
+    uv_mutex_init(&async_lock);
2216
+  }
2217
+
2218
+  virtual ~AsyncProgressQueueWorker() {
2219
+    uv_mutex_lock(&async_lock);
2220
+
2221
+    while (!asyncdata_.empty()) {
2222
+      std::pair<T*, size_t> &datapair = asyncdata_.front();
2223
+      T *data = datapair.first;
2224
+
2225
+      asyncdata_.pop();
2226
+
2227
+      delete[] data;
2228
+    }
2229
+
2230
+    uv_mutex_unlock(&async_lock);
2231
+    uv_mutex_destroy(&async_lock);
2232
+  }
2233
+
2234
+  void WorkComplete() {
2235
+    WorkProgress();
2236
+    AsyncWorker::WorkComplete();
2237
+  }
2238
+
2239
+  void WorkProgress() {
2240
+    uv_mutex_lock(&async_lock);
2241
+
2242
+    while (!asyncdata_.empty()) {
2243
+      std::pair<T*, size_t> &datapair = asyncdata_.front();
2244
+
2245
+      T *data = datapair.first;
2246
+      size_t size = datapair.second;
2247
+
2248
+      asyncdata_.pop();
2249
+      uv_mutex_unlock(&async_lock);
2250
+
2251
+      // Don't send progress events after we've already completed.
2252
+      if (this->callback) {
2253
+          this->HandleProgressCallback(data, size);
2254
+      }
2255
+
2256
+      delete[] data;
2257
+
2258
+      uv_mutex_lock(&async_lock);
2259
+    }
2260
+
2261
+    uv_mutex_unlock(&async_lock);
2262
+  }
2263
+
2264
+ private:
2265
+  void SendProgress_(const T *data, size_t count) {
2266
+    T *new_data = new T[count];
2267
+    std::copy(data, data + count, new_data);
2268
+
2269
+    uv_mutex_lock(&async_lock);
2270
+    asyncdata_.push(std::pair<T*, size_t>(new_data, count));
2271
+    uv_mutex_unlock(&async_lock);
2272
+
2273
+    uv_async_send(&this->async);
2274
+  }
2275
+
2276
+  uv_mutex_t async_lock;
2277
+  std::queue<std::pair<T*, size_t> > asyncdata_;
2278
+};
2279
+
2280
+inline void AsyncExecute (uv_work_t* req) {
2281
+  AsyncWorker *worker = static_cast<AsyncWorker*>(req->data);
2282
+  worker->Execute();
2283
+}
2284
+
2285
+/* uv_after_work_cb has 1 argument before node-v0.9.4 and
2286
+ * 2 arguments since node-v0.9.4
2287
+ * https://github.com/libuv/libuv/commit/92fb84b751e18f032c02609467f44bfe927b80c5
2288
+ */
2289
+inline void AsyncExecuteComplete(uv_work_t *req) {
2290
+  AsyncWorker* worker = static_cast<AsyncWorker*>(req->data);
2291
+  worker->WorkComplete();
2292
+  worker->Destroy();
2293
+}
2294
+inline void AsyncExecuteComplete (uv_work_t* req, int status) {
2295
+  AsyncExecuteComplete(req);
2296
+}
2297
+
2298
+inline void AsyncQueueWorker (AsyncWorker* worker) {
2299
+  uv_queue_work(
2300
+      GetCurrentEventLoop()
2301
+    , &worker->request
2302
+    , AsyncExecute
2303
+    , AsyncExecuteComplete
2304
+  );
2305
+}
2306
+
2307
+namespace imp {
2308
+
2309
+inline
2310
+ExternalOneByteStringResource const*
2311
+GetExternalResource(v8::Local<v8::String> str) {
2312
+#if NODE_MODULE_VERSION < ATOM_0_21_MODULE_VERSION
2313
+    return str->GetExternalAsciiStringResource();
2314
+#else
2315
+    return str->GetExternalOneByteStringResource();
2316
+#endif
2317
+}
2318
+
2319
+inline
2320
+bool
2321
+IsExternal(v8::Local<v8::String> str) {
2322
+#if NODE_MODULE_VERSION < ATOM_0_21_MODULE_VERSION
2323
+    return str->IsExternalAscii();
2324
+#else
2325
+    return str->IsExternalOneByte();
2326
+#endif
2327
+}
2328
+
2329
+}  // end of namespace imp
2330
+
2331
+enum Encoding {ASCII, UTF8, BASE64, UCS2, BINARY, HEX, BUFFER};
2332
+
2333
+#if NODE_MODULE_VERSION < NODE_0_10_MODULE_VERSION
2334
+# include "nan_string_bytes.h"  // NOLINT(build/include)
2335
+#endif
2336
+
2337
+inline v8::Local<v8::Value> Encode(
2338
+    const void *buf, size_t len, enum Encoding encoding = BINARY) {
2339
+#if (NODE_MODULE_VERSION >= ATOM_0_21_MODULE_VERSION)
2340
+  v8::Isolate* isolate = v8::Isolate::GetCurrent();
2341
+  node::encoding node_enc = static_cast<node::encoding>(encoding);
2342
+
2343
+  if (encoding == UCS2) {
2344
+    return node::Encode(
2345
+        isolate
2346
+      , reinterpret_cast<const uint16_t *>(buf)
2347
+      , len / 2);
2348
+  } else {
2349
+    return node::Encode(
2350
+        isolate
2351
+      , reinterpret_cast<const char *>(buf)
2352
+      , len
2353
+      , node_enc);
2354
+  }
2355
+#elif (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)
2356
+  return node::Encode(
2357
+      v8::Isolate::GetCurrent()
2358
+    , buf, len
2359
+    , static_cast<node::encoding>(encoding));
2360
+#else
2361
+# if NODE_MODULE_VERSION >= NODE_0_10_MODULE_VERSION
2362
+  return node::Encode(buf, len, static_cast<node::encoding>(encoding));
2363
+# else
2364
+  return imp::Encode(reinterpret_cast<const char*>(buf), len, encoding);
2365
+# endif
2366
+#endif
2367
+}
2368
+
2369
+inline ssize_t DecodeBytes(
2370
+    v8::Local<v8::Value> val, enum Encoding encoding = BINARY) {
2371
+#if (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)
2372
+  return node::DecodeBytes(
2373
+      v8::Isolate::GetCurrent()
2374
+    , val
2375
+    , static_cast<node::encoding>(encoding));
2376
+#else
2377
+# if (NODE_MODULE_VERSION < NODE_0_10_MODULE_VERSION)
2378
+  if (encoding == BUFFER) {
2379
+    return node::DecodeBytes(val, node::BINARY);
2380
+  }
2381
+# endif
2382
+  return node::DecodeBytes(val, static_cast<node::encoding>(encoding));
2383
+#endif
2384
+}
2385
+
2386
+inline ssize_t DecodeWrite(
2387
+    char *buf
2388
+  , size_t len
2389
+  , v8::Local<v8::Value> val
2390
+  , enum Encoding encoding = BINARY) {
2391
+#if (NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION)
2392
+  return node::DecodeWrite(
2393
+      v8::Isolate::GetCurrent()
2394
+    , buf
2395
+    , len
2396
+    , val
2397
+    , static_cast<node::encoding>(encoding));
2398
+#else
2399
+# if (NODE_MODULE_VERSION < NODE_0_10_MODULE_VERSION)
2400
+  if (encoding == BUFFER) {
2401
+    return node::DecodeWrite(buf, len, val, node::BINARY);
2402
+  }
2403
+# endif
2404
+  return node::DecodeWrite(
2405
+      buf
2406
+    , len
2407
+    , val
2408
+    , static_cast<node::encoding>(encoding));
2409
+#endif
2410
+}
2411
+
2412
+inline void SetPrototypeTemplate(
2413
+    v8::Local<v8::FunctionTemplate> templ
2414
+  , const char *name
2415
+  , v8::Local<v8::Data> value
2416
+) {
2417
+  HandleScope scope;
2418
+  SetTemplate(templ->PrototypeTemplate(), name, value);
2419
+}
2420
+
2421
+inline void SetPrototypeTemplate(
2422
+    v8::Local<v8::FunctionTemplate> templ
2423
+  , v8::Local<v8::String> name
2424
+  , v8::Local<v8::Data> value
2425
+  , v8::PropertyAttribute attributes
2426
+) {
2427
+  HandleScope scope;
2428
+  SetTemplate(templ->PrototypeTemplate(), name, value, attributes);
2429
+}
2430
+
2431
+inline void SetInstanceTemplate(
2432
+    v8::Local<v8::FunctionTemplate> templ
2433
+  , const char *name
2434
+  , v8::Local<v8::Data> value
2435
+) {
2436
+  HandleScope scope;
2437
+  SetTemplate(templ->InstanceTemplate(), name, value);
2438
+}
2439
+
2440
+inline void SetInstanceTemplate(
2441
+    v8::Local<v8::FunctionTemplate> templ
2442
+  , v8::Local<v8::String> name
2443
+  , v8::Local<v8::Data> value
2444
+  , v8::PropertyAttribute attributes
2445
+) {
2446
+  HandleScope scope;
2447
+  SetTemplate(templ->InstanceTemplate(), name, value, attributes);
2448
+}
2449
+
2450
+namespace imp {
2451
+
2452
+// Note(@agnat): Helper to distinguish different receiver types. The first
2453
+// version deals with receivers derived from v8::Template. The second version
2454
+// handles everything else. The final argument only serves as discriminator and
2455
+// is unused.
2456
+template <typename T>
2457
+inline
2458
+void
2459
+SetMethodAux(T recv,
2460
+             v8::Local<v8::String> name,
2461
+             v8::Local<v8::FunctionTemplate> tpl,
2462
+             v8::Template *) {
2463
+  recv->Set(name, tpl);
2464
+}
2465
+
2466
+template <typename T>
2467
+inline
2468
+void
2469
+SetMethodAux(T recv,
2470
+             v8::Local<v8::String> name,
2471
+             v8::Local<v8::FunctionTemplate> tpl,
2472
+             ...) {
2473
+  Set(recv, name, GetFunction(tpl).ToLocalChecked());
2474
+}
2475
+
2476
+}  // end of namespace imp
2477
+
2478
+template <typename T, template <typename> class HandleType>
2479
+inline void SetMethod(
2480
+    HandleType<T> recv
2481
+  , const char *name
2482
+  , FunctionCallback callback
2483
+  , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
2484
+  HandleScope scope;
2485
+  v8::Local<v8::FunctionTemplate> t = New<v8::FunctionTemplate>(callback, data);
2486
+  v8::Local<v8::String> fn_name = New(name).ToLocalChecked();
2487
+  t->SetClassName(fn_name);
2488
+  // Note(@agnat): Pass an empty T* as discriminator. See note on
2489
+  // SetMethodAux(...) above
2490
+  imp::SetMethodAux(recv, fn_name, t, static_cast<T*>(0));
2491
+}
2492
+
2493
+inline void SetPrototypeMethod(
2494
+    v8::Local<v8::FunctionTemplate> recv
2495
+  , const char* name
2496
+  , FunctionCallback callback
2497
+  , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
2498
+  HandleScope scope;
2499
+  v8::Local<v8::FunctionTemplate> t = New<v8::FunctionTemplate>(
2500
+      callback
2501
+    , data
2502
+    , New<v8::Signature>(recv));
2503
+  v8::Local<v8::String> fn_name = New(name).ToLocalChecked();
2504
+  recv->PrototypeTemplate()->Set(fn_name, t);
2505
+  t->SetClassName(fn_name);
2506
+}
2507
+
2508
+//=== Accessors and Such =======================================================
2509
+
2510
+inline void SetAccessor(
2511
+    v8::Local<v8::ObjectTemplate> tpl
2512
+  , v8::Local<v8::String> name
2513
+  , GetterCallback getter
2514
+  , SetterCallback setter = 0
2515
+  , v8::Local<v8::Value> data = v8::Local<v8::Value>()
2516
+  , v8::AccessControl settings = v8::DEFAULT
2517
+  , v8::PropertyAttribute attribute = v8::None
2518
+  , imp::Sig signature = imp::Sig()) {
2519
+  HandleScope scope;
2520
+
2521
+  imp::NativeGetter getter_ =
2522
+      imp::GetterCallbackWrapper;
2523
+  imp::NativeSetter setter_ =
2524
+      setter ? imp::SetterCallbackWrapper : 0;
2525
+
2526
+  v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
2527
+  otpl->SetInternalFieldCount(imp::kAccessorFieldCount);
2528
+  v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
2529
+
2530
+  obj->SetInternalField(
2531
+      imp::kGetterIndex
2532
+    , New<v8::External>(reinterpret_cast<void *>(getter)));
2533
+
2534
+  if (setter != 0) {
2535
+    obj->SetInternalField(
2536
+        imp::kSetterIndex
2537
+      , New<v8::External>(reinterpret_cast<void *>(setter)));
2538
+  }
2539
+
2540
+  if (!data.IsEmpty()) {
2541
+    obj->SetInternalField(imp::kDataIndex, data);
2542
+  }
2543
+
2544
+  tpl->SetAccessor(
2545
+      name
2546
+    , getter_
2547
+    , setter_
2548
+    , obj
2549
+    , settings
2550
+    , attribute
2551
+    , signature);
2552
+}
2553
+
2554
+inline bool SetAccessor(
2555
+    v8::Local<v8::Object> obj
2556
+  , v8::Local<v8::String> name
2557
+  , GetterCallback getter
2558
+  , SetterCallback setter = 0
2559
+  , v8::Local<v8::Value> data = v8::Local<v8::Value>()
2560
+  , v8::AccessControl settings = v8::DEFAULT
2561
+  , v8::PropertyAttribute attribute = v8::None) {
2562
+  HandleScope scope;
2563
+
2564
+  imp::NativeGetter getter_ =
2565
+      imp::GetterCallbackWrapper;
2566
+  imp::NativeSetter setter_ =
2567
+      setter ? imp::SetterCallbackWrapper : 0;
2568
+
2569
+  v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
2570
+  otpl->SetInternalFieldCount(imp::kAccessorFieldCount);
2571
+  v8::Local<v8::Object> dataobj = NewInstance(otpl).ToLocalChecked();
2572
+
2573
+  dataobj->SetInternalField(
2574
+      imp::kGetterIndex
2575
+    , New<v8::External>(reinterpret_cast<void *>(getter)));
2576
+
2577
+  if (!data.IsEmpty()) {
2578
+    dataobj->SetInternalField(imp::kDataIndex, data);
2579
+  }
2580
+
2581
+  if (setter) {
2582
+    dataobj->SetInternalField(
2583
+        imp::kSetterIndex
2584
+      , New<v8::External>(reinterpret_cast<void *>(setter)));
2585
+  }
2586
+
2587
+#if (NODE_MODULE_VERSION >= NODE_6_0_MODULE_VERSION)
2588
+  return obj->SetAccessor(
2589
+      GetCurrentContext()
2590
+    , name
2591
+    , getter_
2592
+    , setter_
2593
+    , dataobj
2594
+    , settings
2595
+    , attribute).FromMaybe(false);
2596
+#else
2597
+  return obj->SetAccessor(
2598
+      name
2599
+    , getter_
2600
+    , setter_
2601
+    , dataobj
2602
+    , settings
2603
+    , attribute);
2604
+#endif
2605
+}
2606
+
2607
+inline void SetNamedPropertyHandler(
2608
+    v8::Local<v8::ObjectTemplate> tpl
2609
+  , PropertyGetterCallback getter
2610
+  , PropertySetterCallback setter = 0
2611
+  , PropertyQueryCallback query = 0
2612
+  , PropertyDeleterCallback deleter = 0
2613
+  , PropertyEnumeratorCallback enumerator = 0
2614
+  , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
2615
+  HandleScope scope;
2616
+
2617
+  imp::NativePropertyGetter getter_ =
2618
+      imp::PropertyGetterCallbackWrapper;
2619
+  imp::NativePropertySetter setter_ =
2620
+      setter ? imp::PropertySetterCallbackWrapper : 0;
2621
+  imp::NativePropertyQuery query_ =
2622
+      query ? imp::PropertyQueryCallbackWrapper : 0;
2623
+  imp::NativePropertyDeleter *deleter_ =
2624
+      deleter ? imp::PropertyDeleterCallbackWrapper : 0;
2625
+  imp::NativePropertyEnumerator enumerator_ =
2626
+      enumerator ? imp::PropertyEnumeratorCallbackWrapper : 0;
2627
+
2628
+  v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
2629
+  otpl->SetInternalFieldCount(imp::kPropertyFieldCount);
2630
+  v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
2631
+  obj->SetInternalField(
2632
+      imp::kPropertyGetterIndex
2633
+    , New<v8::External>(reinterpret_cast<void *>(getter)));
2634
+
2635
+  if (setter) {
2636
+    obj->SetInternalField(
2637
+        imp::kPropertySetterIndex
2638
+      , New<v8::External>(reinterpret_cast<void *>(setter)));
2639
+  }
2640
+
2641
+  if (query) {
2642
+    obj->SetInternalField(
2643
+        imp::kPropertyQueryIndex
2644
+      , New<v8::External>(reinterpret_cast<void *>(query)));
2645
+  }
2646
+
2647
+  if (deleter) {
2648
+    obj->SetInternalField(
2649
+        imp::kPropertyDeleterIndex
2650
+      , New<v8::External>(reinterpret_cast<void *>(deleter)));
2651
+  }
2652
+
2653
+  if (enumerator) {
2654
+    obj->SetInternalField(
2655
+        imp::kPropertyEnumeratorIndex
2656
+      , New<v8::External>(reinterpret_cast<void *>(enumerator)));
2657
+  }
2658
+
2659
+  if (!data.IsEmpty()) {
2660
+    obj->SetInternalField(imp::kDataIndex, data);
2661
+  }
2662
+
2663
+#if NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
2664
+  tpl->SetHandler(v8::NamedPropertyHandlerConfiguration(
2665
+      getter_, setter_, query_, deleter_, enumerator_, obj));
2666
+#else
2667
+  tpl->SetNamedPropertyHandler(
2668
+      getter_
2669
+    , setter_
2670
+    , query_
2671
+    , deleter_
2672
+    , enumerator_
2673
+    , obj);
2674
+#endif
2675
+}
2676
+
2677
+inline void SetIndexedPropertyHandler(
2678
+    v8::Local<v8::ObjectTemplate> tpl
2679
+  , IndexGetterCallback getter
2680
+  , IndexSetterCallback setter = 0
2681
+  , IndexQueryCallback query = 0
2682
+  , IndexDeleterCallback deleter = 0
2683
+  , IndexEnumeratorCallback enumerator = 0
2684
+  , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
2685
+  HandleScope scope;
2686
+
2687
+  imp::NativeIndexGetter getter_ =
2688
+      imp::IndexGetterCallbackWrapper;
2689
+  imp::NativeIndexSetter setter_ =
2690
+      setter ? imp::IndexSetterCallbackWrapper : 0;
2691
+  imp::NativeIndexQuery query_ =
2692
+      query ? imp::IndexQueryCallbackWrapper : 0;
2693
+  imp::NativeIndexDeleter deleter_ =
2694
+      deleter ? imp::IndexDeleterCallbackWrapper : 0;
2695
+  imp::NativeIndexEnumerator enumerator_ =
2696
+      enumerator ? imp::IndexEnumeratorCallbackWrapper : 0;
2697
+
2698
+  v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
2699
+  otpl->SetInternalFieldCount(imp::kIndexPropertyFieldCount);
2700
+  v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
2701
+  obj->SetInternalField(
2702
+      imp::kIndexPropertyGetterIndex
2703
+    , New<v8::External>(reinterpret_cast<void *>(getter)));
2704
+
2705
+  if (setter) {
2706
+    obj->SetInternalField(
2707
+        imp::kIndexPropertySetterIndex
2708
+      , New<v8::External>(reinterpret_cast<void *>(setter)));
2709
+  }
2710
+
2711
+  if (query) {
2712
+    obj->SetInternalField(
2713
+        imp::kIndexPropertyQueryIndex
2714
+      , New<v8::External>(reinterpret_cast<void *>(query)));
2715
+  }
2716
+
2717
+  if (deleter) {
2718
+    obj->SetInternalField(
2719
+        imp::kIndexPropertyDeleterIndex
2720
+      , New<v8::External>(reinterpret_cast<void *>(deleter)));
2721
+  }
2722
+
2723
+  if (enumerator) {
2724
+    obj->SetInternalField(
2725
+        imp::kIndexPropertyEnumeratorIndex
2726
+      , New<v8::External>(reinterpret_cast<void *>(enumerator)));
2727
+  }
2728
+
2729
+  if (!data.IsEmpty()) {
2730
+    obj->SetInternalField(imp::kDataIndex, data);
2731
+  }
2732
+
2733
+#if NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
2734
+  tpl->SetHandler(v8::IndexedPropertyHandlerConfiguration(
2735
+      getter_, setter_, query_, deleter_, enumerator_, obj));
2736
+#else
2737
+  tpl->SetIndexedPropertyHandler(
2738
+      getter_
2739
+    , setter_
2740
+    , query_
2741
+    , deleter_
2742
+    , enumerator_
2743
+    , obj);
2744
+#endif
2745
+}
2746
+
2747
+inline void SetCallHandler(
2748
+    v8::Local<v8::FunctionTemplate> tpl
2749
+  , FunctionCallback callback
2750
+  , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
2751
+  HandleScope scope;
2752
+
2753
+  v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
2754
+  otpl->SetInternalFieldCount(imp::kFunctionFieldCount);
2755
+  v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
2756
+
2757
+  obj->SetInternalField(
2758
+      imp::kFunctionIndex
2759
+    , New<v8::External>(reinterpret_cast<void *>(callback)));
2760
+
2761
+  if (!data.IsEmpty()) {
2762
+    obj->SetInternalField(imp::kDataIndex, data);
2763
+  }
2764
+
2765
+  tpl->SetCallHandler(imp::FunctionCallbackWrapper, obj);
2766
+}
2767
+
2768
+
2769
+inline void SetCallAsFunctionHandler(
2770
+    v8::Local<v8::ObjectTemplate> tpl,
2771
+    FunctionCallback callback,
2772
+    v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
2773
+  HandleScope scope;
2774
+
2775
+  v8::Local<v8::ObjectTemplate> otpl = New<v8::ObjectTemplate>();
2776
+  otpl->SetInternalFieldCount(imp::kFunctionFieldCount);
2777
+  v8::Local<v8::Object> obj = NewInstance(otpl).ToLocalChecked();
2778
+
2779
+  obj->SetInternalField(
2780
+      imp::kFunctionIndex
2781
+    , New<v8::External>(reinterpret_cast<void *>(callback)));
2782
+
2783
+  if (!data.IsEmpty()) {
2784
+    obj->SetInternalField(imp::kDataIndex, data);
2785
+  }
2786
+
2787
+  tpl->SetCallAsFunctionHandler(imp::FunctionCallbackWrapper, obj);
2788
+}
2789
+
2790
+//=== Weak Persistent Handling =================================================
2791
+
2792
+#include "nan_weak.h"  // NOLINT(build/include)
2793
+
2794
+//=== ObjectWrap ===============================================================
2795
+
2796
+#include "nan_object_wrap.h"  // NOLINT(build/include)
2797
+
2798
+//=== HiddenValue/Private ======================================================
2799
+
2800
+#include "nan_private.h"  // NOLINT(build/include)
2801
+
2802
+//=== Export ==================================================================
2803
+
2804
+inline
2805
+void
2806
+Export(ADDON_REGISTER_FUNCTION_ARGS_TYPE target, const char *name,
2807
+    FunctionCallback f) {
2808
+  HandleScope scope;
2809
+
2810
+  Set(target, New<v8::String>(name).ToLocalChecked(),
2811
+      GetFunction(New<v8::FunctionTemplate>(f)).ToLocalChecked());
2812
+}
2813
+
2814
+//=== Tap Reverse Binding =====================================================
2815
+
2816
+struct Tap {
2817
+  explicit Tap(v8::Local<v8::Value> t) : t_() {
2818
+    HandleScope scope;
2819
+
2820
+    t_.Reset(To<v8::Object>(t).ToLocalChecked());
2821
+  }
2822
+
2823
+  ~Tap() { t_.Reset(); }  // not sure if necessary
2824
+
2825
+  inline void plan(int i) {
2826
+    HandleScope scope;
2827
+    v8::Local<v8::Value> arg = New(i);
2828
+    Call("plan", New(t_), 1, &arg);
2829
+  }
2830
+
2831
+  inline void ok(bool isOk, const char *msg = NULL) {
2832
+    HandleScope scope;
2833
+    v8::Local<v8::Value> args[2];
2834
+    args[0] = New(isOk);
2835
+    if (msg) args[1] = New(msg).ToLocalChecked();
2836
+    Call("ok", New(t_), msg ? 2 : 1, args);
2837
+  }
2838
+
2839
+  inline void pass(const char * msg = NULL) {
2840
+    HandleScope scope;
2841
+    v8::Local<v8::Value> hmsg;
2842
+    if (msg) hmsg = New(msg).ToLocalChecked();
2843
+    Call("pass", New(t_), msg ? 1 : 0, &hmsg);
2844
+  }
2845
+
2846
+  inline void end() {
2847
+    HandleScope scope;
2848
+    Call("end", New(t_), 0, NULL);
2849
+  }
2850
+
2851
+ private:
2852
+  Persistent<v8::Object> t_;
2853
+};
2854
+
2855
+#define NAN_STRINGIZE2(x) #x
2856
+#define NAN_STRINGIZE(x) NAN_STRINGIZE2(x)
2857
+#define NAN_TEST_EXPRESSION(expression) \
2858
+  ( expression ), __FILE__ ":" NAN_STRINGIZE(__LINE__) ": " #expression
2859
+
2860
+#define NAN_EXPORT(target, function) Export(target, #function, function)
2861
+
2862
+#undef TYPE_CHECK
2863
+
2864
+//=== Generic Maybefication ===================================================
2865
+
2866
+namespace imp {
2867
+
2868
+template <typename T> struct Maybefier;
2869
+
2870
+template <typename T> struct Maybefier<v8::Local<T> > {
2871
+  inline static MaybeLocal<T> convert(v8::Local<T> v) {
2872
+    return v;
2873
+  }
2874
+};
2875
+
2876
+template <typename T> struct Maybefier<MaybeLocal<T> > {
2877
+  inline static MaybeLocal<T> convert(MaybeLocal<T> v) {
2878
+    return v;
2879
+  }
2880
+};
2881
+
2882
+}  // end of namespace imp
2883
+
2884
+template <typename T, template <typename> class MaybeMaybe>
2885
+inline MaybeLocal<T>
2886
+MakeMaybe(MaybeMaybe<T> v) {
2887
+  return imp::Maybefier<MaybeMaybe<T> >::convert(v);
2888
+}
2889
+
2890
+//=== TypedArrayContents =======================================================
2891
+
2892
+#include "nan_typedarray_contents.h"  // NOLINT(build/include)
2893
+
2894
+//=== JSON =====================================================================
2895
+
2896
+#include "nan_json.h"  // NOLINT(build/include)
2897
+
2898
+//=== ScriptOrigin =============================================================
2899
+
2900
+#include "nan_scriptorigin.h"  // NOLINT(build/include)
2901
+
2902
+}  // end of namespace Nan
2903
+
2904
+#endif  // NAN_H_
... ...
@@ -0,0 +1,88 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_CALLBACKS_H_
10
+#define NAN_CALLBACKS_H_
11
+
12
+template<typename T> class FunctionCallbackInfo;
13
+template<typename T> class PropertyCallbackInfo;
14
+template<typename T> class Global;
15
+
16
+typedef void(*FunctionCallback)(const FunctionCallbackInfo<v8::Value>&);
17
+typedef void(*GetterCallback)
18
+    (v8::Local<v8::String>, const PropertyCallbackInfo<v8::Value>&);
19
+typedef void(*SetterCallback)(
20
+    v8::Local<v8::String>,
21
+    v8::Local<v8::Value>,
22
+    const PropertyCallbackInfo<void>&);
23
+typedef void(*PropertyGetterCallback)(
24
+    v8::Local<v8::String>,
25
+    const PropertyCallbackInfo<v8::Value>&);
26
+typedef void(*PropertySetterCallback)(
27
+    v8::Local<v8::String>,
28
+    v8::Local<v8::Value>,
29
+    const PropertyCallbackInfo<v8::Value>&);
30
+typedef void(*PropertyEnumeratorCallback)
31
+    (const PropertyCallbackInfo<v8::Array>&);
32
+typedef void(*PropertyDeleterCallback)(
33
+    v8::Local<v8::String>,
34
+    const PropertyCallbackInfo<v8::Boolean>&);
35
+typedef void(*PropertyQueryCallback)(
36
+    v8::Local<v8::String>,
37
+    const PropertyCallbackInfo<v8::Integer>&);
38
+typedef void(*IndexGetterCallback)(
39
+    uint32_t,
40
+    const PropertyCallbackInfo<v8::Value>&);
41
+typedef void(*IndexSetterCallback)(
42
+    uint32_t,
43
+    v8::Local<v8::Value>,
44
+    const PropertyCallbackInfo<v8::Value>&);
45
+typedef void(*IndexEnumeratorCallback)
46
+    (const PropertyCallbackInfo<v8::Array>&);
47
+typedef void(*IndexDeleterCallback)(
48
+    uint32_t,
49
+    const PropertyCallbackInfo<v8::Boolean>&);
50
+typedef void(*IndexQueryCallback)(
51
+    uint32_t,
52
+    const PropertyCallbackInfo<v8::Integer>&);
53
+
54
+namespace imp {
55
+typedef v8::Local<v8::AccessorSignature> Sig;
56
+
57
+static const int kDataIndex =                    0;
58
+
59
+static const int kFunctionIndex =                1;
60
+static const int kFunctionFieldCount =           2;
61
+
62
+static const int kGetterIndex =                  1;
63
+static const int kSetterIndex =                  2;
64
+static const int kAccessorFieldCount =           3;
65
+
66
+static const int kPropertyGetterIndex =          1;
67
+static const int kPropertySetterIndex =          2;
68
+static const int kPropertyEnumeratorIndex =      3;
69
+static const int kPropertyDeleterIndex =         4;
70
+static const int kPropertyQueryIndex =           5;
71
+static const int kPropertyFieldCount =           6;
72
+
73
+static const int kIndexPropertyGetterIndex =     1;
74
+static const int kIndexPropertySetterIndex =     2;
75
+static const int kIndexPropertyEnumeratorIndex = 3;
76
+static const int kIndexPropertyDeleterIndex =    4;
77
+static const int kIndexPropertyQueryIndex =      5;
78
+static const int kIndexPropertyFieldCount =      6;
79
+
80
+}  // end of namespace imp
81
+
82
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
83
+# include "nan_callbacks_12_inl.h"  // NOLINT(build/include)
84
+#else
85
+# include "nan_callbacks_pre_12_inl.h"  // NOLINT(build/include)
86
+#endif
87
+
88
+#endif  // NAN_CALLBACKS_H_
... ...
@@ -0,0 +1,514 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_CALLBACKS_12_INL_H_
10
+#define NAN_CALLBACKS_12_INL_H_
11
+
12
+template<typename T>
13
+class ReturnValue {
14
+  v8::ReturnValue<T> value_;
15
+
16
+ public:
17
+  template <class S>
18
+  explicit inline ReturnValue(const v8::ReturnValue<S> &value) :
19
+      value_(value) {}
20
+  template <class S>
21
+  explicit inline ReturnValue(const ReturnValue<S>& that)
22
+      : value_(that.value_) {
23
+    TYPE_CHECK(T, S);
24
+  }
25
+
26
+  // Handle setters
27
+  template <typename S> inline void Set(const v8::Local<S> &handle) {
28
+    TYPE_CHECK(T, S);
29
+    value_.Set(handle);
30
+  }
31
+
32
+  template <typename S> inline void Set(const Global<S> &handle) {
33
+    TYPE_CHECK(T, S);
34
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
35
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) &&                       \
36
+  (V8_MINOR_VERSION > 5 || (V8_MINOR_VERSION == 5 &&                           \
37
+  defined(V8_BUILD_NUMBER) && V8_BUILD_NUMBER >= 8))))
38
+    value_.Set(handle);
39
+#else
40
+    value_.Set(*reinterpret_cast<const v8::Persistent<S>*>(&handle));
41
+    const_cast<Global<S> &>(handle).Reset();
42
+#endif
43
+  }
44
+
45
+  // Fast primitive setters
46
+  inline void Set(bool value) {
47
+    TYPE_CHECK(T, v8::Boolean);
48
+    value_.Set(value);
49
+  }
50
+
51
+  inline void Set(double i) {
52
+    TYPE_CHECK(T, v8::Number);
53
+    value_.Set(i);
54
+  }
55
+
56
+  inline void Set(int32_t i) {
57
+    TYPE_CHECK(T, v8::Integer);
58
+    value_.Set(i);
59
+  }
60
+
61
+  inline void Set(uint32_t i) {
62
+    TYPE_CHECK(T, v8::Integer);
63
+    value_.Set(i);
64
+  }
65
+
66
+  // Fast JS primitive setters
67
+  inline void SetNull() {
68
+    TYPE_CHECK(T, v8::Primitive);
69
+    value_.SetNull();
70
+  }
71
+
72
+  inline void SetUndefined() {
73
+    TYPE_CHECK(T, v8::Primitive);
74
+    value_.SetUndefined();
75
+  }
76
+
77
+  inline void SetEmptyString() {
78
+    TYPE_CHECK(T, v8::String);
79
+    value_.SetEmptyString();
80
+  }
81
+
82
+  // Convenience getter for isolate
83
+  inline v8::Isolate *GetIsolate() const {
84
+    return value_.GetIsolate();
85
+  }
86
+
87
+  // Pointer setter: Uncompilable to prevent inadvertent misuse.
88
+  template<typename S>
89
+  inline void Set(S *whatever) { TYPE_CHECK(S*, v8::Primitive); }
90
+};
91
+
92
+template<typename T>
93
+class FunctionCallbackInfo {
94
+  const v8::FunctionCallbackInfo<T> &info_;
95
+  const v8::Local<v8::Value> data_;
96
+
97
+ public:
98
+  explicit inline FunctionCallbackInfo(
99
+      const v8::FunctionCallbackInfo<T> &info
100
+    , v8::Local<v8::Value> data) :
101
+          info_(info)
102
+        , data_(data) {}
103
+
104
+  inline ReturnValue<T> GetReturnValue() const {
105
+    return ReturnValue<T>(info_.GetReturnValue());
106
+  }
107
+
108
+#if NODE_MAJOR_VERSION < 10
109
+  inline v8::Local<v8::Function> Callee() const { return info_.Callee(); }
110
+#endif
111
+  inline v8::Local<v8::Value> Data() const { return data_; }
112
+  inline v8::Local<v8::Object> Holder() const { return info_.Holder(); }
113
+  inline bool IsConstructCall() const { return info_.IsConstructCall(); }
114
+  inline int Length() const { return info_.Length(); }
115
+  inline v8::Local<v8::Value> operator[](int i) const { return info_[i]; }
116
+  inline v8::Local<v8::Object> This() const { return info_.This(); }
117
+  inline v8::Isolate *GetIsolate() const { return info_.GetIsolate(); }
118
+
119
+
120
+ protected:
121
+  static const int kHolderIndex = 0;
122
+  static const int kIsolateIndex = 1;
123
+  static const int kReturnValueDefaultValueIndex = 2;
124
+  static const int kReturnValueIndex = 3;
125
+  static const int kDataIndex = 4;
126
+  static const int kCalleeIndex = 5;
127
+  static const int kContextSaveIndex = 6;
128
+  static const int kArgsLength = 7;
129
+
130
+ private:
131
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(FunctionCallbackInfo)
132
+};
133
+
134
+template<typename T>
135
+class PropertyCallbackInfo {
136
+  const v8::PropertyCallbackInfo<T> &info_;
137
+  const v8::Local<v8::Value> data_;
138
+
139
+ public:
140
+  explicit inline PropertyCallbackInfo(
141
+      const v8::PropertyCallbackInfo<T> &info
142
+    , const v8::Local<v8::Value> data) :
143
+          info_(info)
144
+        , data_(data) {}
145
+
146
+  inline v8::Isolate* GetIsolate() const { return info_.GetIsolate(); }
147
+  inline v8::Local<v8::Value> Data() const { return data_; }
148
+  inline v8::Local<v8::Object> This() const { return info_.This(); }
149
+  inline v8::Local<v8::Object> Holder() const { return info_.Holder(); }
150
+  inline ReturnValue<T> GetReturnValue() const {
151
+    return ReturnValue<T>(info_.GetReturnValue());
152
+  }
153
+
154
+ protected:
155
+  static const int kHolderIndex = 0;
156
+  static const int kIsolateIndex = 1;
157
+  static const int kReturnValueDefaultValueIndex = 2;
158
+  static const int kReturnValueIndex = 3;
159
+  static const int kDataIndex = 4;
160
+  static const int kThisIndex = 5;
161
+  static const int kArgsLength = 6;
162
+
163
+ private:
164
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(PropertyCallbackInfo)
165
+};
166
+
167
+namespace imp {
168
+static
169
+void FunctionCallbackWrapper(const v8::FunctionCallbackInfo<v8::Value> &info) {
170
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
171
+  FunctionCallback callback = reinterpret_cast<FunctionCallback>(
172
+      reinterpret_cast<intptr_t>(
173
+          obj->GetInternalField(kFunctionIndex).As<v8::External>()->Value()));
174
+  FunctionCallbackInfo<v8::Value>
175
+      cbinfo(info, obj->GetInternalField(kDataIndex));
176
+  callback(cbinfo);
177
+}
178
+
179
+typedef void (*NativeFunction)(const v8::FunctionCallbackInfo<v8::Value> &);
180
+
181
+#if NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
182
+static
183
+void GetterCallbackWrapper(
184
+    v8::Local<v8::Name> property
185
+  , const v8::PropertyCallbackInfo<v8::Value> &info) {
186
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
187
+  PropertyCallbackInfo<v8::Value>
188
+      cbinfo(info, obj->GetInternalField(kDataIndex));
189
+  GetterCallback callback = reinterpret_cast<GetterCallback>(
190
+      reinterpret_cast<intptr_t>(
191
+          obj->GetInternalField(kGetterIndex).As<v8::External>()->Value()));
192
+  callback(property.As<v8::String>(), cbinfo);
193
+}
194
+
195
+typedef void (*NativeGetter)
196
+    (v8::Local<v8::Name>, const v8::PropertyCallbackInfo<v8::Value> &);
197
+
198
+static
199
+void SetterCallbackWrapper(
200
+    v8::Local<v8::Name> property
201
+  , v8::Local<v8::Value> value
202
+  , const v8::PropertyCallbackInfo<void> &info) {
203
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
204
+  PropertyCallbackInfo<void>
205
+      cbinfo(info, obj->GetInternalField(kDataIndex));
206
+  SetterCallback callback = reinterpret_cast<SetterCallback>(
207
+      reinterpret_cast<intptr_t>(
208
+          obj->GetInternalField(kSetterIndex).As<v8::External>()->Value()));
209
+  callback(property.As<v8::String>(), value, cbinfo);
210
+}
211
+
212
+typedef void (*NativeSetter)(
213
+    v8::Local<v8::Name>
214
+  , v8::Local<v8::Value>
215
+  , const v8::PropertyCallbackInfo<void> &);
216
+#else
217
+static
218
+void GetterCallbackWrapper(
219
+    v8::Local<v8::String> property
220
+  , const v8::PropertyCallbackInfo<v8::Value> &info) {
221
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
222
+  PropertyCallbackInfo<v8::Value>
223
+      cbinfo(info, obj->GetInternalField(kDataIndex));
224
+  GetterCallback callback = reinterpret_cast<GetterCallback>(
225
+      reinterpret_cast<intptr_t>(
226
+          obj->GetInternalField(kGetterIndex).As<v8::External>()->Value()));
227
+  callback(property, cbinfo);
228
+}
229
+
230
+typedef void (*NativeGetter)
231
+    (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Value> &);
232
+
233
+static
234
+void SetterCallbackWrapper(
235
+    v8::Local<v8::String> property
236
+  , v8::Local<v8::Value> value
237
+  , const v8::PropertyCallbackInfo<void> &info) {
238
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
239
+  PropertyCallbackInfo<void>
240
+      cbinfo(info, obj->GetInternalField(kDataIndex));
241
+  SetterCallback callback = reinterpret_cast<SetterCallback>(
242
+      reinterpret_cast<intptr_t>(
243
+          obj->GetInternalField(kSetterIndex).As<v8::External>()->Value()));
244
+  callback(property, value, cbinfo);
245
+}
246
+
247
+typedef void (*NativeSetter)(
248
+    v8::Local<v8::String>
249
+  , v8::Local<v8::Value>
250
+  , const v8::PropertyCallbackInfo<void> &);
251
+#endif
252
+
253
+#if NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
254
+static
255
+void PropertyGetterCallbackWrapper(
256
+    v8::Local<v8::Name> property
257
+  , const v8::PropertyCallbackInfo<v8::Value> &info) {
258
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
259
+  PropertyCallbackInfo<v8::Value>
260
+      cbinfo(info, obj->GetInternalField(kDataIndex));
261
+  PropertyGetterCallback callback = reinterpret_cast<PropertyGetterCallback>(
262
+      reinterpret_cast<intptr_t>(
263
+          obj->GetInternalField(kPropertyGetterIndex)
264
+              .As<v8::External>()->Value()));
265
+  callback(property.As<v8::String>(), cbinfo);
266
+}
267
+
268
+typedef void (*NativePropertyGetter)
269
+    (v8::Local<v8::Name>, const v8::PropertyCallbackInfo<v8::Value> &);
270
+
271
+static
272
+void PropertySetterCallbackWrapper(
273
+    v8::Local<v8::Name> property
274
+  , v8::Local<v8::Value> value
275
+  , const v8::PropertyCallbackInfo<v8::Value> &info) {
276
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
277
+  PropertyCallbackInfo<v8::Value>
278
+      cbinfo(info, obj->GetInternalField(kDataIndex));
279
+  PropertySetterCallback callback = reinterpret_cast<PropertySetterCallback>(
280
+      reinterpret_cast<intptr_t>(
281
+          obj->GetInternalField(kPropertySetterIndex)
282
+              .As<v8::External>()->Value()));
283
+  callback(property.As<v8::String>(), value, cbinfo);
284
+}
285
+
286
+typedef void (*NativePropertySetter)(
287
+    v8::Local<v8::Name>
288
+  , v8::Local<v8::Value>
289
+  , const v8::PropertyCallbackInfo<v8::Value> &);
290
+
291
+static
292
+void PropertyEnumeratorCallbackWrapper(
293
+    const v8::PropertyCallbackInfo<v8::Array> &info) {
294
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
295
+  PropertyCallbackInfo<v8::Array>
296
+      cbinfo(info, obj->GetInternalField(kDataIndex));
297
+  PropertyEnumeratorCallback callback =
298
+      reinterpret_cast<PropertyEnumeratorCallback>(reinterpret_cast<intptr_t>(
299
+          obj->GetInternalField(kPropertyEnumeratorIndex)
300
+              .As<v8::External>()->Value()));
301
+  callback(cbinfo);
302
+}
303
+
304
+typedef void (*NativePropertyEnumerator)
305
+    (const v8::PropertyCallbackInfo<v8::Array> &);
306
+
307
+static
308
+void PropertyDeleterCallbackWrapper(
309
+    v8::Local<v8::Name> property
310
+  , const v8::PropertyCallbackInfo<v8::Boolean> &info) {
311
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
312
+  PropertyCallbackInfo<v8::Boolean>
313
+      cbinfo(info, obj->GetInternalField(kDataIndex));
314
+  PropertyDeleterCallback callback = reinterpret_cast<PropertyDeleterCallback>(
315
+      reinterpret_cast<intptr_t>(
316
+          obj->GetInternalField(kPropertyDeleterIndex)
317
+              .As<v8::External>()->Value()));
318
+  callback(property.As<v8::String>(), cbinfo);
319
+}
320
+
321
+typedef void (NativePropertyDeleter)
322
+    (v8::Local<v8::Name>, const v8::PropertyCallbackInfo<v8::Boolean> &);
323
+
324
+static
325
+void PropertyQueryCallbackWrapper(
326
+    v8::Local<v8::Name> property
327
+  , const v8::PropertyCallbackInfo<v8::Integer> &info) {
328
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
329
+  PropertyCallbackInfo<v8::Integer>
330
+      cbinfo(info, obj->GetInternalField(kDataIndex));
331
+  PropertyQueryCallback callback = reinterpret_cast<PropertyQueryCallback>(
332
+      reinterpret_cast<intptr_t>(
333
+          obj->GetInternalField(kPropertyQueryIndex)
334
+              .As<v8::External>()->Value()));
335
+  callback(property.As<v8::String>(), cbinfo);
336
+}
337
+
338
+typedef void (*NativePropertyQuery)
339
+    (v8::Local<v8::Name>, const v8::PropertyCallbackInfo<v8::Integer> &);
340
+#else
341
+static
342
+void PropertyGetterCallbackWrapper(
343
+    v8::Local<v8::String> property
344
+  , const v8::PropertyCallbackInfo<v8::Value> &info) {
345
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
346
+  PropertyCallbackInfo<v8::Value>
347
+      cbinfo(info, obj->GetInternalField(kDataIndex));
348
+  PropertyGetterCallback callback = reinterpret_cast<PropertyGetterCallback>(
349
+      reinterpret_cast<intptr_t>(
350
+          obj->GetInternalField(kPropertyGetterIndex)
351
+              .As<v8::External>()->Value()));
352
+  callback(property, cbinfo);
353
+}
354
+
355
+typedef void (*NativePropertyGetter)
356
+    (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Value> &);
357
+
358
+static
359
+void PropertySetterCallbackWrapper(
360
+    v8::Local<v8::String> property
361
+  , v8::Local<v8::Value> value
362
+  , const v8::PropertyCallbackInfo<v8::Value> &info) {
363
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
364
+  PropertyCallbackInfo<v8::Value>
365
+      cbinfo(info, obj->GetInternalField(kDataIndex));
366
+  PropertySetterCallback callback = reinterpret_cast<PropertySetterCallback>(
367
+      reinterpret_cast<intptr_t>(
368
+          obj->GetInternalField(kPropertySetterIndex)
369
+              .As<v8::External>()->Value()));
370
+  callback(property, value, cbinfo);
371
+}
372
+
373
+typedef void (*NativePropertySetter)(
374
+    v8::Local<v8::String>
375
+  , v8::Local<v8::Value>
376
+  , const v8::PropertyCallbackInfo<v8::Value> &);
377
+
378
+static
379
+void PropertyEnumeratorCallbackWrapper(
380
+    const v8::PropertyCallbackInfo<v8::Array> &info) {
381
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
382
+  PropertyCallbackInfo<v8::Array>
383
+      cbinfo(info, obj->GetInternalField(kDataIndex));
384
+  PropertyEnumeratorCallback callback =
385
+      reinterpret_cast<PropertyEnumeratorCallback>(reinterpret_cast<intptr_t>(
386
+          obj->GetInternalField(kPropertyEnumeratorIndex)
387
+              .As<v8::External>()->Value()));
388
+  callback(cbinfo);
389
+}
390
+
391
+typedef void (*NativePropertyEnumerator)
392
+    (const v8::PropertyCallbackInfo<v8::Array> &);
393
+
394
+static
395
+void PropertyDeleterCallbackWrapper(
396
+    v8::Local<v8::String> property
397
+  , const v8::PropertyCallbackInfo<v8::Boolean> &info) {
398
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
399
+  PropertyCallbackInfo<v8::Boolean>
400
+      cbinfo(info, obj->GetInternalField(kDataIndex));
401
+  PropertyDeleterCallback callback = reinterpret_cast<PropertyDeleterCallback>(
402
+      reinterpret_cast<intptr_t>(
403
+          obj->GetInternalField(kPropertyDeleterIndex)
404
+              .As<v8::External>()->Value()));
405
+  callback(property, cbinfo);
406
+}
407
+
408
+typedef void (NativePropertyDeleter)
409
+    (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Boolean> &);
410
+
411
+static
412
+void PropertyQueryCallbackWrapper(
413
+    v8::Local<v8::String> property
414
+  , const v8::PropertyCallbackInfo<v8::Integer> &info) {
415
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
416
+  PropertyCallbackInfo<v8::Integer>
417
+      cbinfo(info, obj->GetInternalField(kDataIndex));
418
+  PropertyQueryCallback callback = reinterpret_cast<PropertyQueryCallback>(
419
+      reinterpret_cast<intptr_t>(
420
+          obj->GetInternalField(kPropertyQueryIndex)
421
+              .As<v8::External>()->Value()));
422
+  callback(property, cbinfo);
423
+}
424
+
425
+typedef void (*NativePropertyQuery)
426
+    (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Integer> &);
427
+#endif
428
+
429
+static
430
+void IndexGetterCallbackWrapper(
431
+    uint32_t index, const v8::PropertyCallbackInfo<v8::Value> &info) {
432
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
433
+  PropertyCallbackInfo<v8::Value>
434
+      cbinfo(info, obj->GetInternalField(kDataIndex));
435
+  IndexGetterCallback callback = reinterpret_cast<IndexGetterCallback>(
436
+      reinterpret_cast<intptr_t>(
437
+          obj->GetInternalField(kIndexPropertyGetterIndex)
438
+              .As<v8::External>()->Value()));
439
+  callback(index, cbinfo);
440
+}
441
+
442
+typedef void (*NativeIndexGetter)
443
+    (uint32_t, const v8::PropertyCallbackInfo<v8::Value> &);
444
+
445
+static
446
+void IndexSetterCallbackWrapper(
447
+    uint32_t index
448
+  , v8::Local<v8::Value> value
449
+  , const v8::PropertyCallbackInfo<v8::Value> &info) {
450
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
451
+  PropertyCallbackInfo<v8::Value>
452
+      cbinfo(info, obj->GetInternalField(kDataIndex));
453
+  IndexSetterCallback callback = reinterpret_cast<IndexSetterCallback>(
454
+      reinterpret_cast<intptr_t>(
455
+          obj->GetInternalField(kIndexPropertySetterIndex)
456
+              .As<v8::External>()->Value()));
457
+  callback(index, value, cbinfo);
458
+}
459
+
460
+typedef void (*NativeIndexSetter)(
461
+    uint32_t
462
+  , v8::Local<v8::Value>
463
+  , const v8::PropertyCallbackInfo<v8::Value> &);
464
+
465
+static
466
+void IndexEnumeratorCallbackWrapper(
467
+    const v8::PropertyCallbackInfo<v8::Array> &info) {
468
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
469
+  PropertyCallbackInfo<v8::Array>
470
+      cbinfo(info, obj->GetInternalField(kDataIndex));
471
+  IndexEnumeratorCallback callback = reinterpret_cast<IndexEnumeratorCallback>(
472
+      reinterpret_cast<intptr_t>(
473
+          obj->GetInternalField(
474
+              kIndexPropertyEnumeratorIndex).As<v8::External>()->Value()));
475
+  callback(cbinfo);
476
+}
477
+
478
+typedef void (*NativeIndexEnumerator)
479
+    (const v8::PropertyCallbackInfo<v8::Array> &);
480
+
481
+static
482
+void IndexDeleterCallbackWrapper(
483
+    uint32_t index, const v8::PropertyCallbackInfo<v8::Boolean> &info) {
484
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
485
+  PropertyCallbackInfo<v8::Boolean>
486
+      cbinfo(info, obj->GetInternalField(kDataIndex));
487
+  IndexDeleterCallback callback = reinterpret_cast<IndexDeleterCallback>(
488
+      reinterpret_cast<intptr_t>(
489
+          obj->GetInternalField(kIndexPropertyDeleterIndex)
490
+              .As<v8::External>()->Value()));
491
+  callback(index, cbinfo);
492
+}
493
+
494
+typedef void (*NativeIndexDeleter)
495
+    (uint32_t, const v8::PropertyCallbackInfo<v8::Boolean> &);
496
+
497
+static
498
+void IndexQueryCallbackWrapper(
499
+    uint32_t index, const v8::PropertyCallbackInfo<v8::Integer> &info) {
500
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
501
+  PropertyCallbackInfo<v8::Integer>
502
+      cbinfo(info, obj->GetInternalField(kDataIndex));
503
+  IndexQueryCallback callback = reinterpret_cast<IndexQueryCallback>(
504
+      reinterpret_cast<intptr_t>(
505
+          obj->GetInternalField(kIndexPropertyQueryIndex)
506
+              .As<v8::External>()->Value()));
507
+  callback(index, cbinfo);
508
+}
509
+
510
+typedef void (*NativeIndexQuery)
511
+    (uint32_t, const v8::PropertyCallbackInfo<v8::Integer> &);
512
+}  // end of namespace imp
513
+
514
+#endif  // NAN_CALLBACKS_12_INL_H_
... ...
@@ -0,0 +1,520 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_CALLBACKS_PRE_12_INL_H_
10
+#define NAN_CALLBACKS_PRE_12_INL_H_
11
+
12
+namespace imp {
13
+template<typename T> class ReturnValueImp;
14
+}  // end of namespace imp
15
+
16
+template<typename T>
17
+class ReturnValue {
18
+  v8::Isolate *isolate_;
19
+  v8::Persistent<T> *value_;
20
+  friend class imp::ReturnValueImp<T>;
21
+
22
+ public:
23
+  template <class S>
24
+  explicit inline ReturnValue(v8::Isolate *isolate, v8::Persistent<S> *p) :
25
+      isolate_(isolate), value_(p) {}
26
+  template <class S>
27
+  explicit inline ReturnValue(const ReturnValue<S>& that)
28
+      : isolate_(that.isolate_), value_(that.value_) {
29
+    TYPE_CHECK(T, S);
30
+  }
31
+
32
+  // Handle setters
33
+  template <typename S> inline void Set(const v8::Local<S> &handle) {
34
+    TYPE_CHECK(T, S);
35
+    value_->Dispose();
36
+    *value_ = v8::Persistent<T>::New(handle);
37
+  }
38
+
39
+  template <typename S> inline void Set(const Global<S> &handle) {
40
+    TYPE_CHECK(T, S);
41
+    value_->Dispose();
42
+    *value_ = v8::Persistent<T>::New(handle.persistent);
43
+    const_cast<Global<S> &>(handle).Reset();
44
+  }
45
+
46
+  // Fast primitive setters
47
+  inline void Set(bool value) {
48
+    v8::HandleScope scope;
49
+
50
+    TYPE_CHECK(T, v8::Boolean);
51
+    value_->Dispose();
52
+    *value_ = v8::Persistent<T>::New(v8::Boolean::New(value));
53
+  }
54
+
55
+  inline void Set(double i) {
56
+    v8::HandleScope scope;
57
+
58
+    TYPE_CHECK(T, v8::Number);
59
+    value_->Dispose();
60
+    *value_ = v8::Persistent<T>::New(v8::Number::New(i));
61
+  }
62
+
63
+  inline void Set(int32_t i) {
64
+    v8::HandleScope scope;
65
+
66
+    TYPE_CHECK(T, v8::Integer);
67
+    value_->Dispose();
68
+    *value_ = v8::Persistent<T>::New(v8::Int32::New(i));
69
+  }
70
+
71
+  inline void Set(uint32_t i) {
72
+    v8::HandleScope scope;
73
+
74
+    TYPE_CHECK(T, v8::Integer);
75
+    value_->Dispose();
76
+    *value_ = v8::Persistent<T>::New(v8::Uint32::NewFromUnsigned(i));
77
+  }
78
+
79
+  // Fast JS primitive setters
80
+  inline void SetNull() {
81
+    v8::HandleScope scope;
82
+
83
+    TYPE_CHECK(T, v8::Primitive);
84
+    value_->Dispose();
85
+    *value_ = v8::Persistent<T>::New(v8::Null());
86
+  }
87
+
88
+  inline void SetUndefined() {
89
+    v8::HandleScope scope;
90
+
91
+    TYPE_CHECK(T, v8::Primitive);
92
+    value_->Dispose();
93
+    *value_ = v8::Persistent<T>::New(v8::Undefined());
94
+  }
95
+
96
+  inline void SetEmptyString() {
97
+    v8::HandleScope scope;
98
+
99
+    TYPE_CHECK(T, v8::String);
100
+    value_->Dispose();
101
+    *value_ = v8::Persistent<T>::New(v8::String::Empty());
102
+  }
103
+
104
+  // Convenience getter for isolate
105
+  inline v8::Isolate *GetIsolate() const {
106
+    return isolate_;
107
+  }
108
+
109
+  // Pointer setter: Uncompilable to prevent inadvertent misuse.
110
+  template<typename S>
111
+  inline void Set(S *whatever) { TYPE_CHECK(S*, v8::Primitive); }
112
+};
113
+
114
+template<typename T>
115
+class FunctionCallbackInfo {
116
+  const v8::Arguments &args_;
117
+  v8::Local<v8::Value> data_;
118
+  ReturnValue<T> return_value_;
119
+  v8::Persistent<T> retval_;
120
+
121
+ public:
122
+  explicit inline FunctionCallbackInfo(
123
+      const v8::Arguments &args
124
+    , v8::Local<v8::Value> data) :
125
+          args_(args)
126
+        , data_(data)
127
+        , return_value_(args.GetIsolate(), &retval_)
128
+        , retval_(v8::Persistent<T>::New(v8::Undefined())) {}
129
+
130
+  inline ~FunctionCallbackInfo() {
131
+    retval_.Dispose();
132
+    retval_.Clear();
133
+  }
134
+
135
+  inline ReturnValue<T> GetReturnValue() const {
136
+    return ReturnValue<T>(return_value_);
137
+  }
138
+
139
+  inline v8::Local<v8::Function> Callee() const { return args_.Callee(); }
140
+  inline v8::Local<v8::Value> Data() const { return data_; }
141
+  inline v8::Local<v8::Object> Holder() const { return args_.Holder(); }
142
+  inline bool IsConstructCall() const { return args_.IsConstructCall(); }
143
+  inline int Length() const { return args_.Length(); }
144
+  inline v8::Local<v8::Value> operator[](int i) const { return args_[i]; }
145
+  inline v8::Local<v8::Object> This() const { return args_.This(); }
146
+  inline v8::Isolate *GetIsolate() const { return args_.GetIsolate(); }
147
+
148
+
149
+ protected:
150
+  static const int kHolderIndex = 0;
151
+  static const int kIsolateIndex = 1;
152
+  static const int kReturnValueDefaultValueIndex = 2;
153
+  static const int kReturnValueIndex = 3;
154
+  static const int kDataIndex = 4;
155
+  static const int kCalleeIndex = 5;
156
+  static const int kContextSaveIndex = 6;
157
+  static const int kArgsLength = 7;
158
+
159
+ private:
160
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(FunctionCallbackInfo)
161
+};
162
+
163
+template<typename T>
164
+class PropertyCallbackInfoBase {
165
+  const v8::AccessorInfo &info_;
166
+  const v8::Local<v8::Value> data_;
167
+
168
+ public:
169
+  explicit inline PropertyCallbackInfoBase(
170
+      const v8::AccessorInfo &info
171
+    , const v8::Local<v8::Value> data) :
172
+          info_(info)
173
+        , data_(data) {}
174
+
175
+  inline v8::Isolate* GetIsolate() const { return info_.GetIsolate(); }
176
+  inline v8::Local<v8::Value> Data() const { return data_; }
177
+  inline v8::Local<v8::Object> This() const { return info_.This(); }
178
+  inline v8::Local<v8::Object> Holder() const { return info_.Holder(); }
179
+
180
+ protected:
181
+  static const int kHolderIndex = 0;
182
+  static const int kIsolateIndex = 1;
183
+  static const int kReturnValueDefaultValueIndex = 2;
184
+  static const int kReturnValueIndex = 3;
185
+  static const int kDataIndex = 4;
186
+  static const int kThisIndex = 5;
187
+  static const int kArgsLength = 6;
188
+
189
+ private:
190
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(PropertyCallbackInfoBase)
191
+};
192
+
193
+template<typename T>
194
+class PropertyCallbackInfo : public PropertyCallbackInfoBase<T> {
195
+  ReturnValue<T> return_value_;
196
+  v8::Persistent<T> retval_;
197
+
198
+ public:
199
+  explicit inline PropertyCallbackInfo(
200
+      const v8::AccessorInfo &info
201
+    , const v8::Local<v8::Value> data) :
202
+          PropertyCallbackInfoBase<T>(info, data)
203
+        , return_value_(info.GetIsolate(), &retval_)
204
+        , retval_(v8::Persistent<T>::New(v8::Undefined())) {}
205
+
206
+  inline ~PropertyCallbackInfo() {
207
+    retval_.Dispose();
208
+    retval_.Clear();
209
+  }
210
+
211
+  inline ReturnValue<T> GetReturnValue() const { return return_value_; }
212
+};
213
+
214
+template<>
215
+class PropertyCallbackInfo<v8::Array> :
216
+    public PropertyCallbackInfoBase<v8::Array> {
217
+  ReturnValue<v8::Array> return_value_;
218
+  v8::Persistent<v8::Array> retval_;
219
+
220
+ public:
221
+  explicit inline PropertyCallbackInfo(
222
+      const v8::AccessorInfo &info
223
+    , const v8::Local<v8::Value> data) :
224
+          PropertyCallbackInfoBase<v8::Array>(info, data)
225
+        , return_value_(info.GetIsolate(), &retval_)
226
+        , retval_(v8::Persistent<v8::Array>::New(v8::Local<v8::Array>())) {}
227
+
228
+  inline ~PropertyCallbackInfo() {
229
+    retval_.Dispose();
230
+    retval_.Clear();
231
+  }
232
+
233
+  inline ReturnValue<v8::Array> GetReturnValue() const {
234
+    return return_value_;
235
+  }
236
+};
237
+
238
+template<>
239
+class PropertyCallbackInfo<v8::Boolean> :
240
+    public PropertyCallbackInfoBase<v8::Boolean> {
241
+  ReturnValue<v8::Boolean> return_value_;
242
+  v8::Persistent<v8::Boolean> retval_;
243
+
244
+ public:
245
+  explicit inline PropertyCallbackInfo(
246
+      const v8::AccessorInfo &info
247
+    , const v8::Local<v8::Value> data) :
248
+          PropertyCallbackInfoBase<v8::Boolean>(info, data)
249
+        , return_value_(info.GetIsolate(), &retval_)
250
+        , retval_(v8::Persistent<v8::Boolean>::New(v8::Local<v8::Boolean>())) {}
251
+
252
+  inline ~PropertyCallbackInfo() {
253
+    retval_.Dispose();
254
+    retval_.Clear();
255
+  }
256
+
257
+  inline ReturnValue<v8::Boolean> GetReturnValue() const {
258
+    return return_value_;
259
+  }
260
+};
261
+
262
+template<>
263
+class PropertyCallbackInfo<v8::Integer> :
264
+    public PropertyCallbackInfoBase<v8::Integer> {
265
+  ReturnValue<v8::Integer> return_value_;
266
+  v8::Persistent<v8::Integer> retval_;
267
+
268
+ public:
269
+  explicit inline PropertyCallbackInfo(
270
+      const v8::AccessorInfo &info
271
+    , const v8::Local<v8::Value> data) :
272
+          PropertyCallbackInfoBase<v8::Integer>(info, data)
273
+        , return_value_(info.GetIsolate(), &retval_)
274
+        , retval_(v8::Persistent<v8::Integer>::New(v8::Local<v8::Integer>())) {}
275
+
276
+  inline ~PropertyCallbackInfo() {
277
+    retval_.Dispose();
278
+    retval_.Clear();
279
+  }
280
+
281
+  inline ReturnValue<v8::Integer> GetReturnValue() const {
282
+    return return_value_;
283
+  }
284
+};
285
+
286
+namespace imp {
287
+template<typename T>
288
+class ReturnValueImp : public ReturnValue<T> {
289
+ public:
290
+  explicit ReturnValueImp(ReturnValue<T> that) :
291
+      ReturnValue<T>(that) {}
292
+  inline v8::Handle<T> Value() {
293
+      return *ReturnValue<T>::value_;
294
+  }
295
+};
296
+
297
+static
298
+v8::Handle<v8::Value> FunctionCallbackWrapper(const v8::Arguments &args) {
299
+  v8::Local<v8::Object> obj = args.Data().As<v8::Object>();
300
+  FunctionCallback callback = reinterpret_cast<FunctionCallback>(
301
+      reinterpret_cast<intptr_t>(
302
+          obj->GetInternalField(kFunctionIndex).As<v8::External>()->Value()));
303
+  FunctionCallbackInfo<v8::Value>
304
+      cbinfo(args, obj->GetInternalField(kDataIndex));
305
+  callback(cbinfo);
306
+  return ReturnValueImp<v8::Value>(cbinfo.GetReturnValue()).Value();
307
+}
308
+
309
+typedef v8::Handle<v8::Value> (*NativeFunction)(const v8::Arguments &);
310
+
311
+static
312
+v8::Handle<v8::Value> GetterCallbackWrapper(
313
+    v8::Local<v8::String> property, const v8::AccessorInfo &info) {
314
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
315
+  PropertyCallbackInfo<v8::Value>
316
+      cbinfo(info, obj->GetInternalField(kDataIndex));
317
+  GetterCallback callback = reinterpret_cast<GetterCallback>(
318
+      reinterpret_cast<intptr_t>(
319
+          obj->GetInternalField(kGetterIndex).As<v8::External>()->Value()));
320
+  callback(property, cbinfo);
321
+  return ReturnValueImp<v8::Value>(cbinfo.GetReturnValue()).Value();
322
+}
323
+
324
+typedef v8::Handle<v8::Value> (*NativeGetter)
325
+    (v8::Local<v8::String>, const v8::AccessorInfo &);
326
+
327
+static
328
+void SetterCallbackWrapper(
329
+    v8::Local<v8::String> property
330
+  , v8::Local<v8::Value> value
331
+  , const v8::AccessorInfo &info) {
332
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
333
+  PropertyCallbackInfo<void>
334
+      cbinfo(info, obj->GetInternalField(kDataIndex));
335
+  SetterCallback callback = reinterpret_cast<SetterCallback>(
336
+      reinterpret_cast<intptr_t>(
337
+          obj->GetInternalField(kSetterIndex).As<v8::External>()->Value()));
338
+  callback(property, value, cbinfo);
339
+}
340
+
341
+typedef void (*NativeSetter)
342
+    (v8::Local<v8::String>, v8::Local<v8::Value>, const v8::AccessorInfo &);
343
+
344
+static
345
+v8::Handle<v8::Value> PropertyGetterCallbackWrapper(
346
+    v8::Local<v8::String> property, const v8::AccessorInfo &info) {
347
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
348
+  PropertyCallbackInfo<v8::Value>
349
+      cbinfo(info, obj->GetInternalField(kDataIndex));
350
+  PropertyGetterCallback callback = reinterpret_cast<PropertyGetterCallback>(
351
+      reinterpret_cast<intptr_t>(
352
+          obj->GetInternalField(kPropertyGetterIndex)
353
+              .As<v8::External>()->Value()));
354
+  callback(property, cbinfo);
355
+  return ReturnValueImp<v8::Value>(cbinfo.GetReturnValue()).Value();
356
+}
357
+
358
+typedef v8::Handle<v8::Value> (*NativePropertyGetter)
359
+    (v8::Local<v8::String>, const v8::AccessorInfo &);
360
+
361
+static
362
+v8::Handle<v8::Value> PropertySetterCallbackWrapper(
363
+    v8::Local<v8::String> property
364
+  , v8::Local<v8::Value> value
365
+  , const v8::AccessorInfo &info) {
366
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
367
+  PropertyCallbackInfo<v8::Value>
368
+      cbinfo(info, obj->GetInternalField(kDataIndex));
369
+  PropertySetterCallback callback = reinterpret_cast<PropertySetterCallback>(
370
+      reinterpret_cast<intptr_t>(
371
+          obj->GetInternalField(kPropertySetterIndex)
372
+              .As<v8::External>()->Value()));
373
+  callback(property, value, cbinfo);
374
+  return ReturnValueImp<v8::Value>(cbinfo.GetReturnValue()).Value();
375
+}
376
+
377
+typedef v8::Handle<v8::Value> (*NativePropertySetter)
378
+    (v8::Local<v8::String>, v8::Local<v8::Value>, const v8::AccessorInfo &);
379
+
380
+static
381
+v8::Handle<v8::Array> PropertyEnumeratorCallbackWrapper(
382
+    const v8::AccessorInfo &info) {
383
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
384
+  PropertyCallbackInfo<v8::Array>
385
+      cbinfo(info, obj->GetInternalField(kDataIndex));
386
+  PropertyEnumeratorCallback callback =
387
+      reinterpret_cast<PropertyEnumeratorCallback>(reinterpret_cast<intptr_t>(
388
+          obj->GetInternalField(kPropertyEnumeratorIndex)
389
+              .As<v8::External>()->Value()));
390
+  callback(cbinfo);
391
+  return ReturnValueImp<v8::Array>(cbinfo.GetReturnValue()).Value();
392
+}
393
+
394
+typedef v8::Handle<v8::Array> (*NativePropertyEnumerator)
395
+    (const v8::AccessorInfo &);
396
+
397
+static
398
+v8::Handle<v8::Boolean> PropertyDeleterCallbackWrapper(
399
+    v8::Local<v8::String> property
400
+  , const v8::AccessorInfo &info) {
401
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
402
+  PropertyCallbackInfo<v8::Boolean>
403
+      cbinfo(info, obj->GetInternalField(kDataIndex));
404
+  PropertyDeleterCallback callback = reinterpret_cast<PropertyDeleterCallback>(
405
+      reinterpret_cast<intptr_t>(
406
+          obj->GetInternalField(kPropertyDeleterIndex)
407
+              .As<v8::External>()->Value()));
408
+  callback(property, cbinfo);
409
+  return ReturnValueImp<v8::Boolean>(cbinfo.GetReturnValue()).Value();
410
+}
411
+
412
+typedef v8::Handle<v8::Boolean> (NativePropertyDeleter)
413
+    (v8::Local<v8::String>, const v8::AccessorInfo &);
414
+
415
+static
416
+v8::Handle<v8::Integer> PropertyQueryCallbackWrapper(
417
+    v8::Local<v8::String> property, const v8::AccessorInfo &info) {
418
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
419
+  PropertyCallbackInfo<v8::Integer>
420
+      cbinfo(info, obj->GetInternalField(kDataIndex));
421
+  PropertyQueryCallback callback = reinterpret_cast<PropertyQueryCallback>(
422
+      reinterpret_cast<intptr_t>(
423
+          obj->GetInternalField(kPropertyQueryIndex)
424
+              .As<v8::External>()->Value()));
425
+  callback(property, cbinfo);
426
+  return ReturnValueImp<v8::Integer>(cbinfo.GetReturnValue()).Value();
427
+}
428
+
429
+typedef v8::Handle<v8::Integer> (*NativePropertyQuery)
430
+    (v8::Local<v8::String>, const v8::AccessorInfo &);
431
+
432
+static
433
+v8::Handle<v8::Value> IndexGetterCallbackWrapper(
434
+    uint32_t index, const v8::AccessorInfo &info) {
435
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
436
+  PropertyCallbackInfo<v8::Value>
437
+      cbinfo(info, obj->GetInternalField(kDataIndex));
438
+  IndexGetterCallback callback = reinterpret_cast<IndexGetterCallback>(
439
+      reinterpret_cast<intptr_t>(
440
+          obj->GetInternalField(kIndexPropertyGetterIndex)
441
+              .As<v8::External>()->Value()));
442
+  callback(index, cbinfo);
443
+  return ReturnValueImp<v8::Value>(cbinfo.GetReturnValue()).Value();
444
+}
445
+
446
+typedef v8::Handle<v8::Value> (*NativeIndexGetter)
447
+    (uint32_t, const v8::AccessorInfo &);
448
+
449
+static
450
+v8::Handle<v8::Value> IndexSetterCallbackWrapper(
451
+    uint32_t index
452
+  , v8::Local<v8::Value> value
453
+  , const v8::AccessorInfo &info) {
454
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
455
+  PropertyCallbackInfo<v8::Value>
456
+      cbinfo(info, obj->GetInternalField(kDataIndex));
457
+  IndexSetterCallback callback = reinterpret_cast<IndexSetterCallback>(
458
+      reinterpret_cast<intptr_t>(
459
+          obj->GetInternalField(kIndexPropertySetterIndex)
460
+              .As<v8::External>()->Value()));
461
+  callback(index, value, cbinfo);
462
+  return ReturnValueImp<v8::Value>(cbinfo.GetReturnValue()).Value();
463
+}
464
+
465
+typedef v8::Handle<v8::Value> (*NativeIndexSetter)
466
+    (uint32_t, v8::Local<v8::Value>, const v8::AccessorInfo &);
467
+
468
+static
469
+v8::Handle<v8::Array> IndexEnumeratorCallbackWrapper(
470
+    const v8::AccessorInfo &info) {
471
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
472
+  PropertyCallbackInfo<v8::Array>
473
+      cbinfo(info, obj->GetInternalField(kDataIndex));
474
+  IndexEnumeratorCallback callback = reinterpret_cast<IndexEnumeratorCallback>(
475
+      reinterpret_cast<intptr_t>(
476
+          obj->GetInternalField(kIndexPropertyEnumeratorIndex)
477
+              .As<v8::External>()->Value()));
478
+  callback(cbinfo);
479
+  return ReturnValueImp<v8::Array>(cbinfo.GetReturnValue()).Value();
480
+}
481
+
482
+typedef v8::Handle<v8::Array> (*NativeIndexEnumerator)
483
+    (const v8::AccessorInfo &);
484
+
485
+static
486
+v8::Handle<v8::Boolean> IndexDeleterCallbackWrapper(
487
+    uint32_t index, const v8::AccessorInfo &info) {
488
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
489
+  PropertyCallbackInfo<v8::Boolean>
490
+      cbinfo(info, obj->GetInternalField(kDataIndex));
491
+  IndexDeleterCallback callback = reinterpret_cast<IndexDeleterCallback>(
492
+      reinterpret_cast<intptr_t>(
493
+          obj->GetInternalField(kIndexPropertyDeleterIndex)
494
+              .As<v8::External>()->Value()));
495
+  callback(index, cbinfo);
496
+  return ReturnValueImp<v8::Boolean>(cbinfo.GetReturnValue()).Value();
497
+}
498
+
499
+typedef v8::Handle<v8::Boolean> (*NativeIndexDeleter)
500
+    (uint32_t, const v8::AccessorInfo &);
501
+
502
+static
503
+v8::Handle<v8::Integer> IndexQueryCallbackWrapper(
504
+    uint32_t index, const v8::AccessorInfo &info) {
505
+  v8::Local<v8::Object> obj = info.Data().As<v8::Object>();
506
+  PropertyCallbackInfo<v8::Integer>
507
+      cbinfo(info, obj->GetInternalField(kDataIndex));
508
+  IndexQueryCallback callback = reinterpret_cast<IndexQueryCallback>(
509
+      reinterpret_cast<intptr_t>(
510
+          obj->GetInternalField(kIndexPropertyQueryIndex)
511
+              .As<v8::External>()->Value()));
512
+  callback(index, cbinfo);
513
+  return ReturnValueImp<v8::Integer>(cbinfo.GetReturnValue()).Value();
514
+}
515
+
516
+typedef v8::Handle<v8::Integer> (*NativeIndexQuery)
517
+    (uint32_t, const v8::AccessorInfo &);
518
+}  // end of namespace imp
519
+
520
+#endif  // NAN_CALLBACKS_PRE_12_INL_H_
... ...
@@ -0,0 +1,72 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_CONVERTERS_H_
10
+#define NAN_CONVERTERS_H_
11
+
12
+namespace imp {
13
+template<typename T> struct ToFactoryBase {
14
+  typedef MaybeLocal<T> return_t;
15
+};
16
+template<typename T> struct ValueFactoryBase { typedef Maybe<T> return_t; };
17
+
18
+template<typename T> struct ToFactory;
19
+
20
+template<>
21
+struct ToFactory<v8::Function> : ToFactoryBase<v8::Function> {
22
+  static inline return_t convert(v8::Local<v8::Value> val) {
23
+    if (val.IsEmpty() || !val->IsFunction()) return MaybeLocal<v8::Function>();
24
+    return MaybeLocal<v8::Function>(val.As<v8::Function>());
25
+  }
26
+};
27
+
28
+#define X(TYPE)                                                                \
29
+    template<>                                                                 \
30
+    struct ToFactory<v8::TYPE> : ToFactoryBase<v8::TYPE> {                     \
31
+      static inline return_t convert(v8::Local<v8::Value> val);                \
32
+    };
33
+
34
+X(Boolean)
35
+X(Number)
36
+X(String)
37
+X(Object)
38
+X(Integer)
39
+X(Uint32)
40
+X(Int32)
41
+
42
+#undef X
43
+
44
+#define X(TYPE)                                                                \
45
+    template<>                                                                 \
46
+    struct ToFactory<TYPE> : ValueFactoryBase<TYPE> {                          \
47
+      static inline return_t convert(v8::Local<v8::Value> val);                \
48
+    };
49
+
50
+X(bool)
51
+X(double)
52
+X(int64_t)
53
+X(uint32_t)
54
+X(int32_t)
55
+
56
+#undef X
57
+}  // end of namespace imp
58
+
59
+template<typename T>
60
+inline
61
+typename imp::ToFactory<T>::return_t To(v8::Local<v8::Value> val) {
62
+  return imp::ToFactory<T>::convert(val);
63
+}
64
+
65
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
66
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
67
+# include "nan_converters_43_inl.h"
68
+#else
69
+# include "nan_converters_pre_43_inl.h"
70
+#endif
71
+
72
+#endif  // NAN_CONVERTERS_H_
... ...
@@ -0,0 +1,68 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_CONVERTERS_43_INL_H_
10
+#define NAN_CONVERTERS_43_INL_H_
11
+
12
+#define X(TYPE)                                                                \
13
+imp::ToFactory<v8::TYPE>::return_t                                             \
14
+imp::ToFactory<v8::TYPE>::convert(v8::Local<v8::Value> val) {                  \
15
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();                            \
16
+  v8::EscapableHandleScope scope(isolate);                                     \
17
+  return scope.Escape(                                                         \
18
+      val->To ## TYPE(isolate->GetCurrentContext())                            \
19
+          .FromMaybe(v8::Local<v8::TYPE>()));                                  \
20
+}
21
+
22
+X(Number)
23
+X(String)
24
+X(Object)
25
+X(Integer)
26
+X(Uint32)
27
+X(Int32)
28
+// V8 <= 7.0
29
+#if V8_MAJOR_VERSION < 7 || (V8_MAJOR_VERSION == 7 && V8_MINOR_VERSION == 0)
30
+X(Boolean)
31
+#else
32
+imp::ToFactory<v8::Boolean>::return_t                                          \
33
+imp::ToFactory<v8::Boolean>::convert(v8::Local<v8::Value> val) {               \
34
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();                            \
35
+  v8::EscapableHandleScope scope(isolate);                                     \
36
+  return scope.Escape(val->ToBoolean(isolate));                                \
37
+}
38
+#endif
39
+
40
+#undef X
41
+
42
+#define X(TYPE, NAME)                                                          \
43
+imp::ToFactory<TYPE>::return_t                                                 \
44
+imp::ToFactory<TYPE>::convert(v8::Local<v8::Value> val) {                      \
45
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();                            \
46
+  v8::HandleScope scope(isolate);                                              \
47
+  return val->NAME ## Value(isolate->GetCurrentContext());                     \
48
+}
49
+
50
+X(double, Number)
51
+X(int64_t, Integer)
52
+X(uint32_t, Uint32)
53
+X(int32_t, Int32)
54
+// V8 <= 7.0
55
+#if V8_MAJOR_VERSION < 7 || (V8_MAJOR_VERSION == 7 && V8_MINOR_VERSION == 0)
56
+X(bool, Boolean)
57
+#else
58
+imp::ToFactory<bool>::return_t                                                 \
59
+imp::ToFactory<bool>::convert(v8::Local<v8::Value> val) {                      \
60
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();                            \
61
+  v8::HandleScope scope(isolate);                                              \
62
+  return Just<bool>(val->BooleanValue(isolate));                               \
63
+}
64
+#endif
65
+
66
+#undef X
67
+
68
+#endif  // NAN_CONVERTERS_43_INL_H_
... ...
@@ -0,0 +1,42 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_CONVERTERS_PRE_43_INL_H_
10
+#define NAN_CONVERTERS_PRE_43_INL_H_
11
+
12
+#define X(TYPE)                                                                \
13
+imp::ToFactory<v8::TYPE>::return_t                                             \
14
+imp::ToFactory<v8::TYPE>::convert(v8::Local<v8::Value> val) {                  \
15
+  return val->To ## TYPE();                                                    \
16
+}
17
+
18
+X(Boolean)
19
+X(Number)
20
+X(String)
21
+X(Object)
22
+X(Integer)
23
+X(Uint32)
24
+X(Int32)
25
+
26
+#undef X
27
+
28
+#define X(TYPE, NAME)                                                          \
29
+imp::ToFactory<TYPE>::return_t                                                 \
30
+imp::ToFactory<TYPE>::convert(v8::Local<v8::Value> val) {                      \
31
+  return Just(val->NAME ## Value());                                           \
32
+}
33
+
34
+X(bool, Boolean)
35
+X(double, Number)
36
+X(int64_t, Integer)
37
+X(uint32_t, Uint32)
38
+X(int32_t, Int32)
39
+
40
+#undef X
41
+
42
+#endif  // NAN_CONVERTERS_PRE_43_INL_H_
... ...
@@ -0,0 +1,29 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_DEFINE_OWN_PROPERTY_HELPER_H_
10
+#define NAN_DEFINE_OWN_PROPERTY_HELPER_H_
11
+
12
+namespace imp {
13
+
14
+inline Maybe<bool> DefineOwnPropertyHelper(
15
+    v8::PropertyAttribute current
16
+  , v8::Handle<v8::Object> obj
17
+  , v8::Handle<v8::String> key
18
+  , v8::Handle<v8::Value> value
19
+  , v8::PropertyAttribute attribs = v8::None) {
20
+  return !(current & v8::DontDelete) ||                     // configurable OR
21
+                  (!(current & v8::ReadOnly) &&             // writable AND
22
+                   !((attribs ^ current) & ~v8::ReadOnly))  // same excluding RO
23
+             ? Just<bool>(obj->ForceSet(key, value, attribs))
24
+             : Nothing<bool>();
25
+}
26
+
27
+}  // end of namespace imp
28
+
29
+#endif  // NAN_DEFINE_OWN_PROPERTY_HELPER_H_
... ...
@@ -0,0 +1,430 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_IMPLEMENTATION_12_INL_H_
10
+#define NAN_IMPLEMENTATION_12_INL_H_
11
+//==============================================================================
12
+// node v0.11 implementation
13
+//==============================================================================
14
+
15
+namespace imp {
16
+
17
+//=== Array ====================================================================
18
+
19
+Factory<v8::Array>::return_t
20
+Factory<v8::Array>::New() {
21
+  return v8::Array::New(v8::Isolate::GetCurrent());
22
+}
23
+
24
+Factory<v8::Array>::return_t
25
+Factory<v8::Array>::New(int length) {
26
+  return v8::Array::New(v8::Isolate::GetCurrent(), length);
27
+}
28
+
29
+//=== Boolean ==================================================================
30
+
31
+Factory<v8::Boolean>::return_t
32
+Factory<v8::Boolean>::New(bool value) {
33
+  return v8::Boolean::New(v8::Isolate::GetCurrent(), value);
34
+}
35
+
36
+//=== Boolean Object ===========================================================
37
+
38
+Factory<v8::BooleanObject>::return_t
39
+Factory<v8::BooleanObject>::New(bool value) {
40
+#if (NODE_MODULE_VERSION >= NODE_6_0_MODULE_VERSION)
41
+  return v8::BooleanObject::New(
42
+    v8::Isolate::GetCurrent(), value).As<v8::BooleanObject>();
43
+#else
44
+  return v8::BooleanObject::New(value).As<v8::BooleanObject>();
45
+#endif
46
+}
47
+
48
+//=== Context ==================================================================
49
+
50
+Factory<v8::Context>::return_t
51
+Factory<v8::Context>::New( v8::ExtensionConfiguration* extensions
52
+                         , v8::Local<v8::ObjectTemplate> tmpl
53
+                         , v8::Local<v8::Value> obj) {
54
+  return v8::Context::New(v8::Isolate::GetCurrent(), extensions, tmpl, obj);
55
+}
56
+
57
+//=== Date =====================================================================
58
+
59
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
60
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
61
+Factory<v8::Date>::return_t
62
+Factory<v8::Date>::New(double value) {
63
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
64
+  v8::EscapableHandleScope scope(isolate);
65
+  return scope.Escape(v8::Date::New(isolate->GetCurrentContext(), value)
66
+      .FromMaybe(v8::Local<v8::Value>()).As<v8::Date>());
67
+}
68
+#else
69
+Factory<v8::Date>::return_t
70
+Factory<v8::Date>::New(double value) {
71
+  return v8::Date::New(v8::Isolate::GetCurrent(), value).As<v8::Date>();
72
+}
73
+#endif
74
+
75
+//=== External =================================================================
76
+
77
+Factory<v8::External>::return_t
78
+Factory<v8::External>::New(void * value) {
79
+  return v8::External::New(v8::Isolate::GetCurrent(), value);
80
+}
81
+
82
+//=== Function =================================================================
83
+
84
+Factory<v8::Function>::return_t
85
+Factory<v8::Function>::New( FunctionCallback callback
86
+                          , v8::Local<v8::Value> data) {
87
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
88
+  v8::EscapableHandleScope scope(isolate);
89
+  v8::Local<v8::ObjectTemplate> tpl = v8::ObjectTemplate::New(isolate);
90
+  tpl->SetInternalFieldCount(imp::kFunctionFieldCount);
91
+  v8::Local<v8::Object> obj = NewInstance(tpl).ToLocalChecked();
92
+
93
+  obj->SetInternalField(
94
+      imp::kFunctionIndex
95
+    , v8::External::New(isolate, reinterpret_cast<void *>(callback)));
96
+
97
+  v8::Local<v8::Value> val = v8::Local<v8::Value>::New(isolate, data);
98
+
99
+  if (!val.IsEmpty()) {
100
+    obj->SetInternalField(imp::kDataIndex, val);
101
+  }
102
+
103
+#if NODE_MAJOR_VERSION >= 10
104
+  v8::Local<v8::Context> context = isolate->GetCurrentContext();
105
+  v8::Local<v8::Function> function =
106
+      v8::Function::New(context, imp::FunctionCallbackWrapper, obj)
107
+      .ToLocalChecked();
108
+#else
109
+  v8::Local<v8::Function> function =
110
+      v8::Function::New(isolate, imp::FunctionCallbackWrapper, obj);
111
+#endif
112
+
113
+  return scope.Escape(function);
114
+}
115
+
116
+//=== Function Template ========================================================
117
+
118
+Factory<v8::FunctionTemplate>::return_t
119
+Factory<v8::FunctionTemplate>::New( FunctionCallback callback
120
+                                  , v8::Local<v8::Value> data
121
+                                  , v8::Local<v8::Signature> signature) {
122
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
123
+  if (callback) {
124
+    v8::EscapableHandleScope scope(isolate);
125
+    v8::Local<v8::ObjectTemplate> tpl = v8::ObjectTemplate::New(isolate);
126
+    tpl->SetInternalFieldCount(imp::kFunctionFieldCount);
127
+    v8::Local<v8::Object> obj = NewInstance(tpl).ToLocalChecked();
128
+
129
+    obj->SetInternalField(
130
+        imp::kFunctionIndex
131
+      , v8::External::New(isolate, reinterpret_cast<void *>(callback)));
132
+    v8::Local<v8::Value> val = v8::Local<v8::Value>::New(isolate, data);
133
+
134
+    if (!val.IsEmpty()) {
135
+      obj->SetInternalField(imp::kDataIndex, val);
136
+    }
137
+
138
+    return scope.Escape(v8::FunctionTemplate::New( isolate
139
+                                    , imp::FunctionCallbackWrapper
140
+                                    , obj
141
+                                    , signature));
142
+  } else {
143
+    return v8::FunctionTemplate::New(isolate, 0, data, signature);
144
+  }
145
+}
146
+
147
+//=== Number ===================================================================
148
+
149
+Factory<v8::Number>::return_t
150
+Factory<v8::Number>::New(double value) {
151
+  return v8::Number::New(v8::Isolate::GetCurrent(), value);
152
+}
153
+
154
+//=== Number Object ============================================================
155
+
156
+Factory<v8::NumberObject>::return_t
157
+Factory<v8::NumberObject>::New(double value) {
158
+  return v8::NumberObject::New( v8::Isolate::GetCurrent()
159
+                              , value).As<v8::NumberObject>();
160
+}
161
+
162
+//=== Integer, Int32 and Uint32 ================================================
163
+
164
+template <typename T>
165
+typename IntegerFactory<T>::return_t
166
+IntegerFactory<T>::New(int32_t value) {
167
+  return To<T>(T::New(v8::Isolate::GetCurrent(), value));
168
+}
169
+
170
+template <typename T>
171
+typename IntegerFactory<T>::return_t
172
+IntegerFactory<T>::New(uint32_t value) {
173
+  return To<T>(T::NewFromUnsigned(v8::Isolate::GetCurrent(), value));
174
+}
175
+
176
+Factory<v8::Uint32>::return_t
177
+Factory<v8::Uint32>::New(int32_t value) {
178
+  return To<v8::Uint32>(
179
+      v8::Uint32::NewFromUnsigned(v8::Isolate::GetCurrent(), value));
180
+}
181
+
182
+Factory<v8::Uint32>::return_t
183
+Factory<v8::Uint32>::New(uint32_t value) {
184
+  return To<v8::Uint32>(
185
+      v8::Uint32::NewFromUnsigned(v8::Isolate::GetCurrent(), value));
186
+}
187
+
188
+//=== Object ===================================================================
189
+
190
+Factory<v8::Object>::return_t
191
+Factory<v8::Object>::New() {
192
+  return v8::Object::New(v8::Isolate::GetCurrent());
193
+}
194
+
195
+//=== Object Template ==========================================================
196
+
197
+Factory<v8::ObjectTemplate>::return_t
198
+Factory<v8::ObjectTemplate>::New() {
199
+  return v8::ObjectTemplate::New(v8::Isolate::GetCurrent());
200
+}
201
+
202
+//=== RegExp ===================================================================
203
+
204
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
205
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
206
+Factory<v8::RegExp>::return_t
207
+Factory<v8::RegExp>::New(
208
+    v8::Local<v8::String> pattern
209
+  , v8::RegExp::Flags flags) {
210
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
211
+  v8::EscapableHandleScope scope(isolate);
212
+  return scope.Escape(
213
+      v8::RegExp::New(isolate->GetCurrentContext(), pattern, flags)
214
+          .FromMaybe(v8::Local<v8::RegExp>()));
215
+}
216
+#else
217
+Factory<v8::RegExp>::return_t
218
+Factory<v8::RegExp>::New(
219
+    v8::Local<v8::String> pattern
220
+  , v8::RegExp::Flags flags) {
221
+  return v8::RegExp::New(pattern, flags);
222
+}
223
+#endif
224
+
225
+//=== Script ===================================================================
226
+
227
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
228
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
229
+Factory<v8::Script>::return_t
230
+Factory<v8::Script>::New( v8::Local<v8::String> source) {
231
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
232
+  v8::EscapableHandleScope scope(isolate);
233
+  v8::ScriptCompiler::Source src(source);
234
+  return scope.Escape(
235
+      v8::ScriptCompiler::Compile(isolate->GetCurrentContext(), &src)
236
+          .FromMaybe(v8::Local<v8::Script>()));
237
+}
238
+
239
+Factory<v8::Script>::return_t
240
+Factory<v8::Script>::New( v8::Local<v8::String> source
241
+                        , v8::ScriptOrigin const& origin) {
242
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
243
+  v8::EscapableHandleScope scope(isolate);
244
+  v8::ScriptCompiler::Source src(source, origin);
245
+  return scope.Escape(
246
+      v8::ScriptCompiler::Compile(isolate->GetCurrentContext(), &src)
247
+          .FromMaybe(v8::Local<v8::Script>()));
248
+}
249
+#else
250
+Factory<v8::Script>::return_t
251
+Factory<v8::Script>::New( v8::Local<v8::String> source) {
252
+  v8::ScriptCompiler::Source src(source);
253
+  return v8::ScriptCompiler::Compile(v8::Isolate::GetCurrent(), &src);
254
+}
255
+
256
+Factory<v8::Script>::return_t
257
+Factory<v8::Script>::New( v8::Local<v8::String> source
258
+                        , v8::ScriptOrigin const& origin) {
259
+  v8::ScriptCompiler::Source src(source, origin);
260
+  return v8::ScriptCompiler::Compile(v8::Isolate::GetCurrent(), &src);
261
+}
262
+#endif
263
+
264
+//=== Signature ================================================================
265
+
266
+Factory<v8::Signature>::return_t
267
+Factory<v8::Signature>::New(Factory<v8::Signature>::FTH receiver) {
268
+  return v8::Signature::New(v8::Isolate::GetCurrent(), receiver);
269
+}
270
+
271
+//=== String ===================================================================
272
+
273
+Factory<v8::String>::return_t
274
+Factory<v8::String>::New() {
275
+  return v8::String::Empty(v8::Isolate::GetCurrent());
276
+}
277
+
278
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
279
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
280
+Factory<v8::String>::return_t
281
+Factory<v8::String>::New(const char * value, int length) {
282
+  return v8::String::NewFromUtf8(
283
+      v8::Isolate::GetCurrent(), value, v8::NewStringType::kNormal, length);
284
+}
285
+
286
+Factory<v8::String>::return_t
287
+Factory<v8::String>::New(std::string const& value) {
288
+  assert(value.size() <= INT_MAX && "string too long");
289
+  return v8::String::NewFromUtf8(v8::Isolate::GetCurrent(),
290
+      value.data(), v8::NewStringType::kNormal, static_cast<int>(value.size()));
291
+}
292
+
293
+Factory<v8::String>::return_t
294
+Factory<v8::String>::New(const uint16_t * value, int length) {
295
+  return v8::String::NewFromTwoByte(v8::Isolate::GetCurrent(), value,
296
+        v8::NewStringType::kNormal, length);
297
+}
298
+
299
+Factory<v8::String>::return_t
300
+Factory<v8::String>::New(v8::String::ExternalStringResource * value) {
301
+  return v8::String::NewExternalTwoByte(v8::Isolate::GetCurrent(), value);
302
+}
303
+
304
+Factory<v8::String>::return_t
305
+Factory<v8::String>::New(ExternalOneByteStringResource * value) {
306
+  return v8::String::NewExternalOneByte(v8::Isolate::GetCurrent(), value);
307
+}
308
+#else
309
+Factory<v8::String>::return_t
310
+Factory<v8::String>::New(const char * value, int length) {
311
+  return v8::String::NewFromUtf8(v8::Isolate::GetCurrent(), value,
312
+                                 v8::String::kNormalString, length);
313
+}
314
+
315
+Factory<v8::String>::return_t
316
+Factory<v8::String>::New(
317
+    std::string const& value) /* NOLINT(build/include_what_you_use) */ {
318
+  assert(value.size() <= INT_MAX && "string too long");
319
+  return v8::String::NewFromUtf8(v8::Isolate::GetCurrent(), value.data(),
320
+                                 v8::String::kNormalString,
321
+                                 static_cast<int>(value.size()));
322
+}
323
+
324
+Factory<v8::String>::return_t
325
+Factory<v8::String>::New(const uint16_t * value, int length) {
326
+  return v8::String::NewFromTwoByte(v8::Isolate::GetCurrent(), value,
327
+                                    v8::String::kNormalString, length);
328
+}
329
+
330
+Factory<v8::String>::return_t
331
+Factory<v8::String>::New(v8::String::ExternalStringResource * value) {
332
+  return v8::String::NewExternal(v8::Isolate::GetCurrent(), value);
333
+}
334
+
335
+Factory<v8::String>::return_t
336
+Factory<v8::String>::New(ExternalOneByteStringResource * value) {
337
+  return v8::String::NewExternal(v8::Isolate::GetCurrent(), value);
338
+}
339
+#endif
340
+
341
+//=== String Object ============================================================
342
+
343
+// See https://github.com/nodejs/nan/pull/811#discussion_r224594980.
344
+// Disable the warning as there is no way around it.
345
+// TODO(bnoordhuis) Use isolate-based version in Node.js v12.
346
+Factory<v8::StringObject>::return_t
347
+Factory<v8::StringObject>::New(v8::Local<v8::String> value) {
348
+// V8 > 7.0
349
+#if V8_MAJOR_VERSION > 7 || (V8_MAJOR_VERSION == 7 && V8_MINOR_VERSION > 0)
350
+  return v8::StringObject::New(v8::Isolate::GetCurrent(), value)
351
+      .As<v8::StringObject>();
352
+#else
353
+#ifdef _MSC_VER
354
+#pragma warning(push)
355
+#pragma warning(disable : 4996)
356
+#endif
357
+#ifdef __GNUC__
358
+#pragma GCC diagnostic push
359
+#pragma GCC diagnostic ignored "-Wdeprecated-declarations"
360
+#endif
361
+  return v8::StringObject::New(value).As<v8::StringObject>();
362
+#ifdef __GNUC__
363
+#pragma GCC diagnostic pop
364
+#endif
365
+#ifdef _MSC_VER
366
+#pragma warning(pop)
367
+#endif
368
+#endif
369
+}
370
+
371
+//=== Unbound Script ===========================================================
372
+
373
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
374
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
375
+Factory<v8::UnboundScript>::return_t
376
+Factory<v8::UnboundScript>::New(v8::Local<v8::String> source) {
377
+  v8::ScriptCompiler::Source src(source);
378
+  return v8::ScriptCompiler::CompileUnboundScript(
379
+      v8::Isolate::GetCurrent(), &src);
380
+}
381
+
382
+Factory<v8::UnboundScript>::return_t
383
+Factory<v8::UnboundScript>::New( v8::Local<v8::String> source
384
+                               , v8::ScriptOrigin const& origin) {
385
+  v8::ScriptCompiler::Source src(source, origin);
386
+  return v8::ScriptCompiler::CompileUnboundScript(
387
+      v8::Isolate::GetCurrent(), &src);
388
+}
389
+#else
390
+Factory<v8::UnboundScript>::return_t
391
+Factory<v8::UnboundScript>::New(v8::Local<v8::String> source) {
392
+  v8::ScriptCompiler::Source src(source);
393
+  return v8::ScriptCompiler::CompileUnbound(v8::Isolate::GetCurrent(), &src);
394
+}
395
+
396
+Factory<v8::UnboundScript>::return_t
397
+Factory<v8::UnboundScript>::New( v8::Local<v8::String> source
398
+                               , v8::ScriptOrigin const& origin) {
399
+  v8::ScriptCompiler::Source src(source, origin);
400
+  return v8::ScriptCompiler::CompileUnbound(v8::Isolate::GetCurrent(), &src);
401
+}
402
+#endif
403
+
404
+}  // end of namespace imp
405
+
406
+//=== Presistents and Handles ==================================================
407
+
408
+#if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
409
+template <typename T>
410
+inline v8::Local<T> New(v8::Handle<T> h) {
411
+  return v8::Local<T>::New(v8::Isolate::GetCurrent(), h);
412
+}
413
+#endif
414
+
415
+template <typename T, typename M>
416
+inline v8::Local<T> New(v8::Persistent<T, M> const& p) {
417
+  return v8::Local<T>::New(v8::Isolate::GetCurrent(), p);
418
+}
419
+
420
+template <typename T, typename M>
421
+inline v8::Local<T> New(Persistent<T, M> const& p) {
422
+  return v8::Local<T>::New(v8::Isolate::GetCurrent(), p);
423
+}
424
+
425
+template <typename T>
426
+inline v8::Local<T> New(Global<T> const& p) {
427
+  return v8::Local<T>::New(v8::Isolate::GetCurrent(), p);
428
+}
429
+
430
+#endif  // NAN_IMPLEMENTATION_12_INL_H_
... ...
@@ -0,0 +1,263 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_IMPLEMENTATION_PRE_12_INL_H_
10
+#define NAN_IMPLEMENTATION_PRE_12_INL_H_
11
+
12
+//==============================================================================
13
+// node v0.10 implementation
14
+//==============================================================================
15
+
16
+namespace imp {
17
+
18
+//=== Array ====================================================================
19
+
20
+Factory<v8::Array>::return_t
21
+Factory<v8::Array>::New() {
22
+  return v8::Array::New();
23
+}
24
+
25
+Factory<v8::Array>::return_t
26
+Factory<v8::Array>::New(int length) {
27
+  return v8::Array::New(length);
28
+}
29
+
30
+//=== Boolean ==================================================================
31
+
32
+Factory<v8::Boolean>::return_t
33
+Factory<v8::Boolean>::New(bool value) {
34
+  return v8::Boolean::New(value)->ToBoolean();
35
+}
36
+
37
+//=== Boolean Object ===========================================================
38
+
39
+Factory<v8::BooleanObject>::return_t
40
+Factory<v8::BooleanObject>::New(bool value) {
41
+  return v8::BooleanObject::New(value).As<v8::BooleanObject>();
42
+}
43
+
44
+//=== Context ==================================================================
45
+
46
+Factory<v8::Context>::return_t
47
+Factory<v8::Context>::New( v8::ExtensionConfiguration* extensions
48
+                         , v8::Local<v8::ObjectTemplate> tmpl
49
+                         , v8::Local<v8::Value> obj) {
50
+  v8::Persistent<v8::Context> ctx = v8::Context::New(extensions, tmpl, obj);
51
+  v8::Local<v8::Context> lctx = v8::Local<v8::Context>::New(ctx);
52
+  ctx.Dispose();
53
+  return lctx;
54
+}
55
+
56
+//=== Date =====================================================================
57
+
58
+Factory<v8::Date>::return_t
59
+Factory<v8::Date>::New(double value) {
60
+  return v8::Date::New(value).As<v8::Date>();
61
+}
62
+
63
+//=== External =================================================================
64
+
65
+Factory<v8::External>::return_t
66
+Factory<v8::External>::New(void * value) {
67
+  return v8::External::New(value);
68
+}
69
+
70
+//=== Function =================================================================
71
+
72
+Factory<v8::Function>::return_t
73
+Factory<v8::Function>::New( FunctionCallback callback
74
+                          , v8::Local<v8::Value> data) {
75
+  v8::HandleScope scope;
76
+
77
+  return scope.Close(Factory<v8::FunctionTemplate>::New(
78
+                         callback, data, v8::Local<v8::Signature>())
79
+                         ->GetFunction());
80
+}
81
+
82
+
83
+//=== FunctionTemplate =========================================================
84
+
85
+Factory<v8::FunctionTemplate>::return_t
86
+Factory<v8::FunctionTemplate>::New( FunctionCallback callback
87
+                                  , v8::Local<v8::Value> data
88
+                                  , v8::Local<v8::Signature> signature) {
89
+  if (callback) {
90
+    v8::HandleScope scope;
91
+
92
+    v8::Local<v8::ObjectTemplate> tpl = v8::ObjectTemplate::New();
93
+    tpl->SetInternalFieldCount(imp::kFunctionFieldCount);
94
+    v8::Local<v8::Object> obj = tpl->NewInstance();
95
+
96
+    obj->SetInternalField(
97
+        imp::kFunctionIndex
98
+      , v8::External::New(reinterpret_cast<void *>(callback)));
99
+
100
+    v8::Local<v8::Value> val = v8::Local<v8::Value>::New(data);
101
+
102
+    if (!val.IsEmpty()) {
103
+      obj->SetInternalField(imp::kDataIndex, val);
104
+    }
105
+
106
+    // Note(agnat): Emulate length argument here. Unfortunately, I couldn't find
107
+    // a way. Have at it though...
108
+    return scope.Close(
109
+        v8::FunctionTemplate::New(imp::FunctionCallbackWrapper
110
+                                 , obj
111
+                                 , signature));
112
+  } else {
113
+    return v8::FunctionTemplate::New(0, data, signature);
114
+  }
115
+}
116
+
117
+//=== Number ===================================================================
118
+
119
+Factory<v8::Number>::return_t
120
+Factory<v8::Number>::New(double value) {
121
+  return v8::Number::New(value);
122
+}
123
+
124
+//=== Number Object ============================================================
125
+
126
+Factory<v8::NumberObject>::return_t
127
+Factory<v8::NumberObject>::New(double value) {
128
+  return v8::NumberObject::New(value).As<v8::NumberObject>();
129
+}
130
+
131
+//=== Integer, Int32 and Uint32 ================================================
132
+
133
+template <typename T>
134
+typename IntegerFactory<T>::return_t
135
+IntegerFactory<T>::New(int32_t value) {
136
+  return To<T>(T::New(value));
137
+}
138
+
139
+template <typename T>
140
+typename IntegerFactory<T>::return_t
141
+IntegerFactory<T>::New(uint32_t value) {
142
+  return To<T>(T::NewFromUnsigned(value));
143
+}
144
+
145
+Factory<v8::Uint32>::return_t
146
+Factory<v8::Uint32>::New(int32_t value) {
147
+  return To<v8::Uint32>(v8::Uint32::NewFromUnsigned(value));
148
+}
149
+
150
+Factory<v8::Uint32>::return_t
151
+Factory<v8::Uint32>::New(uint32_t value) {
152
+  return To<v8::Uint32>(v8::Uint32::NewFromUnsigned(value));
153
+}
154
+
155
+
156
+//=== Object ===================================================================
157
+
158
+Factory<v8::Object>::return_t
159
+Factory<v8::Object>::New() {
160
+  return v8::Object::New();
161
+}
162
+
163
+//=== Object Template ==========================================================
164
+
165
+Factory<v8::ObjectTemplate>::return_t
166
+Factory<v8::ObjectTemplate>::New() {
167
+  return v8::ObjectTemplate::New();
168
+}
169
+
170
+//=== RegExp ===================================================================
171
+
172
+Factory<v8::RegExp>::return_t
173
+Factory<v8::RegExp>::New(
174
+    v8::Local<v8::String> pattern
175
+  , v8::RegExp::Flags flags) {
176
+  return v8::RegExp::New(pattern, flags);
177
+}
178
+
179
+//=== Script ===================================================================
180
+
181
+Factory<v8::Script>::return_t
182
+Factory<v8::Script>::New( v8::Local<v8::String> source) {
183
+  return v8::Script::New(source);
184
+}
185
+Factory<v8::Script>::return_t
186
+Factory<v8::Script>::New( v8::Local<v8::String> source
187
+                        , v8::ScriptOrigin const& origin) {
188
+  return v8::Script::New(source, const_cast<v8::ScriptOrigin*>(&origin));
189
+}
190
+
191
+//=== Signature ================================================================
192
+
193
+Factory<v8::Signature>::return_t
194
+Factory<v8::Signature>::New(Factory<v8::Signature>::FTH receiver) {
195
+  return v8::Signature::New(receiver);
196
+}
197
+
198
+//=== String ===================================================================
199
+
200
+Factory<v8::String>::return_t
201
+Factory<v8::String>::New() {
202
+  return v8::String::Empty();
203
+}
204
+
205
+Factory<v8::String>::return_t
206
+Factory<v8::String>::New(const char * value, int length) {
207
+  return v8::String::New(value, length);
208
+}
209
+
210
+Factory<v8::String>::return_t
211
+Factory<v8::String>::New(
212
+    std::string const& value) /* NOLINT(build/include_what_you_use) */ {
213
+  assert(value.size() <= INT_MAX && "string too long");
214
+  return v8::String::New(value.data(), static_cast<int>(value.size()));
215
+}
216
+
217
+Factory<v8::String>::return_t
218
+Factory<v8::String>::New(const uint16_t * value, int length) {
219
+  return v8::String::New(value, length);
220
+}
221
+
222
+Factory<v8::String>::return_t
223
+Factory<v8::String>::New(v8::String::ExternalStringResource * value) {
224
+  return v8::String::NewExternal(value);
225
+}
226
+
227
+Factory<v8::String>::return_t
228
+Factory<v8::String>::New(v8::String::ExternalAsciiStringResource * value) {
229
+  return v8::String::NewExternal(value);
230
+}
231
+
232
+//=== String Object ============================================================
233
+
234
+Factory<v8::StringObject>::return_t
235
+Factory<v8::StringObject>::New(v8::Local<v8::String> value) {
236
+  return v8::StringObject::New(value).As<v8::StringObject>();
237
+}
238
+
239
+}  // end of namespace imp
240
+
241
+//=== Presistents and Handles ==================================================
242
+
243
+template <typename T>
244
+inline v8::Local<T> New(v8::Handle<T> h) {
245
+  return v8::Local<T>::New(h);
246
+}
247
+
248
+template <typename T>
249
+inline v8::Local<T> New(v8::Persistent<T> const& p) {
250
+  return v8::Local<T>::New(p);
251
+}
252
+
253
+template <typename T, typename M>
254
+inline v8::Local<T> New(Persistent<T, M> const& p) {
255
+  return v8::Local<T>::New(p.persistent);
256
+}
257
+
258
+template <typename T>
259
+inline v8::Local<T> New(Global<T> const& p) {
260
+  return v8::Local<T>::New(p.persistent);
261
+}
262
+
263
+#endif  // NAN_IMPLEMENTATION_PRE_12_INL_H_
... ...
@@ -0,0 +1,166 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_JSON_H_
10
+#define NAN_JSON_H_
11
+
12
+#if NODE_MODULE_VERSION < NODE_0_12_MODULE_VERSION
13
+#define NAN_JSON_H_NEED_PARSE 1
14
+#else
15
+#define NAN_JSON_H_NEED_PARSE 0
16
+#endif  // NODE_MODULE_VERSION < NODE_0_12_MODULE_VERSION
17
+
18
+#if NODE_MODULE_VERSION >= NODE_7_0_MODULE_VERSION
19
+#define NAN_JSON_H_NEED_STRINGIFY 0
20
+#else
21
+#define NAN_JSON_H_NEED_STRINGIFY 1
22
+#endif  // NODE_MODULE_VERSION >= NODE_7_0_MODULE_VERSION
23
+
24
+class JSON {
25
+ public:
26
+  JSON() {
27
+#if NAN_JSON_H_NEED_PARSE + NAN_JSON_H_NEED_STRINGIFY
28
+    Nan::HandleScope scope;
29
+
30
+    Nan::MaybeLocal<v8::Value> maybe_global_json = Nan::Get(
31
+      Nan::GetCurrentContext()->Global(),
32
+      Nan::New("JSON").ToLocalChecked()
33
+    );
34
+
35
+    assert(!maybe_global_json.IsEmpty() && "global JSON is empty");
36
+    v8::Local<v8::Value> val_global_json = maybe_global_json.ToLocalChecked();
37
+
38
+    assert(val_global_json->IsObject() && "global JSON is not an object");
39
+    Nan::MaybeLocal<v8::Object> maybe_obj_global_json =
40
+      Nan::To<v8::Object>(val_global_json);
41
+
42
+    assert(!maybe_obj_global_json.IsEmpty() && "global JSON object is empty");
43
+    v8::Local<v8::Object> global_json = maybe_obj_global_json.ToLocalChecked();
44
+
45
+#if NAN_JSON_H_NEED_PARSE
46
+    Nan::MaybeLocal<v8::Value> maybe_parse_method = Nan::Get(
47
+      global_json, Nan::New("parse").ToLocalChecked()
48
+    );
49
+
50
+    assert(!maybe_parse_method.IsEmpty() && "JSON.parse is empty");
51
+    v8::Local<v8::Value> parse_method = maybe_parse_method.ToLocalChecked();
52
+
53
+    assert(parse_method->IsFunction() && "JSON.parse is not a function");
54
+    parse_cb_.Reset(parse_method.As<v8::Function>());
55
+#endif  // NAN_JSON_H_NEED_PARSE
56
+
57
+#if NAN_JSON_H_NEED_STRINGIFY
58
+    Nan::MaybeLocal<v8::Value> maybe_stringify_method = Nan::Get(
59
+      global_json, Nan::New("stringify").ToLocalChecked()
60
+    );
61
+
62
+    assert(!maybe_stringify_method.IsEmpty() && "JSON.stringify is empty");
63
+    v8::Local<v8::Value> stringify_method =
64
+      maybe_stringify_method.ToLocalChecked();
65
+
66
+    assert(
67
+      stringify_method->IsFunction() && "JSON.stringify is not a function"
68
+    );
69
+    stringify_cb_.Reset(stringify_method.As<v8::Function>());
70
+#endif  // NAN_JSON_H_NEED_STRINGIFY
71
+#endif  // NAN_JSON_H_NEED_PARSE + NAN_JSON_H_NEED_STRINGIFY
72
+  }
73
+
74
+  inline
75
+  Nan::MaybeLocal<v8::Value> Parse(v8::Local<v8::String> json_string) {
76
+    Nan::EscapableHandleScope scope;
77
+#if NAN_JSON_H_NEED_PARSE
78
+    return scope.Escape(parse(json_string));
79
+#else
80
+    Nan::MaybeLocal<v8::Value> result;
81
+#if NODE_MODULE_VERSION >= NODE_0_12_MODULE_VERSION && \
82
+    NODE_MODULE_VERSION <= IOJS_2_0_MODULE_VERSION
83
+    result = v8::JSON::Parse(json_string);
84
+#else
85
+#if NODE_MODULE_VERSION > NODE_6_0_MODULE_VERSION
86
+    v8::Local<v8::Context> context_or_isolate = Nan::GetCurrentContext();
87
+#else
88
+    v8::Isolate* context_or_isolate = v8::Isolate::GetCurrent();
89
+#endif  // NODE_MODULE_VERSION > NODE_6_0_MODULE_VERSION
90
+    result = v8::JSON::Parse(context_or_isolate, json_string);
91
+#endif  // NODE_MODULE_VERSION >= NODE_0_12_MODULE_VERSION &&
92
+        // NODE_MODULE_VERSION <= IOJS_2_0_MODULE_VERSION
93
+    if (result.IsEmpty()) return v8::Local<v8::Value>();
94
+    return scope.Escape(result.ToLocalChecked());
95
+#endif  // NAN_JSON_H_NEED_PARSE
96
+  }
97
+
98
+  inline
99
+  Nan::MaybeLocal<v8::String> Stringify(v8::Local<v8::Object> json_object) {
100
+    Nan::EscapableHandleScope scope;
101
+    Nan::MaybeLocal<v8::String> result =
102
+#if NAN_JSON_H_NEED_STRINGIFY
103
+      Nan::To<v8::String>(stringify(json_object));
104
+#else
105
+      v8::JSON::Stringify(Nan::GetCurrentContext(), json_object);
106
+#endif  // NAN_JSON_H_NEED_STRINGIFY
107
+    if (result.IsEmpty()) return v8::Local<v8::String>();
108
+    return scope.Escape(result.ToLocalChecked());
109
+  }
110
+
111
+  inline
112
+  Nan::MaybeLocal<v8::String> Stringify(v8::Local<v8::Object> json_object,
113
+    v8::Local<v8::String> gap) {
114
+    Nan::EscapableHandleScope scope;
115
+    Nan::MaybeLocal<v8::String> result =
116
+#if NAN_JSON_H_NEED_STRINGIFY
117
+      Nan::To<v8::String>(stringify(json_object, gap));
118
+#else
119
+      v8::JSON::Stringify(Nan::GetCurrentContext(), json_object, gap);
120
+#endif  // NAN_JSON_H_NEED_STRINGIFY
121
+    if (result.IsEmpty()) return v8::Local<v8::String>();
122
+    return scope.Escape(result.ToLocalChecked());
123
+  }
124
+
125
+ private:
126
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(JSON)
127
+#if NAN_JSON_H_NEED_PARSE
128
+  Nan::Callback parse_cb_;
129
+#endif  // NAN_JSON_H_NEED_PARSE
130
+#if NAN_JSON_H_NEED_STRINGIFY
131
+  Nan::Callback stringify_cb_;
132
+#endif  // NAN_JSON_H_NEED_STRINGIFY
133
+
134
+#if NAN_JSON_H_NEED_PARSE
135
+  inline v8::Local<v8::Value> parse(v8::Local<v8::Value> arg) {
136
+    assert(!parse_cb_.IsEmpty() && "parse_cb_ is empty");
137
+    AsyncResource resource("nan:JSON.parse");
138
+    return parse_cb_.Call(1, &arg, &resource).FromMaybe(v8::Local<v8::Value>());
139
+  }
140
+#endif  // NAN_JSON_H_NEED_PARSE
141
+
142
+#if NAN_JSON_H_NEED_STRINGIFY
143
+  inline v8::Local<v8::Value> stringify(v8::Local<v8::Value> arg) {
144
+    assert(!stringify_cb_.IsEmpty() && "stringify_cb_ is empty");
145
+    AsyncResource resource("nan:JSON.stringify");
146
+    return stringify_cb_.Call(1, &arg, &resource)
147
+        .FromMaybe(v8::Local<v8::Value>());
148
+  }
149
+
150
+  inline v8::Local<v8::Value> stringify(v8::Local<v8::Value> arg,
151
+    v8::Local<v8::String> gap) {
152
+    assert(!stringify_cb_.IsEmpty() && "stringify_cb_ is empty");
153
+
154
+    v8::Local<v8::Value> argv[] = {
155
+      arg,
156
+      Nan::Null(),
157
+      gap
158
+    };
159
+    AsyncResource resource("nan:JSON.stringify");
160
+    return stringify_cb_.Call(3, argv, &resource)
161
+        .FromMaybe(v8::Local<v8::Value>());
162
+  }
163
+#endif  // NAN_JSON_H_NEED_STRINGIFY
164
+};
165
+
166
+#endif  // NAN_JSON_H_
... ...
@@ -0,0 +1,356 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_MAYBE_43_INL_H_
10
+#define NAN_MAYBE_43_INL_H_
11
+
12
+template<typename T>
13
+using MaybeLocal = v8::MaybeLocal<T>;
14
+
15
+inline
16
+MaybeLocal<v8::String> ToDetailString(v8::Local<v8::Value> val) {
17
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
18
+  v8::EscapableHandleScope scope(isolate);
19
+  return scope.Escape(val->ToDetailString(isolate->GetCurrentContext())
20
+                          .FromMaybe(v8::Local<v8::String>()));
21
+}
22
+
23
+inline
24
+MaybeLocal<v8::Uint32> ToArrayIndex(v8::Local<v8::Value> val) {
25
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
26
+  v8::EscapableHandleScope scope(isolate);
27
+  return scope.Escape(val->ToArrayIndex(isolate->GetCurrentContext())
28
+                          .FromMaybe(v8::Local<v8::Uint32>()));
29
+}
30
+
31
+inline
32
+Maybe<bool> Equals(v8::Local<v8::Value> a, v8::Local<v8::Value>(b)) {
33
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
34
+  v8::HandleScope scope(isolate);
35
+  return a->Equals(isolate->GetCurrentContext(), b);
36
+}
37
+
38
+inline
39
+MaybeLocal<v8::Object> NewInstance(v8::Local<v8::Function> h) {
40
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
41
+  v8::EscapableHandleScope scope(isolate);
42
+  return scope.Escape(h->NewInstance(isolate->GetCurrentContext())
43
+                          .FromMaybe(v8::Local<v8::Object>()));
44
+}
45
+
46
+inline
47
+MaybeLocal<v8::Object> NewInstance(
48
+      v8::Local<v8::Function> h
49
+    , int argc
50
+    , v8::Local<v8::Value> argv[]) {
51
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
52
+  v8::EscapableHandleScope scope(isolate);
53
+  return scope.Escape(h->NewInstance(isolate->GetCurrentContext(), argc, argv)
54
+                          .FromMaybe(v8::Local<v8::Object>()));
55
+}
56
+
57
+inline
58
+MaybeLocal<v8::Object> NewInstance(v8::Local<v8::ObjectTemplate> h) {
59
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
60
+  v8::EscapableHandleScope scope(isolate);
61
+  return scope.Escape(h->NewInstance(isolate->GetCurrentContext())
62
+                          .FromMaybe(v8::Local<v8::Object>()));
63
+}
64
+
65
+
66
+inline MaybeLocal<v8::Function> GetFunction(
67
+    v8::Local<v8::FunctionTemplate> t) {
68
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
69
+  v8::EscapableHandleScope scope(isolate);
70
+  return scope.Escape(t->GetFunction(isolate->GetCurrentContext())
71
+                          .FromMaybe(v8::Local<v8::Function>()));
72
+}
73
+
74
+inline Maybe<bool> Set(
75
+    v8::Local<v8::Object> obj
76
+  , v8::Local<v8::Value> key
77
+  , v8::Local<v8::Value> value) {
78
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
79
+  v8::HandleScope scope(isolate);
80
+  return obj->Set(isolate->GetCurrentContext(), key, value);
81
+}
82
+
83
+inline Maybe<bool> Set(
84
+    v8::Local<v8::Object> obj
85
+  , uint32_t index
86
+  , v8::Local<v8::Value> value) {
87
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
88
+  v8::HandleScope scope(isolate);
89
+  return obj->Set(isolate->GetCurrentContext(), index, value);
90
+}
91
+
92
+#if NODE_MODULE_VERSION < NODE_4_0_MODULE_VERSION
93
+#include "nan_define_own_property_helper.h"  // NOLINT(build/include)
94
+#endif
95
+
96
+inline Maybe<bool> DefineOwnProperty(
97
+    v8::Local<v8::Object> obj
98
+  , v8::Local<v8::String> key
99
+  , v8::Local<v8::Value> value
100
+  , v8::PropertyAttribute attribs = v8::None) {
101
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
102
+  v8::HandleScope scope(isolate);
103
+#if NODE_MODULE_VERSION >= NODE_4_0_MODULE_VERSION
104
+  return obj->DefineOwnProperty(isolate->GetCurrentContext(), key, value,
105
+                                attribs);
106
+#else
107
+  Maybe<v8::PropertyAttribute> maybeCurrent =
108
+      obj->GetPropertyAttributes(isolate->GetCurrentContext(), key);
109
+  if (maybeCurrent.IsNothing()) {
110
+    return Nothing<bool>();
111
+  }
112
+  v8::PropertyAttribute current = maybeCurrent.FromJust();
113
+  return imp::DefineOwnPropertyHelper(current, obj, key, value, attribs);
114
+#endif
115
+}
116
+
117
+NAN_DEPRECATED inline Maybe<bool> ForceSet(
118
+    v8::Local<v8::Object> obj
119
+  , v8::Local<v8::Value> key
120
+  , v8::Local<v8::Value> value
121
+  , v8::PropertyAttribute attribs = v8::None) {
122
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
123
+  v8::HandleScope scope(isolate);
124
+#if NODE_MODULE_VERSION >= NODE_9_0_MODULE_VERSION
125
+  return key->IsName()
126
+             ? obj->DefineOwnProperty(isolate->GetCurrentContext(),
127
+                                      key.As<v8::Name>(), value, attribs)
128
+             : Nothing<bool>();
129
+#else
130
+  return obj->ForceSet(isolate->GetCurrentContext(), key, value, attribs);
131
+#endif
132
+}
133
+
134
+inline MaybeLocal<v8::Value> Get(
135
+    v8::Local<v8::Object> obj
136
+  , v8::Local<v8::Value> key) {
137
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
138
+  v8::EscapableHandleScope scope(isolate);
139
+  return scope.Escape(obj->Get(isolate->GetCurrentContext(), key)
140
+                          .FromMaybe(v8::Local<v8::Value>()));
141
+}
142
+
143
+inline
144
+MaybeLocal<v8::Value> Get(v8::Local<v8::Object> obj, uint32_t index) {
145
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
146
+  v8::EscapableHandleScope scope(isolate);
147
+  return scope.Escape(obj->Get(isolate->GetCurrentContext(), index)
148
+                          .FromMaybe(v8::Local<v8::Value>()));
149
+}
150
+
151
+inline v8::PropertyAttribute GetPropertyAttributes(
152
+    v8::Local<v8::Object> obj
153
+  , v8::Local<v8::Value> key) {
154
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
155
+  v8::HandleScope scope(isolate);
156
+  return obj->GetPropertyAttributes(isolate->GetCurrentContext(), key)
157
+      .FromJust();
158
+}
159
+
160
+inline Maybe<bool> Has(
161
+    v8::Local<v8::Object> obj
162
+  , v8::Local<v8::String> key) {
163
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
164
+  v8::HandleScope scope(isolate);
165
+  return obj->Has(isolate->GetCurrentContext(), key);
166
+}
167
+
168
+inline Maybe<bool> Has(v8::Local<v8::Object> obj, uint32_t index) {
169
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
170
+  v8::HandleScope scope(isolate);
171
+  return obj->Has(isolate->GetCurrentContext(), index);
172
+}
173
+
174
+inline Maybe<bool> Delete(
175
+    v8::Local<v8::Object> obj
176
+  , v8::Local<v8::String> key) {
177
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
178
+  v8::HandleScope scope(isolate);
179
+  return obj->Delete(isolate->GetCurrentContext(), key);
180
+}
181
+
182
+inline
183
+Maybe<bool> Delete(v8::Local<v8::Object> obj, uint32_t index) {
184
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
185
+  v8::HandleScope scope(isolate);
186
+  return obj->Delete(isolate->GetCurrentContext(), index);
187
+}
188
+
189
+inline
190
+MaybeLocal<v8::Array> GetPropertyNames(v8::Local<v8::Object> obj) {
191
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
192
+  v8::EscapableHandleScope scope(isolate);
193
+  return scope.Escape(obj->GetPropertyNames(isolate->GetCurrentContext())
194
+                          .FromMaybe(v8::Local<v8::Array>()));
195
+}
196
+
197
+inline
198
+MaybeLocal<v8::Array> GetOwnPropertyNames(v8::Local<v8::Object> obj) {
199
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
200
+  v8::EscapableHandleScope scope(isolate);
201
+  return scope.Escape(obj->GetOwnPropertyNames(isolate->GetCurrentContext())
202
+                          .FromMaybe(v8::Local<v8::Array>()));
203
+}
204
+
205
+inline Maybe<bool> SetPrototype(
206
+    v8::Local<v8::Object> obj
207
+  , v8::Local<v8::Value> prototype) {
208
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
209
+  v8::HandleScope scope(isolate);
210
+  return obj->SetPrototype(isolate->GetCurrentContext(), prototype);
211
+}
212
+
213
+inline MaybeLocal<v8::String> ObjectProtoToString(
214
+    v8::Local<v8::Object> obj) {
215
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
216
+  v8::EscapableHandleScope scope(isolate);
217
+  return scope.Escape(obj->ObjectProtoToString(isolate->GetCurrentContext())
218
+                          .FromMaybe(v8::Local<v8::String>()));
219
+}
220
+
221
+inline Maybe<bool> HasOwnProperty(
222
+    v8::Local<v8::Object> obj
223
+  , v8::Local<v8::String> key) {
224
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
225
+  v8::HandleScope scope(isolate);
226
+  return obj->HasOwnProperty(isolate->GetCurrentContext(), key);
227
+}
228
+
229
+inline Maybe<bool> HasRealNamedProperty(
230
+    v8::Local<v8::Object> obj
231
+  , v8::Local<v8::String> key) {
232
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
233
+  v8::HandleScope scope(isolate);
234
+  return obj->HasRealNamedProperty(isolate->GetCurrentContext(), key);
235
+}
236
+
237
+inline Maybe<bool> HasRealIndexedProperty(
238
+    v8::Local<v8::Object> obj
239
+  , uint32_t index) {
240
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
241
+  v8::HandleScope scope(isolate);
242
+  return obj->HasRealIndexedProperty(isolate->GetCurrentContext(), index);
243
+}
244
+
245
+inline Maybe<bool> HasRealNamedCallbackProperty(
246
+    v8::Local<v8::Object> obj
247
+  , v8::Local<v8::String> key) {
248
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
249
+  v8::HandleScope scope(isolate);
250
+  return obj->HasRealNamedCallbackProperty(isolate->GetCurrentContext(), key);
251
+}
252
+
253
+inline MaybeLocal<v8::Value> GetRealNamedPropertyInPrototypeChain(
254
+    v8::Local<v8::Object> obj
255
+  , v8::Local<v8::String> key) {
256
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
257
+  v8::EscapableHandleScope scope(isolate);
258
+  return scope.Escape(obj->GetRealNamedPropertyInPrototypeChain(
259
+                             isolate->GetCurrentContext(), key)
260
+                          .FromMaybe(v8::Local<v8::Value>()));
261
+}
262
+
263
+inline MaybeLocal<v8::Value> GetRealNamedProperty(
264
+    v8::Local<v8::Object> obj
265
+  , v8::Local<v8::String> key) {
266
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
267
+  v8::EscapableHandleScope scope(isolate);
268
+  return scope.Escape(
269
+      obj->GetRealNamedProperty(isolate->GetCurrentContext(), key)
270
+          .FromMaybe(v8::Local<v8::Value>()));
271
+}
272
+
273
+inline MaybeLocal<v8::Value> CallAsFunction(
274
+    v8::Local<v8::Object> obj
275
+  , v8::Local<v8::Object> recv
276
+  , int argc
277
+  , v8::Local<v8::Value> argv[]) {
278
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
279
+  v8::EscapableHandleScope scope(isolate);
280
+  return scope.Escape(
281
+      obj->CallAsFunction(isolate->GetCurrentContext(), recv, argc, argv)
282
+          .FromMaybe(v8::Local<v8::Value>()));
283
+}
284
+
285
+inline MaybeLocal<v8::Value> CallAsConstructor(
286
+    v8::Local<v8::Object> obj
287
+  , int argc, v8::Local<v8::Value> argv[]) {
288
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
289
+  v8::EscapableHandleScope scope(isolate);
290
+  return scope.Escape(
291
+      obj->CallAsConstructor(isolate->GetCurrentContext(), argc, argv)
292
+          .FromMaybe(v8::Local<v8::Value>()));
293
+}
294
+
295
+inline
296
+MaybeLocal<v8::String> GetSourceLine(v8::Local<v8::Message> msg) {
297
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
298
+  v8::EscapableHandleScope scope(isolate);
299
+  return scope.Escape(msg->GetSourceLine(isolate->GetCurrentContext())
300
+                          .FromMaybe(v8::Local<v8::String>()));
301
+}
302
+
303
+inline Maybe<int> GetLineNumber(v8::Local<v8::Message> msg) {
304
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
305
+  v8::HandleScope scope(isolate);
306
+  return msg->GetLineNumber(isolate->GetCurrentContext());
307
+}
308
+
309
+inline Maybe<int> GetStartColumn(v8::Local<v8::Message> msg) {
310
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
311
+  v8::HandleScope scope(isolate);
312
+  return msg->GetStartColumn(isolate->GetCurrentContext());
313
+}
314
+
315
+inline Maybe<int> GetEndColumn(v8::Local<v8::Message> msg) {
316
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
317
+  v8::HandleScope scope(isolate);
318
+  return msg->GetEndColumn(isolate->GetCurrentContext());
319
+}
320
+
321
+inline MaybeLocal<v8::Object> CloneElementAt(
322
+    v8::Local<v8::Array> array
323
+  , uint32_t index) {
324
+#if (NODE_MODULE_VERSION >= NODE_6_0_MODULE_VERSION)
325
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
326
+  v8::EscapableHandleScope scope(isolate);
327
+  v8::Local<v8::Context> context = isolate->GetCurrentContext();
328
+  v8::Local<v8::Value> elem;
329
+  v8::Local<v8::Object> obj;
330
+  if (!array->Get(context, index).ToLocal(&elem)) {
331
+    return scope.Escape(obj);
332
+  }
333
+  if (!elem->ToObject(context).ToLocal(&obj)) {
334
+    return scope.Escape(v8::Local<v8::Object>());
335
+  }
336
+  return scope.Escape(obj->Clone());
337
+#else
338
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
339
+  v8::EscapableHandleScope scope(isolate);
340
+  return scope.Escape(array->CloneElementAt(isolate->GetCurrentContext(), index)
341
+                          .FromMaybe(v8::Local<v8::Object>()));
342
+#endif
343
+}
344
+
345
+inline MaybeLocal<v8::Value> Call(
346
+    v8::Local<v8::Function> fun
347
+  , v8::Local<v8::Object> recv
348
+  , int argc
349
+  , v8::Local<v8::Value> argv[]) {
350
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
351
+  v8::EscapableHandleScope scope(isolate);
352
+  return scope.Escape(fun->Call(isolate->GetCurrentContext(), recv, argc, argv)
353
+                          .FromMaybe(v8::Local<v8::Value>()));
354
+}
355
+
356
+#endif  // NAN_MAYBE_43_INL_H_
... ...
@@ -0,0 +1,268 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_MAYBE_PRE_43_INL_H_
10
+#define NAN_MAYBE_PRE_43_INL_H_
11
+
12
+template<typename T>
13
+class MaybeLocal {
14
+ public:
15
+  inline MaybeLocal() : val_(v8::Local<T>()) {}
16
+
17
+  template<typename S>
18
+# if NODE_MODULE_VERSION >= NODE_0_12_MODULE_VERSION
19
+  inline
20
+  MaybeLocal(v8::Local<S> that) : val_(that) {}  // NOLINT(runtime/explicit)
21
+# else
22
+  inline
23
+  MaybeLocal(v8::Local<S> that) :  // NOLINT(runtime/explicit)
24
+      val_(*reinterpret_cast<v8::Local<T>*>(&that)) {}
25
+# endif
26
+
27
+  inline bool IsEmpty() const { return val_.IsEmpty(); }
28
+
29
+  template<typename S>
30
+  inline bool ToLocal(v8::Local<S> *out) const {
31
+    *out = val_;
32
+    return !IsEmpty();
33
+  }
34
+
35
+  inline v8::Local<T> ToLocalChecked() const {
36
+#if defined(V8_ENABLE_CHECKS)
37
+    assert(!IsEmpty() && "ToLocalChecked is Empty");
38
+#endif  // V8_ENABLE_CHECKS
39
+    return val_;
40
+  }
41
+
42
+  template<typename S>
43
+  inline v8::Local<S> FromMaybe(v8::Local<S> default_value) const {
44
+    return IsEmpty() ? default_value : v8::Local<S>(val_);
45
+  }
46
+
47
+ private:
48
+  v8::Local<T> val_;
49
+};
50
+
51
+inline
52
+MaybeLocal<v8::String> ToDetailString(v8::Handle<v8::Value> val) {
53
+  return MaybeLocal<v8::String>(val->ToDetailString());
54
+}
55
+
56
+inline
57
+MaybeLocal<v8::Uint32> ToArrayIndex(v8::Handle<v8::Value> val) {
58
+  return MaybeLocal<v8::Uint32>(val->ToArrayIndex());
59
+}
60
+
61
+inline
62
+Maybe<bool> Equals(v8::Handle<v8::Value> a, v8::Handle<v8::Value>(b)) {
63
+  return Just<bool>(a->Equals(b));
64
+}
65
+
66
+inline
67
+MaybeLocal<v8::Object> NewInstance(v8::Handle<v8::Function> h) {
68
+  return MaybeLocal<v8::Object>(h->NewInstance());
69
+}
70
+
71
+inline
72
+MaybeLocal<v8::Object> NewInstance(
73
+      v8::Local<v8::Function> h
74
+    , int argc
75
+    , v8::Local<v8::Value> argv[]) {
76
+  return MaybeLocal<v8::Object>(h->NewInstance(argc, argv));
77
+}
78
+
79
+inline
80
+MaybeLocal<v8::Object> NewInstance(v8::Handle<v8::ObjectTemplate> h) {
81
+  return MaybeLocal<v8::Object>(h->NewInstance());
82
+}
83
+
84
+inline
85
+MaybeLocal<v8::Function> GetFunction(v8::Handle<v8::FunctionTemplate> t) {
86
+  return MaybeLocal<v8::Function>(t->GetFunction());
87
+}
88
+
89
+inline Maybe<bool> Set(
90
+    v8::Handle<v8::Object> obj
91
+  , v8::Handle<v8::Value> key
92
+  , v8::Handle<v8::Value> value) {
93
+  return Just<bool>(obj->Set(key, value));
94
+}
95
+
96
+inline Maybe<bool> Set(
97
+    v8::Handle<v8::Object> obj
98
+  , uint32_t index
99
+  , v8::Handle<v8::Value> value) {
100
+  return Just<bool>(obj->Set(index, value));
101
+}
102
+
103
+#include "nan_define_own_property_helper.h"  // NOLINT(build/include)
104
+
105
+inline Maybe<bool> DefineOwnProperty(
106
+    v8::Handle<v8::Object> obj
107
+  , v8::Handle<v8::String> key
108
+  , v8::Handle<v8::Value> value
109
+  , v8::PropertyAttribute attribs = v8::None) {
110
+  v8::PropertyAttribute current = obj->GetPropertyAttributes(key);
111
+  return imp::DefineOwnPropertyHelper(current, obj, key, value, attribs);
112
+}
113
+
114
+NAN_DEPRECATED inline Maybe<bool> ForceSet(
115
+    v8::Handle<v8::Object> obj
116
+  , v8::Handle<v8::Value> key
117
+  , v8::Handle<v8::Value> value
118
+  , v8::PropertyAttribute attribs = v8::None) {
119
+  return Just<bool>(obj->ForceSet(key, value, attribs));
120
+}
121
+
122
+inline MaybeLocal<v8::Value> Get(
123
+    v8::Handle<v8::Object> obj
124
+  , v8::Handle<v8::Value> key) {
125
+  return MaybeLocal<v8::Value>(obj->Get(key));
126
+}
127
+
128
+inline MaybeLocal<v8::Value> Get(
129
+    v8::Handle<v8::Object> obj
130
+  , uint32_t index) {
131
+  return MaybeLocal<v8::Value>(obj->Get(index));
132
+}
133
+
134
+inline Maybe<v8::PropertyAttribute> GetPropertyAttributes(
135
+    v8::Handle<v8::Object> obj
136
+  , v8::Handle<v8::Value> key) {
137
+  return Just<v8::PropertyAttribute>(obj->GetPropertyAttributes(key));
138
+}
139
+
140
+inline Maybe<bool> Has(
141
+    v8::Handle<v8::Object> obj
142
+  , v8::Handle<v8::String> key) {
143
+  return Just<bool>(obj->Has(key));
144
+}
145
+
146
+inline Maybe<bool> Has(
147
+    v8::Handle<v8::Object> obj
148
+  , uint32_t index) {
149
+  return Just<bool>(obj->Has(index));
150
+}
151
+
152
+inline Maybe<bool> Delete(
153
+    v8::Handle<v8::Object> obj
154
+  , v8::Handle<v8::String> key) {
155
+  return Just<bool>(obj->Delete(key));
156
+}
157
+
158
+inline Maybe<bool> Delete(
159
+    v8::Handle<v8::Object> obj
160
+  , uint32_t index) {
161
+  return Just<bool>(obj->Delete(index));
162
+}
163
+
164
+inline
165
+MaybeLocal<v8::Array> GetPropertyNames(v8::Handle<v8::Object> obj) {
166
+  return MaybeLocal<v8::Array>(obj->GetPropertyNames());
167
+}
168
+
169
+inline
170
+MaybeLocal<v8::Array> GetOwnPropertyNames(v8::Handle<v8::Object> obj) {
171
+  return MaybeLocal<v8::Array>(obj->GetOwnPropertyNames());
172
+}
173
+
174
+inline Maybe<bool> SetPrototype(
175
+    v8::Handle<v8::Object> obj
176
+  , v8::Handle<v8::Value> prototype) {
177
+  return Just<bool>(obj->SetPrototype(prototype));
178
+}
179
+
180
+inline MaybeLocal<v8::String> ObjectProtoToString(
181
+    v8::Handle<v8::Object> obj) {
182
+  return MaybeLocal<v8::String>(obj->ObjectProtoToString());
183
+}
184
+
185
+inline Maybe<bool> HasOwnProperty(
186
+    v8::Handle<v8::Object> obj
187
+  , v8::Handle<v8::String> key) {
188
+  return Just<bool>(obj->HasOwnProperty(key));
189
+}
190
+
191
+inline Maybe<bool> HasRealNamedProperty(
192
+    v8::Handle<v8::Object> obj
193
+  , v8::Handle<v8::String> key) {
194
+  return Just<bool>(obj->HasRealNamedProperty(key));
195
+}
196
+
197
+inline Maybe<bool> HasRealIndexedProperty(
198
+    v8::Handle<v8::Object> obj
199
+  , uint32_t index) {
200
+  return Just<bool>(obj->HasRealIndexedProperty(index));
201
+}
202
+
203
+inline Maybe<bool> HasRealNamedCallbackProperty(
204
+    v8::Handle<v8::Object> obj
205
+  , v8::Handle<v8::String> key) {
206
+  return Just<bool>(obj->HasRealNamedCallbackProperty(key));
207
+}
208
+
209
+inline MaybeLocal<v8::Value> GetRealNamedPropertyInPrototypeChain(
210
+    v8::Handle<v8::Object> obj
211
+  , v8::Handle<v8::String> key) {
212
+  return MaybeLocal<v8::Value>(
213
+      obj->GetRealNamedPropertyInPrototypeChain(key));
214
+}
215
+
216
+inline MaybeLocal<v8::Value> GetRealNamedProperty(
217
+    v8::Handle<v8::Object> obj
218
+  , v8::Handle<v8::String> key) {
219
+  return MaybeLocal<v8::Value>(obj->GetRealNamedProperty(key));
220
+}
221
+
222
+inline MaybeLocal<v8::Value> CallAsFunction(
223
+    v8::Handle<v8::Object> obj
224
+  , v8::Handle<v8::Object> recv
225
+  , int argc
226
+  , v8::Handle<v8::Value> argv[]) {
227
+  return MaybeLocal<v8::Value>(obj->CallAsFunction(recv, argc, argv));
228
+}
229
+
230
+inline MaybeLocal<v8::Value> CallAsConstructor(
231
+    v8::Handle<v8::Object> obj
232
+  , int argc
233
+  , v8::Local<v8::Value> argv[]) {
234
+  return MaybeLocal<v8::Value>(obj->CallAsConstructor(argc, argv));
235
+}
236
+
237
+inline
238
+MaybeLocal<v8::String> GetSourceLine(v8::Handle<v8::Message> msg) {
239
+  return MaybeLocal<v8::String>(msg->GetSourceLine());
240
+}
241
+
242
+inline Maybe<int> GetLineNumber(v8::Handle<v8::Message> msg) {
243
+  return Just<int>(msg->GetLineNumber());
244
+}
245
+
246
+inline Maybe<int> GetStartColumn(v8::Handle<v8::Message> msg) {
247
+  return Just<int>(msg->GetStartColumn());
248
+}
249
+
250
+inline Maybe<int> GetEndColumn(v8::Handle<v8::Message> msg) {
251
+  return Just<int>(msg->GetEndColumn());
252
+}
253
+
254
+inline MaybeLocal<v8::Object> CloneElementAt(
255
+    v8::Handle<v8::Array> array
256
+  , uint32_t index) {
257
+  return MaybeLocal<v8::Object>(array->CloneElementAt(index));
258
+}
259
+
260
+inline MaybeLocal<v8::Value> Call(
261
+    v8::Local<v8::Function> fun
262
+  , v8::Local<v8::Object> recv
263
+  , int argc
264
+  , v8::Local<v8::Value> argv[]) {
265
+  return MaybeLocal<v8::Value>(fun->Call(recv, argc, argv));
266
+}
267
+
268
+#endif  // NAN_MAYBE_PRE_43_INL_H_
... ...
@@ -0,0 +1,340 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_NEW_H_
10
+#define NAN_NEW_H_
11
+
12
+namespace imp {  // scnr
13
+
14
+// TODO(agnat): Generalize
15
+template <typename T> v8::Local<T> To(v8::Local<v8::Integer> i);
16
+
17
+template <>
18
+inline
19
+v8::Local<v8::Integer>
20
+To<v8::Integer>(v8::Local<v8::Integer> i) {
21
+  return Nan::To<v8::Integer>(i).ToLocalChecked();
22
+}
23
+
24
+template <>
25
+inline
26
+v8::Local<v8::Int32>
27
+To<v8::Int32>(v8::Local<v8::Integer> i) {
28
+  return Nan::To<v8::Int32>(i).ToLocalChecked();
29
+}
30
+
31
+template <>
32
+inline
33
+v8::Local<v8::Uint32>
34
+To<v8::Uint32>(v8::Local<v8::Integer> i) {
35
+  return Nan::To<v8::Uint32>(i).ToLocalChecked();
36
+}
37
+
38
+template <typename T> struct FactoryBase {
39
+  typedef v8::Local<T> return_t;
40
+};
41
+
42
+template <typename T> struct MaybeFactoryBase {
43
+  typedef MaybeLocal<T> return_t;
44
+};
45
+
46
+template <typename T> struct Factory;
47
+
48
+template <>
49
+struct Factory<v8::Array> : FactoryBase<v8::Array> {
50
+  static inline return_t New();
51
+  static inline return_t New(int length);
52
+};
53
+
54
+template <>
55
+struct Factory<v8::Boolean> : FactoryBase<v8::Boolean> {
56
+  static inline return_t New(bool value);
57
+};
58
+
59
+template <>
60
+struct Factory<v8::BooleanObject> : FactoryBase<v8::BooleanObject> {
61
+  static inline return_t New(bool value);
62
+};
63
+
64
+template <>
65
+struct Factory<v8::Context> : FactoryBase<v8::Context> {
66
+  static inline
67
+  return_t
68
+  New( v8::ExtensionConfiguration* extensions = NULL
69
+     , v8::Local<v8::ObjectTemplate> tmpl = v8::Local<v8::ObjectTemplate>()
70
+     , v8::Local<v8::Value> obj = v8::Local<v8::Value>());
71
+};
72
+
73
+template <>
74
+struct Factory<v8::Date> : MaybeFactoryBase<v8::Date> {
75
+  static inline return_t New(double value);
76
+};
77
+
78
+template <>
79
+struct Factory<v8::External> : FactoryBase<v8::External> {
80
+  static inline return_t New(void *value);
81
+};
82
+
83
+template <>
84
+struct Factory<v8::Function> : FactoryBase<v8::Function> {
85
+  static inline
86
+  return_t
87
+  New( FunctionCallback callback
88
+     , v8::Local<v8::Value> data = v8::Local<v8::Value>());
89
+};
90
+
91
+template <>
92
+struct Factory<v8::FunctionTemplate> : FactoryBase<v8::FunctionTemplate> {
93
+  static inline
94
+  return_t
95
+  New( FunctionCallback callback = NULL
96
+     , v8::Local<v8::Value> data = v8::Local<v8::Value>()
97
+     , v8::Local<v8::Signature> signature = v8::Local<v8::Signature>());
98
+};
99
+
100
+template <>
101
+struct Factory<v8::Number> : FactoryBase<v8::Number> {
102
+  static inline return_t New(double value);
103
+};
104
+
105
+template <>
106
+struct Factory<v8::NumberObject> : FactoryBase<v8::NumberObject> {
107
+  static inline return_t New(double value);
108
+};
109
+
110
+template <typename T>
111
+struct IntegerFactory : FactoryBase<T> {
112
+  typedef typename FactoryBase<T>::return_t return_t;
113
+  static inline return_t New(int32_t value);
114
+  static inline return_t New(uint32_t value);
115
+};
116
+
117
+template <>
118
+struct Factory<v8::Integer> : IntegerFactory<v8::Integer> {};
119
+
120
+template <>
121
+struct Factory<v8::Int32> : IntegerFactory<v8::Int32> {};
122
+
123
+template <>
124
+struct Factory<v8::Uint32> : FactoryBase<v8::Uint32> {
125
+  static inline return_t New(int32_t value);
126
+  static inline return_t New(uint32_t value);
127
+};
128
+
129
+template <>
130
+struct Factory<v8::Object> : FactoryBase<v8::Object> {
131
+  static inline return_t New();
132
+};
133
+
134
+template <>
135
+struct Factory<v8::ObjectTemplate> : FactoryBase<v8::ObjectTemplate> {
136
+  static inline return_t New();
137
+};
138
+
139
+template <>
140
+struct Factory<v8::RegExp> : MaybeFactoryBase<v8::RegExp> {
141
+  static inline return_t New(
142
+      v8::Local<v8::String> pattern, v8::RegExp::Flags flags);
143
+};
144
+
145
+template <>
146
+struct Factory<v8::Script> : MaybeFactoryBase<v8::Script> {
147
+  static inline return_t New( v8::Local<v8::String> source);
148
+  static inline return_t New( v8::Local<v8::String> source
149
+                            , v8::ScriptOrigin const& origin);
150
+};
151
+
152
+template <>
153
+struct Factory<v8::Signature> : FactoryBase<v8::Signature> {
154
+  typedef v8::Local<v8::FunctionTemplate> FTH;
155
+  static inline return_t New(FTH receiver = FTH());
156
+};
157
+
158
+template <>
159
+struct Factory<v8::String> : MaybeFactoryBase<v8::String> {
160
+  static inline return_t New();
161
+  static inline return_t New(const char *value, int length = -1);
162
+  static inline return_t New(const uint16_t *value, int length = -1);
163
+  static inline return_t New(std::string const& value);
164
+
165
+  static inline return_t New(v8::String::ExternalStringResource * value);
166
+  static inline return_t New(ExternalOneByteStringResource * value);
167
+};
168
+
169
+template <>
170
+struct Factory<v8::StringObject> : FactoryBase<v8::StringObject> {
171
+  static inline return_t New(v8::Local<v8::String> value);
172
+};
173
+
174
+}  // end of namespace imp
175
+
176
+#if (NODE_MODULE_VERSION >= 12)
177
+
178
+namespace imp {
179
+
180
+template <>
181
+struct Factory<v8::UnboundScript> : MaybeFactoryBase<v8::UnboundScript> {
182
+  static inline return_t New( v8::Local<v8::String> source);
183
+  static inline return_t New( v8::Local<v8::String> source
184
+                            , v8::ScriptOrigin const& origin);
185
+};
186
+
187
+}  // end of namespace imp
188
+
189
+# include "nan_implementation_12_inl.h"
190
+
191
+#else  // NODE_MODULE_VERSION >= 12
192
+
193
+# include "nan_implementation_pre_12_inl.h"
194
+
195
+#endif
196
+
197
+//=== API ======================================================================
198
+
199
+template <typename T>
200
+typename imp::Factory<T>::return_t
201
+New() {
202
+  return imp::Factory<T>::New();
203
+}
204
+
205
+template <typename T, typename A0>
206
+typename imp::Factory<T>::return_t
207
+New(A0 arg0) {
208
+  return imp::Factory<T>::New(arg0);
209
+}
210
+
211
+template <typename T, typename A0, typename A1>
212
+typename imp::Factory<T>::return_t
213
+New(A0 arg0, A1 arg1) {
214
+  return imp::Factory<T>::New(arg0, arg1);
215
+}
216
+
217
+template <typename T, typename A0, typename A1, typename A2>
218
+typename imp::Factory<T>::return_t
219
+New(A0 arg0, A1 arg1, A2 arg2) {
220
+  return imp::Factory<T>::New(arg0, arg1, arg2);
221
+}
222
+
223
+template <typename T, typename A0, typename A1, typename A2, typename A3>
224
+typename imp::Factory<T>::return_t
225
+New(A0 arg0, A1 arg1, A2 arg2, A3 arg3) {
226
+  return imp::Factory<T>::New(arg0, arg1, arg2, arg3);
227
+}
228
+
229
+// Note(agnat): When passing overloaded function pointers to template functions
230
+// as generic arguments the compiler needs help in picking the right overload.
231
+// These two functions handle New<Function> and New<FunctionTemplate> with
232
+// all argument variations.
233
+
234
+// v8::Function and v8::FunctionTemplate with one or two arguments
235
+template <typename T>
236
+typename imp::Factory<T>::return_t
237
+New( FunctionCallback callback
238
+      , v8::Local<v8::Value> data = v8::Local<v8::Value>()) {
239
+    return imp::Factory<T>::New(callback, data);
240
+}
241
+
242
+// v8::Function and v8::FunctionTemplate with three arguments
243
+template <typename T, typename A2>
244
+typename imp::Factory<T>::return_t
245
+New( FunctionCallback callback
246
+      , v8::Local<v8::Value> data = v8::Local<v8::Value>()
247
+      , A2 a2 = A2()) {
248
+    return imp::Factory<T>::New(callback, data, a2);
249
+}
250
+
251
+// Convenience
252
+
253
+#if NODE_MODULE_VERSION < IOJS_3_0_MODULE_VERSION
254
+template <typename T> inline v8::Local<T> New(v8::Handle<T> h);
255
+#endif
256
+
257
+#if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
258
+template <typename T, typename M>
259
+    inline v8::Local<T> New(v8::Persistent<T, M> const& p);
260
+#else
261
+template <typename T> inline v8::Local<T> New(v8::Persistent<T> const& p);
262
+#endif
263
+template <typename T, typename M>
264
+inline v8::Local<T> New(Persistent<T, M> const& p);
265
+template <typename T>
266
+inline v8::Local<T> New(Global<T> const& p);
267
+
268
+inline
269
+imp::Factory<v8::Boolean>::return_t
270
+New(bool value) {
271
+  return New<v8::Boolean>(value);
272
+}
273
+
274
+inline
275
+imp::Factory<v8::Int32>::return_t
276
+New(int32_t value) {
277
+  return New<v8::Int32>(value);
278
+}
279
+
280
+inline
281
+imp::Factory<v8::Uint32>::return_t
282
+New(uint32_t value) {
283
+  return New<v8::Uint32>(value);
284
+}
285
+
286
+inline
287
+imp::Factory<v8::Number>::return_t
288
+New(double value) {
289
+  return New<v8::Number>(value);
290
+}
291
+
292
+inline
293
+imp::Factory<v8::String>::return_t
294
+New(std::string const& value) {  // NOLINT(build/include_what_you_use)
295
+  return New<v8::String>(value);
296
+}
297
+
298
+inline
299
+imp::Factory<v8::String>::return_t
300
+New(const char * value, int length) {
301
+  return New<v8::String>(value, length);
302
+}
303
+
304
+inline
305
+imp::Factory<v8::String>::return_t
306
+New(const uint16_t * value, int length) {
307
+  return New<v8::String>(value, length);
308
+}
309
+
310
+inline
311
+imp::Factory<v8::String>::return_t
312
+New(const char * value) {
313
+  return New<v8::String>(value);
314
+}
315
+
316
+inline
317
+imp::Factory<v8::String>::return_t
318
+New(const uint16_t * value) {
319
+  return New<v8::String>(value);
320
+}
321
+
322
+inline
323
+imp::Factory<v8::String>::return_t
324
+New(v8::String::ExternalStringResource * value) {
325
+  return New<v8::String>(value);
326
+}
327
+
328
+inline
329
+imp::Factory<v8::String>::return_t
330
+New(ExternalOneByteStringResource * value) {
331
+  return New<v8::String>(value);
332
+}
333
+
334
+inline
335
+imp::Factory<v8::RegExp>::return_t
336
+New(v8::Local<v8::String> pattern, v8::RegExp::Flags flags) {
337
+  return New<v8::RegExp>(pattern, flags);
338
+}
339
+
340
+#endif  // NAN_NEW_H_
... ...
@@ -0,0 +1,156 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_OBJECT_WRAP_H_
10
+#define NAN_OBJECT_WRAP_H_
11
+
12
+class ObjectWrap {
13
+ public:
14
+  ObjectWrap() {
15
+    refs_ = 0;
16
+  }
17
+
18
+
19
+  virtual ~ObjectWrap() {
20
+    if (persistent().IsEmpty()) {
21
+      return;
22
+    }
23
+
24
+    persistent().ClearWeak();
25
+    persistent().Reset();
26
+  }
27
+
28
+
29
+  template <class T>
30
+  static inline T* Unwrap(v8::Local<v8::Object> object) {
31
+    assert(!object.IsEmpty());
32
+    assert(object->InternalFieldCount() > 0);
33
+    // Cast to ObjectWrap before casting to T.  A direct cast from void
34
+    // to T won't work right when T has more than one base class.
35
+    void* ptr = GetInternalFieldPointer(object, 0);
36
+    ObjectWrap* wrap = static_cast<ObjectWrap*>(ptr);
37
+    return static_cast<T*>(wrap);
38
+  }
39
+
40
+
41
+  inline v8::Local<v8::Object> handle() const {
42
+    return New(handle_);
43
+  }
44
+
45
+
46
+  inline Persistent<v8::Object>& persistent() {
47
+    return handle_;
48
+  }
49
+
50
+
51
+ protected:
52
+  inline void Wrap(v8::Local<v8::Object> object) {
53
+    assert(persistent().IsEmpty());
54
+    assert(object->InternalFieldCount() > 0);
55
+    SetInternalFieldPointer(object, 0, this);
56
+    persistent().Reset(object);
57
+    MakeWeak();
58
+  }
59
+
60
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
61
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
62
+
63
+  inline void MakeWeak() {
64
+    persistent().v8::PersistentBase<v8::Object>::SetWeak(
65
+        this, WeakCallback, v8::WeakCallbackType::kParameter);
66
+#if NODE_MAJOR_VERSION < 10
67
+    // FIXME(bnoordhuis) Probably superfluous in older Node.js versions too.
68
+    persistent().MarkIndependent();
69
+#endif
70
+  }
71
+
72
+#elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
73
+
74
+  inline void MakeWeak() {
75
+    persistent().v8::PersistentBase<v8::Object>::SetWeak(this, WeakCallback);
76
+    persistent().MarkIndependent();
77
+  }
78
+
79
+#else
80
+
81
+  inline void MakeWeak() {
82
+    persistent().persistent.MakeWeak(this, WeakCallback);
83
+    persistent().MarkIndependent();
84
+  }
85
+
86
+#endif
87
+
88
+  /* Ref() marks the object as being attached to an event loop.
89
+   * Refed objects will not be garbage collected, even if
90
+   * all references are lost.
91
+   */
92
+  virtual void Ref() {
93
+    assert(!persistent().IsEmpty());
94
+    persistent().ClearWeak();
95
+    refs_++;
96
+  }
97
+
98
+  /* Unref() marks an object as detached from the event loop.  This is its
99
+   * default state.  When an object with a "weak" reference changes from
100
+   * attached to detached state it will be freed. Be careful not to access
101
+   * the object after making this call as it might be gone!
102
+   * (A "weak reference" means an object that only has a
103
+   * persistent handle.)
104
+   *
105
+   * DO NOT CALL THIS FROM DESTRUCTOR
106
+   */
107
+  virtual void Unref() {
108
+    assert(!persistent().IsEmpty());
109
+    assert(!persistent().IsWeak());
110
+    assert(refs_ > 0);
111
+    if (--refs_ == 0)
112
+      MakeWeak();
113
+  }
114
+
115
+  int refs_;  // ro
116
+
117
+ private:
118
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(ObjectWrap)
119
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
120
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
121
+
122
+  static void
123
+  WeakCallback(v8::WeakCallbackInfo<ObjectWrap> const& info) {
124
+    ObjectWrap* wrap = info.GetParameter();
125
+    assert(wrap->refs_ == 0);
126
+    wrap->handle_.Reset();
127
+    delete wrap;
128
+  }
129
+
130
+#elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
131
+
132
+  static void
133
+  WeakCallback(v8::WeakCallbackData<v8::Object, ObjectWrap> const& data) {
134
+    ObjectWrap* wrap = data.GetParameter();
135
+    assert(wrap->refs_ == 0);
136
+    assert(wrap->handle_.IsNearDeath());
137
+    wrap->handle_.Reset();
138
+    delete wrap;
139
+  }
140
+
141
+#else
142
+
143
+  static void WeakCallback(v8::Persistent<v8::Value> value, void *data) {
144
+    ObjectWrap *wrap = static_cast<ObjectWrap*>(data);
145
+    assert(wrap->refs_ == 0);
146
+    assert(wrap->handle_.IsNearDeath());
147
+    wrap->handle_.Reset();
148
+    delete wrap;
149
+  }
150
+
151
+#endif
152
+  Persistent<v8::Object> handle_;
153
+};
154
+
155
+
156
+#endif  // NAN_OBJECT_WRAP_H_
... ...
@@ -0,0 +1,132 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_PERSISTENT_12_INL_H_
10
+#define NAN_PERSISTENT_12_INL_H_
11
+
12
+template<typename T, typename M> class Persistent :
13
+    public v8::Persistent<T, M> {
14
+ public:
15
+  inline Persistent() : v8::Persistent<T, M>() {}
16
+
17
+  template<typename S> inline Persistent(v8::Local<S> that) :
18
+      v8::Persistent<T, M>(v8::Isolate::GetCurrent(), that) {}
19
+
20
+  template<typename S, typename M2>
21
+  inline
22
+  Persistent(const v8::Persistent<S, M2> &that) :  // NOLINT(runtime/explicit)
23
+      v8::Persistent<T, M2>(v8::Isolate::GetCurrent(), that) {}
24
+
25
+  inline void Reset() { v8::PersistentBase<T>::Reset(); }
26
+
27
+  template <typename S>
28
+  inline void Reset(const v8::Local<S> &other) {
29
+    v8::PersistentBase<T>::Reset(v8::Isolate::GetCurrent(), other);
30
+  }
31
+
32
+  template <typename S>
33
+  inline void Reset(const v8::PersistentBase<S> &other) {
34
+    v8::PersistentBase<T>::Reset(v8::Isolate::GetCurrent(), other);
35
+  }
36
+
37
+  template<typename P>
38
+  inline void SetWeak(
39
+    P *parameter
40
+    , typename WeakCallbackInfo<P>::Callback callback
41
+    , WeakCallbackType type);
42
+
43
+ private:
44
+  inline T *operator*() const { return *PersistentBase<T>::persistent; }
45
+
46
+  template<typename S, typename M2>
47
+  inline void Copy(const Persistent<S, M2> &that) {
48
+    TYPE_CHECK(T, S);
49
+
50
+    this->Reset();
51
+
52
+    if (!that.IsEmpty()) {
53
+      this->Reset(that);
54
+      M::Copy(that, this);
55
+    }
56
+  }
57
+};
58
+
59
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
60
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
61
+template<typename T>
62
+class Global : public v8::Global<T> {
63
+ public:
64
+  inline Global() : v8::Global<T>() {}
65
+
66
+  template<typename S> inline Global(v8::Local<S> that) :
67
+    v8::Global<T>(v8::Isolate::GetCurrent(), that) {}
68
+
69
+  template<typename S>
70
+  inline
71
+  Global(const v8::PersistentBase<S> &that) :  // NOLINT(runtime/explicit)
72
+      v8::Global<S>(v8::Isolate::GetCurrent(), that) {}
73
+
74
+  inline void Reset() { v8::PersistentBase<T>::Reset(); }
75
+
76
+  template <typename S>
77
+  inline void Reset(const v8::Local<S> &other) {
78
+    v8::PersistentBase<T>::Reset(v8::Isolate::GetCurrent(), other);
79
+  }
80
+
81
+  template <typename S>
82
+  inline void Reset(const v8::PersistentBase<S> &other) {
83
+    v8::PersistentBase<T>::Reset(v8::Isolate::GetCurrent(), other);
84
+  }
85
+
86
+  template<typename P>
87
+  inline void SetWeak(
88
+    P *parameter
89
+    , typename WeakCallbackInfo<P>::Callback callback
90
+    , WeakCallbackType type) {
91
+    reinterpret_cast<Persistent<T>*>(this)->SetWeak(
92
+        parameter, callback, type);
93
+  }
94
+};
95
+#else
96
+template<typename T>
97
+class Global : public v8::UniquePersistent<T> {
98
+ public:
99
+  inline Global() : v8::UniquePersistent<T>() {}
100
+
101
+  template<typename S> inline Global(v8::Local<S> that) :
102
+    v8::UniquePersistent<T>(v8::Isolate::GetCurrent(), that) {}
103
+
104
+  template<typename S>
105
+  inline
106
+  Global(const v8::PersistentBase<S> &that) :  // NOLINT(runtime/explicit)
107
+      v8::UniquePersistent<S>(v8::Isolate::GetCurrent(), that) {}
108
+
109
+  inline void Reset() { v8::PersistentBase<T>::Reset(); }
110
+
111
+  template <typename S>
112
+  inline void Reset(const v8::Local<S> &other) {
113
+    v8::PersistentBase<T>::Reset(v8::Isolate::GetCurrent(), other);
114
+  }
115
+
116
+  template <typename S>
117
+  inline void Reset(const v8::PersistentBase<S> &other) {
118
+    v8::PersistentBase<T>::Reset(v8::Isolate::GetCurrent(), other);
119
+  }
120
+
121
+  template<typename P>
122
+  inline void SetWeak(
123
+    P *parameter
124
+    , typename WeakCallbackInfo<P>::Callback callback
125
+    , WeakCallbackType type) {
126
+    reinterpret_cast<Persistent<T>*>(this)->SetWeak(
127
+        parameter, callback, type);
128
+  }
129
+};
130
+#endif
131
+
132
+#endif  // NAN_PERSISTENT_12_INL_H_
... ...
@@ -0,0 +1,242 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_PERSISTENT_PRE_12_INL_H_
10
+#define NAN_PERSISTENT_PRE_12_INL_H_
11
+
12
+template<typename T>
13
+class PersistentBase {
14
+  v8::Persistent<T> persistent;
15
+  template<typename U>
16
+  friend v8::Local<U> New(const PersistentBase<U> &p);
17
+  template<typename U, typename M>
18
+  friend v8::Local<U> New(const Persistent<U, M> &p);
19
+  template<typename U>
20
+  friend v8::Local<U> New(const Global<U> &p);
21
+  template<typename S> friend class ReturnValue;
22
+
23
+ public:
24
+  inline PersistentBase() :
25
+      persistent() {}
26
+
27
+  inline void Reset() {
28
+    persistent.Dispose();
29
+    persistent.Clear();
30
+  }
31
+
32
+  template<typename S>
33
+  inline void Reset(const v8::Local<S> &other) {
34
+    TYPE_CHECK(T, S);
35
+
36
+    if (!persistent.IsEmpty()) {
37
+      persistent.Dispose();
38
+    }
39
+
40
+    if (other.IsEmpty()) {
41
+      persistent.Clear();
42
+    } else {
43
+      persistent = v8::Persistent<T>::New(other);
44
+    }
45
+  }
46
+
47
+  template<typename S>
48
+  inline void Reset(const PersistentBase<S> &other) {
49
+    TYPE_CHECK(T, S);
50
+
51
+    if (!persistent.IsEmpty()) {
52
+      persistent.Dispose();
53
+    }
54
+
55
+    if (other.IsEmpty()) {
56
+      persistent.Clear();
57
+    } else {
58
+      persistent = v8::Persistent<T>::New(other.persistent);
59
+    }
60
+  }
61
+
62
+  inline bool IsEmpty() const { return persistent.IsEmpty(); }
63
+
64
+  inline void Empty() { persistent.Clear(); }
65
+
66
+  template<typename S>
67
+  inline bool operator==(const PersistentBase<S> &that) const {
68
+    return this->persistent == that.persistent;
69
+  }
70
+
71
+  template<typename S>
72
+  inline bool operator==(const v8::Local<S> &that) const {
73
+    return this->persistent == that;
74
+  }
75
+
76
+  template<typename S>
77
+  inline bool operator!=(const PersistentBase<S> &that) const {
78
+    return !operator==(that);
79
+  }
80
+
81
+  template<typename S>
82
+  inline bool operator!=(const v8::Local<S> &that) const {
83
+    return !operator==(that);
84
+  }
85
+
86
+  template<typename P>
87
+  inline void SetWeak(
88
+    P *parameter
89
+    , typename WeakCallbackInfo<P>::Callback callback
90
+    , WeakCallbackType type);
91
+
92
+  inline void ClearWeak() { persistent.ClearWeak(); }
93
+
94
+  inline void MarkIndependent() { persistent.MarkIndependent(); }
95
+
96
+  inline bool IsIndependent() const { return persistent.IsIndependent(); }
97
+
98
+  inline bool IsNearDeath() const { return persistent.IsNearDeath(); }
99
+
100
+  inline bool IsWeak() const { return persistent.IsWeak(); }
101
+
102
+ private:
103
+  inline explicit PersistentBase(v8::Persistent<T> that) :
104
+      persistent(that) { }
105
+  inline explicit PersistentBase(T *val) : persistent(val) {}
106
+  template<typename S, typename M> friend class Persistent;
107
+  template<typename S> friend class Global;
108
+  friend class ObjectWrap;
109
+};
110
+
111
+template<typename T>
112
+class NonCopyablePersistentTraits {
113
+ public:
114
+  typedef Persistent<T, NonCopyablePersistentTraits<T> >
115
+      NonCopyablePersistent;
116
+  static const bool kResetInDestructor = false;
117
+  template<typename S, typename M>
118
+  inline static void Copy(const Persistent<S, M> &source,
119
+                             NonCopyablePersistent *dest) {
120
+    Uncompilable<v8::Object>();
121
+  }
122
+
123
+  template<typename O> inline static void Uncompilable() {
124
+    TYPE_CHECK(O, v8::Primitive);
125
+  }
126
+};
127
+
128
+template<typename T>
129
+struct CopyablePersistentTraits {
130
+  typedef Persistent<T, CopyablePersistentTraits<T> > CopyablePersistent;
131
+  static const bool kResetInDestructor = true;
132
+  template<typename S, typename M>
133
+  static inline void Copy(const Persistent<S, M> &source,
134
+                             CopyablePersistent *dest) {}
135
+};
136
+
137
+template<typename T, typename M> class Persistent :
138
+    public PersistentBase<T> {
139
+ public:
140
+  inline Persistent() {}
141
+
142
+  template<typename S> inline Persistent(v8::Handle<S> that)
143
+      : PersistentBase<T>(v8::Persistent<T>::New(that)) {
144
+    TYPE_CHECK(T, S);
145
+  }
146
+
147
+  inline Persistent(const Persistent &that) : PersistentBase<T>() {
148
+    Copy(that);
149
+  }
150
+
151
+  template<typename S, typename M2>
152
+  inline Persistent(const Persistent<S, M2> &that) :
153
+      PersistentBase<T>() {
154
+    Copy(that);
155
+  }
156
+
157
+  inline Persistent &operator=(const Persistent &that) {
158
+    Copy(that);
159
+    return *this;
160
+  }
161
+
162
+  template <class S, class M2>
163
+  inline Persistent &operator=(const Persistent<S, M2> &that) {
164
+    Copy(that);
165
+    return *this;
166
+  }
167
+
168
+  inline ~Persistent() {
169
+    if (M::kResetInDestructor) this->Reset();
170
+  }
171
+
172
+ private:
173
+  inline T *operator*() const { return *PersistentBase<T>::persistent; }
174
+
175
+  template<typename S, typename M2>
176
+  inline void Copy(const Persistent<S, M2> &that) {
177
+    TYPE_CHECK(T, S);
178
+
179
+    this->Reset();
180
+
181
+    if (!that.IsEmpty()) {
182
+      this->persistent = v8::Persistent<T>::New(that.persistent);
183
+      M::Copy(that, this);
184
+    }
185
+  }
186
+};
187
+
188
+template<typename T>
189
+class Global : public PersistentBase<T> {
190
+  struct RValue {
191
+    inline explicit RValue(Global* obj) : object(obj) {}
192
+    Global* object;
193
+  };
194
+
195
+ public:
196
+  inline Global() : PersistentBase<T>(0) { }
197
+
198
+  template <typename S>
199
+  inline Global(v8::Local<S> that)  // NOLINT(runtime/explicit)
200
+      : PersistentBase<T>(v8::Persistent<T>::New(that)) {
201
+    TYPE_CHECK(T, S);
202
+  }
203
+
204
+  template <typename S>
205
+  inline Global(const PersistentBase<S> &that)  // NOLINT(runtime/explicit)
206
+    : PersistentBase<T>(that) {
207
+    TYPE_CHECK(T, S);
208
+  }
209
+  /**
210
+   * Move constructor.
211
+   */
212
+  inline Global(RValue rvalue)  // NOLINT(runtime/explicit)
213
+    : PersistentBase<T>(rvalue.object->persistent) {
214
+    rvalue.object->Reset();
215
+  }
216
+  inline ~Global() { this->Reset(); }
217
+  /**
218
+   * Move via assignment.
219
+   */
220
+  template<typename S>
221
+  inline Global &operator=(Global<S> rhs) {
222
+    TYPE_CHECK(T, S);
223
+    this->Reset(rhs.persistent);
224
+    rhs.Reset();
225
+    return *this;
226
+  }
227
+  /**
228
+   * Cast operator for moves.
229
+   */
230
+  inline operator RValue() { return RValue(this); }
231
+  /**
232
+   * Pass allows returning uniques from functions, etc.
233
+   */
234
+  Global Pass() { return Global(RValue(this)); }
235
+
236
+ private:
237
+  Global(Global &);
238
+  void operator=(Global &);
239
+  template<typename S> friend class ReturnValue;
240
+};
241
+
242
+#endif  // NAN_PERSISTENT_PRE_12_INL_H_
... ...
@@ -0,0 +1,73 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_PRIVATE_H_
10
+#define NAN_PRIVATE_H_
11
+
12
+inline Maybe<bool>
13
+HasPrivate(v8::Local<v8::Object> object, v8::Local<v8::String> key) {
14
+  HandleScope scope;
15
+#if NODE_MODULE_VERSION >= NODE_6_0_MODULE_VERSION
16
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
17
+  v8::Local<v8::Context> context = isolate->GetCurrentContext();
18
+  v8::Local<v8::Private> private_key = v8::Private::ForApi(isolate, key);
19
+  return object->HasPrivate(context, private_key);
20
+#else
21
+  return Just(!object->GetHiddenValue(key).IsEmpty());
22
+#endif
23
+}
24
+
25
+inline MaybeLocal<v8::Value>
26
+GetPrivate(v8::Local<v8::Object> object, v8::Local<v8::String> key) {
27
+#if NODE_MODULE_VERSION >= NODE_6_0_MODULE_VERSION
28
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
29
+  v8::EscapableHandleScope scope(isolate);
30
+  v8::Local<v8::Context> context = isolate->GetCurrentContext();
31
+  v8::Local<v8::Private> private_key = v8::Private::ForApi(isolate, key);
32
+  v8::MaybeLocal<v8::Value> v = object->GetPrivate(context, private_key);
33
+  return scope.Escape(v.ToLocalChecked());
34
+#else
35
+  EscapableHandleScope scope;
36
+  v8::Local<v8::Value> v = object->GetHiddenValue(key);
37
+  if (v.IsEmpty()) {
38
+    v = Undefined();
39
+  }
40
+  return scope.Escape(v);
41
+#endif
42
+}
43
+
44
+inline Maybe<bool> SetPrivate(
45
+    v8::Local<v8::Object> object,
46
+    v8::Local<v8::String> key,
47
+    v8::Local<v8::Value> value) {
48
+#if NODE_MODULE_VERSION >= NODE_6_0_MODULE_VERSION
49
+  HandleScope scope;
50
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
51
+  v8::Local<v8::Context> context = isolate->GetCurrentContext();
52
+  v8::Local<v8::Private> private_key = v8::Private::ForApi(isolate, key);
53
+  return object->SetPrivate(context, private_key, value);
54
+#else
55
+  return Just(object->SetHiddenValue(key, value));
56
+#endif
57
+}
58
+
59
+inline Maybe<bool> DeletePrivate(
60
+    v8::Local<v8::Object> object,
61
+    v8::Local<v8::String> key) {
62
+#if NODE_MODULE_VERSION >= NODE_6_0_MODULE_VERSION
63
+  HandleScope scope;
64
+  v8::Isolate *isolate = v8::Isolate::GetCurrent();
65
+  v8::Local<v8::Private> private_key = v8::Private::ForApi(isolate, key);
66
+  return object->DeletePrivate(isolate->GetCurrentContext(), private_key);
67
+#else
68
+  return Just(object->DeleteHiddenValue(key));
69
+#endif
70
+}
71
+
72
+#endif  // NAN_PRIVATE_H_
73
+
... ...
@@ -0,0 +1,76 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2021 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_SCRIPTORIGIN_H_
10
+#define NAN_SCRIPTORIGIN_H_
11
+
12
+class ScriptOrigin : public v8::ScriptOrigin {
13
+ public:
14
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 9 ||                      \
15
+  (V8_MAJOR_VERSION == 9 && (defined(V8_MINOR_VERSION) && (V8_MINOR_VERSION > 0\
16
+      || (V8_MINOR_VERSION == 0 && defined(V8_BUILD_NUMBER)                    \
17
+          && V8_BUILD_NUMBER >= 1)))))
18
+  explicit ScriptOrigin(v8::Local<v8::Value> name) :
19
+      v8::ScriptOrigin(v8::Isolate::GetCurrent(), name) {}
20
+
21
+  ScriptOrigin(v8::Local<v8::Value> name
22
+             , v8::Local<v8::Integer> line) :
23
+      v8::ScriptOrigin(v8::Isolate::GetCurrent()
24
+                   , name
25
+                   , To<int32_t>(line).FromMaybe(0)) {}
26
+
27
+  ScriptOrigin(v8::Local<v8::Value> name
28
+             , v8::Local<v8::Integer> line
29
+             , v8::Local<v8::Integer> column) :
30
+      v8::ScriptOrigin(v8::Isolate::GetCurrent()
31
+                   , name
32
+                   , To<int32_t>(line).FromMaybe(0)
33
+                   , To<int32_t>(column).FromMaybe(0)) {}
34
+#elif defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 8 ||                    \
35
+  (V8_MAJOR_VERSION == 8 && (defined(V8_MINOR_VERSION) && (V8_MINOR_VERSION > 9\
36
+      || (V8_MINOR_VERSION == 9 && defined(V8_BUILD_NUMBER)                    \
37
+          && V8_BUILD_NUMBER >= 45)))))
38
+  explicit ScriptOrigin(v8::Local<v8::Value> name) : v8::ScriptOrigin(name) {}
39
+
40
+  ScriptOrigin(v8::Local<v8::Value> name
41
+             , v8::Local<v8::Integer> line) :
42
+      v8::ScriptOrigin(name, To<int32_t>(line).FromMaybe(0)) {}
43
+
44
+  ScriptOrigin(v8::Local<v8::Value> name
45
+             , v8::Local<v8::Integer> line
46
+             , v8::Local<v8::Integer> column) :
47
+      v8::ScriptOrigin(name
48
+                   , To<int32_t>(line).FromMaybe(0)
49
+                   , To<int32_t>(column).FromMaybe(0)) {}
50
+#else
51
+  explicit ScriptOrigin(v8::Local<v8::Value> name) : v8::ScriptOrigin(name) {}
52
+
53
+  ScriptOrigin(v8::Local<v8::Value> name
54
+             , v8::Local<v8::Integer> line) : v8::ScriptOrigin(name, line) {}
55
+
56
+  ScriptOrigin(v8::Local<v8::Value> name
57
+             , v8::Local<v8::Integer> line
58
+             , v8::Local<v8::Integer> column) :
59
+      v8::ScriptOrigin(name, line, column) {}
60
+#endif
61
+
62
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 8 ||                      \
63
+  (V8_MAJOR_VERSION == 8 && (defined(V8_MINOR_VERSION) && (V8_MINOR_VERSION > 9\
64
+      || (V8_MINOR_VERSION == 9 && defined(V8_BUILD_NUMBER)                    \
65
+          && V8_BUILD_NUMBER >= 45)))))
66
+    v8::Local<v8::Integer> ResourceLineOffset() const {
67
+      return New(LineOffset());
68
+    }
69
+
70
+    v8::Local<v8::Integer> ResourceColumnOffset() const {
71
+      return New(ColumnOffset());
72
+    }
73
+#endif
74
+};
75
+
76
+#endif  // NAN_SCRIPTORIGIN_H_
... ...
@@ -0,0 +1,305 @@
1
+// Copyright Joyent, Inc. and other Node contributors.
2
+//
3
+// Permission is hereby granted, free of charge, to any person obtaining a
4
+// copy of this software and associated documentation files (the
5
+// "Software"), to deal in the Software without restriction, including
6
+// without limitation the rights to use, copy, modify, merge, publish,
7
+// distribute, sublicense, and/or sell copies of the Software, and to permit
8
+// persons to whom the Software is furnished to do so, subject to the
9
+// following conditions:
10
+//
11
+// The above copyright notice and this permission notice shall be included
12
+// in all copies or substantial portions of the Software.
13
+//
14
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15
+// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
17
+// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
18
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
19
+// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
20
+// USE OR OTHER DEALINGS IN THE SOFTWARE.
21
+
22
+#ifndef NAN_STRING_BYTES_H_
23
+#define NAN_STRING_BYTES_H_
24
+
25
+// Decodes a v8::Local<v8::String> or Buffer to a raw char*
26
+
27
+namespace imp {
28
+
29
+using v8::Local;
30
+using v8::Object;
31
+using v8::String;
32
+using v8::Value;
33
+
34
+
35
+//// Base 64 ////
36
+
37
+#define base64_encoded_size(size) ((size + 2 - ((size + 2) % 3)) / 3 * 4)
38
+
39
+
40
+
41
+//// HEX ////
42
+
43
+static bool contains_non_ascii_slow(const char* buf, size_t len) {
44
+  for (size_t i = 0; i < len; ++i) {
45
+    if (buf[i] & 0x80) return true;
46
+  }
47
+  return false;
48
+}
49
+
50
+
51
+static bool contains_non_ascii(const char* src, size_t len) {
52
+  if (len < 16) {
53
+    return contains_non_ascii_slow(src, len);
54
+  }
55
+
56
+  const unsigned bytes_per_word = sizeof(void*);
57
+  const unsigned align_mask = bytes_per_word - 1;
58
+  const unsigned unaligned = reinterpret_cast<uintptr_t>(src) & align_mask;
59
+
60
+  if (unaligned > 0) {
61
+    const unsigned n = bytes_per_word - unaligned;
62
+    if (contains_non_ascii_slow(src, n)) return true;
63
+    src += n;
64
+    len -= n;
65
+  }
66
+
67
+
68
+#if defined(__x86_64__) || defined(_WIN64)
69
+  const uintptr_t mask = 0x8080808080808080ll;
70
+#else
71
+  const uintptr_t mask = 0x80808080l;
72
+#endif
73
+
74
+  const uintptr_t* srcw = reinterpret_cast<const uintptr_t*>(src);
75
+
76
+  for (size_t i = 0, n = len / bytes_per_word; i < n; ++i) {
77
+    if (srcw[i] & mask) return true;
78
+  }
79
+
80
+  const unsigned remainder = len & align_mask;
81
+  if (remainder > 0) {
82
+    const size_t offset = len - remainder;
83
+    if (contains_non_ascii_slow(src + offset, remainder)) return true;
84
+  }
85
+
86
+  return false;
87
+}
88
+
89
+
90
+static void force_ascii_slow(const char* src, char* dst, size_t len) {
91
+  for (size_t i = 0; i < len; ++i) {
92
+    dst[i] = src[i] & 0x7f;
93
+  }
94
+}
95
+
96
+
97
+static void force_ascii(const char* src, char* dst, size_t len) {
98
+  if (len < 16) {
99
+    force_ascii_slow(src, dst, len);
100
+    return;
101
+  }
102
+
103
+  const unsigned bytes_per_word = sizeof(void*);
104
+  const unsigned align_mask = bytes_per_word - 1;
105
+  const unsigned src_unalign = reinterpret_cast<uintptr_t>(src) & align_mask;
106
+  const unsigned dst_unalign = reinterpret_cast<uintptr_t>(dst) & align_mask;
107
+
108
+  if (src_unalign > 0) {
109
+    if (src_unalign == dst_unalign) {
110
+      const unsigned unalign = bytes_per_word - src_unalign;
111
+      force_ascii_slow(src, dst, unalign);
112
+      src += unalign;
113
+      dst += unalign;
114
+      len -= src_unalign;
115
+    } else {
116
+      force_ascii_slow(src, dst, len);
117
+      return;
118
+    }
119
+  }
120
+
121
+#if defined(__x86_64__) || defined(_WIN64)
122
+  const uintptr_t mask = ~0x8080808080808080ll;
123
+#else
124
+  const uintptr_t mask = ~0x80808080l;
125
+#endif
126
+
127
+  const uintptr_t* srcw = reinterpret_cast<const uintptr_t*>(src);
128
+  uintptr_t* dstw = reinterpret_cast<uintptr_t*>(dst);
129
+
130
+  for (size_t i = 0, n = len / bytes_per_word; i < n; ++i) {
131
+    dstw[i] = srcw[i] & mask;
132
+  }
133
+
134
+  const unsigned remainder = len & align_mask;
135
+  if (remainder > 0) {
136
+    const size_t offset = len - remainder;
137
+    force_ascii_slow(src + offset, dst + offset, remainder);
138
+  }
139
+}
140
+
141
+
142
+static size_t base64_encode(const char* src,
143
+                            size_t slen,
144
+                            char* dst,
145
+                            size_t dlen) {
146
+  // We know how much we'll write, just make sure that there's space.
147
+  assert(dlen >= base64_encoded_size(slen) &&
148
+      "not enough space provided for base64 encode");
149
+
150
+  dlen = base64_encoded_size(slen);
151
+
152
+  unsigned a;
153
+  unsigned b;
154
+  unsigned c;
155
+  unsigned i;
156
+  unsigned k;
157
+  unsigned n;
158
+
159
+  static const char table[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
160
+                              "abcdefghijklmnopqrstuvwxyz"
161
+                              "0123456789+/";
162
+
163
+  i = 0;
164
+  k = 0;
165
+  n = slen / 3 * 3;
166
+
167
+  while (i < n) {
168
+    a = src[i + 0] & 0xff;
169
+    b = src[i + 1] & 0xff;
170
+    c = src[i + 2] & 0xff;
171
+
172
+    dst[k + 0] = table[a >> 2];
173
+    dst[k + 1] = table[((a & 3) << 4) | (b >> 4)];
174
+    dst[k + 2] = table[((b & 0x0f) << 2) | (c >> 6)];
175
+    dst[k + 3] = table[c & 0x3f];
176
+
177
+    i += 3;
178
+    k += 4;
179
+  }
180
+
181
+  if (n != slen) {
182
+    switch (slen - n) {
183
+      case 1:
184
+        a = src[i + 0] & 0xff;
185
+        dst[k + 0] = table[a >> 2];
186
+        dst[k + 1] = table[(a & 3) << 4];
187
+        dst[k + 2] = '=';
188
+        dst[k + 3] = '=';
189
+        break;
190
+
191
+      case 2:
192
+        a = src[i + 0] & 0xff;
193
+        b = src[i + 1] & 0xff;
194
+        dst[k + 0] = table[a >> 2];
195
+        dst[k + 1] = table[((a & 3) << 4) | (b >> 4)];
196
+        dst[k + 2] = table[(b & 0x0f) << 2];
197
+        dst[k + 3] = '=';
198
+        break;
199
+    }
200
+  }
201
+
202
+  return dlen;
203
+}
204
+
205
+
206
+static size_t hex_encode(const char* src, size_t slen, char* dst, size_t dlen) {
207
+  // We know how much we'll write, just make sure that there's space.
208
+  assert(dlen >= slen * 2 &&
209
+      "not enough space provided for hex encode");
210
+
211
+  dlen = slen * 2;
212
+  for (uint32_t i = 0, k = 0; k < dlen; i += 1, k += 2) {
213
+    static const char hex[] = "0123456789abcdef";
214
+    uint8_t val = static_cast<uint8_t>(src[i]);
215
+    dst[k + 0] = hex[val >> 4];
216
+    dst[k + 1] = hex[val & 15];
217
+  }
218
+
219
+  return dlen;
220
+}
221
+
222
+
223
+
224
+static Local<Value> Encode(const char* buf,
225
+                           size_t buflen,
226
+                           enum Encoding encoding) {
227
+  assert(buflen <= node::Buffer::kMaxLength);
228
+  if (!buflen && encoding != BUFFER)
229
+    return New("").ToLocalChecked();
230
+
231
+  Local<String> val;
232
+  switch (encoding) {
233
+    case BUFFER:
234
+      return CopyBuffer(buf, buflen).ToLocalChecked();
235
+
236
+    case ASCII:
237
+      if (contains_non_ascii(buf, buflen)) {
238
+        char* out = new char[buflen];
239
+        force_ascii(buf, out, buflen);
240
+        val = New<String>(out, buflen).ToLocalChecked();
241
+        delete[] out;
242
+      } else {
243
+        val = New<String>(buf, buflen).ToLocalChecked();
244
+      }
245
+      break;
246
+
247
+    case UTF8:
248
+      val = New<String>(buf, buflen).ToLocalChecked();
249
+      break;
250
+
251
+    case BINARY: {
252
+      // TODO(isaacs) use ExternalTwoByteString?
253
+      const unsigned char *cbuf = reinterpret_cast<const unsigned char*>(buf);
254
+      uint16_t * twobytebuf = new uint16_t[buflen];
255
+      for (size_t i = 0; i < buflen; i++) {
256
+        // XXX is the following line platform independent?
257
+        twobytebuf[i] = cbuf[i];
258
+      }
259
+      val = New<String>(twobytebuf, buflen).ToLocalChecked();
260
+      delete[] twobytebuf;
261
+      break;
262
+    }
263
+
264
+    case BASE64: {
265
+      size_t dlen = base64_encoded_size(buflen);
266
+      char* dst = new char[dlen];
267
+
268
+      size_t written = base64_encode(buf, buflen, dst, dlen);
269
+      assert(written == dlen);
270
+
271
+      val = New<String>(dst, dlen).ToLocalChecked();
272
+      delete[] dst;
273
+      break;
274
+    }
275
+
276
+    case UCS2: {
277
+      const uint16_t* data = reinterpret_cast<const uint16_t*>(buf);
278
+      val = New<String>(data, buflen / 2).ToLocalChecked();
279
+      break;
280
+    }
281
+
282
+    case HEX: {
283
+      size_t dlen = buflen * 2;
284
+      char* dst = new char[dlen];
285
+      size_t written = hex_encode(buf, buflen, dst, dlen);
286
+      assert(written == dlen);
287
+
288
+      val = New<String>(dst, dlen).ToLocalChecked();
289
+      delete[] dst;
290
+      break;
291
+    }
292
+
293
+    default:
294
+      assert(0 && "unknown encoding");
295
+      break;
296
+  }
297
+
298
+  return val;
299
+}
300
+
301
+#undef base64_encoded_size
302
+
303
+}  // end of namespace imp
304
+
305
+#endif  // NAN_STRING_BYTES_H_
... ...
@@ -0,0 +1,96 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_TYPEDARRAY_CONTENTS_H_
10
+#define NAN_TYPEDARRAY_CONTENTS_H_
11
+
12
+template<typename T>
13
+class TypedArrayContents {
14
+ public:
15
+  inline explicit TypedArrayContents(v8::Local<v8::Value> from) :
16
+      length_(0), data_(NULL) {
17
+    HandleScope scope;
18
+
19
+    size_t length = 0;
20
+    void*  data = NULL;
21
+
22
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
23
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
24
+
25
+    if (from->IsArrayBufferView()) {
26
+      v8::Local<v8::ArrayBufferView> array =
27
+        v8::Local<v8::ArrayBufferView>::Cast(from);
28
+
29
+      const size_t    byte_length = array->ByteLength();
30
+      const ptrdiff_t byte_offset = array->ByteOffset();
31
+      v8::Local<v8::ArrayBuffer> buffer = array->Buffer();
32
+
33
+      length = byte_length / sizeof(T);
34
+// Actually it's 7.9 here but this would lead to ABI issues with Node.js 13
35
+// using 7.8 till 13.2.0.
36
+#if (V8_MAJOR_VERSION >= 8)
37
+      data = static_cast<char*>(buffer->GetBackingStore()->Data()) + byte_offset;
38
+#else
39
+      data = static_cast<char*>(buffer->GetContents().Data()) + byte_offset;
40
+#endif
41
+    }
42
+
43
+#else
44
+
45
+    if (from->IsObject() && !from->IsNull()) {
46
+      v8::Local<v8::Object> array = v8::Local<v8::Object>::Cast(from);
47
+
48
+      MaybeLocal<v8::Value> buffer = Get(array,
49
+        New<v8::String>("buffer").ToLocalChecked());
50
+      MaybeLocal<v8::Value> byte_length = Get(array,
51
+        New<v8::String>("byteLength").ToLocalChecked());
52
+      MaybeLocal<v8::Value> byte_offset = Get(array,
53
+        New<v8::String>("byteOffset").ToLocalChecked());
54
+
55
+      if (!buffer.IsEmpty() &&
56
+          !byte_length.IsEmpty() && byte_length.ToLocalChecked()->IsUint32() &&
57
+          !byte_offset.IsEmpty() && byte_offset.ToLocalChecked()->IsUint32()) {
58
+        data = array->GetIndexedPropertiesExternalArrayData();
59
+        if(data) {
60
+          length = byte_length.ToLocalChecked()->Uint32Value() / sizeof(T);
61
+        }
62
+      }
63
+    }
64
+
65
+#endif
66
+
67
+#if defined(_MSC_VER) && _MSC_VER >= 1900 || __cplusplus >= 201103L
68
+    assert(reinterpret_cast<uintptr_t>(data) % alignof (T) == 0);
69
+#elif defined(_MSC_VER) && _MSC_VER >= 1600 || defined(__GNUC__)
70
+    assert(reinterpret_cast<uintptr_t>(data) % __alignof(T) == 0);
71
+#else
72
+    assert(reinterpret_cast<uintptr_t>(data) % sizeof (T) == 0);
73
+#endif
74
+
75
+    length_ = length;
76
+    data_   = static_cast<T*>(data);
77
+  }
78
+
79
+  inline size_t length() const      { return length_; }
80
+  inline T* operator*()             { return data_;   }
81
+  inline const T* operator*() const { return data_;   }
82
+
83
+ private:
84
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(TypedArrayContents)
85
+
86
+  //Disable heap allocation
87
+  void *operator new(size_t size);
88
+  void operator delete(void *, size_t) {
89
+    abort();
90
+  }
91
+
92
+  size_t  length_;
93
+  T*      data_;
94
+};
95
+
96
+#endif  // NAN_TYPEDARRAY_CONTENTS_H_
... ...
@@ -0,0 +1,437 @@
1
+/*********************************************************************
2
+ * NAN - Native Abstractions for Node.js
3
+ *
4
+ * Copyright (c) 2018 NAN contributors
5
+ *
6
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
7
+ ********************************************************************/
8
+
9
+#ifndef NAN_WEAK_H_
10
+#define NAN_WEAK_H_
11
+
12
+static const int kInternalFieldsInWeakCallback = 2;
13
+static const int kNoInternalFieldIndex = -1;
14
+
15
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
16
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
17
+# define NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_ \
18
+    v8::WeakCallbackInfo<WeakCallbackInfo<T> > const&
19
+# define NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_ \
20
+    NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_
21
+# define NAN_WEAK_PARAMETER_CALLBACK_SIG_ NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_
22
+# define NAN_WEAK_TWOFIELD_CALLBACK_SIG_ NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_
23
+#elif NODE_MODULE_VERSION > IOJS_1_1_MODULE_VERSION
24
+# define NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_ \
25
+    v8::PhantomCallbackData<WeakCallbackInfo<T> > const&
26
+# define NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_ \
27
+    NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_
28
+# define NAN_WEAK_PARAMETER_CALLBACK_SIG_ NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_
29
+# define NAN_WEAK_TWOFIELD_CALLBACK_SIG_ NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_
30
+#elif NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
31
+# define NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_ \
32
+    v8::PhantomCallbackData<WeakCallbackInfo<T> > const&
33
+# define NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_ \
34
+    v8::InternalFieldsCallbackData<WeakCallbackInfo<T>, void> const&
35
+# define NAN_WEAK_PARAMETER_CALLBACK_SIG_ NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_
36
+# define NAN_WEAK_TWOFIELD_CALLBACK_SIG_ NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_
37
+#elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
38
+# define NAN_WEAK_CALLBACK_DATA_TYPE_ \
39
+    v8::WeakCallbackData<S, WeakCallbackInfo<T> > const&
40
+# define NAN_WEAK_CALLBACK_SIG_ NAN_WEAK_CALLBACK_DATA_TYPE_
41
+#else
42
+# define NAN_WEAK_CALLBACK_DATA_TYPE_ void *
43
+# define NAN_WEAK_CALLBACK_SIG_ \
44
+    v8::Persistent<v8::Value>, NAN_WEAK_CALLBACK_DATA_TYPE_
45
+#endif
46
+
47
+template<typename T>
48
+class WeakCallbackInfo {
49
+ public:
50
+  typedef void (*Callback)(const WeakCallbackInfo<T>& data);
51
+  WeakCallbackInfo(
52
+      Persistent<v8::Value> *persistent
53
+    , Callback callback
54
+    , void *parameter
55
+    , void *field1 = 0
56
+    , void *field2 = 0) :
57
+        callback_(callback), isolate_(0), parameter_(parameter) {
58
+    std::memcpy(&persistent_, persistent, sizeof (v8::Persistent<v8::Value>));
59
+    internal_fields_[0] = field1;
60
+    internal_fields_[1] = field2;
61
+  }
62
+  inline v8::Isolate *GetIsolate() const { return isolate_; }
63
+  inline T *GetParameter() const { return static_cast<T*>(parameter_); }
64
+  inline void *GetInternalField(int index) const {
65
+    assert((index == 0 || index == 1) && "internal field index out of bounds");
66
+    if (index == 0) {
67
+      return internal_fields_[0];
68
+    } else {
69
+      return internal_fields_[1];
70
+    }
71
+  }
72
+
73
+ private:
74
+  NAN_DISALLOW_ASSIGN_COPY_MOVE(WeakCallbackInfo)
75
+  Callback callback_;
76
+  v8::Isolate *isolate_;
77
+  void *parameter_;
78
+  void *internal_fields_[kInternalFieldsInWeakCallback];
79
+  v8::Persistent<v8::Value> persistent_;
80
+  template<typename S, typename M> friend class Persistent;
81
+  template<typename S> friend class PersistentBase;
82
+#if NODE_MODULE_VERSION <= NODE_0_12_MODULE_VERSION
83
+# if NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
84
+  template<typename S>
85
+  static void invoke(NAN_WEAK_CALLBACK_SIG_ data);
86
+  template<typename S>
87
+  static WeakCallbackInfo *unwrap(NAN_WEAK_CALLBACK_DATA_TYPE_ data);
88
+# else
89
+  static void invoke(NAN_WEAK_CALLBACK_SIG_ data);
90
+  static WeakCallbackInfo *unwrap(NAN_WEAK_CALLBACK_DATA_TYPE_ data);
91
+# endif
92
+#else
93
+# if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                     \
94
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
95
+  template<bool isFirstPass>
96
+  static void invokeparameter(NAN_WEAK_PARAMETER_CALLBACK_SIG_ data);
97
+  template<bool isFirstPass>
98
+  static void invoketwofield(NAN_WEAK_TWOFIELD_CALLBACK_SIG_ data);
99
+# else
100
+  static void invokeparameter(NAN_WEAK_PARAMETER_CALLBACK_SIG_ data);
101
+  static void invoketwofield(NAN_WEAK_TWOFIELD_CALLBACK_SIG_ data);
102
+# endif
103
+  static WeakCallbackInfo *unwrapparameter(
104
+      NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_ data);
105
+  static WeakCallbackInfo *unwraptwofield(
106
+      NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_ data);
107
+#endif
108
+};
109
+
110
+
111
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
112
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
113
+
114
+template<typename T>
115
+template<bool isFirstPass>
116
+void
117
+WeakCallbackInfo<T>::invokeparameter(NAN_WEAK_PARAMETER_CALLBACK_SIG_ data) {
118
+  WeakCallbackInfo<T> *cbinfo = unwrapparameter(data);
119
+  if (isFirstPass) {
120
+    cbinfo->persistent_.Reset();
121
+    data.SetSecondPassCallback(invokeparameter<false>);
122
+  } else {
123
+    cbinfo->callback_(*cbinfo);
124
+    delete cbinfo;
125
+  }
126
+}
127
+
128
+template<typename T>
129
+template<bool isFirstPass>
130
+void
131
+WeakCallbackInfo<T>::invoketwofield(NAN_WEAK_TWOFIELD_CALLBACK_SIG_ data) {
132
+  WeakCallbackInfo<T> *cbinfo = unwraptwofield(data);
133
+  if (isFirstPass) {
134
+    cbinfo->persistent_.Reset();
135
+    data.SetSecondPassCallback(invoketwofield<false>);
136
+  } else {
137
+    cbinfo->callback_(*cbinfo);
138
+    delete cbinfo;
139
+  }
140
+}
141
+
142
+template<typename T>
143
+WeakCallbackInfo<T> *WeakCallbackInfo<T>::unwrapparameter(
144
+    NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_ data) {
145
+  WeakCallbackInfo<T> *cbinfo =
146
+      static_cast<WeakCallbackInfo<T>*>(data.GetParameter());
147
+  cbinfo->isolate_ = data.GetIsolate();
148
+  return cbinfo;
149
+}
150
+
151
+template<typename T>
152
+WeakCallbackInfo<T> *WeakCallbackInfo<T>::unwraptwofield(
153
+    NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_ data) {
154
+  WeakCallbackInfo<T> *cbinfo =
155
+      static_cast<WeakCallbackInfo<T>*>(data.GetInternalField(0));
156
+  cbinfo->isolate_ = data.GetIsolate();
157
+  return cbinfo;
158
+}
159
+
160
+#undef NAN_WEAK_PARAMETER_CALLBACK_SIG_
161
+#undef NAN_WEAK_TWOFIELD_CALLBACK_SIG_
162
+#undef NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_
163
+#undef NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_
164
+# elif NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
165
+
166
+template<typename T>
167
+void
168
+WeakCallbackInfo<T>::invokeparameter(NAN_WEAK_PARAMETER_CALLBACK_SIG_ data) {
169
+  WeakCallbackInfo<T> *cbinfo = unwrapparameter(data);
170
+  cbinfo->persistent_.Reset();
171
+  cbinfo->callback_(*cbinfo);
172
+  delete cbinfo;
173
+}
174
+
175
+template<typename T>
176
+void
177
+WeakCallbackInfo<T>::invoketwofield(NAN_WEAK_TWOFIELD_CALLBACK_SIG_ data) {
178
+  WeakCallbackInfo<T> *cbinfo = unwraptwofield(data);
179
+  cbinfo->persistent_.Reset();
180
+  cbinfo->callback_(*cbinfo);
181
+  delete cbinfo;
182
+}
183
+
184
+template<typename T>
185
+WeakCallbackInfo<T> *WeakCallbackInfo<T>::unwrapparameter(
186
+    NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_ data) {
187
+  WeakCallbackInfo<T> *cbinfo =
188
+       static_cast<WeakCallbackInfo<T>*>(data.GetParameter());
189
+  cbinfo->isolate_ = data.GetIsolate();
190
+  return cbinfo;
191
+}
192
+
193
+template<typename T>
194
+WeakCallbackInfo<T> *WeakCallbackInfo<T>::unwraptwofield(
195
+    NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_ data) {
196
+  WeakCallbackInfo<T> *cbinfo =
197
+       static_cast<WeakCallbackInfo<T>*>(data.GetInternalField1());
198
+  cbinfo->isolate_ = data.GetIsolate();
199
+  return cbinfo;
200
+}
201
+
202
+#undef NAN_WEAK_PARAMETER_CALLBACK_SIG_
203
+#undef NAN_WEAK_TWOFIELD_CALLBACK_SIG_
204
+#undef NAN_WEAK_PARAMETER_CALLBACK_DATA_TYPE_
205
+#undef NAN_WEAK_TWOFIELD_CALLBACK_DATA_TYPE_
206
+#elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
207
+
208
+template<typename T>
209
+template<typename S>
210
+void WeakCallbackInfo<T>::invoke(NAN_WEAK_CALLBACK_SIG_ data) {
211
+  WeakCallbackInfo<T> *cbinfo = unwrap(data);
212
+  cbinfo->persistent_.Reset();
213
+  cbinfo->callback_(*cbinfo);
214
+  delete cbinfo;
215
+}
216
+
217
+template<typename T>
218
+template<typename S>
219
+WeakCallbackInfo<T> *WeakCallbackInfo<T>::unwrap(
220
+    NAN_WEAK_CALLBACK_DATA_TYPE_ data) {
221
+  void *parameter = data.GetParameter();
222
+  WeakCallbackInfo<T> *cbinfo =
223
+      static_cast<WeakCallbackInfo<T>*>(parameter);
224
+  cbinfo->isolate_ = data.GetIsolate();
225
+  return cbinfo;
226
+}
227
+
228
+#undef NAN_WEAK_CALLBACK_SIG_
229
+#undef NAN_WEAK_CALLBACK_DATA_TYPE_
230
+#else
231
+
232
+template<typename T>
233
+void WeakCallbackInfo<T>::invoke(NAN_WEAK_CALLBACK_SIG_ data) {
234
+  WeakCallbackInfo<T> *cbinfo = unwrap(data);
235
+  cbinfo->persistent_.Dispose();
236
+  cbinfo->persistent_.Clear();
237
+  cbinfo->callback_(*cbinfo);
238
+  delete cbinfo;
239
+}
240
+
241
+template<typename T>
242
+WeakCallbackInfo<T> *WeakCallbackInfo<T>::unwrap(
243
+    NAN_WEAK_CALLBACK_DATA_TYPE_ data) {
244
+  WeakCallbackInfo<T> *cbinfo =
245
+      static_cast<WeakCallbackInfo<T>*>(data);
246
+  cbinfo->isolate_ = v8::Isolate::GetCurrent();
247
+  return cbinfo;
248
+}
249
+
250
+#undef NAN_WEAK_CALLBACK_SIG_
251
+#undef NAN_WEAK_CALLBACK_DATA_TYPE_
252
+#endif
253
+
254
+#if defined(V8_MAJOR_VERSION) && (V8_MAJOR_VERSION > 4 ||                      \
255
+  (V8_MAJOR_VERSION == 4 && defined(V8_MINOR_VERSION) && V8_MINOR_VERSION >= 3))
256
+template<typename T, typename M>
257
+template<typename P>
258
+inline void Persistent<T, M>::SetWeak(
259
+    P *parameter
260
+  , typename WeakCallbackInfo<P>::Callback callback
261
+  , WeakCallbackType type) {
262
+  WeakCallbackInfo<P> *wcbd;
263
+  if (type == WeakCallbackType::kParameter) {
264
+    wcbd = new WeakCallbackInfo<P>(
265
+        reinterpret_cast<Persistent<v8::Value>*>(this)
266
+      , callback
267
+      , parameter);
268
+    v8::PersistentBase<T>::SetWeak(
269
+        wcbd
270
+      , WeakCallbackInfo<P>::template invokeparameter<true>
271
+      , type);
272
+  } else {
273
+    v8::Local<v8::Value>* self_v(reinterpret_cast<v8::Local<v8::Value>*>(this));
274
+    assert((*self_v)->IsObject());
275
+    v8::Local<v8::Object> self((*self_v).As<v8::Object>());
276
+    int count = self->InternalFieldCount();
277
+    void *internal_fields[kInternalFieldsInWeakCallback] = {0, 0};
278
+    for (int i = 0; i < count && i < kInternalFieldsInWeakCallback; i++) {
279
+      internal_fields[i] = self->GetAlignedPointerFromInternalField(i);
280
+    }
281
+    wcbd = new WeakCallbackInfo<P>(
282
+        reinterpret_cast<Persistent<v8::Value>*>(this)
283
+      , callback
284
+      , 0
285
+      , internal_fields[0]
286
+      , internal_fields[1]);
287
+    self->SetAlignedPointerInInternalField(0, wcbd);
288
+    v8::PersistentBase<T>::SetWeak(
289
+        static_cast<WeakCallbackInfo<P>*>(0)
290
+      , WeakCallbackInfo<P>::template invoketwofield<true>
291
+      , type);
292
+  }
293
+}
294
+#elif NODE_MODULE_VERSION > IOJS_1_1_MODULE_VERSION
295
+template<typename T, typename M>
296
+template<typename P>
297
+inline void Persistent<T, M>::SetWeak(
298
+    P *parameter
299
+  , typename WeakCallbackInfo<P>::Callback callback
300
+  , WeakCallbackType type) {
301
+  WeakCallbackInfo<P> *wcbd;
302
+  if (type == WeakCallbackType::kParameter) {
303
+    wcbd = new WeakCallbackInfo<P>(
304
+        reinterpret_cast<Persistent<v8::Value>*>(this)
305
+      , callback
306
+      , parameter);
307
+    v8::PersistentBase<T>::SetPhantom(
308
+        wcbd
309
+      , WeakCallbackInfo<P>::invokeparameter);
310
+  } else {
311
+    v8::Local<v8::Value>* self_v(reinterpret_cast<v8::Local<v8::Value>*>(this));
312
+    assert((*self_v)->IsObject());
313
+    v8::Local<v8::Object> self((*self_v).As<v8::Object>());
314
+    int count = self->InternalFieldCount();
315
+    void *internal_fields[kInternalFieldsInWeakCallback] = {0, 0};
316
+    for (int i = 0; i < count && i < kInternalFieldsInWeakCallback; i++) {
317
+      internal_fields[i] = self->GetAlignedPointerFromInternalField(i);
318
+    }
319
+    wcbd = new WeakCallbackInfo<P>(
320
+        reinterpret_cast<Persistent<v8::Value>*>(this)
321
+      , callback
322
+      , 0
323
+      , internal_fields[0]
324
+      , internal_fields[1]);
325
+    self->SetAlignedPointerInInternalField(0, wcbd);
326
+    v8::PersistentBase<T>::SetPhantom(
327
+        static_cast<WeakCallbackInfo<P>*>(0)
328
+      , WeakCallbackInfo<P>::invoketwofield
329
+      , 0
330
+      , count > 1 ? 1 : kNoInternalFieldIndex);
331
+  }
332
+}
333
+#elif NODE_MODULE_VERSION > NODE_0_12_MODULE_VERSION
334
+template<typename T, typename M>
335
+template<typename P>
336
+inline void Persistent<T, M>::SetWeak(
337
+    P *parameter
338
+  , typename WeakCallbackInfo<P>::Callback callback
339
+  , WeakCallbackType type) {
340
+  WeakCallbackInfo<P> *wcbd;
341
+  if (type == WeakCallbackType::kParameter) {
342
+    wcbd = new WeakCallbackInfo<P>(
343
+        reinterpret_cast<Persistent<v8::Value>*>(this)
344
+      , callback
345
+      , parameter);
346
+    v8::PersistentBase<T>::SetPhantom(
347
+        wcbd
348
+      , WeakCallbackInfo<P>::invokeparameter);
349
+  } else {
350
+    v8::Local<v8::Value>* self_v(reinterpret_cast<v8::Local<v8::Value>*>(this));
351
+    assert((*self_v)->IsObject());
352
+    v8::Local<v8::Object> self((*self_v).As<v8::Object>());
353
+    int count = self->InternalFieldCount();
354
+    void *internal_fields[kInternalFieldsInWeakCallback] = {0, 0};
355
+    for (int i = 0; i < count && i < kInternalFieldsInWeakCallback; i++) {
356
+      internal_fields[i] = self->GetAlignedPointerFromInternalField(i);
357
+    }
358
+    wcbd = new WeakCallbackInfo<P>(
359
+        reinterpret_cast<Persistent<v8::Value>*>(this)
360
+      , callback
361
+      , 0
362
+      , internal_fields[0]
363
+      , internal_fields[1]);
364
+    self->SetAlignedPointerInInternalField(0, wcbd);
365
+    v8::PersistentBase<T>::SetPhantom(
366
+        WeakCallbackInfo<P>::invoketwofield
367
+      , 0
368
+      , count > 1 ? 1 : kNoInternalFieldIndex);
369
+  }
370
+}
371
+#elif NODE_MODULE_VERSION > NODE_0_10_MODULE_VERSION
372
+template<typename T, typename M>
373
+template<typename P>
374
+inline void Persistent<T, M>::SetWeak(
375
+    P *parameter
376
+  , typename WeakCallbackInfo<P>::Callback callback
377
+  , WeakCallbackType type) {
378
+  WeakCallbackInfo<P> *wcbd;
379
+  if (type == WeakCallbackType::kParameter) {
380
+    wcbd = new WeakCallbackInfo<P>(
381
+        reinterpret_cast<Persistent<v8::Value>*>(this)
382
+      , callback
383
+      , parameter);
384
+    v8::PersistentBase<T>::SetWeak(wcbd, WeakCallbackInfo<P>::invoke);
385
+  } else {
386
+    v8::Local<v8::Value>* self_v(reinterpret_cast<v8::Local<v8::Value>*>(this));
387
+    assert((*self_v)->IsObject());
388
+    v8::Local<v8::Object> self((*self_v).As<v8::Object>());
389
+    int count = self->InternalFieldCount();
390
+    void *internal_fields[kInternalFieldsInWeakCallback] = {0, 0};
391
+    for (int i = 0; i < count && i < kInternalFieldsInWeakCallback; i++) {
392
+      internal_fields[i] = self->GetAlignedPointerFromInternalField(i);
393
+    }
394
+    wcbd = new WeakCallbackInfo<P>(
395
+        reinterpret_cast<Persistent<v8::Value>*>(this)
396
+      , callback
397
+      , 0
398
+      , internal_fields[0]
399
+      , internal_fields[1]);
400
+    v8::PersistentBase<T>::SetWeak(wcbd, WeakCallbackInfo<P>::invoke);
401
+  }
402
+}
403
+#else
404
+template<typename T>
405
+template<typename P>
406
+inline void PersistentBase<T>::SetWeak(
407
+    P *parameter
408
+  , typename WeakCallbackInfo<P>::Callback callback
409
+  , WeakCallbackType type) {
410
+  WeakCallbackInfo<P> *wcbd;
411
+  if (type == WeakCallbackType::kParameter) {
412
+    wcbd = new WeakCallbackInfo<P>(
413
+        reinterpret_cast<Persistent<v8::Value>*>(this)
414
+      , callback
415
+      , parameter);
416
+    persistent.MakeWeak(wcbd, WeakCallbackInfo<P>::invoke);
417
+  } else {
418
+    v8::Local<v8::Value>* self_v(reinterpret_cast<v8::Local<v8::Value>*>(this));
419
+    assert((*self_v)->IsObject());
420
+    v8::Local<v8::Object> self((*self_v).As<v8::Object>());
421
+    int count = self->InternalFieldCount();
422
+    void *internal_fields[kInternalFieldsInWeakCallback] = {0, 0};
423
+    for (int i = 0; i < count && i < kInternalFieldsInWeakCallback; i++) {
424
+      internal_fields[i] = self->GetPointerFromInternalField(i);
425
+    }
426
+    wcbd = new WeakCallbackInfo<P>(
427
+        reinterpret_cast<Persistent<v8::Value>*>(this)
428
+      , callback
429
+      , 0
430
+      , internal_fields[0]
431
+      , internal_fields[1]);
432
+    persistent.MakeWeak(wcbd, WeakCallbackInfo<P>::invoke);
433
+  }
434
+}
435
+#endif
436
+
437
+#endif  // NAN_WEAK_H_
... ...
@@ -0,0 +1,37 @@
1
+{
2
+  "name": "nan",
3
+  "version": "2.15.0",
4
+  "description": "Native Abstractions for Node.js: C++ header for Node 0.8 -> 14 compatibility",
5
+  "main": "include_dirs.js",
6
+  "repository": {
7
+    "type": "git",
8
+    "url": "git://github.com/nodejs/nan.git"
9
+  },
10
+  "scripts": {
11
+    "test": "tap --gc --stderr test/js/*-test.js",
12
+    "test:worker": "node --experimental-worker test/tap-as-worker.js --gc --stderr test/js/*-test.js",
13
+    "rebuild-tests": "node-gyp rebuild --msvs_version=2015 --directory test",
14
+    "docs": "doc/.build.sh"
15
+  },
16
+  "contributors": [
17
+    "Rod Vagg <r@va.gg> (https://github.com/rvagg)",
18
+    "Benjamin Byholm <bbyholm@abo.fi> (https://github.com/kkoopa/)",
19
+    "Trevor Norris <trev.norris@gmail.com> (https://github.com/trevnorris)",
20
+    "Nathan Rajlich <nathan@tootallnate.net> (https://github.com/TooTallNate)",
21
+    "Brett Lawson <brett19@gmail.com> (https://github.com/brett19)",
22
+    "Ben Noordhuis <info@bnoordhuis.nl> (https://github.com/bnoordhuis)",
23
+    "David Siegel <david@artcom.de> (https://github.com/agnat)",
24
+    "Michael Ira Krufky <mkrufky@gmail.com> (https://github.com/mkrufky)"
25
+  ],
26
+  "devDependencies": {
27
+    "bindings": "~1.2.1",
28
+    "commander": "^2.8.1",
29
+    "glob": "^5.0.14",
30
+    "request": "=2.81.0",
31
+    "node-gyp": "~3.6.2",
32
+    "readable-stream": "^2.1.4",
33
+    "tap": "~0.7.1",
34
+    "xtend": "~4.0.0"
35
+  },
36
+  "license": "MIT"
37
+}
... ...
@@ -0,0 +1,412 @@
1
+#!/usr/bin/env node
2
+/*********************************************************************
3
+ * NAN - Native Abstractions for Node.js
4
+ *
5
+ * Copyright (c) 2018 NAN contributors
6
+ *
7
+ * MIT License <https://github.com/nodejs/nan/blob/master/LICENSE.md>
8
+ ********************************************************************/
9
+
10
+var commander = require('commander'),
11
+    fs = require('fs'),
12
+    glob = require('glob'),
13
+    groups = [],
14
+    total = 0,
15
+    warning1 = '/* ERROR: Rewrite using Buffer */\n',
16
+    warning2 = '\\/\\* ERROR\\: Rewrite using Buffer \\*\\/\\n',
17
+    length,
18
+    i;
19
+
20
+fs.readFile(__dirname + '/package.json', 'utf8', function (err, data) {
21
+  if (err) {
22
+    throw err;
23
+  }
24
+
25
+  commander
26
+      .version(JSON.parse(data).version)
27
+      .usage('[options] <file ...>')
28
+      .parse(process.argv);
29
+
30
+  if (!process.argv.slice(2).length) {
31
+    commander.outputHelp();
32
+  }
33
+});
34
+
35
+/* construct strings representing regular expressions
36
+   each expression contains a unique group allowing for identification of the match
37
+   the index of this key group, relative to the regular expression in question,
38
+    is indicated by the first array member */
39
+
40
+/* simple substistutions, key group is the entire match, 0 */
41
+groups.push([0, [
42
+  '_NAN_',
43
+  'NODE_SET_METHOD',
44
+  'NODE_SET_PROTOTYPE_METHOD',
45
+  'NanAsciiString',
46
+  'NanEscapeScope',
47
+  'NanReturnValue',
48
+  'NanUcs2String'].join('|')]);
49
+
50
+/* substitutions of parameterless macros, key group is 1 */
51
+groups.push([1, ['(', [
52
+  'NanEscapableScope',
53
+  'NanReturnNull',
54
+  'NanReturnUndefined',
55
+  'NanScope'].join('|'), ')\\(\\)'].join('')]);
56
+
57
+/* replace TryCatch with NanTryCatch once, gobbling possible namespace, key group 2 */
58
+groups.push([2, '(?:(?:v8\\:\\:)?|(Nan)?)(TryCatch)']);
59
+
60
+/* NanNew("string") will likely not fail a ToLocalChecked(), key group 1 */ 
61
+groups.push([1, ['(NanNew)', '(\\("[^\\"]*"[^\\)]*\\))(?!\\.ToLocalChecked\\(\\))'].join('')]);
62
+
63
+/* Removed v8 APIs, warn that the code needs rewriting using node::Buffer, key group 2 */
64
+groups.push([2, ['(', warning2, ')?', '^.*?(', [
65
+      'GetIndexedPropertiesExternalArrayDataLength',
66
+      'GetIndexedPropertiesExternalArrayData',
67
+      'GetIndexedPropertiesExternalArrayDataType',
68
+      'GetIndexedPropertiesPixelData',
69
+      'GetIndexedPropertiesPixelDataLength',
70
+      'HasIndexedPropertiesInExternalArrayData',
71
+      'HasIndexedPropertiesInPixelData',
72
+      'SetIndexedPropertiesToExternalArrayData',
73
+      'SetIndexedPropertiesToPixelData'].join('|'), ')'].join('')]);
74
+
75
+/* No need for NanScope in V8-exposed methods, key group 2 */
76
+groups.push([2, ['((', [
77
+      'NAN_METHOD',
78
+      'NAN_GETTER',
79
+      'NAN_SETTER',
80
+      'NAN_PROPERTY_GETTER',
81
+      'NAN_PROPERTY_SETTER',
82
+      'NAN_PROPERTY_ENUMERATOR',
83
+      'NAN_PROPERTY_DELETER',
84
+      'NAN_PROPERTY_QUERY',
85
+      'NAN_INDEX_GETTER',
86
+      'NAN_INDEX_SETTER',
87
+      'NAN_INDEX_ENUMERATOR',
88
+      'NAN_INDEX_DELETER',
89
+      'NAN_INDEX_QUERY'].join('|'), ')\\([^\\)]*\\)\\s*\\{)\\s*NanScope\\(\\)\\s*;'].join('')]);
90
+
91
+/* v8::Value::ToXXXXXXX returns v8::MaybeLocal<T>, key group 3 */
92
+groups.push([3, ['([\\s\\(\\)])([^\\s\\(\\)]+)->(', [
93
+      'Boolean',
94
+      'Number',
95
+      'String',
96
+      'Object',
97
+      'Integer',
98
+      'Uint32',
99
+      'Int32'].join('|'), ')\\('].join('')]);
100
+
101
+/* v8::Value::XXXXXXXValue returns v8::Maybe<T>, key group 3 */
102
+groups.push([3, ['([\\s\\(\\)])([^\\s\\(\\)]+)->((?:', [
103
+      'Boolean',
104
+      'Number',
105
+      'Integer',
106
+      'Uint32',
107
+      'Int32'].join('|'), ')Value)\\('].join('')]);
108
+
109
+/* NAN_WEAK_CALLBACK macro was removed, write out callback definition, key group 1 */
110
+groups.push([1, '(NAN_WEAK_CALLBACK)\\(([^\\s\\)]+)\\)']);
111
+
112
+/* node::ObjectWrap and v8::Persistent have been replaced with Nan implementations, key group 1 */
113
+groups.push([1, ['(', [
114
+  'NanDisposePersistent',
115
+  'NanObjectWrapHandle'].join('|'), ')\\s*\\(\\s*([^\\s\\)]+)'].join('')]);
116
+
117
+/* Since NanPersistent there is no need for NanMakeWeakPersistent, key group 1 */
118
+groups.push([1, '(NanMakeWeakPersistent)\\s*\\(\\s*([^\\s,]+)\\s*,\\s*']);
119
+
120
+/* Many methods of v8::Object and others now return v8::MaybeLocal<T>, key group 3 */
121
+groups.push([3, ['([\\s])([^\\s]+)->(', [
122
+  'GetEndColumn',
123
+  'GetFunction',
124
+  'GetLineNumber',
125
+  'NewInstance',
126
+  'GetPropertyNames',
127
+  'GetOwnPropertyNames',
128
+  'GetSourceLine',
129
+  'GetStartColumn',
130
+  'ObjectProtoToString',
131
+  'ToArrayIndex',
132
+  'ToDetailString',
133
+  'CallAsConstructor',
134
+  'CallAsFunction',
135
+  'CloneElementAt',
136
+  'Delete',
137
+  'ForceSet',
138
+  'Get',
139
+  'GetPropertyAttributes',
140
+  'GetRealNamedProperty',
141
+  'GetRealNamedPropertyInPrototypeChain',
142
+  'Has',
143
+  'HasOwnProperty',
144
+  'HasRealIndexedProperty',
145
+  'HasRealNamedCallbackProperty',
146
+  'HasRealNamedProperty',
147
+  'Set',
148
+  'SetAccessor',
149
+  'SetIndexedPropertyHandler',
150
+  'SetNamedPropertyHandler',
151
+  'SetPrototype'].join('|'), ')\\('].join('')]);
152
+
153
+/* You should get an error if any of these fail anyways,
154
+   or handle the error better, it is indicated either way, key group 2 */
155
+groups.push([2, ['NanNew(<(?:v8\\:\\:)?(', ['Date', 'String', 'RegExp'].join('|'), ')>)(\\([^\\)]*\\))(?!\\.ToLocalChecked\\(\\))'].join('')]);
156
+
157
+/* v8::Value::Equals now returns a v8::Maybe, key group 3 */
158
+groups.push([3, '([\\s\\(\\)])([^\\s\\(\\)]+)->(Equals)\\(([^\\s\\)]+)']);
159
+
160
+/* NanPersistent makes this unnecessary, key group 1 */
161
+groups.push([1, '(NanAssignPersistent)(?:<v8\\:\\:[^>]+>)?\\(([^,]+),\\s*']);
162
+
163
+/* args has been renamed to info, key group 2 */
164
+groups.push([2, '(\\W)(args)(\\W)'])
165
+
166
+/* node::ObjectWrap was replaced with NanObjectWrap, key group 2 */
167
+groups.push([2, '(\\W)(?:node\\:\\:)?(ObjectWrap)(\\W)']);
168
+
169
+/* v8::Persistent was replaced with NanPersistent, key group 2 */
170
+groups.push([2, '(\\W)(?:v8\\:\\:)?(Persistent)(\\W)']);
171
+
172
+/* counts the number of capturing groups in a well-formed regular expression,
173
+   ignoring non-capturing groups and escaped parentheses */
174
+function groupcount(s) {
175
+  var positive = s.match(/\((?!\?)/g),
176
+      negative = s.match(/\\\(/g);
177
+  return (positive ? positive.length : 0) - (negative ? negative.length : 0);
178
+}
179
+
180
+/* compute the absolute position of each key group in the joined master RegExp */
181
+for (i = 1, length = groups.length; i < length; i++) {
182
+	total += groupcount(groups[i - 1][1]);
183
+	groups[i][0] += total;
184
+}
185
+
186
+/* create the master RegExp, whis is the union of all the groups' expressions */
187
+master = new RegExp(groups.map(function (a) { return a[1]; }).join('|'), 'gm');
188
+
189
+/* replacement function for String.replace, receives 21 arguments */
190
+function replace() {
191
+	/* simple expressions */
192
+      switch (arguments[groups[0][0]]) {
193
+        case '_NAN_':
194
+          return 'NAN_';
195
+        case 'NODE_SET_METHOD':
196
+          return 'NanSetMethod';
197
+        case 'NODE_SET_PROTOTYPE_METHOD':
198
+          return 'NanSetPrototypeMethod';
199
+        case 'NanAsciiString':
200
+          return 'NanUtf8String';
201
+        case 'NanEscapeScope':
202
+          return 'scope.Escape';
203
+        case 'NanReturnNull':
204
+          return 'info.GetReturnValue().SetNull';
205
+        case 'NanReturnValue':
206
+          return 'info.GetReturnValue().Set';
207
+        case 'NanUcs2String':
208
+          return 'v8::String::Value';
209
+        default:
210
+      }
211
+
212
+      /* macros without arguments */
213
+      switch (arguments[groups[1][0]]) {
214
+        case 'NanEscapableScope':
215
+          return 'NanEscapableScope scope'
216
+        case 'NanReturnUndefined':
217
+          return 'return';
218
+        case 'NanScope':
219
+          return 'NanScope scope';
220
+        default:
221
+      }
222
+
223
+      /* TryCatch, emulate negative backref */
224
+      if (arguments[groups[2][0]] === 'TryCatch') {
225
+        return arguments[groups[2][0] - 1] ? arguments[0] : 'NanTryCatch';
226
+      }
227
+
228
+      /* NanNew("foo") --> NanNew("foo").ToLocalChecked() */
229
+      if (arguments[groups[3][0]] === 'NanNew') {
230
+        return [arguments[0], '.ToLocalChecked()'].join('');
231
+      }
232
+
233
+      /* insert warning for removed functions as comment on new line above */
234
+      switch (arguments[groups[4][0]]) {
235
+        case 'GetIndexedPropertiesExternalArrayData':
236
+        case 'GetIndexedPropertiesExternalArrayDataLength':
237
+        case 'GetIndexedPropertiesExternalArrayDataType':
238
+        case 'GetIndexedPropertiesPixelData':
239
+        case 'GetIndexedPropertiesPixelDataLength':
240
+        case 'HasIndexedPropertiesInExternalArrayData':
241
+        case 'HasIndexedPropertiesInPixelData':
242
+        case 'SetIndexedPropertiesToExternalArrayData':
243
+        case 'SetIndexedPropertiesToPixelData':
244
+          return arguments[groups[4][0] - 1] ? arguments[0] : [warning1, arguments[0]].join('');
245
+        default:
246
+      }
247
+
248
+     /* remove unnecessary NanScope() */
249
+      switch (arguments[groups[5][0]]) {
250
+        case 'NAN_GETTER':
251
+        case 'NAN_METHOD':
252
+        case 'NAN_SETTER':
253
+        case 'NAN_INDEX_DELETER':
254
+        case 'NAN_INDEX_ENUMERATOR':
255
+        case 'NAN_INDEX_GETTER':
256
+        case 'NAN_INDEX_QUERY':
257
+        case 'NAN_INDEX_SETTER':
258
+        case 'NAN_PROPERTY_DELETER':
259
+        case 'NAN_PROPERTY_ENUMERATOR':
260
+        case 'NAN_PROPERTY_GETTER':
261
+        case 'NAN_PROPERTY_QUERY':
262
+        case 'NAN_PROPERTY_SETTER':
263
+          return arguments[groups[5][0] - 1];
264
+        default:
265
+      }
266
+
267
+      /* Value conversion */
268
+      switch (arguments[groups[6][0]]) {
269
+        case 'Boolean':
270
+        case 'Int32':
271
+        case 'Integer':
272
+        case 'Number':
273
+        case 'Object':
274
+        case 'String':
275
+        case 'Uint32':
276
+          return [arguments[groups[6][0] - 2], 'NanTo<v8::', arguments[groups[6][0]], '>(',  arguments[groups[6][0] - 1]].join('');
277
+        default:
278
+      }
279
+
280
+      /* other value conversion */
281
+      switch (arguments[groups[7][0]]) {
282
+        case 'BooleanValue':
283
+          return [arguments[groups[7][0] - 2], 'NanTo<bool>(', arguments[groups[7][0] - 1]].join('');
284
+        case 'Int32Value':
285
+          return [arguments[groups[7][0] - 2], 'NanTo<int32_t>(', arguments[groups[7][0] - 1]].join('');
286
+        case 'IntegerValue':
287
+          return [arguments[groups[7][0] - 2], 'NanTo<int64_t>(', arguments[groups[7][0] - 1]].join('');
288
+        case 'Uint32Value':
289
+          return [arguments[groups[7][0] - 2], 'NanTo<uint32_t>(', arguments[groups[7][0] - 1]].join('');
290
+        default:
291
+      }
292
+
293
+      /* NAN_WEAK_CALLBACK */
294
+      if (arguments[groups[8][0]] === 'NAN_WEAK_CALLBACK') {
295
+        return ['template<typename T>\nvoid ',
296
+          arguments[groups[8][0] + 1], '(const NanWeakCallbackInfo<T> &data)'].join('');
297
+      }
298
+
299
+      /* use methods on NAN classes instead */
300
+      switch (arguments[groups[9][0]]) {
301
+        case 'NanDisposePersistent':
302
+          return [arguments[groups[9][0] + 1], '.Reset('].join('');
303
+        case 'NanObjectWrapHandle':
304
+          return [arguments[groups[9][0] + 1], '->handle('].join('');
305
+        default:
306
+      }
307
+
308
+      /* use method on NanPersistent instead */
309
+      if (arguments[groups[10][0]] === 'NanMakeWeakPersistent') {
310
+        return arguments[groups[10][0] + 1] + '.SetWeak(';
311
+      }
312
+
313
+      /* These return Maybes, the upper ones take no arguments */
314
+      switch (arguments[groups[11][0]]) {
315
+        case 'GetEndColumn':
316
+        case 'GetFunction':
317
+        case 'GetLineNumber':
318
+        case 'GetOwnPropertyNames':
319
+        case 'GetPropertyNames':
320
+        case 'GetSourceLine':
321
+        case 'GetStartColumn':
322
+        case 'NewInstance':
323
+        case 'ObjectProtoToString':
324
+        case 'ToArrayIndex':
325
+        case 'ToDetailString':
326
+          return [arguments[groups[11][0] - 2], 'Nan', arguments[groups[11][0]], '(', arguments[groups[11][0] - 1]].join('');
327
+        case 'CallAsConstructor':
328
+        case 'CallAsFunction':
329
+        case 'CloneElementAt':
330
+        case 'Delete':
331
+        case 'ForceSet':
332
+        case 'Get':
333
+        case 'GetPropertyAttributes':
334
+        case 'GetRealNamedProperty':
335
+        case 'GetRealNamedPropertyInPrototypeChain':
336
+        case 'Has':
337
+        case 'HasOwnProperty':
338
+        case 'HasRealIndexedProperty':
339
+        case 'HasRealNamedCallbackProperty':
340
+        case 'HasRealNamedProperty':
341
+        case 'Set':
342
+        case 'SetAccessor':
343
+        case 'SetIndexedPropertyHandler':
344
+        case 'SetNamedPropertyHandler':
345
+        case 'SetPrototype':
346
+          return [arguments[groups[11][0] - 2], 'Nan', arguments[groups[11][0]], '(', arguments[groups[11][0] - 1], ', '].join('');
347
+        default:
348
+      }
349
+
350
+      /* Automatic ToLocalChecked(), take it or leave it */
351
+      switch (arguments[groups[12][0]]) {
352
+        case 'Date':
353
+        case 'String':
354
+        case 'RegExp':
355
+          return ['NanNew', arguments[groups[12][0] - 1], arguments[groups[12][0] + 1], '.ToLocalChecked()'].join('');
356
+        default:
357
+      }
358
+
359
+      /* NanEquals is now required for uniformity */
360
+      if (arguments[groups[13][0]] === 'Equals') {
361
+        return [arguments[groups[13][0] - 1], 'NanEquals(', arguments[groups[13][0] - 1], ', ', arguments[groups[13][0] + 1]].join('');
362
+      }
363
+
364
+      /* use method on replacement class instead */
365
+      if (arguments[groups[14][0]] === 'NanAssignPersistent') {
366
+        return [arguments[groups[14][0] + 1], '.Reset('].join('');
367
+      }
368
+
369
+      /* args --> info */
370
+      if (arguments[groups[15][0]] === 'args') {
371
+        return [arguments[groups[15][0] - 1], 'info', arguments[groups[15][0] + 1]].join('');
372
+      }
373
+
374
+      /* ObjectWrap --> NanObjectWrap */
375
+      if (arguments[groups[16][0]] === 'ObjectWrap') {
376
+        return [arguments[groups[16][0] - 1], 'NanObjectWrap', arguments[groups[16][0] + 1]].join('');
377
+      }
378
+
379
+      /* Persistent --> NanPersistent */
380
+      if (arguments[groups[17][0]] === 'Persistent') {
381
+        return [arguments[groups[17][0] - 1], 'NanPersistent', arguments[groups[17][0] + 1]].join('');
382
+      }
383
+
384
+      /* This should not happen. A switch is probably missing a case if it does. */
385
+      throw 'Unhandled match: ' + arguments[0];
386
+}
387
+
388
+/* reads a file, runs replacement and writes it back */
389
+function processFile(file) {
390
+  fs.readFile(file, {encoding: 'utf8'}, function (err, data) {
391
+    if (err) {
392
+      throw err;
393
+    }
394
+
395
+    /* run replacement twice, might need more runs */
396
+    fs.writeFile(file, data.replace(master, replace).replace(master, replace), function (err) {
397
+      if (err) {
398
+        throw err;
399
+      }
400
+    });
401
+  });
402
+}
403
+
404
+/* process file names from command line and process the identified files */
405
+for (i = 2, length = process.argv.length; i < length; i++) {
406
+  glob(process.argv[i], function (err, matches) {
407
+    if (err) {
408
+      throw err;
409
+    }
410
+    matches.forEach(processFile);
411
+  });
412
+}
... ...
@@ -0,0 +1,14 @@
1
+1to2 naively converts source code files from NAN 1 to NAN 2. There will be erroneous conversions,
2
+false positives and missed opportunities. The input files are rewritten in place. Make sure that
3
+you have backups. You will have to manually review the changes afterwards and do some touchups.
4
+
5
+```sh
6
+$ tools/1to2.js
7
+
8
+  Usage: 1to2 [options] <file ...>
9
+
10
+  Options:
11
+
12
+    -h, --help     output usage information
13
+    -V, --version  output the version number
14
+```
... ...
@@ -0,0 +1,19 @@
1
+{
2
+  "name": "1to2",
3
+  "version": "1.0.0",
4
+  "description": "NAN 1 -> 2 Migration Script",
5
+  "main": "1to2.js",
6
+  "repository": {
7
+    "type": "git",
8
+    "url": "git://github.com/nodejs/nan.git"
9
+  },
10
+  "contributors": [
11
+    "Benjamin Byholm <bbyholm@abo.fi> (https://github.com/kkoopa/)",
12
+    "Mathias Küsel (https://github.com/mathiask88/)"
13
+  ],
14
+  "dependencies": {
15
+    "glob": "~5.0.10",
16
+    "commander": "~2.8.1"
17
+  },
18
+  "license": "MIT"
19
+}
... ...
@@ -0,0 +1,108 @@
1
+{
2
+  "name": "node",
3
+  "lockfileVersion": 2,
4
+  "requires": true,
5
+  "packages": {
6
+    "": {
7
+      "dependencies": {
8
+        "irc": "^0.5.2"
9
+      }
10
+    },
11
+    "node_modules/iconv": {
12
+      "version": "2.2.3",
13
+      "resolved": "https://registry.npmjs.org/iconv/-/iconv-2.2.3.tgz",
14
+      "integrity": "sha1-4ITWDut9c9p/CpwJbkyKvgkL+u0=",
15
+      "hasInstallScript": true,
16
+      "optional": true,
17
+      "dependencies": {
18
+        "nan": "^2.3.5"
19
+      },
20
+      "engines": {
21
+        "node": ">=0.8.0"
22
+      }
23
+    },
24
+    "node_modules/irc": {
25
+      "version": "0.5.2",
26
+      "resolved": "https://registry.npmjs.org/irc/-/irc-0.5.2.tgz",
27
+      "integrity": "sha1-NxT0doNlqW0LL3dryRFmvrJGS7w=",
28
+      "dependencies": {
29
+        "irc-colors": "^1.1.0"
30
+      },
31
+      "engines": {
32
+        "node": ">=0.10.0"
33
+      },
34
+      "optionalDependencies": {
35
+        "iconv": "~2.2.1",
36
+        "node-icu-charset-detector": "~0.2.0"
37
+      }
38
+    },
39
+    "node_modules/irc-colors": {
40
+      "version": "1.5.0",
41
+      "resolved": "https://registry.npmjs.org/irc-colors/-/irc-colors-1.5.0.tgz",
42
+      "integrity": "sha512-HtszKchBQTcqw1DC09uD7i7vvMayHGM1OCo6AHt5pkgZEyo99ClhHTMJdf+Ezc9ovuNNxcH89QfyclGthjZJOw==",
43
+      "engines": {
44
+        "node": ">=6"
45
+      }
46
+    },
47
+    "node_modules/nan": {
48
+      "version": "2.15.0",
49
+      "resolved": "https://registry.npmjs.org/nan/-/nan-2.15.0.tgz",
50
+      "integrity": "sha512-8ZtvEnA2c5aYCZYd1cvgdnU6cqwixRoYg70xPLWUws5ORTa/lnw+u4amixRS/Ac5U5mQVgp9pnlSUnbNWFaWZQ==",
51
+      "optional": true
52
+    },
53
+    "node_modules/node-icu-charset-detector": {
54
+      "version": "0.2.0",
55
+      "resolved": "https://registry.npmjs.org/node-icu-charset-detector/-/node-icu-charset-detector-0.2.0.tgz",
56
+      "integrity": "sha1-wjINo3Tdy2cfxUy0oOBB4Vb/1jk=",
57
+      "hasInstallScript": true,
58
+      "optional": true,
59
+      "dependencies": {
60
+        "nan": "^2.3.3"
61
+      },
62
+      "engines": {
63
+        "node": ">=0.6"
64
+      }
65
+    }
66
+  },
67
+  "dependencies": {
68
+    "iconv": {
69
+      "version": "2.2.3",
70
+      "resolved": "https://registry.npmjs.org/iconv/-/iconv-2.2.3.tgz",
71
+      "integrity": "sha1-4ITWDut9c9p/CpwJbkyKvgkL+u0=",
72
+      "optional": true,
73
+      "requires": {
74
+        "nan": "^2.3.5"
75
+      }
76
+    },
77
+    "irc": {
78
+      "version": "0.5.2",
79
+      "resolved": "https://registry.npmjs.org/irc/-/irc-0.5.2.tgz",
80
+      "integrity": "sha1-NxT0doNlqW0LL3dryRFmvrJGS7w=",
81
+      "requires": {
82
+        "iconv": "~2.2.1",
83
+        "irc-colors": "^1.1.0",
84
+        "node-icu-charset-detector": "~0.2.0"
85
+      }
86
+    },
87
+    "irc-colors": {
88
+      "version": "1.5.0",
89
+      "resolved": "https://registry.npmjs.org/irc-colors/-/irc-colors-1.5.0.tgz",
90
+      "integrity": "sha512-HtszKchBQTcqw1DC09uD7i7vvMayHGM1OCo6AHt5pkgZEyo99ClhHTMJdf+Ezc9ovuNNxcH89QfyclGthjZJOw=="
91
+    },
92
+    "nan": {
93
+      "version": "2.15.0",
94
+      "resolved": "https://registry.npmjs.org/nan/-/nan-2.15.0.tgz",
95
+      "integrity": "sha512-8ZtvEnA2c5aYCZYd1cvgdnU6cqwixRoYg70xPLWUws5ORTa/lnw+u4amixRS/Ac5U5mQVgp9pnlSUnbNWFaWZQ==",
96
+      "optional": true
97
+    },
98
+    "node-icu-charset-detector": {
99
+      "version": "0.2.0",
100
+      "resolved": "https://registry.npmjs.org/node-icu-charset-detector/-/node-icu-charset-detector-0.2.0.tgz",
101
+      "integrity": "sha1-wjINo3Tdy2cfxUy0oOBB4Vb/1jk=",
102
+      "optional": true,
103
+      "requires": {
104
+        "nan": "^2.3.3"
105
+      }
106
+    }
107
+  }
108
+}
... ...
@@ -0,0 +1,5 @@
1
+{
2
+  "dependencies": {
3
+    "irc": "^0.5.2"
4
+  }
5
+}
... ...
@@ -0,0 +1,705 @@
1
+/**
2
+ * @author fenris
3
+ */
4
+declare type int = number;
5
+/**
6
+ * @author fenris
7
+ */
8
+declare type float = number;
9
+/**
10
+ * @author fenris
11
+ */
12
+declare type type_time = {
13
+    hours: int;
14
+    minutes: int;
15
+    seconds: int;
16
+};
17
+/**
18
+ * @author fenris
19
+ */
20
+declare type type_pseudopointer<type_value> = {
21
+    value: type_value;
22
+};
23
+/**
24
+ * @author fenris
25
+ */
26
+declare function pseudopointer_null<type_value>(): type_pseudopointer<type_value>;
27
+/**
28
+ * @author fenris
29
+ */
30
+declare function pseudopointer_make<type_value>(value: type_value): type_pseudopointer<type_value>;
31
+/**
32
+ * @author fenris
33
+ */
34
+declare function pseudopointer_isset<type_value>(pseudopointer: type_pseudopointer<type_value>): boolean;
35
+/**
36
+ * @author fenris
37
+ */
38
+declare function pseudopointer_read<type_value>(pseudopointer: type_pseudopointer<type_value>): type_value;
39
+/**
40
+ * @author fenris
41
+ */
42
+declare function pseudopointer_write<type_value>(pseudopointer: type_pseudopointer<type_value>, value: type_value): void;
43
+declare var process: any;
44
+declare var require: any;
45
+declare class Buffer {
46
+    constructor(x: string, modifier?: string);
47
+    toString(modifier?: string): string;
48
+}
49
+declare var java: any;
50
+declare module lib_base {
51
+    /**
52
+     * @author fenris
53
+     */
54
+    function environment(): string;
55
+}
56
+/**
57
+ * @author fenris
58
+ */
59
+declare var instance_verbosity: int;
60
+/**
61
+ * @desc the ability to check for equality with another element of the same domain
62
+ * @author fenris
63
+ */
64
+interface interface_collatable<type_value> {
65
+    /**
66
+     * @author fenris
67
+     */
68
+    _collate(value: type_value): boolean;
69
+}
70
+/**
71
+ * @author fenris
72
+ */
73
+declare function instance_collate<type_value>(value1: type_value, value2: type_value): boolean;
74
+/**
75
+ * @desc the ability to compare with another element of the same domain for determining if the first is "smaller than or equal to" the latter
76
+ * @author fenris
77
+ */
78
+interface interface_comparable<type_value> {
79
+    /**
80
+     * @author fenris
81
+     */
82
+    _compare(value: type_value): boolean;
83
+}
84
+/**
85
+ * @author fenris
86
+ */
87
+declare function instance_compare<type_value>(value1: type_value, value2: type_value): boolean;
88
+/**
89
+ * @desc the ability to create an exact copy
90
+ * @author fenris
91
+ */
92
+interface interface_cloneable<type_value> {
93
+    /**
94
+     * @author fenris
95
+     */
96
+    _clone(): type_value;
97
+}
98
+/**
99
+ * @author fenris
100
+ */
101
+declare function instance_clone<type_value>(value: type_value): type_value;
102
+/**
103
+ * @author fenris
104
+ */
105
+interface interface_hashable {
106
+    /**
107
+     * @author fenris
108
+     */
109
+    _hash(): string;
110
+}
111
+/**
112
+ * @desc the ability to generate a string out of the element, which identifies it to a high degree
113
+ * @author fenris
114
+ */
115
+declare function instance_hash<type_value>(value: type_value): string;
116
+/**
117
+ * @author fenris
118
+ */
119
+interface interface_showable {
120
+    /**
121
+     * @author fenris
122
+     */
123
+    _show(): string;
124
+}
125
+/**
126
+ * @desc the ability to map the element to a textual representation (most likely not injective)
127
+ * @author fenris
128
+ */
129
+declare function instance_show<type_value>(value: type_value): string;
130
+/**
131
+ * @todo outsource to dedicated plankton-lib
132
+ */
133
+declare module lib_log {
134
+    /**
135
+     * @author fenris
136
+     */
137
+    function log(...args: Array<any>): void;
138
+    /**
139
+     * @author fenris
140
+     */
141
+    function info(...args: Array<any>): void;
142
+    /**
143
+     * @author fenris
144
+     */
145
+    function warn(...args: Array<any>): void;
146
+    /**
147
+     * @author fenris
148
+     */
149
+    function error(...args: Array<any>): void;
150
+}
151
+/**
152
+ * @author frac
153
+ */
154
+interface interface_decorator<type_core> {
155
+    /**
156
+     * @author frac
157
+     */
158
+    core: type_core;
159
+}
160
+/**
161
+ * @author frac
162
+ */
163
+declare class class_observer {
164
+    /**
165
+     * @author frac
166
+     */
167
+    protected counter: int;
168
+    /**
169
+     * @author frac
170
+     */
171
+    protected actions: {
172
+        [id: string]: (information: Object) => void;
173
+    };
174
+    /**
175
+     * @author frac
176
+     */
177
+    protected buffer: Array<Object>;
178
+    /**
179
+     * @author frac
180
+     */
181
+    constructor();
182
+    /**
183
+     * @author frac
184
+     */
185
+    empty(): boolean;
186
+    /**
187
+     * @author frac
188
+     */
189
+    flush(): void;
190
+    /**
191
+     * @author frac
192
+     */
193
+    set(id: string, action: (information: Object) => void): void;
194
+    /**
195
+     * @author frac
196
+     */
197
+    del(id: string): void;
198
+    /**
199
+     * @author frac
200
+     */
201
+    add(action: (information: Object) => void): void;
202
+    /**
203
+     * @author frac
204
+     */
205
+    notify(information?: Object, delayed?: boolean): void;
206
+    /**
207
+     * @author frac
208
+     */
209
+    rollout(): void;
210
+}
211
+/**
212
+ * @author frac
213
+ */
214
+/**
215
+ * @author frac
216
+ */
217
+declare module lib_maybe {
218
+    /**
219
+     * @author fenris
220
+     */
221
+    type type_maybe<type_value> = {
222
+        kind: string;
223
+        parameters: Object;
224
+    };
225
+    /**
226
+     * @author fenris
227
+     */
228
+    function make_nothing<type_value>(): type_maybe<type_value>;
229
+    /**
230
+     * @author fenris
231
+     */
232
+    function make_just<type_value>(value: type_value): type_maybe<type_value>;
233
+    /**
234
+     * @author fenris
235
+     */
236
+    function is_nothing<type_value>(maybe: type_maybe<type_value>): boolean;
237
+    /**
238
+     * @author fenris
239
+     */
240
+    function is_just<type_value>(maybe: type_maybe<type_value>): boolean;
241
+    /**
242
+     * @author fenris
243
+     */
244
+    function cull<type_value>(maybe: type_maybe<type_value>): type_value;
245
+    /**
246
+     * @author fenris
247
+     */
248
+    function propagate<type_value, type_value_>(maybe: type_maybe<type_value>, function_: (value: type_value) => type_maybe<type_value_>): type_maybe<type_value_>;
249
+}
250
+/**
251
+ * @author fenris
252
+ */
253
+declare class class_maybe<type_value> implements interface_showable {
254
+    /**
255
+     * @desc whether the wrapper is nothing
256
+     * @author fenris
257
+     */
258
+    is_nothing(): boolean;
259
+    /**
260
+     * @desc whether the wrapper is just
261
+     * @author fenris
262
+     */
263
+    is_just(): boolean;
264
+    /**
265
+     * @desc return the value, stored in the maybe-wrapper
266
+     * @author fenris
267
+     */
268
+    cull(): type_value;
269
+    /**
270
+     * @author fenris
271
+     */
272
+    toString(): string;
273
+    /**
274
+     * @author fenris
275
+     */
276
+    distinguish(action_just: (value?: type_value) => void, action_nothing?: (reason?: string) => void): void;
277
+    /**
278
+     * @author fenris
279
+     */
280
+    propagate<type_value_>(action: (value: type_value) => class_maybe<type_value_>): class_maybe<type_value_>;
281
+    /**
282
+     * @desc [implementation]
283
+     * @author fenris
284
+     */
285
+    _show(): string;
286
+}
287
+/**
288
+ * @author fenris
289
+ */
290
+declare class class_nothing<type_value> extends class_maybe<type_value> {
291
+    /**
292
+     * @author fenris
293
+     */
294
+    private reason;
295
+    /**
296
+     * @author fenris
297
+     */
298
+    constructor(reason?: string);
299
+    /**
300
+     * @author fenris
301
+     */
302
+    is_nothing(): boolean;
303
+    /**
304
+     * @author fenris
305
+     */
306
+    is_just(): boolean;
307
+    /**
308
+     * @author fenris
309
+     */
310
+    cull(): type_value;
311
+    /**
312
+     * @author fenris
313
+     */
314
+    toString(): string;
315
+    /**
316
+     * @author fenris
317
+     */
318
+    reason_get(): string;
319
+    /**
320
+     * @author fenris
321
+     */
322
+    distinguish(action_just: (value?: type_value) => void, action_nothing?: (reason?: string) => void): void;
323
+    /**
324
+     * @author fenris
325
+     */
326
+    propagate<type_value_>(action: (value: type_value) => class_maybe<type_value_>): class_maybe<type_value_>;
327
+}
328
+/**
329
+ * @author fenris
330
+ */
331
+declare class class_just<type_value> extends class_maybe<type_value> {
332
+    /**
333
+     * @author fenris
334
+     */
335
+    private value;
336
+    /**
337
+     * @author fenris
338
+     */
339
+    constructor(value: type_value);
340
+    /**
341
+     * @author fenris
342
+     */
343
+    is_nothing(): boolean;
344
+    /**
345
+     * @author fenris
346
+     */
347
+    is_just(): boolean;
348
+    /**
349
+     * @author fenris
350
+     */
351
+    cull(): type_value;
352
+    /**
353
+     * @author fenris
354
+     */
355
+    toString(): string;
356
+    /**
357
+     * @author fenris
358
+     */
359
+    distinguish(action_just: (value?: type_value) => void, action_nothing?: (reason?: string) => void): void;
360
+    /**
361
+     * @author fenris
362
+     */
363
+    propagate<type_value_>(action: (value: type_value) => class_maybe<type_value_>): class_maybe<type_value_>;
364
+}
365
+/**
366
+ * @author frac
367
+ */
368
+declare class class_error extends Error {
369
+    /**
370
+     * @author frac
371
+     */
372
+    protected suberrors: Array<Error>;
373
+    /**
374
+     * @author frac
375
+     */
376
+    protected mess: string;
377
+    /**
378
+     * @author frac
379
+     */
380
+    constructor(message: string, suberrors?: Array<Error>);
381
+    /**
382
+     * @override
383
+     * @author frac
384
+     */
385
+    toString(): string;
386
+}
387
+declare module lib_code {
388
+    /**
389
+     * @author fenris
390
+     */
391
+    interface interface_code<type_from, type_to> {
392
+        /**
393
+         * @author fenris
394
+         */
395
+        encode(x: type_from): type_to;
396
+        /**
397
+         * @author fenris
398
+         */
399
+        decode(x: type_to): type_from;
400
+    }
401
+}
402
+declare module lib_code {
403
+    /**
404
+     * @author fenris
405
+     */
406
+    type type_code<type_from, type_to> = {
407
+        /**
408
+         * @author fenris
409
+         */
410
+        encode: (x: type_from) => type_to;
411
+        /**
412
+         * @author fenris
413
+         */
414
+        decode: (x: type_to) => type_from;
415
+    };
416
+}
417
+declare module lib_code {
418
+    /**
419
+     * @author fenris
420
+     */
421
+    function inverse_encode<type_from, type_to>(decode: (to: type_to) => type_from, to: type_to): type_from;
422
+    /**
423
+     * @author fenris
424
+     */
425
+    function inverse_decode<type_from, type_to>(encode: (from: type_from) => type_to, from: type_from): type_to;
426
+}
427
+declare module lib_code {
428
+    /**
429
+     * @author fenris
430
+     */
431
+    class class_code_inverse<type_from, type_to> implements interface_code<type_to, type_from> {
432
+        /**
433
+         * @author fenris
434
+         */
435
+        protected subject: interface_code<type_from, type_to>;
436
+        /**
437
+         * @author fenris
438
+         */
439
+        constructor(subject: interface_code<type_from, type_to>);
440
+        /**
441
+         * @implementation
442
+         * @author fenris
443
+         */
444
+        encode(to: type_to): type_from;
445
+        /**
446
+         * @implementation
447
+         * @author fenris
448
+         */
449
+        decode(from: type_from): type_to;
450
+    }
451
+}
452
+declare module lib_code {
453
+    /**
454
+     * @author fenris
455
+     */
456
+    function pair_encode<type_from, type_between, type_to>(encode_first: (from: type_from) => type_between, encode_second: (between: type_between) => type_to, from: type_from): type_to;
457
+    /**
458
+     * @author fenris
459
+     */
460
+    function pair_decode<type_from, type_between, type_to>(decode_first: (between: type_between) => type_from, decode_second: (to: type_to) => type_between, to: type_to): type_from;
461
+}
462
+declare module lib_code {
463
+    /**
464
+     * @author fenris
465
+     */
466
+    class class_code_pair<type_from, type_between, type_to> implements interface_code<type_from, type_to> {
467
+        /**
468
+         * @author fenris
469
+         */
470
+        protected first: interface_code<type_from, type_between>;
471
+        /**
472
+         * @author fenris
473
+         */
474
+        protected second: interface_code<type_between, type_to>;
475
+        /**
476
+         * @author fenris
477
+         */
478
+        constructor(first: interface_code<type_from, type_between>, second: interface_code<type_between, type_to>);
479
+        /**
480
+         * @implementation
481
+         * @author fenris
482
+         */
483
+        encode(from: type_from): type_to;
484
+        /**
485
+         * @implementation
486
+         * @author fenris
487
+         */
488
+        decode(to: type_to): type_from;
489
+    }
490
+}
491
+declare module lib_code {
492
+    /**
493
+     * @author fenris
494
+     */
495
+    function chain_encode(encode_links: Array<(from: any) => any>, from: any): any;
496
+    /**
497
+     * @author fenris
498
+     */
499
+    function chain_decode(decode_links: Array<(to: any) => any>, to: any): any;
500
+}
501
+declare module lib_code {
502
+    /**
503
+     * @author fenris
504
+     */
505
+    class class_code_chain implements interface_code<any, any> {
506
+        /**
507
+         * @author fenris
508
+         */
509
+        protected links: Array<interface_code<any, any>>;
510
+        /**
511
+         * @author fenris
512
+         */
513
+        constructor(links: Array<interface_code<any, any>>);
514
+        /**
515
+         * @implementation
516
+         * @author fenris
517
+         */
518
+        encode(from: any): any;
519
+        /**
520
+         * @implementation
521
+         * @author fenris
522
+         */
523
+        decode(to: any): any;
524
+    }
525
+}
526
+declare module lib_code {
527
+    /**
528
+     * @author Christian Fraß <frass@greenscale.de>
529
+     */
530
+    type type_flatten_from = Array<{
531
+        [name: string]: any;
532
+    }>;
533
+    /**
534
+     * @author Christian Fraß <frass@greenscale.de>
535
+     */
536
+    type type_flatten_to = {
537
+        keys: Array<string>;
538
+        data: Array<Array<any>>;
539
+    };
540
+    /**
541
+     * @author Christian Fraß <frass@greenscale.de>
542
+     */
543
+    function flatten_encode(from: type_flatten_from, keys?: Array<string>): type_flatten_to;
544
+    /**
545
+     * @author Christian Fraß <frass@greenscale.de>
546
+     */
547
+    function flatten_decode(to: type_flatten_to): type_flatten_from;
548
+}
549
+declare module lib_code {
550
+    /**
551
+     * @author fenris
552
+     */
553
+    class class_code_flatten implements interface_code<type_flatten_from, type_flatten_to> {
554
+        /**
555
+         * @author fenris
556
+         */
557
+        constructor();
558
+        /**
559
+         * @implementation
560
+         * @author fenris
561
+         */
562
+        encode(x: type_flatten_from): type_flatten_to;
563
+        /**
564
+         * @implementation
565
+         * @author fenris
566
+         */
567
+        decode(x: type_flatten_to): type_flatten_from;
568
+    }
569
+}
570
+declare module lib_http {
571
+    /**
572
+     * @author fenris <frass@greenscale.de>
573
+     */
574
+    enum enum_method {
575
+        get = "get",
576
+        post = "post",
577
+        options = "options"
578
+    }
579
+    /**
580
+     * @author fenris <frass@greenscale.de>
581
+     */
582
+    type type_request = {
583
+        host: string;
584
+        query: string;
585
+        method: enum_method;
586
+        headers: {
587
+            [name: string]: string;
588
+        };
589
+        body: string;
590
+    };
591
+    /**
592
+     * @author fenris <frass@greenscale.de>
593
+     */
594
+    type type_response = {
595
+        statuscode: int;
596
+        headers: {
597
+            [name: string]: string;
598
+        };
599
+        body: string;
600
+    };
601
+}
602
+declare module lib_http {
603
+    /**
604
+     * @author fenris <frass@greenscale.de>
605
+     */
606
+    function encode_request(request: type_request): string;
607
+    /**
608
+     * @author fenris <frass@greenscale.de>
609
+     */
610
+    function decode_request(request_raw: string): type_request;
611
+    /**
612
+     * @author fenris <frass@greenscale.de>
613
+     */
614
+    function encode_response(response: type_response): string;
615
+    /**
616
+     * @author fenris <frass@greenscale.de>
617
+     */
618
+    function decode_response(response_raw: string): type_response;
619
+}
620
+declare module lib_http {
621
+    /**
622
+     * @author fenris
623
+     */
624
+    class class_http_request implements lib_code.interface_code<type_request, string> {
625
+        /**
626
+         * @author fenris
627
+         */
628
+        constructor();
629
+        /**
630
+         * @implementation
631
+         * @author fenris
632
+         */
633
+        encode(x: type_request): string;
634
+        /**
635
+         * @implementation
636
+         * @author fenris
637
+         */
638
+        decode(x: string): type_request;
639
+    }
640
+    /**
641
+     * @author fenris
642
+     */
643
+    class class_http_response implements lib_code.interface_code<type_response, string> {
644
+        /**
645
+         * @author fenris
646
+         */
647
+        constructor();
648
+        /**
649
+         * @implementation
650
+         * @author fenris
651
+         */
652
+        encode(x: type_response): string;
653
+        /**
654
+         * @implementation
655
+         * @author fenris
656
+         */
657
+        decode(x: string): type_response;
658
+    }
659
+}
660
+declare module lib_server {
661
+    /**
662
+     * @author fenris
663
+     */
664
+    type type_subject = {
665
+        port: int;
666
+        handle: (input: string) => Promise<string>;
667
+        verbosity: int;
668
+        serverobj: any;
669
+    };
670
+    /**
671
+     * @author fenris
672
+     */
673
+    function make(port: int, handle: (input: string) => Promise<string>, verbosity?: int): type_subject;
674
+    /**
675
+     * @author fenris
676
+     */
677
+    function start(subject: type_subject): Promise<void>;
678
+    /**
679
+     * @author fenris
680
+     */
681
+    function kill(subject: type_subject): void;
682
+}
683
+declare module lib_server {
684
+    /**
685
+     * @author fenris
686
+     */
687
+    class class_server {
688
+        /**
689
+         * @author fenris
690
+         */
691
+        protected subject: type_subject;
692
+        /**
693
+         * @author fenris
694
+         */
695
+        constructor(port: int, handle: (input: string) => Promise<string>, verbosity?: int);
696
+        /**
697
+         * @author fenris
698
+         */
699
+        start(): Promise<void>;
700
+        /**
701
+         * @author fenris
702
+         */
703
+        kill(): void;
704
+    }
705
+}
... ...
@@ -0,0 +1,1620 @@
1
+var __extends = (this && this.__extends) || (function () {
2
+    var extendStatics = function (d, b) {
3
+        extendStatics = Object.setPrototypeOf ||
4
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
5
+            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
6
+        return extendStatics(d, b);
7
+    };
8
+    return function (d, b) {
9
+        extendStatics(d, b);
10
+        function __() { this.constructor = d; }
11
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
12
+    };
13
+})();
14
+/*
15
+This file is part of »bacterio-plankton:base«.
16
+
17
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
18
+<info@greenscale.de>
19
+
20
+»bacterio-plankton:base« is free software: you can redistribute it and/or modify
21
+it under the terms of the GNU Lesser General Public License as published by
22
+the Free Software Foundation, either version 3 of the License, or
23
+(at your option) any later version.
24
+
25
+»bacterio-plankton:base« is distributed in the hope that it will be useful,
26
+but WITHOUT ANY WARRANTY; without even the implied warranty of
27
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
28
+GNU Lesser General Public License for more details.
29
+
30
+You should have received a copy of the GNU Lesser General Public License
31
+along with »bacterio-plankton:base«. If not, see <http://www.gnu.org/licenses/>.
32
+ */
33
+// }
34
+/*
35
+This file is part of »bacterio-plankton:base«.
36
+
37
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
38
+<info@greenscale.de>
39
+
40
+»bacterio-plankton:base« is free software: you can redistribute it and/or modify
41
+it under the terms of the GNU Lesser General Public License as published by
42
+the Free Software Foundation, either version 3 of the License, or
43
+(at your option) any later version.
44
+
45
+»bacterio-plankton:base« is distributed in the hope that it will be useful,
46
+but WITHOUT ANY WARRANTY; without even the implied warranty of
47
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
48
+GNU Lesser General Public License for more details.
49
+
50
+You should have received a copy of the GNU Lesser General Public License
51
+along with »bacterio-plankton:base«. If not, see <http://www.gnu.org/licenses/>.
52
+ */
53
+/**
54
+ * @author fenris
55
+ */
56
+/*export*/ function pseudopointer_null() {
57
+    return {
58
+        "value": null
59
+    };
60
+}
61
+/**
62
+ * @author fenris
63
+ */
64
+/*export*/ function pseudopointer_make(value) {
65
+    return {
66
+        "value": value
67
+    };
68
+}
69
+/**
70
+ * @author fenris
71
+ */
72
+/*export*/ function pseudopointer_isset(pseudopointer) {
73
+    return (pseudopointer.value != null);
74
+}
75
+/**
76
+ * @author fenris
77
+ */
78
+/*export*/ function pseudopointer_read(pseudopointer) {
79
+    if (pseudopointer.value != null) {
80
+        return pseudopointer.value;
81
+    }
82
+    else {
83
+        var message = "nullpointer dereferencation";
84
+        throw (new Error(message));
85
+    }
86
+}
87
+/**
88
+ * @author fenris
89
+ */
90
+/*export*/ function pseudopointer_write(pseudopointer, value) {
91
+    pseudopointer.value = value;
92
+}
93
+/*
94
+This file is part of »bacterio-plankton:base«.
95
+
96
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
97
+<info@greenscale.de>
98
+
99
+»bacterio-plankton:base« is free software: you can redistribute it and/or modify
100
+it under the terms of the GNU Lesser General Public License as published by
101
+the Free Software Foundation, either version 3 of the License, or
102
+(at your option) any later version.
103
+
104
+»bacterio-plankton:base« is distributed in the hope that it will be useful,
105
+but WITHOUT ANY WARRANTY; without even the implied warranty of
106
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
107
+GNU Lesser General Public License for more details.
108
+
109
+You should have received a copy of the GNU Lesser General Public License
110
+along with »bacterio-plankton:base«. If not, see <http://www.gnu.org/licenses/>.
111
+ */
112
+;
113
+var lib_base;
114
+(function (lib_base) {
115
+    /**
116
+     * @author fenris
117
+     */
118
+    function environment() {
119
+        var entries = [
120
+            {
121
+                "id": "web",
122
+                "name": "Web",
123
+                "predicate": function () { return (typeof (document) !== "undefined"); },
124
+            },
125
+            {
126
+                "id": "node",
127
+                "name": "Node.js",
128
+                "predicate": function () { return (typeof (process) !== "undefined"); },
129
+            },
130
+            {
131
+                "id": "rhino",
132
+                "name": "Rhino",
133
+                "predicate": function () { return (typeof (java) !== "undefined"); },
134
+            },
135
+            {
136
+                "id": "webworker",
137
+                "name": "WebWorker",
138
+                "predicate": function () { return (typeof (self["WorkerNavigator"]) !== "undefined"); }
139
+            }
140
+        ];
141
+        var id;
142
+        var found = entries.some(function (entry) {
143
+            if (entry.predicate()) {
144
+                id = entry.id;
145
+                return true;
146
+            }
147
+            else {
148
+                return false;
149
+            }
150
+        });
151
+        if (found) {
152
+            return id;
153
+        }
154
+        else {
155
+            throw (new Error("unknown environment"));
156
+        }
157
+    }
158
+    lib_base.environment = environment;
159
+})(lib_base || (lib_base = {}));
160
+/*
161
+This file is part of »bacterio-plankton:base«.
162
+
163
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
164
+<info@greenscale.de>
165
+
166
+»bacterio-plankton:base« is free software: you can redistribute it and/or modify
167
+it under the terms of the GNU Lesser General Public License as published by
168
+the Free Software Foundation, either version 3 of the License, or
169
+(at your option) any later version.
170
+
171
+»bacterio-plankton:base« is distributed in the hope that it will be useful,
172
+but WITHOUT ANY WARRANTY; without even the implied warranty of
173
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
174
+GNU Lesser General Public License for more details.
175
+
176
+You should have received a copy of the GNU Lesser General Public License
177
+along with »bacterio-plankton:base«. If not, see <http://www.gnu.org/licenses/>.
178
+ */
179
+/**
180
+ * @author fenris
181
+ */
182
+var instance_verbosity = 0;
183
+/**
184
+ * @author fenris
185
+ */
186
+function instance_collate(value1, value2) {
187
+    if (typeof (value1) === "object") {
188
+        if (value1 == null) {
189
+            return (value2 == null);
190
+        }
191
+        else {
192
+            if ("_collate" in value1) {
193
+                return value1["_collate"](value2);
194
+            }
195
+            else {
196
+                throw (new Error("[collate]" + " " + "object has no such method"));
197
+            }
198
+        }
199
+    }
200
+    else {
201
+        if (instance_verbosity >= 1) {
202
+            lib_log.warn("[collate]" + " " + "primitive value; using default implementation");
203
+        }
204
+        return (value1 === value2);
205
+    }
206
+}
207
+/**
208
+ * @author fenris
209
+ */
210
+function instance_compare(value1, value2) {
211
+    if (typeof (value1) === "object") {
212
+        if ("_compare" in value1) {
213
+            return value1["_compare"](value2);
214
+        }
215
+        else {
216
+            throw (new Error("[compare]" + " " + "object has no such method"));
217
+        }
218
+    }
219
+    else {
220
+        if (instance_verbosity >= 1) {
221
+            lib_log.warn("[compare]" + " " + "primitive value; using default implementation");
222
+        }
223
+        return (value1 <= value2);
224
+    }
225
+}
226
+/**
227
+ * @author fenris
228
+ */
229
+function instance_clone(value) {
230
+    if (typeof (value) === "object") {
231
+        if ("_clone" in value) {
232
+            return value["_clone"]();
233
+        }
234
+        else {
235
+            throw (new Error("[clone]" + " " + "object has no such method"));
236
+        }
237
+    }
238
+    else {
239
+        if (instance_verbosity >= 1) {
240
+            lib_log.warn("[clone]" + " " + "primitive value; using default implementation");
241
+        }
242
+        return value;
243
+    }
244
+}
245
+/**
246
+ * @desc the ability to generate a string out of the element, which identifies it to a high degree
247
+ * @author fenris
248
+ */
249
+function instance_hash(value) {
250
+    if (typeof (value) === "object") {
251
+        if ("_hash" in value) {
252
+            return value["_hash"]();
253
+        }
254
+        else {
255
+            throw (new Error("[hash]" + " " + "object has no such method"));
256
+        }
257
+    }
258
+    else {
259
+        if (instance_verbosity >= 1) {
260
+            lib_log.warn("[hash]" + " " + "primitive value; using default implementation");
261
+        }
262
+        return String(value);
263
+    }
264
+}
265
+/**
266
+ * @desc the ability to map the element to a textual representation (most likely not injective)
267
+ * @author fenris
268
+ */
269
+function instance_show(value) {
270
+    if (typeof (value) === "object") {
271
+        if (value == null) {
272
+            return "NULL";
273
+        }
274
+        else {
275
+            if ("_show" in value) {
276
+                return value["_show"]();
277
+            }
278
+            else {
279
+                // throw (new Error("[show]" + " " + "object has no such method"));
280
+                return JSON.stringify(value);
281
+            }
282
+        }
283
+    }
284
+    else {
285
+        if (instance_verbosity >= 1) {
286
+            lib_log.warn("[show]" + " " + "primitive value; using default implementation");
287
+        }
288
+        return String(value);
289
+    }
290
+}
291
+/*
292
+This file is part of »bacterio-plankton:base«.
293
+
294
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
295
+<info@greenscale.de>
296
+
297
+»bacterio-plankton:base« is free software: you can redistribute it and/or modify
298
+it under the terms of the GNU Lesser General Public License as published by
299
+the Free Software Foundation, either version 3 of the License, or
300
+(at your option) any later version.
301
+
302
+»bacterio-plankton:base« is distributed in the hope that it will be useful,
303
+but WITHOUT ANY WARRANTY; without even the implied warranty of
304
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
305
+GNU Lesser General Public License for more details.
306
+
307
+You should have received a copy of the GNU Lesser General Public License
308
+along with »bacterio-plankton:base«. If not, see <http://www.gnu.org/licenses/>.
309
+ */
310
+/**
311
+ * @todo outsource to dedicated plankton-lib
312
+ */
313
+var lib_log;
314
+(function (lib_log) {
315
+    /**
316
+     * @author fenris
317
+     */
318
+    function log() {
319
+        var args = [];
320
+        for (var _i = 0; _i < arguments.length; _i++) {
321
+            args[_i] = arguments[_i];
322
+        }
323
+        /*window.*/ console.log.apply(console, args);
324
+    }
325
+    lib_log.log = log;
326
+    /**
327
+     * @author fenris
328
+     */
329
+    function info() {
330
+        var args = [];
331
+        for (var _i = 0; _i < arguments.length; _i++) {
332
+            args[_i] = arguments[_i];
333
+        }
334
+        /*window.*/ console.info.apply(console, args);
335
+    }
336
+    lib_log.info = info;
337
+    /**
338
+     * @author fenris
339
+     */
340
+    function warn() {
341
+        var args = [];
342
+        for (var _i = 0; _i < arguments.length; _i++) {
343
+            args[_i] = arguments[_i];
344
+        }
345
+        /*window.*/ console.warn.apply(console, args);
346
+    }
347
+    lib_log.warn = warn;
348
+    /**
349
+     * @author fenris
350
+     */
351
+    function error() {
352
+        var args = [];
353
+        for (var _i = 0; _i < arguments.length; _i++) {
354
+            args[_i] = arguments[_i];
355
+        }
356
+        /*window.*/ console.error.apply(console, args);
357
+    }
358
+    lib_log.error = error;
359
+})(lib_log || (lib_log = {}));
360
+/*
361
+This file is part of »bacterio-plankton:base«.
362
+
363
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
364
+<info@greenscale.de>
365
+
366
+»bacterio-plankton:base« is free software: you can redistribute it and/or modify
367
+it under the terms of the GNU Lesser General Public License as published by
368
+the Free Software Foundation, either version 3 of the License, or
369
+(at your option) any later version.
370
+
371
+»bacterio-plankton:base« is distributed in the hope that it will be useful,
372
+but WITHOUT ANY WARRANTY; without even the implied warranty of
373
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
374
+GNU Lesser General Public License for more details.
375
+
376
+You should have received a copy of the GNU Lesser General Public License
377
+along with »bacterio-plankton:base«. If not, see <http://www.gnu.org/licenses/>.
378
+ */
379
+/**
380
+ * @author frac
381
+ */
382
+var class_observer = /** @class */ (function () {
383
+    /**
384
+     * @author frac
385
+     */
386
+    function class_observer() {
387
+        this.counter = 0;
388
+        this.actions = {};
389
+        this.buffer = [];
390
+    }
391
+    /**
392
+     * @author frac
393
+     */
394
+    class_observer.prototype.empty = function () {
395
+        return (Object.keys(this.actions).length == 0);
396
+    };
397
+    /**
398
+     * @author frac
399
+     */
400
+    class_observer.prototype.flush = function () {
401
+        this.actions = {};
402
+    };
403
+    /**
404
+     * @author frac
405
+     */
406
+    class_observer.prototype.set = function (id, action) {
407
+        this.actions[id] = action;
408
+    };
409
+    /**
410
+     * @author frac
411
+     */
412
+    class_observer.prototype.del = function (id) {
413
+        delete this.actions[id];
414
+    };
415
+    /**
416
+     * @author frac
417
+     */
418
+    class_observer.prototype.add = function (action) {
419
+        this.set((this.counter++).toString(), action);
420
+    };
421
+    /**
422
+     * @author frac
423
+     */
424
+    class_observer.prototype.notify = function (information, delayed) {
425
+        var _this = this;
426
+        if (information === void 0) { information = {}; }
427
+        if (delayed === void 0) { delayed = false; }
428
+        if (delayed) {
429
+            this.buffer.push(information);
430
+        }
431
+        else {
432
+            Object.keys(this.actions).forEach(function (id) { return _this.actions[id](information); });
433
+        }
434
+    };
435
+    /**
436
+     * @author frac
437
+     */
438
+    class_observer.prototype.rollout = function () {
439
+        var _this = this;
440
+        this.buffer.forEach(function (information) { return _this.notify(information, false); });
441
+        this.buffer = [];
442
+    };
443
+    return class_observer;
444
+}());
445
+/**
446
+ * @author frac
447
+ */
448
+/*
449
+export interface interface_readable<type_value> {
450
+
451
+    |**
452
+     * @author frac
453
+     *|
454
+    read() : type_executor<type_value, Error>;
455
+
456
+}
457
+ */
458
+/**
459
+ * @author frac
460
+ */
461
+/*
462
+export interface interface_writeable<type_value> {
463
+
464
+    |**
465
+     * @author frac
466
+     *|
467
+    write(value : type_value) : type_executor<void, Error>;
468
+
469
+}
470
+ */
471
+/*
472
+This file is part of »bacterio-plankton:base«.
473
+
474
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
475
+<info@greenscale.de>
476
+
477
+»bacterio-plankton:base« is free software: you can redistribute it and/or modify
478
+it under the terms of the GNU Lesser General Public License as published by
479
+the Free Software Foundation, either version 3 of the License, or
480
+(at your option) any later version.
481
+
482
+»bacterio-plankton:base« is distributed in the hope that it will be useful,
483
+but WITHOUT ANY WARRANTY; without even the implied warranty of
484
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
485
+GNU Lesser General Public License for more details.
486
+
487
+You should have received a copy of the GNU Lesser General Public License
488
+along with »bacterio-plankton:base«. If not, see <http://www.gnu.org/licenses/>.
489
+ */
490
+var lib_maybe;
491
+(function (lib_maybe) {
492
+    /**
493
+     * @author fenris
494
+     */
495
+    function make_nothing() {
496
+        return {
497
+            "kind": "nothing",
498
+            "parameters": {}
499
+        };
500
+    }
501
+    lib_maybe.make_nothing = make_nothing;
502
+    /**
503
+     * @author fenris
504
+     */
505
+    function make_just(value) {
506
+        return {
507
+            "kind": "just",
508
+            "parameters": {
509
+                "value": value
510
+            }
511
+        };
512
+    }
513
+    lib_maybe.make_just = make_just;
514
+    /**
515
+     * @author fenris
516
+     */
517
+    function is_nothing(maybe) {
518
+        return (maybe.kind === "nothing");
519
+    }
520
+    lib_maybe.is_nothing = is_nothing;
521
+    /**
522
+     * @author fenris
523
+     */
524
+    function is_just(maybe) {
525
+        return (maybe.kind === "just");
526
+    }
527
+    lib_maybe.is_just = is_just;
528
+    /**
529
+     * @author fenris
530
+     */
531
+    function cull(maybe) {
532
+        if (!is_just(maybe)) {
533
+            var message = "cull from nothing";
534
+            throw (new Error(message));
535
+        }
536
+        else {
537
+            var value = maybe.parameters["value"];
538
+            return value;
539
+        }
540
+    }
541
+    lib_maybe.cull = cull;
542
+    /**
543
+     * @author fenris
544
+     */
545
+    function propagate(maybe, function_) {
546
+        if (!is_just(maybe)) {
547
+        }
548
+        else {
549
+            var value = maybe.parameters["value"];
550
+            var maybe_ = function_(value);
551
+            return maybe_;
552
+        }
553
+    }
554
+    lib_maybe.propagate = propagate;
555
+})(lib_maybe || (lib_maybe = {}));
556
+/**
557
+ * @author fenris
558
+ */
559
+/*export*/ var class_maybe = /** @class */ (function () {
560
+    function class_maybe() {
561
+    }
562
+    /**
563
+     * @desc whether the wrapper is nothing
564
+     * @author fenris
565
+     */
566
+    class_maybe.prototype.is_nothing = function () {
567
+        throw (new Error("not implemented: class_maybe.is_nothing"));
568
+    };
569
+    /**
570
+     * @desc whether the wrapper is just
571
+     * @author fenris
572
+     */
573
+    class_maybe.prototype.is_just = function () {
574
+        throw (new Error("not implemented: class_maybe.is_just"));
575
+    };
576
+    /**
577
+     * @desc return the value, stored in the maybe-wrapper
578
+     * @author fenris
579
+     */
580
+    class_maybe.prototype.cull = function () {
581
+        throw (new Error("not implemented: class_maybe.cull"));
582
+    };
583
+    /**
584
+     * @author fenris
585
+     */
586
+    class_maybe.prototype.toString = function () {
587
+        throw (new Error("not implemented: class_maybe.cull"));
588
+    };
589
+    /**
590
+     * @author fenris
591
+     */
592
+    class_maybe.prototype.distinguish = function (action_just, action_nothing) {
593
+        if (action_nothing === void 0) { action_nothing = function () { }; }
594
+        throw (new Error("not implemented: class_maybe.distinguish"));
595
+    };
596
+    /**
597
+     * @author fenris
598
+     */
599
+    class_maybe.prototype.propagate = function (action) {
600
+        throw (new Error("not implemented: class_maybe.propagate"));
601
+    };
602
+    /**
603
+     * @desc [implementation]
604
+     * @author fenris
605
+     */
606
+    class_maybe.prototype._show = function () {
607
+        return this.toString();
608
+    };
609
+    return class_maybe;
610
+}());
611
+/**
612
+ * @author fenris
613
+ */
614
+/*export*/ var class_nothing = /** @class */ (function (_super) {
615
+    __extends(class_nothing, _super);
616
+    /**
617
+     * @author fenris
618
+     */
619
+    function class_nothing(reason) {
620
+        if (reason === void 0) { reason = null; }
621
+        var _this = _super.call(this) || this;
622
+        _this.reason = reason;
623
+        return _this;
624
+    }
625
+    /**
626
+     * @author fenris
627
+     */
628
+    class_nothing.prototype.is_nothing = function () {
629
+        return true;
630
+    };
631
+    /**
632
+     * @author fenris
633
+     */
634
+    class_nothing.prototype.is_just = function () {
635
+        return false;
636
+    };
637
+    /**
638
+     * @author fenris
639
+     */
640
+    class_nothing.prototype.cull = function () {
641
+        var message = "you shouldn't cull a nothing-value …";
642
+        lib_log.warn(message);
643
+        return null;
644
+    };
645
+    /**
646
+     * @author fenris
647
+     */
648
+    class_nothing.prototype.toString = function () {
649
+        return "<\u00B7>";
650
+    };
651
+    /**
652
+     * @author fenris
653
+     */
654
+    class_nothing.prototype.reason_get = function () {
655
+        var content = ((this.reason == null) ? "·" : this.reason);
656
+        return "<- " + content + " ->";
657
+    };
658
+    /**
659
+     * @author fenris
660
+     */
661
+    class_nothing.prototype.distinguish = function (action_just, action_nothing) {
662
+        if (action_nothing === void 0) { action_nothing = function () { }; }
663
+        action_nothing(this.reason);
664
+    };
665
+    /**
666
+     * @author fenris
667
+     */
668
+    class_nothing.prototype.propagate = function (action) {
669
+        return (new class_nothing(this.reason));
670
+    };
671
+    return class_nothing;
672
+}(class_maybe));
673
+/**
674
+ * @author fenris
675
+ */
676
+/*export*/ var class_just = /** @class */ (function (_super) {
677
+    __extends(class_just, _super);
678
+    /**
679
+     * @author fenris
680
+     */
681
+    function class_just(value) {
682
+        var _this = _super.call(this) || this;
683
+        _this.value = value;
684
+        return _this;
685
+    }
686
+    /**
687
+     * @author fenris
688
+     */
689
+    class_just.prototype.is_nothing = function () {
690
+        return false;
691
+    };
692
+    /**
693
+     * @author fenris
694
+     */
695
+    class_just.prototype.is_just = function () {
696
+        return true;
697
+    };
698
+    /**
699
+     * @author fenris
700
+     */
701
+    class_just.prototype.cull = function () {
702
+        return this.value;
703
+    };
704
+    /**
705
+     * @author fenris
706
+     */
707
+    class_just.prototype.toString = function () {
708
+        var content = instance_show(this.value);
709
+        return "<+ " + content + " +>";
710
+    };
711
+    /**
712
+     * @author fenris
713
+     */
714
+    class_just.prototype.distinguish = function (action_just, action_nothing) {
715
+        if (action_nothing === void 0) { action_nothing = function () { }; }
716
+        action_just(this.value);
717
+    };
718
+    /**
719
+     * @author fenris
720
+     */
721
+    class_just.prototype.propagate = function (action) {
722
+        return action(this.value);
723
+    };
724
+    return class_just;
725
+}(class_maybe));
726
+/*
727
+This file is part of »bacterio-plankton:base«.
728
+
729
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
730
+<info@greenscale.de>
731
+
732
+»bacterio-plankton:base« is free software: you can redistribute it and/or modify
733
+it under the terms of the GNU Lesser General Public License as published by
734
+the Free Software Foundation, either version 3 of the License, or
735
+(at your option) any later version.
736
+
737
+»bacterio-plankton:base« is distributed in the hope that it will be useful,
738
+but WITHOUT ANY WARRANTY; without even the implied warranty of
739
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
740
+GNU Lesser General Public License for more details.
741
+
742
+You should have received a copy of the GNU Lesser General Public License
743
+along with »bacterio-plankton:base«. If not, see <http://www.gnu.org/licenses/>.
744
+ */
745
+/**
746
+ * @author frac
747
+ */
748
+var class_error = /** @class */ (function (_super) {
749
+    __extends(class_error, _super);
750
+    /**
751
+     * @author frac
752
+     */
753
+    function class_error(message, suberrors) {
754
+        if (suberrors === void 0) { suberrors = []; }
755
+        var _this = _super.call(this, message) || this;
756
+        _this.suberrors = suberrors;
757
+        _this.mess = message;
758
+        return _this;
759
+    }
760
+    /**
761
+     * @override
762
+     * @author frac
763
+     */
764
+    class_error.prototype.toString = function () {
765
+        return ( /*super.toString()*/this.mess + " " + ("[" + this.suberrors.map(function (x) { return x.toString(); }).join(",") + "]"));
766
+    };
767
+    return class_error;
768
+}(Error));
769
+/*
770
+This file is part of »bacterio-plankton:code«.
771
+
772
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
773
+<info@greenscale.de>
774
+
775
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
776
+it under the terms of the GNU Lesser General Public License as published by
777
+the Free Software Foundation, either version 3 of the License, or
778
+(at your option) any later version.
779
+
780
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
781
+but WITHOUT ANY WARRANTY; without even the implied warranty of
782
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
783
+GNU Lesser General Public License for more details.
784
+
785
+You should have received a copy of the GNU Lesser General Public License
786
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
787
+ */
788
+/*
789
+This file is part of »bacterio-plankton:code«.
790
+
791
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
792
+<info@greenscale.de>
793
+
794
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
795
+it under the terms of the GNU Lesser General Public License as published by
796
+the Free Software Foundation, either version 3 of the License, or
797
+(at your option) any later version.
798
+
799
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
800
+but WITHOUT ANY WARRANTY; without even the implied warranty of
801
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
802
+GNU Lesser General Public License for more details.
803
+
804
+You should have received a copy of the GNU Lesser General Public License
805
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
806
+ */
807
+/*
808
+This file is part of »bacterio-plankton:code«.
809
+
810
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
811
+<info@greenscale.de>
812
+
813
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
814
+it under the terms of the GNU Lesser General Public License as published by
815
+the Free Software Foundation, either version 3 of the License, or
816
+(at your option) any later version.
817
+
818
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
819
+but WITHOUT ANY WARRANTY; without even the implied warranty of
820
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
821
+GNU Lesser General Public License for more details.
822
+
823
+You should have received a copy of the GNU Lesser General Public License
824
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
825
+ */
826
+var lib_code;
827
+(function (lib_code) {
828
+    /**
829
+     * @author fenris
830
+     */
831
+    function inverse_encode(decode, to) {
832
+        return decode(to);
833
+    }
834
+    lib_code.inverse_encode = inverse_encode;
835
+    /**
836
+     * @author fenris
837
+     */
838
+    function inverse_decode(encode, from) {
839
+        return encode(from);
840
+    }
841
+    lib_code.inverse_decode = inverse_decode;
842
+})(lib_code || (lib_code = {}));
843
+/*
844
+This file is part of »bacterio-plankton:code«.
845
+
846
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
847
+<info@greenscale.de>
848
+
849
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
850
+it under the terms of the GNU Lesser General Public License as published by
851
+the Free Software Foundation, either version 3 of the License, or
852
+(at your option) any later version.
853
+
854
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
855
+but WITHOUT ANY WARRANTY; without even the implied warranty of
856
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
857
+GNU Lesser General Public License for more details.
858
+
859
+You should have received a copy of the GNU Lesser General Public License
860
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
861
+ */
862
+var lib_code;
863
+(function (lib_code) {
864
+    /**
865
+     * @author fenris
866
+     */
867
+    var class_code_inverse = /** @class */ (function () {
868
+        /**
869
+         * @author fenris
870
+         */
871
+        function class_code_inverse(subject) {
872
+            this.subject = subject;
873
+        }
874
+        /**
875
+         * @implementation
876
+         * @author fenris
877
+         */
878
+        class_code_inverse.prototype.encode = function (to) {
879
+            var _this = this;
880
+            return lib_code.inverse_encode(function (x) { return _this.subject.decode(x); }, to);
881
+        };
882
+        /**
883
+         * @implementation
884
+         * @author fenris
885
+         */
886
+        class_code_inverse.prototype.decode = function (from) {
887
+            var _this = this;
888
+            return lib_code.inverse_decode(function (x) { return _this.subject.encode(x); }, from);
889
+        };
890
+        return class_code_inverse;
891
+    }());
892
+    lib_code.class_code_inverse = class_code_inverse;
893
+})(lib_code || (lib_code = {}));
894
+/*
895
+This file is part of »bacterio-plankton:code«.
896
+
897
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
898
+<info@greenscale.de>
899
+
900
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
901
+it under the terms of the GNU Lesser General Public License as published by
902
+the Free Software Foundation, either version 3 of the License, or
903
+(at your option) any later version.
904
+
905
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
906
+but WITHOUT ANY WARRANTY; without even the implied warranty of
907
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
908
+GNU Lesser General Public License for more details.
909
+
910
+You should have received a copy of the GNU Lesser General Public License
911
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
912
+ */
913
+var lib_code;
914
+(function (lib_code) {
915
+    /**
916
+     * @author fenris
917
+     */
918
+    function pair_encode(encode_first, encode_second, from) {
919
+        var between = encode_first(from);
920
+        var to = encode_second(between);
921
+        return to;
922
+    }
923
+    lib_code.pair_encode = pair_encode;
924
+    /**
925
+     * @author fenris
926
+     */
927
+    function pair_decode(decode_first, decode_second, to) {
928
+        var between = decode_second(to);
929
+        var from = decode_first(between);
930
+        return from;
931
+    }
932
+    lib_code.pair_decode = pair_decode;
933
+})(lib_code || (lib_code = {}));
934
+/*
935
+This file is part of »bacterio-plankton:code«.
936
+
937
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
938
+<info@greenscale.de>
939
+
940
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
941
+it under the terms of the GNU Lesser General Public License as published by
942
+the Free Software Foundation, either version 3 of the License, or
943
+(at your option) any later version.
944
+
945
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
946
+but WITHOUT ANY WARRANTY; without even the implied warranty of
947
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
948
+GNU Lesser General Public License for more details.
949
+
950
+You should have received a copy of the GNU Lesser General Public License
951
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
952
+ */
953
+var lib_code;
954
+(function (lib_code) {
955
+    /**
956
+     * @author fenris
957
+     */
958
+    var class_code_pair = /** @class */ (function () {
959
+        /**
960
+         * @author fenris
961
+         */
962
+        function class_code_pair(first, second) {
963
+            this.first = first;
964
+            this.second = second;
965
+        }
966
+        /**
967
+         * @implementation
968
+         * @author fenris
969
+         */
970
+        class_code_pair.prototype.encode = function (from) {
971
+            var _this = this;
972
+            return lib_code.pair_encode(function (x) { return _this.first.encode(x); }, function (x) { return _this.second.encode(x); }, from);
973
+        };
974
+        /**
975
+         * @implementation
976
+         * @author fenris
977
+         */
978
+        class_code_pair.prototype.decode = function (to) {
979
+            var _this = this;
980
+            return lib_code.pair_decode(function (x) { return _this.first.decode(x); }, function (x) { return _this.second.decode(x); }, to);
981
+        };
982
+        return class_code_pair;
983
+    }());
984
+    lib_code.class_code_pair = class_code_pair;
985
+})(lib_code || (lib_code = {}));
986
+/*
987
+This file is part of »bacterio-plankton:code«.
988
+
989
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
990
+<info@greenscale.de>
991
+
992
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
993
+it under the terms of the GNU Lesser General Public License as published by
994
+the Free Software Foundation, either version 3 of the License, or
995
+(at your option) any later version.
996
+
997
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
998
+but WITHOUT ANY WARRANTY; without even the implied warranty of
999
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1000
+GNU Lesser General Public License for more details.
1001
+
1002
+You should have received a copy of the GNU Lesser General Public License
1003
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
1004
+ */
1005
+var lib_code;
1006
+(function (lib_code) {
1007
+    /**
1008
+     * @author fenris
1009
+     */
1010
+    function chain_encode(encode_links, from) {
1011
+        var value = from;
1012
+        encode_links
1013
+            .forEach(function (link) {
1014
+            value = link(value);
1015
+        });
1016
+        return value;
1017
+    }
1018
+    lib_code.chain_encode = chain_encode;
1019
+    /**
1020
+     * @author fenris
1021
+     */
1022
+    function chain_decode(decode_links, to) {
1023
+        var value = to;
1024
+        decode_links
1025
+            .reverse()
1026
+            .forEach(function (link) {
1027
+            value = link(value);
1028
+        });
1029
+        return value;
1030
+    }
1031
+    lib_code.chain_decode = chain_decode;
1032
+})(lib_code || (lib_code = {}));
1033
+/*
1034
+This file is part of »bacterio-plankton:code«.
1035
+
1036
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
1037
+<info@greenscale.de>
1038
+
1039
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
1040
+it under the terms of the GNU Lesser General Public License as published by
1041
+the Free Software Foundation, either version 3 of the License, or
1042
+(at your option) any later version.
1043
+
1044
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
1045
+but WITHOUT ANY WARRANTY; without even the implied warranty of
1046
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1047
+GNU Lesser General Public License for more details.
1048
+
1049
+You should have received a copy of the GNU Lesser General Public License
1050
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
1051
+ */
1052
+var lib_code;
1053
+(function (lib_code) {
1054
+    /**
1055
+     * @author fenris
1056
+     */
1057
+    var class_code_chain = /** @class */ (function () {
1058
+        /**
1059
+         * @author fenris
1060
+         */
1061
+        function class_code_chain(links) {
1062
+            this.links = links;
1063
+        }
1064
+        /**
1065
+         * @implementation
1066
+         * @author fenris
1067
+         */
1068
+        class_code_chain.prototype.encode = function (from) {
1069
+            return lib_code.chain_encode(this.links.map(function (link) { return (function (x) { return link.encode(x); }); }), from);
1070
+        };
1071
+        /**
1072
+         * @implementation
1073
+         * @author fenris
1074
+         */
1075
+        class_code_chain.prototype.decode = function (to) {
1076
+            return lib_code.chain_decode(this.links.map(function (link) { return (function (x) { return link.decode(x); }); }), to);
1077
+        };
1078
+        return class_code_chain;
1079
+    }());
1080
+    lib_code.class_code_chain = class_code_chain;
1081
+})(lib_code || (lib_code = {}));
1082
+/*
1083
+This file is part of »bacterio-plankton:code«.
1084
+
1085
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
1086
+<info@greenscale.de>
1087
+
1088
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
1089
+it under the terms of the GNU Lesser General Public License as published by
1090
+the Free Software Foundation, either version 3 of the License, or
1091
+(at your option) any later version.
1092
+
1093
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
1094
+but WITHOUT ANY WARRANTY; without even the implied warranty of
1095
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1096
+GNU Lesser General Public License for more details.
1097
+
1098
+You should have received a copy of the GNU Lesser General Public License
1099
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
1100
+ */
1101
+var lib_code;
1102
+(function (lib_code) {
1103
+    /**
1104
+     * @author Christian Fraß <frass@greenscale.de>
1105
+     */
1106
+    function flatten_encode(from, keys) {
1107
+        if (keys === void 0) { keys = null; }
1108
+        if (keys === null) {
1109
+            if (from.length > 0) {
1110
+                keys = Object.keys(from[0]);
1111
+            }
1112
+            else {
1113
+                throw (new Error("encoding impossible"));
1114
+            }
1115
+        }
1116
+        return {
1117
+            "keys": keys,
1118
+            "data": from.map(function (line) { return keys.map(function (name) { return line[name]; }); })
1119
+        };
1120
+    }
1121
+    lib_code.flatten_encode = flatten_encode;
1122
+    /**
1123
+     * @author Christian Fraß <frass@greenscale.de>
1124
+     */
1125
+    function flatten_decode(to) {
1126
+        return (to.data
1127
+            .map(function (dataset) {
1128
+            var dataset_ = {};
1129
+            dataset
1130
+                .forEach(function (value, index) {
1131
+                var name = to.keys[index];
1132
+                dataset_[name] = value;
1133
+            });
1134
+            return dataset_;
1135
+        }));
1136
+    }
1137
+    lib_code.flatten_decode = flatten_decode;
1138
+})(lib_code || (lib_code = {}));
1139
+/*
1140
+This file is part of »bacterio-plankton:code«.
1141
+
1142
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
1143
+<info@greenscale.de>
1144
+
1145
+»bacterio-plankton:code« is free software: you can redistribute it and/or modify
1146
+it under the terms of the GNU Lesser General Public License as published by
1147
+the Free Software Foundation, either version 3 of the License, or
1148
+(at your option) any later version.
1149
+
1150
+»bacterio-plankton:code« is distributed in the hope that it will be useful,
1151
+but WITHOUT ANY WARRANTY; without even the implied warranty of
1152
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1153
+GNU Lesser General Public License for more details.
1154
+
1155
+You should have received a copy of the GNU Lesser General Public License
1156
+along with »bacterio-plankton:code«. If not, see <http://www.gnu.org/licenses/>.
1157
+ */
1158
+var lib_code;
1159
+(function (lib_code) {
1160
+    /**
1161
+     * @author fenris
1162
+     */
1163
+    var class_code_flatten = /** @class */ (function () {
1164
+        /**
1165
+         * @author fenris
1166
+         */
1167
+        function class_code_flatten() {
1168
+        }
1169
+        /**
1170
+         * @implementation
1171
+         * @author fenris
1172
+         */
1173
+        class_code_flatten.prototype.encode = function (x) {
1174
+            return lib_code.flatten_encode(x);
1175
+        };
1176
+        /**
1177
+         * @implementation
1178
+         * @author fenris
1179
+         */
1180
+        class_code_flatten.prototype.decode = function (x) {
1181
+            return lib_code.flatten_decode(x);
1182
+        };
1183
+        return class_code_flatten;
1184
+    }());
1185
+    lib_code.class_code_flatten = class_code_flatten;
1186
+})(lib_code || (lib_code = {}));
1187
+/*
1188
+This file is part of »bacterio-plankton:http«.
1189
+
1190
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
1191
+<info@greenscale.de>
1192
+
1193
+»bacterio-plankton:http« is free software: you can redistribute it and/or modify
1194
+it under the terms of the GNU Lesser General Public License as published by
1195
+the Free Software Foundation, either version 3 of the License, or
1196
+(at your option) any later version.
1197
+
1198
+»bacterio-plankton:http« is distributed in the hope that it will be useful,
1199
+but WITHOUT ANY WARRANTY; without even the implied warranty of
1200
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1201
+GNU Lesser General Public License for more details.
1202
+
1203
+You should have received a copy of the GNU Lesser General Public License
1204
+along with »bacterio-plankton:http«. If not, see <http://www.gnu.org/licenses/>.
1205
+ */
1206
+var lib_http;
1207
+(function (lib_http) {
1208
+    /**
1209
+     * @author fenris <frass@greenscale.de>
1210
+     */
1211
+    let enum_method;
1212
+    (function (enum_method) {
1213
+        enum_method["get"] = "get";
1214
+        enum_method["post"] = "post";
1215
+        enum_method["options"] = "options";
1216
+        // put = "put",
1217
+        // delete = "delete",
1218
+        // head = "head",
1219
+    })(enum_method = lib_http.enum_method || (lib_http.enum_method = {}));
1220
+})(lib_http || (lib_http = {}));
1221
+/*
1222
+This file is part of »bacterio-plankton:http«.
1223
+
1224
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
1225
+<info@greenscale.de>
1226
+
1227
+»bacterio-plankton:http« is free software: you can redistribute it and/or modify
1228
+it under the terms of the GNU Lesser General Public License as published by
1229
+the Free Software Foundation, either version 3 of the License, or
1230
+(at your option) any later version.
1231
+
1232
+»bacterio-plankton:http« is distributed in the hope that it will be useful,
1233
+but WITHOUT ANY WARRANTY; without even the implied warranty of
1234
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1235
+GNU Lesser General Public License for more details.
1236
+
1237
+You should have received a copy of the GNU Lesser General Public License
1238
+along with »bacterio-plankton:http«. If not, see <http://www.gnu.org/licenses/>.
1239
+ */
1240
+var lib_http;
1241
+(function (lib_http) {
1242
+    /**
1243
+     * @author fenris <frass@greenscale.de>
1244
+     */
1245
+    const linebreak = "\r\n";
1246
+    /**
1247
+     * @author fenris <frass@greenscale.de>
1248
+     */
1249
+    function encode_method(method) {
1250
+        switch (method) {
1251
+            case lib_http.enum_method.get: return "GET";
1252
+            case lib_http.enum_method.post: return "POST";
1253
+            case lib_http.enum_method.options: return "OPTIONS";
1254
+            default: throw (new Error("impossible"));
1255
+        }
1256
+    }
1257
+    /**
1258
+     * @author fenris <frass@greenscale.de>
1259
+     */
1260
+    function decode_method(method_raw) {
1261
+        switch (method_raw) {
1262
+            case "GET": return lib_http.enum_method.get;
1263
+            case "POST": return lib_http.enum_method.post;
1264
+            case "OPTIONS": return lib_http.enum_method.options;
1265
+            default: throw (new Error("unhandled method: " + method_raw));
1266
+        }
1267
+    }
1268
+    /**
1269
+     * @author fenris <frass@greenscale.de>
1270
+     */
1271
+    function get_statustext(statuscode) {
1272
+        switch (statuscode) {
1273
+            case 100: return "Continue";
1274
+            case 101: return "Switching Protocols";
1275
+            case 103: return "Early Hints";
1276
+            case 200: return "OK";
1277
+            case 201: return "Created";
1278
+            case 202: return "Accepted";
1279
+            case 203: return "Non-Authoritative Information";
1280
+            case 204: return "No Content";
1281
+            case 205: return "Reset Content";
1282
+            case 206: return "Partial Content";
1283
+            case 300: return "Multiple Choices";
1284
+            case 301: return "Moved Permanently";
1285
+            case 302: return "Found";
1286
+            case 303: return "See Other";
1287
+            case 304: return "Not Modified";
1288
+            case 307: return "Temporary Redirect";
1289
+            case 308: return "Permanent Redirect";
1290
+            case 400: return "Bad Request";
1291
+            case 401: return "Unauthorized";
1292
+            case 402: return "Payment Required";
1293
+            case 403: return "Forbidden";
1294
+            case 404: return "Not Found";
1295
+            case 405: return "Method Not Allowed";
1296
+            case 406: return "Not Acceptable";
1297
+            case 407: return "Proxy Authentication Required";
1298
+            case 408: return "Request Timeout";
1299
+            case 409: return "Conflict";
1300
+            case 410: return "Gone";
1301
+            case 411: return "Length Required";
1302
+            case 412: return "Precondition Failed";
1303
+            case 413: return "Payload Too Large";
1304
+            case 414: return "URI Too Long";
1305
+            case 415: return "Unsupported Media Type";
1306
+            case 416: return "Range Not Satisfiable";
1307
+            case 417: return "Expectation Failed";
1308
+            case 418: return "I'm a teapot";
1309
+            case 422: return "Unprocessable Entity";
1310
+            case 425: return "Too Early";
1311
+            case 426: return "Upgrade Required";
1312
+            case 428: return "Precondition Required";
1313
+            case 429: return "Too Many Requests";
1314
+            case 431: return "Request Header Fields Too Large";
1315
+            case 451: return "Unavailable For Legal Reasons";
1316
+            case 500: return "Internal Server Error";
1317
+            case 501: return "Not Implemented";
1318
+            case 502: return "Bad Gateway";
1319
+            case 503: return "Service Unavailable";
1320
+            case 504: return "Gateway Timeout";
1321
+            case 505: return "HTTP Version Not Supported";
1322
+            case 506: return "Variant Also Negotiates";
1323
+            case 507: return "Insufficient Storage";
1324
+            case 508: return "Loop Detected";
1325
+            case 510: return "Not Extended";
1326
+            case 511: return "Network Authentication";
1327
+            default: throw (new Error("unhandled statuscode: " + statuscode.toFixed(0)));
1328
+        }
1329
+    }
1330
+    /**
1331
+     * @author fenris <frass@greenscale.de>
1332
+     */
1333
+    function encode_request(request) {
1334
+        let request_raw = "";
1335
+        request_raw += (encode_method(request.method) + " " + request.query + " " + "HTTP/1.1" + linebreak);
1336
+        request_raw += ("Host: " + request.host + linebreak);
1337
+        for (const [key, value] of Object.entries(request.headers)) {
1338
+            request_raw += (key + ": " + value + linebreak);
1339
+        }
1340
+        request_raw += linebreak;
1341
+        request_raw += request.body;
1342
+        return request_raw;
1343
+    }
1344
+    lib_http.encode_request = encode_request;
1345
+    /**
1346
+     * @author fenris <frass@greenscale.de>
1347
+     */
1348
+    function decode_request(request_raw) {
1349
+        const lines = request_raw.split(linebreak);
1350
+        const first = lines.shift();
1351
+        const [method_raw, query, version] = first.split(" ");
1352
+        let headers = {};
1353
+        while (true) {
1354
+            const line = lines.shift();
1355
+            if (line === "") {
1356
+                break;
1357
+            }
1358
+            else {
1359
+                const [key, value] = line.split(": ", 2);
1360
+                headers[key] = value;
1361
+            }
1362
+        }
1363
+        const body = lines.join(linebreak);
1364
+        const request = {
1365
+            "host": headers["Host"],
1366
+            "query": query,
1367
+            "method": decode_method(method_raw),
1368
+            "headers": headers,
1369
+            "body": body,
1370
+        };
1371
+        return request;
1372
+    }
1373
+    lib_http.decode_request = decode_request;
1374
+    /**
1375
+     * @author fenris <frass@greenscale.de>
1376
+     */
1377
+    function encode_response(response) {
1378
+        let response_raw = "";
1379
+        response_raw += ("HTTP/1.1" + " " + response.statuscode + " " + get_statustext(response.statuscode) + linebreak);
1380
+        for (const [key, value] of Object.entries(response.headers)) {
1381
+            response_raw += (key + ": " + value + linebreak);
1382
+        }
1383
+        response_raw += linebreak;
1384
+        response_raw += response.body;
1385
+        return response_raw;
1386
+    }
1387
+    lib_http.encode_response = encode_response;
1388
+    /**
1389
+     * @author fenris <frass@greenscale.de>
1390
+     */
1391
+    function decode_response(response_raw) {
1392
+        const lines = response_raw.split(linebreak);
1393
+        const first = lines.shift();
1394
+        const statuscode = parseInt(first.split(" ")[1]);
1395
+        let headers = {};
1396
+        while (true) {
1397
+            const line = lines.shift();
1398
+            if (line === "") {
1399
+                break;
1400
+            }
1401
+            else {
1402
+                const [key, value] = line.split(": ", 2);
1403
+                headers[key] = value;
1404
+            }
1405
+        }
1406
+        const body = lines.join(linebreak);
1407
+        const response = {
1408
+            "statuscode": statuscode,
1409
+            "headers": headers,
1410
+            "body": body,
1411
+        };
1412
+        return response;
1413
+    }
1414
+    lib_http.decode_response = decode_response;
1415
+})(lib_http || (lib_http = {}));
1416
+/*
1417
+This file is part of »bacterio-plankton:http«.
1418
+
1419
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
1420
+<info@greenscale.de>
1421
+
1422
+»bacterio-plankton:http« is free software: you can redistribute it and/or modify
1423
+it under the terms of the GNU Lesser General Public License as published by
1424
+the Free Software Foundation, either version 3 of the License, or
1425
+(at your option) any later version.
1426
+
1427
+»bacterio-plankton:http« is distributed in the hope that it will be useful,
1428
+but WITHOUT ANY WARRANTY; without even the implied warranty of
1429
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1430
+GNU Lesser General Public License for more details.
1431
+
1432
+You should have received a copy of the GNU Lesser General Public License
1433
+along with »bacterio-plankton:http«. If not, see <http://www.gnu.org/licenses/>.
1434
+ */
1435
+var lib_http;
1436
+(function (lib_http) {
1437
+    /**
1438
+     * @author fenris
1439
+     */
1440
+    class class_http_request {
1441
+        /**
1442
+         * @author fenris
1443
+         */
1444
+        constructor() {
1445
+        }
1446
+        /**
1447
+         * @implementation
1448
+         * @author fenris
1449
+         */
1450
+        encode(x) {
1451
+            return lib_http.encode_request(x);
1452
+        }
1453
+        /**
1454
+         * @implementation
1455
+         * @author fenris
1456
+         */
1457
+        decode(x) {
1458
+            return lib_http.decode_request(x);
1459
+        }
1460
+    }
1461
+    lib_http.class_http_request = class_http_request;
1462
+    /**
1463
+     * @author fenris
1464
+     */
1465
+    class class_http_response {
1466
+        /**
1467
+         * @author fenris
1468
+         */
1469
+        constructor() {
1470
+        }
1471
+        /**
1472
+         * @implementation
1473
+         * @author fenris
1474
+         */
1475
+        encode(x) {
1476
+            return lib_http.encode_response(x);
1477
+        }
1478
+        /**
1479
+         * @implementation
1480
+         * @author fenris
1481
+         */
1482
+        decode(x) {
1483
+            return lib_http.decode_response(x);
1484
+        }
1485
+    }
1486
+    lib_http.class_http_response = class_http_response;
1487
+})(lib_http || (lib_http = {}));
1488
+/*
1489
+This file is part of »bacterio-plankton:server«.
1490
+
1491
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
1492
+<info@greenscale.de>
1493
+
1494
+»bacterio-plankton:server« is free software: you can redistribute it and/or modify
1495
+it under the terms of the GNU Lesser General Public License as published by
1496
+the Free Software Foundation, either version 3 of the License, or
1497
+(at your option) any later version.
1498
+
1499
+»bacterio-plankton:server« is distributed in the hope that it will be useful,
1500
+but WITHOUT ANY WARRANTY; without even the implied warranty of
1501
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1502
+GNU Lesser General Public License for more details.
1503
+
1504
+You should have received a copy of the GNU Lesser General Public License
1505
+along with »bacterio-plankton:server«. If not, see <http://www.gnu.org/licenses/>.
1506
+ */
1507
+var lib_server;
1508
+(function (lib_server) {
1509
+    /**
1510
+     * @author fenris
1511
+     */
1512
+    function make(port, handle, verbosity = 1) {
1513
+        return {
1514
+            "port": port,
1515
+            "handle": handle,
1516
+            "verbosity": verbosity,
1517
+            "serverobj": undefined,
1518
+        };
1519
+    }
1520
+    lib_server.make = make;
1521
+    /**
1522
+     * @author fenris
1523
+     */
1524
+    function log(subject, level, message) {
1525
+        if (subject.verbosity >= level) {
1526
+            console.log("[server]", message);
1527
+        }
1528
+        else {
1529
+            // do nothing
1530
+        }
1531
+    }
1532
+    /**
1533
+     * @author fenris
1534
+     */
1535
+    function start(subject) {
1536
+        const net = require("net");
1537
+        return (new Promise((resolve, reject) => {
1538
+            subject.serverobj = net.createServer((socket) => {
1539
+                log(subject, 2, "client connected");
1540
+                socket.on("readable", () => {
1541
+                    let chunk;
1542
+                    while (!((chunk = socket.read()) === null)) {
1543
+                        const input = chunk.toString();
1544
+                        log(subject, 3, "reading: " + input);
1545
+                        subject.handle(input)
1546
+                            .then((output) => {
1547
+                            log(subject, 3, "writing: " + output);
1548
+                            socket.write(output);
1549
+                            socket.end();
1550
+                        });
1551
+                    }
1552
+                });
1553
+                socket.on("end", () => {
1554
+                    log(subject, 2, "client disconnected");
1555
+                });
1556
+            });
1557
+            subject.serverobj.on("error", (error) => {
1558
+                throw error;
1559
+            });
1560
+            subject.serverobj.listen(subject.port, () => {
1561
+                log(subject, 1, "listening on port " + subject.port.toFixed(0));
1562
+                resolve(undefined);
1563
+            });
1564
+        }));
1565
+    }
1566
+    lib_server.start = start;
1567
+    /**
1568
+     * @author fenris
1569
+     */
1570
+    function kill(subject) {
1571
+        subject.serverobj.close();
1572
+    }
1573
+    lib_server.kill = kill;
1574
+})(lib_server || (lib_server = {}));
1575
+/*
1576
+This file is part of »bacterio-plankton:server«.
1577
+
1578
+Copyright 2016-2021 'Christian Fraß, Christian Neubauer, Martin Springwald GbR'
1579
+<info@greenscale.de>
1580
+
1581
+»bacterio-plankton:server« is free software: you can redistribute it and/or modify
1582
+it under the terms of the GNU Lesser General Public License as published by
1583
+the Free Software Foundation, either version 3 of the License, or
1584
+(at your option) any later version.
1585
+
1586
+»bacterio-plankton:server« is distributed in the hope that it will be useful,
1587
+but WITHOUT ANY WARRANTY; without even the implied warranty of
1588
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1589
+GNU Lesser General Public License for more details.
1590
+
1591
+You should have received a copy of the GNU Lesser General Public License
1592
+along with »bacterio-plankton:server«. If not, see <common://www.gnu.org/licenses/>.
1593
+ */
1594
+var lib_server;
1595
+(function (lib_server) {
1596
+    /**
1597
+     * @author fenris
1598
+     */
1599
+    class class_server {
1600
+        /**
1601
+         * @author fenris
1602
+         */
1603
+        constructor(port, handle, verbosity = undefined) {
1604
+            this.subject = lib_server.make(port, handle, verbosity);
1605
+        }
1606
+        /**
1607
+         * @author fenris
1608
+         */
1609
+        start() {
1610
+            return lib_server.start(this.subject);
1611
+        }
1612
+        /**
1613
+         * @author fenris
1614
+         */
1615
+        kill() {
1616
+            return lib_server.kill(this.subject);
1617
+        }
1618
+    }
1619
+    lib_server.class_server = class_server;
1620
+})(lib_server || (lib_server = {}));
... ...
@@ -0,0 +1,154 @@
1
+function get_timestamp(): int
2
+{
3
+	return Math.floor(Date.now()/1000);
4
+}
5
+
6
+async function main(): Promise<void>
7
+{
8
+	var nm_irc = require("irc");
9
+	
10
+	var _events: Array<any> = [];
11
+	var _users: Array<{name: string; role: string;}> = [];
12
+	var _client = null;
13
+	
14
+	const server: lib_server.class_server = new lib_server.class_server(
15
+		7979,
16
+		(input: string) => {
17
+			const request: lib_http.type_request = lib_http.decode_request(input);
18
+			// process.stderr.write(JSON.stringify(request, undefined, "\t") + "\n");
19
+			const data_in: any = JSON.parse(request.body);
20
+			let data_out: any;
21
+			let error: (null | Error);
22
+			try {
23
+				switch (data_in["action"]) {
24
+					case "connect":
25
+						if (_client !== null) {
26
+							throw (new Error("already connected"));
27
+						}
28
+						else {
29
+							const client = new nm_irc.Client(
30
+								data_in["data"]["server"],
31
+								data_in["data"]["nickname"],
32
+								{
33
+									"channels": data_in["data"]["channels"],
34
+									"autoConnect": false,
35
+								}
36
+							);
37
+							client.addListener(
38
+								"message",
39
+								(from, to, message) => {
40
+									_events.push({
41
+										"timestamp": get_timestamp(),
42
+										"kind": "channel_message",
43
+										"data": {
44
+											"from": from,
45
+											"to": to,
46
+											"message": message,
47
+										}
48
+									});
49
+								}
50
+							);
51
+							client.addListener(
52
+								"pm",
53
+								(from, message) => {
54
+									_events.push({
55
+										"timestamp": get_timestamp(),
56
+										"kind": "private_message",
57
+										"data": {
58
+											"from": from,
59
+											"message": message,
60
+										}
61
+									});
62
+								}
63
+							);
64
+							client.addListener(
65
+								"names",
66
+								(channel, users) => {
67
+									_users = Object.entries(users).map(([key, value]) => ({"name": key, "role": value.toString()}));
68
+								}
69
+							);
70
+							client.addListener(
71
+								"error",
72
+								(error) => {
73
+									process.stderr.write("error: " + error.message + "\n");
74
+								}
75
+							);
76
+							client.connect(
77
+								3,
78
+								() => {
79
+									_client = client;
80
+								}
81
+							);
82
+						}
83
+						data_out = null;
84
+						break;
85
+					case "check":
86
+						data_out = (_client !== null);
87
+						break;
88
+					case "disconnect":
89
+						if (_client === null) {
90
+							throw (new Error("not (yet) connected"));
91
+						}
92
+						else {
93
+							_client.disconnect(
94
+								"",
95
+								() => {
96
+									_client = null;
97
+								}
98
+							);
99
+							data_out = null;
100
+						}
101
+						break;
102
+					case "say":
103
+						if (_client === null) {
104
+							throw (new Error("not (yet) connected"));
105
+						}
106
+						else {
107
+							_client.say(data_in["data"]["channel"], data_in["data"]["message"]);
108
+							data_out = null;
109
+						}
110
+						break;
111
+					case "fetch":
112
+						if (_client === null) {
113
+							throw (new Error("not (yet) connected"));
114
+						}
115
+						else {
116
+							data_out = {
117
+								"users": _users,
118
+								"events": _events,
119
+							};
120
+							_events = [];
121
+						}
122
+						break;
123
+				}
124
+				error = null;
125
+			}
126
+			catch (error_) {
127
+				error = error_;
128
+			}
129
+			const response: lib_http.type_response = (
130
+				(error !== null)
131
+				? {
132
+					"statuscode": 500,
133
+					"headers": {
134
+						"Access-Control-Allow-Origin": "*",
135
+					},
136
+					"body": JSON.stringify({"error": error.toString()}),
137
+				}
138
+				: {
139
+					"statuscode": 200,
140
+					"headers": {
141
+						"Access-Control-Allow-Origin": "*",
142
+					},
143
+					"body": JSON.stringify(data_out),
144
+				}
145
+			);
146
+			const output: string = lib_http.encode_response(response);
147
+			return Promise.resolve<string>(output);
148
+		}
149
+	);
150
+	server.start()
151
+}
152
+
153
+main();
154
+
... ...
@@ -0,0 +1,4 @@
1
+#!/usr/bin/env sh
2
+
3
+make -f tools/makefile
4
+
... ...
@@ -0,0 +1,43 @@
1
+## consts
2
+
3
+dir_lib := lib
4
+dir_source := source
5
+dir_temp := temp
6
+dir_build := build
7
+
8
+
9
+## commands
10
+
11
+cmd_log := echo "--"
12
+cmd_mkdir := mkdir -p
13
+cmd_cp := cp
14
+cmd_cat := cat
15
+cmd_tsc := tsc --lib es2017
16
+cmd_chmod := chmod
17
+
18
+
19
+## rules
20
+
21
+all: node_modules ${dir_build}/irc-web-backend
22
+.PHONY: all
23
+
24
+node_modules:
25
+	@ ${cmd_log} "copying node modules …"
26
+	@ ${cmd_mkdir} ${dir_build}/node_modules
27
+	@ ${cmd_cp} -ru ${dir_lib}/node/node_modules/* ${dir_build}/node_modules/
28
+.PHONY: node_modules
29
+
30
+${dir_build}/irc-web-backend: ${dir_temp}/head.js ${dir_lib}/plankton/plankton.js ${dir_temp}/irc-web-backend-unlinked.ts
31
+	@ ${cmd_log} "linking …"
32
+	@ ${cmd_mkdir} $(dir $@)
33
+	@ ${cmd_cat} $^ > $@
34
+	@ ${cmd_chmod} +x $@
35
+
36
+${dir_temp}/head.js:
37
+	@ echo "#!/usr/bin/env node" > $@
38
+
39
+${dir_temp}/irc-web-backend-unlinked.ts: ${dir_lib}/plankton/plankton.d.ts ${dir_source}/main.ts
40
+	@ ${cmd_log} "building …"
41
+	@ ${cmd_mkdir} $(dir $@)
42
+	@ ${cmd_tsc} $^ --outFile $@
43
+
... ...
@@ -0,0 +1,6 @@
1
+#!/usr/bin/env sh
2
+
3
+dir_lib="lib"
4
+cd ${dir_lib}/node
5
+npm install irc
6
+
... ...
@@ -0,0 +1,6 @@
1
+#!/usr/bin/env sh
2
+
3
+dir_lib="lib"
4
+cd ${dir_lib}/plankton
5
+ptk bundle node http server
6
+
0 7